@shgroup/dsh-serenity-hooks 1.16.2 → 1.16.4

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.16.2",
+  "version": "1.16.4",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：真实 DSH 工具 cc_fs/session/acc_msm/eap/neat/cce/loop + 拦截缝机械约束（safe-mode/路径守卫/会话落盘）。适配 DSH 公开版（0.1.0-rc，deepseek-ai/deepseek-harness）。私有（dsh-external 组织）。",
   "engines": {

package/lib/index.js

@@ -3,11 +3,11 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 import { appendFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { execFile, execFileSync, spawnSync } from "node:child_process";
-import { platform } from "node:os";
+import { homedir, platform } from "node:os";
 import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
 import { randomBytes } from "node:crypto";
-import { fileURLToPath } from "node:url";
 //#region src/ccc.ts
 /**
 * ccc.ts — CCC 纯逻辑层（零 DSH 依赖，可独立单测）
@@ -986,6 +986,225 @@ const sessionTool = defineTool({
 	}
 });
 //#endregion
+//#region src/constants.ts
+/** 常量（纯模块，零 DSH 依赖） */
+/**
+* ACC 版本：自动从 package.json 读取（单一真相源，消除与 CHANGELOG 的漂移）。
+* 发布时只需改 package.json 的 version。
+*/
+const ACC_VERSION = (() => {
+	try {
+		const here = dirname(fileURLToPath(import.meta.url));
+		return JSON.parse(readFileSync(join(here, "..", "package.json"), "utf-8")).version ?? "0.0.0";
+	} catch {
+		return "0.0.0";
+	}
+})();
+//#endregion
+//#region src/seams/guards.ts
+/**
+* guards.ts — 拦截缝：安全模式 + 路径守卫（P3 语义的机械层）
+*
+* 纯决策逻辑（decideGuard）与 DSH 注册（registerGuards）分离：
+* 前者零 DSH 依赖可单测，后者把决策接到 tools/pre-execute 瀑布 + ctx.tools.guard 终局。
+*
+* 对应 opencode-serenity-plugin 的 tool.execute.before 路径守卫 + bash 开关 + 黑名单。
+*/
+/**
+* 安全模式 + 黑名单 + P3 路径守卫的纯决策。
+* 对齐 opencode-serenity-plugin 标准：安全模式 = **bash 禁用** + 写入黑名单；
+* write/edit 等工具仅受路径逃逸与黑名单约束（不整体禁用）。
+* 优先级：safe-mode bash > 路径越界 > 黑名单命中。
+*/
+function decideGuard(input) {
+	const { root, toolName, safeModeOn, blacklist, pathArg } = input;
+	if (safeModeOn && toolName === "bash") return {
+		deny: `bash: 没有这个工具`,
+		kind: "deny"
+	};
+	if (pathArg !== void 0) {
+		const rel = relative(root, resolve(root, pathArg));
+		if (rel.startsWith("..")) return {
+			deny: `path escape blocked: "${pathArg}" 越出 CCC 根`,
+			kind: "deny"
+		};
+		if (rel === ".serenity-safe-on" || rel === ".serenity" || rel.startsWith(".serenity-safe-on/") || rel.startsWith(".serenity/")) return {
+			deny: `CCC 治理文件 "${rel}" 保留给用户，agent 不可写`,
+			kind: "deny"
+		};
+		const hit = matchBlacklist(rel, blacklist);
+		if (hit) return {
+			deny: `blacklist blocked: "${pathArg}" 命中规则 "${hit}"`,
+			kind: "deny"
+		};
+	}
+	return { kind: "allow" };
+}
+/** 从 exec 提取 agent 会话 cwd（CCC 根检测基准）；无则回退进程 cwd */
+function resolveAgentCwd(exec) {
+	return exec.agent?.session?.header?.cwd ?? process.cwd();
+}
+/** 安全模式开启时从模型工具列表隐藏的工具（只隐藏 bash；write/edit 保留） */
+const SAFE_MODE_DENY_TOOLS = ["bash"];
+/** agent key → restrict disposer（安全模式工具隐藏状态） */
+const safeModeRestrictions = /* @__PURE__ */ new Map();
+const restrictDiag = {
+	lastKey: null,
+	lastAttemptAt: null,
+	lastSuccess: null,
+	lastError: null,
+	activeKeys: []
+};
+function getRestrictDiagnostics() {
+	return {
+		...restrictDiag,
+		activeKeys: [...safeModeRestrictions.keys()]
+	};
+}
+/** 诊断落盘：AGENT_SESSIONS/.restrict-diag.json（文件通道，避免 HTTP 自锁） */
+function writeRestrictDiag(root) {
+	try {
+		const dir = resolve(root, "AGENT_SESSIONS");
+		mkdirSync(dir, { recursive: true });
+		writeFileSync(resolve(dir, ".restrict-diag.json"), JSON.stringify({
+			...getRestrictDiagnostics(),
+			cccRoot: root
+		}, null, 2) + "\n", "utf-8");
+	} catch {}
+}
+/**
+* 同步安全模式工具隐藏：标记存在 → agent.ctx.tools.restrict deny 隐藏写工具；
+* 标记消失 → 解除。pre-step 每步调用 → 切换实时生效。
+*/
+function syncSafeModeRestriction(agent, root) {
+	const key = agent.session.id ?? "global";
+	const on = isSafeModeOn(root);
+	const existing = safeModeRestrictions.get(key);
+	if (on && !existing) try {
+		const dispose = agent.ctx.tools.restrict({ deny: [...SAFE_MODE_DENY_TOOLS] });
+		safeModeRestrictions.set(key, dispose);
+		restrictDiag.lastKey = key;
+		restrictDiag.lastAttemptAt = (/* @__PURE__ */ new Date()).toISOString();
+		restrictDiag.lastSuccess = true;
+		restrictDiag.lastError = null;
+	} catch (e) {
+		restrictDiag.lastKey = key;
+		restrictDiag.lastAttemptAt = (/* @__PURE__ */ new Date()).toISOString();
+		restrictDiag.lastSuccess = false;
+		restrictDiag.lastError = e.message;
+		console.error(`[serenity-hooks] restrict 失败 (key=${key}):`, e.message);
+	}
+	else if (!on && existing) {
+		try {
+			existing();
+		} catch (e) {
+			console.error(`[serenity-hooks] restrict 解除失败 (key=${key}):`, e.message);
+		}
+		safeModeRestrictions.delete(key);
+	}
+	writeRestrictDiag(root);
+}
+/** 从 exec 参数中提取常见路径字段（write/edit 工具）；宽松读取 */
+function extractPathArg(exec) {
+	const args = exec.arguments;
+	if (args === null || typeof args !== "object") return void 0;
+	const a = args;
+	for (const key of [
+		"path",
+		"file_path",
+		"target",
+		"dst"
+	]) {
+		const v = a[key];
+		if (typeof v === "string") return v;
+	}
+}
+/**
+* 注册守卫：tools/pre-execute 瀑布 + ctx.tools.guard 终局。
+* 两者都从 CCC 根实时读取配置（无状态、无缓存）。
+*/
+function registerGuards(ctx, opts = {}) {
+	const configPaths = opts.configPaths;
+	const evaluate = (exec) => {
+		const root = findSerenityRoot(resolveAgentCwd(exec));
+		if (!root) return { kind: "allow" };
+		const safeModeOn = isSafeModeOn(root);
+		const blacklist = readBlacklist(root, configPaths);
+		const pathArg = extractPathArg(exec);
+		return decideGuard({
+			root,
+			toolName: exec.name,
+			safeModeOn,
+			blacklist,
+			pathArg
+		});
+	};
+	ctx.on("tools/pre-execute", async (exec, next) => {
+		const d = evaluate(exec);
+		if (d.deny) return {
+			kind: "deny",
+			reason: d.deny
+		};
+		return next();
+	});
+	ctx.tools.guard((exec) => {
+		return evaluate(exec).deny;
+	});
+}
+//#endregion
+//#region src/status.ts
+/**
+* status.ts — 状态与安全模式操作（纯逻辑，零 DSH 依赖，可独立单测）
+*
+* WebUI 停靠栏的数据源：ACC 版本 / CCC 根 / safe-mode 状态 / 黑名单 / keeper 阈值 / loop 模型。
+* setSafeMode 直接读写 .serenity-safe-on 标记（守卫实时读取，写即生效）。
+*/
+/** 读取已安装 DSH CLI 版本（npm 全局 @deepseek-ai/dsh）；读不到返回 null */
+function readDshVersion() {
+	try {
+		const pkg = JSON.parse(readFileSync(join(homedir(), ".npm-global", "lib", "node_modules", "@deepseek-ai", "dsh", "package.json"), "utf-8"));
+		return typeof pkg.version === "string" ? pkg.version : null;
+	} catch {
+		return null;
+	}
+}
+function getStatus(cwd, configPaths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	const root = findSerenityRoot(cwd);
+	const restrict = getRestrictDiagnostics();
+	const common = {
+		accVersion: ACC_VERSION,
+		dshVersion: readDshVersion(),
+		nodeVersion: process.version
+	};
+	if (!root) return {
+		root: null,
+		...common,
+		safeModeOn: false,
+		blacklist: [],
+		threshold: null,
+		loopModel: null,
+		restrict
+	};
+	const cfg = loadSerenityConfig(root, configPaths);
+	return {
+		root,
+		...common,
+		safeModeOn: isSafeModeOn(root),
+		blacklist: readBlacklist(root, configPaths),
+		threshold: cfg.sessionKeeper?.threshold ?? null,
+		loopModel: cfg.loop?.defaultModel ?? null,
+		restrict
+	};
+}
+/** 切换安全模式（写/删标记文件）；返回实际生效状态 */
+function setSafeMode(root, on) {
+	const marker = resolve(root, SAFE_MODE_MARKER);
+	if (on) {
+		if (!existsSync(marker)) writeFileSync(marker, (/* @__PURE__ */ new Date()).toISOString() + "\n", "utf-8");
+	} else rmSync(marker, { force: true });
+	return { on: isSafeModeOn(root) };
+}
+//#endregion
 //#region src/kit-ops.ts
 /**
 * kit-ops.ts — acc_kit 纯操作层（零 DSH 依赖）
@@ -1025,7 +1244,9 @@ function runKit(root, args) {
 				configPath,
 				p1: findSerenityRoot(root) !== null,
 				p2: gitRoot !== null,
-				p3: "enforced-by-dsh-fs-sandbox"
+				p3: "enforced-by-dsh-fs-sandbox",
+				accVersion: ACC_VERSION,
+				dshVersion: readDshVersion()
 			};
 		}
 		case "time": return (/* @__PURE__ */ new Date()).toISOString();
@@ -1498,6 +1719,24 @@ const cceTool = defineTool({
 	}
 });
 //#endregion
+//#region src/loop-preset-inherit.ts
+/**
+* 解析 loop agent 从父 agent 继承的 preset，并组装创建 setup 钩子。
+* @param parentCtx - 发起 loop 的 agent 的 scope ctx；无（headless/非 agent 上下文）时为 undefined。
+* @returns 继承结果：meta 用的 agentPreset 与创建 setup 钩子。
+*/
+function loopPresetInheritance(parentCtx) {
+	if (parentCtx === void 0) return {};
+	const agentPreset = parentCtx.get("agentPresets")?.composedPreset(parentCtx);
+	if (agentPreset === void 0) return {};
+	return {
+		agentPreset,
+		setup: (childCtx) => {
+			childCtx.get("agentPresets")?.composeFrom(childCtx, parentCtx);
+		}
+	};
+}
+//#endregion
 //#region src/loop-ops.ts
 /**
 * loop-ops.ts — acc_loop 纯逻辑层（零 DSH 依赖，可独立单测）
@@ -1587,9 +1826,13 @@ ${resumeNote}
 *   model（选）provider/model（如 minimax-cn-coding-plan/MiniMax-M3）；缺省读 loop.defaultModel
 *   maxRounds（默认 100）轮次上限；每轮等待 agent **无超时**（loop 可永续，agent 工作多久等多久）
 *
-* 机制：ctx.agentLoop.create({provider, model}) 创建专用 agent（进程内），
+* 机制：ctx.agents.create()（带 setup 钩子）创建专用 agent（进程内），
 * 每轮 followup → agent/status idle → 读 session.events 响应 → 写进度 → stop token 检查 → 续跑。
 * 工厂模式：apply 时闭包捕获插件 ctx（工具 execute 无 ctx 参数）。
+*
+* preset 继承：setup 钩子里对子 agent 执行 agentPresets.composeFrom（对齐 subagent 先例），
+* 使 loop agent 继承发起方会话的 agent preset 工具（read/write/edit 等 preset 层工具）。
+* agentPresets 是可选服务——无 preset 装配的环境（无 roster 部署）退化为空工具层（历史行为）。
 */
 function agentCwd$1(exec) {
 	return (exec.agent?.session)?.header?.cwd ?? process.cwd();
@@ -1629,6 +1872,7 @@ function lastAssistantText(agent) {
 	return "";
 }
 /** 创建 loop 工具（闭包捕获插件 ctx → 可访问 ctx.agentLoop） */
+/** 创建 loop 工具（闭包捕获插件 ctx → 可访问 ctx.agentLoop） */
 function createLoopTool(ctx) {
 	return defineTool({
 		name: "loop",
@@ -1673,10 +1917,23 @@ function createLoopTool(ctx) {
 			const stopToken = newStopToken();
 			let progress = readProgress(root, label);
 			const startRound = progress ? Math.min(progress.round + 1, maxRounds) : 1;
-			const loopAgent = ctx.agentLoop.create(`loop-${label}`, {
-				provider,
-				model: modelName
-			}, { cwd: root });
+			const parentCtx = exec.agent?.ctx;
+			const inherited = loopPresetInheritance(parentCtx);
+			if (!ctx.agents) throw new Error("loop: ctx.agents 不可用");
+			const sessionId = `loop-${label}`;
+			const handle = await ctx.agents.create({
+				sessionId,
+				meta: {
+					cwd: root,
+					...inherited.agentPreset === void 0 ? {} : { agentPreset: inherited.agentPreset }
+				},
+				agentOptions: {
+					provider,
+					model: modelName
+				},
+				...inherited.setup === void 0 ? {} : { setup: inherited.setup }
+			});
+			const loopAgent = handle.agent;
 			let done = false;
 			let lastResponse = progress?.lastResponse ?? "";
 			let finalRound = startRound - 1;
@@ -1727,7 +1984,9 @@ function createLoopTool(ctx) {
 					updated: (/* @__PURE__ */ new Date()).toISOString(),
 					lastResponse
 				});
-			} finally {}
+			} finally {
+				await handle.dispose().catch(() => {});
+			}
 			const { json } = loopProgressPaths(root, label);
 			return {
 				done,
@@ -1747,157 +2006,6 @@ function createLoopTool(ctx) {
 	});
 }
 //#endregion
-//#region src/seams/guards.ts
-/**
-* guards.ts — 拦截缝：安全模式 + 路径守卫（P3 语义的机械层）
-*
-* 纯决策逻辑（decideGuard）与 DSH 注册（registerGuards）分离：
-* 前者零 DSH 依赖可单测，后者把决策接到 tools/pre-execute 瀑布 + ctx.tools.guard 终局。
-*
-* 对应 opencode-serenity-plugin 的 tool.execute.before 路径守卫 + bash 开关 + 黑名单。
-*/
-/**
-* 安全模式 + 黑名单 + P3 路径守卫的纯决策。
-* 对齐 opencode-serenity-plugin 标准：安全模式 = **bash 禁用** + 写入黑名单；
-* write/edit 等工具仅受路径逃逸与黑名单约束（不整体禁用）。
-* 优先级：safe-mode bash > 路径越界 > 黑名单命中。
-*/
-function decideGuard(input) {
-	const { root, toolName, safeModeOn, blacklist, pathArg } = input;
-	if (safeModeOn && toolName === "bash") return {
-		deny: `bash: 没有这个工具`,
-		kind: "deny"
-	};
-	if (pathArg !== void 0) {
-		const rel = relative(root, resolve(root, pathArg));
-		if (rel.startsWith("..")) return {
-			deny: `path escape blocked: "${pathArg}" 越出 CCC 根`,
-			kind: "deny"
-		};
-		if (rel === ".serenity-safe-on" || rel === ".serenity" || rel.startsWith(".serenity-safe-on/") || rel.startsWith(".serenity/")) return {
-			deny: `CCC 治理文件 "${rel}" 保留给用户，agent 不可写`,
-			kind: "deny"
-		};
-		const hit = matchBlacklist(rel, blacklist);
-		if (hit) return {
-			deny: `blacklist blocked: "${pathArg}" 命中规则 "${hit}"`,
-			kind: "deny"
-		};
-	}
-	return { kind: "allow" };
-}
-/** 从 exec 提取 agent 会话 cwd（CCC 根检测基准）；无则回退进程 cwd */
-function resolveAgentCwd(exec) {
-	return exec.agent?.session?.header?.cwd ?? process.cwd();
-}
-/** 安全模式开启时从模型工具列表隐藏的工具（只隐藏 bash；write/edit 保留） */
-const SAFE_MODE_DENY_TOOLS = ["bash"];
-/** agent key → restrict disposer（安全模式工具隐藏状态） */
-const safeModeRestrictions = /* @__PURE__ */ new Map();
-const restrictDiag = {
-	lastKey: null,
-	lastAttemptAt: null,
-	lastSuccess: null,
-	lastError: null,
-	activeKeys: []
-};
-function getRestrictDiagnostics() {
-	return {
-		...restrictDiag,
-		activeKeys: [...safeModeRestrictions.keys()]
-	};
-}
-/** 诊断落盘：AGENT_SESSIONS/.restrict-diag.json（文件通道，避免 HTTP 自锁） */
-function writeRestrictDiag(root) {
-	try {
-		const dir = resolve(root, "AGENT_SESSIONS");
-		mkdirSync(dir, { recursive: true });
-		writeFileSync(resolve(dir, ".restrict-diag.json"), JSON.stringify({
-			...getRestrictDiagnostics(),
-			cccRoot: root
-		}, null, 2) + "\n", "utf-8");
-	} catch {}
-}
-/**
-* 同步安全模式工具隐藏：标记存在 → agent.ctx.tools.restrict deny 隐藏写工具；
-* 标记消失 → 解除。pre-step 每步调用 → 切换实时生效。
-*/
-function syncSafeModeRestriction(agent, root) {
-	const key = agent.session.id ?? "global";
-	const on = isSafeModeOn(root);
-	const existing = safeModeRestrictions.get(key);
-	if (on && !existing) try {
-		const dispose = agent.ctx.tools.restrict({ deny: [...SAFE_MODE_DENY_TOOLS] });
-		safeModeRestrictions.set(key, dispose);
-		restrictDiag.lastKey = key;
-		restrictDiag.lastAttemptAt = (/* @__PURE__ */ new Date()).toISOString();
-		restrictDiag.lastSuccess = true;
-		restrictDiag.lastError = null;
-	} catch (e) {
-		restrictDiag.lastKey = key;
-		restrictDiag.lastAttemptAt = (/* @__PURE__ */ new Date()).toISOString();
-		restrictDiag.lastSuccess = false;
-		restrictDiag.lastError = e.message;
-		console.error(`[serenity-hooks] restrict 失败 (key=${key}):`, e.message);
-	}
-	else if (!on && existing) {
-		try {
-			existing();
-		} catch (e) {
-			console.error(`[serenity-hooks] restrict 解除失败 (key=${key}):`, e.message);
-		}
-		safeModeRestrictions.delete(key);
-	}
-	writeRestrictDiag(root);
-}
-/** 从 exec 参数中提取常见路径字段（write/edit 工具）；宽松读取 */
-function extractPathArg(exec) {
-	const args = exec.arguments;
-	if (args === null || typeof args !== "object") return void 0;
-	const a = args;
-	for (const key of [
-		"path",
-		"file_path",
-		"target",
-		"dst"
-	]) {
-		const v = a[key];
-		if (typeof v === "string") return v;
-	}
-}
-/**
-* 注册守卫：tools/pre-execute 瀑布 + ctx.tools.guard 终局。
-* 两者都从 CCC 根实时读取配置（无状态、无缓存）。
-*/
-function registerGuards(ctx, opts = {}) {
-	const configPaths = opts.configPaths;
-	const evaluate = (exec) => {
-		const root = findSerenityRoot(resolveAgentCwd(exec));
-		if (!root) return { kind: "allow" };
-		const safeModeOn = isSafeModeOn(root);
-		const blacklist = readBlacklist(root, configPaths);
-		const pathArg = extractPathArg(exec);
-		return decideGuard({
-			root,
-			toolName: exec.name,
-			safeModeOn,
-			blacklist,
-			pathArg
-		});
-	};
-	ctx.on("tools/pre-execute", async (exec, next) => {
-		const d = evaluate(exec);
-		if (d.deny) return {
-			kind: "deny",
-			reason: d.deny
-		};
-		return next();
-	});
-	ctx.tools.guard((exec) => {
-		return evaluate(exec).deny;
-	});
-}
-//#endregion
 //#region src/seams/loop.ts
 /** 解析当前 dsh 会话 scope 的活跃会话 SESSION.md 绝对路径；无标记/越界返回 null */
 function resolveActiveSession(root, scope = DEFAULT_SESSION_SCOPE) {
@@ -2007,21 +2115,6 @@ function registerKeeper(ctx, opts = {}) {
 	});
 }
 //#endregion
-//#region src/constants.ts
-/** 常量（纯模块，零 DSH 依赖） */
-/**
-* ACC 版本：自动从 package.json 读取（单一真相源，消除与 CHANGELOG 的漂移）。
-* 发布时只需改 package.json 的 version。
-*/
-const ACC_VERSION = (() => {
-	try {
-		const here = dirname(fileURLToPath(import.meta.url));
-		return JSON.parse(readFileSync(join(here, "..", "package.json"), "utf-8")).version ?? "0.0.0";
-	} catch {
-		return "0.0.0";
-	}
-})();
-//#endregion
 //#region src/skills-discovery.ts
 /**
 * skills-discovery.ts — CCC 入口 skill 自动发现（纯逻辑，零 DSH 依赖）
@@ -2195,6 +2288,22 @@ function constraintsBlock(root) {
 		""
 	].join("\n");
 }
+/**
+* EAP 自检提示块（DSH 扩展，无 osp 对应——osp 无此块）。
+* 每次输出前的机械自检清单，强化 EAP 表现（E↑ 显式/R↓ 可重建/S↑ 稳定）。
+* 独立块而非塞进 CCE/Constraints：后两者受 osp-alignment 逐字节断言约束。
+*/
+function eapBlock() {
+	return [
+		"",
+		"=== Serenity EAP ===",
+		"每次输出前自检（显式抽象原则：思维的价值 = 外部可重建性）:",
+		"  • E↑ 显式 — 变量/实体明确定义，关系指明方向/基数，边界划定；不用歧义词（\"处理\"\"优化\"→具体化）",
+		"  • R↓ 可重建 — 关键决策记录理由与备选，不跳级讨论（先对齐上层再进下层）",
+		"  • S↑ 稳定 — 结构可重复生成，避免依赖隐含上下文",
+		""
+	].join("\n");
+}
 /** 4) SKILL.md 全文：该 CCC 顶层入口 skill 原文（对齐 osp：原文直推，无包裹头；仅过滤治理内容） */
 function entrySkillSectionText(root) {
 	const skills = findEntrySkills(root);
@@ -2245,12 +2354,13 @@ function sessionBlock(root, scope = DEFAULT_SESSION_SCOPE) {
 		""
 	].join("\n");
 }
-/** 完整系统提示词注入文本：ACC + CCE + Constraints + SKILL 全文 + Session（osp 顺序） */
+/** 完整系统提示词注入文本：ACC + CCE + Constraints + EAP + SKILL 全文 + Session（osp 顺序 + EAP 扩展） */
 function serenitySystemPrompt(root, scope = DEFAULT_SESSION_SCOPE) {
 	const parts = [
 		accBlock(root),
 		cceBlock(),
-		constraintsBlock(root)
+		constraintsBlock(root),
+		eapBlock()
 	];
 	const skill = entrySkillSectionText(root);
 	if (skill) parts.push(skill);
@@ -2258,6 +2368,31 @@ function serenitySystemPrompt(root, scope = DEFAULT_SESSION_SCOPE) {
 	if (session) parts.push(session);
 	return parts.join("\n\n");
 }
+/**
+* Code Mode 适配行：当前 scope 以 Code Mode 呈现工具时（run_code 可见），
+* ACC 块按 native 语义指引"直接调用工具"会与"只有 run_code 可直接调用"的执行
+* 塌缩冲突（模型直呼工具名 → UNKNOWN_TOOL，拒绝信息误导）。追加一行说明，
+* 引导经 run_code 程序内 tools.* 调用。both 模式不塌缩，该行不误导（程序内
+* 调用同样合法），故按 run_code 可见性（code|both）统一附加。
+* @param ctx - 插件 ctx（读 tools 注册表）。
+* @param scope - 装配 scope（agent）；无则按全局视图判断。
+* @returns 适配行（含换行前缀）；非 code/both 返回空串。
+*/
+function codeModeAdaptationLine(ctx, scope) {
+	try {
+		if (!(ctx.tools.get("run_code", scope) !== void 0)) return "";
+	} catch {
+		return "";
+	}
+	return [
+		"",
+		"=== Serenity Code Mode ===",
+		"当前会话以 Code Mode 呈现工具：模型直接调用 ACC 工具名（cc_fs/acc_msm 等）会被拒绝（UNKNOWN_TOOL）。",
+		"请在一个 run_code 程序内经生成的 SDK 绑定调用：`await tools.cc_fs(...)`、`await tools.acc_msm(...)` 等。",
+		"程序只返回你 print/return 的内容——务必 curate 输出。",
+		""
+	].join("\n");
+}
 /** 从 assembly context 解析 agent cwd（subagent/后台 agent 同样带 agent） */
 function agentCwd(context) {
 	return (context.agent?.session)?.header?.cwd;
@@ -2281,7 +2416,9 @@ function registerEntrySkillSectionGlobal(ctx) {
 				if (!cwd) return "";
 				const root = findSerenityRoot(cwd);
 				if (!root) return "";
-				return serenitySystemPrompt(root, agentScope$1(context));
+				const base = serenitySystemPrompt(root, agentScope$1(context));
+				const codeLine = codeModeAdaptationLine(ctx, context.scope);
+				return codeLine ? `${base}\n${codeLine}` : base;
 			}
 		});
 		console.log("[serenity-hooks] ✓ 全局入口 skill section 已注册（systemPrompt 就绪）");
@@ -2289,6 +2426,39 @@ function registerEntrySkillSectionGlobal(ctx) {
 		console.error(`[serenity-hooks] ✗ 全局入口 skill section 注册失败: ${err.message}（检查 inject 是否含 systemPrompt）`);
 	}
 }
+/**
+* agent 级 scoped 注册（P0-1：抗 preset/动态插件同名 shadow）。
+*
+* 为什么 scoped：DSH 的 systemPrompt section 支持 scoped 层同名 shadow 全局
+* （agent.ctx.systemPrompt.section），且 scope 链最近层胜出。若 ACC 只注册全局
+* section，preset 或动态 Cordis 插件可在 scoped 层注册同名 `serenity-entry`
+* 遮蔽 ACC 身份。scoped 注册在 agent 自身层 = 最近层，任何外部组合无法覆盖。
+* 全局注册保留为 fallback（未走 session-start 的 agent / 冷恢复路径）。
+*
+* text 回调闭包持有 root 与 agent：content 固定（该 agent 的 CCC 身份），
+* code-mode 适配按装配 context.scope 判断（与全局版一致）。
+*/
+const sectionedAgents = /* @__PURE__ */ new Set();
+function registerEntrySkillSection(agent, root) {
+	const key = agent.session.id ?? "global";
+	if (sectionedAgents.has(key)) return false;
+	try {
+		const scope = agent.session.id ?? "default";
+		agent.ctx.systemPrompt.section({
+			name: "serenity-entry",
+			order: -50,
+			text: (context) => {
+				const base = serenitySystemPrompt(root, scope);
+				const codeLine = codeModeAdaptationLine(agent.ctx, context.scope);
+				return codeLine ? `${base}\n${codeLine}` : base;
+			}
+		});
+		sectionedAgents.add(key);
+		return true;
+	} catch {
+		return false;
+	}
+}
 //#endregion
 //#region src/seams/context.ts
 const DEFAULT_ENTRY_SKILL_MAX_CHARS = 3e4;
@@ -2345,6 +2515,7 @@ function registerContext(ctx, opts = {}) {
 		const root = findSerenityRoot(agent.session?.header?.cwd ?? process.cwd());
 		if (!root) return;
 		const key = agentKey(agent);
+		registerEntrySkillSection(agent, root);
 		if (injected.has(key)) return;
 		injected.add(key);
 		agent.inject(accMessage(root, configPaths, entrySkillMaxChars, agentScope(agent)));
@@ -2360,9 +2531,12 @@ function registerContext(ctx, opts = {}) {
 		const root = findSerenityRoot(agent.session?.header?.cwd ?? process.cwd());
 		const key = agentKey(agent);
 		const downstream = await next();
-		if (root) try {
-			syncSafeModeRestriction(agent, root);
-		} catch {}
+		if (root) {
+			try {
+				syncSafeModeRestriction(agent, root);
+			} catch {}
+			registerEntrySkillSection(agent, root);
+		}
 		if (!root || injected.has(key) || downstream.kind !== "enter") return downstream;
 		injected.add(key);
 		return {
@@ -2398,45 +2572,6 @@ function registerCompactRetention(ctx, opts = {}) {
 	});
 }
 //#endregion
-//#region src/status.ts
-/**
-* status.ts — 状态与安全模式操作（纯逻辑，零 DSH 依赖，可独立单测）
-*
-* WebUI 停靠栏的数据源：ACC 版本 / CCC 根 / safe-mode 状态 / 黑名单 / keeper 阈值 / loop 模型。
-* setSafeMode 直接读写 .serenity-safe-on 标记（守卫实时读取，写即生效）。
-*/
-function getStatus(cwd, configPaths = DEFAULT_SERENITY_CONFIG_PATHS) {
-	const root = findSerenityRoot(cwd);
-	const restrict = getRestrictDiagnostics();
-	if (!root) return {
-		root: null,
-		accVersion: ACC_VERSION,
-		safeModeOn: false,
-		blacklist: [],
-		threshold: null,
-		loopModel: null,
-		restrict
-	};
-	const cfg = loadSerenityConfig(root, configPaths);
-	return {
-		root,
-		accVersion: ACC_VERSION,
-		safeModeOn: isSafeModeOn(root),
-		blacklist: readBlacklist(root, configPaths),
-		threshold: cfg.sessionKeeper?.threshold ?? null,
-		loopModel: cfg.loop?.defaultModel ?? null,
-		restrict
-	};
-}
-/** 切换安全模式（写/删标记文件）；返回实际生效状态 */
-function setSafeMode(root, on) {
-	const marker = resolve(root, SAFE_MODE_MARKER);
-	if (on) {
-		if (!existsSync(marker)) writeFileSync(marker, (/* @__PURE__ */ new Date()).toISOString() + "\n", "utf-8");
-	} else rmSync(marker, { force: true });
-	return { on: isSafeModeOn(root) };
-}
-//#endregion
 //#region src/api.ts
 const ROUTE_PATH = "/serenity/status";
 function readBody(req) {
@@ -2479,10 +2614,18 @@ function registerStatusApi(ctx, opts = {}) {
 			try {
 				if (req.method === "GET") {
 					const url = new URL(req.url ?? "/", "http://127.0.0.1");
-					sendJson(res, 200, getStatus(resolveWorkspace(ctx, {
+					const status = getStatus(resolveWorkspace(ctx, {
 						sessionId: url.searchParams.get("sessionId") ?? void 0,
 						workspace: url.searchParams.get("workspace") ?? void 0
-					}), configPaths));
+					}), configPaths);
+					const runtime = ctx.get("codeRuntime");
+					sendJson(res, 200, {
+						...status,
+						...runtime === void 0 ? { codeRuntime: null } : { codeRuntime: {
+							language: runtime.language,
+							isolation: runtime.isolation
+						} }
+					});
 					return;
 				}
 				if (req.method === "POST") {
@@ -2662,6 +2805,7 @@ const inject = [
 	"shellEnv",
 	"skills",
 	"agentLoop",
+	"agents",
 	"systemPrompt"
 ];
 const Config = z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.16.2",
+  "version": "1.16.4",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {
@@ -50,6 +50,7 @@
   "peerDependencies": {
     "@deepseek-ai/dsh-agent": "^0.1.0-rc.5",
     "@deepseek-ai/dsh-agent-loop": "^0.1.0-rc.5",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.5",
     "@deepseek-ai/dsh-compaction": "^0.1.0-rc.5",
     "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.5",
@@ -75,6 +76,9 @@
     "@deepseek-ai/dsh-agent-loop": {
       "optional": true
     },
+    "@deepseek-ai/dsh-agent-presets": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-compaction": {
       "optional": true
     }