tianshu-harness 3.27.0 → 3.30.0

package/README.en.md

@@ -25,7 +25,7 @@
   <img src="https://img.shields.io/github/v/release/huiliyi37/Tianshu-harness?color=8B5CF6&label=Release&logo=github&style=for-the-badge" alt="GitHub release">
   <img src="https://img.shields.io/badge/License-Apache%202.0-3B5BDB?style=for-the-badge&logo=apache" alt="License">
   <img src="https://img.shields.io/badge/TypeScript-Strict-blue?style=for-the-badge&logo=typescript" alt="TypeScript">
-  <img src="https://img.shields.io/badge/Tests-16%2C000%2B%20Passed-green?style=for-the-badge&logo=testinglibrary" alt="Tests">
+  <img src="https://img.shields.io/badge/Tests-19%2C000%2B%20Passed-green?style=for-the-badge&logo=testinglibrary" alt="Tests">
   <a href="https://discord.gg/XjWTATCHB"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
   <a href="https://atomgit.com/huiliyi37/Tianshu-harness"><img src="https://atomgit.com/huiliyi37/Tianshu-harness/star/badge.svg" alt="AtomGit Star"></a>
   <a href="https://github.com/huiliyi37/Tianshu-harness/releases"><img src="https://img.shields.io/github/downloads/huiliyi37/Tianshu-harness/total?logo=github&label=downloads" alt="GitHub downloads"></a>
@@ -41,10 +41,10 @@
 
 ### A coding-agent runtime for real engineering work
 
-> **Tianshu** is a TypeScript coding-agent runtime: one agent kernel shared by a **terminal TUI** and a **desktop GUI**. It is built to let models do continuous multi-step engineering work — with cognitive guardrails, multi-agent orchestration, and a DeepSeek V4 prefix-cache-friendly design for cost-efficient long sessions.
+> **Tianshu** is a TypeScript coding-agent runtime: one agent kernel shared by a **terminal TUI** and a **desktop GUI**. It is built to let models do continuous multi-step engineering work — with cognitive guardrails, multi-agent orchestration, and a DeepSeek V4 / V4.1 prefix-cache-friendly design (supporting current Flash and Pro models) for cost-efficient long sessions.
 
 - **One kernel, two surfaces** — a pure-ANSI terminal TUI (`tianshu`) and a Tauri desktop app (macOS / Windows / Linux) share the same agent core, so capabilities stay consistent across interfaces.
-- **Cognitive Virtual Machine (CVM)** — 72 runtime hooks across 5 lifecycle phases put an observable, correctable cognitive layer between model output and real tool actions ([A/B evidence](docs/CVM运行时对Agent模型的实证影响.md)).
+- **Cognitive Virtual Machine (CVM)** — 75 runtime hooks across 5 lifecycle phases put an observable, correctable cognitive layer between model output and real tool actions ([A/B evidence](docs/CVM运行时对Agent模型的实证影响.md)).
 - **Multi-agent orchestration** — from lightweight `/scout` reconnaissance and parallel `/team` execution to `/council` multi-model review and `/galaxy` multi-dimensional attack, complex work runs in waves with review gates.
 - **Unified project memory** — project knowledge lives in `.rivet/knowledge/memory.jsonl`; automatic injection is limited to governance/constraint/preference memories, while old failures and docs stay explicit-recall-only so they cannot hijack new questions.
 - **Prefix-cache first** — frozen prefix + incremental appendix + boundary compaction sustain a measured steady-state **95–99% prefix-cache hit rate** on DeepSeek V4.
@@ -113,7 +113,7 @@ CVM doesn't make the model "smarter"; it adds four layers of defense in depth:
 Layer 1: Belief constitution (static prompt)  → "you should question, verify, refuse"   [A/B proven]
 Layer 2: Courage Hook (preTurn)               → encourage independent judgment          [A/B proven]
 Layer 3: Sensorium (per turn, <1ms)           → 6-dim state sensing drives strategy      [Wave 7-8 proven]
-Layer 4: RuntimeHookPipeline (72 hooks)       → trap-and-emulate regressed behaviors     [always on]
+Layer 4: RuntimeHookPipeline (75 hooks)       → trap-and-emulate regressed behaviors     [always on]
 ```
 
 ### Independent cognition: star domains are not role-play
@@ -132,14 +132,15 @@ Once the degradations are intercepted layer by layer, models begin to express th
 
 | Metric | Value |
 |--------|-------|
-| CLI source (TypeScript, excl. tests) | 1,078 files / 257,623 lines |
-| Test code | 1,361 files / 256,001 lines |
-| Test cases (node:test, static declarations) | **16,471**, test : source ≈ **0.99 : 1** |
-| Total commits | **6,178** on main (repo created 2026-05-15, 105 days in) |
+| `src/` source (TypeScript, excl. tests) | ~1,256 files / ~300k lines (`agent/` alone is 483 files) |
+| `src/` tests | ~1,592 files / ~310k lines (node:test, ~1:1 with source) |
+| `desktop/src` | ~450 files / ~96k lines (React), plus ~11k lines of Rust |
+| `vscode-extension/src` | 17 files / ~2,700 lines |
+| Commits | **8,008** total (created 2026-05-15, ~4.5 months; 1,769 in the last 30 days) |
 | Type checking | `tsc` strict + `noUncheckedIndexedAccess` |
 | Prefix-cache hit rate | 95–99% steady state, measured on long sessions |
 
-Agent core logic (multi-turn loops, tool pipelines, context compaction) is notoriously hard to test, and most open-source agents ship with thin coverage. This project maintains a near 1:1 test-to-source ratio, and every incident fix ships with a regression test — the ratio has held between 0.93:1 and 0.99:1 as the codebase grew (the table above is a measured snapshot as of 2026-08-28). Full methodology, growth milestones, and reproduction commands: [Engineering Metrics](docs/engineering-metrics.md).
+Agent core logic (multi-turn loops, tool pipelines, context compaction) is notoriously hard to test, and most open-source agents ship with thin coverage. This project keeps tests roughly equal to source, and every incident fix ships with a regression test — the ratio has stayed near 1:1 as the codebase grew (earlier slices sat between 0.93:1 and 0.99:1; this table is a rounded snapshot as of 2026-09-30). Full methodology, growth milestones, and reproduction commands: [Engineering Metrics](docs/engineering-metrics.md).
 
 ### Tianshu vs. MiMo-Code vs. Claude Code
 
@@ -148,7 +149,7 @@ Agent core logic (multi-turn loops, tool pipelines, context compaction) is notor
 | Dimension | Tianshu | MiMo-Code | Claude Code |
 | :--- | :--- | :--- | :--- |
 | **Core focus** | Cognitive runtime (CVM) | Product experience / ecosystem | Enterprise coding agent |
-| **Runtime hook layer** | 72 conditionally-assembled hook modules × 5 phases | standard agent loop | user-configurable hooks |
+| **Runtime hook layer** | 75 conditionally-assembled hook modules × 5 phases | standard agent loop | user-configurable hooks |
 | **Prefix-cache tuning** | Deeply tuned for DeepSeek V4 (95–99% steady-state) | provider default | Anthropic prompt caching |
 | **Self-perception** | Continuous cognitive-state vector | — | — |
 | **Cross-session memory** | Unified project memory + adaptive recall + session-scoped pheromones | SQLite + MEMORY.md | project memory |
@@ -592,6 +593,7 @@ The desktop app builds a visual interaction layer on top of the TUI's full capab
 - **Adaptive sidecar memory** — heap cap auto-tiers by machine RAM (8G→2G / 16G→4G / 32G→6G / 64G+→8G; override via `RIVET_SIDECAR_HEAP_MB`); machines with ≤8GB auto-enable the lean resource tier.
 - **Watchdog auto-recovery** — auto-continues on boundary stalls; the desktop timeline shows recovery events (⟳ auto-recover / ⏹ quota exhausted).
 - **Multi-session concurrency** — a tab bar manages multiple sessions, each with its own cwd + model + approval mode.
+- **WSL connected runtime** (Windows) — one click to connect to the runtime running inside WSL; sessions, file access and command execution all happen on the Linux side. Disconnecting cleans up the WSL-side process automatically. The two sides upgrade independently — see the [Desktop User Guide](docs/desktop-guide.md).
 - **Feature panels** (left rail `⌘1…9` to switch): Mission Control (multi-session console), Inbox, Automations (scheduled tasks), Skills / Hooks management, Git / GitHub, Changes (diff review), Delegation (fleet tree & team-wave DAG), Cockpit.
 - **Popout window** — pop a single conversation thread into its own window for multi-screen parallel work.
 - **JobsDock / TodoDock** — a persistent background-task dock (expand logs / kill / open in terminal) and a cross-tab persistent todo dock.
@@ -665,13 +667,14 @@ Registration steps and parameters are covered under “Image generation” in [M
 
 | Provider | Auth | Notable Models |
 |----------|------|----------------|
-| DeepSeek | API key | deepseek-v4-pro (1M ctx), deepseek-v4-flash, deepseek-v4-flash-vision-exp (vision) |
+| DeepSeek | API key | deepseek-flash (1M ctx, DeepSeek-V4.1-Flash, native vision), deepseek-v4-pro (1M ctx, DeepSeek-V4-Pro-0813) |
 | DeepSeek Spark (Pro only) | API key (`DEEPSEEK_SPARK_API_KEY`) | deepseek-v4-flash (lightweight reasoning + anchored cache channel) |
 | Claude | API key (via `cc-switch` proxy) | claude-opus-4-8, claude-sonnet-4-5 |
 | GLM (Zhipu) | API key | glm-5.3 (1M ctx), glm-5.3-flash (vision), glm-5.2 |
 | Codex (GPT-5.6) | OAuth PKCE (ChatGPT subscription) | gpt-5.6-sol |
-| MiniMax | API key | MiniMax-M3, MiniMax-M2.7 |
-| MiMo | API key | mimo-v2.5-pro |
+| MiniMax | API key | MiniMax-M3 (vision), MiniMax-M2.7 |
+| MiMo | API key | mimo-v2.5-pro (preset 2.5; V2.6 Flash / Pro with vision can be discovered/added) |
+| Kimi Code | API key | k3 (1M ctx, vision), k3-256k, kimi-for-coding |
 
 Switch providers inside a session with `/model <name>`.
 
@@ -855,7 +858,7 @@ Node.js 24 · TypeScript strict (`noUncheckedIndexedAccess`) · T9 ANSI renderin
 
 ```bash
 npm run typecheck                                    # typecheck
-npm test                                             # all tests (16,000+ cases)
+npm test                                             # all tests (19,000+ cases)
 npm run build                                        # tsup bundle + staged native/wasm payload
 node dist/cli/entry.js                               # launch TUI
 node dist/cli/entry.js -p "fix the typo"             # headless mode
@@ -1054,9 +1057,9 @@ Write only the fields you want to override; defaults are deep-merged. Full schem
 - **Security vulnerabilities** → [Report privately](https://github.com/huiliyi37/Tianshu-harness/security/advisories/new) (do not open a public issue)
 - **Contributing** → See [CONTRIBUTING.md](CONTRIBUTING.md)
 - **Support guide** → See SUPPORT.md
-- **WeChat group** → 「天枢 harness 交流群」 — scan the QR code below to join (QR codes expire every 7 days; leave a note in Discussions once expired):
+- **WeChat group** → 「天枢 harness 交流群5群」 — scan the QR code below to join (QR codes expire every 7 days; leave a note in Discussions once expired):
 
-<img src="docs/brand/assets/wechat-group-qr.png" width="280" alt="Tianshu Harness WeChat group QR code">
+<img src="docs/brand/assets/wechat-group-qr.png" width="280" alt="Tianshu Harness WeChat group 5 QR code">
 
 > Note: a maintainer needs to enable Discussions in `Settings → General → Discussions` first.
 

package/README.ja.md

@@ -29,7 +29,7 @@
   <img src="https://img.shields.io/github/v/release/huiliyi37/Tianshu-harness?color=8B5CF6&label=Release&logo=github&style=for-the-badge" alt="GitHub release">
   <img src="https://img.shields.io/badge/License-Apache%202.0-3B5BDB?style=for-the-badge&logo=apache" alt="License">
   <img src="https://img.shields.io/badge/TypeScript-Strict-blue?style=for-the-badge&logo=typescript" alt="TypeScript">
-  <img src="https://img.shields.io/badge/Tests-16%2C000%2B%20Passed-green?style=for-the-badge&logo=testinglibrary" alt="Tests">
+  <img src="https://img.shields.io/badge/Tests-19%2C000%2B%20Passed-green?style=for-the-badge&logo=testinglibrary" alt="Tests">
   <a href="https://discord.gg/XjWTATCHB"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
   <a href="https://atomgit.com/huiliyi37/Tianshu-harness"><img src="https://atomgit.com/huiliyi37/Tianshu-harness/star/badge.svg" alt="AtomGit Star"></a>
   <a href="https://github.com/huiliyi37/Tianshu-harness/releases"><img src="https://img.shields.io/github/downloads/huiliyi37/Tianshu-harness/total?logo=github&label=downloads" alt="GitHub downloads"></a>
@@ -45,10 +45,10 @@
 
 ### 実際のエンジニアリング作業のための AI エージェントランタイム
 
-> **天枢**は TypeScript で書かれたコーディングエージェントのランタイムです。**ターミナル TUI** と**デスクトップ GUI** が同一カーネルを共有し、モデルが質問に答えるだけでなく、認知的ガードレール・マルチエージェントオーケストレーション・DeepSeek V4 のプレフィックスキャッシュ向けに設計された低コストの長大セッションを備え、多段階のコーディング作業を継続的に完遂できるようにします。
+> **天枢**は TypeScript で書かれたコーディングエージェントのランタイムです。**ターミナル TUI** と**デスクトップ GUI** が同一カーネルを共有し、モデルが質問に答えるだけでなく、認知的ガードレール・マルチエージェントオーケストレーション・DeepSeek V4 / V4.1 のプレフィックスキャッシュ向けに設計された低コストの長大セッション（現行の Flash および Pro モデルをサポート）を備え、多段階のコーディング作業を継続的に完遂できるようにします。
 
 - **ターミナル × デスクトップ、一つのカーネル** —— 純 ANSI 自前 TUI（`tianshu`）と Tauri デスクトップ（macOS / Windows / Linux）が同一エージェントカーネルを共有。両端で能力は一致し、利用シーンに応じて切り替えられます。
-- **認知仮想マシン（CVM）** —— 5 大フェーズにまたがる 72 のランタイムフックが、モデル出力と実際のアクションの間に観測可能で修正可能な認知レイヤーを挟みます（[A/B 実証](docs/CVM运行时对Agent模型的实证影响.md)）。
+- **認知仮想マシン（CVM）** —— 5 大フェーズにまたがる 75 のランタイムフックが、モデル出力と実際のアクションの間に観測可能で修正可能な認知レイヤーを挟みます（[A/B 実証](docs/CVM运行时对Agent模型的实证影响.md)）。
 - **マルチエージェントオーケストレーション** —— 軽量な `/scout` 読み取り専用偵察、並行 `/team` 施工から、`/council` の複数席会診、`/galaxy` の多次元攻略まで。複雑なタスクは波（wave）単位で実行し、波ごとに検収します。
 - **統一プロジェクトメモリ** —— プロジェクト知識は `.rivet/knowledge/memory.jsonl` に書き込まれます。自動注入はガバナンス／制約系メモリに限定され、過去の問題やドキュメントは明示的な recall 経由のみ——新しいタスクを乗っ取りません。
 - **プレフィックスキャッシュ最優先** —— フリーズしたプレフィックス＋インクリメンタル appendix＋境界圧縮により、DeepSeek V4 の長大セッションで実測の定常ヒット率 **95–99%** を維持し、token コストを大幅に削減します。
@@ -116,7 +116,7 @@ CVM はモデルを「より賢く」するのではなく、4 層の防御深
 Layer 1: 信念憲法（static prompt）      → 「疑問を持ち、検証し、拒否せよ」          [A/B 検証済み]
 Layer 2: Courage Hook（preTurn）        → 高確信時に独立判断を促す                  [A/B 検証済み]
 Layer 3: Sensorium（毎 turn <1ms）      → 六次元状態感知で戦略切替を駆動            [Wave 7-8 検証済み]
-Layer 4: RuntimeHookPipeline（72 hooks）→ trap-and-emulate で退化行動をインターセプト [全パイプライン稼働中]
+Layer 4: RuntimeHookPipeline（75 hooks）→ trap-and-emulate で退化行動をインターセプト [全パイプライン稼働中]
 ```
 
 ### 独立した認知：星域はロールプレイではない
@@ -135,14 +135,15 @@ Layer 4: RuntimeHookPipeline（72 hooks）→ trap-and-emulate で退化行動
 
 | 指標 | 数値 |
 |------|------|
-| CLI ソースコード（TypeScript、テスト除く） | 1,078 ファイル / 257,623 行 |
-| テストコード | 1,361 ファイル / 256,001 行 |
-| テストケース（node:test、静的宣言ベース） | **16,471**、テスト : ソース ≈ **0.99 : 1** |
-| 累計コミット | **6,178**（main ブランチ；2026-05-15 リポジトリ作成、105 日） |
+| `src/` ソース（TypeScript、テスト除く） | 約 1,256 ファイル / 30 万行（最大の `agent/` は 483 ファイル） |
+| `src/` テスト | 約 1,592 ファイル / 31 万行（node:test、ソースと約 1:1） |
+| `desktop/src` | 約 450 ファイル / 9.6 万行（React）、別途 Rust 約 1.1 万行 |
+| `vscode-extension/src` | 17 ファイル / 約 2,700 行 |
+| 累計コミット | **8,008**（2026-05-15 作成、約 4.5 か月；直近 30 日で 1,769） |
 | 型チェック | `tsc` strict + `noUncheckedIndexedAccess` |
 | プレフィックスキャッシュヒット率 | 長大セッションの定常実測 95–99% |
 
-コーディングエージェントのコアロジック（マルチターンループ、ツールパイプライン、コンテキスト圧縮）はテスト困難で有名で、オープンソースのエージェントプロジェクトは一般にテストカバレッジが薄いものです——本プロジェクトはテストとソースを同量に保ち、障害修正には必ず回帰テストを付けています。テスト:ソース行数比は長期にわたり 0.93–0.99 を維持し、規模拡大でも薄まっていません（上表は 2026-08-28 実測スナップショット）。完全な統計口径・イテレーションマイルストーン・再現コマンドは [エンジニアリング品質指標](docs/engineering-metrics.md) を参照。
+コーディングエージェントのコアロジック（マルチターンループ、ツールパイプライン、コンテキスト圧縮）はテスト困難で有名で、オープンソースのエージェントプロジェクトは一般にテストカバレッジが薄いものです——本プロジェクトはテストとソースを同量に保ち、障害修正には必ず回帰テストを付けています。テスト:ソース行数比は 1:1 付近を維持し、規模拡大でも薄まっていません（以前の切片は 0.93–0.99；上表は 2026-09-30 の概数スナップショット）。完全な統計口径・イテレーションマイルストーン・再現コマンドは [エンジニアリング品質指標](docs/engineering-metrics.md) を参照。
 
 ## 🚀 クイックスタート
 
@@ -336,7 +337,7 @@ DeepSeek はキャッシュミスに 50× の料金を課します。天枢の
 
 プレフィックスキャッシュが定常上限に達した後、コスト最適化は DeepSeek API の思考 token 側に移ります——出力 token 課金の推論モデルでは verbose reasoning の削減が ROI 最高のレバーです。
 
-- **デフォルト reasoningEffort の降格** —— DeepSeek V4 Pro は `max` → `high`、Flash は `max` → `medium`。明示設定済みユーザーは影響なし（`reasoningFloor` 保護）。
+- **デフォルト reasoningEffort の調整** —— DeepSeek 主力モデル（Pro / Flash）のデフォルトはいずれも `high`（Flash は `medium` から `high` へ引き上げ）。明示設定済みユーザーは影響なし（`reasoningFloor` 保護）。
 - **effort ルーティング（デフォルト有効）** —— 低複雑度＋高確信度のルーチンターンは reasoning effort を自動で 1 段下げ、決して上げない。`RIVET_EFFORT_ROUTING=0` でオフ。
 - **Compact は flash 側路で** —— 圧縮時に provider 未設定でも主モデルを走らせてしまうバグを修正し、主 provider から flash エンドポイントを自動推定。
 - **Doom-loop 自動収束** —— 繰り返しツール呼び出しを検出すると、動的 appendix がより厳しい output-style 制約を注入し、無駄な思考 token 消費を削減。`RIVET_TERSE=0` でオフ。
@@ -607,6 +608,7 @@ TUI は CLI のデフォルトサーフェスです。デスクトップ版（Ta
 - **sidecar メモリ適応**：ヒープ上限をマシンメモリで自動段階分け（8G→2G / 16G→4G / 32G→6G / 64G+→8G、`RIVET_SIDECAR_HEAP_MB` で上書き可）。≤8GB マシンは自動で lean リソースセットを有効化
 - **watchdog 自動復旧**：境界での停滞時に自動で続行。デスクトップ版のタイムラインに復旧イベントを表示（⟳ 自動復旧 / ⏹ クォータ枯渇）
 - **マルチセッション並行**：タブバーで複数セッションを管理。それぞれ独立した cwd＋モデル＋承認モード
+- **WSL 接続ランタイム**（Windows）：ワンクリックで WSL 内で動作するランタイムに接続。セッション・ファイル読み書き・コマンド実行がすべて Linux 側で行われます。切断時は WSL 側プロセスを自動クリーンアップ。両側は独立してアップグレードできます——詳細は [デスクトップユーザーガイド](docs/desktop-guide.md) を参照。
 - **機能パネル**（左サイドバー `⌘1…9` で切替）：Mission Control（マルチセッションコンソール）、Inbox（受信トレイ）、Automations（定期タスク）、Skills / Hooks 管理、Git / GitHub、Changes（変更レビュー）、Delegation（委譲艦隊とチーム波次 DAG）、Cockpit コックピット
 - **Popout 独立ウィンドウ**：単一のセッションスレッドを独立ウィンドウに分離し、マルチディスプレイで並行
 - **JobsDock / TodoDock 常駐ドロワー**：バックグラウンドタスクのドッキングバー（ログ展開 / Kill / ターミナルで開く）、タブ横断の常駐 todo
@@ -716,15 +718,16 @@ OpenAI 形式のテキスト→画像エンドポイント（SiliconFlow / OpenA
 
 ### マルチプロバイダー＋適応的ルーティング
 
-| プロバイダー | 認証方式 | フラッグシップモデル |
+| プロバイダー | 認証方式 | 接続モデルの例 |
 |--------|----------|----------|
-| DeepSeek | API key | deepseek-v4-pro (1M ctx), deepseek-v4-flash, deepseek-v4-flash-vision-exp（ビジュアル） |
+| DeepSeek | API key | deepseek-flash（1M ctx、DeepSeek-V4.1-Flash、ネイティブビジュアル）, deepseek-v4-pro（1M ctx、DeepSeek-V4-Pro-0813） |
 | DeepSeek Spark（Pro 専用） | API key（`DEEPSEEK_SPARK_API_KEY`） | deepseek-v4-flash（軽量推論＋アンカーキャッシュチャネル） |
 | Claude | API key（`cc-switch` プロキシ経由） | claude-opus-4-8, claude-sonnet-4-5 |
 | GLM（智谱） | API key | glm-5.3 (1M ctx), glm-5.3-flash（ビジュアル）, glm-5.2 |
 | Codex (GPT-5.6) | OAuth PKCE（ChatGPT サブスクリプション） | gpt-5.6-sol |
-| MiniMax | API key | MiniMax-M3, MiniMax-M2.7 |
-| MiMo | API key | mimo-v2.5-pro |
+| MiniMax | API key | MiniMax-M3（ビジュアル）, MiniMax-M2.7 |
+| MiMo | API key | mimo-v2.5-pro（プリセット 2.5；ビジュアル対応の最新 MiMo V2.6 Flash / Pro も検出・追加可能） |
+| Kimi Code | API key | k3（1M ctx、ビジュアル）, k3-256k, kimi-for-coding |
 
 セッション内では `/model <name>` でいつでもプロバイダーを切替。
 
@@ -840,7 +843,7 @@ tianshu config set-approval auto-safe       # デフォルト段階を永続化
 | コマンド | 説明 |
 |------|------|
 | `/model [name\|list]` | モデル/プロバイダーを表示または切替 |
-| `/effort [off\|low\|medium\|high\|max\|auto]` | 推論深度を制御（引数なしで選択パネル表示）。デフォルト `high`（Pro）/ `medium`（Flash）、ルーチンターンは自動降格。手動で `max` にしたものは決して降格されない |
+| `/effort [off\|low\|medium\|high\|max\|auto]` | 推論深度を制御（引数なしで選択パネル表示）。デフォルトはいずれも `high`（Pro / Flash）、ルーチンターンは自動降格。手動で `max` にしたものは決して降格されない |
 | `/permission [supervise\|auto\|unattended\|manual\|yolo\|allow\|deny\|bash\|remove\|reset\|test]` | 権限モード：監督 / 自動 / 全自動 |
 | `/yes [off]` `/yolo [off]` | ワンクリック全自動。両者は同じ意味（`off` で自動に戻る）——デフォルトとして永続化され、再起動後も有効 |
 | `/domain [list\|<name>\|auto\|off]` | 星域ペルソナを表示または切替 |
@@ -918,7 +921,7 @@ Node.js 24 · TypeScript strict（`noUncheckedIndexedAccess`）· T9 ANSI レン
 
 ```bash
 npm run typecheck                                    # 型チェック
-npm test                                             # すべてのテスト（16,000+ ケース）
+npm test                                             # すべてのテスト（19,000+ ケース）
 npm run build                                        # tsup バンドル＋ネイティブ/wasm ペイロード配置
 node dist/cli/entry.js                               # TUI 起動
 node dist/cli/entry.js -p "fix the typo"             # ヘッドレスモード
@@ -1165,9 +1168,9 @@ tianshu logs open desktop            # sidecar ログディレクトリを開く
 - **セキュリティ脆弱性** → [プライベート報告](https://github.com/huiliyi37/Tianshu-harness/security/advisories/new)（公開 issue を開かないでください）
 - **コードへのコントリビュート** → [CONTRIBUTING.md](CONTRIBUTING.md) を参照
 - **ヘルプガイド** → [SUPPORT.md](SUPPORT.md) を参照
-- **WeChat 交流グループ** →「天枢 harness 交流群」。QR コードで参加。日常の議論 / フィードバック / リリース情報をいち早く入手：
+- **WeChat 交流グループ** →「天枢 harness 交流群5群」。QR コードで参加。日常の議論 / フィードバック / リリース情報をいち早く入手：
 
-<img src="docs/brand/assets/wechat-group-qr.png" width="280" alt="天枢 harness 交流群 WeChat グループ QR コード">
+<img src="docs/brand/assets/wechat-group-qr.png" width="280" alt="天枢 harness 交流群5群 WeChat グループ QR コード">
 
 > WeChat グループの QR コードには有効期限（7 日）があります。期限切れの場合は [Discussions](https://github.com/huiliyi37/Tianshu-harness/discussions) または Issue にコメントしてください。メンテナーが新しい QR を補充します。
 

package/README.ko.md

@@ -29,7 +29,7 @@
   <img src="https://img.shields.io/github/v/release/huiliyi37/Tianshu-harness?color=8B5CF6&label=Release&logo=github&style=for-the-badge" alt="GitHub release">
   <img src="https://img.shields.io/badge/License-Apache%202.0-3B5BDB?style=for-the-badge&logo=apache" alt="License">
   <img src="https://img.shields.io/badge/TypeScript-Strict-blue?style=for-the-badge&logo=typescript" alt="TypeScript">
-  <img src="https://img.shields.io/badge/Tests-16%2C000%2B%20Passed-green?style=for-the-badge&logo=testinglibrary" alt="Tests">
+  <img src="https://img.shields.io/badge/Tests-19%2C000%2B%20Passed-green?style=for-the-badge&logo=testinglibrary" alt="Tests">
   <a href="https://discord.gg/XjWTATCHB"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
   <a href="https://atomgit.com/huiliyi37/Tianshu-harness"><img src="https://atomgit.com/huiliyi37/Tianshu-harness/star/badge.svg" alt="AtomGit Star"></a>
   <a href="https://github.com/huiliyi37/Tianshu-harness/releases"><img src="https://img.shields.io/github/downloads/huiliyi37/Tianshu-harness/total?logo=github&label=downloads" alt="GitHub downloads"></a>
@@ -48,7 +48,7 @@
 > **天枢**는 TypeScript로 작성된 코딩 에이전트 런타임입니다. **터미널 TUI**와 **데스크톱 GUI**가 동일한 커널을 공유하며, 모델이 질문에 답하는 것에 그치지 않고, 인지 가드레일·멀티에이전트 오케스트레이션·DeepSeek V4 프리픽스 캐시에 맞춰 설계된 저비용 장대 세션을 갖추고 다단계 코딩 작업을 계속 완수할 수 있게 합니다.
 
 - **터미널 × 데스크톱, 하나의 커널** —— 순수 ANSI 자체 제작 TUI（`tianshu`）와 Tauri 데스크톱（macOS / Windows / Linux）이 동일한 에이전트 커널을 공유합니다. 양쪽의 능력은 동일하며 사용 시나리오에 따라 전환할 수 있습니다.
-- **인지 가상 머신（CVM）** —— 72개의 런타임 훅이 5대 단계에 걸쳐 있어, 모델 출력과 실제 행동 사이에 관측 가능하고 바로잡을 수 있는 인지 런타임을 둡니다（[A/B 실증](docs/CVM运行时对Agent模型的实证影响.md)）.
+- **인지 가상 머신（CVM）** —— 75개의 런타임 훅이 5대 단계에 걸쳐 있어, 모델 출력과 실제 행동 사이에 관측 가능하고 바로잡을 수 있는 인지 런타임을 둡니다（[A/B 실증](docs/CVM运行时对Agent模型的实证影响.md)）.
 - **멀티에이전트 오케스트레이션** —— 가벼운 `/scout` 읽기 전용 정찰, 병렬 `/team` 시공부터 `/council` 다중 좌석 회진, `/galaxy` 다차원 공략까지. 복잡한 작업은 파(wave) 단위로 실행하며 파마다 검수합니다.
 - **통합 프로젝트 메모리** —— 프로젝트 지식은 `.rivet/knowledge/memory.jsonl`에 기록됩니다. 자동 주입은 거버넌스/제약 계열 메모리에만 한정되며, 과거 문제와 문서는 명시적 recall을 통해서만 들어옵니다——새 작업을 납치하지 않습니다.
 - **프리픽스 캐시 최우선** —— 동결 프리픽스 + 증분 appendix + 경계 압축으로 DeepSeek V4 장대 세션에서 실측 정상 적중률 **95–99%**를 유지하여 token 비용을 크게 낮춥니다.
@@ -116,7 +116,7 @@ CVM은 모델을「더 똑똑하게」만드는 것이 아니라 4계층 방어
 Layer 1: 信念宪法（static prompt）      → "你应该质疑、验证、拒绝"      [A/B 已证]
 Layer 2: Courage Hook（preTurn）        → 高信心时鼓励独立判断          [A/B 已证]
 Layer 3: Sensorium（每 turn <1ms）      → 六维状态感知，驱动策略切换     [Wave 7-8 已证]
-Layer 4: RuntimeHookPipeline（72 hooks） → trap-and-emulate 拦截退化行为 [全管线运行中]
+Layer 4: RuntimeHookPipeline（75 hooks） → trap-and-emulate 拦截退化行为 [全管线运行中]
 ```
 
 ### 독립된 인지: 星域은 롤플레이가 아니다
@@ -135,14 +135,15 @@ Layer 4: RuntimeHookPipeline（72 hooks） → trap-and-emulate 拦截退化行
 
 | 지표 | 수치 |
 |------|------|
-| CLI 소스코드（TypeScript, 테스트 제외） | 1,078 파일 / 257,623 줄 |
-| 테스트 코드 | 1,361 파일 / 256,001 줄 |
-| 테스트 케이스（node:test, 정적 선언 기준） | **16,471**, 테스트 : 소스 ≈ **0.99 : 1** |
-| 누적 커밋 | **6,178**（main 브랜치; 2026-05-15 리포지토리 생성, 105일） |
+| `src/` 소스（TypeScript, 테스트 제외） | 약 1,256 파일 / 30만 줄（가장 큰 `agent/`는 483 파일） |
+| `src/` 테스트 | 약 1,592 파일 / 31만 줄（node:test, 소스와 약 1:1） |
+| `desktop/src` | 약 450 파일 / 9.6만 줄（React）, 별도로 Rust 약 1.1만 줄 |
+| `vscode-extension/src` | 17 파일 / 약 2,700 줄 |
+| 누적 커밋 | **8,008**（2026-05-15 생성, 약 4.5개월; 최근 30일 1,769） |
 | 타입 체크 | `tsc` strict + `noUncheckedIndexedAccess` |
 | 프리픽스 캐시 적중률 | 장대 세션 정상 상태 실측 95–99% |
 
-코딩 에이전트의 핵심 로직（멀티턴 루프, 도구 파이프라인, 컨텍스트 압축）은 테스트가 어렵기로 유명하고, 오픈소스 에이전트 프로젝트는 일반적으로 테스트 커버리지가 얇습니다——본 프로젝트는 테스트와 소스를 동량으로 유지하고 사고 수정에는 반드시 회귀 테스트를 붙입니다. 테스트:소스 줄 수 비는 오랫동안 0.93–0.99를 유지하며 규모가 커져도 희석되지 않았습니다（위 표는 2026-08-28 실측 스냅샷）. 완전한 통계 기준·반복 마일스톤·재현 명령어는 [엔지니어링 품질 지표](docs/engineering-metrics.md)를 참조하세요.
+코딩 에이전트의 핵심 로직（멀티턴 루프, 도구 파이프라인, 컨텍스트 압축）은 테스트가 어렵기로 유명하고, 오픈소스 에이전트 프로젝트는 일반적으로 테스트 커버리지가 얇습니다——본 프로젝트는 테스트와 소스를 동량으로 유지하고 사고 수정에는 반드시 회귀 테스트를 붙입니다. 테스트:소스 줄 수 비는 1:1 근처를 유지하며 규모가 커져도 희석되지 않았습니다（이전 슬라이스는 0.93–0.99; 위 표는 2026-09-30 어림 스냅샷）. 완전한 통계 기준·반복 마일스톤·재현 명령어는 [엔지니어링 품질 지표](docs/engineering-metrics.md)를 참조하세요.
 
 ## 🚀 빠른 시작
 
@@ -336,7 +337,7 @@ DeepSeek은 캐시 미스에 50× 비용을 부과합니다. 天枢의 프롬프
 
 프리픽스 캐시가 정상 상태 상한에 근접하면 비용 최적화는 DeepSeek API 사고 token 쪽으로 옮겨갑니다——출력 token 단위 과금의 추론 모델에서는 verbose reasoning을 줄이는 것이 ROI가 가장 높은 레버입니다.
 
-- **기본 reasoningEffort 하향** —— DeepSeek V4 Pro는 `max` → `high`, Flash는 `max` → `medium`. 이미 명시적 구성을 둔 사용자는 영향이 없습니다（`reasoningFloor` 보호）.
+- **기본 reasoningEffort** —— DeepSeek V4-Pro-0813와 V4.1-Flash의 기본값은 모두 `high`입니다. 이미 명시적 구성을 둔 사용자는 영향이 없습니다（`reasoningFloor` 보호）.
 - **effort 라우팅（기본 켜짐）** —— 낮은 복잡도 + 높은 확신도의 일상 턴은 reasoning effort를 한 단계 자동 하향하며, 올리는 일은 없습니다. `RIVET_EFFORT_ROUTING=0`으로 끄기.
 - **Compact는 flash 사이드 경유** —— 압축 시 provider가 구성되지 않았는데도 메인 모델로 가던 버그를 수정하고, 메인 provider에서 flash 엔드포인트를 자동 추론합니다.
 - **Doom-loop 자동 수습** —— 반복되는 도구 호출을 감지하면 동적 appendix로 더 엄격한 output-style 제약을 주입해 불필요한 사고 token 소모를 줄입니다. `RIVET_TERSE=0`으로 끄기.
@@ -608,6 +609,7 @@ TUI는 CLI의 기본 표면입니다. 데스크톱 앱（Tauri）과 VS Code/Cur
 - **sidecar 메모리 적응**: 힙 상한을 머신 메모리별로 자동 분급（8G→2G / 16G→4G / 32G→6G / 64G+→8G, `RIVET_SIDECAR_HEAP_MB`로 덮어쓰기 가능）, ≤8GB 머신은 자동으로 lean 리소스 단계
 - **watchdog 자동 복구**: 경계 정체 시 자동으로 이어 실행, 데스크톱 타임라인에서 복구 이벤트를 볼 수 있습니다（⟳ 자동 복구 / ⏹ 할당량 소진）
 - **다중 세션 동시**: 탭 바에서 여러 세션 관리, 각각 독립 cwd + 모델 + 승인 모드
+- **WSL 연결 런타임** (Windows): 원클릭으로 WSL 내부에서 실행되는 런타임에 연결합니다. 세션, 파일 읽기/쓰기, 명령 실행이 모두 Linux 측에서 이루어집니다. 연결을 끊으면 WSL 측 프로세스가 자동으로 정리됩니다. 양측은 독립적으로 업그레이드할 수 있습니다 — 자세한 내용은 [데스크톱 사용자 가이드](docs/desktop-guide.md)를 참조하세요.
 - **기능 패널**（왼쪽 바 `⌘1…9` 전환）: Mission Control（다중 세션 콘솔）, Inbox（받은 편지함）, Automations（정기 작업）, Skills / Hooks 관리, Git / GitHub, Changes（변경 검토）, Delegation（파견 함대와 팀 wave DAG）, Cockpit 운전석
 - **Popout 독립 창**: 단일 세션 스레드를 독립 창으로 팝아웃, 멀티 스크린 병행
 - **JobsDock / TodoDock 상주 서랍**: 백그라운드 작업 도킹 바（로그 펼치기 / Kill / 터미널에서 열기）, 탭 간 상주 todo
@@ -716,15 +718,16 @@ OpenAI 형식의 텍스트→이미지 엔드포인트（SiliconFlow, OpenAI Ima
 
 ### 다중 제공자 + 적응형 라우팅
 
-| 제공자 | 인증 방식 | 플래그십 모델 |
+| 제공자 | 인증 방식 | 연결 모델 예시 |
 |--------|----------|----------|
-| DeepSeek | API key | deepseek-v4-pro (1M ctx), deepseek-v4-flash, deepseek-v4-flash-vision-exp（비전） |
+| DeepSeek | API key | deepseek-flash（1M ctx, DeepSeek-V4.1-Flash, 비전）, deepseek-v4-pro（1M ctx, DeepSeek-V4-Pro-0813） |
 | DeepSeek Spark（Pro 전용） | API key（`DEEPSEEK_SPARK_API_KEY`） | deepseek-v4-flash（경량 추론 + 앵커 캐시 채널） |
 | Claude | API key（`cc-switch` 프록시 경유） | claude-opus-4-8, claude-sonnet-4-5 |
 | GLM（지푸） | API key | glm-5.3 (1M ctx), glm-5.3-flash（비전）, glm-5.2 |
 | Codex (GPT-5.6) | OAuth PKCE（ChatGPT 구독） | gpt-5.6-sol |
-| MiniMax | API key | MiniMax-M3, MiniMax-M2.7 |
-| MiMo | API key | mimo-v2.5-pro |
+| MiniMax | API key | MiniMax-M3（비전）, MiniMax-M2.7 |
+| MiMo | API key | mimo-v2.5-pro（기존 V2.5 프리셋; V2.6 Flash / Pro는 모델 목록에서 추가 가능） |
+| Kimi Code | API key | k3（1M ctx, 비전）, k3-256k, kimi-for-coding |
 
 세션 안에서 `/model <name>`으로 언제든 제공자를 전환할 수 있습니다.
 
@@ -921,7 +924,7 @@ Node.js 24 · TypeScript strict（`noUncheckedIndexedAccess`）· T9 ANSI 렌더
 
 ```bash
 npm run typecheck                                    # 类型检查
-npm test                                             # 所有测试（16,000+ 用例）
+npm test                                             # 所有测试（19,000+ 用例）
 npm run build                                        # tsup 打包 + 原生/wasm 载荷落位
 node dist/cli/entry.js                               # 启动 TUI
 node dist/cli/entry.js -p "fix the typo"             # 无界面模式
@@ -1167,9 +1170,9 @@ tianshu logs open desktop            # 打开 sidecar 日志目录（GUI 起不
 - **보안 취약점** → [비공개 보고](https://github.com/huiliyi37/Tianshu-harness/security/advisories/new)（공개 issue를 열지 말 것）
 - **코드 기여** → [CONTRIBUTING.md](CONTRIBUTING.md) 참조
 - **도움 요청 가이드** → [SUPPORT.md](SUPPORT.md) 참조
-- **위챗 교류 그룹** → 「天枢 harness 교류 그룹」, QR 코드를 스캔해 입장, 일상 토론 / 피드백 / 최신 릴리스 소식을 가장 먼저 받아볼 수 있습니다:
+- **위챗 교류 그룹** → 「天枢 harness 交流群5群」, QR 코드를 스캔해 입장, 일상 토론 / 피드백 / 최신 릴리스 소식을 가장 먼저 받아볼 수 있습니다:
 
-<img src="docs/brand/assets/wechat-group-qr.png" width="280" alt="天枢 harness 交流群微信群二维码">
+<img src="docs/brand/assets/wechat-group-qr.png" width="280" alt="天枢 harness 交流群5群微信群二维码">
 
 > 위챗 그룹 QR 코드에는 유효기간이 있습니다（7일）. 만료되면 [Discussions](https://github.com/huiliyi37/Tianshu-harness/discussions)나 Issue에 남겨 주시면 관리자가 새 코드를 올려 드립니다.
 
@@ -1238,4 +1241,3 @@ tianshu logs open desktop            # 打开 sidecar 日志目录（GUI 起不
 ## 감사의 말
 
 - 데스크톱 앱의 "사용자 지정 배경화면과 영역별 유리" 기능 **디자인**은 <a href="https://github.com/elysia395/dsh-wallpaper-engine">dsh-wallpaper-engine</a>(MIT License)을 참고했습니다. 구현은 천수가 독자적으로 작성한 것이며 상류 코드를 포함하지 않습니다. 참고 범위와 라이선스 전문은 <a href="THIRD-PARTY-NOTICES.md">THIRD-PARTY-NOTICES.md</a>를 참조하세요.
-