omnilane 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -6,6 +6,20 @@ semantic version tags.
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-07-19
+
+### Fixed
+
+- `configure set` no longer deletes hand-written comments from
+  `routing.local.yaml`: it now rewrites only its own stamp header and the lane
+  being replaced, so user comments survive a set.
+
+### Added
+
+- Browser-backed UI tests honor `OMNILANE_TEST_REQUIRE_BROWSER=1`, which turns
+  a persistent Chrome/Playwright launch failure into a real failure instead of
+  a skip — for hosts known to have a working Chrome.
+
 ## [0.9.0] - 2026-07-19
 
 ### Added
@@ -307,7 +321,8 @@ semantic version tags.
 - Initial shared routing table, cross-vendor dispatcher, runners, installer,
   and baseline lint fixes.
 
-[Unreleased]: https://github.com/Seraphim0916/omnilane/compare/v0.9.0...HEAD
+[Unreleased]: https://github.com/Seraphim0916/omnilane/compare/v0.9.1...HEAD
+[0.9.1]: https://github.com/Seraphim0916/omnilane/compare/v0.9.0...v0.9.1
 [0.9.0]: https://github.com/Seraphim0916/omnilane/compare/v0.8.3...v0.9.0
 [0.8.3]: https://github.com/Seraphim0916/omnilane/compare/v0.8.2...v0.8.3
 [0.8.2]: https://github.com/Seraphim0916/omnilane/compare/v0.8.1...v0.8.2

package/README.ja.md

@@ -21,113 +21,56 @@
 
 ---
 
-## v0.9.0 の新機能
+## 👋 はじめての方へ
 
-- **OpenAI 互換の direct-API ベンダーを 5 つ追加** — `deepseek`、`zai`(GLM)、
-  `mistral`、`groq`、`cerebras` が `openrouter` と同じく CLI 不要のレーンに
-  (curl と `<VENDOR>_API_KEY` だけ)。`lib/common.sh` のレジストリに 1 行で
-  追加でき、モデル能力の比較は [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) を参照。
-- **Fish シェル補完** — `omnilane completion fish | source`。
+すでに AI コーディングアシスタント——**Claude Code、Codex、Cursor、Gemini
+CLI** など——を使っていますよね。どれも一度に一つの AI モデルとやり取りし、
+「どのタスクにどのモデルが最適か」の判断はあなた任せです。
 
-## v0.8.3 の新機能
+**omnilane がその判断を代行します。** 一つひとつの作業を、それに最も強い(そして最も安い)
+モデルへ自動で振り分けます——難しいコーディングはトップコーダーへ、ちょっとした確認は
+速くて安いモデルへ、長い文書は大コンテキストモデルへ——すべてあなたが既に契約している
+サブスクと API キーで。組み込みのデフォルトのまま使うも、小さな設定ファイルを一つ調整するも
+自由。新しく面倒を見る対象は増えず(既存ツールの裏で動きます)、`./install.sh --uninstall`
+できれいに削除できます。
 
-- **MCP サーバー** — `omnilane mcp` は依存ゼロの stdio MCP サーバーを起動し、
-  MCP 対応ホスト(Claude Code、Codex、Gemini CLI、Cursor、OpenCode など)が
-  スキルなしで omnilane を発見・呼び出しできます:ツールは `route`、
-  `jobs_status`、`jobs_result`、`list_lanes`。`route` は読み取り専用の
-  advise がデフォルトで、work モードには明示的な workdir が必須です。
+**[⬇ 60 秒クイックスタートへ](#-60-秒クイックスタート)**
 
-## v0.8.2 の新機能
+## v0.9.1 の新機能
 
-- **`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** — マルチプロバイダ集約 CLI OpenCode 経由の
-  ヘッドレスディスパッチ(`opencode run`)。advise モードは組み込みの
-  読み取り専用 `plan` エージェントを使用し、work モードは `--auto`。
-  デフォルトの `coding-overflow` チェーンの最終フォールバックに追加。
-
-## v0.8.1 の新機能
+- **修正**: `configure set` が `routing.local.yaml` の手書きコメントを削除しなく
+  なりました。書き換えるのは自身のスタンプ行と置き換え対象のレーンだけです。
 
-- **Claude Code プラグインがルーティングリマインダーを自動読み込み** —
-  プラグインに `SessionStart` フック(`hooks/hooks.json`)を同梱。
-  セッション開始時(`startup|resume|clear`)にルーティングリマインダーを
-  自動注入するため、`~/.claude/CLAUDE.md` を編集せずプラグインの
-  インストールだけで有効になります。他の CLI は引き続き `install.sh` の
-  指示ファイル方式です。
-
-## v0.8.0 の新機能
-
-- **2 つの新ディスパッチベンダー** — `kimi`(Moonshot Kimi Code CLI)と
-  `qwen`(Alibaba Qwen Code CLI)が統一 runner 契約で加わりました:
-  advise は読み取り専用、work は自動承認、API キー環境変数を除去して
-  CLI 自身のサブスクリプションログインを使用、空出力は明示的な失敗。
-  `--vendor kimi|qwen` で直接指名できます。
-- **coding-overflow にフォールバックチェーン** — クォータ逃し弁が
-  grok → kimi → qwen → `off` の順にフォールバックし、3 ベンダーの
-  いずれか 1 つで動作します。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** に変更。難しいタスクと長時間作業には
-  extra effort を推奨する Anthropic 公式ガイダンスに従います。
-
-## v0.7.0 の新機能
-
-- **ディスパッチを事前にプレビュー** — `--dry-run` は解決済みの実行計画
-  (vendor、モデル、モード、タイムアウト、副作用判定)を表示し、モデル呼び出しも
-  ジョブ状態の作成も行いません。
-- **バージョン付き JSON で自動化** — `--list`/`--explain`/`--validate` と
-  `jobs list|status|result|stats` に `--json` エンベロープを追加。読み取り専用の
-  `jobs wait`、`jobs audit`、決定的マニフェスト付きのオフライン
-  `omnilane release-audit` も利用できます。
-- **ローカルジョブを一気通貫で操作** — `jobs tail` で出力を覗き、`jobs retry` で
-  完了ジョブを fail-closed に再実行、`prune --older-than` で古いジョブを整理。
-  `--help` が全コマンドを網羅します。
-- **インストールと補完を安全に** — `install.sh --check`/`--dry-run` は書き込みなしで
-  ドリフトを報告し、`omnilane completion bash|zsh` が安全なタブ補完を提供。
-  macOS 標準 Bash 3.2 のクラッシュを 5 件修正しました。
+## v0.9.0 の新機能
 
-## v0.6.0 の新機能
+- **OpenAI 互換の direct-API ベンダーを 5 つ追加** — `deepseek`、`zai`(GLM)、
+  `mistral`、`groq`、`cerebras` が `openrouter` と同じく CLI 不要のレーンに
+  (curl と `<VENDOR>_API_KEY` だけ)。`lib/common.sh` のレジストリに 1 行で
+  追加でき、モデル能力の比較は [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) を参照。
+- **Fish シェル補完** — `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 の停止を安全に処理** — 全体上限が未設定なら、解決済みの呼び出し単位
-  ウォッチドッグを process group ヒューズとして使い、明示設定の優先順位と終了
-  コードの意味は維持します。
-- **表示バージョンを信頼可能に** — `VERSION` が `omnilane --version` と二つの
-  plugin manifest を統一し、CI が変更履歴と五言語 README の一致を検査します。
+```bash
+npm i -g omnilane                                    # CLI をインストール
+omnilane route hardest-coding "auth トークン更新テストの不安定さを修正"
+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 トークン更新テストの不安定さを修正"
-omnilane ui start     # 任意:ブラウザでジョブをライブ表示
 ```
 
+> はじめての方は、まず `omnilane doctor` を実行してください。omnilane が今どのモデル CLI と
+> API キーに接続できるかがわかり、実際に何が動くか把握できます。
+
 ## 🧭 仕組み
 
 omnilane は、**どの** agentic CLI のメインループでも、サブタスクをレーンに
@@ -436,6 +379,103 @@ configure.sh set|get|unset|list|diff LANE [SPEC]    # routing.local.yaml を非
   制限し、監視対象の process group を終了します。Omnilane は `git init` を自動実行せず、
   リポジトリの作成も要求しません。
 
+## 📜 リリース履歴
+
+<details>
+<summary>過去のリリース(v0.8.3 以前)</summary>
+
+## v0.8.3 の新機能
+
+- **MCP サーバー** — `omnilane mcp` は依存ゼロの stdio MCP サーバーを起動し、
+  MCP 対応ホスト(Claude Code、Codex、Gemini CLI、Cursor、OpenCode など)が
+  スキルなしで 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** — マルチプロバイダ集約 CLI OpenCode 経由の
+  ヘッドレスディスパッチ(`opencode run`)。advise モードは組み込みの
+  読み取り専用 `plan` エージェントを使用し、work モードは `--auto`。
+  デフォルトの `coding-overflow` チェーンの最終フォールバックに追加。
+
+## v0.8.1 の新機能
+
+- **Claude Code プラグインがルーティングリマインダーを自動読み込み** —
+  プラグインに `SessionStart` フック(`hooks/hooks.json`)を同梱。
+  セッション開始時(`startup|resume|clear`)にルーティングリマインダーを
+  自動注入するため、`~/.claude/CLAUDE.md` を編集せずプラグインの
+  インストールだけで有効になります。他の CLI は引き続き `install.sh` の
+  指示ファイル方式です。
+
+## v0.8.0 の新機能
+
+- **2 つの新ディスパッチベンダー** — `kimi`(Moonshot Kimi Code CLI)と
+  `qwen`(Alibaba Qwen Code CLI)が統一 runner 契約で加わりました:
+  advise は読み取り専用、work は自動承認、API キー環境変数を除去して
+  CLI 自身のサブスクリプションログインを使用、空出力は明示的な失敗。
+  `--vendor kimi|qwen` で直接指名できます。
+- **coding-overflow にフォールバックチェーン** — クォータ逃し弁が
+  grok → kimi → qwen → `off` の順にフォールバックし、3 ベンダーの
+  いずれか 1 つで動作します。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** に変更。難しいタスクと長時間作業には
+  extra effort を推奨する Anthropic 公式ガイダンスに従います。
+
+## v0.7.0 の新機能
+
+- **ディスパッチを事前にプレビュー** — `--dry-run` は解決済みの実行計画
+  (vendor、モデル、モード、タイムアウト、副作用判定)を表示し、モデル呼び出しも
+  ジョブ状態の作成も行いません。
+- **バージョン付き JSON で自動化** — `--list`/`--explain`/`--validate` と
+  `jobs list|status|result|stats` に `--json` エンベロープを追加。読み取り専用の
+  `jobs wait`、`jobs audit`、決定的マニフェスト付きのオフライン
+  `omnilane release-audit` も利用できます。
+- **ローカルジョブを一気通貫で操作** — `jobs tail` で出力を覗き、`jobs retry` で
+  完了ジョブを fail-closed に再実行、`prune --older-than` で古いジョブを整理。
+  `--help` が全コマンドを網羅します。
+- **インストールと補完を安全に** — `install.sh --check`/`--dry-run` は書き込みなしで
+  ドリフトを報告し、`omnilane completion bash|zsh` が安全なタブ補完を提供。
+  macOS 標準 Bash 3.2 のクラッシュを 5 件修正しました。
+
+## 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 の停止を安全に処理** — 全体上限が未設定なら、解決済みの呼び出し単位
+  ウォッチドッグを process group ヒューズとして使い、明示設定の優先順位と終了
+  コードの意味は維持します。
+- **表示バージョンを信頼可能に** — `VERSION` が `omnilane --version` と二つの
+  plugin manifest を統一し、CI が変更履歴と五言語 README の一致を検査します。
+
+</details>
+
 ## 🌱 ステータス
 
 omnilane は 13 のディスパッチベンダーを備えます——4 つのハーネスネイティブ

package/README.ko.md

@@ -21,113 +21,55 @@
 
 ---
 
-## v0.9.0 새 기능
+## 👋 처음이신가요?
 
-- **OpenAI 호환 direct-API 벤더 5개 추가** — `deepseek`, `zai` (GLM), `mistral`,
-  `groq`, `cerebras` 가 `openrouter` 처럼 CLI 없는 레인으로 추가(curl 과
-  `<VENDOR>_API_KEY` 만 필요). `lib/common.sh` 레지스트리에 한 줄로 추가되며,
-  모델 능력 비교는 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) 참고.
-- **Fish 셸 자동완성** — `omnilane completion fish | source`.
+이미 AI 코딩 어시스턴트——**Claude Code, Codex, Cursor, Gemini CLI** 같은——를 쓰고
+계시죠. 각각은 한 번에 하나의 AI 모델과 대화하며, "어떤 작업에 어떤 모델이 최선인가"는
+당신 몫으로 남습니다.
 
-## v0.8.3 새 기능
+**omnilane 이 대신 골라 줍니다.** 모든 작업을 그 일에 가장 강한(그리고 가장 저렴한) 모델로
+자동 라우팅합니다——어려운 코딩은 최고 코더에게, 간단한 확인은 빠르고 싼 모델에게, 긴 문서는
+큰 컨텍스트 모델에게——전부 이미 결제 중인 구독과 API 키로. 기본값 그대로 쓰거나, 작은 설정
+파일 하나만 손보면 됩니다. 새로 관리할 대상이 늘지 않고(기존 도구 뒤에서 동작),
+`./install.sh --uninstall` 로 깔끔히 제거됩니다.
 
-- **MCP 서버** — `omnilane mcp` 는 의존성 없는 stdio MCP 서버를 시작하여,
-  MCP 지원 호스트(Claude Code, Codex, Gemini CLI, Cursor, OpenCode 등)가
-  스킬 설치 없이 omnilane 을 발견하고 호출할 수 있습니다: 도구는 `route`,
-  `jobs_status`, `jobs_result`, `list_lanes`. `route` 는 읽기 전용 advise 가
-  기본값이며, work 모드는 명시적 workdir 이 필요합니다.
+**[⬇ 60초 시작으로](#-60초-시작)**
 
-## v0.8.2 새 기능
+## v0.9.1 새 기능
 
-- **`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** — 멀티 프로바이더 집합 CLI OpenCode를 통한
-  헤드리스 디스패치(`opencode run`). advise 모드는 내장 읽기 전용 `plan`
-  에이전트를 사용하고 work 모드는 `--auto`를 사용합니다. 기본
-  `coding-overflow` 체인의 마지막 폴백으로 추가되었습니다.
-
-## v0.8.1 새 기능
+- **수정**: `configure set` 이 더 이상 `routing.local.yaml` 의 수기 주석을
+  삭제하지 않습니다. 자체 스탬프 줄과 교체 대상 레인만 다시 씁니다.
 
-- **Claude Code 플러그인이 라우팅 리마인더를 자동 로드** — 플러그인에
-  `SessionStart` 훅(`hooks/hooks.json`)이 포함되어 세션 시작 시
-  (`startup|resume|clear`) 라우팅 리마인더를 자동 주입합니다.
-  `~/.claude/CLAUDE.md` 수정 없이 플러그인 설치만으로 적용됩니다.
-  다른 CLI는 기존대로 `install.sh` 지침 파일 방식을 사용합니다.
-
-## v0.8.0 새 기능
-
-- **새 디스패치 벤더 2종** — `kimi`(Moonshot Kimi Code CLI)와
-  `qwen`(Alibaba Qwen Code CLI)이 통일 runner 계약으로 합류:
-  advise 는 읽기 전용, work 는 자동 승인, API 키 환경 변수를 제거해
-  CLI 자체 구독 로그인을 사용, 빈 출력은 명시적 실패.
-  `--vendor kimi|qwen` 으로 직접 지정할 수 있습니다.
-- **coding-overflow 폴백 체인** — 쿼터 안전 밸브가 grok → kimi → qwen
-  → `off` 순으로 폴백해 세 벤더 중 하나만 설치돼 있어도 동작합니다.
-  runner 는 페이크 바이너리로 계약 테스트 완료. 실제 모델 사용 보고를
-  환영합니다.
-
-## v0.7.1 새 기능
-
-- **라우팅 테이블 갱신(2026-07 모델 데이터)** — hardest-coding 1순위를
-  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** 로 변경. 어려운 작업과 장시간 작업에 extra effort 를
-  권장하는 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` 가 안전한 탭 완성을
-  제공하며, macOS 기본 Bash 3.2 크래시 5건을 수정했습니다.
+## v0.9.0 새 기능
 
-## v0.6.0 새 기능
+- **OpenAI 호환 direct-API 벤더 5개 추가** — `deepseek`, `zai` (GLM), `mistral`,
+  `groq`, `cerebras` 가 `openrouter` 처럼 CLI 없는 레인으로 추가(curl 과
+  `<VENDOR>_API_KEY` 만 필요). `lib/common.sh` 레지스트리에 한 줄로 추가되며,
+  모델 능력 비교는 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) 참고.
+- **Fish 셸 자동완성** — `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 멈춤을 안전하게 종료** — 전체 상한이 없으면 결정된 호출별 워치독을
-  process group 퓨즈로 사용하고, 명시한 timeout 우선순위와 종료 코드 의미는
-  그대로 유지합니다.
-- **표시 버전을 신뢰 가능하게 유지** — `VERSION` 이 `omnilane --version` 과 두
-  plugin manifest 를 통일하며 CI 가 변경 기록과 5개 언어 README 를 검사합니다.
+```bash
+npm i -g omnilane                                    # CLI 설치
+omnilane route hardest-coding "간헐적으로 실패하는 auth 토큰 갱신 테스트 수정"
+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 토큰 갱신 테스트 수정"
-omnilane ui start     # 선택: 브라우저에서 잡을 실시간 확인
 ```
 
+> 처음이신가요? 먼저 `omnilane doctor` 를 실행하세요. omnilane 이 지금 어떤 모델 CLI 와
+> API 키에 접근할 수 있는지 알려 주어, 실제로 무엇이 실행될지 파악할 수 있습니다.
+
 ## 🧭 동작 방식
 
 omnilane 은 **어떤** agentic CLI 든 메인 루프가 서브태스크를 레인으로 분류하고,
@@ -424,6 +366,103 @@ CLI 를 사용할 수 없음, `5` 1라운드 성공 투표자 부족, `6` 2라
   process group을 정리합니다. Omnilane 은 `git init` 을 자동 실행하지 않으며 저장소
   생성을 요구하지도 않습니다.
 
+## 📜 릴리스 기록
+
+<details>
+<summary>이전 릴리스(v0.8.3 이하)</summary>
+
+## v0.8.3 새 기능
+
+- **MCP 서버** — `omnilane mcp` 는 의존성 없는 stdio MCP 서버를 시작하여,
+  MCP 지원 호스트(Claude Code, Codex, Gemini CLI, Cursor, OpenCode 등)가
+  스킬 설치 없이 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** — 멀티 프로바이더 집합 CLI OpenCode를 통한
+  헤드리스 디스패치(`opencode run`). advise 모드는 내장 읽기 전용 `plan`
+  에이전트를 사용하고 work 모드는 `--auto`를 사용합니다. 기본
+  `coding-overflow` 체인의 마지막 폴백으로 추가되었습니다.
+
+## v0.8.1 새 기능
+
+- **Claude Code 플러그인이 라우팅 리마인더를 자동 로드** — 플러그인에
+  `SessionStart` 훅(`hooks/hooks.json`)이 포함되어 세션 시작 시
+  (`startup|resume|clear`) 라우팅 리마인더를 자동 주입합니다.
+  `~/.claude/CLAUDE.md` 수정 없이 플러그인 설치만으로 적용됩니다.
+  다른 CLI는 기존대로 `install.sh` 지침 파일 방식을 사용합니다.
+
+## v0.8.0 새 기능
+
+- **새 디스패치 벤더 2종** — `kimi`(Moonshot Kimi Code CLI)와
+  `qwen`(Alibaba Qwen Code CLI)이 통일 runner 계약으로 합류:
+  advise 는 읽기 전용, work 는 자동 승인, API 키 환경 변수를 제거해
+  CLI 자체 구독 로그인을 사용, 빈 출력은 명시적 실패.
+  `--vendor kimi|qwen` 으로 직접 지정할 수 있습니다.
+- **coding-overflow 폴백 체인** — 쿼터 안전 밸브가 grok → kimi → qwen
+  → `off` 순으로 폴백해 세 벤더 중 하나만 설치돼 있어도 동작합니다.
+  runner 는 페이크 바이너리로 계약 테스트 완료. 실제 모델 사용 보고를
+  환영합니다.
+
+## v0.7.1 새 기능
+
+- **라우팅 테이블 갱신(2026-07 모델 데이터)** — hardest-coding 1순위를
+  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** 로 변경. 어려운 작업과 장시간 작업에 extra effort 를
+  권장하는 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` 가 안전한 탭 완성을
+  제공하며, macOS 기본 Bash 3.2 크래시 5건을 수정했습니다.
+
+## 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 멈춤을 안전하게 종료** — 전체 상한이 없으면 결정된 호출별 워치독을
+  process group 퓨즈로 사용하고, 명시한 timeout 우선순위와 종료 코드 의미는
+  그대로 유지합니다.
+- **표시 버전을 신뢰 가능하게 유지** — `VERSION` 이 `omnilane --version` 과 두
+  plugin manifest 를 통일하며 CI 가 변경 기록과 5개 언어 README 를 검사합니다.
+
+</details>
+
 ## 🌱 상태
 
 omnilane 은 13개의 디스패치 벤더를 갖춥니다——4개의 하네스 네이티브(codex,

package/README.md

@@ -21,120 +21,57 @@ or any hosted model via OpenRouter — on the subscriptions you already pay for,
 
 ---
 
-## What's new in v0.9.0
-
-- **Five OpenAI-compatible direct-API vendors** — `deepseek`, `zai` (GLM),
-  `mistral`, `groq`, and `cerebras` join `openrouter` as CLI-free lanes (curl +
-  a `<VENDOR>_API_KEY`). A one-line `lib/common.sh` registry entry adds each;
-  see [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
-- **Fish shell completion** — `omnilane completion fish | source`.
-
-## What's new in v0.8.3
-
-- **MCP server** — `omnilane mcp` starts a zero-dependency stdio MCP server,
-  so any MCP-capable host (Claude Code, Codex, Gemini CLI, Cursor, OpenCode…)
-  can discover and call omnilane without installing the skill: tools `route`,
-  `jobs_status`, `jobs_result`, and `list_lanes`. `route` defaults to
-  read-only advise mode; work mode requires an explicit workdir.
-
-## What's new in v0.8.2
-
-- **`openrouter` vendor** — dispatch straight to the OpenRouter API with
-  nothing but `curl` and an `OPENROUTER_API_KEY`: hundreds of hosted models
-  become reachable from any omnilane install, no coding-agent CLI required.
-  Advise/consult only (it cannot edit files; work mode fails with guidance)
-  and the model slug is mandatory, e.g.
-  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`.
-- **`deepseek`, `zai`, `mistral`, `groq`, `cerebras` vendors** — the same
-  CLI-free direct-API path as `openrouter`, for OpenAI-compatible providers:
-  DeepSeek, Z.ai GLM, Mistral, Groq, and Cerebras. Each needs only `curl` and
-  its `<VENDOR>_API_KEY`; advise/consult only. A one-line `lib/common.sh`
-  registry entry defines each endpoint, key env, and default model. See
-  [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
-- **`opencode` vendor** — headless dispatch through the OpenCode
-  multi-provider aggregator CLI (`opencode run`). Advise mode pins OpenCode's
-  built-in read-only `plan` agent; work mode uses `--auto`. Joins the default
-  `coding-overflow` chain as its last fallback.
-
-## What's new in v0.8.1
-
-- **Claude Code plugin auto-loads the routing reminder** — the plugin now
-  ships a `SessionStart` hook (`hooks/hooks.json`) that injects the routing
-  reminder at session open (`startup|resume|clear`), so plugin installs get
-  the persistent reminder with no edit to `~/.claude/CLAUDE.md`. The
-  `install.sh` instruction-file reminder still covers the other CLIs.
+## 👋 New here?
 
-## What's new in v0.8.0
+You already drive an AI coding assistant — **Claude Code, Codex, Cursor, Gemini
+CLI**, and the like. Each one talks to a single AI model, and picking the best
+model for each task is left to you.
 
-- **Two new dispatch vendors** — `kimi` (Moonshot Kimi Code CLI) and `qwen`
-  (Alibaba Qwen Code CLI) join the vendor set with the uniform runner
-  contract: advise stays read-only, work auto-approves, API-key env is
-  stripped so the CLIs use their own subscription logins, and empty output
-  is a loud failure. Pin them with `--vendor kimi|qwen`.
-- **coding-overflow grows a chain** — the quota relief valve now falls back
-  grok → kimi → qwen before `off`, so it works with any one of the three
-  vendors installed. Runners are contract-tested against fake binaries;
-  real-model reports welcome.
+**omnilane picks for you.** For every piece of work it routes the task to the
+model that is best (and cheapest) for it — tough coding to a top coder, quick
+checks to a fast cheap model, long documents to a big-context model — all on the
+subscriptions and API keys you already pay for. Use the built-in defaults, or
+tweak one small file. Nothing new to babysit (it runs behind your existing tool),
+and `./install.sh --uninstall` removes it cleanly.
 
-## What's new in v0.7.1
+**[⬇ Jump to the 60-second start](#-60-second-start)**
 
-- **Routing refresh (2026-07 model data)** — hardest-coding now dispatches
-  GPT-5.6 Sol at **max** effort: Artificial Analysis Coding Agent Index v1.1
-  scores Sol (max) at 80, the current state of the art, retiring the older
-  xhigh-beats-max snapshot.
-- **Claude backups sharpened** — the Claude Opus 4.8 fallback on
-  hardest-coding and hard-judgment moves to **xhigh** effort, following
-  Anthropic's guidance to use extra effort for difficult tasks and
-  long-running work.
+## What's new in v0.9.1
 
-## What's new in v0.7.0
+- **Fix:** `configure set` no longer deletes hand-written comments from
+  `routing.local.yaml` — it rewrites only its own stamp header and the lane
+  being replaced.
 
-- **Preview any dispatch first** — `--dry-run` prints the fully resolved plan
-  (vendor, model, mode, timeouts, side-effect decision) with no provider call
-  and no job state.
-- **Automate with versioned JSON** — one `--json` envelope for `--list`,
-  `--explain`, `--validate`, and `jobs list|status|result|stats`, plus
-  read-only `jobs wait`, `jobs audit`, and an offline `omnilane release-audit`
-  gate with a deterministic manifest.
-- **Drive local jobs end to end** — `jobs tail` peeks at live output,
-  `jobs retry` re-dispatches a completed job fail-closed,
-  `prune --older-than` ages out old jobs, and `--help` covers every command.
-- **Install and complete safely** — `install.sh --check`/`--dry-run` report
-  drift without writing, `omnilane completion bash|zsh` ships safe tab
-  completion, and five macOS stock Bash 3.2 crashes are fixed.
+## What's new in v0.9.0
 
-## What's new in v0.6.0
+- **Five OpenAI-compatible direct-API vendors** — `deepseek`, `zai` (GLM),
+  `mistral`, `groq`, and `cerebras` join `openrouter` as CLI-free lanes (curl +
+  a `<VENDOR>_API_KEY`). A one-line `lib/common.sh` registry entry adds each;
+  see [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
+- **Fish shell completion** — `omnilane completion fish | source`.
 
-- **Explain and validate routes offline** — inspect every fallback candidate
-  with `--explain`, or lint the complete effective table with `--validate`,
-  without invoking a provider or creating job state.
-- **Inspect local health and outcomes** — bounded `jobs.sh stats` aggregates and
-  `omnilane doctor --json` make local automation observable without exposing
-  task or result bodies.
-- **Compare runs in Live Board** — pin one loaded job as a memory-only reference
-  and compare its model path and public result with the current selection.
-- **Keep lock recovery quiet** — transient owner-file read races no longer leak
-  misleading missing-file diagnostics.
+## ⚡ 60-second start
 
-## What's new in v0.5.1
+**The quick way — install from npm:**
 
-- **Use Codex work outside Git** — ordinary directories remain supported;
-  Omnilane never requires or runs `git init`.
-- **Stop non-Git hangs cleanly** — the resolved per-call watchdog becomes an
-  automatic process-group fuse when no whole-job timeout was configured, while
-  explicit timeout precedence and exit semantics remain intact.
-- **Trust the displayed version** — `VERSION` now drives `omnilane --version`
-  and both plugin manifests, with CI checking the changelog and all five READMEs.
+```bash
+npm i -g omnilane                                    # install the CLI
+omnilane route hardest-coding "fix the flaky auth token refresh"
+omnilane doctor                                      # see which AI CLIs / keys you have
+omnilane ui start                                    # optional: watch jobs live in your browser
+```
 
-## ⚡ 60-second start
+**Or clone the repo** (gets you the routing table and skill to customise):
 
 ```bash
 git clone https://github.com/Seraphim0916/omnilane && cd omnilane
 ./install.sh          # finds your CLIs, links the skill, speaks your language
 omnilane route hardest-coding "fix the flaky auth token refresh"
-omnilane ui start     # optional: watch jobs live in your browser
 ```
 
+> New to this? Run `omnilane doctor` first — it tells you which model CLIs and
+> API keys omnilane can already reach, so you know what will actually run.
+
 ## 🧭 How it works
 
 omnilane lets the main loop of **any** agentic CLI classify subtasks into
@@ -467,6 +404,110 @@ configurator and `routing.local.yaml` exist so you can disagree.
   a Git worktree, so the automatic fuse above bounds that case and cleans the
   supervised process group. Omnilane neither initializes nor requires a repository.
 
+## 📜 Release history
+
+<details>
+<summary>Older releases (v0.8.3 and earlier)</summary>
+
+## What's new in v0.8.3
+
+- **MCP server** — `omnilane mcp` starts a zero-dependency stdio MCP server,
+  so any MCP-capable host (Claude Code, Codex, Gemini CLI, Cursor, OpenCode…)
+  can discover and call omnilane without installing the skill: tools `route`,
+  `jobs_status`, `jobs_result`, and `list_lanes`. `route` defaults to
+  read-only advise mode; work mode requires an explicit workdir.
+
+## What's new in v0.8.2
+
+- **`openrouter` vendor** — dispatch straight to the OpenRouter API with
+  nothing but `curl` and an `OPENROUTER_API_KEY`: hundreds of hosted models
+  become reachable from any omnilane install, no coding-agent CLI required.
+  Advise/consult only (it cannot edit files; work mode fails with guidance)
+  and the model slug is mandatory, e.g.
+  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`.
+- **`deepseek`, `zai`, `mistral`, `groq`, `cerebras` vendors** — the same
+  CLI-free direct-API path as `openrouter`, for OpenAI-compatible providers:
+  DeepSeek, Z.ai GLM, Mistral, Groq, and Cerebras. Each needs only `curl` and
+  its `<VENDOR>_API_KEY`; advise/consult only. A one-line `lib/common.sh`
+  registry entry defines each endpoint, key env, and default model. See
+  [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
+- **`opencode` vendor** — headless dispatch through the OpenCode
+  multi-provider aggregator CLI (`opencode run`). Advise mode pins OpenCode's
+  built-in read-only `plan` agent; work mode uses `--auto`. Joins the default
+  `coding-overflow` chain as its last fallback.
+
+## What's new in v0.8.1
+
+- **Claude Code plugin auto-loads the routing reminder** — the plugin now
+  ships a `SessionStart` hook (`hooks/hooks.json`) that injects the routing
+  reminder at session open (`startup|resume|clear`), so plugin installs get
+  the persistent reminder with no edit to `~/.claude/CLAUDE.md`. The
+  `install.sh` instruction-file reminder still covers the other CLIs.
+
+## What's new in v0.8.0
+
+- **Two new dispatch vendors** — `kimi` (Moonshot Kimi Code CLI) and `qwen`
+  (Alibaba Qwen Code CLI) join the vendor set with the uniform runner
+  contract: advise stays read-only, work auto-approves, API-key env is
+  stripped so the CLIs use their own subscription logins, and empty output
+  is a loud failure. Pin them with `--vendor kimi|qwen`.
+- **coding-overflow grows a chain** — the quota relief valve now falls back
+  grok → kimi → qwen before `off`, so it works with any one of the three
+  vendors installed. Runners are contract-tested against fake binaries;
+  real-model reports welcome.
+
+## What's new in v0.7.1
+
+- **Routing refresh (2026-07 model data)** — hardest-coding now dispatches
+  GPT-5.6 Sol at **max** effort: Artificial Analysis Coding Agent Index v1.1
+  scores Sol (max) at 80, the current state of the art, retiring the older
+  xhigh-beats-max snapshot.
+- **Claude backups sharpened** — the Claude Opus 4.8 fallback on
+  hardest-coding and hard-judgment moves to **xhigh** effort, following
+  Anthropic's guidance to use extra effort for difficult tasks and
+  long-running work.
+
+## What's new in v0.7.0
+
+- **Preview any dispatch first** — `--dry-run` prints the fully resolved plan
+  (vendor, model, mode, timeouts, side-effect decision) with no provider call
+  and no job state.
+- **Automate with versioned JSON** — one `--json` envelope for `--list`,
+  `--explain`, `--validate`, and `jobs list|status|result|stats`, plus
+  read-only `jobs wait`, `jobs audit`, and an offline `omnilane release-audit`
+  gate with a deterministic manifest.
+- **Drive local jobs end to end** — `jobs tail` peeks at live output,
+  `jobs retry` re-dispatches a completed job fail-closed,
+  `prune --older-than` ages out old jobs, and `--help` covers every command.
+- **Install and complete safely** — `install.sh --check`/`--dry-run` report
+  drift without writing, `omnilane completion bash|zsh` ships safe tab
+  completion, and five macOS stock Bash 3.2 crashes are fixed.
+
+## What's new in v0.6.0
+
+- **Explain and validate routes offline** — inspect every fallback candidate
+  with `--explain`, or lint the complete effective table with `--validate`,
+  without invoking a provider or creating job state.
+- **Inspect local health and outcomes** — bounded `jobs.sh stats` aggregates and
+  `omnilane doctor --json` make local automation observable without exposing
+  task or result bodies.
+- **Compare runs in Live Board** — pin one loaded job as a memory-only reference
+  and compare its model path and public result with the current selection.
+- **Keep lock recovery quiet** — transient owner-file read races no longer leak
+  misleading missing-file diagnostics.
+
+## What's new in v0.5.1
+
+- **Use Codex work outside Git** — ordinary directories remain supported;
+  Omnilane never requires or runs `git init`.
+- **Stop non-Git hangs cleanly** — the resolved per-call watchdog becomes an
+  automatic process-group fuse when no whole-job timeout was configured, while
+  explicit timeout precedence and exit semantics remain intact.
+- **Trust the displayed version** — `VERSION` now drives `omnilane --version`
+  and both plugin manifests, with CI checking the changelog and all five READMEs.
+
+</details>
+
 ## 🌱 Status
 
 omnilane now spans thirteen dispatch vendors — four harness natives (codex,

package/README.zh-CN.md

@@ -21,97 +21,50 @@
 
 ---
 
-## 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`。
+你已经在用某个 AI 写程式助手——**Claude Code、Codex、Cursor、Gemini
+CLI** 之类。每个一次只接一个 AI 模型,而「每件工作该用哪个模型最好」得你自己决定。
 
-## v0.8.3 新功能
+**omnilane 帮你决定。** 每一件工作,它会自动派给对那件事最强(也最省)的模型——硬派程式
+交给顶尖程式模型、随手的小检查交给又快又便宜的、长文件交给大脉络模型——全部用你本来就在
+付费的订阅与 API 金钥。用内建预设值就好,或改一个小设定档就能微调。不用另外顾一套东西
+(它躲在你现有工具背后跑),`./install.sh --uninstall` 可干净移除。
 
-- **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。
+**[⬇ 直接跳到 60 秒上手](#-60-秒上手)**
 
-## v0.8.2 新功能
+## v0.9.1 新功能
 
-- **`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` 链作为最后回退。
+- **修复**:`configure set` 不再删除 `routing.local.yaml` 中手写的注释——
+  只改写自身的戳记行与被替换的 lane。
 
-## 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.9.0 新功能
 
-## v0.6.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`。
 
-- **离线理解并验证路由** — 使用 `--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),
@@ -394,6 +347,90 @@ configure.sh set|get|unset|list|diff LANE [SPEC]    # 非交互编辑/查看 rou
   外卡住，因此上面的自动保险丝会限制这个场景并清理受监工的进程组。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>
+
 ## 🌱 状态
 
 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。

package/README.zh-TW.md

@@ -21,105 +21,53 @@
 
 ---
 
-## 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`。
+你已經在用某個 AI 寫程式助手——**Claude Code、Codex、Cursor、Gemini
+CLI** 之類。每個一次只接一個 AI 模型,而「每件工作該用哪個模型最好」得你自己決定。
 
-## v0.8.3 新功能
+**omnilane 幫你決定。** 每一件工作,它會自動派給對那件事最強(也最省)的模型——硬派程式
+交給頂尖程式模型、隨手的小檢查交給又快又便宜的、長文件交給大脈絡模型——全部用你本來就在
+付費的訂閱與 API 金鑰。用內建預設值就好,或改一個小設定檔就能微調。不用另外顧一套東西
+(它躲在你現有工具背後跑),`./install.sh --uninstall` 可乾淨移除。
 
-- **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。
+**[⬇ 直接跳到 60 秒上手](#-60-秒上手)**
 
-## v0.8.2 新功能
+## v0.9.1 新功能
 
-- **`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 新功能
+- **修正**:`configure set` 不再刪掉 `routing.local.yaml` 裡手寫的註解——
+  只改寫自身的戳記行與被取代的 lane。
 
-- **路由表更新(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.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),
@@ -412,6 +360,95 @@ 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>
+
 ## 🌱 狀態
 
 omnilane 現有十三個派工 vendor——四個框架原生(codex、claude、grok、gemini)、

package/VERSION

@@ -1 +1 @@
-0.9.0
+0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omnilane",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "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/scripts/configure.sh

@@ -60,7 +60,9 @@ cfg_set() {
   {
     echo "# updated by 'configure set' on $(date +%F) — first match per lane wins"
     echo "$lane: $spec"
-    [[ "$had_file" -eq 1 ]] && grep -v '^#' "$LOCAL_FILE.bak" | grep -v "^$lane:" || true
+    # Drop only our own stamp line and the lane being replaced; the user's own
+    # comments in routing.local.yaml survive a set.
+    [[ "$had_file" -eq 1 ]] && grep -v "^# updated by 'configure set'" "$LOCAL_FILE.bak" | grep -v "^$lane:" || true
   } > "$tmp"
   mv "$tmp" "$LOCAL_FILE"