@xiaobuyu/nodesign 0.0.7 → 0.0.8

package/server/engine/agent/hooks/user-prompt-submit.js

@@ -27,7 +27,17 @@ import { readUiConfigFile, withUiDefaults } from '../../../projects/ui-config.js
 import { readAssetsSummary } from '../../../projects/assets-summary.js';
 import { relationsDigest } from '../../../lib/board-relations.js';
 import { getViewpoint, describeViewpoint } from '../../../projects/viewpoint-store.js';
+import { sheetSummaries, latestSheetId, currentSheet, sheetOfPoint } from '../../../lib/board-sheets.js';
+import { currentSheetIdOf } from '../../../lib/sheet-state.js';
+import { dirtyEvents, describeDirty, splitDirtyByCharge } from '../../../lib/board-dirty.js';
+import { fitFor } from '../../../lib/sketch-layout.js';
+import { readStateVars } from '../../../lib/state-table.js';
+import { parseTriggers, evalTriggers, readLatch, writeLatch } from '../../../lib/state-triggers.js';
 import { recentChalk, CHALK_DIR } from '../../../lib/chalk.js';
+import { listRoleNames } from '../role-card.js';
+import { stageStatus } from '../stage-status.js';
+import { resetBeat } from '../beat-state.js';
+import { roleLabel } from '../../mcp/actor.js';
 import { readBoard } from '../../../projects/board-store.js';
 import { estimateSizeOn } from '../../../lib/board-kind-sizes.js';
 import { layerOf } from '../../../lib/canvas-id.js';
@@ -105,13 +115,99 @@ async function collectSections({ workspaceRoot, sessionId, projectId }) {
         w: vp.camera.w, h: vp.camera.h,
       } } : vp;
       const line = describeViewpoint(q, rects);
-      if (line) sections.push({ key: 'viewpoint', title: '用户视点', text: `用户此刻在画布上：${line}。他说「这个/这里/这张」多半指选中的 > 开着的窗 > 视口里的东西；要细节调 read_user_view。` });
+      // 纸（2026-08-29 纸范式）：报当前有哪些纸、剩多少地 —— 空位建议/走向学习
+      // 那套启发式随落位引擎一起退役，agent 的空间账本现在是纸的清单。
+      let spot = null;
+      // 暂存架（2026-08-30）：机器到货的默认座。点名 + 三个安置动词，agent 不动它们就一直在
+      const shelfSeats = Object.entries(board.objects || {})
+        .filter(([, e]) => e?.seat === 'shelf' && !e.zone && Number.isFinite(e?.x))
+        .map(([id]) => id);
+      const pendingSeats = Array.isArray(board.pending) ? board.pending : [];
+      try {
+        const ss = sheetSummaries(board);
+        // 「最新」按登记时间取（latestSheetId 一份算法）—— 不是数组末项那张最下面的
+        const latest = latestSheetId(board);
+        const cur = ss.find(s => s.id === latest) || ss[ss.length - 1];
+        if (cur) {
+          // 报「还能装下什么」不是裸数字（2026-08-30 容量线）：行数是模型真正用来
+          // 决策的量纲 —— 顺手教它超过余量别赌一发，flow 会替它拆
+          const slots = cur.slots?.length
+            ? `；版位 ${cur.slots.map(s => `${s.name} 剩 ~${s.freeLines} 行`).join('、')}`
+            : '；这张没规划版位';
+          spot = `板上 ${ss.length} 张纸；当前 ${cur.id}${cur.title ? `（${cur.title}）` : ''} 还剩 ~${cur.freeH}px 高的空地${slots}`
+            + '（内容眼看要超余量就别赌一发 —— 自己多切几个空位分段填（plan/replan 省掉 at 即竖排接放），'
+            + '或兜底 flow:true；写满**不会**自动翻页，自己 open_sheet 规划下一页；新话题也是 open_sheet）';
+        } else {
+          spot = '板上还没铺过纸 —— 第一笔 write_on_board 会自动铺一张在他视口下，或先 open_sheet';
+        }
+        const unplaced = [...shelfSeats, ...pendingSeats];
+        if (unplaced.length) {
+          spot += `；📦 ${unplaced.length} 件在暂存架等你安置（${unplaced.slice(0, 3).map(r => r.split('/').pop()).join('、')}${unplaced.length > 3 ? '…' : ''}）`
+            + ' —— 给它们规划的地：open_sheet{plan:[…{for:"artifacts"}]} 或逐件 pin_to_board{path,slot} / edit_board move。'
+            + '架不是版面，东西留在架上就是没摆';
+        }
+      } catch { /* 纸读不出就不占字 */ }
+      const dirs = null;
+      /**
+       * 手机 / 平板档的版式（2026-08-28 移动端第二轮，用户拍板「一件 = 一屏，纵向单列」）。
+       *
+       * ⚠️ 这段是**事前**说的，不是靠 write_on_board 的返回文案事后纠正 —— 一块
+       * 1700 宽的板书在 390 的屏上已经写出来了，再告诉它"下次窄一点"没有意义，
+       * 用户这一轮拿到的就是要横着滑四屏的东西。
+       *
+       * ⭐ 同时几何那边也在执行（resolvePlacement 的 column：左右侧一律降级成正下方）。
+       * 两处都做不是重复：提示词管"它主动写多宽"，几何管"它没照做时版面还读得了"。
+       */
+      const fit = fitFor(vp);
+      const laneLine = fit.column
+        ? `⚠️ 他在${fit.lane === 'phone' ? '手机' : '平板'}上（屏幕 ${fit.screen?.w}x${fit.screen?.h}px）。`
+          + `版面规矩：**一件 = 一屏，纵向单列**。每件宽度 ≤${fit.w}（超了就要横向滑动，手机上没人受得了），`
+          + `高度到 ${fit.h} 都行（竖着滚是手机上读长内容的天然姿势）。`
+          + `接着写就往**正下方**接，别用 side:'right'/'left' 并排 —— 并排的第二件在他屏幕外。`
+          + `宁可多拆几件竖着排，也别把一件写宽。`
+        : '';
+      if (line) sections.push({ key: 'viewpoint', title: '用户视点', text: `用户此刻在画布上：${line}。${spot ? `${spot}。` : ''}${dirs ? `${dirs}。` : ''}${laneLine}他说「这个/这里/这张」多半指选中的 > 开着的窗 > 视口里的东西；写板走纸（at = 纸内坐标）。要看画面细节才调 read_user_view。` });
     }
   } catch { /* 视点读不到就沉默 */ }
+  // 板上动静（2026-08-29 纸范式刀 4）：用户拖动/搬家/擦组此前完全静默，agent 只能
+  // 撞运气。这里报最近半小时的动静（指纹只在有新动静时变，未变随「未变」行收拢）；
+  // 回合中途的动静另有 PreToolUse 注入器在 agent 摸板前插话。
+  try {
+    const evts = dirtyEvents(projectId, 0);
+    if (evts.length) {
+      const line = describeDirty(evts, { limit: 6 });
+      // 有限负责制（刀⑤ 2026-08-30）：动静按纸分拣 —— 挪进你当前纸的要接手处理，
+      // 挪去别处的是用户自留地，只报不催（板整个是用户随便动，别拔河）。
+      let charge = '';
+      try {
+        const b = await readBoard(projectId);
+        const curId = currentSheet(b, currentSheetIdOf(sessionId))?.id || null;
+        const sheetOf = (id) => {
+          const e = b.objects?.[id];
+          if (!e || !Number.isFinite(e.x)) return null;
+          const sz = estimateSizeOn(b, id, e);
+          return sheetOfPoint(b, { x: e.x + sz.w / 2, y: e.y + sz.h / 2 })?.id || null;
+        };
+        const { inMine, elsewhere } = splitDirtyByCharge(evts, { sheetOf, currentSheetId: curId });
+        if (inMine.length) {
+          charge = `\n⚠️ 其中 ${inMine.slice(0, 4).join('、')}${inMine.length > 4 ? ` 等 ${inMine.length} 件` : ''} 现在落在**你正在写的纸（${curId}）**上：`
+            + '这块工作区的版面归你管 —— 若它挡了你的版位/内容，用 edit_board 给它挪个合适的位置（挪要挪得讲理，别甩出用户视野）；用户明说过要放那儿的除外。';
+        }
+        if (elsewhere.length && inMine.length) {
+          charge += `\n其余 ${elsewhere.length} 件在你的纸外 —— 那是用户自留地，不要去动。`;
+        } else if (elsewhere.length) {
+          charge = '\n这些都在你当前的纸外 —— 用户自留地，看在眼里就好，不要去动。';
+        }
+      } catch { /* 分拣失败就退回不分拣的报法 */ }
+      sections.push({ key: 'boardDirty', title: '板上动静', text:
+        `用户最近亲手动过板面：${line}。这些位置以现状为准 —— 摆放前先 read_board，别按你记忆里的旧位置来。${charge}` });
+    }
+  } catch { /* 动静读不到就沉默 */ }
+
   try {
     const digest = await relationsDigest(projectId, { limit: 12 });
     if (digest) {
-      sections.push({ key: 'relations', title: '画布关系线', text: `画布关系线（用户和你手动画的连线，端点跟着改名走；语义看线上的词）：\n${digest}\n  产出新东西后记得用 relate_on_board 把「改自/对照/接着/取材」画上去。` });
+      sections.push({ key: 'relations', title: '画布关系线', text: `画布关系线（用户和你手动画的连线，端点跟着改名走；语义看线上的词）：\n${digest}\n  产出新东西后记得用 edit_board add_edge 把「改自/对照/接着/取材」画上去。` });
     }
   } catch { /* 板读不到就沉默 */ }
 
@@ -140,22 +236,114 @@ async function collectSections({ workspaceRoot, sessionId, projectId }) {
   // 最近板书（2026-08-23；08-24 记忆改版时被误删，同日修回）：你/用户在画布上
   // 说过的最近几句 —— 对话在板上，得记得板上说了什么
   try {
-    const recent = await recentChalk(workspaceRoot, { limit: 8 });
+    const all = await recentChalk(workspaceRoot, { limit: 24 });
+    const roleNames = await listRoleNames(workspaceRoot);
+    // 前 8 条 + 保底：每个角色最新那条就算被 GM 自己的章节/状态板挤出前 8 也要在 ——
+    // GM 需要知道台上角色说了什么（08-28 用户拍板），漏了它就会旁白转述/代笔补戏。
+    const recent = all.slice(0, 8);
+    const seenRole = new Set(recent.map(c => c.by));
+    for (const c of all.slice(8)) {
+      if (c.by && c.by !== 'agent' && c.by !== 'user' && !seenRole.has(c.by)) {
+        recent.push(c); seenRole.add(c.by);
+      }
+    }
     if (recent.length) {
-      const lines = recent.map(c => `  ${c.path}（${c.by === 'user' ? '用户' : '你'}${c.anchor ? `，关于 ${c.anchor}` : ''}${c.replyTo ? `，回应 ${c.replyTo.replace(`${CHALK_DIR}/`, '')}` : ''}）「${c.first}」`);
+      // 这段是注给**主 agent** 的，所以「你」= 主 agent；角色写的板书报它的名字，
+      // 否则主 agent 会把角色写的东西当成自己写的（RP 线里那是大部分板书）。
+      const lines = recent.map(c => `  ${c.path}（${c.by === 'user' ? '用户' : c.by && c.by !== 'agent' ? roleLabel(c.by, roleNames.get(c.by)) : '你'}${c.anchor ? `，关于 ${c.anchor}` : ''}${c.replyTo ? `，回应 ${c.replyTo.replace(`${CHALK_DIR}/`, '')}` : ''}）「${c.first}」`);
       sections.push({ key: 'chalk', title: '最近板书', text: `画布上最近的板书（${CHALK_DIR}/，新在前；正文 Read 文件）：\n${lines.join('\n')}`, items: recent.map(c => c.path) });
     }
   } catch { /* 板书读不到就沉默 */ }
 
+  // 状态表（2026-08-30）：板上那张 `| 键 | 值 |` 的现值，每轮开头端到手边 ——
+  // 演出里"会变、要记得"的东西（好感度/时间/线索）不该靠模型自己在上下文里背。
+  //
+  // ⚠️ 这一节**不给 items**，走整节 hash 比对（renderTurnState 的默认分支）。
+  // 给了 items 会被 diffItems 渲染成「新增 好感度=4；移除 好感度=3」—— 信息对、
+  // 话是错的（那个渲染器被 9 个节共用，为一张小表去改它不值）。而且对读者来说，
+  // 变了的时候看到**整表现值**比看到增量有用：它按现值行事，不按 delta 行事。
+  //
+  // ⛔ 「解析不出来」必须出声。collectSections 的房规是"采不到就不出现"，对普通节
+  // 是对的，对这一节就是坑：表被 set_text / 用户手改写坏之后会静默消失，而写口闸
+  // 只守得住 set_vars 那一路（另外两路是合法的写入方）。所以 broken 一律推一节。
+  try {
+    const st = await readStateVars(workspaceRoot);
+    if (st.state === 'ok' && st.rows.length) {
+      const table = st.rows.map(r => `  ${r.key} = ${r.value}`).join('\n');
+      const parts = [];
+
+      // 条件触发器（2026-08-30）：求值点 = 注入点。只在这里求一次，命中就写进
+      // 这一轮的状态块 —— 不在 set_vars 里求值攒到下一轮，那样中间一次进程重启
+      // 就静默吞掉一次触发。沿状态落 .nd/（派生记账，丢了只是"上膛不击发"）。
+      let trig = null;
+      try {
+        const parsed = parseTriggers(st.body || '');
+        if (parsed.triggers.length || parsed.errors.length) {
+          const { latch, fresh } = await readLatch(workspaceRoot);
+          trig = evalTriggers(parsed.triggers, st.rows, latch, { fresh });
+          try { await writeLatch(workspaceRoot, trig.latch); } catch (e) {
+            console.warn('[vars] 沿状态写不进去，下一轮可能重复触发：', e.message);
+          }
+          if (trig.fired.length) {
+            parts.push(`⚡ 这一拍有 ${trig.fired.length} 个条件命中了（你之前挂的）：\n`
+              + trig.fired.map(f => `  · ${f.message}\n    （条件：${f.raw}）`).join('\n'));
+          }
+          const roster = [];
+          if (trig.armed) roster.push(`${trig.armed} 条挂着`);
+          if (trig.retired) roster.push(`${trig.retired} 条已退休`);
+          if (roster.length) parts.push(`  触发器：${roster.join('、')}（声明在 ${st.rel} 的 \`\`\`nd:triggers 围栏里，删一行就是撤一条）`);
+          for (const e of [...parsed.errors, ...trig.errors]) {
+            parts.push(`  ⚠️ 触发器写错了，这条一直不会响：${e}`);
+          }
+        }
+      } catch (e) { console.warn('[vars] 触发器求值失败：', e.message); }
+
+      parts.push(`状态表现值（${st.rel}，共 ${st.rows.length} 格）：\n${table}\n`
+        + `  改数字用 set_vars（只动那一格）；改表的结构/加说明文字才用 edit_board 的 set_text。`);
+      sections.push({ key: 'vars', title: '状态表', text: parts.join('\n') });
+    } else if (st.state === 'broken') {
+      sections.push({
+        key: 'vars',
+        title: '状态表',
+        text: `⚠️ 状态表读不出来了：${st.why}\n`
+          + `  在修好之前 set_vars 会一直拒绝（它不会"尽力写"，那只会把表写得更坏）。`
+          + `${st.rel ? ` Read 一下 ${st.rel} 看看表被改成什么样了。` : ''}`,
+      });
+    }
+  } catch { /* 状态表这一节自己不能变成故障源 */ }
+
+  // 台上（2026-08-29）：角色现在的状态。判据全是 harness 盖的章（SubagentStart/Stop，
+  // 见 stage-status.js）—— 此前主持人对这件事是半盲的：只在角色**结束**时收到一条
+  // 通知，中间既不知道谁在写，也不知道谁写完在等它接。08-28 真会话里用户替它问出了
+  // 这个洞（「说书人是不是要重启一下？」），而主持人手上没有任何工具能回答。
+  try {
+    const st = stageStatus(projectId);
+    if (st.length) {
+      const names = await listRoleNames(workspaceRoot);
+      const mins = (ms) => Math.round(ms / 60000);
+      const lines = st.map((r) => {
+        const who = roleLabel(r.slug, names.get(r.slug));
+        if (r.writing) return `  ${who}（${r.slug}）正在写`;
+        const idle = r.idleMs > 90000 ? `，${mins(r.idleMs)} 分钟没动了` : '';
+        return `  ${who}（${r.slug}）写完了这一段${idle}${r.lastLine ? `，收笔时说：「${r.lastLine}」` : ''}`;
+      });
+      sections.push({ key: 'stage', title: '台上', text:
+        `这场故事里的角色：\n${lines.join('\n')}\n`
+        + `写完的角色这一轮已经结束了 —— 要它接着演，SendMessage 寄给它的名字（当场醒，记得之前所有事）；`
+        + `不用重新派（重派会新起一个失忆的同名角色顶掉它）。` });
+    }
+  } catch { /* 台上读不到就沉默 */ }
+
   // 黑板模式（2026-08-23；08-24 起默认开 —— 没写过这个键的按开算，显式 false 才算关）
   try {
     const cfg = withUiDefaults(await readUiConfigFile(workspaceRoot));
     if (cfg.blackboard_mode === true) {
       sections.push({ key: 'blackboard', title: '黑板模式', text:
-        '【黑板模式：开】用户此刻在画布上专注思考。这一轮默认这么做：想事情就画成图（sketch_on_board，'
-        + '小改动用 edit_sketch 原地改别重画）；做完一件东西在它旁边写一条板书（write_on_board near=）；'
+        '【黑板模式：开】用户此刻在画布上专注思考。这一轮默认这么做：先有纸再动笔（新话题 open_sheet）；'
+        + '想事情就画成图（write_on_board 给 nodes/edges，小改动用 edit_board 原地改别重画）；'
+        + '做完一件东西在它旁边写一条板书（near= 连线说明它说的是谁）；'
         + '用户标注了板上的东西就接在那条下面回（reply_to=）。侧栏照常回复，但板上已经写的别大段重复。'
-        + '尺寸守规范（0.8 倍一屏可读、正文 md 起、一条板书说一件事）；画完 look_at_board 看一眼再收。' });
+        + '尺寸守规范（一张纸 = 一屏、正文 md 起、一条板书说一件事）；画完 look_at_board 看一眼再收。' });
     }
   } catch { /* 读失败：不注入 */ }
 
@@ -212,6 +400,8 @@ export function renderTurnState(sections, prev) {
 
 export function makeUserPromptSubmitHandler({ ctx: _ctx, workspaceRoot, sessionId, projectId }) {
   return async (_input, _toolUseId, _options) => {
+    // 新的一轮：收尾闸重新记账（判的是「这一轮」，见 beat-state.js）
+    resetBeat(sessionId);
     try {
       if (!workspaceRoot) return {};
       const sections = await collectSections({ workspaceRoot, sessionId, projectId });

package/server/engine/agent/hooks.js

@@ -46,6 +46,7 @@
 import {
   makePreToolUseAgentForceForegroundHandler,
   makePreToolUseGrepContentDefaultHandler,
+  makePreToolUseActorStamp,
 } from './hooks/pre-defaults.js';
 import {
   makePreToolUseGetPendingChangesProtocolInjector,
@@ -63,6 +64,13 @@ import {
   makePreToolUseBashStarterFilesFallback,
 } from './hooks/pre-starter-files.js';
 import { makePreToolUseBoardNeighborhoodInjector } from './hooks/pre-board-neighborhood.js';
+import { makePreToolUseBoardDirtyInjector } from './hooks/pre-board-dirty.js';
+import { makePreToolUseUnknownParamsProbe } from './hooks/pre-unknown-params.js';
+import { makePreToolUseSendMessageRecipientGuard } from './hooks/pre-peer-guard.js';
+import { createRoleRoster } from './cast.js';
+import { makePostToolUseFailureRoleRelease, makeSubagentStopRoleNotice, makeSubagentStartRoleAlias } from './hooks/resident-role-lifecycle.js';
+import { makePostToolUseBeatWrite, makePostToolUseBeatHandoff, makeStopBeatGate } from './hooks/beat-gate.js';
+import { makePostToolUseSlotAliasHandler } from './hooks/slot-alias.js';
 import { makePreToolUsePerformanceLogGuard } from './hooks/pre-performance-log-guard.js';
 import { makePreToolUseWorkspaceScopeGuard } from './hooks/pre-workspace-scope-guard.js';
 import { PROJECTS_DATA_ROOT } from '../../projects/workspace.js';
@@ -99,7 +107,14 @@ import { makePostToolUseSubagentReportRecovery } from './hooks/post-subagent-rep
  * @param {string} [deps.projectId]
  * @returns {Partial<Record<string, Array<{ matcher?: string, hooks: Function[], timeout?: number }>>>}
  */
-export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, projectId } = {}) {
+export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, projectId, roleRoster: injected = null } = {}) {
+  // 常驻角色名册：**一个会话一份**（闭包级，不是全局表）。派发时登记、收件人闸按它放行。
+  // 两个 handler 必须拿同一个引用 —— 各建各的等于闸永远看到空名册，症状是所有角色
+  // 都寄不出信（fail-closed，至少不静默漏）。见 cast.js createRoleRoster 的头注释。
+  // 名册由 session-loop 建好传进来（cast_role 也要用同一份 —— 它记"这一回合造的角色"，
+  // 派发闸据此拦掉本回合内注定失败的派发）。没传就自建，单测/脚本直接调时仍成立。
+  const roleRoster = injected || createRoleRoster();
+
   return assertHooksWellFormed({
     // ── P0+ stage 1（不动）──
 
@@ -138,10 +153,31 @@ export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, project
     }, {
       matcher: 'Task|Agent',
       hooks: [
-        makePreToolUseAgentForceForegroundHandler(),
+        makePreToolUseAgentForceForegroundHandler({ roster: roleRoster, workspaceRoot, ctx }),
         // vision-checker 派遣 prompt 模板首次注入（仅当 subagent_type='vision-checker'）
         makePreToolUseTaskVisionCheckerDispatchInjector(),
       ],
+    }, {
+      // SendMessage 收件人闸：只放行 main / 本项目常驻角色 / 本会话 agentId。
+      // 这个工具的另一半寻址空间是**同机其他 Claude 会话**（探针实测 ListAgents
+      // 列得出来），跨会话寄信 = 一个用户的 agent 给另一个人的 agent 递指令。
+      // SDK 的 crossSessionInbound 只管收不管发，发这侧得自己拦。见 pre-peer-guard.js
+      matcher: 'SendMessage',
+      hooks: [makePreToolUseSendMessageRecipientGuard({ roster: roleRoster })],
+    }, {
+      // 板上写入的署名：工具执行前把「这次是谁调的」记下来（MCP handler 自己拿不到
+      // agent 身份，hook 拿得到）。常驻角色写的板书要署它的名，不能全算主 agent 头上。
+      // 见 agent/actor-trail.js —— 权威是 harness 盖的章，不是角色文件里的自称。
+      //
+      // ⛔ 这里曾是手写工具名单，漏过两次，两次症状都是「闸装着、判据永远落 'agent'」：
+      //   - 08-26 漏 await_user/check_inbox/read_board → 整条收件箱回路在生产里是死的
+      //   - 08-28 审出漏场务四件 → 对真角色恒拒（它们永远被当成主控）
+      //   （两族工具 08-29 随编排收敛一起退役，教训留着：通配挂法就是从这两次来的）
+      // 手写名单和「写死表家族」同病：加新工具必漏。改成全量盖章 —— 盖章本身只是往
+      // 500 容量的 LRU Map 记一条，多盖无副作用，凡是可能用 byOf 的工具永远在闸内。
+      // 装配层有测试钉着（hooks-assembly.test.js）：别再收窄回名单。
+      matcher: 'mcp__nodesign__.*',
+      hooks: [makePreToolUseActorStamp()],
     }, {
       // ⚠️ Grep 的输入改写只许有这一个 handler——两个各返回 updatedInput 会互相抹掉
       matcher: 'Grep',
@@ -190,6 +226,16 @@ export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, project
       // UserPromptSubmit 的全图摘要截断后，这里做精确补充。每个文件一个会话只注一次。
       matcher: 'Read|Edit|Write',
       hooks: [makePreToolUseBoardNeighborhoodInjector({ workspaceRoot, projectId })],
+    }, {
+      // 板上动静（2026-08-29 纸范式刀 4）：用户回合中途拖动/搬家/擦组，agent 下一次
+      // 摸板前插话（按会话恰好一次，台账在 lib/board-dirty.js）。
+      matcher: 'mcp__nodesign__(write_on_board|edit_board|read_board|board_batch|open_sheet|organize_board|look_at_board)',
+      hooks: [makePreToolUseBoardDirtyInjector({ projectId, sessionId })],
+    }, {
+      // 未知参数探针（2026-08-30）：zod 把 schema 里没有的键静默 strip 掉，工具自己
+      // 看不见 —— 只有钩子拿得到原始 tool_input。挂全部 nodesign 工具。
+      matcher: 'mcp__nodesign__.*',
+      hooks: [makePreToolUseUnknownParamsProbe()],
     }, {
       matcher: 'Write',
       hooks: [
@@ -204,9 +250,11 @@ export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, project
       ],
     }],
 
-    // Stop —— agent 准备结束 query 时触发，发自检事件给前端
+    // Stop —— agent 准备结束 query 时触发，发自检事件给前端。
+    // 第二个是演出模式的收尾闸：这一拍既没给按钮也没交给角色就不许收工
+    // （08-28 真会话的头号病：写完两千字正文玩家没有任何把手）。
     Stop: [{
-      hooks: [makeStopReflectionHandler({ ctx, workspaceRoot })],
+      hooks: [makeStopReflectionHandler({ ctx, workspaceRoot }), makeStopBeatGate({ sessionId, projectId })],
     }],
 
     // PostCompact —— compact 后把摘要写入 spec.json 长期记忆
@@ -231,6 +279,18 @@ export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, project
     // PostToolUse —— 按 MCP 工具名分别注 additionalContext，引导 agent 利用
     // 工具结果。matcher 字段是 SDK 标准（与 PreToolUse 'Bash' 同语义）。
     PostToolUse: [
+      // 演员位实例学名（2026-08-28 重构）：hook input 没有实例名字段，名字只在
+      // 派发/唤醒的 tool_result 里露面 —— 从那里学 agentId→实例名（slot-alias.js）。
+      // 收件箱、板书署名、退场标记全靠这张表把 rp-actor 解析回具体角色。
+      {
+        matcher: 'Task|Agent|SendMessage',
+        hooks: [makePostToolUseSlotAliasHandler(), makePostToolUseBeatHandoff({ sessionId, projectId })],
+      },
+      // 收尾闸的另一半：主持人往画布上写了什么、带没带按钮（见 hooks/beat-gate.js）
+      {
+        matcher: 'mcp__nodesign__write_on_board|mcp__nodesign__board_batch',
+        hooks: [makePostToolUseBeatWrite({ sessionId, projectId })],
+      },
       // Edit/Write 后干掉 tool_response.originalFile：FileEditOutput/FileWriteOutput
       // 默认含完整原文件（sdk-tools.d.ts:2270, 2328），这是上下文累积大头。
       // canvas.html 25KB 一次 Edit ≈ 6k tokens，30 turn 累积可达 180k+ → 触发 256k 上限。
@@ -303,15 +363,25 @@ export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, project
     // 注入恢复建议（避免重试同样的错）。
     PostToolUseFailure: [{
       hooks: [makePostToolUseFailureHandler({ ctx, projectId, sessionId })],
+    }, {
+      // 常驻角色派发失败 → 把名字从名册里撤回。claim 在 PreToolUse（派发**之前**），
+      // 不撤的话这个名字整个会话被 brick，而且收件人闸会对一个并不存在的 agent 放行
+      // （裸名回落全机解析 = H1 那个洞在窄窗口里重开）。见 resident-role-lifecycle.js
+      matcher: 'Task|Agent',
+      hooks: [makePostToolUseFailureRoleRelease({ roster: roleRoster })],
     }],
 
     // SubagentStart / SubagentStop —— 主动捕子代理生命周期。当前只 emit 事件
     // 给上层观察；不阻塞流程。stage 2 真接通子代理时这里加调度逻辑。
     SubagentStart: [{
-      hooks: [makeSubagentStartHandler({ ctx })],
+      // 第二个 handler 是署名的正门：agent_id ↔ 角色名在起飞这一刻绑定
+      // （见 resident-role-lifecycle.js；旧的"从 tool_result 抠 id"已退役）
+      hooks: [makeSubagentStartHandler({ ctx, sessionId }), makeSubagentStartRoleAlias({ projectId })],
     }],
     SubagentStop: [{
-      hooks: [makeSubagentStopHandler({ ctx })],
+      // 常驻角色退场时补一句「怎么把它叫回来」给主控。放在通用 emit 之后：
+      // 那个只 emit 事件不返输出，两者不抢 systemMessage。见 resident-role-lifecycle.js
+      hooks: [makeSubagentStopHandler({ ctx, sessionId }), makeSubagentStopRoleNotice({ projectId })],
     }],
   });
 }

package/server/engine/agent/isolation.js

@@ -25,6 +25,7 @@ import os from 'node:os';
 import fs from 'node:fs/promises';
 import { platform } from '../../runtime/platform.js';
 import { autoModeSettings } from './auto-mode-rules.js';
+import { MCP_ALLOW_RULE } from '../mcp/server-name.js';
 
 /**
  * 会话要用的缓存/临时目录一次备齐（2026-08-19 从 session-loop 下沉）。
@@ -129,7 +130,15 @@ export function buildIsolationOptions({ cwdRoot, sharedRoot, npmCacheDir, agentT
           // 没有它 Bash 的 tmp 只读：venv 静默失败、pip --user EROFS、npm 装不上
           ...(agentTmpDir ? [agentTmpDir] : []),
         ],
-        denyWrite: ['/etc', '/usr', '/bin', '/sbin', '/private/etc'],
+        // ⛔ 角色文件不许模型写（2026-08-26）：它是派发闸的判据本身，模型能改就等于
+        // 自己给自己发工具权限（TOCTOU + 解析器分歧两条绕法，详见
+        // hooks/pre-workspace-scope-guard.js 那段注释）。
+        // 这半只管 Bash —— Write/Edit 是进程内工具**不进 bwrap**，那半在上面那道闸。
+        // 正门 cast_role 走服务端 fs，不经沙盒，照写不误。
+        denyWrite: [
+          '/etc', '/usr', '/bin', '/sbin', '/private/etc',
+          ...(cwdRoot ? [path.join(cwdRoot, '.claude', 'agents')] : []),
+        ],
         // 数据根整个盖住、再用 allowRead 给自己的工作区开天窗。
         // ⚠️ 口径要准（08-18 上生产时实测纠正）：`ls 数据根` **看得见别的项目的
         // 目录名**（沙盒里实测列出了另一个 pid），拦住的是**进去读**——
@@ -149,7 +158,21 @@ export function buildIsolationOptions({ cwdRoot, sharedRoot, npmCacheDir, agentT
       },
     },
     settings: {
-      permissions: { deny: platform.protectedPathRules({ dataRoot }) },
+      permissions: {
+        deny: platform.protectedPathRules({ dataRoot }),
+        // 本平台自己的 MCP 工具整服务放行，不过 auto 模式分类器（2026-08-25 用户拍板）。
+        //
+        // 为什么：这些工具是我们自己写的，每一件的边界在服务端**已经**有闸
+        //   —— 出网走 ssrf-guard，publish_site / 本地产线走 owner + 档位闸，
+        //   生图走额度闸，路径走 permissions.deny + 沙盒。让一个模型分类器
+        //   再判一遍 `read_board` 安不安全，既判不出新东西，还多一次外部依赖。
+        // 真实账：真用户会话里分类器**从没拦下过一次真越界**（唯一那条是
+        //   Stage 2 classifier error 误伤 deliver_files 交稿），却因为自身不可用
+        //   挡掉过 8 个会话的正经活（08-24 一天 15 次）。闸门的净效用是负的。
+        // Bash **不在**名单里：它跑的是任意命令，语义判断正是分类器的本职。
+        //   内置的 Read/Write/Edit/WebFetch 等也照旧不动。
+        allow: [MCP_ALLOW_RULE],
+      },
       // auto 模式的分类器规则（只在开了 auto 时注入，省得白占 settings）。
       // ⚠️ 按节替换不是追加 —— 为什么只覆盖 environment / hard_deny 两节，
       // 见 auto-mode-rules.js 文件头。

package/server/engine/agent/memory-config.js

@@ -45,10 +45,32 @@ export const MEMORY_EXTRA_GUIDELINES = [
  * SDK 手里（agent 照 SDK 默认路径写记忆被沙盒拒、~/.claude 下堆了 187 个空目录）。
  * 「两处同名键静默互吞」没有任何报错，出口断言在这里兜。
  */
-export function mergeAgentSettings(isolationSettings, { skipWebFetchPreflight, sharedRoot }) {
+export function mergeAgentSettings(isolationSettings, extra = {}) {
+  // ⚠️ 这个第二参是**显式白名单**（它存在的理由就是防 settings 互吞）。所以它有一个
+  // 结构性陷阱：往调用点里塞一个这里没解构的新键 = 那个键被静默丢弃，零症状。
+  // 2026-08-26 真踩：`crossSessionInbound: 'refuse'`（跨会话入向闸）在调用点写得好好的，
+  // 到了 SDK 手里根本不存在 —— 修互吞案的函数自己吞了新键。
+  // 所以未知键**当场炸**：白名单的代价必须由加键的人当场付，不能由线上静默付。
+  const { skipWebFetchPreflight, sharedRoot, crossSessionInbound, ...unknown } = extra;
+  const unknownKeys = Object.keys(unknown);
+  if (unknownKeys.length) {
+    throw new Error(
+      `[memory-config] mergeAgentSettings 收到不认识的键：${unknownKeys.join(', ')} —— `
+      + '这个第二参是显式白名单，加新键要同时改这里的解构和下面的出口断言，别指望它透传',
+    );
+  }
+
   const settings = {
     ...isolationSettings,
     skipWebFetchPreflight,
+    // 跨会话入向（2026-08-26）：实测——不是推断——Nodesign 的每个会话都会以 cwd
+    // 派生的名字注册进**本机 peer 名册**（生产上正在跑的用户会话当时显示为
+    // `shared-6d`），同机任何一个 Claude 会话 ListAgents 都看得见、都能按名字寄信。
+    // SDK 默认「权限模式相同就自动投递」（bypass↔bypass），而我们正是
+    // bypassPermissions → 本机任何 bypass 会话都能把文本注进用户会话的上下文。
+    // 出向那侧我们自己拦（hooks/pre-peer-guard.js），入向只有这一个旋钮。
+    // ⛔ 别写 'hold'：那是「存起来等人批准」，而服务端没有人在批。
+    ...(crossSessionInbound ? { crossSessionInbound } : {}),
     ...(sharedRoot ? {
       autoMemoryEnabled: true,
       autoMemoryDirectory: memoryDirFor(sharedRoot),
@@ -57,5 +79,9 @@ export function mergeAgentSettings(isolationSettings, { skipWebFetchPreflight, s
   if (sharedRoot && !settings.autoMemoryDirectory) {
     throw new Error('[memory-config] settings.autoMemoryDirectory 被吞了 —— 检查 settings 合并处');
   }
+  // 出口断言按「传进来的每个键都要在出口活着」逐条对，不是只看一个样本键
+  if (crossSessionInbound && settings.crossSessionInbound !== crossSessionInbound) {
+    throw new Error('[memory-config] settings.crossSessionInbound 被吞了 —— 跨会话入向闸会静默失效');
+  }
   return settings;
 }