@shgroup/dsh-serenity-hooks 1.59.5 → 1.63.1

package/dsh.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.59.5",
+  "version": "1.63.1",
   "main": "lib/index.js",
-  "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 轨迹日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 与 0.2.0-rc.1（双档，deepseek-ai/deepseek-harness）。",
+  "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 轨迹日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
   "engines": {
     "dsh": ">=0.1.7-rc.1"
   },

package/lib/host/contract.d.ts

@@ -23,6 +23,17 @@ type HostAccess = 'injected' | 'lazy';
 interface HostMember {
     name: string;
     kind: 'function' | 'value';
+    /**
+     * 成员所属的「互斥族」标签（可选）。**同族成员满足任一即可**。
+     *
+     * 🔴 为什么需要（v1.61，S151 2026-10-17 报告）：
+     *   宿主会**给同一个能力改名**并保留旧名作回退。`subagents` 就是实例：
+     *   `0.2.1-rc.*+` 的正门叫 `startActivation`，`start` 仅作旧宿主回退
+     *   （`tools/cheap-worker.ts` 的 `resolveSubagentStarter()` 是**双路**的）。
+     *   若契约把某一个具体名字钉成"必须有"，宿主改名后 ⇒ **探针报假故障，而功能是好的**。
+     *   ⇒ 判据必须是「**这一族里至少有一个能用**」，不是「这个名字必须在」。
+     */
+    anyOf?: string;
 }
 interface HostServiceContract {
     /** 稳定标识（报告用） */

package/lib/index.js

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
 import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebServer, i as cccRootForExec, l as hostLlm, m as hostWeb, n as agentCwdFor, o as listCccs, p as hostSubagents, r as cccRootForCwd, s as hostAgents, t as NO_CCC_FROM_AGENT_CWD, u as hostService } from "./ccc-roots-GIJ3A_tw.js";
 import { _ as resolveInside, a as findSerenityRoot$1, c as matchBlacklist, d as readCccName$1, f as readCheapWorkerConfig, h as readTrajectorySkills, i as findGitRoot, l as pathInside, m as readSafeModeHiddenTools, n as SAFE_MODE_MARKER, o as isSafeModeOn, p as readExclusiveTools, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-B0ZGL9lx.js";
-import { A as localIdStamp, C as setActiveSessionInfo, D as isoLocal, E as useSession, O as localFileStamp, S as sessionsRoot, T as summarize, _ as namingTitleFor, a as pruneMissingBindings, b as resolveSessionByTitle, c as setBindingStore, d as clearActiveSessionInfo, f as createSession, g as listSessions, h as getActiveSessionInfo, i as listBoundSessionIds, k as localHuman, l as DEFAULT_SESSION_SCOPE, m as findSession, n as PLUGIN_SOURCE, o as readLastBound, p as extractSessionMdPathFromText, r as appendBound, s as resolveSessionTrajectoryLabel, t as ACC_MESSAGE_KIND, u as TRAJECTORY_ACTIONS, v as parseSessionContextFromEvents, w as showSession, x as sessionEvents$1, y as readActiveSessionMd } from "./message-source-B4P3Uw6D.js";
+import { A as localIdStamp, C as setActiveSessionInfo, D as isoLocal, E as useSession, O as localFileStamp, S as sessionsRoot, T as summarize, _ as namingTitleFor, a as pruneMissingBindings, b as resolveSessionByTitle, c as setBindingStore, d as clearActiveSessionInfo, f as createSession, g as listSessions, h as getActiveSessionInfo, i as listBoundSessionIds, k as localHuman, l as DEFAULT_SESSION_SCOPE, m as findSession, n as PLUGIN_SOURCE, o as readLastBound, p as extractSessionMdPathFromText, r as appendBound, s as resolveSessionTrajectoryLabel, u as TRAJECTORY_ACTIONS, v as parseSessionContextFromEvents, w as showSession, x as sessionEvents$1, y as readActiveSessionMd } from "./message-source-B4P3Uw6D.js";
 import { a as readGitTrack, c as unsetEntry, i as localstorePath, l as writeEntry, n as checkLocalstoreGitCompliance, o as readStore, r as getEntry, s as runLocalStore, t as LOCALSTORE_SCOPES } from "./localstore-ops-DMs_ovHo.js";
 import { a as FACE_PORTS, c as MECHANISM_PORTS, d as registerSkiffSession$1, f as skiffRoleFor$1, h as ACC_VERSION, i as ACP_PORT, l as SKIFF_DEBUG_PORT, m as unregisterSkiffSession$1, n as readSimpleSettings, o as GATEWAY_PORT, p as skiffSessionInfo$1, r as registerSettingsSection, s as MAIN_WEB_PORT, u as WEIXIN_SEND_PORT } from "./settings-section-DGUQZo5j.js";
 import { a as readSkiffRoles, c as roleMsmWhitelist, d as systemPromptSource, f as trajectorySubset, i as isSkiffSessionId, l as roleToolWhitelist, n as buildSkiffBasePrompt, o as resolveRoleSystemPrompt, r as createRolePromptReader, s as resolveSkiffKind } from "./skiff-role-B615L9MV.js";
@@ -11518,17 +11518,39 @@ async function sendToTrajectory(ctx, root, target, message, sender) {
 *
 * 何时用：**只有** `send-now` 在 `acquireWakeAgent` 报「无绑定会话记录」时（见该处的判据说明）。
 *
-* 三步（顺序不可换）：
-*   ① `sessionController.create({ cwd: root })` —— 宿主原语，**idempotently adopt**
-*      ⇒ 重复调用不会建出第二条（不必自造"先查再建"的竞态窗口）。
+* ## 🔴 2026-10-18 根治：改成**和用户操作完全同一个调用形态**
+*
+* owner 原话：「应当和用户操作唤起的会话完全一样才行」。
+*
+* 上一版（v1.62.1）传的是 `{ cwd: root }`，然后**事后补** `attachSession()` 去挂工作区。
+* 那是**补救**，不是"一样" —— 宿主里那条路径（`sessionController.create` 的
+* `if (workspace !== void 0) await workspace.attachSession(sessionId)`）**只在 `workspaceId` 分支执行**：
+*
+*   ```js
+*   if (request.workspaceId !== void 0) workspace = registry.get(request.workspaceId)
+*   const cwd = workspace?.path ?? request.cwd ?? this.defaultCwd
+*   ...
+*   if (workspace !== void 0) await workspace.attachSession(sessionId)   // ← 只有这条分支
+*   ```
+*
+* 而**用户在 UI 里新建会话传的正是 `workspaceId`**（见 `client/sessions/service.d.ts` 的
+* `create({ workspaceId?, cwd?, ... })`）⇒ 用户那条路天然会走到 `attachSession`。
+*
+* ⇒ 现在与用户**同一条分支**：先由 CCC 根查出 `workspaceId`，再用 `{ workspaceId }` 建。
+*   **`attachToWorkspace` 降级为兜底**（只在"该目录还没有工作区登记"时才会用上），
+*   不再是主路径 —— 因为主路径已经由宿主自己做完。
+*
+* ## 三步（顺序不可换）
+*   ① `sessionController.create({ workspaceId })` —— 与用户同一形态；宿主替我们挂工作区。
+*      **idempotently adopt** ⇒ 重复调用不会建出第二条（不必自造"先查再建"的竞态窗口）。
 *   ② `resolveAgent(sessionId)` —— 拿到**真 agent**。`create` 只返回 id，不给 agent。
 *   ③ `appendBound(...)` —— 落绑定。**必须由本函数写**：`listBoundSessionIds` 是
 *      `acquireWakeAgent` 的唯一选人依据，不写绑定则下一条消息**还是**找不到它
 *      （那就成了"建了但永远用不上"，比不建更坏）。
 *
-* 🔴 **为什么用 `cwd: root` 而不是目标的目录**：会话的 cwd 决定它落在哪个 CCC
+* 🔴 **为什么定位到 CCC 根这一级、不是轨迹目录**：会话的 cwd 决定它落在哪个 CCC
 *    （`cccRootForCwd` 上溯 `.serenity`）。目标轨迹本就住在该 CCC 的 `AGENT_SESSIONS/` 下
-*    ⇒ 传 CCC 根才让它**进同一个 CCC**；传轨迹目录会让它变成一个**不同 CCC**的会话。
+*    ⇒ 落到 CCC 根才让它**进同一个 CCC**；落到轨迹目录会让它变成一个**不同 CCC**的会话。
 *
 * @returns 命中返回 agent 与取得方式；任一步失败返回**带原因**的 error（不静默、不误报成功）
 */
@@ -11539,9 +11561,11 @@ async function createAndBindTarget(ctx, root, dirName) {
 		error: "目标无活跃 dsh 会话，且 sessionController.create 不可用（绑定 id: 无）——无法就地创建载体；请先对该轨迹执行一次 container_trajectory use",
 		notReady: true
 	};
+	const ws = findWorkspaceByPath(listWorkspaces(ctx) ?? [], root);
+	const workspaceId = typeof ws?.id === "string" && ws.id !== "" ? ws.id : void 0;
 	let sessionId = "";
 	try {
-		const out = await create.call(sc, { cwd: root });
+		const out = await create.call(sc, workspaceId !== void 0 ? { workspaceId } : { cwd: root });
 		sessionId = String(out?.sessionId ?? "");
 	} catch (err) {
 		return { error: `就地创建会话失败（${dirName}）: ${String(err?.message ?? err)}` };
@@ -11568,13 +11592,100 @@ async function createAndBindTarget(ctx, root, dirName) {
 		mdPath: join(root, "AGENT_SESSIONS", dirName, "SESSION.md"),
 		note: "auto-created by send-now"
 	});
-	const how = `auto-create(${sessionId}${bound ? ", bound" : ", ⚠️ 绑定写入失败"})`;
+	const wsNote = workspaceId !== void 0 ? "" : await attachToWorkspace(ctx, root, sessionId);
+	const how = `auto-create(${sessionId}${bound ? ", bound" : ", ⚠️ 绑定写入失败"}${workspaceId !== void 0 ? ", via-workspaceId(=用户同一形态)" : ", via-cwd+attach"}${wsNote})`;
 	return {
 		agent,
 		how
 	};
 }
 /**
+* 把刚建的会话挂进 **cwd 所属的那个工作区**（2026-10-17 缺陷修复）。
+*
+* 🔴 **为什么必须我们自己做（宿主源码取证，不是推断）**：
+*   `sessionController.create()` 里 `attachSession` **只在 `workspaceId` 分支执行** ——
+*   `dsh-api-session-controller/lib/index.js` 的 `create()`：
+*     ```
+*     if (request.workspaceId !== void 0) workspace = registry.get(request.workspaceId)
+*     const cwd = workspace?.path ?? request.cwd ?? this.defaultCwd
+*     ...
+*     if (workspace !== void 0) await workspace.attachSession(sessionId)   // ← 只有这条分支挂工作区
+*     ```
+*   我们传的是 `{ cwd }`（**必须如此**：`workspaceId` 与 `cwd` 互斥，而工作区 id 是宿主的内部 uuid，
+*   我们又得按"这条轨迹住在哪个 CCC"来建会话）⇒ **建出来的会话从不登记进任何工作区**。
+*
+* 🔴 **症状（现场实证，本机真实数据）**：`send-now` 自动建出的那条会话
+*   （`note` = `auto-created by send-now`）header `cwd` 确实是某个 CCC 根，
+*   **却不在**该工作区的 `sessionIds` 里
+*   （同一个 CCC 的另外两条会话都在）⇒ WebUI 里它不属于那个工作区。
+*
+* 🔴 **为什么按 `path` 找而不是"拿第一个"**：多个 CCC 并存（本机实有 5 个工作区）
+*   ⇒ 拿第一个必然挂错。判据 = `workspace.path === root`（宿主 `Workspace.path` 是
+*   **realpath 规范化**后的规范路径；`root` 已是 `cccRootForCwd` 上溯出来的真实目录，
+*   两侧同一来源，故可直接比）。
+*
+* ⚠️ **失败不阻断投递**：工作区归属影响的是"在 WebUI 里归哪个工作区"，
+*   而消息投递已经完成 ⇒ 把原因**如实写进回执**，不吞、也不把成功改成失败。
+*
+* @param ctx 插件上下文
+* @param root CCC 根（= 该会话的 cwd）
+* @param sessionId 刚建出来的会话 id
+* @returns 追加到回执里的短注记（成功/跳过为空串，失败带原因）
+*/
+async function attachToWorkspace(ctx, root, sessionId) {
+	const workspaces = listWorkspaces(ctx);
+	if (workspaces === void 0) return ", ⚠️ 工作区未挂载（workspaceRegistry 不可用）";
+	const match = findWorkspaceByPath(workspaces, root);
+	if (match === void 0) return "";
+	if (typeof match.attachSession !== "function") return ", ⚠️ 工作区未挂载（attachSession 不可用）";
+	if (Array.isArray(match.sessionIds) && match.sessionIds.includes(sessionId)) return "";
+	try {
+		await match.attachSession(sessionId);
+		return ", workspace-attached";
+	} catch (err) {
+		return `, ⚠️ 工作区挂载失败: ${String(err?.message ?? err)}`;
+	}
+}
+/** `workspaceRegistry.list()` 的读取收口（不可用返回 `undefined`，**与"空列表"区分**） */
+function listWorkspaces(ctx) {
+	const reg = hostService(ctx, "workspaceRegistry");
+	if (typeof reg?.list !== "function") return void 0;
+	try {
+		return reg.list() ?? [];
+	} catch {
+		return;
+	}
+}
+/**
+* 在 `workspaceRegistry.list()` 里找 **path 等于该 CCC 根** 的那一个。
+*
+* 🔴 **为什么要 realpath 归一（不是画蛇添足）**：宿主的 `Workspace.path` 是
+*   **`fs.realpath` 规范化**过的（`entity.d.ts` 逐字：*"Canonical directory path: the
+*   `fs.realpath` of the path given at create time (trailing slashes, `..`, and symlinks
+*   all resolved)"*）。而 `root` 来自 `cccRootForCwd` 的上溯——**上溯用的是字面路径**。
+*   ⇒ 当 CCC 根是一个**符号链接**（部署上常见：家目录/项目目录被链到别处），
+*   两侧**逐字不等**，只比字符串会**挂错或挂不上**。
+*
+* ⚠️ 归一失败（路径不存在等）时**回落字面比较** —— 不改既有语义，只是多给一次机会。
+*
+* @param workspaces registry.list() 的返回
+* @param root CCC 根
+* @returns 命中的工作区，无则 undefined
+*/
+function findWorkspaceByPath(workspaces, root) {
+	const direct = workspaces.find((ws) => ws?.path === root);
+	if (direct !== void 0) return direct;
+	const canonical = (p) => {
+		try {
+			return realpathSync(p);
+		} catch {
+			return p;
+		}
+	};
+	const want = canonical(root);
+	return workspaces.find((ws) => typeof ws?.path === "string" && canonical(ws.path) === want);
+}
+/**
 * 本 tick 要扫的 CCC 根集合（**并集**）。
 *
 * C2（S142 2026-09-15 Q5）：原实现是 `collectLiveCccs`——**只认 live 会话** ⇒
@@ -14091,15 +14202,77 @@ const DEFAULT_COMPACTION_TOOLS = [
 */
 const DEFAULT_ANCHOR_MESSAGES = ["You are the operator agent of Serenity — a cognitive container governed by the Abstract Cognitive Container (ACC) protocol.\nWe operate under the Explicit Abstraction Principle (EAP): the functional value of a thought equals its external reconstructability — every output we produce must be explicit (E↑), reconstructable (R↓), and stable (S↑).\nThe personal pronoun is us/we.\nWe anchor first, then act: the abstract layer precedes the concrete.\nPlease simply reply \"acknowledge\" — no action needed.", "Before we proceed, align on how we work:\n1. We read before we write — every decision grounds in what already exists in the container.\n2. Every output records its reasoning (R↓): decisions carry reasons and alternatives.\n3. We never jump levels — abstract layer first, then specifics.\n4. Every artifact we create is a durable cognitive anchor for the work that follows.\n5. We keep the container's state coherent (SESSION.md) as we advance.\nPlease simply reply \"acknowledge\" — no action needed."];
 /**
-* 根会话锚定重入判定（v1.28.1 提取导出以便单测）：会话是否已有真实用户消息。
-* resume/续跑的会话已有对话历史 → **不重锚**（first-anchor 只注入一次）。
+* 会话里是否已有模型回复（= 已经不是首轮）。
+*
+* 🔴 这是锚定的**形状判据**（v1.62）：锚定只能在**首轮**造。
+*    ⛔ 不能用 `hasUserMessageHistory`：宿主在 system 之后、真人 prompt 之前就写了
+*    ACC 横幅，而锚定实际执行点（`setTimeout(0)`）更晚 ⇒ 真人历史**必然已存在** ⇒ 恒真。
+*    而 `assistant/message` 只在**模型真的答过一轮之后**才出现 ⇒ 它在首轮时必然为空。
+*/
+function hasAssistantHistory(session) {
+	return sessionEvents$1(session).some((event) => event.type === "assistant/message");
+}
+/**
+* 把 first-anchor 的锚定话语**直接写进会话日志**，取代「真跑两轮」。
 *
-* 0.1.2-rc.1 适配教训：裸读 `session.events`（经类型断言）恒 undefined →
-* `!undefined` 恒 true → 有历史也永不跳过 → 任何情况发消息都重插 first-anchor。
-* 统一经 sessionEvents() 读取（snapshotEvents() 优先，.events 兜底）。
+* ## 🔴 两条硬约束（宿主 v4 格式校验器，实测逐条踩过）
+*
+* **约束 A — 只能写 `user/message`**：`system/message` 与 `assistant/message` 都在
+*   `STEP_EVENT_TYPES` 里 ⇒ 必须过 `requireStep()`（`data.turn`/`data.step` 精确匹配
+*   **当前打开的** turn 与 step，且为 null 时同样拒绝）。而本函数在 `agent/pre-step`
+*   前后被调用时 **turn/step 都还没打开**（`turn/start` 在 preStep 之前，`step/start`
+*   在 preStep 之后）⇒ 代写它们**结构性非法**。
+*   ⚠️ 症状：写通道不校验 ⇒ **首轮正常**；**重新进入**时重放才抛
+*   `system/message does not match an open turn and step` ⇒ 会话 corrupt、界面空白。
+*   ⇒ **v1.60 那版「先写占位 system 等宿主 replace」的整套方案因此作废**。
+*
+* **约束 B — 必须写在宿主提交 `system/message` 之后**：格式层有 `protectedHead`
+*   机制 —— `foldSurface()` 里 `system/message` 若在 **surface 非空且尚无 protectedHead**
+*   时到来，直接抛 `system/message requires a protected first surface head`。
+*   也就是说：**surface 的第一个节点必须是 system**。
+*   ⇒ 若我们先写 user 消息，宿主随后的 system 就落不到首位 ⇒ 重放同样判 corrupt。
+*   ⚠️ 这条是**第一次修复后仍然翻车**的原因（同一会话、不同报错），
+*   判据仍是「重启宿主后重新进入该会话」。
+*
+* ⇒ 因此调用时机 = **`session/event` 里看到该会话第一条 `system/message` 之后**（见下方注册处），
+*   而不是 `agent/inbox/inserted`（那太早）。
+*
+* ## 为什么去掉 assistant 那半不损失什么
+*
+* 锚定话语的**唯一目的**是让模型认为自己已经同意过协作协议。
+* 保留 **2 条 `user/message`** 即可达成；丢掉的只是"模型自己的 ack 回复"——
+* 而那原本也是**我们伪造的**，不是模型真说过的。
+*
+* ## 判据（改这个函数前后都必须跑）
+*
+* ① 单测钉形状（只许 user/message）；
+* ② **容器内真跑一轮 → 重启宿主 → 重新进入该会话** —— 只有这条路能证明日志合法
+*   （前两次修复都是"单测全绿 + 首轮正常"却仍然 corrupt）。
+* ③ 直接调宿主自己的 `assertReleasedV4Relationships()` 判形状，**不要自写复刻**。
+*
+* @param session 会话（需有 append）
+* @param anchorMessages 锚定话语序列（缺省协议固有两条）
+* @returns 是否成功写入
 */
-function hasUserMessageHistory(session) {
-	return sessionEvents$1(session).some((event) => event.type === "user/message");
+function appendAnchorHistory(session, anchorMessages = DEFAULT_ANCHOR_MESSAGES) {
+	const target = session;
+	if (typeof target?.append !== "function") return false;
+	const append = target.append.bind(target);
+	const rid = (prefix) => `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+	try {
+		for (let i = 0; i < anchorMessages.length; i++) append("user/message", {
+			id: rid(`anchor-user-${i + 1}`),
+			role: "user",
+			content: [{
+				type: "text",
+				text: anchorMessages[i]
+			}],
+			source: { kind: "user" }
+		}, { surfaceOp: "append" });
+		return anchorMessages.length > 0;
+	} catch {
+		return false;
+	}
 }
 /**
 * 构建一个 epoch 感知晋升跟踪器（纯逻辑，可单测）。
@@ -14213,9 +14386,18 @@ const PROMOTE_EVENTS = {
 	"assistant-message": /* @__PURE__ */ new Set(["assistant/message"]),
 	either: /* @__PURE__ */ new Set(["tool/call", "assistant/message"])
 };
-/** 协议固有 bootstrap 设置：zeroTools=true（首请求 0 工具纯文字锚定轮）、
-*  晋升信号仅 assistant/message（对齐 zero-anchored-standard）、
-*  requiredSignals = 锚定轮数（2 条消息 → 2 条回复后晋升）。无参——零配置面。 */
+/** 协议固有 bootstrap 设置（v1.62 / D140）。
+*
+* 🔴 **zeroTools 必须为 false**：v1.62 起锚定历史**只造 `user/message`**（不含伪造的
+*   `assistant/message`）⇒ **首请求时晋升信号尚未满足** ⇒ 若仍 `zeroTools: true`，
+*   首请求会真的退化成「0 工具」，模型看不到任何 ACC 工具。
+*
+* 🔴 **为什么不改回去伪造一条 assistant**：宿主 v4 校验要求 `assistant/message` 落在
+*   已打开的 turn+step 内（见 `appendAnchorHistory` 头注释），而锚定写入时 turn/step
+*   都还没打开 ⇒ 伪造它**结构性非法**，代价是「重新进入会话即 corrupt」。
+*
+* ⇒ 取舍：**首请求就给完整工具目录**（放弃「首请求窄目录」这个 cache 断点优化），
+*   换来**日志合法**。`bootstrapTools` 因此只是历史字段，`boundary < 0` 分支已让位。 */
 function resolveBootstrapSettings() {
 	return {
 		bootstrapTools: [...DEFAULT_BOOTSTRAP_TOOLS],
@@ -14224,7 +14406,7 @@ function resolveBootstrapSettings() {
 		suppressedSources: new Set(DEFAULT_SUPPRESSED_SOURCES),
 		compactionTools: [...DEFAULT_COMPACTION_TOOLS],
 		anchorMessages: [...DEFAULT_ANCHOR_MESSAGES],
-		zeroTools: true
+		zeroTools: false
 	};
 }
 /**
@@ -14263,36 +14445,32 @@ function registerBootstrap(ctx) {
 			const root = cccRootForCwd(cwd);
 			if (!root) return;
 			trackerFor(root).observe(session, event);
+			if (event.type === "system/message") setTimeout(() => {
+				try {
+					maybeAnchor(session, root);
+				} catch {}
+			}, 0);
 		} catch {}
 	});
+	/** 造锚定历史（幂等；防重靠 `anchoredSessions`）。 */
+	const maybeAnchor = (session, _root) => {
+		const s = session;
+		s?.header?.delegationDepth;
+		const sid = typeof s?.id === "string" ? s.id : void 0;
+		if (sid !== void 0 && anchoredSessions.has(sid)) return;
+		if (sid !== void 0 && (sid.startsWith("cheap-worker-") || isSkiffSessionId(sid))) return;
+		if (hasAssistantHistory(session)) return;
+		const wrote = appendAnchorHistory(session, SETTINGS.anchorMessages);
+		if (wrote && sid !== void 0) anchoredSessions.add(sid);
+		if (wrote) warnOnce(`anchor history fabricated: ${SETTINGS.anchorMessages.length} 条 user 消息（不再真跑）`);
+	};
 	ctx.on("agent/inbox/inserted", ({ agent, message }) => {
 		try {
 			if (!agentRoot(agent)) return;
 			const session = agent.session;
-			const depth = session?.header?.delegationDepth ?? 0;
 			const sid = typeof session?.id === "string" ? session.id : void 0;
 			if (sid !== void 0 && (sid.startsWith("cheap-worker-") || isSkiffSessionId(sid))) return;
-			if (depth === 0) {
-				if (hasUserMessageHistory(session)) return;
-			} else if (sid !== void 0 && anchoredSessions.has(sid)) return;
 			if (message?.source?.kind === "plugin:dsh-serenity-hooks") return;
-			const inbox = agent.inbox;
-			if (!inbox?.prepend) return;
-			for (let i = SETTINGS.anchorMessages.length - 1; i >= 0; i--) inbox.prepend("next-turn", {
-				id: `bootstrap-anchor-${Date.now()}-${Math.random().toString(36).slice(2, 8)}-${i}`,
-				role: "user",
-				content: [{
-					type: "text",
-					text: SETTINGS.anchorMessages[i]
-				}],
-				source: {
-					kind: ACC_MESSAGE_KIND,
-					form: "notice",
-					summary: "bootstrap anchor turn"
-				}
-			});
-			if (sid !== void 0) anchoredSessions.add(sid);
-			warnOnce(`anchor turns injected: ${SETTINGS.anchorMessages.length} 条（${SETTINGS.anchorMessages[0].slice(0, 40)}…）`);
 		} catch {}
 	});
 	let warned = false;
@@ -14330,8 +14508,9 @@ function registerBootstrap(ctx) {
 					tools: tools.filter((tool) => typeof tool.name === "string" && keep.has(tool.name))
 				};
 			}
+			if (status.boundary < 0) return assembled;
 			const keep = new Set(SETTINGS.bootstrapTools);
-			if (status.boundary >= 0) for (const toolName of SETTINGS.compactionTools) keep.add(toolName);
+			for (const toolName of SETTINGS.compactionTools) keep.add(toolName);
 			const missing = [...keep].filter((name) => !available.has(name));
 			if (missing.length > 0) {
 				warnOnce(`expected bootstrap tools missing=${JSON.stringify(missing)} — bootstrap disabled, full catalog exposed`);
@@ -16141,8 +16320,13 @@ const HOST_SERVICES = [
 		name: "subagents",
 		access: "lazy",
 		members: [{
+			name: "startActivation",
+			kind: "function",
+			anyOf: "spawn-starter"
+		}, {
 			name: "start",
-			kind: "function"
+			kind: "function",
+			anyOf: "spawn-starter"
 		}],
 		impact: "cheap-worker 委派不可用（前台委派的正门，响亮报错）",
 		required: false
@@ -16388,13 +16572,30 @@ function probeHostContract(ctx, hostVersion = null) {
 		for (const member of svc.members) {
 			checked += 1;
 			const actual = value[member.name];
-			if (!(member.kind === "function" ? typeof actual === "function" : actual !== void 0)) issues.push({
-				id: `${svc.id}.${member.name}`,
-				kind: "member",
-				detail: `service "${svc.name}" is missing ${member.kind} "${member.name}"`,
-				impact: svc.impact,
-				required: svc.required
-			});
+			if (!(member.kind === "function" ? typeof actual === "function" : actual !== void 0)) {
+				if (member.anyOf !== void 0) {
+					const siblings = svc.members.filter((m) => m.anyOf === member.anyOf);
+					if (siblings.some((m) => {
+						const v = value[m.name];
+						return m.kind === "function" ? typeof v === "function" : v !== void 0;
+					})) continue;
+					issues.push({
+						id: `${svc.id}.${member.anyOf}`,
+						kind: "member",
+						detail: `service "${svc.name}" is missing every ${member.kind} of "${member.anyOf}" (${siblings.map((m) => m.name).join(" | ")})`,
+						impact: svc.impact,
+						required: svc.required
+					});
+					continue;
+				}
+				issues.push({
+					id: `${svc.id}.${member.name}`,
+					kind: "member",
+					detail: `service "${svc.name}" is missing ${member.kind} "${member.name}"`,
+					impact: svc.impact,
+					required: svc.required
+				});
+			}
 		}
 	}
 	const version = checkHostVersion(hostVersion);

package/lib/seams/bootstrap.d.ts

@@ -59,6 +59,58 @@ export declare const DEFAULT_ANCHOR_MESSAGES: string[];
  * 统一经 sessionEvents() 读取（snapshotEvents() 优先，.events 兜底）。
  */
 export declare function hasUserMessageHistory(session: unknown): boolean;
+/**
+ * 会话里是否已有模型回复（= 已经不是首轮）。
+ *
+ * 🔴 这是锚定的**形状判据**（v1.62）：锚定只能在**首轮**造。
+ *    ⛔ 不能用 `hasUserMessageHistory`：宿主在 system 之后、真人 prompt 之前就写了
+ *    ACC 横幅，而锚定实际执行点（`setTimeout(0)`）更晚 ⇒ 真人历史**必然已存在** ⇒ 恒真。
+ *    而 `assistant/message` 只在**模型真的答过一轮之后**才出现 ⇒ 它在首轮时必然为空。
+ */
+export declare function hasAssistantHistory(session: unknown): boolean;
+/**
+ * 把 first-anchor 的锚定话语**直接写进会话日志**，取代「真跑两轮」。
+ *
+ * ## 🔴 两条硬约束（宿主 v4 格式校验器，实测逐条踩过）
+ *
+ * **约束 A — 只能写 `user/message`**：`system/message` 与 `assistant/message` 都在
+ *   `STEP_EVENT_TYPES` 里 ⇒ 必须过 `requireStep()`（`data.turn`/`data.step` 精确匹配
+ *   **当前打开的** turn 与 step，且为 null 时同样拒绝）。而本函数在 `agent/pre-step`
+ *   前后被调用时 **turn/step 都还没打开**（`turn/start` 在 preStep 之前，`step/start`
+ *   在 preStep 之后）⇒ 代写它们**结构性非法**。
+ *   ⚠️ 症状：写通道不校验 ⇒ **首轮正常**；**重新进入**时重放才抛
+ *   `system/message does not match an open turn and step` ⇒ 会话 corrupt、界面空白。
+ *   ⇒ **v1.60 那版「先写占位 system 等宿主 replace」的整套方案因此作废**。
+ *
+ * **约束 B — 必须写在宿主提交 `system/message` 之后**：格式层有 `protectedHead`
+ *   机制 —— `foldSurface()` 里 `system/message` 若在 **surface 非空且尚无 protectedHead**
+ *   时到来，直接抛 `system/message requires a protected first surface head`。
+ *   也就是说：**surface 的第一个节点必须是 system**。
+ *   ⇒ 若我们先写 user 消息，宿主随后的 system 就落不到首位 ⇒ 重放同样判 corrupt。
+ *   ⚠️ 这条是**第一次修复后仍然翻车**的原因（同一会话、不同报错），
+ *   判据仍是「重启宿主后重新进入该会话」。
+ *
+ * ⇒ 因此调用时机 = **`session/event` 里看到该会话第一条 `system/message` 之后**（见下方注册处），
+ *   而不是 `agent/inbox/inserted`（那太早）。
+ *
+ * ## 为什么去掉 assistant 那半不损失什么
+ *
+ * 锚定话语的**唯一目的**是让模型认为自己已经同意过协作协议。
+ * 保留 **2 条 `user/message`** 即可达成；丢掉的只是"模型自己的 ack 回复"——
+ * 而那原本也是**我们伪造的**，不是模型真说过的。
+ *
+ * ## 判据（改这个函数前后都必须跑）
+ *
+ * ① 单测钉形状（只许 user/message）；
+ * ② **容器内真跑一轮 → 重启宿主 → 重新进入该会话** —— 只有这条路能证明日志合法
+ *   （前两次修复都是"单测全绿 + 首轮正常"却仍然 corrupt）。
+ * ③ 直接调宿主自己的 `assertReleasedV4Relationships()` 判形状，**不要自写复刻**。
+ *
+ * @param session 会话（需有 append）
+ * @param anchorMessages 锚定话语序列（缺省协议固有两条）
+ * @returns 是否成功写入
+ */
+export declare function appendAnchorHistory(session: unknown, anchorMessages?: string[]): boolean;
 interface PromotionStatus {
     /** 最后一次 compaction/end 的 seq（-1 = 未压缩过） */
     boundary: number;
@@ -85,9 +137,18 @@ interface PromotionTracker {
  * 通常 ≤ 2 < 默认兜底 3，不受影响。
  */
 export declare function createEpochPromotion(promoteEvents: Set<'tool/call' | 'assistant/message'>, requiredSignals?: number, maxRoundsFallback?: number): PromotionTracker;
-/** 协议固有 bootstrap 设置：zeroTools=true（首请求 0 工具纯文字锚定轮）、
- *  晋升信号仅 assistant/message（对齐 zero-anchored-standard）、
- *  requiredSignals = 锚定轮数（2 条消息 → 2 条回复后晋升）。无参——零配置面。 */
+/** 协议固有 bootstrap 设置（v1.62 / D140）。
+ *
+ * 🔴 **zeroTools 必须为 false**：v1.62 起锚定历史**只造 `user/message`**（不含伪造的
+ *   `assistant/message`）⇒ **首请求时晋升信号尚未满足** ⇒ 若仍 `zeroTools: true`，
+ *   首请求会真的退化成「0 工具」，模型看不到任何 ACC 工具。
+ *
+ * 🔴 **为什么不改回去伪造一条 assistant**：宿主 v4 校验要求 `assistant/message` 落在
+ *   已打开的 turn+step 内（见 `appendAnchorHistory` 头注释），而锚定写入时 turn/step
+ *   都还没打开 ⇒ 伪造它**结构性非法**，代价是「重新进入会话即 corrupt」。
+ *
+ * ⇒ 取舍：**首请求就给完整工具目录**（放弃「首请求窄目录」这个 cache 断点优化），
+ *   换来**日志合法**。`bootstrapTools` 因此只是历史字段，`boundary < 0` 分支已让位。 */
 export declare function resolveBootstrapSettings(): BootstrapSettings;
 export declare function registerBootstrap(ctx: Context): void;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.59.5",
-  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 与 0.2.0-rc.1（双档）。",
+  "version": "1.63.1",
+  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
   "license": "MIT",
   "repository": {
     "type": "git",