@xiaobuyu/nodesign 0.0.6 → 0.0.8

package/server/engine/mcp/index.js

@@ -10,7 +10,7 @@
  *   反馈层（用户在 canvas 上的直接编辑 + 评论 buffer）：
  *     get_pending_changes / clear_pending_changes
  *   产物层（NoDesign 差异化能力）：
- *     expose_tweaks / export_handoff / record_decision
+ *     export_handoff …（expose_tweaks 08-24 暂退役待升级；record_decision 08-24 拆除，记忆体系接棒）
  *   研究层：
  *     web_search（4 provider，CJK auto baidu）
  *
@@ -29,11 +29,12 @@
 
 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';
-import { makeRecordDecisionTool } from './tools/record-decision.js';
 import { makeWebSearchTool } from './tools/web-search.js';
 import { withTierGate } from './tools/tier-gate.js';   // 档位闸包装器（auth/tier.js；按项目 owner）
 import { makeReadPageTool } from './tools/read-page.js';
@@ -48,26 +49,23 @@ 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';
 import { makeHighlightTool } from './tools/highlight.js';
 import { makePreviewDeckTool } from './tools/preview-deck.js';
 import { makeBuildDocxTool } from './tools/build-docx.js';
-import { makeExposeTweaksTool } from './tools/expose-tweaks.js';
+// expose-tweaks 08-24 暂退役（能力不足待升级再加回）：本体与前端 TweaksPanel 留档休眠，不注册
 import { makeGetPendingChangesTool } from './tools/get-pending-changes.js';
 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';
@@ -75,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';
@@ -103,7 +107,7 @@ import { makeLookupTagsTool } from './tools/lookup-tags.js';
 const ALWAYS_LOAD_TOOLS = new Set([
   'screenshot_canvas', 'read_page', 'list_pages', 'query_elements',
   'get_computed_styles', 'navigate_to_page', 'highlight', 'preview_deck',
-  'record_decision', 'get_pending_changes', 'clear_pending_changes',
+  'get_pending_changes', 'clear_pending_changes',
   // screenshot_url 常驻：explorer 显式 tools 列表没有 ToolSearch，defer 了它就
   // 永远拉不到 schema；schema 本身很小（4 字段），常驻成本可忽略
   'screenshot_url',
@@ -128,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 }),
@@ -160,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,
 
@@ -182,8 +227,15 @@ export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId,
       // C10 export_handoff — 复用 exports.js 的 buildHandoffZip，写到 workspace/exports/
       makeExportHandoffTool({ workspaceRoot, sharedRoot, projectId, sessionId, ctx }),
 
-      // C11 record_decision — 写入 spec.json decisions[] 设计意图档案
-      makeRecordDecisionTool({ workspaceRoot, 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。
@@ -259,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,
@@ -284,9 +336,6 @@ export function createNodesignMcpServer({ workspaceRoot, sharedRoot, projectId,
       makeGetPendingChangesTool({ workspaceRoot, ctx }),
       makeClearPendingChangesTool({ workspaceRoot, ctx }),
 
-      // Tweaks 协议：agent 暴露 deck 专属可调参数 schema → 前端按 schema 渲染控件
-      makeExposeTweaksTool({ workspaceRoot, ctx }),
-
       // 图片生成（gemini-3.1-flash-image-preview / Nano Banana 2，via NoDesk passthrough）
       // 落档优先 sharedRoot/assets/generated/，fallback workspaceRoot/assets/generated/。
       // 跨 session 共享靠 sessions/<sid>/assets softlink → shared/assets。
@@ -299,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({ 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)
@@ -338,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;
+}

package/server/engine/mcp/server-name.js

@@ -0,0 +1,19 @@
+/**
+ * mcp/server-name.js —— MCP 服务名的唯一真相源（2026-08-25）
+ *
+ * 这个名字有两个读者，而且**改错了不会报错，只会静默失效**：
+ *   1. session-loop.js 的 `mcpServers: { [MCP_SERVER_NAME]: server }` —— 决定
+ *      工具在模型眼里叫 `mcp__<名>__<工具>`
+ *   2. isolation.js 的 `permissions.allow: ['mcp__<名>']` —— 决定这些工具跳不跳
+ *      auto 模式分类器
+ * 两处对不上时：工具照常能用，只是每一次调用又开始过分类器，没有任何报错。
+ * 所以名字收在这里一份，两边都 import，并由 isolation.test.js 钉住。
+ *
+ * 单独一个文件而不是挂在 mcp/index.js：isolation.js 只要这一个字符串，
+ * 不该为此把整棵工具树（连带 DB 模块）拖进来。
+ */
+
+export const MCP_SERVER_NAME = 'nodesign';
+
+/** 给 permissions.allow 用的整服务放行规则 */
+export const MCP_ALLOW_RULE = `mcp__${MCP_SERVER_NAME}`;

package/server/engine/mcp/tools/artifact-session.js

@@ -257,11 +257,12 @@ export const ARTIFACT_BATCHABLE = [
   'screenshot_canvas', 'trace_motion', 'get_computed_styles', 'explain_style', 'query_elements',
 ];
 
-export function makeArtifactBatchTool({ tools }) {
+export function makeArtifactBatchTool({ tools, resolve = null }) {
   const names = ARTIFACT_BATCHABLE.filter(n => tools.some(t => t.name === n));
   return makeBatchTool({
     name: 'artifact_batch',
     tools,
+    resolve,
     batchable: ARTIFACT_BATCHABLE,
     finalShot: { name: 'artifact_computer', input: { action: 'screenshot' } },
     description: `Run several artifact-session steps in ONE round trip: open → click → type →

package/server/engine/mcp/tools/browse-computer.js

@@ -179,7 +179,8 @@ async function zoomShot(page, region, frame, lead) {
   }
   const [x0, y0, x1, y1] = region.map(Math.round);
   if (x0 < 0 || y0 < 0 || x1 > frame.w || y1 > frame.h || x1 - x0 < 8 || y1 - y0 < 8) {
-    return asText(`Error: zoom region [${region.join(', ')}] must lie inside the ${frame.w}×${frame.h} screenshot and be at least 8×8.`, true);
+    return asText(`Error: zoom region [${region.join(', ')}] must lie inside the ${frame.w}×${frame.h} LIVE VIEWPORT and be at least 8×8. `
+      + 'zoom takes viewport pixels — coordinates from a fullPage screenshot are in page space and do NOT work here; scroll the target into view first, or subtract the scroll offset.', true);
   }
   const clip = { x: toPage(x0, frame), y: toPage(y0, frame), width: toPage(x1 - x0, frame), height: toPage(y1 - y0, frame) };
   const buf = await page.screenshot({ type: 'png', clip });

package/server/engine/mcp/tools/browse-find-batch.js

@@ -85,41 +85,102 @@ as an error telling you to find again.`,
  * @param {string[]} o.batchable     允许的名字
  * @param {{name:string, input:object}} [o.finalShot]   结尾补的那张"当前状态"；不传就不补
  */
-export function makeBatchTool({ name, description, tools, batchable, finalShot }) {
+export function makeBatchTool({ name, description, tools = [], batchable, resolve = null, finalShot }) {
+  // resolve（2026-08-27 重置，清 08-26 那条「batch 绕闸」挂账）：传了它，子工具在
+  // **运行时**从装配完成后的注册表取（index.js 在包装管线跑完后回填 wrappedByName），
+  // 能力闸 / 参数消毒 / 模式过滤对 batch 内的调用照常生效。batchable 仍是**政策名单**
+  // （哪些名字许进 batch）；resolve 查不到 = 这台机器/该模式把它下架了，如实报。
+  // 不传 resolve 走旧的实例表（单测直连用 —— 但生产装配一律传 resolve）。
   const byName = new Map(tools.filter(t => batchable.includes(t.name)).map(t => [t.name, t]));
-  const names = [...byName.keys()];
+  const lookup = (n) => (resolve ? (batchable.includes(n) ? resolve(n) : undefined) : byName.get(n));
+  const names = resolve ? [...batchable] : [...byName.keys()];
+  const shotDefault = finalShot ? finalShot.default !== false : false;
   return tool(
     name,
     description,
     {
-      actions: z.array(z.object({
+      // looseObject（2026-08-29）：**放错层的参数不许静默消失**。模型很自然会写
+      // {name, chain:true, input:{…}} —— chain 是 write_on_board 的参数，写在了
+      // action 这一层。z.object 默认剥掉未知键，于是那一步照跑、只是丢了半个意图
+      // （真会话 proj_mtdr2xpa：两章的 chain:true 都这么没的，章节不接线程、
+      // 落到兜底位，正文列当场散架，用户看到的是"摆位乱了"）。收下它们，在
+      // handler 里按子工具的 schema 归位，并如实报一句。
+      actions: z.array(z.looseObject({
         name: z.string().describe(`Tool name: one of ${names.join(' | ')}.`),
-        input: z.record(z.string(), z.unknown()).optional().describe("That tool's input, same shape as calling it directly."),
+        input: z.record(z.string(), z.unknown()).optional().describe("That tool's input, same shape as calling it directly. Put the tool's OWN parameters in here — a parameter written beside `name` instead of inside `input` is folded in for you and reported."),
       })).min(1).max(MAX_ITEMS)
         .describe(`1-${MAX_ITEMS} items, run in order. Each item: {"name": <tool>, "input": {...}}.`),
-      screenshotAfter: z.boolean().optional()
-        .describe('Append a screenshot of the resulting state at the end (default true). Set false for text-only sequences to save tokens.'),
+      // 没有 finalShot 就不放这个参数 —— 写一个永远无效的旋钮是在骗模型
+      ...(finalShot ? { screenshotAfter: z.boolean().optional()
+        .describe(shotDefault
+          ? 'Append a look at the resulting state at the end (default true). Set false for text-only sequences to save tokens.'
+          : 'Pass true to append a look at the resulting state at the end (default false — most board upkeep is text work; ask for eyes when looks matter).') } : {}),
     },
     async ({ actions, screenshotAfter }, extra) => {
       const out = [];
       const n = actions.length;
       let failedAt = -1;
+      let failText = '';
       let lastHadImage = false;
+      let shotLifted = false;
       for (let i = 0; i < n; i += 1) {
-        const { name: toolName, input } = actions[i];
+        const { name: toolName, input, ...stray } = actions[i];
         const label = `[${i + 1}/${n}] ${toolName}${input?.action ? ` ${input.action}` : ''}`;
         if (failedAt >= 0) { out.push({ type: 'text', text: `${label}: ${HALT_TEXT}` }); continue; }
-        const def = byName.get(toolName);
+        const def = lookup(toolName);
         if (!def) {
           failedAt = i;
-          out.push({ type: 'text', text: `${label}: Error: "${toolName}" is not batchable here (use one of ${names.join(', ')}).` });
+          failText = batchable.includes(toolName)
+            ? `"${toolName}" 在这台机器/该项目模式下没有注册（能力或模式闸下架了它）——这一步换别的路。`
+            : `"${toolName}" is not batchable here (use one of ${names.join(', ')}).`;
+          out.push({ type: 'text', text: `${label}: Error: ${failText}` });
           continue;
         }
-        const parsed = z.object(def.inputSchema).safeParse(input || {});
+        // 归位（08-29）：action 这一层的多余键按子工具的 schema 收进 input；
+        // screenshotAfter 是 batch 自己的旋钮，抬到 batch 层。都如实报 —— 静默
+        // 修正会让下一次还写错，静默丢弃会让这一次就出错。
+        let folded = input || {};
+        const notes = [];
+        const own = new Set(Object.keys(def.inputSchema || {}));
+        const strayKeys = Object.keys(stray);
+        if (strayKeys.length) {
+          const patch = {};
+          for (const k of strayKeys) {
+            if (k === 'screenshotAfter') { shotLifted = shotLifted || stray[k] === true; notes.push('screenshotAfter 是整批的旋钮，已抬到 batch 层'); continue; }
+            if (own.has(k) && !(k in folded)) { patch[k] = stray[k]; continue; }
+            notes.push(`${k} 不是 ${toolName} 的参数，忽略了`);
+          }
+          if (Object.keys(patch).length) {
+            folded = { ...folded, ...patch };
+            notes.push(`${Object.keys(patch).join('/')} 本该写在 input 里（已收进去，下次直接写 input 内）`);
+          }
+        }
+        // 双层信封（2026-08-30）：{"input":{"input":{…},"op":"x"}} 真实发生过 ——
+        // 模型要拼两级嵌套，多包一层不出声。里层不是这个工具的参数、而里面的键是，
+        // 就摊平上来。
+        if (!own.has('input') && folded.input && typeof folded.input === 'object' && !Array.isArray(folded.input)) {
+          const inner = folded.input;
+          if (Object.keys(inner).some((k) => own.has(k))) {
+            const { input: _drop, ...rest } = folded;
+            folded = { ...inner, ...rest };
+            notes.push('input 里又套了一层 input，已摊平（下次一层就够）');
+          }
+        }
+        // ⛔ input **内部**的未知键：z.object 静默 strip，不报错不留痕。08-29 那把
+        // looseObject 只盖住了写在 name 旁边的（action 这一层），差一层没盖到 ——
+        // 真会话里 write_on_board 收到过整份 `facts`（一长串剧情事实），一个字没落、
+        // 一句话没报。归不了位就点名，别静默丢。
+        const unknownIn = Object.keys(folded).filter((k) => !own.has(k));
+        if (unknownIn.length) {
+          notes.push(`⛔ ${unknownIn.join('/')} 不是 ${toolName} 的参数，这次**整个丢掉了**（内容没落盘）`
+            + `—— ${toolName} 收的是：${[...own].join('/')}`);
+        }
+        const parsed = z.object(def.inputSchema).safeParse(folded);
         if (!parsed.success) {
           failedAt = i;
           const why = parsed.error.issues.map(is => `${is.path.join('.') || '(root)'}: ${is.message}`).join('; ');
-          out.push({ type: 'text', text: `${label}: Error: invalid input — ${why}` });
+          failText = `invalid input — ${why}`;
+          out.push({ type: 'text', text: `${label}: Error: ${failText}` });
           continue;
         }
         let r;
@@ -131,14 +192,31 @@ export function makeBatchTool({ name, description, tools, batchable, finalShot }
         // 第一块文本前面挂上 [i/n] 标签；没有文本块（纯图）就补一行标签再放图
         if (!blocks.some(b => b.type === 'text')) out.push({ type: 'text', text: `${label}: done` });
         let prefixed = false;
+        const tail = notes.length ? `\n⚠ ${notes.join('；')}` : '';
         for (const b of blocks) {
-          if (b.type === 'text' && !prefixed) { out.push({ type: 'text', text: `${label}: ${b.text}` }); prefixed = true; }
+          if (b.type === 'text' && !prefixed) { out.push({ type: 'text', text: `${label}: ${b.text}${tail}` }); prefixed = true; }
           else out.push(b);
         }
-        if (r?.isError) failedAt = i;
+        if (!prefixed && tail) out.push({ type: 'text', text: `${label}:${tail}` });
+        if (r?.isError) {
+          failedAt = i;
+          failText = blocks.find(b => b.type === 'text')?.text || '(no error text)';
+        }
+      }
+      // 失败时把错误行提到最前面：下游（记账层截 120/500 字符、模型扫返回）都先看到
+      // 真正的报错，而不是前面成功步骤的输出。同时钉死"别整批重跑"——前面的步骤
+      // （click/type 这类非幂等动作）已经执行过了。
+      if (failedAt >= 0) {
+        const step = actions[failedAt];
+        out.unshift({
+          type: 'text',
+          text: `FAILED at step ${failedAt + 1}/${n} (${step.name}${step.input?.action ? ` ${step.input.action}` : ''}): ${String(failText).split('\n')[0]}\n`
+            + `Steps 1-${failedAt} already ran — do NOT re-run the whole batch; continue from the failed step.`,
+        });
       }
-      if (finalShot && screenshotAfter !== false && !lastHadImage) {
-        const shotDef = byName.get(finalShot.name);
+      const wantShot = screenshotAfter === undefined ? (shotLifted || shotDefault) : screenshotAfter;
+      if (finalShot && wantShot && !lastHadImage) {
+        const shotDef = lookup(finalShot.name);
         if (shotDef) {
           try {
             const s = await shotDef.handler(finalShot.input || {}, extra);
@@ -154,11 +232,12 @@ export function makeBatchTool({ name, description, tools, batchable, finalShot }
   );
 }
 
-export function makeBrowserBatchTool({ tools }) {
+export function makeBrowserBatchTool({ tools, resolve = null }) {
   const names = BATCHABLE.filter(n => tools.some(t => t.name === n));
   return makeBatchTool({
     name: 'browser_batch',
     tools,
+    resolve,
     batchable: BATCHABLE,
     finalShot: { name: 'browser_screenshot', input: {} },
     description: `Run a sequence of browser tool calls in ONE round trip. Each item is