omnilane 0.10.1 → 0.10.3

package/README.zh-CN.md

@@ -21,41 +21,25 @@
 
 ---
 
-## 2026-07-25 更新
+## 🤔 omnilane 是什么?
 
-- 默认路由加入 `claude-opus-5`：成为 `hard-judgment`、`taste-final` 第一顺位，也纳入最高难度编程任务的备选。
-- `omnilane configure` 已扩展全部 13 个提供商：共 106 个可选模型，完整收录 Codex、Claude Code、Grok Build、Antigravity 实时列表，并加入已验证的 OpenRouter／OpenCode 快捷项；仍可用 `c` 输入自定义模型 ID。
+**问题在哪。** 你已经在用某个 AI 写代码助手——**Claude Code、Codex、Cursor、
+Gemini CLI** 之类。每一个都只接一个模型家族,所以你交代的每件事都跑在那同一个
+模型上,不管它合不合适:随手改个文件名烧掉最贵的模型,真正难的架构问题却刚好落在
+你当下开着的那个。
 
----
-## 👋 第一次用?
-
-你已经在用某个 AI 写程式助手——**Claude Code、Codex、Cursor、Gemini
-CLI** 之类。每个一次只接一个 AI 模型,而「每件工作该用哪个模型最好」得你自己决定。
-
-**omnilane 帮你决定。** 每一件工作,它会自动派给对那件事最强(也最省)的模型——硬派程式
-交给顶尖程式模型、随手的小检查交给又快又便宜的、长文件交给大脉络模型——全部用你本来就在
-付费的订阅与 API 金钥。用内建预设值就好,或改一个小设定档就能微调。不用另外顾一套东西
-(它躲在你现有工具背后跑),`./install.sh --uninstall` 可干净移除。
-
-**[⬇ 直接跳到 60 秒上手](#-60-秒上手)**
-
-## v0.10.0 新功能
+**omnilane 做什么。** 它给你的助手一张路由表。工作被分进**通道**——最难的实现、
+机械粗活、初筛、硬判断、文字终审——每条通道指名对那件事最强(也最省)的模型。
+助手保留自己本来就擅长的通道,其余用你既有的登录,在后台交给别家厂商的 CLI。
 
-- **Gemini 3.6 Flash 默认路由**——`fast-agentic`、`triage`、`bulk-mechanical`
-  的 gemini 候选(与 `Gemini Flash` 别名)改用 2026-07-21 发布的 Gemini 3.6
-  Flash:输出 token 更少、输出单价更低、Artificial Analysis 实测输出速度第一。
-- **证据重审计**——路由注释、模型能力笔记与 Gemini 价格表对官方来源刷新
-  (2026-07-21/22)。
-
-## v0.9.1 新功能
+**它不是什么。** 不是 proxy、不是另一笔订阅、不是又一个要维护的服务。它就是一张表
+加一支派工脚本,躲在你现有工具背后跑。`./install.sh --uninstall` 可完全清除。
 
-- **修复**:`configure set` 不再删除 `routing.local.yaml` 中手写的注释——
-  只改写自身的戳记行与被替换的 lane。
+**你不需要每一家订阅。** 每条通道都是候选链,派工时自动采用本机实际装了的第一个
+候选。装一家或七家都行,整条链都没有的通道就自动关闭,而不是报错。只有一份订阅
+时,整张默认表会收敛到那一家。
 
-## v0.9.0 新功能
-
-- **新增 5 个 OpenAI-compatible direct-API vendor** — `deepseek`、`zai`(GLM)、`mistral`、`groq`、`cerebras`,与 `openrouter` 同为免 CLI 通道(curl 加一把 `<VENDOR>_API_KEY`);`lib/common.sh` registry 一行即加一个。详见 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md)。
-- **fish shell 补全** — `omnilane completion fish | source`。
+**[⬇ 直接跳到 60 秒上手](#-60-秒上手)** · **[❓ 看常见问题](#-常见问题)**
 
 ## ⚡ 60 秒上手
 
@@ -119,10 +103,10 @@ flowchart LR
 
 | 通道 | 首选模型 | 备选模型 | 用途 |
 |---|---|---|---|
-| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (max) | 最难的实现、深度调试、正确性攸关的修改 |
+| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (xhigh) | 最难的实现、深度调试、正确性攸关的修改 |
 | 🏗️ bulk-mechanical | GPT-5.6 Terra (max) | Claude Sonnet 5 (high) | 重构、迁移、测试、大面积扫描——机械耐力活 |
 | 🧹 triage | GPT-5.6 Luna (medium) | Gemini 3.6 Flash (Low) | 高量初筛、第一轮过滤 |
-| ⚖️ hard-judgment | Claude Opus 5 (max) | GPT-5.6 Sol (max) | 架构仲裁、深度推理、第二意见 |
+| ⚖️ hard-judgment | Claude Opus 5 (xhigh) | GPT-5.6 Sol (max) | 架构仲裁、深度推理、第二意见 |
 | ✒️ taste-final | Claude Opus 5 (high) | GPT-5.6 Sol (max) | 对外文字、prompt 与文档打磨、风格终审 |
 | 💬 consult | 明确指定的厂商/模型 | —(不降级) | 自然语言直接咨询;必须保留 `--vendor` |
 | 🎨 ui-draft | GPT-5.6 Sol (xhigh) | Claude Opus 5 (high) | 有设计规范/参考图时的 UI 出稿;开放式视觉品味交给 taste-final |
@@ -132,13 +116,11 @@ flowchart LR
 | 🚰 coding-overflow | Grok 4.5 | Kimi K3 → Qwen3 Coder Plus → OpenCode | Codex 额度吃紧时的中量级编码溢流道;事实性声明须另行查证 |
 | 🗳️ arbitrate | off(可选评审团) | — | 内置意见评审团,重大决定用——默认关闭,要用在 `routing.local.yaml` 打开;每评审每轮烧一次额度 |
 
-**备选模型**是候选链的下一位——首选那家的厂商 CLI 没装时,派发就降到它。
+**备选模型**是候选链的下一位——首选那家的厂商 CLI 没装时,派发就降到它。每条
+通道都是这样一条链;整条都没装时,通道自动降为 `off`。
 
-> **Claude Fable 5 去哪了?** 默认表刻意不放:Claude 顶级档通常就是*主循环本人*,
-> 不是被派发的工人,且定价高于 Opus。这是成本/护栏/主循环策略,不代表能力
-> 不如 Opus;Anthropic 将 Fable 5 定位在 Opus 5 之上。设置菜单的模型清单里有它——
-> 不同意就自己路由过去(例如在 `routing.local.yaml` 写
-> `taste-final: claude claude-fable-5 high`)。
+> **Claude Fable 5 去哪了?** 默认表刻意不放——理由与完整数据见
+> [常见问题](#-常见问题)。
 
 ### 自然语言咨询
 
@@ -343,6 +325,121 @@ configure.sh set|get|unset|list|diff LANE [SPEC]    # 非交互编辑/查看 rou
   而不是永远显示 `running`。
 - **任务载荷上限** — 过大的任务文本自动头尾截断,防止撑爆工作端上下文。
 
+## ❓ 常见问题
+
+<details>
+<summary><b>这些订阅我全都要有吗?</b></summary>
+
+<br/>
+
+不用。每条通道都是候选链,派工时采用本机实际装了的第一个候选。只有一份订阅时,
+整张表会收敛到那一家;整条链都没有的通道自动关闭,不会报错。运行
+`omnilane doctor` 可以看到这台机器现在实际接得到什么,`routing.local.yaml.example`
+也附了常见情形的起手配置(只有 Claude、以 Codex 为主、没有 Codex)。
+
+</details>
+
+<details>
+<summary><b>omnilane 会不会把我的代码送到新的地方?</b></summary>
+
+<br/>
+
+不会多出新的去处。派工是调用你早就装好也登录过的厂商 CLI,所以代码只会到达
+你本来就在用的那几家。执行器在调用订阅制 CLI 前会剥掉 API 密钥环境变量,避免
+一把残留的密钥把你悄悄切到按 token 计费。唯一的例外是 direct-API vendor 家族
+(`openrouter`、`deepseek`、`zai`、`mistral`、`groq`、`cerebras`),它们本来就是
+拿你配置的密钥直调该提供商的 API——这几家只做 advise,不会改文件。
+
+</details>
+
+<details>
+<summary><b>Claude Fable 5 去哪了?为什么默认表不放它?</b></summary>
+
+<br/>
+
+**因为 Claude 顶级档通常就是主循环本人,不是被派发的工人。** 通道存在的意义,
+是把工作送给「你正在开的那个模型以外」的模型。如果 Fable 5 就是你的主循环,把
+判断和文字再路由回 Fable 5 只是多一次调用、毫无增益——所以上面那份「选你的主控
+模型」清单里,Fable 5 有自己独立的一行,身份是**主控**:自己做 hard-judgment、
+taste-final、最吃正确性的硬修。
+
+**测量数据也不支持把它当工人。** Artificial Analysis 智能指数(2026-07-24)
+Opus 5(max)61 分、Fable 5(max)60 分——AA 自己的用词是「实质打平」,而 Epoch AI
+的能力指数排序还是反过来的(Fable 5 161、Opus 5 159)。综合智力就当它平手。真正
+拉开差距的是 agentic 专业产出,而且差很多:
+
+| 评测 | Claude Opus 5 (max) | Claude Fable 5 | |
+|---|---:|---:|---|
+| AA-Briefcase(agentic 知识工作,Elo) | 1720 | 1574 | **+146** |
+| GDPval-AA v2(Elo) | 1861 | 1747 | **+114** |
+| AA-Briefcase 每任务成本 | $17.79 | $22.30 | **-20%** |
+| API 单价,输入/输出 每 1M | $5 / $25 | $10 / $50 | **一半** |
+
+Opus 5 的 max、xhigh、high 三个档位包揽 AA-Briefcase 前三名,连 `high` 档都在
+不到一半的每任务成本下赢过 Fable 5。也就是说,Fable 5 贵一倍,却换不到任何一条
+通道所在意的优势。
+
+**Fable 5 真正更强的地方**:事实广度。它在 AA-Omniscience 上仍领先 Opus 5
+(符合两者的规模差),而 Opus 5 在没把握时更倾向直接作答——幻觉率 50%,比
+Opus 4.8 高 14 个百分点。任务偏「回想」而非「执行」时,直接点名它:
+
+```bash
+dispatch.sh --vendor claude --model claude-fable-5 --effort high consult "…"
+```
+
+**这是成本与主循环策略的选择,不是能力判决。** 设置菜单的模型清单里有 Fable 5,
+在 `routing.local.yaml` 写一行就能覆盖默认:
+
+```yaml
+taste-final: claude claude-fable-5 high
+```
+
+</details>
+
+<details>
+<summary><b>Claude 那几条通道为什么用 <code>xhigh</code> 而不是 <code>max</code>?</b></summary>
+
+<br/>
+
+因为推理档位不是越高越好。Anthropic 官方把 `xhigh` 定为编码与 agentic 工作的
+起手档位,`high` 是其他吃智力任务的下限,`max` 保留给「正确性重于成本」的场合。
+第三方实测也一致:Vals.ai 的 Vibe Code Bench 上,Opus 5 在 `high` 拿 89.8%,
+`xhigh` 只有 88.3%、`max` 88.4%——最高档倾向产出更繁复的解,反而更常出错。
+你的工作类型如果不同意,单条通道自己拉高:
+
+```bash
+omnilane configure set hard-judgment "claude claude-opus-5 max"
+```
+
+</details>
+
+<details>
+<summary><b>通道首选的 CLI 没装会怎样?</b></summary>
+
+<br/>
+
+派工会沿着候选链往下走,用你手上有的第一家。不花任何额度就能先看决策:
+
+```bash
+scripts/dispatch.sh --explain hardest-coding   # 逐候选解释
+scripts/dispatch.sh --list                     # 整张生效表
+scripts/dispatch.sh --dry-run hardest-coding "…"   # 完整解析后的计划,不调用模型
+```
+
+</details>
+
+<details>
+<summary><b>被派工的模型会不会乱改我的文件?</b></summary>
+
+<br/>
+
+除非你明说要它改。派工默认是 `advise` 只读模式,而且是逐厂商实现的(只读沙箱、
+plan 模式,或只给只读工具集)。要改文件必须同时给 `--mode work` 和明确的
+`--workdir`。工作端也不能再往外派——深度守卫会用退出码 86 拒绝嵌套派工,一道
+命令不可能失控变成一整串 AI 烧你的额度。
+
+</details>
+
 ## 📊 默认值与数据来源
 
 默认通道配置依据 Artificial Analysis 2026-07 快照(已对 AA 站上原始记录与
@@ -350,7 +447,8 @@ configure.sh set|get|unset|list|diff LANE [SPEC]    # 非交互编辑/查看 rou
 设置菜单和 `routing.local.yaml` 就是让你不同意用的。评审团(arbitrate)
 默认关闭;要用就在 `routing.local.yaml` 写
 `arbitrate: vote codex,claude,grok -`(从四家里任选 1-4 个评审),
-或改用 `exec` 厂商指向你自己的多模型审查闸脚本。
+或改用 `exec` 厂商指向你自己的多模型审查闸脚本。完整工作笔记(含各评测的
+但书)见 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md)。
 
 ## ⚠️ 已知限制
 
@@ -364,8 +462,58 @@ configure.sh set|get|unset|list|diff LANE [SPEC]    # 非交互编辑/查看 rou
 
 ## 📜 版本历程
 
+## v0.10.3 新功能
+
+- **五种语言的 README 全面重整**——文档开头改成先讲清楚「这是什么、我为什么会
+  想要它」,版本历程全部收拢到最下方,不再打断开头的介绍;新增常见问题,回答
+  一直被问到的几件事:是不是每家订阅都要有、代码会被送去哪、为什么默认表没有
+  Fable 5、为什么用 `xhigh` 而不是 `max`、首选 CLI 没装会怎样、被派工的模型会不会
+  改文件。
+- **修复:插件清单的版本号没跟上**——`plugin.json` 与
+  `.claude-plugin/plugin.json` 在 0.10.1、0.10.2 发布后仍写着 `0.10.0`,导致插件
+  安装显示错误版本。
+- **修复:`routing.local.yaml.example` 还指着已退场的模型**——起手配置里的
+  `claude-opus-4-8` 全数改为 `claude-opus-5`(并按通道给对应档位),Gemini 3.5
+  Flash 候选改为 3.6 Flash,与 0.10.0 以来的默认值一致。
+- **对照原始资料修正智能指数数字**(`docs/model-capabilities-2026-07.md`):
+  那是指数点数不是百分比;补上 AA-Briefcase / GDPval-AA v2 对照,并记下两项与
+  默认值相反的结果:Fable 5 在事实知识领先、GPT-5.6 Sol 在呈现质量领先。
+
+## v0.10.2 新功能
+
+- **`hardest-coding` 与 `hard-judgment` 的 Claude 档位由 `max` 降为 `xhigh`**,
+  对齐 Anthropic 对 Claude Opus 5 的官方建议:编码与 agentic 工作从 `xhigh` 起跳,
+  `high` 是其他吃智力任务的下限,`max` 保留给正确性重于成本的场合。要拉回去用
+  `omnilane configure set <通道> "<配置>"`。
+- **修掉两条死的 CHANGELOG 比较链接**——它们指向从未发布的 `v0.10.0` tag。
+
+## v0.10.1 新功能
+
+- **默认路由加入 `claude-opus-5`**:成为 `hard-judgment`、`taste-final` 第一顺位,
+  也纳入最高难度编程任务的备选。
+- **`omnilane configure` 已扩展全部 13 个提供商**:共 106 个可选模型,完整收录
+  Codex、Claude Code、Grok Build、Antigravity 实时列表,并加入已验证的
+  OpenRouter／OpenCode 快捷项;仍可用 `c` 输入自定义模型 ID。
+
 <details>
-<summary>旧版本(v0.8.3 以前)</summary>
+<summary>旧版本(v0.10.0 以前)</summary>
+
+## v0.10.0 新功能
+
+- **Gemini 3.6 Flash 默认路由**——`fast-agentic`、`triage`、`bulk-mechanical`
+  的 gemini 候选(与 `Gemini Flash` 别名)改用 Gemini 3.6 Flash:输出 token
+  更少、输出单价更低、Artificial Analysis 实测输出速度第一。
+- **证据重审计**——路由注释、模型能力笔记与 Gemini 价格表对官方来源刷新。
+
+## v0.9.1 新功能
+
+- **修复**:`configure set` 不再删除 `routing.local.yaml` 中手写的注释——
+  只改写自身的戳记行与被替换的 lane。
+
+## v0.9.0 新功能
+
+- **新增 5 个 OpenAI-compatible direct-API vendor** — `deepseek`、`zai`(GLM)、`mistral`、`groq`、`cerebras`,与 `openrouter` 同为免 CLI 通道(curl 加一把 `<VENDOR>_API_KEY`);`lib/common.sh` registry 一行即加一个。详见 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md)。
+- **fish shell 补全** — `omnilane completion fish | source`。
 
 ## v0.8.3 新功能
 

package/README.zh-TW.md

@@ -21,44 +21,25 @@
 
 ---
 
-## 2026-07-25 更新
+## 🤔 omnilane 是什麼?
 
-- 預設路由加入 `claude-opus-5`：成為 `hard-judgment`、`taste-final` 第一順位，也納入最高難度程式任務的備援。
-- `omnilane configure` 已擴充全部 13 個供應商：共 106 個可選模型，完整收錄 Codex、Claude Code、Grok Build、Antigravity 即時清單，並加入已驗證的 OpenRouter／OpenCode 捷徑；仍可用 `c` 輸入自訂模型 ID。
+**問題在哪。** 你已經在用某個 AI 寫程式助手——**Claude Code、Codex、Cursor、
+Gemini CLI** 之類。每一個都只接一個模型家族,所以你交代的每件事都跑在那同一個
+模型上,不管它適不適合:隨手改個檔名燒掉最貴的模型,真正難的架構問題卻剛好落在
+你當下開著的那個。
 
----
-## 👋 第一次用?
-
-你已經在用某個 AI 寫程式助手——**Claude Code、Codex、Cursor、Gemini
-CLI** 之類。每個一次只接一個 AI 模型,而「每件工作該用哪個模型最好」得你自己決定。
-
-**omnilane 幫你決定。** 每一件工作,它會自動派給對那件事最強(也最省)的模型——硬派程式
-交給頂尖程式模型、隨手的小檢查交給又快又便宜的、長文件交給大脈絡模型——全部用你本來就在
-付費的訂閱與 API 金鑰。用內建預設值就好,或改一個小設定檔就能微調。不用另外顧一套東西
-(它躲在你現有工具背後跑),`./install.sh --uninstall` 可乾淨移除。
-
-**[⬇ 直接跳到 60 秒上手](#-60-秒上手)**
-
-## v0.10.0 新功能
+**omnilane 做什麼。** 它給你的助手一張路由表。工作被分進**通道**——最難的實作、
+機械粗活、初篩、硬判斷、文字終審——每條通道指名對那件事最強(也最省)的模型。
+助手保留自己本來就擅長的通道,其餘用你既有的登入,在背景丟給別家廠商的 CLI。
 
-- **Gemini 3.6 Flash 預設路由**——`fast-agentic`、`triage`、`bulk-mechanical`
-  的 gemini 候選(與 `Gemini Flash` 別名)改用 2026-07-21 發布的 Gemini 3.6
-  Flash:輸出 token 更少、輸出單價更低、Artificial Analysis 實測輸出速度第一。
-- **證據重稽核**——路由註解、模型能力筆記與 Gemini 價格表對官方來源刷新
-  (2026-07-21/22)。
-
-## v0.9.1 新功能
-
-- **修正**:`configure set` 不再刪掉 `routing.local.yaml` 裡手寫的註解——
-  只改寫自身的戳記行與被取代的 lane。
+**它不是什麼。** 不是 proxy、不是另一筆訂閱、不是又一個要顧的服務。它就是一張表
+加一支派工腳本,躲在你現有工具背後跑。`./install.sh --uninstall` 可完全清除。
 
-## v0.9.0 新功能
+**你不需要每一家訂閱。** 每條通道都是候選鏈,派工時自動採用本機實際裝了的第一個
+候選。裝一家或七家都行,整條鏈都沒有的通道就自動關閉,而不是報錯。只有一份訂閱
+時,整張預設表會收斂到那一家。
 
-- **五個 OpenAI-compatible direct-API vendor** — `deepseek`、`zai`(GLM)、
-  `mistral`、`groq`、`cerebras`,與 `openrouter` 同為免 CLI 通道(curl 加一把
-  `<VENDOR>_API_KEY`);`lib/common.sh` registry 一行即加一個。詳見
-  [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md)。
-- **fish shell 補全** — `omnilane completion fish | source`。
+**[⬇ 直接跳到 60 秒上手](#-60-秒上手)** · **[❓ 看常見問題](#-常見問題)**
 
 ## ⚡ 60 秒上手
 
@@ -122,10 +103,10 @@ flowchart LR
 
 | 通道 | 首選模型 | 備選模型 | 用途 |
 |---|---|---|---|
-| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (max) | 最難的實作、深度除錯、正確性攸關的修改 |
+| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (xhigh) | 最難的實作、深度除錯、正確性攸關的修改 |
 | 🏗️ bulk-mechanical | GPT-5.6 Terra (max) | Claude Sonnet 5 (high) | 重構、搬遷、測試、大面積掃描——機械耐力活 |
 | 🧹 triage | GPT-5.6 Luna (medium) | Gemini 3.6 Flash (Low) | 高量初篩、第一輪過濾 |
-| ⚖️ hard-judgment | Claude Opus 5 (max) | GPT-5.6 Sol (max) | 架構仲裁、深度推理、第二意見 |
+| ⚖️ hard-judgment | Claude Opus 5 (xhigh) | GPT-5.6 Sol (max) | 架構仲裁、深度推理、第二意見 |
 | ✒️ taste-final | Claude Opus 5 (high) | GPT-5.6 Sol (max) | 對外文字、prompt 與文件打磨、風格終審 |
 | 💬 consult | 明確點名的廠商/模型 | —(不降級) | 自然語言直接諮詢;必須保留 `--vendor` |
 | 🎨 ui-draft | GPT-5.6 Sol (xhigh) | Claude Opus 5 (high) | 有設計規範/參考圖時的 UI 出稿;開放式視覺品味交給 taste-final |
@@ -135,13 +116,11 @@ flowchart LR
 | 🚰 coding-overflow | Grok 4.5 | Kimi K3 → Qwen3 Coder Plus → OpenCode | Codex 額度吃緊時的中量級編碼溢流道;事實性宣稱須另行查證 |
 | 🗳️ arbitrate | off(選配評審團) | — | 內建意見評審團,重大決定用——預設關閉,要用在 `routing.local.yaml` 開;每評審每輪燒一次額度 |
 
-**備選模型**是候選鏈的下一位——首選那家的廠商 CLI 沒裝時,派工就降到它。
+**備選模型**是候選鏈的下一位——首選那家的廠商 CLI 沒裝時,派工就降到它。每條
+通道都是這樣一條鏈;整條都沒裝時,通道自動降為 `off`。
 
-> **Claude Fable 5 去哪了?** 預設表刻意不放:Claude 頂級檔通常就是*主迴圈本人*,
-> 不是被派發的工人,而且定價高於 Opus。這是成本/護欄/主迴圈策略,不代表能力
-> 不如 Opus;Anthropic 將 Fable 5 定位在 Opus 5 之上。設定選單的模型清單有列它——
-> 不同意就自己路由過去(例如在 `routing.local.yaml` 寫
-> `taste-final: claude claude-fable-5 high`)。
+> **Claude Fable 5 去哪了?** 預設表刻意不放——理由與完整數據見
+> [常見問題](#-常見問題)。
 
 ### 自然語言諮詢
 
@@ -359,11 +338,127 @@ codex/claude/grok/gemini 自選 1-4 個評審。開了之後,同一個問題丟
   而不是永遠顯示 `running`。
 - **任務酬載上限** — 過大的任務文字自動頭尾截斷,防止撐爆工作端脈絡。
 
+## ❓ 常見問題
+
+<details>
+<summary><b>這些訂閱我全都要有嗎?</b></summary>
+
+<br/>
+
+不用。每條通道都是候選鏈,派工時採用本機實際裝了的第一個候選。只有一份訂閱時,
+整張表會收斂到那一家;整條鏈都沒有的通道自動關閉,不會報錯。跑
+`omnilane doctor` 可以看到這台機器現在實際接得到什麼,`routing.local.yaml.example`
+也附了常見情境的起手設定檔(只有 Claude、以 Codex 為主、沒有 Codex)。
+
+</details>
+
+<details>
+<summary><b>omnilane 會不會把我的程式碼送到新的地方?</b></summary>
+
+<br/>
+
+不會多出新的去處。派工是呼叫你早就裝好也登入過的廠商 CLI,所以程式碼只會到達
+你本來就在用的那幾家。執行器在呼叫訂閱制 CLI 前會剝掉 API 金鑰環境變數,避免
+一把殘留的金鑰把你悄悄切到按 token 計費。唯一的例外是 direct-API vendor 家族
+(`openrouter`、`deepseek`、`zai`、`mistral`、`groq`、`cerebras`),它們本來就是
+拿你設定的金鑰直呼該供應商的 API——這幾家只做 advise,不會改檔。
+
+</details>
+
+<details>
+<summary><b>Claude Fable 5 去哪了?為什麼預設表不放它?</b></summary>
+
+<br/>
+
+**因為 Claude 頂級檔通常就是主迴圈本人,不是被派發的工人。** 通道存在的意義,
+是把工作送給「你正在開的那個模型以外」的模型。如果 Fable 5 就是你的主迴圈,把
+判斷和文字再路由回 Fable 5 只是多一次呼叫、毫無增益——所以上面那份「選你的主控
+模型」清單裡,Fable 5 有自己獨立的一列,身分是**主控**:自己做 hard-judgment、
+taste-final、最吃正確性的硬修。
+
+**量測數據也不支持把它當工人。** Artificial Analysis 智慧指數(2026-07-24)
+Opus 5(max)61 分、Fable 5(max)60 分——AA 自己的用詞是「實質打平」,而 Epoch AI
+的能力指數排序還是反過來的(Fable 5 161、Opus 5 159)。綜合智力就當它平手。真正
+拉開差距的是 agentic 專業產出,而且差很多:
+
+| 評測 | Claude Opus 5 (max) | Claude Fable 5 | |
+|---|---:|---:|---|
+| AA-Briefcase(agentic 知識工作,Elo) | 1720 | 1574 | **+146** |
+| GDPval-AA v2(Elo) | 1861 | 1747 | **+114** |
+| AA-Briefcase 每任務成本 | $17.79 | $22.30 | **-20%** |
+| API 單價,輸入/輸出 每 1M | $5 / $25 | $10 / $50 | **一半** |
+
+Opus 5 的 max、xhigh、high 三個檔位包辦 AA-Briefcase 前三名,連 `high` 檔都在
+不到一半的每任務成本下贏過 Fable 5。也就是說,Fable 5 貴一倍,卻換不到任何一條
+通道所在意的優勢。
+
+**Fable 5 真正比較強的地方**:事實廣度。它在 AA-Omniscience 上仍領先 Opus 5
+(符合兩者的規模差),而 Opus 5 在沒把握時更傾向直接作答——幻覺率 50%,比
+Opus 4.8 高 14 個百分點。任務偏「回想」而非「執行」時,直接點名它:
+
+```bash
+dispatch.sh --vendor claude --model claude-fable-5 --effort high consult "…"
+```
+
+**這是成本與主迴圈策略的選擇,不是能力判決。** 設定選單的模型清單有列 Fable 5,
+在 `routing.local.yaml` 寫一行就能覆寫預設:
+
+```yaml
+taste-final: claude claude-fable-5 high
+```
+
+</details>
+
+<details>
+<summary><b>Claude 那幾條通道為什麼用 <code>xhigh</code> 而不是 <code>max</code>?</b></summary>
+
+<br/>
+
+因為推理檔位不是越高越好。Anthropic 官方把 `xhigh` 定為編碼與 agentic 工作的
+起手檔位,`high` 是其他吃智力任務的下限,`max` 保留給「正確性重於成本」的場合。
+第三方實測也一致:Vals.ai 的 Vibe Code Bench 上,Opus 5 在 `high` 拿 89.8%,
+`xhigh` 只有 88.3%、`max` 88.4%——最高檔傾向產出更繁複的解,反而更常出錯。
+你的工作型態如果不同意,單條通道自己拉高:
+
+```bash
+omnilane configure set hard-judgment "claude claude-opus-5 max"
+```
+
+</details>
+
+<details>
+<summary><b>通道首選的 CLI 沒裝會怎樣?</b></summary>
+
+<br/>
+
+派工會沿著候選鏈往下走,用你手上有的第一家。不花任何額度就能先看決策:
+
+```bash
+scripts/dispatch.sh --explain hardest-coding   # 逐候選解釋
+scripts/dispatch.sh --list                     # 整張生效表
+scripts/dispatch.sh --dry-run hardest-coding "…"   # 完整解析後的計畫,不呼叫模型
+```
+
+</details>
+
+<details>
+<summary><b>被派工的模型會不會亂改我的檔案?</b></summary>
+
+<br/>
+
+除非你明講要它改。派工預設是 `advise` 唯讀模式,而且是逐廠商實作的(唯讀沙箱、
+plan 模式,或只給唯讀工具集)。要改檔必須同時給 `--mode work` 和明確的
+`--workdir`。工作端也不能再往外派——深度守衛會用退出碼 86 拒絕巢狀派工,一道
+指令不可能失控變成一整串 AI 燒你的額度。
+
+</details>
+
 ## 📊 預設值與資料來源
 
 預設通道配置依據 Artificial Analysis 2026-07 快照(已對 AA 站上原始紀錄與
 各廠官方定價頁交叉核對)加上公開對比評測;這些是意見不是定律——
-設定選單和 `routing.local.yaml` 就是讓你不同意用的。
+設定選單和 `routing.local.yaml` 就是讓你不同意用的。完整工作筆記(含各評測的
+但書)見 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md)。
 
 ## ⚠️ 已知限制
 
@@ -377,8 +472,61 @@ codex/claude/grok/gemini 自選 1-4 個評審。開了之後,同一個問題丟
 
 ## 📜 版本歷程
 
+## v0.10.3 新功能
+
+- **五種語言的 README 全面重整**——文件開頭改成先講清楚「這是什麼、我為什麼會
+  想要它」,版本歷程全部收攏到最下方,不再打斷開頭的介紹;新增常見問題,回答
+  一直被問到的幾件事:是不是每家訂閱都要有、程式碼會被送去哪、為什麼預設表沒有
+  Fable 5、為什麼用 `xhigh` 而不是 `max`、首選 CLI 沒裝會怎樣、被派工的模型會不會
+  改檔。
+- **修正:外掛資訊檔的版本號沒跟上**——`plugin.json` 與
+  `.claude-plugin/plugin.json` 在 0.10.1、0.10.2 發布後仍寫著 `0.10.0`,導致外掛
+  安裝顯示錯誤版本。
+- **修正:`routing.local.yaml.example` 還指著已退場的模型**——起手設定檔裡的
+  `claude-opus-4-8` 全數改為 `claude-opus-5`(並依通道給對應檔位),Gemini 3.5
+  Flash 候選改為 3.6 Flash,與 0.10.0 以來的預設值一致。
+- **對照原始資料修正智慧指數數字**(`docs/model-capabilities-2026-07.md`):
+  那是指數點數不是百分比;補上 AA-Briefcase / GDPval-AA v2 對照,並記下兩項與
+  預設值相反的結果:Fable 5 在事實知識領先、GPT-5.6 Sol 在呈現品質領先。
+
+## v0.10.2 新功能
+
+- **`hardest-coding` 與 `hard-judgment` 的 Claude 檔位由 `max` 降為 `xhigh`**,
+  對齊 Anthropic 對 Claude Opus 5 的官方建議:編碼與 agentic 工作從 `xhigh` 起跳,
+  `high` 是其他吃智力任務的下限,`max` 保留給正確性重於成本的場合。要拉回去用
+  `omnilane configure set <通道> "<設定>"`。
+- **修掉兩條死的 CHANGELOG 比較連結**——它們指向從未發布的 `v0.10.0` tag。
+
+## v0.10.1 新功能
+
+- **預設路由加入 `claude-opus-5`**:成為 `hard-judgment`、`taste-final` 第一順位,
+  也納入最高難度程式任務的備援。
+- **`omnilane configure` 已擴充全部 13 個供應商**:共 106 個可選模型,完整收錄
+  Codex、Claude Code、Grok Build、Antigravity 即時清單,並加入已驗證的
+  OpenRouter／OpenCode 捷徑;仍可用 `c` 輸入自訂模型 ID。
+
 <details>
-<summary>舊版本(v0.8.3 以前)</summary>
+<summary>舊版本(v0.10.0 以前)</summary>
+
+## v0.10.0 新功能
+
+- **Gemini 3.6 Flash 預設路由**——`fast-agentic`、`triage`、`bulk-mechanical`
+  的 gemini 候選(與 `Gemini Flash` 別名)改用 Gemini 3.6 Flash:輸出 token
+  更少、輸出單價更低、Artificial Analysis 實測輸出速度第一。
+- **證據重稽核**——路由註解、模型能力筆記與 Gemini 價格表對官方來源刷新。
+
+## v0.9.1 新功能
+
+- **修正**:`configure set` 不再刪掉 `routing.local.yaml` 裡手寫的註解——
+  只改寫自身的戳記行與被取代的 lane。
+
+## v0.9.0 新功能
+
+- **五個 OpenAI-compatible direct-API vendor** — `deepseek`、`zai`(GLM)、
+  `mistral`、`groq`、`cerebras`,與 `openrouter` 同為免 CLI 通道(curl 加一把
+  `<VENDOR>_API_KEY`);`lib/common.sh` registry 一行即加一個。詳見
+  [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md)。
+- **fish shell 補全** — `omnilane completion fish | source`。
 
 ## v0.8.3 新功能
 

package/VERSION

@@ -1 +1 @@
-0.10.1
+0.10.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omnilane",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "One routing table, every harness — classify subtasks into lanes and dispatch each lane to the best vendor's agentic CLI (Codex, Claude, Gemini, Grok) using your existing subscription logins.",
   "bin": {
     "omnilane": "bin/omnilane"

package/routing.local.yaml.example

@@ -8,7 +8,7 @@
 # consult is a multi-vendor direct-target chain. configure.sh intentionally
 # skips it because that menu writes one candidate per lane. If overriding it,
 # retain every vendor you want to address by name:
-# consult: codex gpt-5.6-sol max | claude claude-opus-4-8 high | grok grok-4.5 - | gemini "Gemini 3.1 Pro (High)" -
+# consult: codex gpt-5.6-sol max | claude claude-opus-5 high | grok grok-4.5 - | gemini "Gemini 3.1 Pro (High)" -
 
 # ── Starter profiles ─────────────────────────────────────────────
 # Uncomment ONE block that matches what you actually subscribe to.
@@ -16,12 +16,12 @@
 # in routing.yaml automatically.
 
 # Profile: Claude-only (no Codex/Gemini/Grok) — route everything to Claude.
-# hardest-coding:  claude claude-opus-4-8 high
+# hardest-coding:  claude claude-opus-5 xhigh
 # bulk-mechanical: claude claude-sonnet-5 high
 # triage:          claude claude-haiku-4-5 -
-# hard-judgment:   claude claude-opus-4-8 high
-# ui-draft:        claude claude-opus-4-8 high
-# long-context:    claude claude-opus-4-8 high
+# hard-judgment:   claude claude-opus-5 xhigh
+# ui-draft:        claude claude-opus-5 high
+# long-context:    claude claude-opus-5 high
 # fast-agentic:    claude claude-sonnet-5 high
 # live-search:     off - -
 # coding-overflow: off - -
@@ -32,10 +32,10 @@
 # taste-final:     claude claude-fable-5 high
 
 # Profile: Codex-heavy (Sol main) — keep the hard lanes on Codex, Claude for taste.
-# taste-final:     claude claude-opus-4-8 high
+# taste-final:     claude claude-opus-5 high
 # long-context:    codex gpt-5.6-sol high
 
 # Profile: no Codex subscription — promote Claude/Gemini into the coding lanes.
-# hardest-coding:  claude claude-opus-4-8 high
-# bulk-mechanical: gemini "Gemini 3.5 Flash (High)" -
-# triage:          gemini "Gemini 3.5 Flash (Low)" -
+# hardest-coding:  claude claude-opus-5 xhigh
+# bulk-mechanical: gemini "Gemini 3.6 Flash (High)" -
+# triage:          gemini "Gemini 3.6 Flash (Low)" -

package/routing.yaml

@@ -17,10 +17,10 @@
 # standard short-context API tier — on subscription CLIs treat $ as relative ranking.
 # Your own job outcomes (~/.omnilane/jobs/) outrank these priors; edit lanes to match.
 
-hardest-coding:  codex gpt-5.6-sol max | claude claude-opus-5 max  # Opus 5 xhigh is joint-first on AA Coding Agent Index (2026-07-24); max adds test-time compute for correctness-critical fallback. Keep Sol first for the established Codex harness lane.
+hardest-coding:  codex gpt-5.6-sol max | claude claude-opus-5 xhigh  # Opus 5 xhigh is joint-first on AA Coding Agent Index (2026-07-24) and is Anthropic's documented starting point for coding/agentic work; max shows diminishing returns and can overthink. Keep Sol first for the established Codex harness lane.
 bulk-mechanical: codex gpt-5.6-terra max | claude claude-sonnet-5 high | gemini "Gemini 3.6 Flash (High)" -  # AA Coding Agent Index v1.1: Terra 77.4 ~= Fable 77.2 at a fraction of the cost
 triage:          codex gpt-5.6-luna medium | gemini "Gemini 3.6 Flash (Low)" - | claude claude-haiku-4-5 -  # high-volume scans
-hard-judgment:   claude claude-opus-5 max | codex gpt-5.6-sol max   # AA Intelligence Index 2026-07-24: Opus 5 max 61, Sol max 59; Opus leads AA agentic knowledge-work benchmarks
+hard-judgment:   claude claude-opus-5 xhigh | codex gpt-5.6-sol max   # AA Intelligence Index 2026-07-24: Opus 5 61, Sol max 59; Opus leads AA agentic knowledge-work benchmarks. xhigh per Anthropic guidance (high is the documented floor for intelligence-sensitive work; max is for correctness-over-cost only) — raise to max locally via `omnilane configure set` if your workload needs it.
 taste-final:     claude claude-opus-5 high | codex gpt-5.6-sol max    # user-facing prose, prompt/doc polish, Chinese phrasing, style arbitration
 consult:         codex gpt-5.6-sol max | claude claude-opus-5 high | grok grok-4.5 - | gemini "Gemini 3.1 Pro (High)" -  # direct named-model consultation; use --vendor to prevent fallback
 ui-draft:        codex gpt-5.6-sol xhigh | claude claude-opus-5 high  # only with a design system / reference images; open-ended visual taste -> taste-final
@@ -33,9 +33,12 @@ arbitrate:       off - -                        # opinion panel is OPT-IN: it co
                                                 # Debate round (each voter rebuts the others): set the effort field to 2.
                                                 # Custom gate: `arbitrate: exec /path/to/script -`
 # Claude Fable 5 (claude-fable-5) is deliberately absent from the defaults: the top Claude tier
-# is usually the MAIN LOOP itself, not a dispatched worker, and it prices above Opus. This is a
-# cost / guardrail / main-loop policy choice, NOT a capability verdict — Anthropic positions
-# Fable 5 above Opus 4.8. If you want
+# is usually the MAIN LOOP itself, not a dispatched worker, and it prices at twice Opus 5
+# ($10/$50 vs $5/$25). This is a cost / guardrail / main-loop policy choice, NOT a capability
+# verdict — AA calls Opus 5 (61) and Fable 5 (60) "effectively tied" on the Intelligence Index
+# (2026-07-24) and Epoch AI ranks them the other way, but Opus 5 leads AA-Briefcase by 146 Elo
+# and GDPval-AA v2 by 114 Elo at 20% lower cost per task. Fable 5 does keep the lead on factual
+# breadth (AA-Omniscience), so name it explicitly for recall-heavy consults. If you want
 # to route to it anyway, pick it in the configurator or set e.g.
 #   taste-final: claude claude-fable-5 high
 # in ~/.omnilane/routing.local.yaml.