@xiaobuyu/nodesign 0.0.6 → 0.0.8

package/server/engine/agent/prompts/tools/direct-edit-protocol.md

@@ -53,7 +53,7 @@
     **`linkedToEditId` follow-up comment 的优先级最高**：用户填了"重排 OK" / "保持完全不动" 等明确指令，按 comment 来。没填走默认（你自己判断"尽量不动"）
 - **pending-style** —— 按 `styleDelta` 改 inline style 或对应 Tailwind class（如 styleDelta.marginLeft 改 `ml-*`）。
   - **自由模式（free position）—— 最小改动原则**：
-    - `styleDelta` 只含 `{position:'absolute', left, top}` —— 这是用户的真实意图（落位）
+    - `styleDelta` 只含 `{position:'absolute', left, top}` —— 这是用户的真实意图（他把东西摆到了哪里）
     - **不要无脑写整个 source 的样式**。默认只改这 3 个定位字段，**保留 source 原本的 CSS class 行为**（响应式、flex/grid 分配的尺寸、margin、transform 等）
     - 看 `aiContext.parentNeedsRelative` —— true 时把 `parentAnchor` 父元素加 `position:relative`
     - **`aiContext.preDragLayout` 是关键决策上下文**——source 拖前的 computed style 快照，让你判断是否需要追加补救：

package/server/engine/agent/prompts/tools/generate-image-cookbook.md

@@ -4,10 +4,9 @@
 > 注入，每 session 只注一次。SKILL.md 已含精简版核心要点，本文是深度参考。
 >
 > ⚠️ Gemini gateway 时代的参数段（imageSize / thinkingLevel / model 路由 flash-pro /
-> Image Search Grounding / PDF 文档输入 / NB2 model card 失败模式）**已整体移出本文**，
-> 存在同目录 `generate-image-cookbook.gemini-gateway.md`，不再注入。那些旋钮在当前
-> 后端上传了不报错也没效果，留在这里只会让你花心思拨一个不存在的开关。
-> `NODESIGN_IMAGE_PROVIDER=gateway` 重开时再把那份取回来。
+> Image Search Grounding / PDF 文档输入 / NB2 model card 失败模式）**已整体移出本文**
+> （那份存档 08-24 已删：全仓无引用的孤儿文件；要复活 gateway 从 git 历史里捞）。
+> 那些旋钮在当前后端上传了不报错也没效果，留在这里只会让你花心思拨一个不存在的开关。
 
 ## 前置 · 后端事实 —— 先读这节，它决定下面所有写法
 
@@ -44,7 +43,7 @@
 
 | 主体 | 来源 | 触发动作 |
 |---|---|---|
-| 用户上传素材（`assets/*.png\|jpg`）| 直接用 | 把路径喂 `referenceImages[]` |
+| 用户上传素材（`用户内容/*.png\|jpg`，老项目在 `assets/`）| 直接用 | 把路径喂 `referenceImages[]` |
 | 模型脑里有的著名实体（Apple Park / Wong Kar-wai 风 / 艺术流派）| 不必 reference | prompt 直接点名 |
 | **真实存在但模型不熟**（最新发布产品 / 小众品牌 / 用户自有 IP / 特定型号设备）| **`web_search { include_images:true }`** | 工具自动翻英文 + 下载到 `assets/references/`；选 1-2 张最切题的 `local_path` 喂 `referenceImages[]` |
 | 抽象概念 / 装饰 / 隐喻 | 不需要 reference | 直接 prompt |
@@ -242,7 +241,7 @@ Avoid: <底线级禁令>
 |---|---|
 | **风格一致（跨页锚）** | 第 1 张 cover 当种子，后续 hero / section-divider 都引它 → 整篇像同一部片子 |
 | **角色一致（多页叙事）** | portrait 跨页引 + 给角色起名（"Maya, the woman in Reference 1"）|
-| **logo / brand 嵌入** | 用户上传 logo 进 `assets/`，prompt 写 "Place the logo from Reference 1 etched into the bottle in Reference 2" |
+| **logo / brand 嵌入** | 用户上传 logo 进 `用户内容/`，prompt 写 "Place the logo from Reference 1 etched into the bottle in Reference 2" |
 | **精修而非重画** | `screenshot_canvas` 截当前页当 reference，配 § G 的模板 |
 | **真实主体锚定** | `web_search { include_images: true }` 拿真图 → 喂进来 + "Use the product in Reference 1 as the subject; render it in [场景]" |
 
@@ -344,6 +343,24 @@ Step 3: 给角色起名锚定（"Maya, character from Reference 1"）
 
 每次只改一处，改完再看，别一轮里改五件事。
 
+### G1. variationOf 模式 —— 系列图一致性用参数，别手写咒语
+
+上面那套 "Change only… Keep… unchanged" 的骨架，工具已经内置成结构化参数：
+
+```json
+{ "variationOf": "assets/generated/A1.png",
+  "change": "裙子换成薄荷绿短裙，长度到膝盖以上",
+  "preserve": ["pose","framing","face","hair","top","shoes"] }
+```
+
+- `variationOf` 就是编辑基底（自动成为第 1 张 reference），`change` 是唯一要动的那处，
+  `preserve` 是必须一致的方面（**省略 = 全保，最安全**）。工具会展开成完整骨架并
+  自动追加通用禁止项（不凭空加背带/发饰、缺席也要保持 —— 都是真实翻过车的）。
+- 何时用它而不是手写 § G 模板：**做系列**（换装矩阵、多页同角色、多帧同场景）。
+  组织成一棵树：先出一张锚图，之后每次调用只沿一个轴变一处。
+- 手写 prompt 仍然适合单次精修（改光线、删元素这类一次性编辑）。
+- 此模式下 `prompt` 可省略；传了就当补充说明附在骨架后。
+
 ## H. 连续帧的能力边界（实测，别重新踩）
 
 | 用法 | 结果 |
@@ -390,9 +407,9 @@ Step 3: 给角色起名锚定（"Maya, character from Reference 1"）
 
 ## J. 调完必做
 
-1. **`record_decision`** —— 把 prompt + role + path + 用户评价记进任务便利贴
-   （`notes/决策.md`）。重生时能查回，用户在画布上也看得到。
-   ⚠️ 入参是 `title`（必填）/ `rationale`（必填）/ `scope` / `alternatives`，**没有 `topic`**。
+1. **记进记忆** —— 定案的 anchor（prompt 骨架 + role + 产物路径 + 用户评价）写一条
+   `type: project` 记忆（`记忆/` 主题文件 + MEMORY.md 一行）。重生时能查回，
+   用户在画布上也看得到。
 2. **关键节点的反馈循环**：cover / 第一个 portrait / logo 嵌入这种会被当跨页种子的 anchor，
    生完在自然回话里邀请用户看一眼方向（生图的 image block 已自动渲染在 chat，他直接看得到）。
    种子早定早收益。

package/server/engine/agent/prompts/tools/paint-still-cookbook.md

@@ -264,7 +264,7 @@ lora_strength: "0.9,0.7"
 
 ## 批量与铁律
 
-- stills ≤16 条，每条可再开 `batch` 1-8，逐张上墙
+- stills ≤16 条，每条可再开 `batch` 1-8，逐张出现在画布上
 - **任何一条失败即中止整批剩余**（后面大概率同因，不空烧）
 - `name` 只能是字母数字下划线连字符，1-40 字符，**中文名会被直接拒**
 - 视频关键帧一律 1344x768

package/server/engine/agent/prompts/tools/site-reference.md

@@ -21,12 +21,22 @@
 
 （旧项目里工作区根上直接放 index.html 的「根站」仍被识别和支持，但**新站一律入夹**。）
 
-**构建型站点**（Astro / 11ty / 自写 build 脚本）：源随便组织，构建产物落
-`dist/`（或 `out/` `build/` `_site/`，有 index.html 的那个自动被认作**产物根**；
-也可在 `.nd-project.json` 加 `"root": "<目录>"` 显式指定）。预览、截图、`list_pages`、
+**构建型站点**（Vite / React / Vue / Astro / 11ty / 自写 build 脚本）：源随便组织，
+构建产物落 `dist/`（或 `out/` `build/` `_site/` `public/`，有 index.html 的那个自动
+被认作**产物根**）。现代工程源码里的 `index.html`（引 `/src/main.tsx` 那种 dev 入口）
+**不会**被误当产物 —— 构建完系统自动优先 dist。`.nd-project.json` 的 `"root": "<目录>"`
+可显式指定产物根：**放站点文件夹里，路径相对该文件夹**（如 `观察日志/.nd-project.json`
+写 `{"root":"dist"}`）；根站的放工作区根。预览、截图、`list_pages`、
 导出、发布看的**全是产物根** —— 改完源必须重新构建，否则用户看到的还是旧的。
+构建必须用绝对路径或 `(cd <站点文件夹> && npm run build)` 子 shell 跑，**build 完
+`ls` 确认产物真的落在了站点文件夹里的 dist/**（cwd 漂了会把 dist 建到别处）。
 `node_modules` / 构建缓存系统永远不扫，不用进 .ndignore。
 
+WebGL/Three.js（含 R3F）的一个静默坑：渲染器属性（如剖切要的
+`localClippingEnabled`）传给 `<Canvas gl={{…}}>` 构造参数会被**静默忽略**（无报错
+无效果），要在 `onCreated={({gl}) => { gl.localClippingEnabled = true }}` 里设；
+`clippingPlanes` 裁掉的是法线**负**侧，"看起来没剖"先怀疑法线方向。
+
 手写起手：`mkdir 观察日志`，然后 Write `观察日志/index.html`（文件夹名换成真站名；
 没有起手模板，骨架从需求推、样式从风格名推）。**唯一硬要求是产物根上有 `index.html`**；
 样式文件怎么拆怎么叫你定，按站的体量来。
@@ -103,4 +113,5 @@
 - **字体链少了 CJK 那段**：`'Inter', sans-serif` 换台机器中文就掉到系统默认字体。
   每段 latin family 后面必须跟 `'PingFang SC', 'Noto Sans SC'`
 - **改了 style.css 预览没变**：不会。html/css/js 走 `no-cache`，写完即时刷新
-- **半角标点**：中文正文里的 `,` `:` 很扎眼，用全角 `，` `：`
+- **标点跟正文主体语言走**：中文正文里的 `,` `:` 很扎眼，用全角 `，` `：`；
+  英文正文反过来，全角标点混进去一样扎眼，用半角加空格

package/server/engine/agent/role-card.js

@@ -0,0 +1,175 @@
+/**
+ * engine/agent/role-card.js —— 读角色文件（2026-08-26）
+ *
+ * 角色文件（`.claude/agents/rp-*.md`）**是模型可写的**：`cast_role` 是正门，但主 agent
+ * 手里有 Write/Edit/Bash，`.claude/agents/` 就在工作区内，workspace-scope-guard 不拦它。
+ * 所以「角色只能拿板上工具」这条教义如果只写在 cast_role 里，等于没写 —— 绕过它只要
+ * 手写一份 md。
+ *
+ * 收口在**派发时**（见 hooks/pre-defaults.js 的 rp 分支）：不管这份文件是谁写的、
+ * 怎么落的盘，派它之前都按同一张白名单核一遍。
+ *
+ * ## 三种要拦的写法
+ *
+ *   tools: mcp__nodesign__publish_site      点名要外发工具
+ *   tools: mcp__nodesign                    **server 通配** = 这个 server 的全部工具
+ *   （压根没有 tools 行）                    SDK 语义 = **继承父代理的全部工具**
+ *
+ * 最后那条最容易漏：少写一行比多写一行危险。所以缺失 = 不合法，不是"用默认值"。
+ *
+ * ## 解析为什么是保守的
+ *
+ * frontmatter 真的走 YAML 解析（CLI 侧 `Bun.YAML.parse`），合法写法不止一种
+ * （`a, b` / `[a, b]` / 多行 `- a`）。这里三种都认；认不出的形状一律**当不合法**
+ * 而不是当空 —— 判据看不懂的东西不能默认放行。角色文件本来就该由 cast_role 写，
+ * 手写出奇怪形状时 deny 会指回正门。
+ */
+
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { isResidentRole, isSlotType, safeRoleLabel } from './cast.js';
+
+const AGENTS_DIR = '.claude/agents';
+const REGISTRY_REL = '.nd/cast.json';
+
+/**
+ * 演员位登记表（2026-08-28 重构）：cast_role 写的 slug → {name, duty, pen, card}。
+ * 没有/坏了 = 空表 —— 登记是展示层，fail-soft，坏了角色照样上场（署名退回 slug）。
+ */
+export async function readCastRegistry(workspaceRoot) {
+  try {
+    const raw = await fs.readFile(path.join(workspaceRoot, REGISTRY_REL), 'utf8');
+    const data = JSON.parse(raw);
+    return data && typeof data.roles === 'object' && data.roles ? data : { version: 1, roles: {} };
+  } catch { return { version: 1, roles: {} }; }
+}
+const FM_RE = /^---\r?\n([\s\S]{0,4000}?)\r?\n---/;
+
+/** 从 frontmatter 文本里取一个键的原始值（只认顶层、单行键） */
+function rawValue(fm, key) {
+  const re = new RegExp(`^${key}:[ \\t]*(.*)$`, 'm');
+  const m = re.exec(fm);
+  return m ? m[1] : null;
+}
+
+/**
+ * 解析 tools 声明。
+ * @returns {{ kind: 'list', tools: string[] } | { kind: 'missing' } | { kind: 'unparsable' }}
+ */
+export function parseToolsDeclaration(fm) {
+  const raw = rawValue(fm, 'tools');
+  if (raw === null) return { kind: 'missing' };
+  const inline = raw.trim();
+
+  if (inline === '') {
+    // 多行数组：tools:\n  - a\n  - b
+    const after = fm.slice(fm.indexOf('\ntools:') + 1).split('\n').slice(1);
+    const items = [];
+    for (const line of after) {
+      if (/^\s*-\s+/.test(line)) { items.push(line.replace(/^\s*-\s+/, '').trim().replace(/^["']|["']$/g, '')); continue; }
+      if (/^\S/.test(line)) break;          // 下一个顶层键
+      if (line.trim() === '') continue;
+      return { kind: 'unparsable' };
+    }
+    return items.length ? { kind: 'list', tools: items } : { kind: 'unparsable' };
+  }
+
+  const flow = /^\[(.*)\]$/.exec(inline);
+  const body = flow ? flow[1] : inline;
+  const tools = body.split(',').map((t) => t.trim().replace(/^["']|["']$/g, '')).filter(Boolean);
+  return tools.length ? { kind: 'list', tools } : { kind: 'unparsable' };
+}
+
+/**
+ * 读一份角色文件。
+ * @returns {Promise<{ slug, displayName: string|null, description: string|null,
+ *                     toolsDecl: ReturnType<typeof parseToolsDeclaration> } | null>}
+ */
+export async function readRoleCard(workspaceRoot, slug) {
+  if (!workspaceRoot || !isResidentRole(slug)) return null;
+  const file = path.join(workspaceRoot, AGENTS_DIR, `${slug}.md`);
+  let raw;
+  try { raw = await fs.readFile(file, 'utf8'); } catch { return null; }
+  const m = FM_RE.exec(raw);
+  if (!m) return { slug, displayName: null, description: null, toolsDecl: { kind: 'unparsable' } };
+  const fm = m[1];
+  const description = rawValue(fm, 'description');
+  const descPlain = description
+    ? description.trim().replace(/^"([\s\S]*)"$/, '$1').replace(/\\"/g, '"')
+    : null;
+  const nameMatch = descPlain ? /^RP 角色「(.+?)」/.exec(descPlain) : null;
+  return {
+    slug,
+    // ⚠️ 展示名是文件里的**自称**，不是实证 —— 角色文件模型可写，一个角色能自称
+    // 「用户」或顶替别的角色。只拿它当展示层，归属的锚在名册（harness 亲眼所见的派发）。
+    // 保留字闸（safeRoleLabel）在**这个出口**过（08-28 下沉）：此前只在 listRoleNames
+    // 过，直接消费 readRoleCard().displayName 的新调用点会重蹈「三个渲染面漏一个」。
+    displayName: nameMatch ? safeRoleLabel(slug, nameMatch[1]) : null,
+    description: descPlain,
+    toolsDecl: parseToolsDeclaration(fm),
+  };
+}
+
+/**
+ * 从派发 prompt 里推断实例名（2026-08-28 晚，glm 撞闸案）。
+ *
+ * name 闸的原设计假设「deny 一次模型就会补参数」—— 对 sonnet 成立（探针实证），
+ * 对免费行 glm 不成立：proj_mtd7d4et 里它连撞九次，第六次把 `name: rp-izumi`
+ * 写进了 prompt 正文 —— 它想给，但参数就是发不出来。弱模型够不着的参数不能当
+ * 硬前置，所以闸学会自己认，按可靠度分层：
+ *
+ *   1. prompt 头部的 `name: rp-xxx` 行（模型明说的）
+ *   2. 登记表匹配：prompt 里出现某个已登记角色的卡路径（cast_role 的配方就是
+ *      「第一行写卡路径」，正常照做的派发天然命中）
+ *   3. prompt 里出现的、登记过的 rp- slug
+ *
+ * 推出来的名字跟模型传参同一信任级（名字本来就是模型起的），不碰任何安全判据
+ * （工具白名单在演员位文件上，收件人闸认的是名册登记）。taken 是已在场名册 ——
+ * 在场的不再当候选（那是"续演该用 SendMessage"的情形，不是新派）。
+ */
+export async function inferRoleNameFromPrompt(workspaceRoot, prompt, { taken = new Set(), isSlot = () => false } = {}) {
+  const head = String(prompt || '').slice(0, 1200);
+  const ok = (s) => s && /^rp-[A-Za-z0-9][A-Za-z0-9_-]{0,60}$/.test(s) && !isSlot(s) && !taken.has(s);
+  const explicit = /name[:：]\s*["'「]?(rp-[A-Za-z0-9][A-Za-z0-9_-]*)/.exec(head);
+  if (explicit && ok(explicit[1])) return explicit[1];
+  const reg = await readCastRegistry(workspaceRoot);
+  const byCard = Object.entries(reg.roles)
+    .filter(([slug, r]) => ok(slug) && typeof r?.card === 'string' && r.card && head.includes(r.card));
+  if (byCard.length === 1) return byCard[0][0];
+  const mentioned = Object.keys(reg.roles).filter((slug) => ok(slug) && head.includes(slug));
+  if (mentioned.length === 1) return mentioned[0];
+  return null;
+}
+
+/**
+ * 列出这个工作区里所有角色的展示名（slug → 展示名）。
+ *
+ * 只当**展示层**用：展示名取自角色文件，而那份文件模型能写 —— 一个角色可以自称
+ * 「用户」。所以这张表不许用来做判断（路由、权限、归属），只用来把 slug 渲染得好看。
+ * 判断一律用 slug 本身（harness 盖的章）。
+ */
+export async function listRoleNames(workspaceRoot) {
+  const out = new Map();
+  if (!workspaceRoot) return out;
+  // 旧式一角一定义（会话启动前就存在的 .claude/agents/rp-*.md）：仍然认，
+  // 但演员位本身（rp-actor / rp-narrator）是位置不是人，不进名册。
+  let names;
+  try { names = await fs.readdir(path.join(workspaceRoot, AGENTS_DIR)); } catch { names = []; }
+  for (const n of names) {
+    if (!n.endsWith('.md')) continue;
+    const slug = n.slice(0, -3);
+    if (!isResidentRole(slug) || isSlotType(slug)) continue;
+    const card = await readRoleCard(workspaceRoot, slug);
+    // 保留字闸已下沉到 readRoleCard 出口（08-28）—— 这里拿到的已是洗过的名字。
+    if (card?.displayName) out.set(slug, card.displayName);
+  }
+  // 登记表（08-28 演员位重构的主源）：同 slug 时登记表赢 —— cast_role 是正门。
+  // 登记表也是模型可写的（.nd 在工作区里），展示名同样只当展示层、过保留字闸。
+  const reg = await readCastRegistry(workspaceRoot);
+  for (const [slug, r] of Object.entries(reg.roles)) {
+    if (!isResidentRole(slug) || isSlotType(slug)) continue;
+    const label = safeRoleLabel(slug, r?.name);
+    if (label) out.set(slug, label);
+  }
+  return out;
+}

package/server/engine/agent/rp-mode.js

@@ -0,0 +1,17 @@
+/**
+ * engine/agent/rp-mode.js —— 「RP 编排机械开不开」的唯一谓词（2026-08-28 归一）
+ *
+ * 此前这个判断散在三处、口径不一：stage-broadcast 判 mode==='rp'，scene.js 和
+ * roles.js 不判 —— design 项目手动 cast_role 之后进入「半条腿」状态：say 能开轮、
+ * onRoleWait 能推进，广播却整机不转，没有任何一处报错。
+ *
+ * 归一口径（08-28）：**编排机械（台上广播 / 轮次机 / set_scene）只在 rp 模式活**；
+ * 直投通道（say 私语、cue_role、SendMessage 召回）任何模式都通 —— design 项目里
+ * 轻度 RP（blackboard-rp skill + cast_role）照样能跟角色说话，只是没有机器替它转。
+ */
+
+import { getProject } from '../../projects/store.js';
+
+export function isRpProject(projectId) {
+  return !!projectId && (getProject(projectId)?.mode || 'design') === 'rp';
+}

package/server/engine/agent/session-loop.js

@@ -31,6 +31,7 @@ import { AgentContext, freshTurnCounters } from './context.js';
 import { Events } from './events.js';
 import { createRun, markRunStarted, markRunSucceeded, markRunFailed, mergeRunMetadata, setRunMetrics, setRunModelUsage } from '../runs/store.js';
 import { getProject } from '../../projects/store.js';
+import { modeSkillsFor } from '../mcp/mode-profile.js';
 import { randomUUID } from 'node:crypto';
 import {
   registerQuerySession,
@@ -47,6 +48,7 @@ import {
 } from '../runs/active-runs.js';
 import {
   promoteNextPendingRunId, claimRunByUuid, releaseCurrentTurnRunId, getPendingRunCount,
+  isBackgroundTurnOpener,
   closeMergedRun, publishQueueDepth, pushUnclaimedMessage,
 } from '../runs/turn-relay.js';
 // skill 起手文件拷贝已挪 hooks.js PreToolUse(Skill/Bash)（2026-07-27），
@@ -54,8 +56,12 @@ import {
 import { loadInstalledPlugins } from './plugin-loader.js';
 import { createHooks } from './hooks.js';
 import { buildIsolationOptions, prepareAgentDirs, sandboxShimEnv } from './isolation.js';
+import { MEMORY_EXTRA_GUIDELINES, mergeAgentSettings } from './memory-config.js';
 import { createNodesignMcpServer } from '../mcp/index.js';
+import { MCP_SERVER_NAME } from '../mcp/server-name.js';
 import { assertInitContract } from './init-contract.js';
+import { clearSessionFlights } from './subagent-flight.js'; import { clearStageStatus } from './stage-status.js'; import { clearBeatState } from './beat-state.js';
+import { createRoleRoster } from './cast.js';
 import { createAgents, resolveDefaultFastModel } from '../agents/index.js';
 import { resolveSdkSpoofModel, pickThinkingConfig, resolveModelRoute, isUncensoredModel } from './model-context.js';
 import { resolveSessionModel } from './session-model.js';
@@ -118,11 +124,6 @@ import { levelFor } from '../../lib/moderation.js';
  * 旁路事件**不算** —— 通知之后 SDK 不一定真的唤起模型，铸了 run 却等不来
  * result 收尾就是僵尸 run。
  */
-function isBackgroundTurnOpener(message) {
-  return message?.type === 'assistant'
-    || message?.type === 'stream_event'
-    || message?.type === 'user';
-}
 
 export async function runSession({
   sessionId,
@@ -324,13 +325,29 @@ export async function runSession({
 
   // MCP server 实例落变量：开局契约自检要从**传给 query 的同一个实例**上取预期
   // 工具名（server.toolNames，见 mcp/index.js）——不另立第二份清单。
-  const nodesignServer = createNodesignMcpServer({ workspaceRoot: wsRoot, sharedRoot, projectId, sessionId, ctx: sharedCtx });
-
+  // 常驻角色名册：一会话一份，hooks 与 MCP 工具共用同一引用（见 cast.js createRoleRoster）
+  const roleRoster = createRoleRoster();
+  // 项目模式（08-27）：启动时读一次（切换下个会话生效），同一读数喂工具面（mode-profile.js）和提示词面（nd:mode 分区），两面不岔开
+  const projectMode = (projectId ? getProject(projectId)?.mode : null) || 'design';
+  const nodesignServer = createNodesignMcpServer({ workspaceRoot: wsRoot, sharedRoot, projectId, sessionId, ctx: sharedCtx, roleRoster, projectMode });
   // npm 缓存 + 沙盒可写 tmp（$TMPDIR / pip 缓存）：细节与教训见 isolation.js
   const agentDirs = await prepareAgentDirs({ dataRoot: PROJECTS_DATA_ROOT, projectId, sessionId });
 
+  // ⛔ 服务器自己的运行姿态不许漏进 agent 环境（08-24 案）：
+  //   - NODE_ENV=production（pm2 注的）会让 agent 沙盒里的 npm install 静默跳过
+  //     devDependencies —— 返回 0 还报 "up to date"，vite/typescript 根本没装上，
+  //     构建道当场断。npm_config_production / npm_config_omit 是同一开关的旁路。
+  //   - PWD 是 pm2 进程的 cwd（仓库根）；spawn({cwd}) 不更新它，bash 会自校正但
+  //     python/node/构建工具读 $PWD 拿到的就是错目录 ——"cwd 被重置到父目录"的
+  //     另一半病根。下面显式钉成 cwdRoot。
+  const {
+    NODE_ENV: _dropNodeEnv, npm_config_production: _dropNpmProd,
+    npm_config_omit: _dropNpmOmit, OLDPWD: _dropOldpwd,
+    ...inheritedEnv
+  } = process.env;
   const sdkEnv = {
-    ...process.env,
+    ...inheritedEnv,
+    PWD: cwdRoot,
     ANTHROPIC_BASE_URL: baseUrlForBinary,
     // 订阅模型：apiKeyForBinary = process.env 原值（通常 undefined）——binary 见到
     // ANTHROPIC_API_KEY 会弃用 ~/.claude 订阅 OAuth，所以订阅路绝不能注入。
@@ -341,6 +358,8 @@ export async function runSession({
     // auto-memory 强制开启分支（binary gate：DISABLE 置 falsy 值 = force on，
     // 绕过 CLAUDE_CODE_SIMPLE 等后置门；前置门 U$/zl 若拦住则此招无效 → 走自建 B 计划）
     CLAUDE_CODE_DISABLE_AUTO_MEMORY: '0',
+    // 记忆指导追加段（保留 SDK 原合同只追加产品口径，理由见 memory-config.js）
+    CLAUDE_COWORK_MEMORY_EXTRA_GUIDELINES: MEMORY_EXTRA_GUIDELINES,
     // 工具搜索：非 alwaysLoad 的 MCP 工具延迟加载（省 ~25-30k 常驻 schema tokens），
     // agent 用 ToolSearch 按需取。白名单见 mcp/index.js ALWAYS_LOAD_TOOLS
     ENABLE_TOOL_SEARCH: 'true',
@@ -405,8 +424,8 @@ export async function runSession({
     systemPrompt: {
       type: 'preset',
       preset: 'claude_code',
-      // 成人段随项目 owner 的外审档联动（agent-shared.renderPrelude）；
-      // 找不到 owner 时落 loose 默认，绝不落 off。
+      // 成人段随项目 owner 的外审档联动（renderPrelude）；无主项目落 tier.js 的 strict，绝不落 off。
+      // ⚠️ 08-30 默认档按通路拆成两栏（订阅 strict / 非订阅 off）→ 同一个项目换个模型跑成人段就换一档。
       //
       // uncensored 走模型表的标记位（model-context.isUncensoredModel），不在这里
       // 判模型名 —— 那是模型属性，写在这儿就是给那张表开第二个真相源。为 true 的
@@ -416,13 +435,18 @@ export async function runSession({
         const owner = projectId ? getUserById(getProject(projectId)?.ownerId) : null;
         // 档位按模型通路取旋钮（08-20 两旋钮：订阅 / 本地与中转），model 是上面已解析的会话模型
         // 无主项目 fail-closed 到 tier.js 的默认（strict），别落 loose（生产 08-21 实查 0 个无主项目）
+        // locale：项目 owner 在账号上记的界面语言。null（没表过态）时 renderPrelude
+        // 落中文默认 —— 服务端拿不到浏览器语言，这里不猜，猜错比给中文更糟。
         return renderPrelude(owner ? levelFor(owner, model) : defaultModerationLevel(null), {
           uncensored: isUncensoredModel(model),
+          locale: owner?.locale || undefined,
+          // 项目模式分区（nd:mode 标记块）—— 跟工具面用的是同一次读数，两面不会岔开
+          mode: projectMode,
         });
       })(),
     },
     plugins: installed.plugins,
-    skills: installed.skills,
+    skills: modeSkillsFor(installed.skills, projectMode),   // 按模式筛+对账（拆件见 mode-profile）
 
     // 2026-05-18 安全：关 inline shell execution。SDK 默认允许 skill / slash command 内
     // inline shell 命令（Anthropic 标准 skill 协议的一部分，如 setup script）—— 但 NoDesign
@@ -530,22 +554,6 @@ export async function runSession({
     persistSession: true,
     settingSources: ['project'],
 
-    // skipWebFetchPreflight 来自 runtime/platform.js（gateway key 模式永远关）
-    // 详细因果链见 platform.js 的 skipWebFetchPreflight 注释
-    settings: {
-      skipWebFetchPreflight: platform.skipWebFetchPreflight,
-      // 项目 memory（2026-07-28 正式启用）：骑 SDK 原生 auto-memory ——
-      // 二级索引（MEMORY.md 常驻 + 主题文件按需召回）、召回监督器
-      // （run.memory_recall 前端已渲染）、auto-dream 后台固化全由 SDK 包办。
-      // ⚠️ 目录必须显式指到项目共享区：默认按 cwd 派生，而 cwd 是会话级的，
-      // 不指定则每个会话一座记忆孤岛；指定后全项目所有会话共享一套。
-      ...(sharedRoot ? {
-        autoMemoryEnabled: true,
-        // 落在 .claude/agent-memory/auto —— 跟前端记忆卡读的是同一棵树
-        // （2026-07-28 修：之前指到 shared/agent-memory/auto，SDK 记了前端也看不到）
-        autoMemoryDirectory: path.join(sharedRoot, '.claude', 'agent-memory', 'auto'),
-      } : {}),
-    },
 
     includePartialMessages: STREAMING_ENABLED,
     // 子代理时间轴（2026-07-28）：转发子代理完整对话（text/thinking 也带
@@ -582,7 +590,19 @@ export async function runSession({
 
     // 隔离两道闸（sandbox 管 Bash，permissions.deny 管 Read/Write 这类进程内工具）
     // 全在 agent/isolation.js 里，改之前读那份文件头上的四条实测教训。
-    ...buildIsolationOptions({ cwdRoot, sharedRoot, ...agentDirs, dataRoot: PROJECTS_DATA_ROOT, env: sdkEnv }),
+    // ⛔ settings 必须与 isolationOptions.settings 深合并 —— 08-15 起两处 settings
+    // 静默互吞八天（autoMemory*/skipWebFetchPreflight 全丢）。合并+出口断言在
+    // memory-config.js 的 mergeAgentSettings。
+    ...(() => {
+      const isolation = buildIsolationOptions({ cwdRoot, sharedRoot, ...agentDirs, dataRoot: PROJECTS_DATA_ROOT, env: sdkEnv });
+      return {
+        ...isolation,
+        settings: mergeAgentSettings(isolation.settings, {
+          skipWebFetchPreflight: platform.skipWebFetchPreflight, sharedRoot,
+          crossSessionInbound: 'refuse',   // 理由见 memory-config.js 那个键的注释
+        }),
+      };
+    })(),
 
     toolConfig: {
       askUserQuestion: { previewFormat: 'html' },
@@ -590,10 +610,12 @@ export async function runSession({
 
     // projectId 要传：PostToolUseFailure 记问题库时用它标归属（漏传的话
     // issues 行的 project_id 全是 null，事后追不回是哪个项目踩的）
-    hooks: createHooks({ ctx: sharedCtx, workspaceRoot: wsRoot, sharedRoot, sessionId, projectId }),
+    hooks: createHooks({ ctx: sharedCtx, workspaceRoot: wsRoot, sharedRoot, sessionId, projectId, roleRoster }),
 
     mcpServers: {
-      nodesign: nodesignServer,
+      // 键名 = 模型眼里的 `mcp__<名>__<工具>` 前缀，也是 isolation.js 那条
+      // permissions.allow 规则要匹配的名字 —— 两个读者，收在 mcp/server-name.js
+      [MCP_SERVER_NAME]: nodesignServer,
     },
 
     // mainModel = appModel ('kimi-k2.6')，sdkModel = SDK 视角 alias ('claude-opus-4-7[1m]')。
@@ -728,8 +750,8 @@ export async function runSession({
     await commitWorkspace(projectId, sessionId, `turn ${status}: ${new Date().toISOString()}`, { author: 'agent' })
       .catch((err) => console.warn('[git] turn commit failed:', err.message));
 
-    // 黑板草稿兜底落定（2026-08-23）：agent 这一轮 sketch_on_board 留下的 staging
-    // 物件，没调 finish_sketch 也在回合结束时变实 —— 草稿态是"正在画"的信号，
+    // 黑板草稿兜底落定（2026-08-23）：agent 这一轮 write_on_board 画图留下的 staging
+    // 物件，没调 edit_board commit 也在回合结束时变实 —— 草稿态是"正在画"的信号，
     // 回合都结束了还半透明就是幽灵。取消/出错同样落定：画了就是画了。
     if (projectId) {
       try {
@@ -981,6 +1003,7 @@ export async function runSession({
     unregisterIngressSession(sessionId);   // API 会话的 fast 兜底路由配对注销（订阅会话 noop）
     unregisterSessionNotice(sessionId, noticeHandler);   // ingress → 会话的通知通道配对注销（按身份，别删掉新会话的）
     takeUpstreamTruncation(sessionId);     // 半截标记跟会话同生命周期，别留
+    clearSessionFlights(sessionId); clearStageStatus(projectId); clearBeatState(sessionId);   // 在飞台账 + 台上一览 + 收尾闸记账，都跟会话同寿命
     // 带 token 比对：sid 若已被新 register 占用（closeQuerySession 已同步让位 +
     // 用户重发起新 runSession），unregister 看到 _token 不匹配 → noop 不误删新 entry
     unregisterQuerySession(sessionId, sessionToken);

package/server/engine/agent/stage-status.js

@@ -0,0 +1,73 @@
+/**
+ * engine/agent/stage-status.js —— 「台上现在有谁、谁在写、谁刚写完」（2026-08-29）
+ *
+ * ## 它补的洞
+ *
+ * 主持人此前对角色的状态是半盲的：派发的返回、SendMessage 的返回、角色结束时的
+ * task-notification —— 全是**事件的瞬间**，没有任何地方能回答「现在怎么样了」。
+ * 2026-08-28 真会话里用户自己问出了这个洞（「感觉说书人是不是都需要重启一下？」），
+ * 而主持人手里最接近的工具 read_scene 只会背一遍它自己声明过的东西。
+ *
+ * ## 判据只用 harness 盖的章
+ *
+ *   在写   SubagentStart 到了、SubagentStop 还没到
+ *   刚写完 SubagentStop（`last_assistant_message` 是它收笔时说的话，SDK 现成给）
+ *
+ * 两个都不是模型能写的（feedback-verify-the-instrument）。这里**不记**「它写了什么
+ * 板书」—— 那份真相在画布上，每回合状态块本来就注入最近板书，重复一份就会有两份
+ * 各执一词的账。
+ *
+ * 生命周期：内存态、跟会话走，runSession 的 finally 里清。
+ */
+
+const stages = new Map();   // projectId → Map<slug, { writing, startedAt, finishedAt, lastLine }>
+
+function tableFor(projectId) {
+  if (!stages.has(projectId)) stages.set(projectId, new Map());
+  return stages.get(projectId);
+}
+
+/** 角色起飞（SubagentStart，名字由别名桥解析出来） */
+export function noteRoleStart(projectId, slug) {
+  if (!projectId || !slug) return;
+  const t = tableFor(projectId);
+  const prev = t.get(slug) || {};
+  t.set(slug, { ...prev, writing: true, startedAt: Date.now(), finishedAt: null });
+}
+
+/** 角色收笔（SubagentStop）。lastLine = 它这一轮最后说的话，截短存 */
+export function noteRoleFinish(projectId, slug, lastLine = null) {
+  if (!projectId || !slug) return;
+  const t = tableFor(projectId);
+  const prev = t.get(slug) || {};
+  t.set(slug, {
+    ...prev,
+    writing: false,
+    finishedAt: Date.now(),
+    lastLine: lastLine ? String(lastLine).replace(/\s+/g, ' ').trim().slice(0, 120) : (prev.lastLine || null),
+  });
+}
+
+/**
+ * 台上一览（给主持人的每回合状态块用）。
+ * @returns {Array<{slug, writing, lastLine, idleMs}>} 按「在写的排前面」排序
+ */
+export function stageStatus(projectId) {
+  const t = stages.get(projectId);
+  if (!t || !t.size) return [];
+  const now = Date.now();
+  return [...t.entries()]
+    .map(([slug, v]) => ({
+      slug,
+      writing: !!v.writing,
+      lastLine: v.lastLine || null,
+      idleMs: v.finishedAt ? now - v.finishedAt : 0,
+    }))
+    .sort((a, b) => Number(b.writing) - Number(a.writing) || a.slug.localeCompare(b.slug));
+}
+
+/** 会话收摊 */
+export function clearStageStatus(projectId) { stages.delete(projectId); }
+
+/** 测试用 */
+export function _resetStageStatus() { stages.clear(); }