@shgroup/dsh-serenity-hooks 1.61.0 → 1.63.1

package/dsh.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.61.0",
+  "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/index.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,70 +14202,66 @@ 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 只注入一次）。
+* 会话里是否已有模型回复（= 已经不是首轮）。
 *
-* 0.1.2-rc.1 适配教训：裸读 `session.events`（经类型断言）恒 undefined →
-* `!undefined` 恒 true → 有历史也永不跳过 → 任何情况发消息都重插 first-anchor。
-* 统一经 sessionEvents() 读取（snapshotEvents() 优先，.events 兜底）。
+* 🔴 这是锚定的**形状判据**（v1.62）：锚定只能在**首轮**造。
+*    ⛔ 不能用 `hasUserMessageHistory`：宿主在 system 之后、真人 prompt 之前就写了
+*    ACC 横幅，而锚定实际执行点（`setTimeout(0)`）更晚 ⇒ 真人历史**必然已存在** ⇒ 恒真。
+*    而 `assistant/message` 只在**模型真的答过一轮之后**才出现 ⇒ 它在首轮时必然为空。
 */
-function hasUserMessageHistory(session) {
-	return sessionEvents$1(session).some((event) => event.type === "user/message");
+function hasAssistantHistory(session) {
+	return sessionEvents$1(session).some((event) => event.type === "assistant/message");
 }
-/** 造出来的 assistant 回复正文。锚定轮要求"只回确认、不做事"。 */
-const ANCHOR_ACK_TEXT = "acknowledge";
-/** 占位 system 文本：宿主 `SystemPromptProjection.project()` 会把它**原地 replace** 成真提示词。 */
-const ANCHOR_SYSTEM_PLACEHOLDER = "<!-- serenity:anchor-placeholder -->";
 /**
-* 把两轮 first-anchor 对话**直接写进会话日志**，取代原来的「真跑两轮」。
+* 把 first-anchor 的锚定话语**直接写进会话日志**，取代「真跑两轮」。
+*
+* ## 🔴 两条硬约束（宿主 v4 格式校验器，实测逐条踩过）
 *
-* ## 为什么可以这样（三条取证，全部打在真 `@deepseek-ai/dsh-session` 上）
+* **约束 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」的整套方案因此作废**。
 *
-* 1. **system 必须是 surface node 0**，而 `agent/pre-step` 跑在宿主提交 system **之前**
-*    ⇒ 若直接写 [anchor…]，system 会被追加到**末尾**（实测：`systemAtIndex: 4`，
-*    且**不报错**、静默走偏）。解法 = **先写一条占位 system**：宿主随后看到 node0
-*    已有 system 且文本不同 ⇒ 走 `replace(head)` 换成真提示词，锚定历史原样留在其后。
-* 2. **`contentGeneration` 只在 replace 时涨，append 不涨**；而 `buildRequest()`
-*    取 generation 快照**晚于** `systemPrompt.project()` ⇒ 那次 replace 不会被
-*    误判成「系列断裂」（不会误触发 `startsSeries`）。
-* 3. **造出来的 `assistant/message` 合法**：`stream: []` 通过校验；整段历史之后
-*    仍可被 compaction 的 `surfaceOp: replace` 整体覆盖（不炸）。
+* **约束 B — 必须写在宿主提交 `system/message` 之后**：格式层有 `protectedHead`
+*   机制 —— `foldSurface()` 里 `system/message` 若在 **surface 非空且尚无 protectedHead**
+*   时到来，直接抛 `system/message requires a protected first surface head`。
+*   也就是说：**surface 的第一个节点必须是 system**。
+*   ⇒ 若我们先写 user 消息，宿主随后的 system 就落不到首位 ⇒ 重放同样判 corrupt。
+*   ⚠️ 这条是**第一次修复后仍然翻车**的原因（同一会话、不同报错），
+*   判据仍是「重启宿主后重新进入该会话」。
 *
-* ## ⚠️ 为什么不发 turn/start、turn/end
+* ⇒ 因此调用时机 = **`session/event` 里看到该会话第一条 `system/message` 之后**（见下方注册处），
+*   而不是 `agent/inbox/inserted`（那太早）。
 *
-* 宿主的 turn 计数是**构造时缓存**的：`phase.lastTurn` 在本钩子触发前已读定（0），
-* 之后 `turn()` 恒用 `phase.turn + 1`。我们若自己发 `turn/start{1}{2}`，宿主随后
-* 仍会再发一条 `turn/start{1}` ⇒ **重复编号 ∧ 两个 turn 同时开着**。
-* ⇒ 只给消息打 **turn 标签**（模型可见顺序不依赖 turn 事件，`deriveMessages` 只看
-* surface 节点），**不碰宿主的 turn 账本**。
+* ## 为什么去掉 assistant 那半不损失什么
+*
+* 锚定话语的**唯一目的**是让模型认为自己已经同意过协作协议。
+* 保留 **2 条 `user/message`** 即可达成；丢掉的只是"模型自己的 ack 回复"——
+* 而那原本也是**我们伪造的**，不是模型真说过的。
+*
+* ## 判据（改这个函数前后都必须跑）
+*
+* ① 单测钉形状（只许 user/message）；
+* ② **容器内真跑一轮 → 重启宿主 → 重新进入该会话** —— 只有这条路能证明日志合法
+*   （前两次修复都是"单测全绿 + 首轮正常"却仍然 corrupt）。
+* ③ 直接调宿主自己的 `assertReleasedV4Relationships()` 判形状，**不要自写复刻**。
 *
 * @param session 会话（需有 append）
-* @param provider 当前路由 provider（写入 assistant 消息来源）
-* @param model 当前模型 id
+* @param anchorMessages 锚定话语序列（缺省协议固有两条）
 * @returns 是否成功写入
 */
-function appendAnchorHistory(session, provider, model, anchorMessages = DEFAULT_ANCHOR_MESSAGES) {
+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)}`;
-	append("system/message", {
-		turn: 1,
-		step: 1,
-		message: {
-			id: rid("anchor-system"),
-			role: "system",
-			content: [{
-				type: "text",
-				text: ANCHOR_SYSTEM_PLACEHOLDER
-			}],
-			source: { kind: "system-prompt" }
-		}
-	}, { surfaceOp: "append" });
-	for (let i = 0; i < anchorMessages.length; i++) {
-		const turn = i + 1;
-		append("user/message", {
-			id: rid(`anchor-user-${turn}`),
+	try {
+		for (let i = 0; i < anchorMessages.length; i++) append("user/message", {
+			id: rid(`anchor-user-${i + 1}`),
 			role: "user",
 			content: [{
 				type: "text",
@@ -14162,26 +14269,10 @@ function appendAnchorHistory(session, provider, model, anchorMessages = DEFAULT_
 			}],
 			source: { kind: "user" }
 		}, { surfaceOp: "append" });
-		append("assistant/message", {
-			turn,
-			step: 1,
-			message: {
-				id: rid(`anchor-assistant-${turn}`),
-				role: "assistant",
-				content: [{
-					type: "text",
-					text: ANCHOR_ACK_TEXT
-				}],
-				source: {
-					kind: "model",
-					provider,
-					model
-				}
-			},
-			stream: []
-		}, { surfaceOp: "append" });
+		return anchorMessages.length > 0;
+	} catch {
+		return false;
 	}
-	return true;
 }
 /**
 * 构建一个 epoch 感知晋升跟踪器（纯逻辑，可单测）。
@@ -14295,16 +14386,18 @@ const PROMOTE_EVENTS = {
 	"assistant-message": /* @__PURE__ */ new Set(["assistant/message"]),
 	either: /* @__PURE__ */ new Set(["tool/call", "assistant/message"])
 };
-/** 协议固有 bootstrap 设置：**zeroTools=false**（v1.60 起）。
+/** 协议固有 bootstrap 设置（v1.62 / D140）。
 *
-* 🔴 **为什么从 true 改成 false**（owner 令 2026-10-17，造历史取代真跑）：
-*   锚定历史现在**直接写进日志**，因此 `assistant/message` 晋升信号在首请求前
-*   就已满足 ⇒ `boundary < 0` 分支实际不可达。但**不能依赖"恰好满足"这个副作用**：
-*   若哪天锚定历史没写成（例如非 CCC 会话/异常降级），`zeroTools: true` 会退回到
-*   「首请求 0 工具」，那是**另一种**退化。显式关掉 ⇒ 任何情况下首请求都拿完整目录。
+* 🔴 **zeroTools 必须为 false**：v1.62 起锚定历史**只造 `user/message`**（不含伪造的
+*   `assistant/message`）⇒ **首请求时晋升信号尚未满足** ⇒ 若仍 `zeroTools: true`，
+*   首请求会真的退化成「0 工具」，模型看不到任何 ACC 工具。
 *
-* ⚠️ 这意味着 `bootstrapTools` 窄化也随之失效 —— 它的作用本来就是"首请求窄目录"，
-*   而造历史的目的正是**取消这个断点**。保留字段只为不破坏旧测试的引用面。 */
+* 🔴 **为什么不改回去伪造一条 assistant**：宿主 v4 校验要求 `assistant/message` 落在
+*   已打开的 turn+step 内（见 `appendAnchorHistory` 头注释），而锚定写入时 turn/step
+*   都还没打开 ⇒ 伪造它**结构性非法**，代价是「重新进入会话即 corrupt」。
+*
+* ⇒ 取舍：**首请求就给完整工具目录**（放弃「首请求窄目录」这个 cache 断点优化），
+*   换来**日志合法**。`bootstrapTools` 因此只是历史字段，`boundary < 0` 分支已让位。 */
 function resolveBootstrapSettings() {
 	return {
 		bootstrapTools: [...DEFAULT_BOOTSTRAP_TOOLS],
@@ -14352,24 +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 route = agent.options;
-			const wrote = appendAnchorHistory(session, typeof route?.provider === "string" ? route.provider : "unknown", typeof route?.model === "string" ? route.model : "unknown");
-			if (wrote && sid !== void 0) anchoredSessions.add(sid);
-			if (wrote) warnOnce(`anchor history fabricated: ${SETTINGS.anchorMessages.length} 轮（不再真跑）`);
-			return;
 		} catch {}
 	});
 	let warned = false;
@@ -14408,10 +14509,11 @@ function registerBootstrap(ctx) {
 				};
 			}
 			if (status.boundary < 0) return assembled;
-			const keep = new Set(SETTINGS.compactionTools);
+			const keep = new Set(SETTINGS.bootstrapTools);
+			for (const toolName of SETTINGS.compactionTools) keep.add(toolName);
 			const missing = [...keep].filter((name) => !available.has(name));
 			if (missing.length > 0) {
-				warnOnce(`expected compaction tools missing=${JSON.stringify(missing)} — bootstrap disabled, full catalog exposed`);
+				warnOnce(`expected bootstrap tools missing=${JSON.stringify(missing)} — bootstrap disabled, full catalog exposed`);
 				return assembled;
 			}
 			return {

package/lib/seams/bootstrap.d.ts

@@ -60,34 +60,57 @@ export declare const DEFAULT_ANCHOR_MESSAGES: string[];
  */
 export declare function hasUserMessageHistory(session: unknown): boolean;
 /**
- * 把两轮 first-anchor 对话**直接写进会话日志**，取代原来的「真跑两轮」。
+ * 会话里是否已有模型回复（= 已经不是首轮）。
  *
- * ## 为什么可以这样（三条取证，全部打在真 `@deepseek-ai/dsh-session` 上）
+ * 🔴 这是锚定的**形状判据**（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」的整套方案因此作废**。
  *
- * 1. **system 必须是 surface node 0**，而 `agent/pre-step` 跑在宿主提交 system **之前**
- *    ⇒ 若直接写 [anchor…]，system 会被追加到**末尾**（实测：`systemAtIndex: 4`，
- *    且**不报错**、静默走偏）。解法 = **先写一条占位 system**：宿主随后看到 node0
- *    已有 system 且文本不同 ⇒ 走 `replace(head)` 换成真提示词，锚定历史原样留在其后。
- * 2. **`contentGeneration` 只在 replace 时涨，append 不涨**；而 `buildRequest()`
- *    取 generation 快照**晚于** `systemPrompt.project()` ⇒ 那次 replace 不会被
- *    误判成「系列断裂」（不会误触发 `startsSeries`）。
- * 3. **造出来的 `assistant/message` 合法**：`stream: []` 通过校验；整段历史之后
- *    仍可被 compaction 的 `surfaceOp: replace` 整体覆盖（不炸）。
+ * **约束 B — 必须写在宿主提交 `system/message` 之后**：格式层有 `protectedHead`
+ *   机制 —— `foldSurface()` 里 `system/message` 若在 **surface 非空且尚无 protectedHead**
+ *   时到来，直接抛 `system/message requires a protected first surface head`。
+ *   也就是说：**surface 的第一个节点必须是 system**。
+ *   ⇒ 若我们先写 user 消息，宿主随后的 system 就落不到首位 ⇒ 重放同样判 corrupt。
+ *   ⚠️ 这条是**第一次修复后仍然翻车**的原因（同一会话、不同报错），
+ *   判据仍是「重启宿主后重新进入该会话」。
  *
- * ## ⚠️ 为什么不发 turn/start、turn/end
+ * ⇒ 因此调用时机 = **`session/event` 里看到该会话第一条 `system/message` 之后**（见下方注册处），
+ *   而不是 `agent/inbox/inserted`（那太早）。
  *
- * 宿主的 turn 计数是**构造时缓存**的：`phase.lastTurn` 在本钩子触发前已读定（0），
- * 之后 `turn()` 恒用 `phase.turn + 1`。我们若自己发 `turn/start{1}{2}`，宿主随后
- * 仍会再发一条 `turn/start{1}` ⇒ **重复编号 ∧ 两个 turn 同时开着**。
- * ⇒ 只给消息打 **turn 标签**（模型可见顺序不依赖 turn 事件，`deriveMessages` 只看
- * surface 节点），**不碰宿主的 turn 账本**。
+ * ## 为什么去掉 assistant 那半不损失什么
+ *
+ * 锚定话语的**唯一目的**是让模型认为自己已经同意过协作协议。
+ * 保留 **2 条 `user/message`** 即可达成；丢掉的只是"模型自己的 ack 回复"——
+ * 而那原本也是**我们伪造的**，不是模型真说过的。
+ *
+ * ## 判据（改这个函数前后都必须跑）
+ *
+ * ① 单测钉形状（只许 user/message）；
+ * ② **容器内真跑一轮 → 重启宿主 → 重新进入该会话** —— 只有这条路能证明日志合法
+ *   （前两次修复都是"单测全绿 + 首轮正常"却仍然 corrupt）。
+ * ③ 直接调宿主自己的 `assertReleasedV4Relationships()` 判形状，**不要自写复刻**。
  *
  * @param session 会话（需有 append）
- * @param provider 当前路由 provider（写入 assistant 消息来源）
- * @param model 当前模型 id
+ * @param anchorMessages 锚定话语序列（缺省协议固有两条）
  * @returns 是否成功写入
  */
-export declare function appendAnchorHistory(session: unknown, provider: string, model: string, anchorMessages?: string[]): boolean;
+export declare function appendAnchorHistory(session: unknown, anchorMessages?: string[]): boolean;
 interface PromotionStatus {
     /** 最后一次 compaction/end 的 seq（-1 = 未压缩过） */
     boundary: number;
@@ -114,16 +137,18 @@ interface PromotionTracker {
  * 通常 ≤ 2 < 默认兜底 3，不受影响。
  */
 export declare function createEpochPromotion(promoteEvents: Set<'tool/call' | 'assistant/message'>, requiredSignals?: number, maxRoundsFallback?: number): PromotionTracker;
-/** 协议固有 bootstrap 设置：**zeroTools=false**（v1.60 起）。
+/** 协议固有 bootstrap 设置（v1.62 / D140）。
+ *
+ * 🔴 **zeroTools 必须为 false**：v1.62 起锚定历史**只造 `user/message`**（不含伪造的
+ *   `assistant/message`）⇒ **首请求时晋升信号尚未满足** ⇒ 若仍 `zeroTools: true`，
+ *   首请求会真的退化成「0 工具」，模型看不到任何 ACC 工具。
  *
- * 🔴 **为什么从 true 改成 false**（owner 令 2026-10-17，造历史取代真跑）：
- *   锚定历史现在**直接写进日志**，因此 `assistant/message` 晋升信号在首请求前
- *   就已满足 ⇒ `boundary < 0` 分支实际不可达。但**不能依赖"恰好满足"这个副作用**：
- *   若哪天锚定历史没写成（例如非 CCC 会话/异常降级），`zeroTools: true` 会退回到
- *   「首请求 0 工具」，那是**另一种**退化。显式关掉 ⇒ 任何情况下首请求都拿完整目录。
+ * 🔴 **为什么不改回去伪造一条 assistant**：宿主 v4 校验要求 `assistant/message` 落在
+ *   已打开的 turn+step 内（见 `appendAnchorHistory` 头注释），而锚定写入时 turn/step
+ *   都还没打开 ⇒ 伪造它**结构性非法**，代价是「重新进入会话即 corrupt」。
  *
- * ⚠️ 这意味着 `bootstrapTools` 窄化也随之失效 —— 它的作用本来就是"首请求窄目录"，
- *   而造历史的目的正是**取消这个断点**。保留字段只为不破坏旧测试的引用面。 */
+ * ⇒ 取舍：**首请求就给完整工具目录**（放弃「首请求窄目录」这个 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.61.0",
-  "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",