dsh-any-agent 0.3.9 → 0.5.0

package/bin/dsh-any-agent.mjs

@@ -34,6 +34,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' +
@@ -50,6 +52,63 @@ if (argv.includes('--help') || argv.includes('-h')) {
   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');

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"
+  ]
+}

package/docs/brand/README.md

@@ -0,0 +1,58 @@
+# README artwork
+
+`header.jpg` is the shared hero for the English and Chinese READMEs: a blue-haired chibi whale-girl enjoying white rice at a coding desk, with subtle terminal connections behind her.
+
+- Generated and refined with the built-in GPT Image tool on 2026-11-02.
+- The selected version includes the requested slimmer cheeks and leg proportions.
+- Exported as an optimized progressive JPEG, 1983 × 793 pixels, 282,513 bytes.
+- The READMEs use the public raw GitHub URL so the same image works on GitHub and npm.
+- Character reference: the community-created [rice-eating DeepSeek whale-girl meme](https://www.vgover.com/news/227900).
+- Visual direction: the dark desktop and blue/amber lighting in [dsh-notify-me's header](https://github.com/chromoany/dsh-notify-me/blob/main/docs/brand/header.jpg).
+
+## Generation and edit prompts
+
+<details>
+<summary>Original generation</summary>
+
+```text
+Use case: ads-marketing.
+Asset type: preview concept for a GitHub README hero banner for dsh-any-agent.
+Primary request: Create an adorable, polished, wide illustrated banner based on the Chinese DeepSeek community fan-character meme "吃白饭的蓝色大肥鱼", a blue-haired chibi whale-girl happily eating plain white rice. This is the humanlike whale-girl character, NOT an ordinary whale animal. Create a fresh scene and composition, not a reproduction of a meme panel.
+Canvas/composition: Wide landscape banner, about 2.5:1, around 2000 x 800. The left half has beautifully typeset project text with ample breathing room. The right half features one large charming chibi whale-girl seated comfortably at a little developer desk, holding a bowl of fluffy steaming white rice and eating a bite with chopsticks. Character and rice bowl should be large and instantly readable. Her whole head, whale fins and tail must fit comfortably within frame. Balance a clean left typography area with a delightful illustrated right area.
+Character appearance: Big round face, very short cuddly chibi proportions around 2.5 heads tall, round rosy cheeks puffed with a mouthful of rice, large expressive blue eyes with a delighted slightly mischievous look; indigo-blue voluminous long wavy hair shading to pale sky-blue tips, a single curved ahoge on top; blue whale-fin-shaped ears with pale scalloped undersides, small blue hair ribbon, white frilled maid headband. Fully clothed in a cute modest navy-blue and white long-sleeved maid dress with a white apron, small navy neck bow, round-toed dark shoes. One blue whale tail emerges naturally behind her and curves out beside her. Keep the character round and soft, not a tall fashion illustration. A tiny rice grain at the corner of her mouth is a sweet detail. A small blue whale mark decorates the rice bowl.
+Scene/backdrop: Cozy midnight-blue coding workspace. A small open laptop beside her shows a few abstract quiet code lines; it stays secondary. Faint elegant terminal-window outlines and fine blue connecting paths in the distant background hint that the project bridges multiple MCP clients to one persistent agent. Minimal desk surface along bottom. Soft warm amber desk-lamp light and cool blue edge light create a welcoming late-night coding mood. Leave the left typography backdrop clean and dark, with no busy objects behind letters.
+Style/medium: Excellent hand-drawn anime chibi editorial illustration, crisp confident outlines, soft cel shading with delicate painterly light, rich restrained blue palette, warm white rice and soft peach cheeks, cute and premium rather than photorealistic or glossy 3D. All parts of scene share one coherent illustration style. The character eating rice is the visual focal point; terminal elements remain very subtle.
+Text (verbatim): "dsh-any-agent"
+Subtitle (verbatim): "A coding buddy that sticks around."
+Typography: Large very legible off-white bold rounded modern sans-serif title on left, all lower case, hyphens precisely correct. Smaller muted light-blue subtitle directly beneath. Title must remain readable at README width. Use only these two pieces of text.
+Constraints: One character, one bowl of clearly visible plain white rice, one anatomically coherent pair of hands holding bowl and chopsticks naturally. Correct fin ears, long gradient blue hair, chibi face, maid headband, single whale tail. No additional people, no animal-whale substitute, no comic panels, no speech bubbles, no other text, no watermark, no badges, no screenshots, no random typography. Opaque full-bleed dark-blue background, generous safe margins, lovely expressive face and readable rice-eating action.
+```
+
+</details>
+
+<details>
+<summary>Face refinement</summary>
+
+```text
+Use case: precise-object-edit.
+Image 1 is the EDIT TARGET: the existing wide dsh-any-agent rice-eating whale-girl banner.
+Image 2 is a CHARACTER FACE REFERENCE ONLY: the original community meme character. Do not copy its text, pose, white background, pointing hand or empty bowl.
+User request: The banner character's face is too chubby. Make the face slightly slimmer and closer to the original reference, while preserving her cute chibi identity.
+Change ONLY the face and the tiny adjoining hair/neck boundaries needed for a natural contour. Reduce the exaggerated sideways cheek bulges and puffed-cheek inflation. Narrow the visible facial contour subtly, approximately 10 to 15 percent, particularly the lower cheeks. Give her the softly rounded, gently tapered cheeks and neat small rounded chin seen in Image 2. Keep a cute round face, NOT a sharp V-shaped chin or elongated adult face. Maintain approximately the same eye size, blue irises and eye style; make the expression a gentle pleased little closed-mouth smile while eating, with only mild fullness in the cheeks. Preserve the tiny rice grain and soft blush.
+Invariants: Keep Image 1's exact wide canvas and composition, project name "dsh-any-agent", subtitle "A coding buddy that sticks around.", exact typography and text placement, all background and terminal windows, desk and laptop, hands/chopsticks/rice bowl, outfit and maid headband, blue gradient long hair, fin ears, whale tail, pose, color palette and lighting. Do not redraw or restyle the rest of the banner. Only a subtle face slimming toward the character reference. No new text or objects.
+```
+
+</details>
+
+<details>
+<summary>Leg proportions</summary>
+
+```text
+Use case: precise-object-edit.
+Edit target: the supplied wide dsh-any-agent whale-girl banner.
+User request: her legs look a little too thick; make them slightly slimmer and more naturally proportioned while retaining the cute chibi style.
+Change ONLY the small lower-body region at the bottom center-right, where the seated character's knees, short legs and navy shoes appear immediately above the desk edge. Subtly reduce the widths of the visible thighs, knees and lower legs by about 15–20 percent so they look lighter and less bulky. Refine the knee contours into a soft natural shape. Reduce oversized shoe bulk just enough to match the narrower legs. Keep the legs short and softly rounded to suit the existing chibi proportions; maintain the same seated posture, clothing coverage, skirt/stocking/shoe design, and modest framing. Adjust only adjoining skirt folds or the tiny surrounding chair area as strictly necessary for a coherent silhouette.
+Invariants: Preserve the already corrected slimmer face EXACTLY, facial expression, eye size, hair, headband, fin ears and tail, all upper-body proportions, hands, rice bowl, chopsticks, rice, laptop, desk, chair, background terminals, lighting, colors and existing illustration style. Preserve the exact canvas, image framing and all text: "dsh-any-agent" and "A coding buddy that sticks around." Keep typography and placement unchanged. This is a localized subtle leg-proportion correction, not a redesign. No additional objects or text.
+```
+
+</details>