认知图谱

AI工程 · 模块

M08AI工具与开发环境

工具出问题时，先确定请求真正经过了哪一层：进程环境、配置文件、认证主体、网关路由和上游配额各管一段。先拿完整证据，再用最小对照把假设分开；一次恢复只说明那个版本组合，不把单点故障泛化到整台机器或整个产品。

核心流程

故障排查的分层链路

中间一列是步骤，右侧是本模块里真实出现过的对应实例。对照实验之后有一道关口：日志证明只改了一个条件，才能往下归因。

AI 工具故障排查的分层链路 先收集完整日志和版本，按命令、配置、认证、路由、配额分层定位，列出可区分的假设，用最小对照实验检验，并用日志确认对照真的生效，再做最小修复，最后把结论限定在该版本组合；每一步配有本模块的真实实例。 本模块里的实例 是 否：条件没变 收集现场证据 完整日志 · 版本 · 实际参数 分层定位 PATH · 配置 · 认证 · 路由 · 配额 列可区分的假设 按完整错误语义，不看包装提示 最小对照 单请求 · 版本回退 · 换窗口 对照真的生效？ 日志确认只改了一个条件 最小修复或恢复 保留配置与会话历史 限定结论范围 只对该版本组合成立 PowerShell 安装报错 落盘一看是 HTML/JS，不是安装脚本 CC Switch 配置错误 缺的 base_url 在 Provider 字段，不在系统变量 Claude 接 Kimi 报 403 “Please run /login” 只是客户端包装提示 Codex CLI 0.153.0 模型目录和请求全部 404，回退 0.152.1 后恢复 WebUI 启动崩溃 日志仍在加载扩展，“禁用全部扩展”并未执行 同一次 Codex CLI 故障 未定位前不删整个 .codex，先拿版本与认证状态 回退后恢复 只证明版本组合相关，不能唯一定位服务端根因 一次只改一个条件 恢复 ≠ 找到根因
先分层、再对照、最后限定范围；每一步都靠日志或配置证据推进，而不是靠换配置碰运气。　出处：C000-064-01、C000-061-01、C002-087-01、C002-054-01、C002-054-02、C000-082-01、C000-082-02、C002-054-03、G-0009

核心逻辑

七条排障与选型的通用判断

先找真正的消费者：配置在哪一层生效

当前进程环境、持久环境和 Provider 配置文件可能各不相同，修改持久变量不能证明运行中的进程已经接收。切换模型名或 provider，不证明认证和计费源跟着变了。局部覆盖会让只改全局默认无效，旧的管理员进程也不会因设置变化自动降权。

具体字段、菜单和认证优先级按当前版本与现场证据确认。

证据先于结论：包装、原文和推断分开

执行下载内容报语法错，先看落盘内容的类型、重定向和来源；看到“Please run /login”不等于登录过期，要按完整错误语义列出并发、账号限制和中转配置等可区分假设。读发布消息也一样：明说、合理暗示和尚未说明分开列。

HTML 返回只说明拿到的不是预期脚本，不能凭片段断定是登录页还是代理拦截。

用最小对照分开假设，并确认对照真的执行了

一次只改一个条件：无工具、无子代理的单请求，单次版本回退，普通窗口与管理员窗口对照。日志若仍在加载扩展，“禁用全部扩展后仍失败”这次实验就没有发生；同时卸载多个包后成功，只能定位到组合，不能归因某一个包。

对照时不得未经授权结束用户正在执行的任务。

不把单点故障泛化，也不用清空代替诊断

一个会话或 app-server 故障，推不出 CLI、整台设备或其它会话都失效。CI 任务失败但 steps 为空，先区分 runner 启动故障和真实测试失败。未定位前不删整个配置目录、不反复换 Key 或买额度；恢复先固定提交与状态边界，只核验、快进或最小修复。

回退 0.152.1 恢复只属于 2026-09-03 那次实例，不是今天的降级指令。

能力面、额度主体和计费对象各自独立

同一品牌的聊天产品、API、代码 CLI、桌面与云端代理是不同能力面。多人限流先找请求实际落在哪个账号、Key、组织或套餐；同品牌的不同订阅不互通额度。订阅用量、已有余额、自动充值和 API 计费控制不同对象；工具名叫 image_gen 也不证明调用了哪个模型。

具体权益、配额和价格都随时间变化，必须按当前官方信息和账户现场核实。

模型选择看同任务对照，不看跑分和自述

官方跑分、独立同口径评测和具体任务个案分三层看；比较时记录执行框架、effort、成功率、总 token、延迟、工具调用和缓存读写成本。推理投入按约束复杂度、依赖跨度、延迟和成本选择；单次难题、长文整合、跨文件执行和多轮状态保持要分开测。

单次负例不证明普遍退化；代码偏好榜不决定中文文学质量。

权限与记忆按 owner 放，不因“在本机”就放大

能执行命令、读文件的代理只拿实际授权的 workspace、账号和凭据。MCP 组合按功能和客户端支持选装，用目录白名单、数据库只读、分域授权缩小影响。屏幕记忆只用于近期上下文恢复，稳定规则、任务状态和代码事实各回自己的 owner。

隔离方式按真实环境决定，容器不自动等于完整安全。

结构

一次调用经过的六层，与模型评估的证据层级

上图从客户端往下到计费，每层写明该查什么、最常见的误判是什么。下图把三类模型评估证据按离你的任务远近排开。

一次 AI 调用经过的六层 客户端与会话、有效配置、认证主体、路由与网关、上游服务与配额、计费与额度六层，每层列出应检查的证据和常见误判。 请求方向 检查什么 常见误判 01 客户端与会话 窗口 · 会话 · 进程权限 实际后台任务、同账号客户端、启动父进程 窗口数 = 请求数；改了设置旧进程就降权 02 有效配置 进程 · 持久 · Provider 文件 运行中的 Base URL、模型与覆盖优先级 改了持久变量，运行中的进程就已接收 03 认证主体 OAuth · API Key · 账号 凭证类型、认证优先级、诊断信息 切换模型名 = 切换了认证和计费源 04 路由与网关 协议 · base URL · 代理规则 协议、客户端拼接路径、最终出站规则 产品名相同，协议就兼容 05 上游服务与配额 账号 · Key · 组织 · 套餐 实际限流响应与配额主体 同一公网 IP，就共享配额 06 计费与额度 订阅 · 余额 · 自动充值 · API 实际停止机制与用量记录 提示词或关掉窗口能当硬上限
第二层最常被跳过：改的配置和运行中进程读到的配置，往往不是同一份。　出处：C002-087-02、C002-090-01、C000-061-01、C002-087-03、C001-004-01、C000-061-02、C000-069-01、C000-095-01、G-0005
模型评估的三类证据与成本口径 厂商与官方跑分、独立同口径评测、你的同任务对照依次更贴近具体任务，并在同一任务上记录成功率、总 token、延迟、工具调用和缓存成本。 同口径 你的任务 同时记账 厂商与官方跑分 能说明：特定框架下的表现 看执行框架 · effort · 样本 独立同口径评测 能说明：同条件下的相对位置 看区间；饱和短题不算数 你的同任务对照 能说明：这件事上谁更好 匿名样文 · 检查实际产物 成本口径 成功率 · 总 token · 延迟 工具调用 · 缓存读写 单次负例不证明普遍退化；厂商宣称的节省率不等于你的实际费用节省。
越往右越贴近你的任务，越该作为选型依据；成本按同一任务记账。　出处：G-0035、G-0004、G-0036、C002-012-01、C002-002-01

演进

从零散报错，到对照实验与恢复边界

  1. 2026.02 – 2026.03

    配置与网络排障，先找发错的那一层

    CC Switch 缺 base_url、npm 发布被 403 拒绝、PowerShell 管道执行拿到 HTML、FlClash 流量异常、WebUI 启动崩溃、MiniMax 多人限流——每次的可复用部分都是先分清消费者层（进程、配置文件、认证、路由、配额），再改已确认的路径。WebUI 那次还暴露了“实验并未真正执行”的问题。

    代表会话：Claude API 配置错误、PowerShell 安装报错解析、WebUI启动问题分析、Minimax 限流与共享

  2. 2026.04 – 2026.05

    能力面与本机代理的边界

    ccswitch 切换模型后额度仍在减少，引出模型路由、认证与结算三层分离。本地运行代理、本机界面、本地模型推理和完全离线被分成四种能力。屏幕记忆不替代规则和仓库；Claude 项目实践区分聊天 Project、仓库代理与 API 工具循环三个执行面。

    代表会话：ccswitch 使用问题分析、开发环境｜05 本地版开源项目操作、AI工具｜07 Codex 使用 Chronicle、AI工具｜Claude项目最佳实践

  3. 2026.06 – 2026.08

    模型、思考强度与额度的选择

    订阅比较拆成套餐、席位、周期、权益和额度；思考强度按约束复杂度与依赖跨度路由。比较 Pro 与极高时提出要分开测单次难题、长文整合、跨文件执行和多轮状态保持；助手给出的“Pro 更适合”和 80/15/5 配比没有同任务对照。已买的 MiniMax 会员先核实是哪类权益，再找候选用途。

    代表会话：AI工具｜ChatGPT 年订阅情况、AI工具｜思考强度使用指南、AI工具｜Pro vs 极高适用场景、AI工具｜推荐MiniMax用法

  4. 2026.08 – 2026.10

    对照实验与恢复边界成形

    会话卡死用最后活动、远端提交和 CI 交叉核对，恢复限定为核验与最小修复。Codex CLI 0.153.0 回退到 0.152.1 后恢复，修正了此前“优先升级到最新版”的建议。Kimi 403 用单请求对照区分并发与持续失败；Terminal 管理员模式按全局默认、配置文件、快捷方式与父进程分层；解读重置公告时分开明说、暗示与未说明。

    代表会话：开发环境｜检查会话卡死状态、开发环境｜Codex CLI 故障排查、开发环境｜Claude使用Kimi报错原因、AI工具｜解读重置措辞

边界

哪些能直接拿来用，哪些已经过时

可以直接复用

  • 分层定位：进程与持久配置、Provider 文件、认证、路由、上游配额、计费分开查。
  • 最小对照（单请求、单次版本回退、换窗口），并用日志确认对照真的执行。
  • 恢复先固定提交与状态边界，只核验、快进或最小修复；不删整份配置。
  • 模型比较用同任务的成功率、总 token、延迟、工具调用和缓存成本。
  • 读发布消息分“明说 / 合理暗示 / 尚未说明”，翻译前对照原文。
  • 代理权限限定在授权的 workspace、账号与凭据；记忆只作近期上下文。

不能据此断言

  • 价格、套餐、席位、额度和年付条件（ChatGPT、Claude、MiniMax）：都是当时的时效信息。
  • 产品版本与命令：CC Switch v3.10.3、npm 2FA 与 Trusted Publishing 规则、Claude Code 安装命令、Chronicle 平台限制、内置生图模型名，均未核当前。
  • “Pro 比极高更适合长期任务”、80/15/5 配比、“Claude 只规划、Codex 只执行”：没有同任务对照。
  • WebUI 0xC0000006 和 ccswitch 额度减少的根因：只是候选，未证实。
  • 回退到 Codex CLI 0.152.1：单次实例，不是今天的降级指令。
  • 同一会话里的地缘冲突与 ETF 短线建议：2026-02 的历史预测，不属于可复用知识。

交互大图

AI 工具链全景

可缩放、搜索、聚焦路径。

从宿主客户端到上游服务与账单的分层，以及挂在旁边的工具、记忆和评测。新窗口打开

来源

本模块全部会话

点开看审读摘要和该会话的主张；数据由 tools/build_atlas.py 从审读账本生成。

主张浏览

全部审读主张

按性质筛选或搜索；点编号看条件与出处。