omnilane 0.8.3 → 0.9.1

package/README.zh-CN.md

@@ -21,92 +21,50 @@
 
 ---
 
-## v0.8.3 新功能
+## 👋 第一次用?
 
-- **MCP server** — `omnilane mcp` 启动零依赖的 stdio MCP server,任何支持
-  MCP 的宿主(Claude Code、Codex、Gemini CLI、Cursor、OpenCode……)无需安装
-  skill 即可发现并调用 omnilane:提供 `route`、`jobs_status`、`jobs_result`、
-  `list_lanes` 四个工具。`route` 默认只读 advise 模式;work 模式必须明确
-  指定 workdir。
+你已经在用某个 AI 写程式助手——**Claude Code、Codex、Cursor、Gemini
+CLI** 之类。每个一次只接一个 AI 模型,而「每件工作该用哪个模型最好」得你自己决定。
 
-## v0.8.2 新功能
+**omnilane 帮你决定。** 每一件工作,它会自动派给对那件事最强(也最省)的模型——硬派程式
+交给顶尖程式模型、随手的小检查交给又快又便宜的、长文件交给大脉络模型——全部用你本来就在
+付费的订阅与 API 金钥。用内建预设值就好,或改一个小设定档就能微调。不用另外顾一套东西
+(它躲在你现有工具背后跑),`./install.sh --uninstall` 可干净移除。
 
-- **`openrouter` vendor** — 只需 `curl` 加一个 `OPENROUTER_API_KEY`,
-  即可直连 OpenRouter API 派工:任何 omnilane 安装都能访问数百个
-  托管模型,无需再装任何代理 CLI。仅限 advise/consult(不能改文件,
-  work 模式会明确报错指路),模型 slug 必填,例如
-  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`。
-- **`opencode` vendor** — 通过 OpenCode 多供应商聚合 CLI 无头派工
-  (`opencode run`)。advise 模式锁定内置只读 `plan` agent;work 模式
-  用 `--auto`。加入默认 `coding-overflow` 链作为最后回退。
+**[⬇ 直接跳到 60 秒上手](#-60-秒上手)**
 
-## v0.8.1 新功能
+## v0.9.1 新功能
 
-- **Claude Code 插件开场自动载入路由提醒** — 插件新增 `SessionStart`
-  hook(`hooks/hooks.json`),在会话开始(`startup|resume|clear`)时自动
-  注入路由提醒,安装插件即生效,无需修改 `~/.claude/CLAUDE.md`。其他
-  CLI 仍使用 `install.sh` 的指令文件提醒。
+- **修复**:`configure set` 不再删除 `routing.local.yaml` 中手写的注释——
+  只改写自身的戳记行与被替换的 lane。
 
-## v0.8.0 新功能
-
-- **两个新派工 vendor** — `kimi`(Moonshot Kimi Code CLI)与 `qwen`
-  (Alibaba Qwen Code CLI)加入,沿用统一 runner 契约:advise 只读、
-  work 自动批准、剥除 API key 环境变量改用 CLI 自身订阅登录、空输出
-  视为失败。可用 `--vendor kimi|qwen` 直接指定。
-- **coding-overflow 新增备选链** — 额度溢流道改为 grok → kimi → qwen
-  再到 `off`,三家装任一家即可用。runner 以假可执行文件完成契约测试;
-  欢迎反馈真实模型实测结果。
+## v0.9.0 新功能
 
-## v0.7.1 新功能
+- **新增 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`。
 
-- **路由表更新(2026-07 模型数据)** — hardest-coding 首选改为 GPT-5.6 Sol
-  **max** 档位:Artificial Analysis Coding Agent Index v1.1 测得 Sol (max)
-  80 分为当前最高,替换旧的「xhigh 胜 max」快照。
-- **Claude 备选升档** — hardest-coding 与 hard-judgment 的 Claude Opus 4.8
-  备选改为 **xhigh**,依 Anthropic 官方对困难任务与长时间工作的建议。
-
-## v0.7.0 新功能
-
-- **先预览再派工** — `--dry-run` 打印完整解析后的派工计划(vendor、模型、
-  模式、超时、副作用判定),不调用模型、不创建作业状态。
-- **版本化 JSON 自动化** — `--list`/`--explain`/`--validate` 与
-  `jobs list|status|result|stats` 都提供 `--json` 信封;另有只读 `jobs wait`、
-  `jobs audit`,以及带可复现 manifest 的离线 `omnilane release-audit` 发布审计。
-- **本地作业一条龙** — `jobs tail` 查看实时输出、`jobs retry` 以 fail-closed
-  方式重派已完成作业、`prune --older-than` 按时间清理,`--help` 覆盖所有命令。
-- **安装与补全更安全** — `install.sh --check`/`--dry-run` 只读报告漂移,
-  `omnilane completion bash|zsh` 提供安全的 tab 补全,并修复五个 macOS 自带
-  Bash 3.2 崩溃。
-
-## v0.6.0 新功能
-
-- **离线理解并验证路由** — 使用 `--explain` 查看每个备用候选，或使用
-  `--validate` 检查完整生效路由表；都不会调用模型或创建作业状态。
-- **用机器可读数据观察本地状态** — `jobs.sh stats` 提供有界统计，
-  `omnilane doctor --json` 提供健康检查，同时不会泄漏任务或结果正文。
-- **在 Live Board 比较两条作业** — 将一条已加载作业固定为仅存在于内存中的
-  参考快照，并排比较模型路径与公开结果。
-- **让锁恢复更安静** — 所有者文件在检查与读取之间消失时，不再泄漏容易误判的
-  缺失文件诊断，同时保持 fail-closed。
+## ⚡ 60 秒上手
 
-## v0.5.1 新功能
+**最快的方式——用 npm 装:**
 
-- **在非 Git 目录使用 Codex work** — 普通文件夹仍完整支持；Omnilane 不要求，
-  也绝不会自动执行 `git init`。
-- **干净停止非 Git 卡死** — 未设置整体上限时，解析后的单次看门狗会自动成为
-  进程组保险丝，同时保留手动 timeout 的优先级和退出码语义。
-- **让版本显示可信** — `VERSION` 现在统一提供给 `omnilane --version` 和两份
-  plugin manifest，CI 会检查变更记录和五种语言 README 是否一致。
+```bash
+npm i -g omnilane                                    # 装 CLI
+omnilane route hardest-coding "修掉会间歇失败的 auth token 更新测试"
+omnilane doctor                                      # 看你手上有哪些 AI CLI / 金钥
+omnilane ui start                                    # 选配:在浏览器即时看派工
+```
 
-## ⚡ 60 秒上手
+**或 clone 整包**(拿到路由表与可自订的技能):
 
 ```bash
 git clone https://github.com/Seraphim0916/omnilane && cd omnilane
-./install.sh          # 检测你的 CLI、接好技能、说你的语言
-omnilane route hardest-coding "修掉间歇失败的 auth token 刷新测试"
-omnilane ui start     # 可选:在浏览器实时查看派发
+./install.sh          # 侦测你的 CLI、接好技能、说你的语言
+omnilane route hardest-coding "修掉会间歇失败的 auth token 更新测试"
 ```
 
+> 第一次用?先跑 `omnilane doctor`——它会告诉你 omnilane 现在能接到哪些模型 CLI 与
+> API 金钥,你就知道实际会跑什么。
+
 ## 🧭 工作原理
 
 omnilane 让**任何**一个 agentic CLI 的主循环把子任务分类到通道(lane),
@@ -131,6 +89,8 @@ flowchart LR
   调用对应厂商的 CLI。`--vendor` 会锁定指定厂商，不做降级。
 - **`skills/omnilane/SKILL.md`** — 一份技能四个框架都能加载:
   先认出自己是哪个模型,自己通道的活自己干,其余派出去。
+- **`omnilane mcp`** — 同一套路由改以 MCP stdio server 提供,
+  给走 MCP 而非 skill 集成的宿主。
 
 <div align="center">
 
@@ -267,10 +227,13 @@ Esc。服务器发送事件(SSE)会实时更新，又不会重建当前聚焦的
 }
 ```
 
-Server 提供 `route`、`jobs_status`、`jobs_result`、`list_lanes` 四个工具。
+Server 提供 `route`,以及一组只读查询工具:`list_lanes`、`explain`、`validate`、`dry_run`、`jobs_list`、`jobs_status`、`jobs_result`、`jobs_stats`、`jobs_audit`、`doctor`。
 `route` 默认只读 `advise` 模式;选择 `work` 的调用必须同时提供明确的
 `workdir`。
 
+唯一的运行需求是 Node.js(不装任何 npm 包);也可以直接
+`npm install -g omnilane`,CLI 连同 MCP server 一起装好。
+
 ## ⚙️ 自定义设置
 
 三层,全部可选:
@@ -295,6 +258,8 @@ scripts/dispatch.sh --list     # 生效表,标出候选链降级与关闭的通
 ```
 eval "$(omnilane completion bash)"             # 在当前 Bash 启用补全
 source <(omnilane completion zsh)               # 在当前 Zsh 启用补全
+omnilane completion fish | source
+omnilane mcp                                   # MCP stdio server(需 Node.js)
 omnilane release-audit [--target 版本] [--json]     # 离线、只读的发布闸门
 omnilane ui start                              # 启动或复用本地 Live UI,输出链接
 omnilane ui status                             # 查看 Live UI 是否正在运行
@@ -308,11 +273,15 @@ dispatch.sh [--json] --list [--json]
 dispatch.sh [--json] --explain 通道 [--json]       # 离线逐候选解释路由决策
 dispatch.sh [--json] --validate [--json]           # 离线检查生效路由，不调用模型
 jobs.sh [--json] {list | status 作业ID | result 作业ID} # JSON 结果只回元数据，不回正文
+jobs.sh [--json] list [--lane L] [--vendor V] [--status running|done]  # 过滤列表
 jobs.sh wait 作业ID [--timeout N]                  # 作业退出码；124 超时；125 工作进程消失
-jobs.sh [--json] stats [--last N]                  # 本机成功率与路由汇总
+jobs.sh cancel 作业ID                              # 停止运行中的作业:整组 SIGTERM,再 SIGKILL
+jobs.sh rm 作业ID                                  # 删除单个已完成/已死作业(运行中会被拒绝)
+jobs.sh [--json] stats [--last N] [--lane L] [--vendor V]  # 本机成功率与路由汇总
 jobs.sh audit [--last N] [--json]                  # 只读检查作业完整性与隐私
 jobs.sh prune [--keep N] [--apply]                # 默认仅预览；只清理已完成作业
 configure.sh                                        # 交互通道菜单
+configure.sh set|get|unset|list|diff LANE [SPEC]    # 非交互编辑/查看 routing.local.yaml
 ```
 
 退出码:`2` 用法错误(包括厂商值无效,或指定厂商不在该通道)、`3` 通道已关闭、
@@ -378,14 +347,93 @@ configure.sh                                        # 交互通道菜单
   外卡住，因此上面的自动保险丝会限制这个场景并清理受监工的进程组。Omnilane
   不会自动执行 `git init`，也不要求用户创建仓库。
 
+## 📜 版本历程
+
+<details>
+<summary>旧版本(v0.8.3 以前)</summary>
+
+## v0.8.3 新功能
+
+- **MCP server** — `omnilane mcp` 启动零依赖的 stdio MCP server,任何支持
+  MCP 的宿主(Claude Code、Codex、Gemini CLI、Cursor、OpenCode……)无需安装
+  skill 即可发现并调用 omnilane:提供 `route`、`jobs_status`、`jobs_result`、
+  `list_lanes` 四个工具。`route` 默认只读 advise 模式;work 模式必须明确
+  指定 workdir。
+
+## v0.8.2 新功能
+
+- **`openrouter` vendor** — 只需 `curl` 加一个 `OPENROUTER_API_KEY`,
+  即可直连 OpenRouter API 派工:任何 omnilane 安装都能访问数百个
+  托管模型,无需再装任何代理 CLI。仅限 advise/consult(不能改文件,
+  work 模式会明确报错指路),模型 slug 必填,例如
+  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`。
+- **`opencode` vendor** — 通过 OpenCode 多供应商聚合 CLI 无头派工
+  (`opencode run`)。advise 模式锁定内置只读 `plan` agent;work 模式
+  用 `--auto`。加入默认 `coding-overflow` 链作为最后回退。
+
+## v0.8.1 新功能
+
+- **Claude Code 插件开场自动载入路由提醒** — 插件新增 `SessionStart`
+  hook(`hooks/hooks.json`),在会话开始(`startup|resume|clear`)时自动
+  注入路由提醒,安装插件即生效,无需修改 `~/.claude/CLAUDE.md`。其他
+  CLI 仍使用 `install.sh` 的指令文件提醒。
+
+## v0.8.0 新功能
+
+- **两个新派工 vendor** — `kimi`(Moonshot Kimi Code CLI)与 `qwen`
+  (Alibaba Qwen Code CLI)加入,沿用统一 runner 契约:advise 只读、
+  work 自动批准、剥除 API key 环境变量改用 CLI 自身订阅登录、空输出
+  视为失败。可用 `--vendor kimi|qwen` 直接指定。
+- **coding-overflow 新增备选链** — 额度溢流道改为 grok → kimi → qwen
+  再到 `off`,三家装任一家即可用。runner 以假可执行文件完成契约测试;
+  欢迎反馈真实模型实测结果。
+
+## v0.7.1 新功能
+
+- **路由表更新(2026-07 模型数据)** — hardest-coding 首选改为 GPT-5.6 Sol
+  **max** 档位:Artificial Analysis Coding Agent Index v1.1 测得 Sol (max)
+  80 分为当前最高,替换旧的「xhigh 胜 max」快照。
+- **Claude 备选升档** — hardest-coding 与 hard-judgment 的 Claude Opus 4.8
+  备选改为 **xhigh**,依 Anthropic 官方对困难任务与长时间工作的建议。
+
+## v0.7.0 新功能
+
+- **先预览再派工** — `--dry-run` 打印完整解析后的派工计划(vendor、模型、
+  模式、超时、副作用判定),不调用模型、不创建作业状态。
+- **版本化 JSON 自动化** — `--list`/`--explain`/`--validate` 与
+  `jobs list|status|result|stats` 都提供 `--json` 信封;另有只读 `jobs wait`、
+  `jobs audit`,以及带可复现 manifest 的离线 `omnilane release-audit` 发布审计。
+- **本地作业一条龙** — `jobs tail` 查看实时输出、`jobs retry` 以 fail-closed
+  方式重派已完成作业、`prune --older-than` 按时间清理,`--help` 覆盖所有命令。
+- **安装与补全更安全** — `install.sh --check`/`--dry-run` 只读报告漂移,
+  `omnilane completion bash|zsh` 提供安全的 tab 补全,并修复五个 macOS 自带
+  Bash 3.2 崩溃。
+
+## v0.6.0 新功能
+
+- **离线理解并验证路由** — 使用 `--explain` 查看每个备用候选，或使用
+  `--validate` 检查完整生效路由表；都不会调用模型或创建作业状态。
+- **用机器可读数据观察本地状态** — `jobs.sh stats` 提供有界统计，
+  `omnilane doctor --json` 提供健康检查，同时不会泄漏任务或结果正文。
+- **在 Live Board 比较两条作业** — 将一条已加载作业固定为仅存在于内存中的
+  参考快照，并排比较模型路径与公开结果。
+- **让锁恢复更安静** — 所有者文件在检查与读取之间消失时，不再泄漏容易误判的
+  缺失文件诊断，同时保持 fail-closed。
+
+## v0.5.1 新功能
+
+- **在非 Git 目录使用 Codex work** — 普通文件夹仍完整支持；Omnilane 不要求，
+  也绝不会自动执行 `git init`。
+- **干净停止非 Git 卡死** — 未设置整体上限时，解析后的单次看门狗会自动成为
+  进程组保险丝，同时保留手动 timeout 的优先级和退出码语义。
+- **让版本显示可信** — `VERSION` 现在统一提供给 `omnilane --version` 和两份
+  plugin manifest，CI 会检查变更记录和五种语言 README 是否一致。
+
+</details>
+
 ## 🌱 状态
 
-v0.8.3 共有八个派发 vendor——四个框架原生(codex、claude、grok、gemini)、
-三个聚合/溢流 CLI(kimi、qwen、opencode),加上免 CLI 的 `openrouter` 直连
-API vendor——全部走统一 runner 契约并附 contract 测试,另有 Claude Code
-`SessionStart` 自动提醒。kimi、qwen、opencode、openrouter 的 runner 以假
-可执行文件做过契约测试;欢迎反馈真实模型使用经验。Grok/Antigravity 命令壳
-行为仍可能随 CLI 版本变动。欢迎提交 issue 与 PR。
+omnilane 现有 13 个派工 vendor——4 个框架原生(codex、claude、grok、gemini)、3 个聚合/溢流 CLI(kimi、qwen、opencode),加上 6 个免 CLI 的 OpenAI-compatible direct-API vendor(openrouter、deepseek、zai、mistral、groq、cerebras)——全部走统一 runner 契约并附 contract 测试,另有 Claude Code `SessionStart` 自动提醒与 MCP stdio server 介面(`omnilane mcp`)。direct-API 与聚合 runner 皆以假可执行档做过契约测试;欢迎反馈真实模型使用经验。Grok/Antigravity 命令壳行为仍可能随 CLI 版本变动。欢迎提交 issue 与 PR。
 
 项目文档：[贡献指南](CONTRIBUTING.md) · [安全政策](SECURITY.md) ·
 [变更记录](CHANGELOG.md)

package/README.zh-TW.md

@@ -21,92 +21,53 @@
 
 ---
 
-## v0.8.3 新功能
-
-- **MCP server** — `omnilane mcp` 啟動零依賴的 stdio MCP server,任何支援
-  MCP 的宿主(Claude Code、Codex、Gemini CLI、Cursor、OpenCode……)不必安裝
-  skill 就能發現並呼叫 omnilane:提供 `route`、`jobs_status`、`jobs_result`、
-  `list_lanes` 四個工具。`route` 預設唯讀 advise 模式;work 模式必須明確
-  指定 workdir。
+## 👋 第一次用?
 
-## v0.8.2 新功能
+你已經在用某個 AI 寫程式助手——**Claude Code、Codex、Cursor、Gemini
+CLI** 之類。每個一次只接一個 AI 模型,而「每件工作該用哪個模型最好」得你自己決定。
 
-- **`openrouter` vendor** — 只要 `curl` 加一把 `OPENROUTER_API_KEY`,
-  就能直連 OpenRouter API 派工:任何 omnilane 安裝都摸得到數百個
-  託管模型,不必再裝任何代理 CLI。僅限 advise/consult(不能改檔,
-  work 模式會明確報錯指路),模型 slug 必填,例如
-  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`。
-- **`opencode` vendor** — 透過 OpenCode 多供應商聚合 CLI 無頭派工
-  (`opencode run`)。advise 模式鎖定內建唯讀 `plan` agent;work 模式
-  用 `--auto`。加入預設 `coding-overflow` 鏈作為最後備援。
+**omnilane 幫你決定。** 每一件工作,它會自動派給對那件事最強(也最省)的模型——硬派程式
+交給頂尖程式模型、隨手的小檢查交給又快又便宜的、長文件交給大脈絡模型——全部用你本來就在
+付費的訂閱與 API 金鑰。用內建預設值就好,或改一個小設定檔就能微調。不用另外顧一套東西
+(它躲在你現有工具背後跑),`./install.sh --uninstall` 可乾淨移除。
 
-## v0.8.1 新功能
+**[⬇ 直接跳到 60 秒上手](#-60-秒上手)**
 
-- **Claude Code 外掛開場自動載入路由提醒** — 外掛新增 `SessionStart`
-  hook(`hooks/hooks.json`),於開場(`startup|resume|clear`)自動注入
-  路由提醒,裝外掛即生效,不必修改 `~/.claude/CLAUDE.md`。其他 CLI
-  仍走 `install.sh` 的指令檔提醒。
-
-## v0.8.0 新功能
-
-- **兩個新派工 vendor** — `kimi`(Moonshot Kimi Code CLI)與 `qwen`
-  (Alibaba Qwen Code CLI)加入,沿用統一 runner 契約:advise 唯讀、
-  work 自動核准、剝除 API key 環境變數改用 CLI 自身訂閱登入、空輸出
-  視為失敗。可用 `--vendor kimi|qwen` 直接點名。
-- **coding-overflow 長出備援鏈** — 額度溢流道改為 grok → kimi → qwen
-  再到 `off`,三家裝任一家即可用。runner 以假執行檔完成契約測試;
-  歡迎回報真實模型實測結果。
-
-## v0.7.1 新功能
-
-- **路由表更新(2026-07 模型數據)** — hardest-coding 首選改為 GPT-5.6 Sol
-  **max** 檔位:Artificial Analysis Coding Agent Index v1.1 測得 Sol (max)
-  80 分為現任最高,汰換舊的「xhigh 勝 max」快照。
-- **Claude 備援升檔** — hardest-coding 與 hard-judgment 的 Claude Opus 4.8
-  備援改為 **xhigh**,依 Anthropic 官方對困難任務與長時間工作的建議。
+## v0.9.1 新功能
 
-## v0.7.0 新功能
+- **修正**:`configure set` 不再刪掉 `routing.local.yaml` 裡手寫的註解——
+  只改寫自身的戳記行與被取代的 lane。
 
-- **先預覽再派工** — `--dry-run` 印出完整解析後的派工計畫(vendor、模型、
-  模式、逾時、副作用判定),不呼叫模型、不建立工作狀態。
-- **版本化 JSON 自動化** — `--list`/`--explain`/`--validate` 與
-  `jobs list|status|result|stats` 都有 `--json` 信封;另有唯讀 `jobs wait`、
-  `jobs audit`,以及帶可重現 manifest 的離線 `omnilane release-audit` 發佈稽核。
-- **本機工作一條龍** — `jobs tail` 窺看即時輸出、`jobs retry` 以 fail-closed
-  方式重派已完成工作、`prune --older-than` 依時間清理,`--help` 覆蓋所有指令。
-- **安裝與補全更安全** — `install.sh --check`/`--dry-run` 唯讀回報漂移,
-  `omnilane completion bash|zsh` 提供安全的 tab 補全,並修復五個 macOS 原生
-  Bash 3.2 崩潰。
+## v0.9.0 新功能
 
-## v0.6.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`。
 
-- **離線看懂並驗證路由** — 用 `--explain` 查看每個備援候選，或用
-  `--validate` 檢查完整生效路由表；都不會呼叫模型或建立工作狀態。
-- **用機器可讀資料觀察本機狀態** — `jobs.sh stats` 提供有界統計，
-  `omnilane doctor --json` 提供健康檢查，又不會洩漏任務或結果正文。
-- **在 Live Board 比較兩筆工作** — 把一筆已載入工作釘成只存在記憶體的
-  參考快照，並排比較模型路徑與公開結果。
-- **讓鎖恢復更安靜** — 擁有者檔案在檢查與讀取間消失時，不再洩漏容易誤判的
-  缺檔診斷，同時維持 fail-closed。
+## ⚡ 60 秒上手
 
-## v0.5.1 新功能
+**最快的方式——用 npm 裝:**
 
-- **在非 Git 目錄使用 Codex work** — 一般資料夾仍完整支援；Omnilane 不要求、
-  也絕不會自動執行 `git init`。
-- **乾淨停止非 Git 卡死** — 未設定整體上限時，解析後的單次看門狗會自動成為
-  程序群組保險絲，同時保留手動 timeout 的優先序與退出碼語意。
-- **讓版本顯示可信** — `VERSION` 現在統一供應 `omnilane --version` 與兩份
-  plugin manifest，CI 會檢查變更紀錄和五語 README 是否一致。
+```bash
+npm i -g omnilane                                    # 裝 CLI
+omnilane route hardest-coding "修掉會間歇失敗的 auth token 更新測試"
+omnilane doctor                                      # 看你手上有哪些 AI CLI / 金鑰
+omnilane ui start                                    # 選配:在瀏覽器即時看派工
+```
 
-## ⚡ 60 秒上手
+**或 clone 整包**(拿到路由表與可自訂的技能):
 
 ```bash
 git clone https://github.com/Seraphim0916/omnilane && cd omnilane
 ./install.sh          # 偵測你的 CLI、接好技能、說你的語言
 omnilane route hardest-coding "修掉會間歇失敗的 auth token 更新測試"
-omnilane ui start     # 選配:在瀏覽器即時看派工
 ```
 
+> 第一次用?先跑 `omnilane doctor`——它會告訴你 omnilane 現在能接到哪些模型 CLI 與
+> API 金鑰,你就知道實際會跑什麼。
+
 ## 🧭 運作方式
 
 omnilane 讓**任何**一個 agentic CLI 的主迴圈把子任務分類到通道(lane),
@@ -131,6 +92,8 @@ flowchart LR
   呼叫對應廠商的 CLI。`--vendor` 會鎖定點名廠商，不做降級。
 - **`skills/omnilane/SKILL.md`** — 一份技能四個框架都能載入:
   先認出自己是哪個模型,自己通道的活自己做,其餘派出去。
+- **`omnilane mcp`** — 同一套路由改以 MCP stdio server 提供,
+  給走 MCP 而非 skill 整合的宿主。
 
 <div align="center">
 
@@ -268,10 +231,13 @@ omnilane ui stop     # 正常停止
 }
 ```
 
-Server 提供 `route`、`jobs_status`、`jobs_result`、`list_lanes` 四個工具。
+Server 提供 `route`,以及一組唯讀查詢工具:`list_lanes`、`explain`、`validate`、`dry_run`、`jobs_list`、`jobs_status`、`jobs_result`、`jobs_stats`、`jobs_audit`、`doctor`。
 `route` 預設唯讀 `advise` 模式;選 `work` 的呼叫必須同時提供明確的
 `workdir`。
 
+唯一的執行需求是 Node.js(不裝任何 npm 套件);也可以直接
+`npm install -g omnilane`,CLI 連同 MCP server 一起裝好。
+
 ## ⚙️ 自訂設定
 
 三層,全部選用:
@@ -298,6 +264,7 @@ omnilane list | route … | jobs … | configure   # 全域指令,任何目錄
                                                # (install.sh 會連結進 ~/.local/bin)
 eval "$(omnilane completion bash)"             # 在目前 Bash 啟用補全
 source <(omnilane completion zsh)               # 在目前 Zsh 啟用補全
+omnilane completion fish | source              # 在目前 Fish 啟用補全
 omnilane ui start                              # 啟動或沿用本機 Live UI,印出網址
 omnilane ui status                             # 查看 Live UI 是否運作中
 omnilane ui url                                # 印出目前通過驗證的本機網址
@@ -310,12 +277,17 @@ dispatch.sh [--json] --list [--json]
 dispatch.sh [--json] --explain 通道 [--json]       # 離線逐候選解釋路由決策
 dispatch.sh [--json] --validate [--json]           # 離線檢查生效路由，不呼叫模型
 jobs.sh [--json] {list | status 工作ID | result 工作ID} # JSON 結果只回中繼資料，不回本文
+jobs.sh [--json] list [--lane L] [--vendor V] [--status running|done]  # 過濾清單
 jobs.sh wait 工作ID [--timeout N]                  # 工作結束碼；124 逾時；125 工作者消失
-jobs.sh [--json] stats [--last N]                  # 本機成功率與路由彙整
+jobs.sh cancel 工作ID                              # 停止執行中的工作:整組 SIGTERM,再 SIGKILL
+jobs.sh rm 工作ID                                  # 刪除單一已完成/已死工作(執行中會被拒絕)
+jobs.sh [--json] stats [--last N] [--lane L] [--vendor V]  # 本機成功率與路由彙整
 jobs.sh audit [--last N] [--json]                  # 唯讀檢查工作完整性與隱私
 jobs.sh prune [--keep N] [--apply]                # 預設只預覽；只清理已完成工作
+omnilane mcp                                   # MCP stdio server(需 Node.js)
 omnilane release-audit [--target 版本] [--json]     # 離線、唯讀的發布閘門
 configure.sh                                        # 互動通道選單
+configure.sh set|get|unset|list|diff LANE [SPEC]    # 非互動編輯/檢視 routing.local.yaml
 ```
 
 **重大決定可以開評審團,不是問一個人。**`arbitrate` 通道**預設關閉**——
@@ -388,12 +360,102 @@ codex/claude/grok/gemini 自選 1-4 個評審。開了之後,同一個問題丟
   外卡住，因此上面的自動保險絲會限制這個情境並清掉受監工的程序群組。Omnilane
   不會自動執行 `git init`，也不要求使用者建立 repo。
 
+## 📜 版本歷程
+
+<details>
+<summary>舊版本(v0.8.3 以前)</summary>
+
+## v0.8.3 新功能
+
+- **MCP server** — `omnilane mcp` 啟動零依賴的 stdio MCP server,任何支援
+  MCP 的宿主(Claude Code、Codex、Gemini CLI、Cursor、OpenCode……)不必安裝
+  skill 就能發現並呼叫 omnilane:提供 `route`、`jobs_status`、`jobs_result`、
+  `list_lanes` 四個工具。`route` 預設唯讀 advise 模式;work 模式必須明確
+  指定 workdir。
+
+## v0.8.2 新功能
+
+- **`openrouter` vendor** — 只要 `curl` 加一把 `OPENROUTER_API_KEY`,
+  就能直連 OpenRouter API 派工:任何 omnilane 安裝都摸得到數百個
+  託管模型,不必再裝任何代理 CLI。僅限 advise/consult(不能改檔,
+  work 模式會明確報錯指路),模型 slug 必填,例如
+  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`。
+- **`deepseek`、`zai`、`mistral`、`groq`、`cerebras` vendor** — 與 `openrouter`
+  同一條免 CLI 直連 API 路徑,對應 OpenAI-compatible 供應商:DeepSeek、Z.ai GLM、
+  Mistral、Groq、Cerebras。各只要 `curl` 加自己那把 `<VENDOR>_API_KEY`;僅限
+  advise/consult。端點、金鑰、預設模型由 `lib/common.sh` 一行 registry 定義。
+  詳見 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md)。
+- **`opencode` vendor** — 透過 OpenCode 多供應商聚合 CLI 無頭派工
+  (`opencode run`)。advise 模式鎖定內建唯讀 `plan` agent;work 模式
+  用 `--auto`。加入預設 `coding-overflow` 鏈作為最後備援。
+
+## v0.8.1 新功能
+
+- **Claude Code 外掛開場自動載入路由提醒** — 外掛新增 `SessionStart`
+  hook(`hooks/hooks.json`),於開場(`startup|resume|clear`)自動注入
+  路由提醒,裝外掛即生效,不必修改 `~/.claude/CLAUDE.md`。其他 CLI
+  仍走 `install.sh` 的指令檔提醒。
+
+## v0.8.0 新功能
+
+- **兩個新派工 vendor** — `kimi`(Moonshot Kimi Code CLI)與 `qwen`
+  (Alibaba Qwen Code CLI)加入,沿用統一 runner 契約:advise 唯讀、
+  work 自動核准、剝除 API key 環境變數改用 CLI 自身訂閱登入、空輸出
+  視為失敗。可用 `--vendor kimi|qwen` 直接點名。
+- **coding-overflow 長出備援鏈** — 額度溢流道改為 grok → kimi → qwen
+  再到 `off`,三家裝任一家即可用。runner 以假執行檔完成契約測試;
+  歡迎回報真實模型實測結果。
+
+## v0.7.1 新功能
+
+- **路由表更新(2026-07 模型數據)** — hardest-coding 首選改為 GPT-5.6 Sol
+  **max** 檔位:Artificial Analysis Coding Agent Index v1.1 測得 Sol (max)
+  80 分為現任最高,汰換舊的「xhigh 勝 max」快照。
+- **Claude 備援升檔** — hardest-coding 與 hard-judgment 的 Claude Opus 4.8
+  備援改為 **xhigh**,依 Anthropic 官方對困難任務與長時間工作的建議。
+
+## v0.7.0 新功能
+
+- **先預覽再派工** — `--dry-run` 印出完整解析後的派工計畫(vendor、模型、
+  模式、逾時、副作用判定),不呼叫模型、不建立工作狀態。
+- **版本化 JSON 自動化** — `--list`/`--explain`/`--validate` 與
+  `jobs list|status|result|stats` 都有 `--json` 信封;另有唯讀 `jobs wait`、
+  `jobs audit`,以及帶可重現 manifest 的離線 `omnilane release-audit` 發佈稽核。
+- **本機工作一條龍** — `jobs tail` 窺看即時輸出、`jobs retry` 以 fail-closed
+  方式重派已完成工作、`prune --older-than` 依時間清理,`--help` 覆蓋所有指令。
+- **安裝與補全更安全** — `install.sh --check`/`--dry-run` 唯讀回報漂移,
+  `omnilane completion bash|zsh` 提供安全的 tab 補全,並修復五個 macOS 原生
+  Bash 3.2 崩潰。
+
+## v0.6.0 新功能
+
+- **離線看懂並驗證路由** — 用 `--explain` 查看每個備援候選，或用
+  `--validate` 檢查完整生效路由表；都不會呼叫模型或建立工作狀態。
+- **用機器可讀資料觀察本機狀態** — `jobs.sh stats` 提供有界統計，
+  `omnilane doctor --json` 提供健康檢查，又不會洩漏任務或結果正文。
+- **在 Live Board 比較兩筆工作** — 把一筆已載入工作釘成只存在記憶體的
+  參考快照，並排比較模型路徑與公開結果。
+- **讓鎖恢復更安靜** — 擁有者檔案在檢查與讀取間消失時，不再洩漏容易誤判的
+  缺檔診斷，同時維持 fail-closed。
+
+## v0.5.1 新功能
+
+- **在非 Git 目錄使用 Codex work** — 一般資料夾仍完整支援；Omnilane 不要求、
+  也絕不會自動執行 `git init`。
+- **乾淨停止非 Git 卡死** — 未設定整體上限時，解析後的單次看門狗會自動成為
+  程序群組保險絲，同時保留手動 timeout 的優先序與退出碼語意。
+- **讓版本顯示可信** — `VERSION` 現在統一供應 `omnilane --version` 與兩份
+  plugin manifest，CI 會檢查變更紀錄和五語 README 是否一致。
+
+</details>
+
 ## 🌱 狀態
 
-v0.8.3 共有八個派工 vendor——四個框架原生(codex、claude、grok、gemini)、
-三個聚合/溢流 CLI(kimi、qwen、opencode),加上免 CLI 的 `openrouter` 直連
-API vendor——全部走統一 runner 契約並附 contract 測試,另有 Claude Code
-`SessionStart` 自動提醒。kimi、qwen、opencode、openrouter 的 runner 以假
+omnilane 現有十三個派工 vendor——四個框架原生(codex、claude、grok、gemini)、
+三個聚合/溢流 CLI(kimi、qwen、opencode),加上六個免 CLI 的 OpenAI-compatible
+直連 API vendor(openrouter、deepseek、zai、mistral、groq、cerebras)——全部走
+統一 runner 契約並附 contract 測試,另有 Claude Code `SessionStart` 自動提醒與
+MCP stdio server 介面(`omnilane mcp`)。直連 API 與聚合 runner 皆以假
 執行檔做過契約測試;歡迎回報真實模型使用經驗。Grok/Antigravity 指令殼行為
 仍可能隨 CLI 版本變動。歡迎回報 issue 與 PR。
 

package/VERSION

@@ -1 +1 @@
-0.8.3
+0.9.1

package/bin/omnilane

@@ -40,13 +40,14 @@ case "$cmd" in
     ;;
   completion)
     [[ $# -eq 1 ]] || {
-      echo "usage: omnilane completion bash|zsh" >&2
+      echo "usage: omnilane completion bash|zsh|fish" >&2
       exit 2
     }
     case "$1" in
       bash) cat "$REPO/completions/omnilane.bash" ;;
       zsh)  cat "$REPO/completions/_omnilane" ;;
-      *) echo "usage: omnilane completion bash|zsh" >&2; exit 2 ;;
+      fish) cat "$REPO/completions/omnilane.fish" ;;
+      *) echo "usage: omnilane completion bash|zsh|fish" >&2; exit 2 ;;
     esac
     ;;
   release-audit) exec bash "$REPO/scripts/release-audit.sh" "$@" ;;
@@ -69,7 +70,7 @@ omnilane — one routing table, every harness
                                         dispatch or consult a model
   omnilane jobs  [--json] COMMAND [ARGS]  list, status, result, stats, wait, or audit
   omnilane mcp                          start the MCP stdio server
-  omnilane completion bash|zsh           print a shell completion script
+  omnilane completion bash|zsh|fish      print a shell completion script
   omnilane release-audit [flags]          offline, read-only release gate
   omnilane doctor [--json]              read-only local health report
   omnilane ui    start|status|url|stop