dsh-any-agent 0.5.0 → 0.5.2

package/src/tools.mjs

@@ -12,12 +12,15 @@ import {
   DEFAULT_PERMISSION,
   DEFAULT_REASONING,
   DEFAULT_REASONING_EFFORT,
+  DEFAULT_REVIEW,
   IDLE_TTL_MS,
   MAX_LIVE,
   MAX_RSS_MB,
   PERMISSION_TIERS,
   REASONING_EFFORTS,
   REASONING_MODES,
+  REVIEW_MODES,
+  REVIEWS_DIR,
   RUNS_DIR,
   SHARED_PROCESS,
   STATE_FILE,
@@ -26,11 +29,14 @@ import {
   DSH_PROFILE,
   toPosixPath,
   resolveDshBin,
+  dshVersionStatus,
+  isNpxCachePath,
 } from './config.mjs';
 import { inspectProfile } from './bootstrap.mjs';
 import { audit } from './audit.mjs';
 import { listOrphans, LOCKS_DIR } from './locks.mjs';
 import { rssMb } from './procstat.mjs';
+import { REVIEW_VERDICTS, normalizeReviewMode } from './review.mjs';
 
 const S = (props, required = []) => ({ type: 'object', properties: props, required, additionalProperties: false });
 
@@ -93,8 +99,9 @@ export const TOOL_DEFS = [
         },
         title_hint: {
           type: 'string',
+          maxLength: 200,
           description:
-            '可读的会话标签。注意 DSH 自己的标题是首条消息的截断前缀（约 13–15 字），会优先显示；' +
+            '可读的会话标签（最长 200 字）。注意 DSH 自己的标题是首条消息的截断前缀（约 13–15 字），会优先显示；' +
             '这里给的值不会被覆盖，而是在 dsh_get / dsh_start 里作为「标题提示」一并返回。',
         },
         reasoning_effort: {
@@ -102,6 +109,13 @@ export const TOOL_DEFS = [
           enum: REASONING_EFFORTS,
           description: `思考深度，默认 ${DEFAULT_REASONING_EFFORT}。注意 ACP 自身的默认是"Provider default"（不设），本服务会显式设成 max。想省钱可调低。`,
         },
+        review: {
+          type: 'string',
+          enum: REVIEW_MODES,
+          description:
+            `调用方审核策略，默认 ${DEFAULT_REVIEW}。advisory：每次派活的结果/哨兵都会附审核单（核验清单 + 证据 + dsh_review 入口），` +
+            '但**不阻塞**后续派活；off：不生成审核单。可被单次 dsh_send 覆盖。',
+        },
         provider: { type: 'string', description: '模型提供方名（如 deepseek-official）。留空用 profile 默认。' },
         model: { type: 'string', description: '模型名（如 deepseek-flash）。指定时必须同时给 provider。' },
         keep_alive: {
@@ -128,10 +142,11 @@ export const TOOL_DEFS = [
       '而是自动降级为后台：返回 run_id + sentinel_file，回合继续跑完，结果稍后由哨兵文件通知。' +
       '（timeout_ms=0 表示一直等。）所以任何时候你都能拿到结果，不用怕"超时了白干"。' +
       '等待模式与后台模式都在回合结束时原子落地一个含最终结果的小文件——' +
-      '**推荐用后台任务（Bash run_in_background + `until [ -f sentinel_file ]`）等它，跑完自动通知你，无需轮询**；' +
+      '**推荐用后台任务（Bash run_in_background + `until [ -f sentinel_file ]`；Windows/PowerShell 用 `Test-Path` 循环，收据里给出现成命令）等它，跑完自动通知你，无需轮询**；' +
       '文件出现后读它即得结果，或用 dsh_get(conversation_id, run_id) 验收，dsh_read 可中途看输出。' +
       '默认隐藏思考内容（只返回正文 + 思考统计）。' +
-      '若会话正在忙，本工具会报错——改用 dsh_interject 插话，或用 dsh_interrupt 先打断。',
+      '结果与后台收据都会带 `review` 审核单（默认 advisory）：调用方核验后用 dsh_review 提交裁决。' +
+      '若会话正在忙，本工具会报错——改用 dsh_interject 插话、dsh_send(queue=true) 入队，或用 dsh_interrupt 先打断。',
     inputSchema: S(
       {
         conversation_id: CONV_ID,
@@ -151,6 +166,12 @@ export const TOOL_DEFS = [
           description:
             '仅 wait=true 时的**等待**上限（毫秒），**默认 0 = 一直等**（不会凭空发明 30 分钟）。到期不会取消回合，只会转成后台并给你 run_id。',
         },
+        review: {
+          type: 'string',
+          enum: REVIEW_MODES,
+          description:
+            '本次派活的审核策略，覆盖会话默认（默认 advisory）。advisory：结果/哨兵附审核单，提示调用方独立核验后用 dsh_review 提交裁决；off：本次不附。',
+        },
         queue: {
           type: 'boolean',
           description:
@@ -159,6 +180,7 @@ export const TOOL_DEFS = [
         },
         client_run_id: {
           type: 'string',
+          maxLength: 128,
           description:
             '调用方生成的幂等键（≤128 字符，作用域=本会话）。重复提交同一个键不会创建第二个 run，' +
             '而是返回首次 run 的结果或收据（replayed=true）。用于"响应在传输层丢了、想安全重发"的场景。',
@@ -218,26 +240,56 @@ export const TOOL_DEFS = [
     description:
       '查看单个会话的详情；带 run_id 时**取那一次派活的最终结果**（异步模式的验收入口）。' +
       '不传 run_id 则取最近一次回合。返回：标题、工作区、权限档、状态、轮数、token 用量、' +
-      '上下文压力、待决审批，以及该回合的完整结果（正文/工具/用量/错误）。' +
-      '**run 记录只在内存、最多保留最近 20 条**；服务重启或记录被挤掉后请改读哨兵文件（它落盘且扛重启）。',
+      '上下文压力、待决审批，以及该回合的完整结果（正文/工具/用量/错误）和 **review 审核单**。' +
+      '**run 记录只在内存、最多保留最近 20 条**；服务重启或记录被挤掉后会从哨兵文件回读（它落盘且扛重启）。',
     inputSchema: S(
       {
         conversation_id: CONV_ID,
-        run_id: { type: 'string', description: 'dsh_send 返回的 run_id；不传则取最近一次回合。' },
+        run_id: { type: 'string', maxLength: 200, description: 'dsh_send 返回的 run_id；不传则取最近一次回合。' },
         client_run_id: {
           type: 'string',
+          maxLength: 128,
           description: '按调用方幂等键取 run（与 run_id 二选一；只对仍在内存里的 run 有效，最多最近 20 条）。',
         },
         max_chars: {
           type: 'number',
           description:
-            '正文在 **text** 里的最大字符数（默认 0 = 不截断）。' +
-            'structured.run.result 仍保留完整内容；截断时附带 answer_truncated/next_offset，可自行分页。',
+            '结果预算（默认 0 = 不截断，返回完整结果）。>0 时**同时**作用于 text 与 structured：' +
+            '正文截到该长度（附 answer_truncated/next_offset），structured.run.result.tools_used 只保留' +
+            '工具名/状态与 input_chars，不再带完整输入。完整结果始终在 sentinel_file 里。' +
+            '一个回合用了很多工具时，默认返回可能超过客户端单次工具结果上限，建议传 8000 左右。',
         },
       },
       ['conversation_id'],
     ),
   },
+  {
+    name: 'dsh_review',
+    description:
+      '提交对一次回合结果的**调用方审核裁决**。dsh_send / dsh_interject / 哨兵里的 result 会带 `review` 审核单' +
+      '（核验清单 + 证据摘要 + review_id）。在把结果当作完成之前，调用方应自己核验（读改动的文件、看 git diff、跑测试等），' +
+      '再调用本工具记录 pass / partial / fail。' +
+      '**默认是建议式审核**：不阻塞后续 dsh_send，也不会自动把审核意见回灌给 DSH；需要修就再 dsh_send。' +
+      'run 记录被内存挤出或服务重启后仍可提交（以哨兵文件为准）。',
+    inputSchema: S(
+      {
+        conversation_id: CONV_ID,
+        run_id: { type: 'string', maxLength: 200, description: '要审核的那次派活（审核单里的 run_id）。' },
+        verdict: {
+          type: 'string',
+          enum: REVIEW_VERDICTS,
+          description: 'pass=可直接采用；partial=部分可用、需补充；fail=不可用、需重做。fail/partial 必须说明理由。',
+        },
+        notes: { type: 'string', description: '审核理由。fail/partial 必填（或改用 findings），最多 8000 字。' },
+        findings: {
+          type: 'array',
+          items: { type: 'string' },
+          description: '逐条问题清单，可选；最多 50 条、每条 2000 字。',
+        },
+      },
+      ['conversation_id', 'run_id', 'verdict'],
+    ),
+  },
   {
     name: 'dsh_interject',
     description:
@@ -261,8 +313,14 @@ export const TOOL_DEFS = [
           description: `思考内容展示档位，默认 ${DEFAULT_REASONING}。`,
         },
         timeout_ms: { type: 'number', description: '新回合的**等待**上限（毫秒），**默认 0 = 一直等**；queue 模式也用它限制等待上一轮结束。忙时等待超时会报错（本次插话未发送，会话不受损）；空闲时到期只转后台，不取消回合。' },
+        review: {
+          type: 'string',
+          enum: REVIEW_MODES,
+          description: '本次插话回合的审核策略，覆盖会话默认（默认 advisory）；off 可关闭本次审核单。',
+        },
         client_run_id: {
           type: 'string',
+          maxLength: 128,
           description: '调用方生成的幂等键（≤128 字符，作用域=本会话）。重复提交返回首次的 run，不会重复插话。',
         },
       },
@@ -365,7 +423,7 @@ export const TOOL_DEFS = [
       {
         conversation_id: CONV_ID,
         action: { type: 'string', enum: ['list', 'remove', 'update', 'promote'] },
-        run_id: { type: 'string', description: 'remove / update / promote 必填' },
+        run_id: { type: 'string', maxLength: 200, description: 'remove / update / promote 必填' },
         text: { type: 'string', description: 'update 时的新文本' },
       },
       ['conversation_id', 'action'],
@@ -380,6 +438,88 @@ export const TOOL_DEFS = [
   },
 ];
 
+/**
+ * 把审核单渲染成调用方一眼能看到的文本块。
+ *
+ * 为什么放在正文后面而不是单独一次工具调用：MCP 调用方拿到结果后往往直接转述，
+ * 审核要求必须和结果出现在同一条消息里，才有机会改变它的下一步动作。
+ */
+function renderReviewSection(review) {
+  if (!review || typeof review !== 'object') return '';
+  const lines = [];
+  const pending = review.status === 'pending';
+  lines.push(`【调用方审核${pending ? ' · 待提交' : ` · ${review.status}`}】`);
+  if (review.prompt_preview) lines.push(`原任务: ${review.prompt_preview}`);
+  const ev = review.evidence ?? {};
+  const bits = [];
+  if (ev.stop_reason) bits.push(`stop=${ev.stop_reason}`);
+  if (ev.workspace_changed != null) bits.push(`工作区变化=${ev.workspace_changed ? '是' : '否'}`);
+  if (ev.changed_files != null) bits.push(`改动文件=${ev.changed_files}`);
+  if (Array.isArray(ev.tools) && ev.tools.length) bits.push(`工具=[${ev.tools.join(', ')}]`);
+  if (ev.auto_approvals) {
+    bits.push(`⚠ 自动放行审批=${ev.auto_approvals}${ev.auto_escalations ? `（含提权 ${ev.auto_escalations}）` : ''}`);
+  }
+  if (bits.length) lines.push(`证据: ${bits.join(' · ')}`);
+  if (pending) {
+    lines.push('在把这次结果当作完成之前，请独立核验：');
+    (review.checklist ?? []).forEach((item, i) => lines.push(`${i + 1}. ${item}`));
+    if (review.instructions) lines.push(review.instructions);
+    lines.push(
+      `提交裁决: dsh_review(conversation_id="${review.conversation_id}", run_id="${review.run_id}", ` +
+        'verdict="pass|partial|fail", notes="审核理由")',
+    );
+  } else {
+    if (review.notes) lines.push(`审核理由: ${review.notes}`);
+    if (Array.isArray(review.findings) && review.findings.length) {
+      lines.push(`审核问题: ${review.findings.join('；')}`);
+    }
+    if (review.review_file) lines.push(`审核记录: ${review.review_file}`);
+  }
+  return lines.join('\n');
+}
+
+/**
+ * 按 `max_chars` 预算压缩一份回合结果（只用于返回给调用方，不改原对象）。
+ *
+ * 体积大头是 tools_used[].input：edit/write 会带完整的新旧文本，几十次工具调用
+ * 轻松几万字。压缩后每个工具只留 id/title/name/status/kind 与 input_chars；
+ * 正文与思考截到预算长度。完整版本仍在哨兵文件里。
+ */
+export function compactResultForBudget(result, cap) {
+  if (!result || typeof result !== 'object' || !(cap > 0)) return result ?? null;
+  const out = { ...result };
+  if (typeof out.answer === 'string' && out.answer.length > cap) out.answer = out.answer.slice(0, cap);
+  if (typeof out.thinking === 'string' && out.thinking.length > cap) out.thinking = out.thinking.slice(0, cap);
+  if (Array.isArray(out.tools_used)) {
+    out.tools_used = out.tools_used.map((t) => {
+      if (!t || typeof t !== 'object') return t;
+      const { input, ...meta } = t;
+      if (input === undefined) return meta;
+      let chars = 0;
+      try {
+        chars = typeof input === 'string' ? input.length : JSON.stringify(input)?.length ?? 0;
+      } catch {
+        chars = 0;
+      }
+      return { ...meta, input_chars: chars };
+    });
+  }
+  return out;
+}
+
+/**
+ * PowerShell 版的哨兵等待命令（Windows 宿主上 Git Bash 可能不可用或挂住）。
+ * 路径放进单引号字面量：PowerShell 单引号里只有 `'` 需要转义（写成 `''`），
+ * `$`、反引号都不展开，所以不会被路径内容注入。
+ */
+export function psWaitCommand(sentinelPath, timeoutSec = 2100) {
+  const lit = `'${String(sentinelPath).replace(/'/g, "''")}'`;
+  return (
+    `$f=${lit}; $dl=(Get-Date).AddSeconds(${Math.max(1, Math.floor(timeoutSec))}); ` +
+    `while(-not (Test-Path -LiteralPath $f)){ if((Get-Date) -gt $dl){ 'TIMEOUT'; exit 1 }; Start-Sleep -Seconds 2 }; 'DONE'`
+  );
+}
+
 /** 把结构化结果渲染成给模型看的文本。 */
 function renderSendResult(r) {
   const lines = [];
@@ -405,9 +545,20 @@ function renderSendResult(r) {
   const tools = (r.tools_used ?? []).map((t) => t.name ?? t.title).filter(Boolean);
   if (tools.length) meta.push(`工具=[${[...new Set(tools)].join(', ')}]`);
   if (r.workspace_changed) meta.push(`本轮工作区状态发生变化(当前共 ${r.diff_stat?.changed_files ?? '?'} 个文件有改动)`);
+  if (r.auto_approvals_total) {
+    meta.push(
+      `自动放行审批 ${r.auto_approvals_total} 次` +
+        (r.auto_escalations_total ? `(含沙箱提权 ${r.auto_escalations_total} 次)` : ''),
+    );
+  }
   lines.push('');
   lines.push(`[${meta.join(' · ')}]`);
 
+  if (r.review) {
+    lines.push('');
+    lines.push(renderReviewSection(r.review));
+  }
+
   if (r.error) {
     lines.push('');
     lines.push(`⚠️ 回合失败: ${r.error}`);
@@ -423,6 +574,7 @@ function renderSendResult(r) {
 function backgroundReceipt(hub, conv, res) {
   const sentinel = res.sentinel_file ?? hub.runSentinelPath(conv.id, res.run_id);
   const sentinelPosix = toPosixPath(sentinel);
+  const review = conv.pendingReviewTicket?.(res.run_id) ?? null;
   const waited = res.waited_ms
     ? `已等待 ${(res.waited_ms / 1000).toFixed(0)}s 仍未结束，改为后台继续（**回合没有被取消**）。`
     : '已在后台执行（**回合没有被取消**）。';
@@ -436,6 +588,9 @@ function backgroundReceipt(hub, conv, res) {
       sentinel_file: sentinel,
       /** Bash/MSYS 形式（D:\a\b → /d/a/b）；非 Windows 等于 sentinel_file。 */
       sentinel_file_posix: sentinelPosix,
+      /** Windows 宿主：现成的 PowerShell 等待命令（路径已按单引号字面量转义）。 */
+      ...(process.platform === 'win32' ? { sentinel_wait_powershell: psWaitCommand(sentinel) } : {}),
+      ...(review ? { review } : {}),
     },
     text:
       `${waited}（run_id=${res.run_id}）\n\n` +
@@ -446,8 +601,13 @@ function backgroundReceipt(hub, conv, res) {
       `推荐用后台任务等它出现，文件一到就会唤醒你：\n` +
       `  Bash(run_in_background): sent="${sentinelPosix}"; \\\n` +
       `    dl=$(( $(date +%s)+2100 )); until [ -f "$sent" ]; do [ $(date +%s) -ge $dl ] && { echo TIMEOUT; exit 1; }; sleep 2; done; echo DONE\n` +
+      (process.platform === 'win32'
+        ? `Windows 上 Bash 不可用（或会挂住）时，用 PowerShell 版本（原生路径，已转义好）：\n` +
+          `  PowerShell(run_in_background): ${psWaitCommand(sentinel)}\n`
+        : '') +
       `文件出现后：直接读它拿结果（推荐——不受内存窗口限制、还扛服务重启），或 dsh_get(conversation_id, run_id) 验收。\n` +
       `消费完可以 rm 掉它。其它随时可用：dsh_status（是否在跑）、dsh_read（增量看输出）。` +
+      (review ? `\n\n${renderReviewSection(review)}` : '') +
       (res.waited_ms
         ? `\n\n下次想立刻返回就传 wait=false；想等更久就调大 timeout_ms（**0 = 一直等**）。`
         : ''),
@@ -471,6 +631,7 @@ function replayRun(hub, conv, run, wantResult) {
         `\n哨兵文件: ${sentinel}`,
     };
   }
+  const review = conv.pendingReviewTicket?.(run.run_id) ?? null;
   return {
     structured: {
       conversation_id: conv.id,
@@ -482,10 +643,12 @@ function replayRun(hub, conv, run, wantResult) {
       replayed: true,
       sentinel_file: sentinel,
       sentinel_file_posix: sentinelPosix,
+      ...(review ? { review } : {}),
     },
     text:
       `（幂等命中：同一个 client_run_id 已在跑或排队，未重复派活）run_id=${run.run_id} status=${run.status}\n` +
-      `哨兵文件: ${sentinel}`,
+      `哨兵文件: ${sentinel}` +
+      (review ? `\n\n${renderReviewSection(review)}` : ''),
   };
 }
 
@@ -493,6 +656,7 @@ function replayRun(hub, conv, run, wantResult) {
 function queuedReceipt(hub, conv, run, position) {
   const sentinel = hub.runSentinelPath(conv.id, run.run_id);
   const sentinelPosix = toPosixPath(sentinel);
+  const review = conv.pendingReviewTicket?.(run.run_id) ?? null;
   return {
     structured: {
       conversation_id: conv.id,
@@ -503,11 +667,13 @@ function queuedReceipt(hub, conv, run, position) {
       status: 'queued',
       sentinel_file: sentinel,
       sentinel_file_posix: sentinelPosix,
+      ...(review ? { review } : {}),
     },
     text:
       `已入队（第 ${position} 位）。当前回合结束后自动执行；**入队时不会写哨兵**，真正结束时才写：\n` +
       `  ${sentinel}\n` +
-      `用 dsh_queue list 查看/修改/删除；取消：dsh_queue(conversation_id, action="remove", run_id="${run.run_id}")。`,
+      `用 dsh_queue list 查看/修改/删除；取消：dsh_queue(conversation_id, action="remove", run_id="${run.run_id}")。` +
+      (review ? `\n\n${renderReviewSection(review)}` : ''),
   };
 }
 
@@ -539,6 +705,7 @@ export function createHandlers(hub, opts = {}) {
         onApproval: args.on_approval,
         titleHint: args.title_hint,
         reasoningEffort: args.reasoning_effort,
+        review: args.review,
         provider: args.provider,
         model: args.model,
         keepAlive: args.keep_alive === true,
@@ -587,7 +754,9 @@ export function createHandlers(hub, opts = {}) {
         throw new Error('prompt 不能为空：至少包含一个非空白字符');
       }
       const conv = await hub.get(args.conversation_id);
+      const review = args.review === undefined ? undefined : normalizeReviewMode(args.review, conv.review);
       const opts = { reasoning: args.reasoning ?? DEFAULT_REASONING };
+      if (review !== undefined) opts.review = review;
       if (args.timeout_ms !== undefined && args.timeout_ms !== null) opts.timeoutMs = parseTimeoutMs(args.timeout_ms);
 
       // ── 幂等：同一个 client_run_id 直接返回首次的 run，不重复执行 ──
@@ -615,6 +784,7 @@ export function createHandlers(hub, opts = {}) {
             reasoning: opts.reasoning,
             clientRunId: args.client_run_id ?? null,
             preview: args.prompt,
+            review: review ?? conv.review,
           });
           if (deduped) return replayRun(hub, conv, run, false);
           audit('send_queued', {
@@ -633,7 +803,10 @@ export function createHandlers(hub, opts = {}) {
 
       const wait = args.wait === true;
       // 记录与预览保留调用方原文；实际派发用 promptText（可能带团队提示）。
-      const run = conv.createRun(args.prompt, { clientRunId: args.client_run_id ?? null });
+      const run = conv.createRun(args.prompt, {
+        clientRunId: args.client_run_id ?? null,
+        review: review ?? conv.review,
+      });
       // prompt() 自己负责收尾与写哨兵。这里 await 是为了**同步暴露 resume/启动失败** ——
       // 否则调用方会拿到一个 accepted 但注定失败的收据（冷启动要几秒，热会话瞬时）。
       const r = await conv.prompt(promptText, { ...opts, run, wait });
@@ -805,7 +978,9 @@ export function createHandlers(hub, opts = {}) {
           `未知 run_id: ${args.run_id}（内存只留最近 20 条；哨兵文件 ${hub.runSentinelPath(args.conversation_id, args.run_id)} 也不存在或不可读）`,
         );
       }
-      // 正文预算只作用于 text；structured 里保留完整 result，调用方要做程序化处理时仍然拿得到。
+      // 预算同时作用于 text 与 structured：Claude Code 等客户端会把 structuredContent
+      // 一并塞进上下文，只截 text 时一次带几十个工具输入的回合仍会超过单次结果上限
+      // （实测 75K 字符被拒收）。完整结果始终在哨兵文件里。
       const answerFull = String(run?.result?.answer ?? '');
       const capRaw = Number(args.max_chars);
       const cap = Number.isFinite(capRaw) && capRaw > 0 ? Math.floor(capRaw) : 0;
@@ -833,6 +1008,11 @@ export function createHandlers(hub, opts = {}) {
           meta.push(`  （思考 ${run.result.thinking_stats.chars} 字已隐藏）`);
         }
         if (run.result?.error) meta.push(`  ⚠️ 失败: ${run.result.error}`);
+        const review = run.review ?? run.result?.review;
+        if (review) {
+          meta.push('');
+          meta.push(renderReviewSection(review));
+        }
       }
       const sentinelFile = run ? hub.runSentinelPath(args.conversation_id, run.run_id) : null;
       const runView = run
@@ -848,10 +1028,15 @@ export function createHandlers(hub, opts = {}) {
             answer_chars: answerFull.length,
             answer_truncated: truncated,
             next_offset: truncated ? cap : null,
-            result: run.result,
+            review: run.review ?? run.result?.review ?? null,
+            result: cap > 0 ? compactResultForBudget(run.result, cap) : run.result,
+            ...(cap > 0 ? { result_compacted: true } : {}),
           }
         : null;
-      if (sentinelFile) meta.push(`\n哨兵文件: ${sentinelFile}`);
+      if (sentinelFile) {
+        meta.push(`\n哨兵文件: ${sentinelFile}`);
+        if (cap > 0) meta.push('（max_chars 已同时压缩 structured：正文截断、工具输入只留长度；完整结果读这个文件）');
+      }
       return {
         structured: {
           ...snap,
@@ -864,6 +1049,31 @@ export function createHandlers(hub, opts = {}) {
       };
     },
 
+    async dsh_review(args) {
+      const conv = await hub.get(args.conversation_id);
+      const r = conv.submitReview(args.run_id, {
+        verdict: args.verdict,
+        notes: args.notes,
+        findings: args.findings,
+      });
+      audit('review', {
+        conversation_id: conv.id,
+        run_id: args.run_id,
+        verdict: args.verdict,
+      });
+      const lines = [
+        `审核已记录：${r.run_id} → ${r.status}（${r.review_id}）`,
+        r.notes ? `理由: ${r.notes}` : '理由: (未填写)',
+      ];
+      if (Array.isArray(r.findings) && r.findings.length) {
+        lines.push('问题:');
+        for (const f of r.findings) lines.push(`  - ${f}`);
+      }
+      lines.push(`审核记录: ${r.review_file}`);
+      lines.push('审核只记录裁决，不会自动回灌给 DSH；需要修复请用 dsh_send 再派活。');
+      return { structured: r, text: lines.join('\n') };
+    },
+
     async dsh_interject(args) {
       if (typeof args.message !== 'string' || args.message.trim() === '') {
         throw new Error('message 不能为空：至少包含一个非空白字符');
@@ -886,6 +1096,7 @@ export function createHandlers(hub, opts = {}) {
         reasoning: args.reasoning ?? DEFAULT_REASONING,
         clientRunId: args.client_run_id ?? null,
       };
+      if (args.review !== undefined) opts.review = normalizeReviewMode(args.review, conv.review);
       if (args.timeout_ms !== undefined && args.timeout_ms !== null) opts.timeoutMs = parseTimeoutMs(args.timeout_ms);
       const r = await conv.interject(args.message, opts);
       conv.lastResult = r;
@@ -986,6 +1197,7 @@ export function createHandlers(hub, opts = {}) {
       const conv = await hub.get(args.conversation_id);
       const snap = conv.snapshot();
       const run = conv.getRun();
+      const review = run ? (run.review ?? run.result?.review ?? null) : null;
       const bits = [`状态=${snap.state}`, `轮数=${snap.turns}`];
       if (snap.state === 'running') {
         bits.push(`已跑=${((snap.running_ms ?? 0) / 1000).toFixed(1)}s`);
@@ -993,6 +1205,9 @@ export function createHandlers(hub, opts = {}) {
         bits.push(`本轮输出=${snap.out_chars ?? 0}字`);
       }
       if (run) bits.push(`最近回合=${run.run_id}(${run.status})`);
+      if (review) {
+        bits.push(`审核=${review.status}${review.verdict ? `(${review.verdict})` : ''}${review.status === 'pending' ? '（待提交）' : ''}`);
+      }
       bits.push(`待决审批=${snap.pending_approvals.length}`);
       if (snap.rss_mb != null) bits.push(`rss=${snap.rss_mb}MB`);
       if (snap.keep_alive) bits.push('保活=是');
@@ -1037,6 +1252,9 @@ export function createHandlers(hub, opts = {}) {
           lock_holder: snap.lock_holder,
           lock_holder_reason: snap.lock_holder_reason,
           lock_conflict: snap.lock_conflict,
+          review: review
+            ? { review_id: review.review_id, status: review.status, verdict: review.verdict ?? null }
+            : null,
           run: run
             ? {
                 run_id: run.run_id,
@@ -1145,7 +1363,26 @@ export function createHandlers(hub, opts = {}) {
           version =
             JSON.parse(readFileSync(join(dirname(bin), '..', 'package.json'), 'utf8')).version ?? null;
         } catch {}
-        add('dsh_bin', 'ok', `${bin}${version ? ` (DSH ${version})` : ''}`);
+        const fromNpx = isNpxCachePath(bin);
+        add(
+          'dsh_bin',
+          fromNpx ? 'warn' : 'ok',
+          `${bin}${version ? ` (DSH ${version})` : ''}${fromNpx ? ' —— 位于 npx 缓存，清缓存后会失效' : ''}`,
+          fromNpx
+            ? '全局安装 DSH（npm i -g @deepseek-ai/dsh）或把 DSH_BIN 指向一个固定位置的 lib/bin.js'
+            : null,
+        );
+        const vs = dshVersionStatus(version);
+        add(
+          'dsh_version',
+          vs.status,
+          `${vs.level}: ${vs.note}`,
+          vs.status === 'ok'
+            ? null
+            : vs.level === 'unverified'
+              ? '对照 docs/zh/compatibility.md；升级后跑一遍 npm test，必要时 npm run test:all'
+              : '升级到 DSH 0.1.7-rc.1 及以上',
+        );
       } catch (e) {
         add('dsh_bin', 'fail', e.message, '设置 DSH_BIN 指向 @deepseek-ai/dsh/lib/bin.js');
       }
@@ -1175,6 +1412,7 @@ export function createHandlers(hub, opts = {}) {
 
       for (const [id, dir] of [
         ['runs_dir', RUNS_DIR],
+        ['reviews_dir', REVIEWS_DIR],
         ['locks_dir', LOCKS_DIR],
       ]) {
         try {