tianshu-harness 3.23.0 → 3.24.0

package/README.en.md

@@ -34,7 +34,7 @@
 
 > **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.
 
-- **One kernel, two surfaces** — a pure-ANSI terminal TUI (`rivet`) and a Tauri desktop app (macOS / Windows / Linux) share the same agent core, so capabilities stay consistent across interfaces.
+- **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)).
 - **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.
@@ -49,8 +49,8 @@
 </p>
 
 > [!NOTE]
-> The project was originally codenamed **Rivet**; the installed CLI binary is still
-> named `rivet` for backward compatibility.
+> The project was originally codenamed **Rivet**. The primary CLI command is now `tianshu`,
+> with `rivet` kept as a compatibility alias (same entry point); the data directory stays `~/.rivet`.
 
 ## Table of contents
 
@@ -161,7 +161,7 @@ Agent core logic (multi-turn loops, tool pipelines, context compaction) is notor
 **A. Desktop app (ready to use)** — download from [GitHub Releases](https://github.com/huiliyi37/Tianshu-harness/releases/latest): macOS `.dmg` (Apple Silicon / Intel) · Windows `.exe` setup wizard · Linux `.AppImage`.
 > **Linux support scope (new in 3.11.2)**: x64 AppImage, no install needed — `chmod +x Tianshu_*.AppImage` and run; requires glibc ≥ 2.35 (Ubuntu 22.04+ / Debian 12+ and other mainstream distros); X11 recommended (Wayland untested). Known limitation: voice input is unavailable on Linux for now (no community whisper build — falls back to browser speech); desktop auto-update works on Linux too.
 
-**B. One-line installer (recommended)** — checks Node ≥ 24 → installs `tianshu-harness` globally (npmmirror registry by default; override via `NPM_CONFIG_REGISTRY`) → launches `rivet`; idempotent, safe to re-run:
+**B. One-line installer (recommended)** — checks Node ≥ 24 → installs `tianshu-harness` globally (npmmirror registry by default; override via `NPM_CONFIG_REGISTRY`) → launches `tianshu`; idempotent, safe to re-run:
 
 ```bash
 # macOS / Linux (bash)
@@ -179,9 +179,11 @@ powershell -ExecutionPolicy Bypass -File scripts\install-tui.ps1 -NoLaunch
 
 ```bash
 npm install -g tianshu-harness
-rivet
+tianshu
 ```
 
+> **Migrating from the old `tianshu-tui` package**: the old package owns the `rivet` bin link, so a direct install fails with `EEXIST` — uninstall first: `npm uninstall -g tianshu-tui && npm install -g tianshu-harness` (the one-line installer handles this automatically).
+
 **D. Build from source**:
 
 ```bash
@@ -194,12 +196,12 @@ npm start          # or: node dist/cli/entry.js
 
 ### 3. Configure an API Key
 
-**No manual step needed for installed builds** — the first launch walks you through it: the desktop app opens a connection wizard, and the CLI auto-runs a setup wizard when no key is found. Just paste your DeepSeek key. Change it anytime: Settings → Provider on desktop, `rivet config` on the CLI.
+**No manual step needed for installed builds** — the first launch walks you through it: the desktop app opens a connection wizard, and the CLI auto-runs a setup wizard when no key is found. Just paste your DeepSeek key. Change it anytime: Settings → Provider on desktop, `tianshu config` on the CLI.
 
 **Manual configuration** is only for developers running from source (or pre-seeding a setup):
 
 ```bash
-rivet config set-key deepseek sk-xxx   # key goes to secrets.json (0600); config.json keeps only a keyRef
+tianshu config set-key deepseek sk-xxx   # key goes to secrets.json (0600); config.json keeps only a keyRef
 export DEEPSEEK_API_KEY=sk-xxx         # or: environment variable (current shell only)
 ```
 
@@ -209,7 +211,7 @@ export DEEPSEEK_API_KEY=sk-xxx         # or: environment variable (current shell
 ### 4. Launch
 
 ```bash
-rivet            # or: npm start / node dist/cli/entry.js
+tianshu            # or: npm start / node dist/cli/entry.js
 ```
 
 You should see the TUI with a `〉` prompt. Type your request and press Enter.
@@ -217,10 +219,10 @@ You should see the TUI with a `〉` prompt. Type your request and press Enter.
 ### Headless mode (script integration)
 
 ```bash
-rivet -p "explain src/agent/loop.ts"       # one-shot prompt, text output, no TUI
-rivet -p "list all TODO comments" --json   # JSON output for scripting
-rivet --stream-json -p "refactor this module"   # NDJSON event stream: text_delta/tool_use/tool_result/turn_complete… (best for CI; output is auto-redacted)
-rivet --goal "fix all type errors" --budget 50  # headless goal autonomy, max 50 turns (default 100)
+tianshu -p "explain src/agent/loop.ts"       # one-shot prompt, text output, no TUI
+tianshu -p "list all TODO comments" --json   # JSON output for scripting
+tianshu --stream-json -p "refactor this module"   # NDJSON event stream: text_delta/tool_use/tool_result/turn_complete… (best for CI; output is auto-redacted)
+tianshu --goal "fix all type errors" --budget 50  # headless goal autonomy, max 50 turns (default 100)
 ```
 
 ### Command-line flags
@@ -238,13 +240,13 @@ rivet --goal "fix all type errors" --budget 50  # headless goal autonomy, max 50
 | `--resume <id\|prefix>` `-r <id\|prefix>` | Resume a specific session (short prefix OK) |
 | `--resume` `-r` (bare) | Open the session picker after startup |
 | `--new` | Force a brand-new session |
-| `--list` · `rivet sessions` | Print the session list and exit |
+| `--list` · `tianshu sessions` | Print the session list and exit |
 | `--dangerously-skip-permissions` | One-session Unattended (skip all approvals; write sandbox stays on) |
 | `--screen-reader` | Screen-reader mode (dynamic segments not rendered; periodic redraw halted) |
 | `--skip-welcome` | Skip the welcome screen |
 | `--stream-events <path>` | Mirror this run as NDJSON `SessionEvent`s to a file |
 
-Subcommands: `rivet config` (interactive config), `rivet serve` (sidecar HTTP/SSE server), `rivet sessions` (list sessions), `rivet logs` (log locations), `rivet browser status` / `rivet browser install [--no-mirror]` (chromium health check and one-shot install for `browser_debug`; mirrors by default).
+Subcommands: `tianshu config` (interactive config), `tianshu serve` (sidecar HTTP/SSE server), `tianshu sessions` (list sessions), `tianshu logs` (log locations), `tianshu browser status` / `tianshu browser install [--no-mirror]` (chromium health check and one-shot install for `browser_debug`; mirrors by default).
 
 ### Auto-Update
 
@@ -325,7 +327,7 @@ Tianshu ships 50 built-in tools, assembled in preset tiers (resolution priority:
 | **taiyi** | 16 | Minimal evaluation tier — high-frequency core + delivery loop, without orchestration/browser/network/vision heavyweights; auto-applies when the taiyi star domain is pinned (explicit config always wins) |
 
 ```bash
-RIVET_TOOL_PRESET=full rivet          # use full for this session
+RIVET_TOOL_PRESET=full tianshu          # use full for this session
 ```
 
 ```json
@@ -397,9 +399,9 @@ Long sessions accumulate context; past a point, starting fresh is cheaper than p
 - **State restore** — side panel, todos, and the active plan all come back
 
 ```bash
-rivet --continue                 # resume the most recent session for this cwd
-rivet --resume abc123            # resume a specific session (short prefix OK)
-rivet --resume                   # open the session picker after startup
+tianshu --continue                 # resume the most recent session for this cwd
+tianshu --resume abc123            # resume a specific session (short prefix OK)
+tianshu --resume                   # open the session picker after startup
 ```
 
 ### Council (Multi-Perspective Review)
@@ -457,7 +459,7 @@ Reusable workflow playbooks. `visual-acceptance` (frontend/UI change acceptance:
 
 Create a custom skill by dropping a `.md` file with YAML frontmatter (`name`, `description`, `triggers`) into `.rivet/skills/`.
 
-> `writing-plans` / `executing-plans` are now built-in native flows (planning follows the system prompt's `<plan-mode>` discipline, execution the `<plan-executing>` discipline) — no skill files needed. `agent-harness-testing` / `cognitive-alignment` / `research-spec` left the default distribution and are archived in [`docs/skills/optional/`](docs/skills/optional/) — copy them into `.rivet/skills/` to enable.
+> `writing-plans` / `executing-plans` are now built-in native flows (planning follows the system prompt's `<plan-mode>` discipline, execution the `<plan-executing>` discipline) — no skill files needed. `agent-harness-testing` / `research-spec` left the default distribution and are archived in [`docs/skills/optional/`](docs/skills/optional/) — copy them into `.rivet/skills/` to enable.
 
 ### Cross-Session Memory
 
@@ -487,10 +489,10 @@ Key switches:
 Connect external tool servers — documentation search, databases, APIs — directly into the agent's tool pipeline. MCP servers auto-discover at startup; their tools appear as `mcp__<serverId>__<toolName>`.
 
 ```bash
-rivet config mcp add-stdio <server-id> npx -y <package> [args...]   # local process
-rivet config mcp add-sse <server-id> http://localhost:3001/sse      # remote/network
-rivet config mcp add-preset context7                                # popular preset
-rivet config mcp list                                               # list + status
+tianshu config mcp add-stdio <server-id> npx -y <package> [args...]   # local process
+tianshu config mcp add-sse <server-id> http://localhost:3001/sse      # remote/network
+tianshu config mcp add-preset context7                                # popular preset
+tianshu config mcp list                                               # list + status
 ```
 
 Inside a session: `/mcp` (status) and `/debug mcp` (diagnostics). MCP tools respect the same approval mode as built-in tools.
@@ -581,7 +583,7 @@ The desktop app builds a visual interaction layer on top of the TUI's full capab
 
 Turn your phone/tablet into a second screen for Tianshu — sessions run on the computer while you watch progress and approve actions from your phone:
 
-- **Enable**: Desktop **Settings → Network → Remote Access** (shows the LAN URL, access token, and a scan-to-connect QR code); or from the CLI side, start `rivet serve` with `RIVET_SERVE_HOST=0.0.0.0` (plus `--mobile-dir` pointing at the desktop build output) to serve `/mobile` on the same port.
+- **Enable**: Desktop **Settings → Network → Remote Access** (shows the LAN URL, access token, and a scan-to-connect QR code); or from the CLI side, start `tianshu serve` with `RIVET_SERVE_HOST=0.0.0.0` (plus `--mobile-dir` pointing at the desktop build output) to serve `/mobile` on the same port.
 - **Connect**: open `http://<computer-LAN-IP>:3100/mobile` in your phone browser — scanning the QR auto-fills the token (the URL is then immediately cleaned to avoid leaking it); manual token entry also works.
 - **What you can do**: session list (sessions with pending approvals pinned on top) → read-only live timeline for a session (same folding / auto-reconnect semantics as the desktop) → approval / plan / question cards + abort button. Sending messages is intentionally out of scope.
 - **Security**: trusted LAN or tunnel only (Tailscale/SSH); in LAN mode the bearer token is the sole credential — treat it like a password; never port-forward to the public internet.
@@ -634,9 +636,9 @@ Registration steps and parameters are covered under “Image generation” in [M
 Switch providers inside a session with `/model <name>`.
 
 ```bash
-rivet config                          # interactive setup (TTY)
-rivet config setup codex --default    # Codex uses OAuth (browser login on first run)
-rivet config show
+tianshu config                          # interactive setup (TTY)
+tianshu config setup codex --default    # Codex uses OAuth (browser login on first run)
+tianshu config show
 ```
 
 Or edit `config.json` directly (only overrides needed, defaults are deep-merged). Location: `~/.rivet/config.json` for the CLI (`%LOCALAPPDATA%\.rivet` on Windows); for the desktop app check Settings → Storage (portable builds use `TianshuData\.rivet` next to the exe):
@@ -709,8 +711,8 @@ Quick reference:
 ```
 
 ```bash
-rivet --dangerously-skip-permissions      # one-session Unattended
-rivet config set-approval auto-safe       # persist the default tier
+tianshu --dangerously-skip-permissions      # one-session Unattended
+tianshu config set-approval auto-safe       # persist the default tier
 ```
 
 - Rules come in `[config]` (persisted) and `[session]` (current session) layers; `deny` always wins.
@@ -1024,7 +1026,7 @@ If Tianshu has been useful and you'd like to say thanks, you can. It stays a cof
 
 - **China mainland** — WeChat Pay (scan the QR code below)
 
-<img src="docs/brand/assets/wechat-pay.jpg" width="240" alt="WeChat Pay">
+<img src="docs/brand/assets/wechat-donate.png" width="240" alt="WeChat Pay">
 
 ## ✨ Contributors
 
@@ -1032,9 +1034,9 @@ Thank you to everyone who has contributed to Tianshu (ordered by first contribut
 
 | Contributor | Contributions |
 |-------------|---------------|
-| [@banxia](https://github.com/banxia) | Project creator · Core development |
+| [@huiliyi37](https://github.com/huiliyi37) | Project creator · Core development |
 
-Full list (17 external contributors / 89 PRs) → CONTRIBUTORS.md.
+Full list (20 external contributors / 122 PRs) → CONTRIBUTORS.md.
 
 External PRs land via a "port" flow; authorship is credited with `Co-authored-by`
 trailers (auto-recorded by scripts/credit-contributors.sh) — contributor wall (full list in CONTRIBUTORS.md):

package/README.ja.md

@@ -38,7 +38,7 @@
 
 > **天枢**は TypeScript で書かれたコーディングエージェントのランタイムです。**ターミナル TUI** と**デスクトップ GUI** が同一カーネルを共有し、モデルが質問に答えるだけでなく、認知的ガードレール・マルチエージェントオーケストレーション・DeepSeek V4 のプレフィックスキャッシュ向けに設計された低コストの長大セッションを備え、多段階のコーディング作業を継続的に完遂できるようにします。
 
-- **ターミナル × デスクトップ、一つのカーネル** —— 純 ANSI 自前 TUI（`rivet`）と Tauri デスクトップ（macOS / Windows / Linux）が同一エージェントカーネルを共有。両端で能力は一致し、利用シーンに応じて切り替えられます。
+- **ターミナル × デスクトップ、一つのカーネル** —— 純 ANSI 自前 TUI（`tianshu`）と Tauri デスクトップ（macOS / Windows / Linux）が同一エージェントカーネルを共有。両端で能力は一致し、利用シーンに応じて切り替えられます。
 - **認知仮想マシン（CVM）** —— 5 大フェーズにまたがる 72 のランタイムフックが、モデル出力と実際のアクションの間に観測可能で修正可能な認知レイヤーを挟みます（[A/B 実証](docs/CVM运行时对Agent模型的实证影响.md)）。
 - **マルチエージェントオーケストレーション** —— 軽量な `/scout` 読み取り専用偵察、並行 `/team` 施工から、`/council` の複数席会診、`/galaxy` の多次元攻略まで。複雑なタスクは波（wave）単位で実行し、波ごとに検収します。
 - **統一プロジェクトメモリ** —— プロジェクト知識は `.rivet/knowledge/memory.jsonl` に書き込まれます。自動注入はガバナンス／制約系メモリに限定され、過去の問題やドキュメントは明示的な recall 経由のみ——新しいタスクを乗っ取りません。
@@ -53,7 +53,7 @@
 </p>
 
 > [!NOTE]
-> 本プロジェクトの当初の開発コードネームは **Rivet** でした。後方互換性のため、インストール済み CLI のコマンド名は現在も `rivet` のままです。
+> 本プロジェクトの当初の開発コードネームは **Rivet** でした。CLI の主コマンドは現在 `tianshu` で、`rivet` は互換エイリアスとして残っています（同一エントリ）。データディレクトリは引き続き `~/.rivet` です。
 
 ## 目次
 
@@ -150,7 +150,7 @@ Layer 4: RuntimeHookPipeline（72 hooks）→ trap-and-emulate で退化行動
 > **Windows サポート範囲**：Windows 10（1809+、22H2 推奨）/ Windows 11。画面描画は **WebView2 Runtime（推奨 ≥ 120）** に依存——v3.5 以降のスクロール・描画最適化には新しいランタイムが必要で、古いとセッション領域のスクロールがカクつきます。3.5.3 以降インストーラーは完全なオフラインインストールパッケージを同梱（ネット不要・システムレベル登録）。既存ユーザーが自動更新で古すぎる旨の表示が出た場合：通知バーまたは「設定 → ランタイムとバージョン情報」で「修復ツールを実行」。**ウィンドウが完全に開かない**場合は、スタートメニューの「WebView2 を修復」、または [Releases](https://github.com/huiliyi37/Tianshu-harness/releases/latest) の `windows-repair` ディレクトリから `repair-webview2.cmd` をダブルクリック。[WebView2 オフラインインストールパッケージ](https://go.microsoft.com/fwlink/p/?LinkId=2124703) を手動インストールして再起動しても構いません。
 > **Win10 タブレットモードの既知動作**：タブレットモードでアプリを切り替えると前のアプリが画面外へスライドします——computer_use のスナップショットは遮へい／バックグラウンド自己修復（PrintWindow 描画）済みで、タブレットモードを切る必要はありません。
 
-**方法 B：ワンラインインストールスクリプト（推奨）** —— Node ≥ 24 を検証 → `tianshu-harness` をグローバルインストール（デフォルトは npmmirror ミラー加速、`NPM_CONFIG_REGISTRY` で上書き可）→ `rivet` を起動。冪等で再実行可能：
+**方法 B：ワンラインインストールスクリプト（推奨）** —— Node ≥ 24 を検証 → `tianshu-harness` をグローバルインストール（デフォルトは npmmirror ミラー加速、`NPM_CONFIG_REGISTRY` で上書き可）→ `tianshu` を起動。冪等で再実行可能：
 
 ```bash
 # macOS / Linux（bash）
@@ -168,10 +168,10 @@ powershell -ExecutionPolicy Bypass -File scripts\install-tui.ps1 -NoLaunch
 
 ```bash
 npm install -g tianshu-harness
-rivet
+tianshu
 ```
 
-> **Windows のヒント**：インストール後に `rivet が認識されない` と出た場合——まず**新しいターミナルを開く**（Node インストール時に開いていたウィンドウは古い PATH のまま）。それでも駄目なら、`npm prefix -g` が出力するディレクトリをユーザー PATH に追加して新しいターミナルを開く。公式インストーラーの Node はデフォルトでこの問題がありません。nvm/fnm/scoop インストールの場合は一度手動追加が必要です。
+> **Windows のヒント**：インストール後に `tianshu が認識されない` と出た場合——まず**新しいターミナルを開く**（Node インストール時に開いていたウィンドウは古い PATH のまま）。それでも駄目なら、`npm prefix -g` が出力するディレクトリをユーザー PATH に追加して新しいターミナルを開く。公式インストーラーの Node はデフォルトでこの問題がありません。nvm/fnm/scoop インストールの場合は一度手動追加が必要です。
 
 **方法 D：ソースからビルド**：
 
@@ -195,7 +195,7 @@ cp completions/rivet.bash ~/.local/share/bash-completion/completions/rivet
 sudo cp completions/rivet.bash /usr/share/bash-completion/completions/rivet
 ```
 
-**zsh** —— `rivet.zsh` を `_rivet` という名前で `$fpath` に配置：
+**zsh** —— `tianshu.zsh` を `_rivet` という名前で `$fpath` に配置：
 
 ```bash
 mkdir -p ~/.zsh/completions
@@ -213,19 +213,19 @@ cp completions/rivet.fish ~/.config/fish/completions/rivet.fish
 **Windows PowerShell** —— `$PROFILE` で dot-source：
 
 ```powershell
-Add-Content $PROFILE ". C:\path\to\rivet.ps1"
+Add-Content $PROFILE ". C:\path\to\tianshu.ps1"
 ```
 
 > 補完内容は CLI と一致：トップレベルコマンド（`config` / `serve` / `sessions` / `browser` / `logs`）、グローバルフラグ、`config` の全サブコマンド、および `~/.rivet/config.json` から動的に読み込む provider 名。
 
 ### 4. API Key を設定（初回は必須）
 
-**直接インストールしたユーザーは手動設定不要**——初回 `rivet` 実行時にまずメイン画面に入り、自動で `/connect` が開きます。そこでプロバイダーを選んで認証を完了。以降いつでも `/connect` で Provider の追加・調整が可能。デスクトップ版では Settings → Provider でも管理できます。
+**直接インストールしたユーザーは手動設定不要**——初回 `tianshu` 実行時にまずメイン画面に入り、自動で `/connect` が開きます。そこでプロバイダーを選んで認証を完了。以降いつでも `/connect` で Provider の追加・調整が可能。デスクトップ版では Settings → Provider でも管理できます。
 
 **開発者がソースを起動する場合**（または起動前に設定しておきたい場合）だけ手動で行います：
 
 ```bash
-rivet config set-key deepseek sk-xxx   # キーは secrets.json（0600）に書かれ、config.json には keyRef のみ残る
+tianshu config set-key deepseek sk-xxx   # キーは secrets.json（0600）に書かれ、config.json には keyRef のみ残る
 export DEEPSEEK_API_KEY=sk-xxx         # または：環境変数（現在のシェルでのみ有効）
 ```
 
@@ -234,7 +234,7 @@ export DEEPSEEK_API_KEY=sk-xxx         # または：環境変数（現在のシ
 ### 5. 起動
 
 ```bash
-rivet            # または：npm start / node dist/cli/entry.js
+tianshu            # または：npm start / node dist/cli/entry.js
 ```
 
 `〉` プロンプト付きの TUI が表示されます。要件を入力して Enter を押せば実行されます。
@@ -242,10 +242,10 @@ rivet            # または：npm start / node dist/cli/entry.js
 ### ヘッドレスモード（スクリプト連携）
 
 ```bash
-rivet -p "src/agent/loop.ts を解説して"       # 単発プロンプト、テキスト出力、TUI なし
-rivet -p "すべての TODO コメントを列挙して" --json    # JSON 出力、スクリプト処理に便利
-rivet --stream-json -p "このモジュールをリファクタリングして"  # NDJSON イベントストリーム：text_delta/tool_use/tool_result/turn_complete…（CI 連携に最適、出力に組込みのマスキングあり）
-rivet --goal "すべての型エラーを修正して" --budget 50   # ヘッドレス目標自律モード、最大 50 ターン（デフォルト 100）
+tianshu -p "src/agent/loop.ts を解説して"       # 単発プロンプト、テキスト出力、TUI なし
+tianshu -p "すべての TODO コメントを列挙して" --json    # JSON 出力、スクリプト処理に便利
+tianshu --stream-json -p "このモジュールをリファクタリングして"  # NDJSON イベントストリーム：text_delta/tool_use/tool_result/turn_complete…（CI 連携に最適、出力に組込みのマスキングあり）
+tianshu --goal "すべての型エラーを修正して" --budget 50   # ヘッドレス目標自律モード、最大 50 ターン（デフォルト 100）
 ```
 
 ### コマンドライン引数
@@ -263,13 +263,13 @@ rivet --goal "すべての型エラーを修正して" --budget 50   # ヘッド
 | `--resume <id\|プレフィックス>` `-r <id\|プレフィックス>` | 指定セッションを復元（短いプレフィックスで可） |
 | `--resume` `-r`（裸） | 起動後にセッションセレクタを開く |
 | `--new` | 強制的に新規セッションを開始 |
-| `--list` · `rivet sessions` | セッション一覧を出力して終了 |
+| `--list` · `tianshu sessions` | セッション一覧を出力して終了 |
 | `--dangerously-skip-permissions` | このセッションだけ全自動（すべての承認をスキップ。サンドボックスは稼働） |
 | `--screen-reader` | スクリーンリーダーモード（動的セグメントを描画せず、定期再描画を停止） |
 | `--skip-welcome` | ウェルカム画面をスキップ |
 | `--stream-events <path>` | この run を NDJSON `SessionEvent` としてファイルにミラーリング |
 
-サブコマンド：`rivet config`（設定コマンドのヘルプを表示。対話型 Provider 設定には TUI `/connect` を使用）、`rivet serve`（sidecar HTTP/SSE を起動）、`rivet sessions`（セッションを列挙）、`rivet logs`（ログの保存先）、`rivet browser status` / `rivet browser install [--no-mirror]`（`browser_debug` に必要な chromium のヘルスチェックとワンクリックインストール、デフォルトで国内ミラーを使用）。
+サブコマンド：`tianshu config`（設定コマンドのヘルプを表示。対話型 Provider 設定には TUI `/connect` を使用）、`tianshu serve`（sidecar HTTP/SSE を起動）、`tianshu sessions`（セッションを列挙）、`tianshu logs`（ログの保存先）、`tianshu browser status` / `tianshu browser install [--no-mirror]`（`browser_debug` に必要な chromium のヘルスチェックとワンクリックインストール、デフォルトで国内ミラーを使用）。
 
 ### 自動更新
 
@@ -299,7 +299,7 @@ DeepSeek はキャッシュミスに 50× の料金を課します。天枢の
 - **バイト単位の差異** —— メッセージ内容にタイムスタンプ、ランダム ID などの不安定なバイトが含まれる
 - **境界をまたぐ書き換え** —— `/compact`（`turn===0` のときのみ履歴書き換え）、`/cd` でのプロジェクト切替（新しい user 境界で末尾断絶）
 
-調査：① `rivet logs`（または TUI 内 `/logs`）でこのセッションのデータルートと `cache-log.jsonl` / `sensorium.jsonl` のパスを直接表示；② セッション `.jsonl` を開いて `cache_read_input_tokens` を検索し各ターンのヒットを確認；③ 全量テレメトリが必要なら `RIVET_DEBUG_TELEMETRY=1`（または任意の非空値）を設定して `sensorium.jsonl` を確認；④ `npm exec -- tsx scripts/verify-cache-hit-rate.ts` で複数ターン会話をシミュレート検証。パス一覧は下記「ログと調査」を参照。
+調査：① `tianshu logs`（または TUI 内 `/logs`）でこのセッションのデータルートと `cache-log.jsonl` / `sensorium.jsonl` のパスを直接表示；② セッション `.jsonl` を開いて `cache_read_input_tokens` を検索し各ターンのヒットを確認；③ 全量テレメトリが必要なら `RIVET_DEBUG_TELEMETRY=1`（または任意の非空値）を設定して `sensorium.jsonl` を確認；④ `npm exec -- tsx scripts/verify-cache-hit-rate.ts` で複数ターン会話をシミュレート検証。パス一覧は下記「ログと調査」を参照。
 
 ### 禅モード（Zen Mode）：読みに集中する開始、手を動かせば解除
 
@@ -357,7 +357,7 @@ DeepSeek はキャッシュミスに 50× の料金を課します。天枢の
 | **taiyi** | 16 | 最小評価セット——高頻度コア＋納品クローズドループ。オーケストレーション/ブラウザ/ネットワーク/ビジュアル等の重いツールを除去。太一星域が固定されると自動でこのセットに（後述「最小ツールセット」） |
 
 ```bash
-RIVET_TOOL_PRESET=full rivet          # このセッションだけ full
+RIVET_TOOL_PRESET=full tianshu          # このセッションだけ full
 ```
 
 ```json
@@ -480,9 +480,9 @@ Plan Mode には星域委譲が内蔵——複雑な計画は自動で `delegate
 - **状態の復元** —— サイドバー、todo、アクティブな計画も一緒に復元
 
 ```bash
-rivet --continue                 # 現在の cwd の直近セッションを復元
-rivet --resume abc123            # 指定セッションを復元（短いプレフィックスで可）
-rivet --resume                   # 起動後にセッションセレクタを開く
+tianshu --continue                 # 現在の cwd の直近セッションを復元
+tianshu --resume abc123            # 指定セッションを復元（短いプレフィックスで可）
+tianshu --resume                   # 起動後にセッションセレクタを開く
 ```
 
 ### 委員会（多視点レビュー）
@@ -505,7 +505,7 @@ rivet --resume                   # 起動後にセッションセレクタを開
 
 `.rivet/skills/` に YAML frontmatter（`name`、`description`、`triggers`）付きの `.md` を置けばカスタム skill にもできます。
 
-> `writing-plans` / `executing-plans` はネイティブフローとして内蔵済み（計画期はシステムプロンプトの `<plan-mode>` 規律、実行期は `<plan-executing>` 規律で実行）。skill ファイルは不要になりました。`agent-harness-testing` / `cognitive-alignment` / `research-spec` はデフォルト配布から外れ、[`docs/skills/optional/`](docs/skills/optional/) にアーカイブ——必要なとき手動で `.rivet/skills/` にコピーすれば有効化できます。
+> `writing-plans` / `executing-plans` はネイティブフローとして内蔵済み（計画期はシステムプロンプトの `<plan-mode>` 規律、実行期は `<plan-executing>` 規律で実行）。skill ファイルは不要になりました。`agent-harness-testing` / `research-spec` はデフォルト配布から外れ、[`docs/skills/optional/`](docs/skills/optional/) にアーカイブ——必要なとき手動で `.rivet/skills/` にコピーすれば有効化できます。
 
 ### セッション間メモリ
 
@@ -535,10 +535,10 @@ rivet --resume                   # 起動後にセッションセレクタを開
 外部ツールサーバー——ドキュメント検索、データベース、API——を agent のツールパイプラインに直接接続。起動時に自動発見され、ツールは `mcp__<serverId>__<toolName>` の形で出現します。
 
 ```bash
-rivet config mcp add-stdio <server-id> npx -y <package> [args...]   # ローカルプロセス
-rivet config mcp add-sse <server-id> http://localhost:3001/sse      # リモート/ネットワーク
-rivet config mcp add-preset context7                               # よく使うプリセット
-rivet config mcp list                                              # 一覧＋ステータス
+tianshu config mcp add-stdio <server-id> npx -y <package> [args...]   # ローカルプロセス
+tianshu config mcp add-sse <server-id> http://localhost:3001/sse      # リモート/ネットワーク
+tianshu config mcp add-preset context7                               # よく使うプリセット
+tianshu config mcp list                                              # 一覧＋ステータス
 ```
 
 セッション内：`/mcp`（ステータス）、`/debug mcp`（診断）。MCP ツールは内蔵ツールと同じ承認モードに従います。
@@ -629,7 +629,7 @@ TUI は CLI のデフォルトサーフェスです。デスクトップ版（Ta
 
 スマホ/タブレットを天枢の「第二の画面」に——セッションは PC 上で実行し、スマホで進捗確認・承認操作ができます：
 
-- **有効化**：デスクトップ **設定 → Network → Remote Access**（LAN URL・アクセストークン・スキャン接続 QR を表示）；または CLI 側で `RIVET_SERVE_HOST=0.0.0.0`（＋デスクトップのビルド成果物を指す `--mobile-dir`）を指定して `rivet serve` を起動すると、同一ポートで `/mobile` が提供されます
+- **有効化**：デスクトップ **設定 → Network → Remote Access**（LAN URL・アクセストークン・スキャン接続 QR を表示）；または CLI 側で `RIVET_SERVE_HOST=0.0.0.0`（＋デスクトップのビルド成果物を指す `--mobile-dir`）を指定して `tianshu serve` を起動すると、同一ポートで `/mobile` が提供されます
 - **接続**：同一 LAN 内のスマホブラウザで `http://<PCのLAN IP>:3100/mobile` を開く——QR スキャンでトークンが自動入力されます（直後に URL から除去され漏えい防止）；手動入力にも対応
 - **できること**：セッション一覧（承認待ちが上位にハイライト）→ 単一セッションの読み取り専用ライブタイムライン（デスクトップと同じ折りたたみ/自動再接続セマンティクス）→ 承認・プラン・質問カード＋中止ボタン。メッセージ送信は意図的に範囲外です
 - **セキュリティ境界**：信頼できる LAN またはトンネル（Tailscale/SSH）のみ。LAN モードではアクセストークンが唯一の資格情報——パスワードと同様に扱い、公開インターネットへのポート公開はしないでください
@@ -689,7 +689,7 @@ TUI は CLI のデフォルトサーフェスです。デスクトップ版（Ta
 
 解決チェーン：`RIVET_LEAN` 環境変数（常に優先）→ ドメイン上書き → グローバル runtime。デスクトップ版：設定 → 動作 → Lean リソースセット → ドメイン単位の上書き（ドメインリストは新規星域の追加に合わせて自動拡張）。注意：ドメイン上書きはセッション組立期に有効（起動時にドメインを固定）。実行中の `/domain` 切替はフリーズ済みツールセットと lean に影響しません（ツールフィンガープリント変更でプレフィックスキャッシュが再構築されるため）。
 
-**ファイル編集不要のワンクリック起動**：`/config` → Basics → 「最小セットと星域バインド」——あるドメイン（changgeng や taiyi など）を選択して保存すると、自動で `defaultDomain` にそのドメインを固定＋そのドメインの taiyi 最小ツールセット上書き（lean リソース削減は含まない）。以降 `rivet` の素起動でその星域の最小セットセッションに入れます。「デフォルトモデル」フィールド（`agent.defaultModel`、`provider:modelId` 形式）と組み合わせれば完全にパラメータなしで起動可能。バインドをクリアすればデフォルトドメインに復帰（ドメイン上書き設定は保持）。デスクトップ版も同じ項目：設定 → システム → 「最小セットと星域バインド」。
+**ファイル編集不要のワンクリック起動**：`/config` → Basics → 「最小セットと星域バインド」——あるドメイン（changgeng や taiyi など）を選択して保存すると、自動で `defaultDomain` にそのドメインを固定＋そのドメインの taiyi 最小ツールセット上書き（lean リソース削減は含まない）。以降 `tianshu` の素起動でその星域の最小セットセッションに入れます。「デフォルトモデル」フィールド（`agent.defaultModel`、`provider:modelId` 形式）と組み合わせれば完全にパラメータなしで起動可能。バインドをクリアすればデフォルトドメインに復帰（ドメイン上書き設定は保持）。デスクトップ版も同じ項目：設定 → システム → 「最小セットと星域バインド」。
 
 
 ### 🎨 画像生成（テキストから画像）
@@ -720,10 +720,10 @@ OpenAI 形式のテキスト→画像エンドポイント（SiliconFlow / OpenA
 セッション内では `/model <name>` でいつでもプロバイダーを切替。
 
 ```bash
-rivet                                 # TUI を起動。初回 key 欠如時は自動で /connect を開く
-rivet config                          # 設定コマンドのヘルプを表示
-rivet config setup codex --default    # Codex は OAuth（初回ブラウザログイン）
-rivet config show                     # 完全な設定を表示
+tianshu                                 # TUI を起動。初回 key 欠如時は自動で /connect を開く
+tianshu config                          # 設定コマンドのヘルプを表示
+tianshu config setup codex --default    # Codex は OAuth（初回ブラウザログイン）
+tianshu config show                     # 完全な設定を表示
 ```
 
 config.json を直接編集することも可能（上書きしたいフィールドだけを書き、デフォルト値は深くマージされます）。ファイル位置：CLI は `~/.rivet/config.json`（Windows は `%LOCALAPPDATA%\.rivet`）。デスクトップ版は Settings → ストレージ位置に従い、ポータブル版は exe 横の `TianshuData\.rivet`——詳細は[データルートを先に特定](#データルートを先に特定する)：
@@ -795,8 +795,8 @@ config.json を直接編集することも可能（上書きしたいフィー
 ```
 
 ```bash
-rivet --dangerously-skip-permissions      # このセッションだけ全自動
-rivet config set-approval auto-safe       # デフォルト段階を永続化
+tianshu --dangerously-skip-permissions      # このセッションだけ全自動
+tianshu config set-approval auto-safe       # デフォルト段階を永続化
 ```
 
 - ルールは `[config]`（永続）と `[session]`（このセッション）の 2 層で、`deny` が常に優先。
@@ -960,11 +960,11 @@ src/
 
 ```bash
 # ターミナル（TUI が起動できなくても使える——agent を初期化せず、設定を読まず、ネットもしない）
-rivet logs                         # このプロジェクトの直近メインセッションの全ログ保存先＋生成有無＋ゲート説明を一覧
-rivet logs --session <id>          # 指定セッション
-rivet logs --json                  # 構造化出力、issue に貼れる
-rivet logs open                    # ファイルマネージャでセッションディレクトリを開く
-rivet logs open desktop            # sidecar ログディレクトリを開く（GUI が起動できないときの第一現場）
+tianshu logs                         # このプロジェクトの直近メインセッションの全ログ保存先＋生成有無＋ゲート説明を一覧
+tianshu logs --session <id>          # 指定セッション
+tianshu logs --json                  # 構造化出力、issue に貼れる
+tianshu logs open                    # ファイルマネージャでセッションディレクトリを開く
+tianshu logs open desktop            # sidecar ログディレクトリを開く（GUI が起動できないときの第一現場）
 ```
 
 - **TUI**：`/logs`（同上の一覧）。`/logs open` / `/logs open desktop` でディレクトリを直接開く
@@ -984,18 +984,18 @@ rivet logs open desktop            # sidecar ログディレクトリを開く
 | `desktop/sidecar-exit.json` | sidecar 終了理由のパンくず | 終了時 |
 | `desktop/sessions/<id>/events.jsonl` | デスクトップ UI イベントストリーム（上記のセッション `.jsonl` とは別データ） | デスクトップの非 ephemeral セッション |
 
-プロジェクト内には他に `<cwd>/.rivet/knowledge/`、`artifacts/`、`plans/` などの共有データがあります。`sessionId` がないとき、六次元は `<cwd>/.rivet/sensorium.jsonl` にフォールバック書き込みされることもあります——`rivet logs` が実際のパスを表示します。
+プロジェクト内には他に `<cwd>/.rivet/knowledge/`、`artifacts/`、`plans/` などの共有データがあります。`sessionId` がないとき、六次元は `<cwd>/.rivet/sensorium.jsonl` にフォールバック書き込みされることもあります——`tianshu logs` が実際のパスを表示します。
 
 #### シナリオ別早見
 
 | 現象 | まず見るもの |
 |------|------|
-| デスクトップウィンドウは開いたがアシスタントが返事しない | `rivet logs open desktop`、または Settings →「ログディレクトリを開く」。次に `desktop/sidecar-exit.json` |
-| キャッシュヒット率が異常 / コストが突然上がる | `rivet logs` → そのセッションの `cache-log.jsonl` と `.jsonl` 内の `cache_read_*` を開く |
+| デスクトップウィンドウは開いたがアシスタントが返事しない | `tianshu logs open desktop`、または Settings →「ログディレクトリを開く」。次に `desktop/sidecar-exit.json` |
+| キャッシュヒット率が異常 / コストが突然上がる | `tianshu logs` → そのセッションの `cache-log.jsonl` と `.jsonl` 内の `cache_read_*` を開く |
 | 六次元 / advisory が効いたか振り返りたい | `RIVET_DEBUG_TELEMETRY` を確認し、`sensorium.jsonl` を読む |
-| バグ報告 / 貢献の調査 | `rivet logs --json` をまるごと issue に貼る（会話本文は含まず、パスとサイズのみ） |
+| バグ報告 / 貢献の調査 | `tianshu logs --json` をまるごと issue に貼る（会話本文は含まず、パスとサイズのみ） |
 
-`RIVET_SESSION_DIR` / `RIVET_DESKTOP_DIR` でセッションツリーとデスクトップツリーをそれぞれ移動可能。有効な上書きは `rivet logs` 出力の先頭に表示されます。
+`RIVET_SESSION_DIR` / `RIVET_DESKTOP_DIR` でセッションツリーとデスクトップツリーをそれぞれ移動可能。有効な上書きは `tianshu logs` 出力の先頭に表示されます。
 
 ## 🔒 セキュリティ
 
@@ -1173,9 +1173,9 @@ rivet logs open desktop            # sidecar ログディレクトリを開く
 
 | コントリビューター | 貢献内容 |
 |--------|----------|
-| [@banxia](https://github.com/banxia) | プロジェクト創設者 · コア開発 |
+| [@huiliyi37](https://github.com/huiliyi37) | プロジェクト創設者 · コア開発 |
 
-完全なリスト（外部コントリビューター 17 名 / 89 PR）→ CONTRIBUTORS.md。
+完全なリスト（外部コントリビューター 20 名 / 122 PR）→ CONTRIBUTORS.md。
 
 外部 PR は「取り込み（收编）」フローでマージされ、著者署名は `Co-authored-by` で
 コントリビューターグラフに計上されます（scripts/credit-contributors.sh が自動記録）——
@@ -1207,7 +1207,7 @@ rivet logs open desktop            # sidecar ログディレクトリを開く
 
 天枢が役に立ったなら、気軽に投げ銭をどうぞ——これは一杯のコーヒーであり、契約ではありません。スポンサーは issue の優先度を変えず、機能スケジュールにも影響しません。
 
-<img src="docs/brand/assets/wechat-pay.jpg" width="240" alt="WeChat Pay">
+<img src="docs/brand/assets/wechat-donate.png" width="240" alt="WeChat Pay">
 
 ## ライセンス