@xiaobuyu/nodesign 0.0.7 → 0.0.8

package/server/engine/agent/tool-input-stream.js

@@ -0,0 +1,165 @@
+/**
+ * server/engine/agent/tool-input-stream.js —— 真流式工具入参（2026-07-28 建，
+ * 2026-08-29 从 agent-shared.js 拆出：行数棘轮，胖了就拆别抬上限）
+ *
+ * input_json_delta 是半截 JSON 碎片。等拼完再发的话，模型逐 token 生成 new_string
+ * 的几十秒里前端只能干转圈。这里对点名的工具累积缓冲区，节流用 partial-json 容错
+ * 解析累积串，把目标字段相对上次的**纯文本增量**推给前端（run.delta.tool_input）。
+ *
+ * 转义符跨块断开由解析器兜住；字段单调增长，万一局部解析短暂回缩就跳过本拍
+ * （append 只在变长时发）。
+ */
+
+import { Events } from './events.js';
+import { toWorkspaceRel } from '../../lib/workspace-path.js';
+import { parse as parsePartialJson, Allow as PartialAllow } from 'partial-json';
+
+// ── 真流式工具入参（2026-07-28，工作台舞台层代码直播）──
+// input_json_delta 是半截 JSON 碎片，等拼完再发一次的话，模型逐 token 生成
+// new_string 的几十秒里前端只能干转圈。这里对写代码的工具累积缓冲区，节流用
+// partial-json 容错解析累积串，把目标字段相对上次的纯文本增量推给前端
+// （run.delta.tool_input）。转义符跨块断开由解析器兜住；字段单调增长，
+// 万一局部解析短暂回缩就跳过本拍（append 只在变长时发）。
+/**
+ * `spot`（2026-08-29 占位契约刀 C）：跟 text 一起抽出来的**位置字段**。
+ *
+ * 在这之前流式板书的字画在"视口里一块空地"（BoardCanvas 的 liveChalkSpotFor），
+ * 跟 agent 给的 at 毫无关系 —— 写完淡出、真卡在真位置接棒，用户看到的是字从假
+ * 位置跳到真位置。站主要的是「先把位置选好，内容流到选定位置」。
+ *
+ * 时机不用另外等：判据跟 file_path 那套一样 —— **目标字段（text）的 key 一出现，
+ * 就说明排在它前面的字段都已闭合**（所以 write_on_board 的 schema 把 at/sheet/
+ * width 排到了 text 前面）。也就是说框在第一个字到达的那一刻立起来，正好。
+ *
+ * ⚠️ 不能只看 `at` 在不在：容错解析会把**没写完的数字**也交出来（`{"x": 123`
+ * 流到一半是 `{x:12}`，完全合法且看不出来），用它当坐标就是错的位置。
+ */
+export const TOOL_INPUT_STREAM_FIELDS = {
+  Edit: 'new_string',
+  Write: 'content',
+  // 板书直播（2026-08-25 流式路 A）：write_on_board 的 text 逐 token 流到画布上
+  // 的舞台粉笔卡（StageLayer chalk 档）—— 粉笔字在用户眼前一行行长出来。
+  mcp__nodesign__write_on_board: { field: 'text', spot: ['slot', 'at', 'sheet', 'width', 'h', 'near', 'side', 'reply_to', 'chain'] },
+  // board_batch 批内嵌套（08-25 用户报「流式名存实亡」：skill 教的是一章一次
+  // batch，正文藏在 actions[].input.text 里，顶层字段抽取器抓不到 —— 等于亲手
+  // 教了大家绕开流式）。batch 档抽**最新一条** write_on_board 动作的 text，
+  // 换动作时发 reset 让前端另起一张。
+  mcp__nodesign__board_batch: { batch: 'write_on_board', field: 'text', spot: ['slot', 'at', 'sheet', 'width', 'h', 'near', 'side', 'reply_to', 'chain'] },
+};
+const TOOL_INPUT_THROTTLE_MS = 120;
+
+export function toolInputStreams(ctx) {
+  if (!ctx._toolInputStreams) ctx._toolInputStreams = new Map();
+  return ctx._toolInputStreams;
+}
+
+
+/** 批内嵌套抽取（纯函数好钉测试）：最新一条 <tool> 动作的 <field> 字符串与它的序号 */
+export function latestBatchField(obj, toolName, field) {
+  const actions = Array.isArray(obj?.actions) ? obj.actions : [];
+  for (let i = actions.length - 1; i >= 0; i -= 1) {
+    const a = actions[i];
+    const name = String(a?.name || '');
+    if ((name === toolName || name.endsWith(`__${toolName}`)) && typeof a?.input?.[field] === 'string') {
+      return { idx: i, text: a.input[field], input: a.input };
+    }
+  }
+  return null;
+}
+
+/**
+ * 位置字段抽取（占位契约刀 C）。只在**目标字段已经出现**时调用 —— 那时排在它
+ * 前面的位置字段都已闭合，数字不会是流到一半的半截值。
+ *
+ * ⚠️ 一个位置字段都没有时返回的是**空对象不是 null**（2026-08-29 刀 F）：
+ * "什么都没点名" 本身就是一条位置信息 —— 那是**纸内顺排**，前端照服务端同一条
+ * 规则算得出落点。返回 null 的话这条事件根本不发，前端只能把字先写在视口一块
+ * 空地上、等落盘再跳过去（站主看到的"流式完毕之后再移动"）。而顺排恰恰是最
+ * 常见的调用形态。
+ *
+ * @returns {object|null} null 只在入参根本不是对象时出现
+ */
+export function pickSpot(input, fields) {
+  if (!input || typeof input !== 'object') return null;
+  const out = {};
+  for (const k of fields) {
+    const v = input[k];
+    if (v === undefined || v === null) continue;
+    // at 是 {x,y}：两个坐标都得是有限数才算数（缺一个就是没写完）
+    if (k === 'at') {
+      if (typeof v === 'object' && Number.isFinite(v.x) && Number.isFinite(v.y)) {
+        out.at = { x: v.x, y: v.y };
+      }
+      continue;
+    }
+    if (typeof v === 'string' || Number.isFinite(v) || typeof v === 'boolean') out[k] = v;
+  }
+  return out;
+}
+
+export function pumpToolInputStream(ctx, st, flush) {
+  const now = Date.now();
+  if (!flush && now - st.lastEmit < TOOL_INPUT_THROTTLE_MS) return;
+  let obj;
+  try { obj = parsePartialJson(st.buf, PartialAllow.ALL); } catch { return; }
+  if (!obj || typeof obj !== 'object') return;
+  let text = '';
+  let reset = false;
+  let host = obj;              // 位置字段所在的对象（batch 档是那条动作的 input）
+  if (st.batch) {
+    const hit = latestBatchField(obj, st.batch, st.field);
+    if (hit) {
+      if (st.actionIdx !== hit.idx) { st.actionIdx = hit.idx; st.sent = 0; st.spotSent = false; reset = true; }
+      text = hit.text;
+      host = hit.input;
+    }
+  } else {
+    text = typeof obj[st.field] === 'string' ? obj[st.field] : '';
+  }
+  // 位置（刀 C）：目标字段已出现 = 排在它前面的位置字段都闭合了，这一拍可以定框。
+  // 一条动作只发一次（batch 换动作时 spotSent 已随 reset 归位）。
+  const spot = (!st.spotSent && st.spot && host?.[st.field] !== undefined)
+    ? { ...pickSpot(host, st.spot), ...(st.batch ? { batchIdx: st.actionIdx } : {}) } : null;
+  // 新纸预告（刀④ 2026-08-30）：batch 的典型形状是 [open_sheet, write{slot}, …]，
+  // 流式发生时**一个动作都没执行**、新纸还没登记 —— 前端只能退到「最新那张纸」
+  // （偏一整屏）或空地（叠一堆）。这里把「这条 write 排在一个 open_sheet 后面」
+  // 这件事随 spot 带出去，slot 的规划矩形也从流进来的 plan 里抠出来，
+  // 前端就能把框立在新纸将要出现的地方。
+  if (spot && st.batch && Array.isArray(obj.actions)) {
+    const opened = obj.actions.slice(0, st.actionIdx)
+      .filter((a) => typeof a?.name === 'string' && a.name.replace(/^mcp__\w+__/, '') === 'open_sheet')
+      .pop();
+    if (opened) {
+      spot.freshSheet = true;
+      const plan = Array.isArray(opened.input?.plan) ? opened.input.plan : [];
+      const sl = spot.slot ? plan.find((p) => p?.slot === spot.slot) : null;
+      if (sl && Number.isFinite(sl.at?.x) && Number.isFinite(sl.at?.y)
+        && Number.isFinite(sl.w) && Number.isFinite(sl.h)) {
+        spot.planSlot = { x: sl.at.x, y: sl.at.y, w: sl.w, h: sl.h };
+      }
+    }
+  }
+  // file_path 只在确定流完后才取：容错解析会把半截字符串也带出来，第一拍常
+  // 截在路径中间（e2e 撞过：抽到项目目录名 → 前端物件寻址指错）。目标字段的
+  // key 出现（键序在 file_path 之后）或对象已有第二个键 = 路径已闭合。
+  const pathComplete = obj[st.field] !== undefined || Object.keys(obj).length >= 2;
+  // 发**工作区相对路径**（2026-08-13）：前端拿它当画布物件 id 的路径部分，
+  // 而 id = 工作区相对路径。以前原样转发绝对路径，前端靠 `tasks/<任务>/`
+  // 这个特征段抠相对部分 —— 那一层拆掉后绝对路径里没有可锚定的标志了。
+  const rawFilePath = !st.filePathSent && pathComplete && typeof obj.file_path === 'string' ? obj.file_path : null;
+  const filePath = rawFilePath ? toWorkspaceRel(rawFilePath, ctx.workspace?.root?.()) : null;
+  const append = text.length > st.sent ? text.slice(st.sent) : '';
+  if (!append && !filePath && !spot && !flush && !reset) return;
+  st.lastEmit = now;
+  if (append) st.sent = text.length;
+  if (filePath) st.filePathSent = true;
+  if (spot) st.spotSent = true;
+  ctx.emit(Events.deltaToolInput(ctx.counters.turns, st.id, st.name, {
+    ...(filePath ? { filePath } : {}),
+    ...(spot ? { spot } : {}),
+    ...(append ? { append } : {}),
+    ...(reset ? { reset: true } : {}),
+    ...(flush ? { done: true } : {}),
+  }));
+}
+

package/server/engine/mcp/actor.js

@@ -0,0 +1,59 @@
+/**
+ * engine/mcp/actor.js —— 板上写入的署名（2026-08-26）
+ *
+ * 板上每一样东西都带 `by`。在常驻角色之前它只有两个值（'agent' / 'user'），
+ * 现在多了第三类：**具名角色**（叙事者、NPC），值是它的 slug（`rp-moli`）。
+ *
+ * 为什么署 slug 而不署展示名：slug 是 harness 在派发那一刻盖的章（见 actor-trail.js），
+ * 展示名住在角色文件里、而那个文件模型能改。署名要能当证据用，就不能取自被署名者
+ * 自己写的文本。展示名由读侧按 slug 查出来（role-card.js），查不到就显示 slug 本身。
+ */
+
+import { callerOf, agentNameOf } from '../agent/actor-trail.js';
+import { isResidentRole, isSlotType, safeRoleLabel } from '../agent/cast.js';
+
+/** MCP handler 的 extra 里取本次 tool_use id（2026-08-26 实测就在这个键上） */
+export function toolUseIdOf(extra) {
+  return extra?._meta?.['claudecode/toolUseId'] || null;
+}
+
+/**
+ * 这次板上写入该署谁的名。
+ * @returns {'agent'|string}  主 agent → 'agent'；常驻角色 → 它的 slug
+ */
+export function byOf(extra) {
+  const caller = callerOf(toolUseIdOf(extra));
+  const type = caller?.agentType;
+  // 落到**演员位**（rp-actor/rp-narrator）说明盖章那一刻别名还没学到实例名。
+  // 这里**当场再解一次** —— 别名可能在盖章之后才学到（08-28 真会话实录：
+  // 19:59 派发、20:10 角色调 jot_memory 被拒、20:10 GM 一发 SendMessage 别名补上、
+  // 20:21 同一个工具就成了。差的就是"用盖章那一刻的快照"还是"用此刻的表"）。
+  if (isSlotType(type)) {
+    const nm = agentNameOf(caller?.agentId);
+    if (isResidentRole(nm) && !isSlotType(nm)) return nm;
+  }
+  return isResidentRole(type) ? type : 'agent';
+}
+
+/**
+ * 把一个 `by` 渲染成给**这个读者**看的称呼。
+ *
+ * read_board 的输出可能被主 agent 读，也可能被角色自己读 —— 同一句「你写的」对两个
+ * 读者含义相反。所以渲染要带视角：谁在读，就管谁叫「你」。
+ *
+ * @param by         板上那条东西的署名（'user' / 'agent' / 'rp-*'）
+ * @param viewer     当前读者（同上取值）
+ * @param names      slug → 展示名（只当展示层，见 role-card.listRoleNames）
+ */
+export function describeBy(by, viewer, names) {
+  if (by === viewer) return '你';
+  if (by === 'user') return '用户';
+  if (by === 'agent') return '主控';
+  return safeRoleLabel(by, names?.get?.(by));
+}
+
+/**
+ * 保留字的第二道防线。真正的闸在源头（`listRoleNames` 出口，见 cast.js
+ * `safeRoleLabel` 的注释）；这里留一层是给「名字没经过那条路」的调用点兜底。
+ */
+export { safeRoleLabel as roleLabel } from '../agent/cast.js';

package/server/engine/mcp/capability-gate.js

@@ -1,8 +1,12 @@
 /**
  * engine/mcp/capability-gate.js — 工具 × 本机能力位（runtime/capabilities.js）的唯一对照表 + 闸。
  *
- * 两种模式：
- *   - block：能力缺席时工具描述前缀「⛔ CURRENTLY UNAVAILABLE + 装法」（照 roll_film 的先例，agent 看到就不会调），
+ * 三种模式：
+ *   - unregister：能力缺席时**整件工具不注册**（连名字都不进模型上下文）。给那种
+ *            「缺了就完全没有替代路径、而且短期内不会回来」的工具用——站主的本地
+ *            GPU 盒子平时不开机，留着名字只会让 agent 反复去撞 SSH 拒连（08-24
+ *            信箱实证：paint_still 连撞两次，一次超时一次参数被拒才放弃）。
+ *   - block：能力缺席时工具描述前缀「⛔ CURRENTLY UNAVAILABLE + 装法」，
  *            真调了也在这里拦住，返回同一句话让它转告用户——不让裸的 ENOENT / 500 漏到 agent 面前
  *   - note ：工具仍可用，只在描述末尾加一句降级说明（build_docx 没有 LibreOffice 时仍能出文件，只是没页图）
  * 没探过（capabilityState 为 null：单测 / 脚本直接 import）→ 原样放行，这层不猜。
@@ -26,17 +30,32 @@ export const TOOL_CAPABILITIES = Object.freeze({
   web_search: { cap: 'webSearch', mode: 'block' },
   generate_image: { cap: 'imageGen', mode: 'block' },
   publish_site: { cap: 'publish', mode: 'block' },
+  // 站主自己的 5090 盒子（NODESIGN_LOCAL_BOX + NODESIGN_H3BOX_SSH）。盒子是手动
+  // 开关的，平时关着，所以用 unregister：不在线时连工具名都不给 agent 看见。
+  // 通用生图仍有 generate_image 顶着，不存在能力真空。
+  paint_still: { cap: 'localBox', mode: 'unregister' },
+  roll_film: { cap: 'localBox', mode: 'unregister' },
 });
 
 export function unavailableMessage(c) {
   return `本机缺 ${c.label}（${c.detail}）。装法：${c.fix}`;
 }
 
+/** 这件工具在当前能力状态下该不该注册（false = 连名字都不给） */
+export function shouldRegisterTool(toolDef) {
+  const spec = TOOL_CAPABILITIES[toolDef.name];
+  if (!spec || spec.mode !== 'unregister') return true;
+  const c = capabilityState(spec.cap);
+  // 没探过（单测 / 脚本直接 import）一律注册 —— 这层不猜，跟 withCapabilityGate 同纪律
+  return !c || c.available;
+}
+
 export function withCapabilityGate(toolDef) {
   const spec = TOOL_CAPABILITIES[toolDef.name];
   if (!spec) return toolDef;
   const c = capabilityState(spec.cap);
   if (!c || c.available) return toolDef;
+  // unregister 档走 shouldRegisterTool，走到这里说明调用方没过滤 —— 按 block 兜底
   const msg = unavailableMessage(c);
   if (spec.mode === 'note') {
     return { ...toolDef, description: `${toolDef.description}\n\n⚠️ ${msg} 本工具仍可用，但依赖它的步骤（页图/体检）会缺席。` };

package/server/engine/mcp/index.js

@@ -29,7 +29,9 @@
 
 import { createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
 import { withParamSanitizer } from './param-sanitizer.js';
-import { withCapabilityGate } from './capability-gate.js';
+import { withCapabilityGate, shouldRegisterTool } from './capability-gate.js';
+import { shouldRegisterForMode, assertModeProfileNames } from './mode-profile.js';
+import { MCP_SERVER_NAME } from './server-name.js';
 import { makeScreenshotCanvasTool } from './tools/screenshot.js';
 import { makeScreenshotUrlTool } from './tools/screenshot-url.js';
 import { makeExportHandoffTool } from './tools/export-handoff.js';
@@ -47,7 +49,7 @@ import {
 } from './tools/browse.js';
 import { makeBrowserScreenshotTool } from './tools/browse-screenshot.js';
 import { makeBrowserComputerTool } from './tools/browse-computer.js';
-import { makeBrowserFindTool, makeBrowserBatchTool } from './tools/browse-find-batch.js';
+import { makeBrowserFindTool, makeBrowserBatchTool, makeBatchTool } from './tools/browse-find-batch.js';
 import { makeArtifactOpenTool, makeArtifactComputerTool, makeArtifactFindTool, makeArtifactMotionTool, makeArtifactBatchTool } from './tools/artifact-session.js';
 import { makeGetComputedStylesTool } from './tools/get-computed-styles.js';
 import { makeNavigateToPageTool } from './tools/navigate-to-page.js';
@@ -60,13 +62,10 @@ import { makeClearPendingChangesTool } from './tools/clear-pending-changes.js';
 import { makeGenerateImageTool } from './tools/generate-image.js';
 import { makeRemoveBackgroundTool } from './tools/remove-background.js';
 import { makePinToBoardTool } from './tools/pin-to-board.js';
-import { makeRelateOnBoardTool } from './tools/relate-on-board.js';
+import { makeEditBoardTool } from './tools/edit-board.js';
 import { makeReadBoardTool } from './tools/read-board.js';
-import { makeArrangeOnBoardTool } from './tools/arrange-on-board.js';
-import { makeCreateOnBoardTool } from './tools/create-on-board.js';
-import { makeSketchOnBoardTool, makeFinishSketchTool } from './tools/sketch-on-board.js';
-import { makeEditSketchTool } from './tools/edit-sketch.js';
 import { makeWriteOnBoardTool } from './tools/write-on-board.js';
+import { makeOpenSheetTool } from './tools/open-sheet.js';
 import { makeLookAtBoardTool } from './tools/look-at-board.js';
 import { makeReadUserViewTool } from './tools/read-user-view.js';
 import { makeOrganizeBoardTool } from './tools/organize-board.js';
@@ -74,6 +73,12 @@ import { makeReadDocumentTool } from './tools/read-document.js';
 import { makeReadTavernJsonTool } from './tools/read-tavern-json.js';
 import { makeDeliverFilesTool } from './tools/deliver-files.js';
 import { makeCrystallizeSkillTool } from './tools/crystallize-skill.js';
+import { makeCastRoleTool } from './tools/cast-role.js';
+import { makeSetVarsTool } from './tools/set-vars.js';
+import { makeDrawTrendTool } from './tools/draw-trend.js';
+import { makeJotMemoryTool } from './tools/role-memory.js';
+import { makeRollDiceTool } from './tools/roll-dice.js';
+import { assertRoleToolsRegistered } from '../agent/cast.js';
 import { makePublishSiteTool } from './tools/publish-site.js';
 import { makeReportIssueTool } from './tools/report-issue.js';
 import { makeRollFilmTool } from './tools/roll-film.js';
@@ -127,12 +132,53 @@ const ALWAYS_LOAD_TOOLS = new Set([
   // 08-21 产物会话五件：成品检查的交互半边（状态跨调用留着）。artifact_batch 的卖点
   // "一趟跑完 + 结尾截图"和 live:true 的存在都只在描述里说，常驻。
   'artifact_open', 'artifact_computer', 'artifact_find', 'artifact_batch', 'artifact_motion',
+  // ⭐ 板面核心五件（2026-08-27 用户拍板「板书是基础交互方式」）：合计约 3.4k token
+  // 的描述量进缓存前缀，每轮增量趋零；换来的是 write 的件数判据/lane/ink、edit 的
+  // 18 个 op、batch 的按拍打包这些**只活在描述里的卖点**每回合都在场 —— 此前它们
+  // 全在 deferred 区，agent 只看得到名字，教义在 prelude 里教、schema 却要现搜。
+  // 膨胀由模式闸控：rp 模式 unregister 掉 artifact/量具族后常驻集自动收缩。
+  // read_user_view 不进：视口已经每回合自动进状态块，它降级成"看画面细节"的按需件。
+  // board_batch 2026-08-30 暂停（见下面注册处的注释），常驻表同步摘牌。
+  'write_on_board', 'edit_board', 'read_board', 'look_at_board',
+  // 纸范式（2026-08-29）：铺纸是板面工作的起手式，卖点全在描述里（当前纸/坐标原点/
+  // 排不下就拒收、翻页归 agent），必须常驻。
+  'open_sheet',
 ]);
 
-export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId, sessionId, ctx } = {}) {
+/**
+ * 常驻表的启动期对账（08-27 审计补）：跟 mode-profile 同病同药 —— 工具改名后
+ * 这张表的旧名字不会报错，只会让那件工具静默退回 deferred（agent 又只看得到名字）。
+ * 对照的是**过滤前**的全量名单：能力/模式闸下架某件时它照常在 builtTools 里。
+ */
+function assertAlwaysLoadNames(registeredNames) {
+  const have = new Set(registeredNames);
+  const ghosts = [...ALWAYS_LOAD_TOOLS].filter((n) => !have.has(n));
+  if (ghosts.length) {
+    throw new Error(`[always-load] 常驻表里有注册表不存在的名字: ${ghosts.join(', ')} —— 改名后表没跟上，这些条目在静默空转`);
+  }
+}
+
+/**
+ * 工具名 → 它真正收的参数名集合。装配时回填（见下），PreToolUse 的未知键探针读它。
+ * 全进程共享一份：同一份 schema 跟项目无关。
+ */
+export const TOOL_PARAM_KEYS = new Map();
+
+export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId, sessionId, ctx, roleRoster = null, projectMode = 'design' } = {}) {
   // 浏览通道里能被 browser_batch 串起来的七件：先建一次，batch 拿**同一批实例**
   // （projectId/ctx 绑在 handler 里，不能再造第二份）。只有 request_help 不进
   // batch（它阻塞等人）；capture 在里面 —— 逐页采 token 正是 batch 要省的那种回合。
+  // batch 的运行时解析表（2026-08-27 重置）：装配管线（能力闸/模式闸/消毒）跑完后
+  // 回填，三个 batch 的子调用一律取**包装后**的实例 —— 08-26「batch 绕闸」挂账在此清账。
+  const wrappedByName = new Map();
+  const resolveTool = (n) => wrappedByName.get(n);
+  const writeOnBoard = makeWriteOnBoardTool({ projectId, sharedRoot: workspaceRoot || sharedRoot, sessionId, ctx });
+  const boardBatchable = [
+    makeOpenSheetTool({ projectId, sessionId, ctx }),
+    writeOnBoard,
+    makeEditBoardTool({ projectId, sharedRoot, sessionId, ctx }),
+    makeReadBoardTool({ projectId, sharedRoot }),
+  ];
   const browseBatchable = [
     makeBrowserNavigateTool({ projectId, ctx }),
     makeBrowserReadTool({ projectId }),
@@ -159,7 +205,7 @@ export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId,
     // 自己的产物靠什么在动：跟 browser_capture motion 同一份引擎（engine/motion/inventory.js）
     makeArtifactMotionTool({ projectId, workspaceRoot, sessionId }),
   ];
-  const tools = [
+  const builtTools = [
       // C9 screenshot_canvas — playwright headless 截图 → image content block
       screenshotCanvas,
 
@@ -181,6 +227,16 @@ export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId,
       // C10 export_handoff — 复用 exports.js 的 buildHandoffZip，写到 workspace/exports/
       makeExportHandoffTool({ workspaceRoot, sharedRoot, projectId, sessionId, ctx }),
 
+      // cast_role — 写一张角色卡并登记名字（2026-08-26 建，08-29 简化）。
+      // 卡是数据，身体是预注册的角色位；写完当回合就能派，之后靠 SendMessage 叫醒。
+      makeCastRoleTool({ workspaceRoot, sessionId, ctx, roster: roleRoster }),
+      makeSetVarsTool({ projectId, sharedRoot: workspaceRoot || sharedRoot }),
+      makeDrawTrendTool({ projectId, sharedRoot: workspaceRoot || sharedRoot, sessionId, ctx }),
+      makeJotMemoryTool({ workspaceRoot }),
+      // roll_dice — 服务端真随机骰（08-28 沉浸感机制刀①）：模型编的骰运不可信，
+      // 这把走 crypto + run.dice 事件直达用户屏幕。GM only（不进角色白名单）。
+      makeRollDiceTool({ projectId, ctx }),
+
       // crystallize_skill — 把探索出来的方法论固化成用户自己的 skill + 作品进橱窗
       // （2026-07-30）。用户明确要求才调；写的是判断依据不是成品 HTML。
       makeCrystallizeSkillTool({ projectId, sessionId, ctx }),
@@ -255,12 +311,12 @@ export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId,
       // 或者第二个常驻名额；1 vCPU 上后者不成立。
       ...browseBatchable,
       // 一次往返跑一串（串行、遇错即停、结尾补截图）—— 省的是模型回合数
-      makeBrowserBatchTool({ tools: browseBatchable }),
+      makeBrowserBatchTool({ tools: browseBatchable, resolve: resolveTool }),
       // ── 产物会话（2026-08-21）：成品检查的交互半边 ──
       // artifact_open 把产物开进常驻会话，artifact_computer/find 对着它点、敲、找；
       // 五个量具 live:true 就量会话里现在这一页；artifact_batch 一趟跑一串。
       ...artifactSessionTools,
-      makeArtifactBatchTool({ tools: [...artifactSessionTools, screenshotCanvas, queryElements, getComputedStyles, explainStyle, traceMotion] }),
+      makeArtifactBatchTool({ tools: [...artifactSessionTools, screenshotCanvas, queryElements, getComputedStyles, explainStyle, traceMotion], resolve: resolveTool }),
       // 撞验证墙时举手叫人（阻塞等，默认 120 秒超时 —— 人可能就走了）
       makeBrowserRequestHelpTool({ projectId, ctx }),
       getComputedStyles,
@@ -292,29 +348,49 @@ export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId,
 
       // 工作台分区画布（2026-07-27）：agent 协助摆放 —— 把产物/文档/deck 钉进
       // 某 session 的工作区。写 board.json（board-store 单锁）+ 广播 board.updated。
-      makePinToBoardTool({ sharedRoot, projectId, ctx }),
+      makePinToBoardTool({ sharedRoot, projectId, sessionId, ctx }),
 
       // 关系线（2026-08-07）：agent 把「这版改自那版」「这两个是对照」这类
       // **只有它知道**的关系画到画布上。画布知道每个产物是什么，但不知道它们
       // 之间是什么关系 —— 那是北极星（排出有版面感的布局）真正缺的那一块。
-      makeRelateOnBoardTool({ sharedRoot, projectId, ctx }),
-      // agent 摆位四件（2026-08-14）：看版面 / 语义摆位·立主角 / 落手写便签 / 归纳收纳
-      makeReadBoardTool({ projectId }),
-      makeArrangeOnBoardTool({ projectId, ctx }),
-      makeCreateOnBoardTool({ projectId, ctx }),
+      // 黑板核心三件（08-25 范式重做，08-28 别名收摊）：写=write_on_board（件数
+      // 判据分流一句话/一张图，ink:'hand' 收编旧 create），改=edit_board（吞
+      // arrange/finish/relate/edit_sketch），看=read_board。board_batch 用
+      // **同一批实例**串行跑（一章 RP 的板面维护八次往返收成一次）。
+      ...boardBatchable,
+      // board_batch 暂停（2026-08-30 用户拍板）：batch 适合语法机械、单步几乎不会
+      // 语义性失败的家族（浏览器/产物检查照旧），板面动作不是 —— 拒收/容量/引用
+      // 都是单步就可能断的语义闸。真会话对账：batch 内每动作失败 16.1% vs 单调用
+      // 9.1%，另有 9.4% 好动作被连坐；今天 glm 一场 board_batch 0/6 全败，sonnet
+      // 同一张卡几乎不用 batch 反而顺。是暂停不是拆除：makeBatchTool/流式预知/
+      // beat-gate/角色白名单里的 batch 支路全保留原样，恢复 = git 翻回这一块注册
+      // （git log -S board_batch -- server/engine/mcp/index.js）+ 常驻表加回名字
+      // + prelude/SKILL 把"攒一车"的教学翻回来。
       makeOrganizeBoardTool({ projectId, ctx }),
-      // 黑板（2026-08-23）：一次落一整张草图 / 落定或擦掉 / 看一眼 / 用户在看哪
-      makeSketchOnBoardTool({ projectId, ctx }),
-      makeFinishSketchTool({ projectId, ctx }),
-      makeEditSketchTool({ projectId, ctx }),
-      makeWriteOnBoardTool({ projectId, sharedRoot: workspaceRoot || sharedRoot, sessionId, ctx }),
       makeLookAtBoardTool({ projectId, ctx }),
       makeReadUserViewTool({ projectId }),
 
       // 注：Phase Image-2 的 request_image_approval 工具已废弃（2026-05-06）。
       // generate_image 的 CallToolResult 已返 image content block，前端自动渲染；
       // agent 在 caption / 自然回话邀请反馈，下一轮用户 chat 即天然 gate。
-  ].map((t) => (
+  ];
+
+  // 模式对照表的启动期对账（2026-08-27）：必须对**过滤前**的全量名单 —— 表校验的
+  // 对象是「注册表里有没有这个名字」，跟本机能力/项目模式无关。工具改名后表没跟上
+  // 时这里当场炸，不让下架条目静默空转（判据本身要先验一遍）。
+  assertModeProfileNames(builtTools.map((t) => t.name));
+  assertAlwaysLoadNames(builtTools.map((t) => t.name));
+
+  const tools = builtTools.filter((t) => (
+    // 本机能力缺席且该工具是 unregister 档 → 整件不注册（连名字都不进上下文）。
+    // 现在只有本地 GPU 盒子那两件：盒子手动开关，关着时留名字只会让 agent 去撞
+    // SSH 拒连。对照表在 capability-gate.js 一份。
+    shouldRegisterTool(t)
+  )).filter((t) => (
+    // 项目模式闸（2026-08-27）：rp 项目下架设计产线（deck/站点/交付/产物量具），
+    // 同样是 unregister 语义。对照表在 mode-profile.js 一份，下面还有启动期对账。
+    shouldRegisterForMode(t, projectMode)
+  )).map((t) => (
     // SDK 用 _meta['anthropic/alwaysLoad'] 标记常驻（tool() 第 5 参的等价物，
     // 集中在这打标避免改 16 个工具文件）
     ALWAYS_LOAD_TOOLS.has(t.name)
@@ -331,8 +407,24 @@ export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId,
     withParamSanitizer(t, { projectId, sessionId })
   ));
 
+  // batch 解析表回填：此刻 tools 里的实例已过完 能力闸/模式闸/alwaysLoad/消毒 全套
+  for (const t of tools) wrappedByName.set(t.name, t);
+  // 参数名台账（2026-08-30）：给 PreToolUse 的未知键探针用。SDK 在进 handler
+  // 之前就按 schema 把未知键 strip 掉了（zod object 默认行为，不报错），所以
+  // 工具自己**永远看不见**模型多传了什么 —— 真会话里 write_on_board 被塞过 20 次
+  // `facts`（整份剧情事实），一次都没留下痕迹。只有钩子拿得到原始 tool_input。
+  for (const t of tools) TOOL_PARAM_KEYS.set(t.name, new Set(Object.keys(t.inputSchema || {})));
+
+  // 角色工具白名单的启动期对账（2026-08-26）：cast_role 会把白名单里的短名写进
+  // 角色文件的 frontmatter，名字写错**不会报错**，只会让角色少一只手（CLI 当那个
+  // 工具不存在）。所以对着真实注册表核一遍，错了当场炸在启动期。
+  assertRoleToolsRegistered(new Set(tools.map((t) => t.name)));
+
+
   const server = createSdkMcpServer({
-    name: 'nodesign',
+    // 名字收在 mcp/server-name.js：它同时是 session-loop 里 mcpServers 的键
+    // （决定模型看到的 mcp__nodesign__* 前缀）和 isolation.js 那条 allow 规则要匹配的名
+    name: MCP_SERVER_NAME,
     version: '0.1.0',
     tools,
   });

package/server/engine/mcp/mode-profile.js

@@ -0,0 +1,139 @@
+/**
+ * engine/mcp/mode-profile.js — 项目模式 × 工具面的唯一对照表 + 闸（2026-08-27）。
+ *
+ * 项目分两种模式（projects.mode，真相源在 projects/store.js）：
+ *   - design：设计工作台（现状默认）。工具面不动 —— 含全部 RP 工具，因为存量的
+ *     演出全发生在 design 项目里，在这里藏 RP 工具等于把它们全断掉。等演出模式
+ *     转正、真会话都迁过去之后，再考虑反向裁剪。
+ *   - rp：演出（常驻角色演故事）。下架设计产线 —— 不是防误用那么简单：工具名
+ *     进上下文就是注意力，prelude 的设计教义也按同一模式剥（system-prompts.js
+ *     的 nd:mode 分区）。两边共用画布/黑板/会话/精灵全部基础设施。
+ *
+ * 跟 capability-gate.js 的关系：同一个注册期 filter 位置、不同判据 ——
+ * 那边按「本机能力在不在」，这边按「这个项目在演哪种戏」。都是 unregister 语义
+ * （连名字都不给模型看见），先后串联，谁说不注册都不注册。
+ *
+ * ⚠️ 改这张表必须跑 assertModeProfileNames（mcp/index.js 启动期已挂）：
+ * 表里的名字对不上真实注册名时它当场炸 —— 不然一次工具改名就让这里静默空转，
+ * 「配置读数 ≠ 真在生效」这条线上已经栽过太多次。
+ */
+
+/**
+ * rp 模式下整件不注册的工具。按产线分组 —— 拆的时候用户按功能拍的板
+ * （2026-08-27：「文档站点应用都移除，生图黑板精灵和浏览器感知留下」）。
+ */
+export const RP_HIDDEN_TOOLS = Object.freeze(new Set([
+  // deck / 文档产线
+  'build_docx', 'preview_deck', 'read_page', 'list_pages',
+  // 站点发布
+  'publish_site',
+  // 设计交付与方法论结晶
+  'export_handoff', 'crystallize_skill',
+  // ⚠️ get_pending_changes / clear_pending_changes **不在此列**：DirectEdit 是用户
+  // 输入通道（圈图说事 / 双击改字），不是设计产线 —— rp 项目里也得能收用户的圈注。
+  // HTML 产物量具（板的眼睛是 look_at_board / read_user_view，不在此列）
+  'screenshot_canvas', 'query_elements', 'get_computed_styles', 'explain_style',
+  'profile_scroll', 'trace_motion',
+  // 产物会话五量具
+  'artifact_open', 'artifact_computer', 'artifact_find', 'artifact_motion', 'artifact_batch',
+]));
+
+/** 这件工具在该模式下该不该注册（false = 连名字都不给） */
+export function shouldRegisterForMode(toolDef, mode) {
+  if (mode !== 'rp') return true;
+  return !RP_HIDDEN_TOOLS.has(toolDef.name);
+}
+
+/**
+ * 启动期对账：表里每个名字必须真实存在于注册表。
+ * @param {string[]} registeredNames design 模式（全量）下的注册名单
+ * @throws 表里出现注册表没有的名字（改名 / 删除后表没跟上）
+ */
+export function assertModeProfileNames(registeredNames) {
+  const have = new Set(registeredNames);
+  const ghosts = [...RP_HIDDEN_TOOLS].filter((n) => !have.has(n));
+  if (ghosts.length) {
+    throw new Error(
+      `[mode-profile] RP_HIDDEN_TOOLS 里有注册表不存在的名字: ${ghosts.join(', ')} `
+      + '—— 工具改名或下线后对照表没跟上，这些条目在静默空转',
+    );
+  }
+}
+
+/**
+ * skill × 模式（2026-08-30）。跟上面那张表同一个语义，另一个载体。
+ *
+ * ## 为什么 skill 也要按模式筛
+ *
+ * `session-loop.js` 把 `installed.skills` 整个交给 SDK，而 SDK **只把 description
+ * 注进系统提示词**（body 才是按需加载，见 agent/skill.js 头注）。所以每装一个 skill，
+ * 它那几百字节的描述就在**每一个会话**里常驻 —— 不分模式。
+ *
+ * 实测（08-30）：RP 会话现在背着 deskskill-engine-mini(562B) / docx-craft(1123B) /
+ * site-craft(782B) 三份描述，合计 ~2.4KB，而这三个 skill 要用的工具
+ * （`build_docx` / `publish_site` / `preview_deck`）在 RP 模式下**根本没注册**
+ * ——上面那张 RP_HIDDEN_TOOLS 已经把它们摘掉了。工具没了描述还在，是纯亏。
+ * 反过来同理：演出侧的文风/技法包不该压在设计会话的常驻区里。
+ *
+ * ## 判据
+ *
+ * 表里没有的名字**一律放行** —— 用户自己装的 plugin（用户级 / 项目级）不归我们裁，
+ * 只管内置这几个。这条别改成白名单：那会让用户装的 skill 静默消失，
+ * 而「静默消失」是这条线上最难查的一类。
+ */
+export const SKILL_MODES = Object.freeze({
+  // 设计产线：工具在 RP 下已下架，描述跟着走
+  'deskskill-engine-mini': 'design',
+  'docx-craft': 'design',
+  'site-craft': 'design',
+  // 演出侧
+  'story-voice': 'rp',
+  'story-craft': 'rp',
+  'story-intimacy': 'rp',
+  // 两边都要：轻度演故事发生在设计项目里（prelude 设计区明写这条路），
+  // 而酒馆卡也常常被丢进设计项目
+  'blackboard-rp': 'both',
+  'story-import': 'both',
+});
+
+/** 按模式筛 skill 名单。表里没有的一律保留（用户装的不归我们裁）。 */
+export function filterSkillsForMode(names, mode) {
+  const want = mode === 'rp' ? 'rp' : 'design';
+  return (Array.isArray(names) ? names : []).filter((n) => {
+    const m = SKILL_MODES[n];
+    return !m || m === 'both' || m === want;
+  });
+}
+
+/**
+ * 启动期对账：表里每个名字必须真的装着。
+ * 跟 assertModeProfileNames 同样的狠法 —— skill 改名/下线后表没跟上就是静默空转。
+ * @param {string[]} installedNames 本次会话实际装上的 skill 名单
+ */
+export function assertSkillModeNames(installedNames) {
+  const have = new Set(installedNames || []);
+  const ghosts = Object.keys(SKILL_MODES).filter((n) => !have.has(n));
+  if (ghosts.length) {
+    throw new Error(
+      `[mode-profile] SKILL_MODES 里有没装上的 skill: ${ghosts.join(', ')} `
+      + '—— skill 改名或下线后对照表没跟上，这些条目在静默空转',
+    );
+  }
+}
+
+/**
+ * skill 按模式筛的总入口（08-30；从 session-loop 拆来 —— 行数棘轮）。
+ * SDK 只把 description 注进系统提示词（body 按需加载），所以每个 skill 的几百字节
+ * 描述是**每个会话**的常驻成本，不分模式。筛之前 RP 会话背着设计三件
+ * （deskskill/docx/site 合计 ~2.4KB）的描述，而它们要用的工具在 RP 下压根没注册。
+ * 对账跟 assertModeProfileNames 一样狠：表里的名字没装上就当场炸，别静默空转。
+ */
+export function modeSkillsFor(installedNames, mode) {
+  assertSkillModeNames(installedNames);
+  const out = filterSkillsForMode(installedNames, mode);
+  if (out.length !== installedNames.length) {
+    const dropped = installedNames.filter((n) => !out.includes(n));
+    console.log(`[session-loop] skills 按 mode=${mode} 筛掉 ${dropped.length}: [${dropped.join(', ')}]`);
+  }
+  return out;
+}