refresh-toolchainlisted

# 工具版本核对与更新 把 Claude Code 与 Codex 的最新变化,核对并回写进本知识库。 ## 为什么需要这套流程 这个知识库的核心卖点是"每条结论都有出处、不瞎编"。AI 工具迭代极快(Claude Code 大约 1-2 天一个版本),一旦指南里的命令改了名、默认值变了、语义反转了而没跟上,**它就从"资料"变成了"错误信息"**——读者照着做会踩坑,这比没有这个知识库更糟。 所以这套流程的重点不是"把新东西加上",而是**反查旧内容有没有被推翻**。 ## 第 0 步:确认当前日期(不能跳过) ```bash date +%Y-%m-%d ``` 必须先拿到真实当前日期。跳过这一步会导致基于过时认知判断"这算不算新",是最容易犯的错。 同时读出上次核对日期(在页面顶栏和 hero 徽章里): ```bash grep -o "核对至 [0-9-]*" topics/claude-code-guide.html topics/codex-guide.html topics/toolchain-changelog.html ``` 本次要覆盖的时间范围 = 上次核对日期 → 今天。 ## 第 1 步:拉官方 changelog 只信这两个一手源: | 工具 | 官方 changelog | |---|---| | Claude Code | `https://code.claude.com/docs/en/changelog` | | Codex | `https://learn.chatgpt.com/docs/changelog` | 用 WebFetch 拉取,prompt 里明确写出时间范围,并要求重点提取:新模型、新斜杠命令、新 CLI 参数、子代理/MCP/hooks/沙箱权限的变化、以及**任何标记为 breaking 或 deprecated 的条目**。 Codex 官方 changelog 偏 App 侧,CLI 细节不足时补充搜索,但**二手源只能用来发现线索,不能直接作为写入依据**——凡是要写进"破坏性变更"表的,必须在官方源核对过。 ## 第 2 步:三分类筛选 | 分类 | 标准 | 标记 | |---|---|---| | 破坏性变更 | 老写法/老命令/老配置会失效或行为反转 | 🔴 | | 行为变化 | 命令参数都还在,但结果或时机变了 | 🔄 | | 新增能力 | 新命令、新配置项、新模型 | 🆕 | **不收录**:纯内部重构、性能优化(除非可感知)、极小众平台修复(除非很多人会踩,如 Windows 路径)、预览/实验特性(等 GA)。 宁可少收也不要收错——这一页的价值在可信度,不在完整度。 ## 第 3 步:反查旧内容(最容易漏,别跳) 拿着第 2 步筛出来的变化列表,**逐条反查两份指南的正文有没有因此变错**: - 命令改名了 → 全文搜旧命令名,确认每处的语义 - 默认值变了 → 搜相关配置项与表格 - 模型换代了 → 搜型号字符串(如 `gpt-5.4`、`Opus 4.8`),包括代码块与配置示例里的 - 参数选项增删 → 搜参数表 ```bash # 示例:核查模型型号是否还有旧的残留 grep -n "Opus 4\.\|gpt-5\.4\|Sonnet 4" topics/claude-code-guide.html topics/codex-guide.html ``` **发现正文写错的,优先级高于新增内容**。