@xiaobuyu/nodesign 0.0.7 → 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

@@ -43,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 |
@@ -241,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 [场景]" |
 

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

@@ -113,4 +113,5 @@ WebGL/Three.js（含 R3F）的一个静默坑：渲染器属性（如剖切要
 - **字体链少了 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），
@@ -56,7 +58,10 @@ 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';
@@ -119,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,
@@ -325,8 +325,11 @@ 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 });
 
@@ -421,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 的
@@ -432,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
@@ -591,6 +599,7 @@ export async function runSession({
         ...isolation,
         settings: mergeAgentSettings(isolation.settings, {
           skipWebFetchPreflight: platform.skipWebFetchPreflight, sharedRoot,
+          crossSessionInbound: 'refuse',   // 理由见 memory-config.js 那个键的注释
         }),
       };
     })(),
@@ -601,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]')。
@@ -739,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 {
@@ -992,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(); }

package/server/engine/agent/subagent-flight.js

@@ -0,0 +1,73 @@
+/**
+ * engine/agent/subagent-flight.js —— 「这个会话还有后台角色在干活吗」（2026-08-28）
+ *
+ * ## 为什么需要这条路
+ *
+ * ws/index.js 的 grace 闸（07-27 建）只认 turn：用户关 tab / 切走后 turn 还在飞就
+ * 续命，等它干完再回收 SDK 进程。演员位范式造出了**第二种在飞工作** —— GM 的场务
+ * turn 几秒钟就结束，后台角色还要写好几分钟。闸不认识它，于是 08-28 泉此方场实录：
+ *
+ *   17:47:39 角色派出 → 17:48:17 GM turn 结束 → 17:49:29 grace 到期关会话
+ *   → 角色被腰斩在第三个 Read 上，板上永远没有第二拍，日志里连个 warn 都没有。
+ *
+ * 从用户视角看就是「角色不写了」。这正是 07-27 那道闸要保住的东西（"用户关 tab 时
+ * 后端应该把活干完"），只是当时在飞工作只有 turn 一种形态。
+ *
+ * ## 判据（2026-08-29 简化）
+ *
+ * **在飞 = SubagentStart 过且 SubagentStop 还没到**，就这一条。
+ *
+ * 08-29 之前它还要减掉「候场」——那时角色写完一段会挂在 await_user 上不收回合，
+ * 一个挂着的角色就能让会话永远关不掉（每个 SDK 进程 ~250MB 且 RSS 单调不减，
+ * 这台盒子 1vCPU/8G、swap=0）。新回路里角色写一段就结束这一轮，「永不收回合」这个
+ * 形态不存在了，减数也就跟着没了。
+ *
+ * 信号是 harness 在 spawn / 结束那一刻亲眼所见并盖的章，不是模型能写的东西。
+ *
+ * ## 生命周期
+ *
+ * 会话内存态，runSession 的 finally 里跟收件箱一起清。**这里不设时间上限** ——
+ * 兜底封顶在 ws/index.js 的续命次数上（一处判据一个真相源，别在两边各写一份）。
+ */
+
+import { agentNameOf } from './actor-trail.js';
+
+const flights = new Map();   // sessionId -> Map<agentId, { agentType, startedAt }>
+
+/** 子代理起飞。agentId 来自 SubagentStart hook input，harness 盖的章 */
+export function noteSubagentStart(sessionId, agentId, agentType = null) {
+  if (!sessionId || !agentId) return;
+  let m = flights.get(sessionId);
+  if (!m) { m = new Map(); flights.set(sessionId, m); }
+  m.set(agentId, { agentType, startedAt: Date.now() });
+}
+
+/** 子代理落地 */
+export function noteSubagentStop(sessionId, agentId) {
+  if (!sessionId || !agentId) return;
+  const m = flights.get(sessionId);
+  if (!m) return;
+  m.delete(agentId);
+  if (m.size === 0) flights.delete(sessionId);
+}
+
+/**
+ * 这个会话里还在飞的后台子代理。
+ *
+ * name 是实例名（角色）——翻不出来的（普通干活子代理）也照样算在飞，只是没名字。
+ *
+ * @param {string} sessionId
+ * @param {string|null} _projectId  旧签名的兼容位（候场判定退役后不再需要）
+ * @returns {Array<{ agentId, agentType, name, startedAt }>}
+ */
+export function workingSubagents(sessionId, _projectId = null) {
+  const m = flights.get(sessionId);
+  if (!m || m.size === 0) return [];
+  return [...m].map(([agentId, info]) => ({ agentId, name: agentNameOf(agentId), ...info }));
+}
+
+/** 会话收摊 */
+export function clearSessionFlights(sessionId) { flights.delete(sessionId); }
+
+/** 测试用：清空全局态 */
+export function _resetSubagentFlight() { flights.clear(); }

package/server/engine/agent/system-prompts.js

@@ -14,6 +14,7 @@
 import path from 'node:path';
 import fs from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import { DEFAULT_LOCALE } from '../../shared/locales.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -40,6 +41,13 @@ const ADULT_POLICY = {
   strict: '露骨的成人内容在这个账号档位下不写——涉及时收敛处理、用留白带过。',
 };
 
+// 界面语言的人话名（2026-08-26 i18n）。注给模型看的是「中文（zh-CN）」这种带 id 的写法：
+// 光写「中文」模型不知道对应哪个 tag，光写 tag 又不如人话直白。
+const UI_LOCALE_NAME = {
+  'zh-CN': '中文（zh-CN）',
+  en: 'English（en）',
+};
+
 /**
  * 「底线」那一节在 prelude 里有**两份并排写着**的版本，标记块框起来：
  * `nd:policy:full`（对外开放平台的完整产物政策）和 `nd:policy:min`。渲染时留一份、
@@ -51,6 +59,14 @@ const ADULT_POLICY = {
  */
 const POLICY_BLOCK = /<!-- nd:policy:(full|min):start -->\n([\s\S]*?)<!-- nd:policy:\1:end -->\n/g;
 
+/**
+ * 项目模式分区（2026-08-27）：prelude 里设计道专属的节框在 `nd:mode:design` 块里，
+ * 演出（常驻角色）专属的节框在 `nd:mode:rp` 块里，渲染时按项目模式留一族、删一族。
+ * 没框的部分是共用骨架。同一个文件里可以有**多个**同名标记块（设计道的节不连续）。
+ * 为什么是标记块不是两份 md：见 POLICY_BLOCK 注释 —— 单一真相源 + 切错当场炸。
+ */
+const MODE_BLOCK = /<!-- nd:mode:(design|rp):start -->\n([\s\S]*?)<!-- nd:mode:\1:end -->\n/g;
+
 // 加载期断言：两份都必须在。少一份说明有人编辑 prelude 时把标记删了，那时候
 // 正则会静默退化成"一份都不删"（uncensored 路径拿到完整底线）或"整节消失"。
 {
@@ -60,6 +76,23 @@ const POLICY_BLOCK = /<!-- nd:policy:(full|min):start -->\n([\s\S]*?)<!-- nd:pol
       throw new Error(`[system-prompts] nodesign-prelude.md 缺少 nd:policy:${want} 标记块 —— 提示词渲染会静默走错版本`);
     }
   }
+  const modes = [...NODESIGN_PRELUDE.matchAll(MODE_BLOCK)].map((m) => m[1]);
+  for (const want of ['design', 'rp']) {
+    if (NODESIGN_PRELUDE && !modes.includes(want)) {
+      throw new Error(`[system-prompts] nodesign-prelude.md 缺少 nd:mode:${want} 标记块 —— 模式分区渲染会静默失效`);
+    }
+  }
+}
+
+// 占位符也要断言：`.replace('{{X}}', v)` 在占位符不存在时**静默什么都不做**，
+// 于是线上会悄悄发出一份没有成人档、或者没有语言指令的提示词，不报错。
+// 标记块那套已经这么防了，占位符这两个之前漏了（08-26 补）。
+{
+  for (const ph of ['{{ADULT_POLICY}}', '{{UI_LOCALE}}']) {
+    if (NODESIGN_PRELUDE && !NODESIGN_PRELUDE.includes(ph)) {
+      throw new Error(`[system-prompts] nodesign-prelude.md 缺少 ${ph} 占位符 —— 渲染会静默少一段`);
+    }
+  }
 }
 
 /**
@@ -76,11 +109,19 @@ const POLICY_BLOCK = /<!-- nd:policy:(full|min):start -->\n([\s\S]*?)<!-- nd:pol
  *   前提不成立。留下的一条不随档位变，也不随谁在用变。
  *
  *   ⚠️ 默认 false。调用方拿不到模型名时落**完整**那份，绝不落 min。
+ *
+ *   `mode`：项目模式（projects.mode）。'design'（默认）留设计道分区，'rp' 留
+ *   演出分区。认不出的值落 design —— 存量项目全是 design，猜错方向宁可多给不少给。
  */
 export function renderPrelude(level = 'loose', opts = {}) {
   const keep = opts.uncensored === true ? 'min' : 'full';
+  const keepMode = opts.mode === 'rp' ? 'rp' : 'design';
+  // 认不出的 locale 落中文：这个产品是中文优先的，拿不准时给中文不给英文。
+  const localeName = UI_LOCALE_NAME[opts.locale] || UI_LOCALE_NAME[DEFAULT_LOCALE];
   return NODESIGN_PRELUDE
     .replace(POLICY_BLOCK, (_all, which, body) => (which === keep ? body : ''))
+    .replace(MODE_BLOCK, (_all, which, body) => (which === keepMode ? body : ''))
     .replace('{{ADULT_POLICY}}', ADULT_POLICY[level] || ADULT_POLICY.loose)
+    .replace('{{UI_LOCALE}}', localeName)
     .trim();
 }