oh-my-openagent 文档漂移修正实战F2 审计修复清单与模型匹配链的源码级校准【免费下载链接】oh-my-openagentOmO: Just type mass ulw keyword with your prompt. Now you are the master of graph engineering.项目地址: https://gitcode.com/gh_mirrors/oh/oh-my-openagent在 oh-my-openagent 仓库中docs文档与packages源码之间的一致性由一套名为docs-drift-audit的定期审计机制保障审计发现差异后会为每个修复者fixer生成一份带精确行号与源码引用地址的修复指令。本文围绕.omo/evidence/20260809-docs-drift-audit/fix-instructions-f2.md展开逐条解读 F2 修复者负责的 5 份文档、30 项漂移修正从模型-代理匹配链的逐 rung 校准、已知问题状态的历史化归档到 Codex 遥测安装命令、lazycodex-ainpm 发布门槛与整体发布流程的文档同步。读完本文你将掌握如何以源码为锚点执行文档漂移审计、如何读懂内置代理与类别的模型回退链以及一份专业修复指令所要求的全局规则与交付物形态。修复任务的边界worktree、拥有文件与全局规则fix-instructions-f2.md首先用四条约束划定了修复者的工作边界这是整个审计流程的纪律基础约束内容工作目录只在指定的 worktree 中编辑禁止触碰其他分支拥有文件仅docs/guide/agent-model-matching.md、docs/reference/known-issues.md、docs/reference/codex-telemetry.md、docs/reference/lazycodex-npm-reservation.md、docs/reference/release-process.md五份文档全局规则每次编辑前重新核对引用re-verify each citation发现不匹配则跳过并记入报告最小编辑仅 ASCII禁用 em dash无法验证的条目一律不动交付物编辑完成后产出/tmp/omo-docs-drift/fix-report-f2.md逐项标记 FIXED / SKIPPED这套规则的本质是证据优先、宁缺毋滥文档中的每个模型名、每个提供商列表、每行配置都必须能在源码中逐字找到依据找不到依据的表述要么被改写要么被跳过并记录而不是凭印象修正。这正是文档漂移审计区别于普通校对的核心差异。模型-代理匹配文档的 20 项校准agent-model-matching.md 是 F2 修复工作量最大的文档20 项指令其核心矛盾是模型生态快速演进GPT-5.6 Sol、Kimi K3、GLM 5.2、MiniMax M 系列等而内置回退链的定义在 agent-model-requirements.ts 中持续变化文档容易停留在旧版本。GPT-5.6 Sol 成为新主角三项修正把 GPT-5.6 Sol 推到了文档的前台Sisyphus 的第三自动 rung原文档写Sisyphus uses Claude, Kimi, and GLM修正后必须补上 GPT-5.6 Sol。从源码看Sisyphus 的完整回退链确实包含四个自动 rungagent-model-requirements.tssisyphus: { fallbackChain: [ { providers: [anthropic, github-copilot, opencode], model: claude-opus-5, variant: max }, { providers: [opencode-go, kimi-for-coding, moonshotai, opencode, bailian-coding-plan, ...], model: kimi-k3 }, { providers: [openai, openai-codex, github-copilot, opencode], model: gpt-5.6-sol, variant: medium }, { providers: [zai-coding-plan, opencode, bailian-coding-plan], model: glm-5.2 }, { providers: [opencode], model: big-pickle } ], requiresAnyModel: true, }Hephaestus 是 Sol-only 单 rung 代理修正指令明确Hephaestus requires the GPT-5.x family应改为Hephaestus 只有一个自动模型 GPT-5.6 Sol且不存在 GPT-5.4 / 5.5 回退。源码证实了这一点agent-model-requirements.tshephaestus的fallbackChain仅含一个gpt-5.6-sol (medium)rung并带有requiresProvider声明要求连接 openai / openai-codex / github-copilot / opencode 之一。Prometheus 没有 GPT rung文档中原把 Prometheus 列入 GPT 路径列表但源码中 Prometheus 的链只有 Claude Fable 5.1xhigh→ Kimi K3max两个 rungagent-model-requirements.ts没有任何 GPT 模型因此必须从 GPT 路径列表中移除。Sisyphus 丢失链与 Kimi K2.7 的重新定位修正指令第 7 项是典型的口径纠偏原文档声称Sisyphus 丢失 Claude 时应回退 Kimi K3、Kimi K2.7、GLM 5.2、Big Pickle 并避免 GPT。修正后的真实链是Kimi K3 → GPT-5.6 Sol (medium) → GLM 5.2 → big-pickle且K2.7 不是任何内置链的自动 rung——它只是手册/目录catalog选项所有内置链现在都使用 K3。同类纠偏还有丢失 GPT-5.4/5.5/5.6 应回退 DeepSeek v3.2不成立没有任何内置 deep-agent 链使用 DeepSeek v3.2。各代理的实际链不同——Hephaestus 是 Sol-onlyOracle 则是 Sol → Gemini 3.1 Pro → Claude Opus 5 → GLM 5.2agent-model-requirements.ts。Kimi K3 重复行合并文档中两行重复的 Kimi K3 应合并为一行Kimi K2.7 行改为手动/目录选项不在任何内置链中。GPT-5.6 Sol 是关键回退的表述收窄在具名代理中只有 Atlas 的链包含 GPT 回退 runggpt-5.6-sol (medium)见 agent-model-requirements.ts因此该表述必须限定到 Atlas。Explore / Librarian 的精确链与 MiniMax 家族Explore 与 Librarian 的链在源码中完全一致agent-model-requirements.ts修正要求文档照此补全gpt-5.6-luna-fast (low) → deepseek-v4-flash (max) ← 紧跟在 Luna Fast 之后插入 → qwen3.7-plus → minimax-m3 / MiniMax-M3 → minimax-m2.7 ← 与 gpt-5.4-nano 一同纳入 rung 列表 → claude-haiku-4-5 → gpt-5.4-nano细节修正包括首个gpt-5.6-luna-fastrung 必须标注(low)变体MiniMax M2.7 通过 OpenCode Go 与 OpenCode Zen 使用改为opencode-go 与 vercel两个提供商MiniMax M2.7 Highspeed 是 OpenCode 目录条目改为vercel-only 回退 rung。MiniMax 的使用范围也随之扩大文档原称MiniMax 仅用于 Explore 和 Librarian实际还用于Atlas 与 Sisyphus-Junior后者在 agent-model-requirements.ts 中还有big-pickle收尾 rung。visual-engineering 链与 GLM 使用边界类别侧的链定义在 category-model-requirements.ts 中visual-engineering的 Opus rung 提供商集合为anthropic / anthropic-api / github-copilot / opencode。修正指令要求文档侧补齐第四 runggpt-5.6-sol (medium)与deep类别的gpt-6-astra (high) → gpt-5.6-sol (medium)结构一致并把 GLM 5.2 的活跃使用行收敛为Sisyphus、Oracle、MomusPrometheus、Metis 等代理的链中没有 GLM rung见 agent-model-requirements.ts。Sisyphus 的 GLM 5.2 rung 提供商则从opencode-go修正为直接编码计划提供商agent-model-requirements.ts 中为zai-coding-plan / opencode / bailian-coding-plan。注入顺序值与默认值的源码级核对修正指令第 20 项最为隐蔽文档中代理注入的order值 0,1,2,3 应改为 1,2,3,4。源码给出了确定性证据——agent-priority-order.ts 中reorderAgentsByPriority以index 1注入序号for (const [index, displayName] of orderedDisplayNames.entries()) { if (Object.prototype.hasOwnProperty.call(agents, displayName)) { ordered[displayName] injectOrderField(agents[displayName], index 1) seen.add(displayName) } }从 0 基索引加 1实际注入值必然是 1,2,3,4文档写 0,1,2,3 属于复制粘贴层面的漂移。而报告中的:259与:335-337两条unspecified-low 的 Luna 默认值则被REJECTED因为类别的默认值确实是openai/gpt-5.6-luna:xhigh见 delegate-task 类别定义 的默认配置只有需求链从 Terra high 起步——这不是文档错误因此修复者被明确要求Leave those lines。这一节展示了审计流程的完整性不是所有差异都要修源码说了算。已知问题文档的 6 项状态修正known-issues.md 的修正模式与模型文档不同它处理的是问题生命周期状态即已解决的历史问题不应再以开放问题形式误导读者。修正指令内容当前文档状态Ralph LooppromiseVERIFIED/promise探测问题降级为历史/已解决注释Ralph Loop 不再接入当前 session hooksGoal 子系统不使用该探测器#5839已标记 Resolved内置 GPT-5.5 推理强度冲突内置链已改用 GPT-5.6 Sol仅保留为手动自定义提供商/上游 OpenCode 的注意事项#5529降级为 caveatrequired-model 未固定子问题标记已解决必需代理在可用性门禁失败时会被跳过#5604已标记 ResolvedLSP 配置位置支持的配置文件收敛为.opencode/lsp.json、.omo/lsp.json、.omo/lsp-client.json或用户级lsp.json#4225工作区列表已更新Ralph Loop 日志洪水历史/已解决注释Goal 已取代 Ralph Loop#5105已标记 ResolvedWindows Bun.serve 问题运行时技能源服务器在 Bun.serve 不可用时回退到 Node HTTP#5025已标记 Resolved源码证据清晰可查LSP 配置列表定义在 mcp/lsp.ts 的PROJECT_LSP_CONFIGS [.opencode/lsp.json, .omo/lsp.json, .omo/lsp-client.json]Ralph Loop 的保留但未接线状态可以从 hooks/index.ts 看到——createRalphLoopHook与createGoalHook同时被导出但当前会话接线只走 Goal 路径。修正指令专门提醒Ralph Loop 目录hooks/ralph-loop虽然保留但它已经是历史组件文档必须避免让读者以为它仍在生效。发布链路三份文档的修正Codex 遥测从 npx 到 bunx 的运行时策略对齐codex-telemetry.md 只有一项修正安装命令从npx lazycodex-ai install改为bunx lazycodex-ai install。理由是仓库运行时策略Bun-first且publish.yml发布流程会随包分发lazycodex-ai的 bin。当前文档中两处来源install与plugin均已使用bunx表述。这份文档其余内容如遥测事件omo_codex_daily_active、每日去重状态文件~/.local/share/omo-codex/posthog-activity.json、OMO_CODEX_DISABLE_POSTHOG与OMO_DISABLE_POSTHOG两级退出开关不受修正影响保持了仅发送匿名日活、绝不含提示词内容与密钥的隐私边界可参见 隐私政策。lazycodex-ai npm 保留可信发布成为硬门槛lazycodex-npm-reservation.md 的两项修正属于流程升级trusted-publisher 预检从软性建议升级为硬门槛publish.yml的 preflight-trust 阶段对所有入选发布包含lazycodex-ai强制执行缺少可信发布配置会直接导致预检失败并阻断发布。因此原文档中手动npm publishNPM_AUTH_TOKEN的 playbook 必须删除改为先在 npm 侧配置 GitHub Actions 可信发布Provider 为 GitHub ActionsOrganization 为code-yeongyuRepository 为oh-my-openagentWorkflow 为publish.yml然后完全通过工作流发布。拆分触发条件明确化仓库推送与 GitHub Release 是两个独立事件——当生成文件与 marketplace 仓库不同时推送code-yeongyu/lazycodex仓库只有当生成载荷与上一个lazycodex-ainpm 载荷比较有变化时才创建 GitHub Release。两者都需要LAZYCODEX_SYNC_TOKEN密钥。文档还维护了lazycodex版本命名空间的保留规则LazyCodex-only 发布必须使用带保留后缀的版本如5.0.0-beta.62.lazycodex.1或5.0.0-lazycodex.1正常 omo 发布会拒绝该标识符双向互斥。预检诊断的重试预算OIDC 每次 30 秒超时、最多 6 次尝试、1/2/4/8/16 秒退避也是文档记录的可操作细节。发布流程版本由工作流计算而非手工预置release-process.md 的修正纠正了一个流程误区原文档称版本提升与包元数据必须已存在于发布分支实际流程是工作流计算版本 → 在 release-state 分支上盖章包元数据 → 打开并合并 release-state PR → 从准备好的 SHA 重新发布。这正是 publish.yml 中双 dispatch 设计的文档化表达第一次 dispatch 的prepared_release_sha为空执行门禁、准备或复用 release 状态、创建/校验 tag然后从该 tag 发起第二次 dispatch第二次 dispatch 携带精确的prepared_release_sha只有这次运行能执行平台发布、主包发布与 release 创建。同时文档强调幂等守卫重复 tag 复用、npm 已发布探测、marketplacegit diff --cached --quiet跳过无变化提交与恢复纪律gh run rerun --failed run-id仅用于瞬态失败一旦出现 release commit、tag 或 npm 发布必须恢复既有 run 而不是新开一次绝不手工发布 npm 包或手工移动 release tag。方法论沉淀cite → verify → edit → report从这份 F2 指令可以提炼出可复用的文档漂移修复循环cite定位每条修正都带精确锚点文档行号 源码引用例如agent-model-requirements.ts:12-28。verify验证编辑前重新核对引用是否仍成立源码与文档双重确认任何一方不匹配就跳过并记录而不是猜测。edit最小编辑只改差异点保持 ASCII、不用 em dash避免引入与主题无关的重写。report报告交付fix-report-*.md逐项标记 FIXED / SKIPPED直到全部条目解决STOP WHEN all items resolved。这套循环的价值在于文档修正不再是文笔问题而是可验证的工程问题。每条表述都能指回一个源码文件每个 REJECTED 条目都带一句源码证据。对维护者而言这意味着文档可以像代码一样被 review、被回归测试对使用者而言模型匹配文档中的每一条链、每个提供商列表都是运行时真实行为的镜像。延伸阅读模型-代理匹配指南三个模型配置档位、提示词预设与安全/风险覆盖对照已知问题已解决条目的历史化写法Codex Light 遥测匿名日活事件与退出开关lazycodex-ai npm 发布手册版本命名空间与可信发布门槛发布流程双 dispatch、幂等守卫与恢复纪律源码锚点内置代理回退链、类别回退链、内置模型配置档位、代理-模型需求定义、类别-模型需求定义【免费下载链接】oh-my-openagentOmO: Just type mass ulw keyword with your prompt. Now you are the master of graph engineering.项目地址: https://gitcode.com/gh_mirrors/oh/oh-my-openagent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考