tianshu-harness 3.24.0 → 3.25.0

package/README.en.md

@@ -216,6 +216,37 @@ tianshu            # or: npm start / node dist/cli/entry.js
 
 You should see the TUI with a `〉` prompt. Type your request and press Enter.
 
+### Your first task
+
+Start with a **read-only** pass so it can learn your project (nothing gets modified):
+
+```
+Read this project and tell me its structure, where the entry points are, and one thing most worth improving
+```
+
+Once you trust its reading, give it a **multi-step task**:
+
+```
+Fix the first failing test in this project and explain the root cause
+```
+
+From there it greps, reads files, edits code and runs tests on its own — every step shows up as a tool call, nothing is just claimed. The default approval tier is **Auto**: low-risk actions run directly, high-risk ones stop and ask (see [Approval & Permissions](#approval--permissions)).
+
+### What to look at afterwards
+
+**① Delivery report** — when the run wraps up, Tianshu calls `deliver_task` and prints a delivery report: gate state (GREEN / YELLOW / RED), which files changed, which verifications ran, and a per-item completion audit. "Done" requires evidence; a finish without evidence gets blocked by the gate.
+
+**② Cockpit** — type `/cockpit` to open it (also reachable from the `Ctrl+P` command palette):
+
+| Panel | What it shows |
+|-------|---------------|
+| `/cockpit verify` | Delivery verification: verified / unverified / failed / blocked, which commands ran, blast radius |
+| `/cockpit advisory` | Runtime advisory ledger: rendered / adopted / ignored, plus per-key adoption rate and lift |
+| `/cockpit model` | Cache hit rate, input/output tokens, per-turn cost |
+| `/cockpit safety` | Risk level and doom-loop detection |
+
+No argument gives the summary view; `/cockpit off` closes it.
+
 ### Headless mode (script integration)
 
 ```bash

package/README.md

@@ -162,13 +162,44 @@ npm install -g tianshu-harness
 
 > **从旧包 `tianshu-tui` 迁移**：旧包占着 `rivet` 命令链接，直接装新包会报 `EEXIST`——先卸再装：`npm uninstall -g tianshu-tui && npm install -g tianshu-harness`（一键安装脚本已内置该迁移，自动处理）。
 
-然后：
+**首次运行**会先进入主界面，再自动打开 `/connect` 向导——在那里选择服务商并粘贴 API Key：
 
 ```bash
-tianshu            # 首次运行自动打开 /connect 向导，选择服务商并完成认证
+tianshu            # 看到 〉 提示符即就绪
 ```
 
-无界面模式（脚本 / CI 集成）：
+### 第一个任务
+
+先让它**只读**地认识你的项目（不改任何东西）：
+
+```
+阅读这个项目，告诉我它的结构、入口在哪、以及一处最值得改进的地方
+```
+
+确认它读得准之后，再给一个**多步任务**：
+
+```
+修复这个项目里第一个失败的测试，并说明根因
+```
+
+接下来它会自己 grep、读文件、改代码、跑测试——每一步都有对应的工具调用，不是"说完就结束"。默认权限档是**自动**：低风险动作直接执行，高风险动作会停下来问你（档位与会话内切换见下方 [权限模式](#权限模式)）。
+
+### 做完之后看两处
+
+**① 交付报告** —— 收尾时天枢会调用 `deliver_task`，输出一块交付报告：交付门状态（GREEN / YELLOW / RED）、本次改动的文件、跑过的验证、逐条完成度审计。「完成」必须有证据；没有证据的收尾会被门禁拦下。
+
+**② Cockpit 驾驶舱** —— 输入 `/cockpit` 打开（`Ctrl+P` 命令面板里也能进）：
+
+| 面板 | 看什么 |
+|------|--------|
+| `/cockpit verify` | 交付验证：已验证 / 未验证 / 失败 / 受阻，跑过哪些命令、影响面多大 |
+| `/cockpit advisory` | 运行时提醒台账：累计渲染 / 采纳 / 忽略，以及每条提醒的采纳率与效果增益（lift） |
+| `/cockpit model` | 缓存命中率、输入输出 tokens、本轮成本 |
+| `/cockpit safety` | 风险等级与空转检测 |
+
+不带参数是总览，`/cockpit off` 关闭。
+
+### 无界面模式（脚本 / CI 集成）
 
 ```bash
 tianshu -p "解释 src/agent/loop.ts"           # 单次提示
@@ -218,6 +249,7 @@ tianshu --goal "修复所有类型错误" --budget 50  # 无头目标自主模
 | [权限与沙箱指南](docs/user-guide-sandbox-permissions.md) | 权限规则、路径授权、沙箱模型、故障排查 |
 | [识图能力手册](docs/user-guide-vision.md) | 视觉通道配置与排查 |
 | [远程访问指南](docs/remote-access.md) | 手机/平板遥控审批的启用与安全边界 |
+| [手机端操作手册](docs/guides/mobile-guide.md) | 手机/平板连接的完整步骤、能力清单、外网（Tailscale）与常见问题 |
 | [排障与 FAQ](docs/guides/troubleshooting.md) | 高频现场速查：卡住、429、缓存异常 |
 
 **理念与架构**

package/dist/{account-login-FJYDGZ7D.js → account-login-QQWVF725.js}

@@ -15,8 +15,8 @@ async function handleAccountLogin(app) {
     saveAccountToken,
     isTerminalPollStatus
   } = await import("./account-OAEKORZE.js");
-  const { openInBrowser } = await import("./login-flow-X6QJ2JZ6.js");
-  const { rivetHome } = await import("./paths-LVV5IMQN.js");
+  const { openInBrowser } = await import("./login-flow-QFHIMH2U.js");
+  const { rivetHome } = await import("./paths-PZCXDIBR.js");
   app.commitStatic("\u6B63\u5728\u5411\u5929\u67A2\u7533\u8BF7\u8BBE\u5907\u6388\u6743\u2026");
   let created;
   try {
@@ -39,7 +39,7 @@ ${created.verifyUrl}
   });
   if (result.status === "approved" && result.accessToken) {
     const token = saveAccountToken(accountStore(rivetHome()), result);
-    const { primeStellarIdentity } = await import("./account-status-GQBCUTXB.js");
+    const { primeStellarIdentity } = await import("./account-status-TV65CJUK.js");
     const identityLine = await primeStellarIdentity(token.accessToken);
     app.commitStatic("\u2705 \u5DF2\u767B\u5F55\u5929\u67A2\u8D26\u53F7\u2014\u2014\u684C\u9762\u7AEF\u4E0E\u7F51\u9875\u7AEF\u73B0\u5728\u770B\u5230\u540C\u4E00\u4EFD\u8BBE\u5907\u4E0E\u8BA2\u9605\u3002");
     if (identityLine) app.commitStatic(`\u661F\u7C4D\uFF1A${identityLine}`);
@@ -52,7 +52,7 @@ ${created.verifyUrl}
 }
 async function handleAccountLogout(app) {
   const { accountStore } = await import("./account-OAEKORZE.js");
-  const { rivetHome } = await import("./paths-LVV5IMQN.js");
+  const { rivetHome } = await import("./paths-PZCXDIBR.js");
   const store = accountStore(rivetHome());
   const had = store.load() !== null;
   store.clear();

package/dist/{account-status-GQBCUTXB.js → account-status-TV65CJUK.js}

@@ -5,7 +5,7 @@ import {
   commitWelcomeStellarIdentityLine,
   formatStellarIdentityLine,
   primeStellarIdentity
-} from "./chunk-YQJ2GF2E.js";
+} from "./chunk-3WHU5BHN.js";
 import "./chunk-AEWHC4WM.js";
 import "./chunk-AE4JGSIT.js";
 import "./chunk-ADIVZ2D5.js";
@@ -13,7 +13,7 @@ import "./chunk-2VYRLULP.js";
 import "./chunk-G4FU2DI5.js";
 import "./chunk-TI5PMDHA.js";
 import "./chunk-P5KJURUR.js";
-import "./chunk-BCQXEZPJ.js";
+import "./chunk-JXVN7D4K.js";
 import "./chunk-5GGOGLSN.js";
 export {
   accountIdentityLines,

package/dist/agent/worker-process/child.js

@@ -2,7 +2,7 @@
 import { createRequire as __rivetCreateRequire } from 'node:module'; const require = __rivetCreateRequire(import.meta.url);
 import {
   buildModelCards
-} from "../../chunk-LLYOUH6U.js";
+} from "../../chunk-MTWAJCLM.js";
 import {
   CHILD_TICK_INTERVAL_MS,
   buildReviewOverrideState,
@@ -10,62 +10,62 @@ import {
   createFrameDecoder,
   createInteractiveToolRegistry,
   encodeFrame
-} from "../../chunk-K2W6L3EV.js";
-import "../../chunk-6QMCBQ52.js";
-import "../../chunk-IBCC4M6B.js";
-import "../../chunk-NR3LAYJ7.js";
+} from "../../chunk-YHDD42XX.js";
+import "../../chunk-DZ6UOJ5D.js";
+import "../../chunk-6H4APDFV.js";
+import "../../chunk-HYAUOHED.js";
+import "../../chunk-57UWL5UP.js";
 import "../../chunk-2XN7PM4N.js";
 import "../../chunk-SAXK6LVF.js";
 import "../../chunk-D2TCGRSX.js";
-import "../../chunk-3CZLTKD3.js";
+import "../../chunk-54BOYE4J.js";
 import {
   DomainKnowledgeStore
 } from "../../chunk-5TQ3JYBU.js";
 import "../../chunk-KX22RD6R.js";
-import "../../chunk-NWJFB7ZI.js";
-import "../../chunk-FW3QKMFX.js";
-import "../../chunk-IESISKUX.js";
+import "../../chunk-22Q62LXJ.js";
+import "../../chunk-DTYYBHDD.js";
+import "../../chunk-QTU5QJ6A.js";
 import {
   DelegationCoordinator,
   runWorkerSession
-} from "../../chunk-TINTPE52.js";
+} from "../../chunk-X5Y3M37O.js";
 import "../../chunk-2X4QWTJ7.js";
 import {
   filterToolRegistry
 } from "../../chunk-VAV6JHGO.js";
-import "../../chunk-RS3SD2AD.js";
+import "../../chunk-NAIVHFWV.js";
 import "../../chunk-ZDIFBJFT.js";
-import "../../chunk-72OR3KCJ.js";
-import "../../chunk-5PJ24C3V.js";
-import "../../chunk-L2RI3QEW.js";
+import "../../chunk-NCAHLGC6.js";
+import "../../chunk-2JIT74WC.js";
+import "../../chunk-WQKHKBJC.js";
 import "../../chunk-AERM3VGP.js";
 import "../../chunk-RK3JHWPT.js";
 import "../../chunk-K2JLA7G6.js";
 import "../../chunk-S4K4L6IM.js";
-import "../../chunk-HO4O3QTA.js";
-import "../../chunk-QEWIDRNY.js";
-import "../../chunk-EZT7EFS7.js";
+import "../../chunk-TLIAWAQL.js";
+import "../../chunk-C25SW723.js";
+import "../../chunk-O55CTZZD.js";
 import "../../chunk-JCFWOULR.js";
-import "../../chunk-2KOY6BE3.js";
+import "../../chunk-KXH62LUI.js";
 import "../../chunk-BBT73QEI.js";
-import "../../chunk-XZ6BMISO.js";
-import "../../chunk-4EUTXGNM.js";
-import "../../chunk-DR5VASYC.js";
+import "../../chunk-VVSBTOIK.js";
+import "../../chunk-7X2D2MBR.js";
+import "../../chunk-WUF5IOFK.js";
 import "../../chunk-2HDP7RMR.js";
-import "../../chunk-BZPTZYOH.js";
-import "../../chunk-DZ6UOJ5D.js";
-import "../../chunk-JHVIITGR.js";
+import "../../chunk-T4MYPXAM.js";
+import "../../chunk-O5QAC6VN.js";
 import "../../chunk-RAXBAWRN.js";
-import "../../chunk-AJPWMSWO.js";
+import "../../chunk-7OUEZBQ7.js";
 import "../../chunk-BUIMGNDD.js";
 import "../../chunk-ZU7JZCVP.js";
-import "../../chunk-JSS75KCG.js";
-import "../../chunk-OMMC3KNF.js";
-import "../../chunk-N4KGRYVB.js";
-import "../../chunk-HBVF6BWO.js";
+import "../../chunk-DUGM7LND.js";
+import "../../chunk-KLNHZCDF.js";
+import "../../chunk-KSEDOUKS.js";
+import "../../chunk-CBUQN32I.js";
 import {
   deriveWorkerSessionId
-} from "../../chunk-VU3LIY7Y.js";
+} from "../../chunk-4U7AHZYW.js";
 import "../../chunk-AE4JGSIT.js";
 import "../../chunk-ZGGCEXDC.js";
 import "../../chunk-ZMZCZNKU.js";
@@ -76,19 +76,20 @@ import "../../chunk-J6ESSM47.js";
 import "../../chunk-3C3R7JXY.js";
 import "../../chunk-TI4GSEL5.js";
 import "../../chunk-OXMIV4WE.js";
-import "../../chunk-YRPOGMJW.js";
+import "../../chunk-4JHCSEXX.js";
 import {
   PromptEngine
-} from "../../chunk-MI5FRZEQ.js";
+} from "../../chunk-2OXB7PGR.js";
 import "../../chunk-RV4KPWEU.js";
 import {
   createProviderClient,
   resolveApiKey,
   resolveCapabilities
-} from "../../chunk-D4XOMBWV.js";
+} from "../../chunk-BGMRJAJ3.js";
+import "../../chunk-ADK6OD5V.js";
 import "../../chunk-O5VZQKCB.js";
-import "../../chunk-PKWVEHA2.js";
-import "../../chunk-7RDOV3DF.js";
+import "../../chunk-4564GSBX.js";
+import "../../chunk-QEVWRN4C.js";
 import {
   profileRegistry
 } from "../../chunk-C4BAI4KE.js";
@@ -97,58 +98,59 @@ import "../../chunk-4UZYEDDP.js";
 import "../../chunk-UXNLELW6.js";
 import "../../chunk-ADIVZ2D5.js";
 import "../../chunk-7FW3I7WC.js";
-import "../../chunk-GD4ZNZ7W.js";
-import "../../chunk-QCEY3WDB.js";
+import "../../chunk-D3ZIJZZ6.js";
 import "../../chunk-7UAZVVUE.js";
-import "../../chunk-UM5YRM4D.js";
-import "../../chunk-ENDZ5AQB.js";
-import "../../chunk-INUPBFOY.js";
+import "../../chunk-RNE77CT2.js";
+import "../../chunk-HKJKOMC6.js";
+import "../../chunk-GD4ZNZ7W.js";
+import "../../chunk-ZT6B7FBV.js";
 import {
   applyDescriptionMode
 } from "../../chunk-JSXWIWWJ.js";
 import "../../chunk-BSECIPAQ.js";
-import "../../chunk-TVJO4SCJ.js";
-import "../../chunk-ZO3I3A7O.js";
+import "../../chunk-FWIKA43V.js";
+import "../../chunk-35OLL4BN.js";
 import "../../chunk-P6GJOVO6.js";
 import "../../chunk-TPI73L57.js";
-import "../../chunk-HV4YGVMS.js";
+import "../../chunk-P46RYAGV.js";
 import "../../chunk-722LQO64.js";
 import {
   createAuthProvider
-} from "../../chunk-GMKAXSYQ.js";
+} from "../../chunk-B5WBNTBA.js";
 import "../../chunk-EPKTIOED.js";
 import "../../chunk-2VYRLULP.js";
-import "../../chunk-SUJERP5I.js";
-import "../../chunk-CI4R6P2B.js";
+import "../../chunk-2R6T7UUG.js";
 import "../../chunk-XU2YXCDL.js";
-import "../../chunk-ETHFACAB.js";
-import "../../chunk-SINZOIBW.js";
-import "../../chunk-VSUFQQQW.js";
+import "../../chunk-JQL6WFIR.js";
+import "../../chunk-DXY2POC4.js";
+import "../../chunk-QC6QI2SW.js";
 import "../../chunk-EXUE5W2F.js";
-import "../../chunk-LH5VCGLB.js";
+import "../../chunk-MJPKLILY.js";
 import "../../chunk-6S5FPUS7.js";
 import "../../chunk-EXXICUIW.js";
 import "../../chunk-QARAGUXX.js";
 import {
   TodoStore
 } from "../../chunk-FL4CIO5T.js";
-import "../../chunk-YJG5HIX5.js";
+import "../../chunk-DKFH4TDX.js";
 import {
   loadConfig,
   subagentPromptBlocks
-} from "../../chunk-LJJXY43L.js";
+} from "../../chunk-DJAVQ47W.js";
 import "../../chunk-G4FU2DI5.js";
 import "../../chunk-TI5PMDHA.js";
-import "../../chunk-4H4TVBEJ.js";
-import "../../chunk-SS5A5ZOD.js";
+import "../../chunk-F7WLWFNS.js";
+import "../../chunk-G3TX7BJQ.js";
 import "../../chunk-P5KJURUR.js";
+import "../../chunk-CI4R6P2B.js";
 import "../../chunk-NYDTN5W4.js";
 import "../../chunk-EGEI2RQA.js";
-import "../../chunk-MPX7Z4KQ.js";
+import "../../chunk-FAYHO63O.js";
+import "../../chunk-GZOQFWMP.js";
 import "../../chunk-ZNC5T65N.js";
-import "../../chunk-6FQV7XDJ.js";
+import "../../chunk-7JOI4AOR.js";
 import "../../chunk-A5MNH4ER.js";
-import "../../chunk-BCQXEZPJ.js";
+import "../../chunk-JXVN7D4K.js";
 import {
   init_esm_shims
 } from "../../chunk-5GGOGLSN.js";

package/dist/{build-backends-I2WKCCU5.js → build-backends-3U4ZJHWF.js}

@@ -3,12 +3,12 @@ import { createRequire as __rivetCreateRequire } from 'node:module'; const requi
 import {
   buildSearchBackends,
   resolveSearchKey
-} from "./chunk-DR5VASYC.js";
+} from "./chunk-WUF5IOFK.js";
 import "./chunk-2HDP7RMR.js";
 import "./chunk-O5VZQKCB.js";
-import "./chunk-SS5A5ZOD.js";
+import "./chunk-G3TX7BJQ.js";
 import "./chunk-P5KJURUR.js";
-import "./chunk-BCQXEZPJ.js";
+import "./chunk-JXVN7D4K.js";
 import "./chunk-5GGOGLSN.js";
 export {
   buildSearchBackends,

package/dist/{chain-FYKBOYRC.js → chain-55SCWUYA.js}

@@ -2,8 +2,9 @@
 import { createRequire as __rivetCreateRequire } from 'node:module'; const require = __rivetCreateRequire(import.meta.url);
 import {
   runBackendChain
-} from "./chunk-4EUTXGNM.js";
-import "./chunk-4H4TVBEJ.js";
+} from "./chunk-7X2D2MBR.js";
+import "./chunk-F7WLWFNS.js";
+import "./chunk-CI4R6P2B.js";
 import "./chunk-5GGOGLSN.js";
 export {
   runBackendChain

package/dist/{checkpoint-MND4DUIX.js → checkpoint-MHV22C3Y.js}

@@ -13,9 +13,9 @@ import {
   recordBashSideEffects,
   removeFromCheckpointIndex,
   rollbackToCheckpoint
-} from "./chunk-HV4YGVMS.js";
+} from "./chunk-P46RYAGV.js";
 import "./chunk-A5MNH4ER.js";
-import "./chunk-BCQXEZPJ.js";
+import "./chunk-JXVN7D4K.js";
 import "./chunk-5GGOGLSN.js";
 export {
   addToCheckpointIndex,