dsh-any-agent 0.4.0 → 0.5.1

package/USAGE-NOTES.en.md

@@ -131,6 +131,7 @@ Practical gotchas and trade-offs you *will* hit when letting Claude / Codex driv
 2. **One conversation per task** — mixing unrelated work pollutes history and costs more.
 3. **Split long work into dispatch + collect**: `wait=false` → do something else → `dsh_get(run_id)`.
 4. **Review output via workspace changes** — `workspace_changed` is true when the `git status` entry set changed across the turn; `diff_stat` lists the current dirty files (it is not a per-turn diff).
-5. **Ask for a plan first** if you want to approve before execution (DSH has plan mode).
-6. **Three cost knobs**: lower `reasoning_effort`, keep `reasoning=hide`, release and start fresh.
-7. **Don't paste large code blocks into the prompt** — tell it which file to read instead; DSH has its own file tools.
+5. **Review the result, don't just relay it** — every result carries a `review` ticket. Check at least one claim with your own tools (read the changed file, inspect `git diff`, run the relevant test), then record `pass` / `partial` / `fail` with `dsh_review`. Default `advisory` does not block the next send; `fail`/`partial` need a reason, and a failed review is not fed back to DSH automatically.
+6. **Ask for a plan first** if you want to approve before execution (DSH has plan mode).
+7. **Three cost knobs**: lower `reasoning_effort`, keep `reasoning=hide`, release and start fresh.
+8. **Don't paste large code blocks into the prompt** — tell it which file to read instead; DSH has its own file tools.

package/USAGE-NOTES.md

@@ -272,6 +272,7 @@
 2. **一个会话一件事**。别往一个会话里塞互不相关的任务，历史会互相污染且越来越贵。
 3. **长任务拆成"派活 + 验收"**：`wait=false` → 干别的 → `dsh_get(run_id)`。
 4. **要审查产出就用工作区变更**：`workspace_changed` 表示本回合前后 `git status` 的条目集合发生了变化；`diff_stat` 列出当前仍处于改动状态的文件（不是本回合的精确 diff）。
-5. **要它先想清楚再动手**：让它先给方案、你确认后再执行（DSH 有计划模式）。
-6. **省钱的三个旋钮**：`reasoning_effort` 调低、`reasoning` 保持 `hide`、及时 `dsh_release` 并开新会话。
-7. **别在提示词里重复贴大段代码**——告诉它去看哪个文件更划算（DSH 自己有文件工具）。
+5. **审核结果，别直接转述**：每个结果都带 `review` 审核单。用自己的工具核验至少一项关键声明（读改动的文件、看 `git diff`、跑相关测试），再用 `dsh_review` 记录 `pass` / `partial` / `fail`。默认 `advisory` 不阻塞下一次派活；`fail`/`partial` 必须给理由，且审核不通过不会自动回灌给 DSH。
+6. **要它先想清楚再动手**：让它先给方案、你确认后再执行（DSH 有计划模式）。
+7. **省钱的三个旋钮**：`reasoning_effort` 调低、`reasoning` 保持 `hide`、及时 `dsh_release` 并开新会话。
+8. **别在提示词里重复贴大段代码**——告诉它去看哪个文件更划算（DSH 自己有文件工具）。

package/bin/dsh-any-agent.mjs

@@ -8,6 +8,8 @@
  *   DSH_MCP_STATE               会话注册表路径（默认 $DSH_HOME/.dsh-any-agent/conversations.json）
  *   DSH_MCP_PERMISSION          新建会话的默认权限档（默认 danger-full-access）
  *   DSH_MCP_APPROVAL            默认审批策略（非只读档默认 auto-allow；ask = 挂起待裁决）
+ *   DSH_MCP_REVIEW              调用方审核策略（默认 advisory；off 关闭自动审核单）
+ *   DSH_MCP_REVIEWS_DIR         审核记录目录（默认 <状态文件同目录>/reviews）
  *   DSH_MCP_IDLE_TTL_MS         空闲多久回收会话进程（默认 0 = 永不回收）
  *   DSH_MCP_PROMPT_TIMEOUT_MS   wait=true 时的等待上限（默认 0 = 不设超时）
  *   DSH_MCP_LOCK_STALE_MS       写锁登记多久没心跳算"持有者失联"（默认 90 秒）
@@ -34,6 +36,8 @@ if (argv.includes('--help') || argv.includes('-h')) {
     'Runs as an MCP stdio server; normally launched by your MCP client, not by hand.\n\n' +
     'Usage:\n' +
     '  dsh-any-agent                 run the MCP server on stdio\n' +
+    '  dsh-any-agent team on|off     enable/disable Agent Teams (writes settings.json)\n' +
+    '  dsh-any-agent team status     show the effective team mode\n' +
     '  dsh-any-agent --version       print the version and exit\n' +
     '  dsh-any-agent --help          this text\n\n' +
     'Register it with your client:\n' +
@@ -44,12 +48,70 @@ if (argv.includes('--help') || argv.includes('-h')) {
     '  DSH_MCP_PROFILE          DSH profile to drive (default dsh-mcp)\n' +
     '  DSH_MCP_PERMISSION       danger-full-access | workspace-write | read-only\n' +
     '  DSH_MCP_APPROVAL         auto-allow | auto-deny | ask\n' +
+    '  DSH_MCP_REVIEW           advisory (default) | off — caller review ticket on results\n' +
     '  DSH_MCP_LOG              silent (default) | info | debug\n\n' +
     'Docs: https://github.com/xmtlzzz/dsh-any-agent\n',
   );
   process.exit(0);
 }
 
+/**
+ * `dsh-any-agent team on|off|status`
+ *
+ * 团队开关写 `<DSH_HOME>/.dsh-any-agent/settings.json`，不改客户端配置。
+ * 优先级：环境变量 DSH_MCP_TEAM > 该文件 > 默认关。
+ */
+if (argv[0] === 'team') {
+  const fs = await import('node:fs');
+  const nodePath = await import('node:path');
+  const cfg = await import('../src/config.mjs');
+  const readSettings = () => {
+    try {
+      return JSON.parse(fs.readFileSync(cfg.TEAM_SETTINGS_FILE, 'utf8'));
+    } catch {
+      return {};
+    }
+  };
+  const writeSettings = (obj) => {
+    fs.mkdirSync(nodePath.dirname(cfg.TEAM_SETTINGS_FILE), { recursive: true });
+    const tmp = `${cfg.TEAM_SETTINGS_FILE}.tmp.${process.pid}`;
+    fs.writeFileSync(tmp, JSON.stringify(obj, null, 2) + '\n', 'utf8');
+    fs.renameSync(tmp, cfg.TEAM_SETTINGS_FILE);
+  };
+
+  const action = argv[1] ?? 'status';
+  if (action === 'on' || action === 'off') {
+    const cur = readSettings();
+    cur.team = action === 'on';
+    writeSettings(cur);
+    process.stdout.write(
+      `团队模式已${action === 'on' ? '开启' : '关闭'}（${cfg.TEAM_SETTINGS_FILE}）。\n` +
+        `DSH 版本: ${cfg.DSH_VERSION ?? '未检测到'}（团队需要 >= 0.1.7-0）。\n`,
+    );
+    if (cfg.TEAM_MODE_SOURCE === 'env') {
+      process.stdout.write(
+        '⚠️ 环境变量 DSH_MCP_TEAM 优先级更高；请同时删除它，否则本次设置不会生效。\n',
+      );
+    }
+    process.stdout.write('重新连接 MCP 服务（或重启客户端）后生效。\n');
+    process.exit(0);
+  }
+  if (action === 'status') {
+    const file = readSettings();
+    process.stdout.write(
+      '团队模式状态：\n' +
+        `  环境变量 DSH_MCP_TEAM: ${process.env.DSH_MCP_TEAM ?? '(未设置)'}\n` +
+        `  设置文件: ${cfg.TEAM_SETTINGS_FILE}（team=${file.team === undefined ? '未设置' : file.team}）\n` +
+        `  生效值: ${cfg.TEAM_MODE ? '开' : '关'}（来源: ${cfg.TEAM_MODE_SOURCE}）\n` +
+        `  profile: ${cfg.DSH_PROFILE}\n` +
+        `  团队能力可用: ${cfg.TEAM_ACTIVE ? '是' : '否'}\n`,
+    );
+    process.exit(0);
+  }
+  process.stderr.write('用法: dsh-any-agent team on|off|status\n');
+  process.exit(2);
+}
+
 const { createLogger } = await import('../src/config.mjs');
 const { Hub } = await import('../src/hub.mjs');
 const { createMcpServer } = await import('../src/mcp.mjs');
@@ -63,9 +125,11 @@ await hub.load();
 hub.startReaper();
 // 启动时清一次过期哨兵（哨兵内含正文，长期不清理会无声堆积）
 const prunedSentinels = hub.pruneSentinels();
-if (prunedSentinels.pruned) {
+if (prunedSentinels.pruned || prunedSentinels.reviews_pruned) {
   log.info(
-    `[dsh-any-agent] 启动清理：删除 ${prunedSentinels.pruned} 个过期哨兵、${prunedSentinels.dirs_removed} 个空目录`,
+    `[dsh-any-agent] 启动清理：删除 ${prunedSentinels.pruned} 个过期哨兵、` +
+      `${prunedSentinels.reviews_pruned ?? 0} 条过期审核记录、` +
+      `${prunedSentinels.dirs_removed + (prunedSentinels.review_dirs_removed ?? 0)} 个空目录`,
   );
 }
 // 写锁登记清理：删掉"MCP 已死 + 子进程也死了"的记录；**保留**子进程还活着的那些 ——

package/demo/mcp-client.mjs

@@ -0,0 +1,130 @@
+/**
+ * 极简 MCP 客户端（demo 用）。
+ *
+ * 与 `test/mcp-client.mjs` 是同一套换行分隔 JSON-RPC 协议，但这里刻意独立一份：
+ * `test/` 不进 npm 发布包，而 demo 要随包分发 —— 依赖它会让 `npm run demo`
+ * 在装好的包里直接崩。
+ *
+ * 只做四件事：拉起服务端、initialize、tools/list、tools/call。
+ */
+
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+
+export class McpClient {
+  #child = null;
+  #nextId = 1;
+  #pending = new Map();
+  #buf = '';
+
+  constructor({ pkgRoot, env = {} }) {
+    this.pkgRoot = pkgRoot;
+    this.env = env;
+    /** 服务端的 stderr 行（demo 默认静默，只有 -v 时才值得看）。 */
+    this.stderr = [];
+  }
+
+  get pid() {
+    return this.#child?.pid ?? null;
+  }
+
+  start() {
+    this.#child = spawn(process.execPath, [join(this.pkgRoot, 'bin', 'dsh-any-agent.mjs')], {
+      env: { ...process.env, ...this.env },
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    this.#child.stdout.setEncoding('utf8');
+    this.#child.stderr.setEncoding('utf8');
+    this.#child.stdout.on('data', (d) => this.#onData(d));
+    this.#child.stderr.on('data', (d) => {
+      for (const line of d.split(/\r?\n/)) if (line.trim()) this.stderr.push(line.trim());
+    });
+    this.#child.on('exit', (code, signal) => {
+      const why = `服务端退出（code=${code}${signal ? `, signal=${signal}` : ''}）`;
+      for (const [, p] of this.#pending) p.reject(new Error(why));
+      this.#pending.clear();
+    });
+    return this;
+  }
+
+  #onData(chunk) {
+    this.#buf += chunk;
+    let i;
+    while ((i = this.#buf.indexOf('\n')) !== -1) {
+      const line = this.#buf.slice(0, i);
+      this.#buf = this.#buf.slice(i + 1);
+      if (!line.trim()) continue;
+      let msg;
+      try {
+        msg = JSON.parse(line);
+      } catch {
+        throw new Error(`服务端输出了非 JSON 内容: ${line.slice(0, 300)}`);
+      }
+      if (msg.id === undefined) continue;
+      const p = this.#pending.get(msg.id);
+      if (!p) continue;
+      this.#pending.delete(msg.id);
+      clearTimeout(p.timer);
+      msg.error ? p.reject(new Error(msg.error.message)) : p.resolve(msg.result);
+    }
+  }
+
+  request(method, params, timeoutMs = 120_000) {
+    const id = this.#nextId++;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        if (this.#pending.delete(id)) reject(new Error(`请求超时: ${method}`));
+      }, timeoutMs);
+      this.#pending.set(id, { resolve, reject, timer });
+      this.#child.stdin.write(JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n');
+    });
+  }
+
+  notify(method, params) {
+    this.#child.stdin.write(JSON.stringify({ jsonrpc: '2.0', method, params }) + '\n');
+  }
+
+  async initialize() {
+    const r = await this.request('initialize', {
+      protocolVersion: '2025-06-18',
+      capabilities: {},
+      clientInfo: { name: 'dsh-any-agent-demo', version: '1.0.0' },
+    });
+    this.notify('notifications/initialized', {});
+    return r;
+  }
+
+  async listTools() {
+    return (await this.request('tools/list', {})).tools;
+  }
+
+  async callTool(name, args = {}, timeoutMs) {
+    return await this.request('tools/call', { name, arguments: args }, timeoutMs);
+  }
+
+  /** 取工具结果里的纯文本。 */
+  static text(result) {
+    return (result?.content ?? [])
+      .filter((c) => c.type === 'text')
+      .map((c) => c.text)
+      .join('\n');
+  }
+
+  async close() {
+    try {
+      this.#child.stdin.end();
+    } catch {}
+    await new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        try {
+          this.#child?.kill();
+        } catch {}
+        resolve();
+      }, 6000);
+      this.#child?.once('exit', () => {
+        clearTimeout(timer);
+        resolve();
+      });
+    });
+  }
+}

package/demo/run.mjs

@@ -0,0 +1,326 @@
+#!/usr/bin/env node
+/**
+ * 5 分钟真实案例：把一件活派给 DSH，中途插两次话，再回头验收。
+ *
+ * 这个脚本只用 MCP 协议本身（`initialize` / `tools/list` / `tools/call`），
+ * 不 import 服务端的任何内部模块 —— 它就是你自己的客户端会做的事，
+ * 只不过换成了命令行。
+ *
+ * 用法：
+ *   node demo/run.mjs                 真实跑一遍（需要本机 DSH + 可用 provider）
+ *   node demo/run.mjs --replay        回放上一次录制（零成本、不需要 DSH）
+ *   node demo/run.mjs --keep          保留临时工作区，方便自己翻结果
+ *   node demo/run.mjs --save          跑完把这份记录写成 demo/transcript.json
+ *   node demo/run.mjs --timeout 240   单个回合的最长等待秒数（默认 240）
+ *   node demo/run.mjs --prompt "…"    换一个任务（会跳过内置的两条插话）
+ *
+ * 隔离：注册表 / 哨兵 / 写锁登记全部指向临时目录，不会动你日常的
+ * `~/.dsh/.dsh-any-agent`。DSH 自己的会话仍落在 `~/.dsh/sessions`（凭据与
+ * provider 在那里），脚本结束时会 `dsh_release(forget=true)` 把它移出注册表。
+ */
+
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { McpClient } from './mcp-client.mjs';
+
+const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
+const TRANSCRIPT = join(PKG_ROOT, 'demo', 'transcript.json');
+
+// ── 参数 ────────────────────────────────────────────────────────────
+const argv = process.argv.slice(2);
+const flag = (name) => argv.includes(name);
+const opt = (name, fallback) => {
+  const i = argv.indexOf(name);
+  return i !== -1 && argv[i + 1] && !argv[i + 1].startsWith('-') ? argv[i + 1] : fallback;
+};
+
+if (flag('-h') || flag('--help')) {
+  console.log(
+    [
+      'dsh-any-agent demo —— 派活 → 插话 → 验收',
+      '',
+      '  node demo/run.mjs                 real run (needs a local DSH + a working provider)',
+      '  node demo/run.mjs --replay        replay the last recorded run (no DSH, no tokens)',
+      '  node demo/run.mjs --keep          keep the temp workspace',
+      '  node demo/run.mjs --save          write demo/transcript.json from this run',
+      '  node demo/run.mjs --timeout 240   seconds to wait per turn (default 240)',
+      '  node demo/run.mjs --prompt "…"    use your own task instead of the built-in one',
+      '',
+      'Env: DSH_BIN, DSH_HOME, DSH_MCP_PROFILE (same as the server).',
+    ].join('\n'),
+  );
+  process.exit(0);
+}
+
+const TURN_TIMEOUT_S = Number(opt('--timeout', '240')) || 240;
+const KEEP = flag('--keep');
+const SAVE = flag('--save');
+
+// ── 记录器：打印 + 收集，--save 时落盘 ──────────────────────────────
+const log = [];
+function say(line = '') {
+  process.stdout.write(line + '\n');
+  log.push(line);
+}
+
+// ── --replay：零成本回放 ────────────────────────────────────────────
+if (flag('--replay')) {
+  if (!existsSync(TRANSCRIPT)) {
+    console.error(`还没有录制过：${TRANSCRIPT} 不存在。\n先真实跑一次：node demo/run.mjs --save`);
+    process.exit(1);
+  }
+  const doc = JSON.parse(readFileSync(TRANSCRIPT, 'utf8'));
+  say(`（回放：${doc.recorded_at} 在本机录制的真实运行，不是现场跑的）`);
+  say(`  任务：${doc.prompt}`);
+  say('');
+  for (const line of doc.lines) say(line);
+  process.exit(0);
+}
+
+// ── 真实运行 ────────────────────────────────────────────────────────
+const DEFAULT_PROMPT = [
+  '这是一个自动化演示，请直接动手，不要做架构/影响面分析，不要创建 .birdview/ 之类的产物，不要使用技能。',
+  '',
+  '在这个空目录里做一件小事，并自己验证：',
+  '',
+  '1. 写 fib.mjs：ESM 导出 fib(n)，fib(0)=0、fib(1)=1，用迭代实现，不要递归。',
+  '2. 写 test-fib.mjs：用 node:test + node:assert 覆盖 fib(0)、fib(1)、fib(10)=55。',
+  '3. 运行 `node --test test-fib.mjs`，确认全部通过。',
+  '',
+  '只在当前目录里建这两个文件，不要建别的文件，不要安装任何依赖。',
+].join('\n');
+
+const PROMPT = opt('--prompt', DEFAULT_PROMPT);
+const CUSTOM = PROMPT !== DEFAULT_PROMPT;
+
+const INTERJECTS = [
+  '补充一条要求：fib(n) 收到负数要抛 RangeError("n must be >= 0")，测试里补一条对应断言。',
+  '再补一条：在 fib.mjs 顶上加一行注释，说明时间复杂度是 O(n)。其它别动。',
+];
+
+const t0 = Date.now();
+const since = () => `+${((Date.now() - t0) / 1000).toFixed(1)}s`;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+// 隔离目录：注册表 / 哨兵 / 锁登记都放这里
+const base = mkdtempSync(join(tmpdir(), 'dsh-any-agent-demo-'));
+const stateDir = join(base, 'state');
+const workspace = join(base, 'workspace');
+mkdirSync(stateDir, { recursive: true });
+mkdirSync(workspace, { recursive: true });
+
+const env = {
+  DSH_MCP_STATE: join(stateDir, 'conversations.json'),
+  DSH_MCP_RUNS_DIR: join(stateDir, 'runs'),
+  DSH_MCP_LOCKS_DIR: join(stateDir, 'locks'),
+  DSH_MCP_LOG: 'silent',
+  DSH_MCP_PERMISSION: 'workspace-write',
+  DSH_MCP_APPROVAL: 'auto-allow',
+};
+
+say('dsh-any-agent · 5 分钟真实案例');
+say('='.repeat(64));
+say(`工作区：${workspace}`);
+say(`注册表：${env.DSH_MCP_STATE}（隔离，不动你的日常状态）`);
+say('');
+
+// 前置检查：Node 版本 + DSH 是否可用。早失败 > 跑一半失败。
+const [major, minor] = process.versions.node.split('.').map(Number);
+if (major < 22 || (major === 22 && minor < 15)) {
+  console.error(
+    `Node ${process.versions.node} 太旧：服务端要用 node:zlib 的 zstdDecompressSync 读会话头，需要 >= 22.15。`,
+  );
+  process.exit(1);
+}
+
+let resolveDshBin;
+try {
+  ({ resolveDshBin } = await import('../src/config.mjs'));
+} catch (e) {
+  console.error(`加载配置失败：${e.message}`);
+  process.exit(1);
+}
+try {
+  say(`DSH：${resolveDshBin()}`);
+} catch (e) {
+  console.error(
+    [
+      '找不到可用的 DSH。这个 demo 演示的是「让 DSH 干活」，不是「不装 DSH 也能跑」。',
+      '  装一份：npm i -g @deepseek-ai/dsh   （或设置 DSH_BIN 指向它的 lib/bin.js）',
+      `  原因：${e.message}`,
+    ].join('\n'),
+  );
+  process.exit(1);
+}
+say('');
+
+const client = new McpClient({ pkgRoot: PKG_ROOT, env }).start();
+let exitCode = 0;
+
+/** 从 tools/call 的返回里同时拿结构化字段和可读文本。 */
+const info = (res) => res?.structuredContent ?? {};
+const text = (res) => McpClient.text(res);
+const sentinelStatus = (file) => {
+  try {
+    return JSON.parse(readFileSync(file, 'utf8'));
+  } catch {
+    return null;
+  }
+};
+
+try {
+  // 1. 握手
+  say(`[1/6] ${since()}  initialize —— 服务端只要求 4 个标准方法`);
+  await client.initialize();
+  const tools = await client.listTools();
+  say(`     已连接，暴露 ${tools.length} 个工具：${tools.map((t) => t.name).join(', ')}`);
+
+  // 2. 建会话
+  say('');
+  say(`[2/6] ${since()}  dsh_start —— 建一个长驻会话`);
+  const started = await client.callTool('dsh_start', {
+    cwd: workspace,
+    title_hint: 'demo: fib + test',
+    permission: 'workspace-write',
+  });
+  const convId = info(started).conversation_id;
+  if (!convId) throw new Error(`dsh_start 没返回 conversation_id：\n${text(started)}`);
+  say(`     会话 ${convId}`);
+
+  // 3. 派活（不等）
+  say('');
+  say(`[3/6] ${since()}  dsh_send(wait=false) —— 派完立刻返回，回合在后台跑`);
+  const sent = await client.callTool('dsh_send', {
+    conversation_id: convId,
+    prompt: PROMPT,
+    wait: false,
+  });
+  const sendInfo = info(sent);
+  if (!sendInfo.run_id) throw new Error(`dsh_send 没返回 run_id：\n${text(sent)}`);
+  const firstRun = sendInfo.run_id;
+  const firstSentinel = sendInfo.sentinel_file;
+  say(`     run_id=${firstRun}`);
+  say(`     哨兵=${firstSentinel}   ← 跑完由它通知，不用轮询`);
+
+  // 4. 两次插话。注意：dsh_interject 会一直等到"改口后的那一轮"结束才返回，
+  //    所以这一步同时也是"第二轮的验收点"。
+  say('');
+  say(`[4/6] ${since()}  中途插话 —— 打断当前回合并改口，已做的工作不丢`);
+  let last = null;
+  let n = 0;
+  for (const message of INTERJECTS) {
+    if (CUSTOM) break;
+    await sleep(4000);
+    const res = await client.callTool(
+      'dsh_interject',
+      { conversation_id: convId, message, timeout_ms: TURN_TIMEOUT_S * 1000 },
+      (TURN_TIMEOUT_S + 60) * 1000,
+    );
+    const r = info(res);
+    n += 1;
+    // interject 的返回是"改口后那一轮"的结果：有的版本带 status，有的只带 stop_reason。
+    // 两个都认，别把一次正常结束报成 undefined。
+    const state = r.status ?? (r.error ? 'error' : r.stop_reason === 'end_turn' ? 'done' : r.stop_reason);
+    if (r.interjected === 'idle') {
+      say(`     插话 #${n}：会话当时已空闲，按普通回合执行；status=${state}（${since()}）`);
+    } else {
+      say(
+        `     插话 #${n}：已打断上一轮（上一轮跑了 ${((r.waited_ms ?? 0) / 1000).toFixed(1)}s），` +
+          `新一轮 status=${state}（${since()}）`,
+      );
+    }
+    last = r;
+    if (state !== 'done') say(`       本轮未正常结束：${r.error ?? state}`);
+  }
+  if (CUSTOM) say('     （--prompt 自定义任务，跳过内置插话）');
+
+  // 5. 收活：先看被打断那一轮的哨兵，再看最后一轮
+  say('');
+  say(`[5/6] ${since()}  收活 —— 一个回合 = 一个哨兵，被打断的也算`);
+  const cancelled = firstSentinel ? sentinelStatus(firstSentinel) : null;
+  if (cancelled) {
+    say(`     第 1 轮（被打断）哨兵：status=${cancelled.status}  ← 没被丢掉，照样落地`);
+  }
+  if (last?.sentinel_file) {
+    const fin = sentinelStatus(last.sentinel_file);
+    say(`     最后一轮哨兵：status=${fin?.status ?? '（尚未落地）'}  ${last.sentinel_file}`);
+  }
+
+  // 6. 验收：用 run_id 取正文，然后自己复核磁盘
+  say('');
+  say(`[6/6] ${since()}  dsh_get —— 用 run_id 取回最终结果`);
+  const finalRun = last?.run_id ?? firstRun;
+  const got = await client.callTool('dsh_get', { conversation_id: convId, run_id: finalRun });
+  const answer = info(got).run?.result?.answer ?? '';
+  say(
+    (answer || text(got))
+      .split('\n')
+      .filter((l) => l.trim())
+      .slice(0, 10)
+      .map((l) => `     ${l}`)
+      .join('\n'),
+  );
+
+  say('');
+  say('—'.repeat(64));
+  say('复核（不看它说了什么，看磁盘上有什么）');
+  const files = ['fib.mjs', 'test-fib.mjs'].filter((f) => existsSync(join(workspace, f)));
+  say(`  产出文件：${files.length ? files.join(', ') : '（无）'}`);
+  if (files.includes('test-fib.mjs')) {
+    const test = spawnSync(process.execPath, ['--test', 'test-fib.mjs'], {
+      cwd: workspace,
+      encoding: 'utf8',
+      timeout: 60_000,
+    });
+    say(`  node --test：exit=${test.status}`);
+    for (const line of (test.stdout ?? '').trim().split('\n').filter(Boolean).slice(-3)) {
+      say(`    ${line.trim()}`);
+    }
+    if (test.status !== 0) exitCode = 1;
+  } else {
+    exitCode = 1;
+  }
+
+  // 状态快照：锁在谁手上、内存多少、是否共享进程
+  const status = await client.callTool('dsh_status', { conversation_id: convId }).catch(() => null);
+  if (status) {
+    say('');
+    say('状态快照（dsh_status）');
+    for (const line of text(status).split('\n').slice(0, 8)) say(`  ${line}`);
+  }
+
+  await client.callTool('dsh_release', { conversation_id: convId, forget: true }).catch(() => null);
+} catch (e) {
+  exitCode = 1;
+  say('');
+  say(`!! 失败：${e.message}`);
+  if (client.stderr.length) {
+    say('服务端 stderr（最后 10 行）：');
+    for (const l of client.stderr.slice(-10)) say(`  ${l}`);
+  }
+} finally {
+  await client.close();
+  if (!KEEP) rmSync(base, { recursive: true, force: true });
+}
+
+say('');
+say('='.repeat(64));
+say(
+  `${exitCode === 0 ? '完成' : '未通过'} · 总耗时 ${((Date.now() - t0) / 1000).toFixed(1)}s` +
+    (KEEP ? ` · 工作区保留在 ${workspace}` : ''),
+);
+
+if (SAVE && exitCode === 0) {
+  writeFileSync(
+    TRANSCRIPT,
+    JSON.stringify({ recorded_at: new Date().toISOString(), prompt: PROMPT, lines: log }, null, 2) + '\n',
+    'utf8',
+  );
+  say(`已录制：${TRANSCRIPT}（之后可用 --replay 零成本回放）`);
+}
+
+process.exit(exitCode);

package/demo/transcript.json

@@ -0,0 +1,47 @@
+{
+  "recorded_at": "2026-11-03T08:16:28.187Z",
+  "prompt": "这是一个自动化演示，请直接动手，不要做架构/影响面分析，不要创建 .birdview/ 之类的产物，不要使用技能。\n\n在这个空目录里做一件小事，并自己验证：\n\n1. 写 fib.mjs：ESM 导出 fib(n)，fib(0)=0、fib(1)=1，用迭代实现，不要递归。\n2. 写 test-fib.mjs：用 node:test + node:assert 覆盖 fib(0)、fib(1)、fib(10)=55。\n3. 运行 `node --test test-fib.mjs`，确认全部通过。\n\n只在当前目录里建这两个文件，不要建别的文件，不要安装任何依赖。",
+  "lines": [
+    "dsh-any-agent · 5 分钟真实案例",
+    "================================================================",
+    "工作区：C:\\Users\\xmtlz\\AppData\\Local\\Temp\\dsh-any-agent-demo-R2f2pV\\workspace",
+    "注册表：C:\\Users\\xmtlz\\AppData\\Local\\Temp\\dsh-any-agent-demo-R2f2pV\\state\\conversations.json（隔离，不动你的日常状态）",
+    "",
+    "DSH：C:\\Users\\xmtlz\\AppData\\Local\\npm-cache\\_npx\\57331acab1a6b93f\\node_modules\\@deepseek-ai\\dsh\\lib\\bin.js",
+    "",
+    "[1/6] +0.1s  initialize —— 服务端只要求 4 个标准方法",
+    "     已连接，暴露 14 个工具：dsh_start, dsh_send, dsh_list, dsh_read, dsh_get, dsh_interject, dsh_interrupt, dsh_takeover, dsh_release, dsh_approval_decide, dsh_status, dsh_inbox, dsh_queue, dsh_doctor",
+    "",
+    "[2/6] +0.2s  dsh_start —— 建一个长驻会话",
+    "     会话 cfc31c11-b407-4917-86d9-ccf851f06228",
+    "",
+    "[3/6] +7.6s  dsh_send(wait=false) —— 派完立刻返回，回合在后台跑",
+    "     run_id=run-mw0exu3d-1",
+    "     哨兵=C:\\Users\\xmtlz\\AppData\\Local\\Temp\\dsh-any-agent-demo-R2f2pV\\state\\runs\\cfc31c11-b407-4917-86d9-ccf851f06228\\run-mw0exu3d-1.json   ← 跑完由它通知，不用轮询",
+    "",
+    "[4/6] +7.7s  中途插话 —— 打断当前回合并改口，已做的工作不丢",
+    "     插话 #1：已打断上一轮（上一轮跑了 0.1s），新一轮 status=done（+38.7s）",
+    "     插话 #2：会话当时已空闲，按普通回合执行；status=done（+56.1s）",
+    "",
+    "[5/6] +56.1s  收活 —— 一个回合 = 一个哨兵，被打断的也算",
+    "     第 1 轮（被打断）哨兵：status=cancelled  ← 没被丢掉，照样落地",
+    "     最后一轮哨兵：status=done  C:\\Users\\xmtlz\\AppData\\Local\\Temp\\dsh-any-agent-demo-R2f2pV\\state\\runs\\cfc31c11-b407-4917-86d9-ccf851f06228\\run-mw0eyl8k-3.json",
+    "",
+    "[6/6] +56.1s  dsh_get —— 用 run_id 取回最终结果",
+    "     已在 `fib.mjs` 第 1 行加上注释 `// Time complexity: O(n)`，其余内容一字未动，仍只有这两个文件、无依赖。重跑 `node --test test-fib.mjs` 依旧 4/4 通过。",
+    "",
+    "————————————————————————————————————————————————————————————————",
+    "复核（不看它说了什么，看磁盘上有什么）",
+    "  产出文件：fib.mjs, test-fib.mjs",
+    "  node --test：exit=0",
+    "    ℹ skipped 0",
+    "    ℹ todo 0",
+    "    ℹ duration_ms 131.9934",
+    "",
+    "状态快照（dsh_status）",
+    "  状态=idle | 轮数=3 | 最近回合=run-mw0eyl8k-3(done) | 待决审批=0 | rss=214MB",
+    "",
+    "================================================================",
+    "完成 · 总耗时 57.6s"
+  ]
+}