omnilane 0.8.2 → 0.9.0

package/README.zh-CN.md

@@ -5,8 +5,9 @@
 ### 一张路由表,四个执行框架通用。
 
 *让主循环不再猜要用哪个模型。*<br/>
-每个子任务都派给真正最擅长它的模型——横跨<br/>
-**Claude Code · Codex · Grok Build · Antigravity**,直接用你已经在付的订阅。
+从 **Claude Code · Codex · Grok Build · Antigravity** 任一框架驾驶,每个子任务都派给<br/>
+真正最擅长它的模型——Codex、Claude、Grok、Gemini、Kimi、Qwen、OpenCode,<br/>
+或经 OpenRouter 直达任何托管模型——用你已经在付的订阅,或一把 API 密钥。
 
 <img src="docs/hero.zh-CN.png" alt="omnilane 把每个子任务派给 Claude Code、Codex、Grok、Antigravity 中最擅长的模型" width="820"/>
 
@@ -20,6 +21,19 @@
 
 ---
 
+## 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 新功能
+
+- **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`,
@@ -101,7 +115,8 @@ omnilane ui start     # 可选:在浏览器实时查看派发
 ## 🧭 工作原理
 
 omnilane 让**任何**一个 agentic CLI 的主循环把子任务分类到通道(lane),
-再以无头方式把每条通道派发给该项工作最强的厂商 CLI,直接沿用你已有的订阅登录:
+再以无头方式把每条通道派发给该项工作最强的厂商——直接沿用你已有的订阅登录
+(`openrouter` vendor 例外:免装任何 CLI,一把 API 密钥直连):
 
 ```mermaid
 flowchart LR
@@ -121,6 +136,8 @@ flowchart LR
   调用对应厂商的 CLI。`--vendor` 会锁定指定厂商，不做降级。
 - **`skills/omnilane/SKILL.md`** — 一份技能四个框架都能加载:
   先认出自己是哪个模型,自己通道的活自己干,其余派出去。
+- **`omnilane mcp`** — 同一套路由改以 MCP stdio server 提供,
+  给走 MCP 而非 skill 集成的宿主。
 
 <div align="center">
 
@@ -215,8 +232,10 @@ Esc。服务器发送事件(SSE)会实时更新，又不会重建当前聚焦的
 
 ## 📦 安装
 
-前置需求:想路由到的厂商 CLI(`codex`、`claude`、`grok`、`agy`)已登录且在
-`PATH` 上——**有几家装几家就好**,缺的通道会自动降级。
+前置需求:想路由到的厂商 CLI(`codex`、`claude`、`grok`、`agy`,另可选
+`kimi`、`qwen`、`opencode`)已登录且在 `PATH` 上——**有几家装几家就好**,
+缺的通道会自动降级。`openrouter` vendor 是例外:不需要任何 CLI,只要
+`curl` 和环境变量里的 `OPENROUTER_API_KEY`。
 
 最快:`./install.sh` — 自动检测本机的 CLI、接好技能、列出其余的插件安装命令、
 打印这台机器的生效路由表,最后询问是否进入交互设置菜单(`--uninstall` 可逆)。
@@ -238,6 +257,30 @@ Esc。服务器发送事件(SSE)会实时更新，又不会重建当前聚焦的
 - **Antigravity**:`agy plugin install <本仓库路径>`(先用
   `agy plugin validate` 检查)
 
+### MCP server
+
+`omnilane mcp` 会启动零依赖、跑在本机的 MCP stdio server,让任何支持 MCP
+的宿主无需安装 skill、也不用加路由提醒,即可发现并调用 omnilane。在宿主
+配置里指向已安装的 CLI 即可:
+
+```json
+{
+  "mcpServers": {
+    "omnilane": {
+      "command": "omnilane",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+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 一起装好。
+
 ## ⚙️ 自定义设置
 
 三层,全部可选:
@@ -262,6 +305,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 是否正在运行
@@ -275,11 +320,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` 通道已关闭、
@@ -291,9 +340,11 @@ configure.sh                                        # 交互通道菜单
 ## 🎭 模式
 
 - **advise(默认)** — 只读工作端。Codex 跑只读沙箱;Claude 只给
-  Read/Glob/Grep;Grok 跑 plan 模式。适合审查、提问、第二意见。
+  Read/Glob/Grep;Grok 跑 plan 模式;Kimi 与 OpenCode 锁各自的只读
+  plan 模式;OpenRouter 天生只做 advise(纯推理)。适合审查、提问、第二意见。
 - **work** — 允许改文件,仅限你指定的 `--workdir`。Codex 给
   workspace-write 沙箱;Claude 自动接受编辑;Gemini 跑 accept-edits 模式。
+  `openrouter` vendor 会明确拒绝 work 模式——改文件请走代理式 CLI vendor。
 
 ## 🔒 内置安全机制
 
@@ -345,10 +396,7 @@ configure.sh                                        # 交互通道菜单
 
 ## 🌱 状态
 
-v0.5.1 让 Codex `work` 在非 Git 目录仍可使用，同时以进程组清理限制卡死，
-并同步所有公开版本来源。它延续 v0.5.0 对安装器、派发生命周期、作业存储、
-整体截止时间、诊断和发布 CI 的强化。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

@@ -5,8 +5,9 @@
 ### 一張路由表,四個執行框架通用。
 
 *讓主迴圈不再猜要用哪個模型。*<br/>
-每個子任務都派給真正最擅長它的模型——橫跨<br/>
-**Claude Code · Codex · Grok Build · Antigravity**,直接用你已經在付的訂閱。
+從 **Claude Code · Codex · Grok Build · Antigravity** 任一框架開車,每個子任務都派給<br/>
+真正最擅長它的模型——Codex、Claude、Grok、Gemini、Kimi、Qwen、OpenCode,<br/>
+或經 OpenRouter 直達任何託管模型——用你已經在付的訂閱,或一把 API 金鑰。
 
 <img src="docs/hero.zh-TW.png" alt="omnilane 把每個子任務派給 Claude Code、Codex、Grok、Antigravity 中最擅長的模型" width="820"/>
 
@@ -20,6 +21,22 @@
 
 ---
 
+## 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 新功能
+
+- **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`,
@@ -27,6 +44,11 @@
   託管模型,不必再裝任何代理 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` 鏈作為最後備援。
@@ -101,7 +123,8 @@ omnilane ui start     # 選配:在瀏覽器即時看派工
 ## 🧭 運作方式
 
 omnilane 讓**任何**一個 agentic CLI 的主迴圈把子任務分類到通道(lane),
-再以無頭方式把每條通道派工給該項工作最強的廠商 CLI,直接沿用你既有的訂閱登入:
+再以無頭方式把每條通道派工給該項工作最強的廠商——直接沿用你既有的訂閱登入
+(`openrouter` vendor 例外:免裝任何 CLI,一把 API 金鑰直連):
 
 ```mermaid
 flowchart LR
@@ -121,6 +144,8 @@ flowchart LR
   呼叫對應廠商的 CLI。`--vendor` 會鎖定點名廠商，不做降級。
 - **`skills/omnilane/SKILL.md`** — 一份技能四個框架都能載入:
   先認出自己是哪個模型,自己通道的活自己做,其餘派出去。
+- **`omnilane mcp`** — 同一套路由改以 MCP stdio server 提供,
+  給走 MCP 而非 skill 整合的宿主。
 
 <div align="center">
 
@@ -215,8 +240,10 @@ omnilane ui stop     # 正常停止
 
 ## 📦 安裝
 
-前置需求:想路由到的廠商 CLI(`codex`、`claude`、`grok`、`agy`)已登入且在
-`PATH` 上——**有幾家裝幾家就好**,缺的通道會自動降級。
+前置需求:想路由到的廠商 CLI(`codex`、`claude`、`grok`、`agy`,另可選
+`kimi`、`qwen`、`opencode`)已登入且在 `PATH` 上——**有幾家裝幾家就好**,
+缺的通道會自動降級。`openrouter` vendor 是例外:不需要任何 CLI,只要
+`curl` 和環境變數裡的 `OPENROUTER_API_KEY`。
 
 最快:`./install.sh` — 自動偵測本機的 CLI、接好技能、列出其餘的外掛安裝指令、
 印出這台機器的生效路由表,最後問你要不要進入互動設定選單(`--uninstall` 可逆)。
@@ -239,6 +266,30 @@ omnilane ui stop     # 正常停止
 - **Antigravity**:`agy plugin install <本 repo 路徑>`(先用
   `agy plugin validate` 檢查)
 
+### MCP server
+
+`omnilane mcp` 會啟動零依賴、跑在本機的 MCP stdio server,讓任何支援 MCP
+的宿主不必安裝 skill、也不用加路由提醒,就能發現並呼叫 omnilane。在宿主
+設定裡指向已安裝的 CLI 即可:
+
+```json
+{
+  "mcpServers": {
+    "omnilane": {
+      "command": "omnilane",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+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 一起裝好。
+
 ## ⚙️ 自訂設定
 
 三層,全部選用:
@@ -265,6 +316,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                                # 印出目前通過驗證的本機網址
@@ -277,12 +329,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` 通道**預設關閉**——
@@ -304,9 +361,11 @@ codex/claude/grok/gemini 自選 1-4 個評審。開了之後,同一個問題丟
 ## 🎭 模式
 
 - **advise(預設)** — 唯讀工作端。Codex 跑唯讀沙箱;Claude 只給
-  Read/Glob/Grep;Grok 跑 plan 模式。適合審查、提問、第二意見。
+  Read/Glob/Grep;Grok 跑 plan 模式;Kimi 與 OpenCode 鎖各自的唯讀
+  plan 模式;OpenRouter 天生只做 advise(純推論)。適合審查、提問、第二意見。
 - **work** — 允許改檔案,僅限你指定的 `--workdir`。Codex 給
   workspace-write 沙箱;Claude 自動接受編輯;Gemini 跑 accept-edits 模式。
+  `openrouter` vendor 會明確拒絕 work 模式——改檔請走代理式 CLI vendor。
 
 ## 🔒 內建安全機制
 
@@ -355,10 +414,13 @@ codex/claude/grok/gemini 自選 1-4 個評審。開了之後,同一個問題丟
 
 ## 🌱 狀態
 
-v0.5.1 讓 Codex `work` 在非 Git 目錄仍可使用，同時以程序群組清理限制卡死，
-並同步所有公開版本來源。它延續 v0.5.0 對安裝器、派工生命週期、job 儲存、
-整體截止時間、診斷與發布 CI 的強化。Grok/Antigravity 指令殼行為仍可能隨
-CLI 版本變動。歡迎回報 issue 與 PR。
+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。
 
 專案文件：[貢獻指南](CONTRIBUTING.md) · [安全政策](SECURITY.md) ·
 [變更紀錄](CHANGELOG.md)

package/VERSION

@@ -1 +1 @@
-0.8.2
+0.9.0

package/bin/omnilane

@@ -31,15 +31,23 @@ case "$cmd" in
   list)      exec bash "$REPO/scripts/dispatch.sh" --list ;;
   route|dispatch) exec bash "$REPO/scripts/dispatch.sh" "$@" ;;
   jobs)      exec bash "$REPO/scripts/jobs.sh" "$@" ;;
+  mcp)
+    command -v node >/dev/null 2>&1 || {
+      echo "omnilane: mcp requires Node.js on PATH" >&2
+      exit 1
+    }
+    exec node "$REPO/bin/omnilane-mcp" "$@"
+    ;;
   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" "$@" ;;
@@ -61,7 +69,8 @@ omnilane — one routing table, every harness
   omnilane route [--vendor V] [flags] LANE "TASK"
                                         dispatch or consult a model
   omnilane jobs  [--json] COMMAND [ARGS]  list, status, result, stats, wait, or audit
-  omnilane completion bash|zsh           print a shell completion script
+  omnilane mcp                          start the MCP stdio server
+  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