@shgroup/dsh-serenity-hooks 1.16.3 → 1.16.5

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.16.3",
+  "version": "1.16.5",
   "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": {
@@ -16,7 +16,8 @@
       "eap",
       "neat",
       "cce",
-      "loop"
+      "loop",
+      "localstore"
     ],
     "skills": []
   }

package/lib/index.js

@@ -1,13 +1,13 @@
 import z from "@deepseek-ai/schemastery";
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import { appendFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { appendFileSync, chmodSync, 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 { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { randomBytes } from "node:crypto";
 import { fileURLToPath } from "node:url";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { randomBytes, randomUUID } from "node:crypto";
 //#region src/ccc.ts
 /**
 * ccc.ts — CCC 纯逻辑层（零 DSH 依赖，可独立单测）
@@ -278,7 +278,7 @@ function runCcFs(root, args) {
 function agentCwd$6(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
-function renderText$8(value) {
+function renderText$9(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -330,7 +330,7 @@ const ccFsTool = defineTool({
 	},
 	output: {
 		schema: { type: "json" },
-		render: (args, value) => renderText$8(value)
+		render: (args, value) => renderText$9(value)
 	},
 	async execute(args, exec) {
 		const root = findSerenityRoot(agentCwd$6(exec));
@@ -909,7 +909,7 @@ function agentCwd$5(exec) {
 function agentScope$2(exec) {
 	return exec.agent?.session?.id ?? "default";
 }
-function renderText$7(value) {
+function renderText$8(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -940,7 +940,7 @@ const sessionTool = defineTool({
 	},
 	output: {
 		schema: { type: "json" },
-		render: (args, value) => renderText$7(value)
+		render: (args, value) => renderText$8(value)
 	},
 	async execute(args, exec) {
 		const root = findSerenityRoot(agentCwd$5(exec));
@@ -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();
@@ -1046,7 +1267,7 @@ function runKit(root, args) {
 function agentCwd$4(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
-function renderText$6(value) {
+function renderText$7(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -1069,7 +1290,7 @@ const kitTool = defineTool({
 	},
 	output: {
 		schema: { type: "json" },
-		render: (args, value) => renderText$6(value)
+		render: (args, value) => renderText$7(value)
 	},
 	async execute(args, exec) {
 		const root = findSerenityRoot(agentCwd$4(exec));
@@ -1182,7 +1403,7 @@ function runGit(root, args) {
 function agentCwd$3(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
-function renderText$5(value) {
+function renderText$6(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -1209,7 +1430,7 @@ const gitTool = defineTool({
 	},
 	output: {
 		schema: { type: "json" },
-		render: (args, value) => renderText$5(value)
+		render: (args, value) => renderText$6(value)
 	},
 	async execute(args, exec) {
 		const root = findSerenityRoot(agentCwd$3(exec));
@@ -1225,7 +1446,7 @@ const gitTool = defineTool({
 function agentCwd$2(exec) {
 	return exec.agent?.session?.header?.cwd ?? process.cwd();
 }
-function renderText$4(value) {
+function renderText$5(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -1269,7 +1490,7 @@ const msmTool = defineTool({
 	},
 	output: {
 		schema: { type: "json" },
-		render: (args, value) => renderText$4(value)
+		render: (args, value) => renderText$5(value)
 	},
 	async execute(args, exec) {
 		const root = findSerenityRoot(agentCwd$2(exec));
@@ -1310,7 +1531,7 @@ CCC（home-serenity 等）认知内容编码为 skill/SESSION/设计文档。产
 
 ## 参考
 https://github.com/tellmewhattodo/theory-eap`;
-function renderText$3(value) {
+function renderText$4(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -1330,7 +1551,7 @@ const eapTool = defineTool({
 	} },
 	output: {
 		schema: { type: "string" },
-		render: (_args, value) => renderText$3(value)
+		render: (_args, value) => renderText$4(value)
 	},
 	async execute(args) {
 		if (args.section === "variables") return EAP_CONTENT.split("## 输出前自检清单")[0];
@@ -1371,7 +1592,7 @@ const NEAT_CONTENT = `# Neat 设计协作协议
 2. 等待确认或修正（小步）
 3. 确认后记录决策（写入会话 SESSION.md 或设计文档）
 4. 推进到下一决策点`;
-function renderText$2(value) {
+function renderText$3(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -1387,7 +1608,7 @@ const neatTool = defineTool({
 	} },
 	output: {
 		schema: { type: "string" },
-		render: (_args, value) => renderText$2(value)
+		render: (_args, value) => renderText$3(value)
 	},
 	async execute(args) {
 		if (args.section === "rules") return NEAT_CONTENT.match(/## 四条铁律[\s\S]*?(?=## )/)?.[0] ?? NEAT_CONTENT;
@@ -1450,7 +1671,7 @@ CCE 回答"有结构的知识应如何跨时间持续演化而不丧失连贯性
 ## 与 Serenity 的关系
 Serenity 的会话系统、会话追踪、熵管理机制（SQC 品质循环）都是 CCE 的工程实现；
 CCC 系统提示词中嵌入的行为约束即来自 CCE。`;
-function renderText$1(value) {
+function renderText$2(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -1471,7 +1692,7 @@ const cceTool = defineTool({
 	} },
 	output: {
 		schema: { type: "string" },
-		render: (_args, value) => renderText$1(value)
+		render: (_args, value) => renderText$2(value)
 	},
 	async execute(args) {
 		const section = args.section;
@@ -1616,7 +1837,7 @@ ${resumeNote}
 function agentCwd$1(exec) {
 	return (exec.agent?.session)?.header?.cwd ?? process.cwd();
 }
-function renderText(value) {
+function renderText$1(value) {
 	return [{
 		type: "text",
 		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
@@ -1655,7 +1876,7 @@ function lastAssistantText(agent) {
 function createLoopTool(ctx) {
 	return defineTool({
 		name: "loop",
-		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成或达轮次上限。\n用法：loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .dsh/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：每轮创建全新 agent 工作（读文件/改代码/执行命令），汇报进度后进入下一轮；完成时输出停止标记即终止。**每轮等待无超时**（loop 永续：agent 工作多久等多久，不被超时打断）。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan，maxRounds: 5",
+		description: "牛马循环（老 loop 等效）：用指定模型创建专用 agent 反复执行任务直到完成。\n用法：loop 接受 task（要完成的目标）或依赖 session 上下文；模型缺省读 .dsh/serenity.json 的 loop.defaultModel（当前 minimax-cn-coding-plan/MiniMax-M3，廉价牛马）。\n行为：内部硬性 while 循环驱动 agent 逐轮推进任务，每轮等待无超时（agent 工作多久等多久）。唯一完成条件 = agent 精确回显本轮随机完成码（stop token），防止低智能模型提前结束。调用者不关心轮数——任务交给 loop，完成即返回。\n进度：写入 AGENT_SESSIONS/loop-<label>.md/.json；同 label 再次调用从上次轮次续跑（不重做）。\n约束：loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫/session-keeper）。\n示例：loop 执行「扫描 SQC 并修复 DC 问题」，label: sqc-scan",
 		parameters: {
 			task: {
 				type: "string",
@@ -1676,12 +1897,12 @@ function createLoopTool(ctx) {
 			},
 			maxRounds: {
 				type: "integer",
-				description: "轮次上限（默认 100）"
+				description: "保险阀（防死循环，默认 100；调用者通常无需设置——loop 跑到完成或达此上限）"
 			}
 		},
 		output: {
 			schema: { type: "json" },
-			render: (_args, value) => renderText(value)
+			render: (_args, value) => renderText$1(value)
 		},
 		async execute(args, exec) {
 			const root = findSerenityRoot(agentCwd$1(exec));
@@ -1695,11 +1916,11 @@ function createLoopTool(ctx) {
 			const { provider, model: modelName } = splitModel(model);
 			const stopToken = newStopToken();
 			let progress = readProgress(root, label);
-			const startRound = progress ? Math.min(progress.round + 1, maxRounds) : 1;
+			const startRound = progress ? progress.round + 1 : 1;
 			const parentCtx = exec.agent?.ctx;
 			const inherited = loopPresetInheritance(parentCtx);
 			if (!ctx.agents) throw new Error("loop: ctx.agents 不可用");
-			const sessionId = `loop-${label}`;
+			const sessionId = `loop-${label}-${randomUUID()}`;
 			const handle = await ctx.agents.create({
 				sessionId,
 				meta: {
@@ -1775,166 +1996,364 @@ function createLoopTool(ctx) {
 				progressFile: json,
 				lastResponse: lastResponse.slice(0, 2e3),
 				usage: {
-					how: "loop 用指定模型（默认 M3）创建专用 agent 每轮独立执行任务，完成时输出停止标记即终止",
+					how: "loop 内部硬性 while 驱动 agent 逐轮推进，agent 精确回显随机完成码即终止",
 					progress: `进度在 AGENT_SESSIONS/loop-${label}.md 与 .json；同 label 再调 loop 会从下一轮续跑（不重做）`,
 					constraints: "loop agent 受完整 Serenity 约束（ACC 身份/入口技能系统提示词/守卫）",
-					next: done ? "任务已完成；可查看进度文件收尾" : `任务未完成（${finalRound}/${maxRounds} 轮）；可同 label 续跑或调整 maxRounds`
+					next: done ? "任务已完成；可查看进度文件收尾" : `任务未完成（已达保险阀 ${maxRounds} 轮）；可同 label 续跑`
 				}
 			};
 		}
 	});
 }
 //#endregion
-//#region src/seams/guards.ts
+//#region src/localstore-ops.ts
 /**
-* guards.ts — 拦截缝：安全模式 + 路径守卫（P3 语义的机械层）
+* localstore-ops.ts — localstore 纯逻辑层（零 DSH 依赖，可独立单测）
 *
-* 纯决策逻辑（decideGuard）与 DSH 注册（registerGuards）分离：
-* 前者零 DSH 依赖可单测，后者把决策接到 tools/pre-execute 瀑布 + ctx.tools.guard 终局。
+* ACC 标准本地凭据/配置存储（S133 设计）：
+*   - 一个工具管理两个命名空间：credential（凭据，0600）+ config（偏好，0644）
+*   - 存储于 ~/.serenity/（平台感知：win %USERPROFILE%\.serenity\）
+*   - 两个 YAML 文件：credentials.yaml（扁平 REF→value）+ settings.yaml（命名空间分节）
+*   - 目录 0700
 *
-* 对应 opencode-serenity-plugin 的 tool.execute.before 路径守卫 + bash 开关 + 黑名单。
-*/
-/**
-* 安全模式 + 黑名单 + P3 路径守卫的纯决策。
-* 对齐 opencode-serenity-plugin 标准：安全模式 = **bash 禁用** + 写入黑名单；
-* write/edit 等工具仅受路径逃逸与黑名单约束（不整体禁用）。
-* 优先级：safe-mode bash > 路径越界 > 黑名单命中。
+* YAML 用轻量自实现子集（零依赖）：扁平 `KEY: value` 映射 + `#` 注释。
+* 凭据/配置本质是给 MSM/agent 用的普通 YAML 文件——agent 可按 doc 子命令
+* 说明直接用 fs 工具（read/write）操作；本工具是管理入口 + 规范文档。
 */
-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"
-		};
+const LOCALSTORE_SCOPES = ["credential", "config"];
+/** 根目录名（~/.serenity） */
+const STORE_DIR_NAME = ".serenity";
+/** 凭据文件（0600） */
+const CREDENTIALS_FILENAME = "credentials.yaml";
+/** 配置文件（0644） */
+const SETTINGS_FILENAME = "settings.yaml";
+/** 凭据 key 规范：大写蛇形（命名空间前缀），如 HOME_GITLAB_TOKEN */
+const CREDENTIAL_KEY_RE = /^[A-Z][A-Z0-9_]*$/;
+/** 配置节名规范：小写字母数字连字符 */
+const CONFIG_SECTION_RE = /^[a-z][a-z0-9-]*$/;
+/** 配置 key 规范（节内）：小驼峰（首字母小写，可含大写），如 defaultModel */
+const CONFIG_KEY_RE = /^[a-z][a-zA-Z0-9_]*$/;
+/** 解析 ~/.serenity 根（平台感知：os.homedir() 三平台统一） */
+function serenityDir() {
+	return join(homedir(), STORE_DIR_NAME);
+}
+/** 各命名空间的文件绝对路径 */
+function storeFilePath(scope) {
+	return scope === "credential" ? join(serenityDir(), CREDENTIALS_FILENAME) : join(serenityDir(), SETTINGS_FILENAME);
+}
+/** 确保目录存在并设 0700 */
+function ensureDir(dir) {
+	mkdirSync(dir, { recursive: true });
+	try {
+		chmodSync(dir, 448);
+	} catch {}
+}
+/** 设置文件权限：credential 0600 / config 0644 */
+function applyFileMode(scope, path) {
+	try {
+		chmodSync(path, scope === "credential" ? 384 : 420);
+	} catch {}
+}
+/** 解析扁平映射 YAML → Record<string,string>（忽略 # 注释与空行；值去引号） */
+function parseFlatYaml(text) {
+	const out = {};
+	for (const rawLine of text.split("\n")) {
+		const line = rawLine.trim();
+		if (line === "" || line.startsWith("#")) continue;
+		const idx = line.indexOf(":");
+		if (idx <= 0) continue;
+		const key = line.slice(0, idx).trim();
+		let value = line.slice(idx + 1).trim();
+		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+		out[key] = value;
 	}
-	return { kind: "allow" };
+	return out;
 }
-/** 从 exec 提取 agent 会话 cwd（CCC 根检测基准）；无则回退进程 cwd */
-function resolveAgentCwd(exec) {
-	return exec.agent?.session?.header?.cwd ?? process.cwd();
+/** 序列化扁平映射 YAML（保持 key 顺序，值引号包裹含特殊字符的） */
+function renderFlatYaml(entries) {
+	const lines = [];
+	for (const [key, value] of Object.entries(entries)) {
+		const rendered = /[:#\n]/.test(value) || value === "" || /^\s/.test(value) || /\s$/.test(value) ? JSON.stringify(value) : value;
+		lines.push(`${key}: ${rendered}`);
+	}
+	return lines.join("\n") + (lines.length > 0 ? "\n" : "");
+}
+/** 解析分节 YAML（config）：节 → key → value */
+function parseSectionedYaml(text) {
+	const out = {};
+	let section = "";
+	for (const rawLine of text.split("\n")) {
+		const line = rawLine.trim();
+		if (line === "" || line.startsWith("#")) continue;
+		if (rawLine.length - rawLine.trimStart().length === 0 && line.endsWith(":")) {
+			section = line.slice(0, -1).trim();
+			if (!out[section]) out[section] = {};
+			continue;
+		}
+		if (section === "") continue;
+		const idx = line.indexOf(":");
+		if (idx <= 0) continue;
+		const key = line.slice(0, idx).trim();
+		let value = line.slice(idx + 1).trim();
+		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+		const sectionMap = out[section] ??= {};
+		sectionMap[key] = value;
+	}
+	return out;
 }
-/** 安全模式开启时从模型工具列表隐藏的工具（只隐藏 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() {
+/** 序列化分节 YAML（config）：节 → key → value */
+function renderSectionedYaml(sections) {
+	const lines = [];
+	for (const [section, entries] of Object.entries(sections)) {
+		lines.push(`${section}:`);
+		for (const [key, value] of Object.entries(entries)) {
+			const rendered = /[:#\n]/.test(value) || value === "" || /^\s/.test(value) || /\s$/.test(value) ? JSON.stringify(value) : value;
+			lines.push(`  ${key}: ${rendered}`);
+		}
+	}
+	return lines.join("\n") + (lines.length > 0 ? "\n" : "");
+}
+/** 读取命名空间全部条目（文件不存在返回空） */
+function readStore(scope) {
+	const path = storeFilePath(scope);
+	if (!existsSync(path)) return scope === "credential" ? {} : {};
+	const text = readFileSync(path, "utf-8");
+	return scope === "credential" ? parseFlatYaml(text) : parseSectionedYaml(text);
+}
+/** 校验凭据 key 合法（大写蛇形）；不合法抛错 */
+function assertCredentialKey(key) {
+	if (!CREDENTIAL_KEY_RE.test(key)) throw new Error(`credential key "${key}" 必须匹配大写蛇形 ^[A-Z][A-Z0-9_]*$（如 HOME_GITLAB_TOKEN）`);
+}
+/** 校验 config 路径（节.key）；不合法抛错 */
+function assertConfigPath(path) {
+	const idx = path.indexOf(".");
+	if (idx <= 0 || idx === path.length - 1) throw new Error(`config path "${path}" 必须为 section.key（如 loop.defaultModel）`);
+	const section = path.slice(0, idx);
+	const key = path.slice(idx + 1);
+	if (!CONFIG_SECTION_RE.test(section)) throw new Error(`config 节 "${section}" 必须匹配 ^[a-z][a-z0-9-]*$`);
+	if (!CONFIG_KEY_RE.test(key)) throw new Error(`config key "${key}" 必须匹配小驼峰 ^[a-z][a-zA-Z0-9_]*$（如 defaultModel）`);
 	return {
-		...restrictDiag,
-		activeKeys: [...safeModeRestrictions.keys()]
+		section,
+		key
 	};
 }
-/** 诊断落盘：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 {}
+/** 写入单个条目（自动建目录/设权限；保留其他条目与注释行外内容） */
+function writeEntry(scope, name, value) {
+	const path = storeFilePath(scope);
+	ensureDir(serenityDir());
+	if (scope === "credential") {
+		assertCredentialKey(name);
+		const entries = parseFlatYaml(existsSync(path) ? readFileSync(path, "utf-8") : "");
+		entries[name] = value;
+		writeFileSync(path, renderFlatYaml(entries), "utf-8");
+	} else {
+		const { section, key } = assertConfigPath(name);
+		const sections = parseSectionedYaml(existsSync(path) ? readFileSync(path, "utf-8") : "");
+		if (!sections[section]) sections[section] = {};
+		sections[section][key] = value;
+		writeFileSync(path, renderSectionedYaml(sections), "utf-8");
+	}
+	applyFileMode(scope, path);
+}
+/** 删除单个条目（不存在返回 false） */
+function unsetEntry(scope, name) {
+	const path = storeFilePath(scope);
+	if (!existsSync(path)) return false;
+	if (scope === "credential") {
+		assertCredentialKey(name);
+		const entries = parseFlatYaml(readFileSync(path, "utf-8"));
+		if (!(name in entries)) return false;
+		delete entries[name];
+		writeFileSync(path, renderFlatYaml(entries), "utf-8");
+		return true;
+	}
+	const { section, key } = assertConfigPath(name);
+	const sections = parseSectionedYaml(readFileSync(path, "utf-8"));
+	const sectionMap = sections[section];
+	if (!sectionMap || !(key in sectionMap)) return false;
+	delete sectionMap[key];
+	if (Object.keys(sectionMap).length === 0) delete sections[section];
+	writeFileSync(path, renderSectionedYaml(sections), "utf-8");
+	return true;
+}
+/** 读取单个条目值；不存在返回 null */
+function getEntry(scope, name) {
+	const path = storeFilePath(scope);
+	if (!existsSync(path)) return null;
+	if (scope === "credential") {
+		assertCredentialKey(name);
+		return parseFlatYaml(readFileSync(path, "utf-8"))[name] ?? null;
+	}
+	const { section, key } = assertConfigPath(name);
+	return parseSectionedYaml(readFileSync(path, "utf-8"))[section]?.[key] ?? null;
+}
+/** 列出 key（凭据只返回 key 名，不返回值） */
+function listKeys(scope) {
+	const data = readStore(scope);
+	if (scope === "credential") return Object.keys(data);
+	return Object.entries(data).flatMap(([section, entries]) => Object.keys(entries).map((key) => `${section}.${key}`));
 }
 /**
-* 同步安全模式工具隐藏：标记存在 → agent.ctx.tools.restrict deny 隐藏写工具；
-* 标记消失 → 解除。pre-step 每步调用 → 切换实时生效。
+* doc 说明文本：输出存储位置/格式/key 规范/权限/读写方法/安全边界。
+* agent 据此可直接用 fs 工具（read/write）自己读写凭据/配置。
 */
-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);
+function docText() {
+	const dir = serenityDir();
+	const credPath = storeFilePath("credential");
+	const cfgPath = storeFilePath("config");
+	return [
+		"# localstore — ACC 本地凭据/配置存储（标准）",
+		"",
+		"一个工具管理两个命名空间：credential（凭据，0600）+ config（偏好，0644）。",
+		"存储于用户主目录，不在任何 CCC git 仓库内。",
+		"",
+		"## 存储位置（平台感知）",
+		`- 根目录: ${dir}  (0700)`,
+		`- 凭据:   ${credPath}  (0600)`,
+		`- 配置:   ${cfgPath}  (0644)`,
+		"- Windows: %USERPROFILE%\\.serenity\\...（与 Linux/macOS 的 $HOME/.serenity 同构）",
+		"",
+		"## 格式",
+		"credentials.yaml（扁平映射，key = 大写蛇形命名空间前缀）：",
+		"```yaml",
+		"HOME_GITLAB_TOKEN: xxx",
+		"SSH_UBUNTU_PASSWORD: xxx",
+		"ANYSEARCH_API_KEY: xxx",
+		"```",
+		"settings.yaml（命名空间分节）：",
+		"```yaml",
+		"loop:",
+		"  defaultModel: minimax-cn-coding-plan/MiniMax-M3",
+		"ui:",
+		"  theme: dark",
+		"```",
+		"",
+		"## key 规范",
+		"- credential key: ^[A-Z][A-Z0-9_]*$（如 HOME_GITLAB_TOKEN）",
+		"- config path: section.key（节 ^[a-z][a-z0-9-]*$，key 小驼峰 ^[a-z][a-zA-Z0-9_]*$，如 loop.defaultModel）",
+		"",
+		"## 读取方法（agent 可直接用 fs 工具）",
+		"- 用 read 工具读对应文件 → 按上面格式解析 YAML",
+		"- 或用 localstore get <name> [--scope credential|config]",
+		"",
+		"## 写入方法",
+		"- 推荐：localstore set <name> <value> [--scope ...]（自动建目录/设权限/保留其他条目）",
+		"- 或直接用 write/edit 工具修改文件，保持 YAML 合法（键值冒号分隔）",
+		"",
+		"## 安全边界",
+		"- list/show 对 credential 只返回 key 名，不返回值",
+		"- 凭据值应在 agent 内部使用，不要写入对话/日志",
+		"- 文件权限不符（非 0600/0644）时 get/set 会提示 chmod 修复",
+		"- 文件在用户主目录，天然不进入任何 git 仓库",
+		""
+	].join("\n");
 }
-/** 从 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;
+/** 运行 localstore 操作（纯逻辑；返回 JSON 值供工具 render） */
+function runLocalStore(args) {
+	const scope = args.scope === "config" ? "config" : "credential";
+	switch (args.action) {
+		case "list": return {
+			scope,
+			keys: listKeys(scope)
+		};
+		case "get": {
+			if (!args.name) throw new Error("get 需要 name");
+			const value = getEntry(scope, args.name);
+			if (value === null) throw new Error(`not found: ${args.name}（scope=${scope}）`);
+			return {
+				scope,
+				name: args.name,
+				value,
+				source: scope
+			};
+		}
+		case "set":
+			if (!args.name) throw new Error("set 需要 name");
+			if (args.value === void 0) throw new Error("set 需要 value");
+			writeEntry(scope, args.name, args.value);
+			return {
+				scope,
+				name: args.name,
+				set: true
+			};
+		case "unset": {
+			if (!args.name) throw new Error("unset 需要 name");
+			const removed = unsetEntry(scope, args.name);
+			return {
+				scope,
+				name: args.name,
+				removed
+			};
+		}
+		case "show": {
+			if (!args.name) throw new Error("show 需要 name");
+			const exists = getEntry(scope, args.name) !== null;
+			return {
+				scope,
+				name: args.name,
+				exists,
+				path: storeFilePath(scope)
+			};
+		}
+		case "doc": return { doc: docText() };
+		default: throw new Error(`未知子命令: ${args.action}（可用 list/get/set/unset/show/doc）`);
 	}
 }
+//#endregion
+//#region src/tools/localstore.ts
 /**
-* 注册守卫：tools/pre-execute 瀑布 + ctx.tools.guard 终局。
-* 两者都从 CCC 根实时读取配置（无状态、无缓存）。
+* localstore.ts — localstore 真实 DSH 工具定义（defineTool）
+*
+* ACC 标准本地凭据/配置存储（S133 设计）。进程内注册，零 DSH 依赖逻辑在
+* localstore-ops.ts（可单测）。doc 子命令输出存储规范，agent 可直接用 fs
+* 工具（read/write）自己读写。
 */
-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;
-	});
+const ACTIONS = [
+	"list",
+	"get",
+	"set",
+	"unset",
+	"show",
+	"doc"
+];
+function renderText(value) {
+	return [{
+		type: "text",
+		text: typeof value === "string" ? value : JSON.stringify(value, null, 2)
+	}];
 }
+const localstoreTool = defineTool({
+	name: "localstore",
+	description: "ACC 标准本地凭据/配置存储：一个工具管理两个命名空间 credential（凭据，0600）与 config（本地偏好，0644）。存储于用户主目录 ~/.serenity/（平台感知，不在任何 git 仓库内）。子命令：list（列 key，凭据不返回值）/ get <name>（读值）/ set <name> <value>（写）/ unset <name>（删）/ show <name>（元数据，凭据不打印值）/ doc（输出存储规范——路径/格式/key 规范/权限，agent 可按说明直接用 read/write 操作文件）。默认 scope=credential；config 需传 --scope config（路径为 section.key，如 loop.defaultModel）。",
+	parameters: {
+		action: {
+			type: "string",
+			enum: [...ACTIONS],
+			required: true,
+			description: "子命令：list/get/set/unset/show/doc"
+		},
+		name: {
+			type: "string",
+			description: "条目名（credential 用大写蛇形；config 用 section.key）"
+		},
+		value: {
+			type: "string",
+			description: "set 的值"
+		},
+		scope: {
+			type: "string",
+			enum: [...LOCALSTORE_SCOPES],
+			description: "命名空间 credential|config（默认 credential）"
+		}
+	},
+	output: {
+		schema: { type: "json" },
+		render: (args, value) => renderText(value)
+	},
+	async execute(args) {
+		return runLocalStore(args);
+	}
+});
 //#endregion
 //#region src/seams/loop.ts
 /** 解析当前 dsh 会话 scope 的活跃会话 SESSION.md 绝对路径；无标记/越界返回 null */
@@ -2045,21 +2464,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 依赖）
@@ -2161,6 +2565,7 @@ function accBlock(root) {
 		"  neat     — return the full Neat design collaboration protocol",
 		"  cce      — return the full Cognitive Continuity Engineering framework",
 		"  loop     — 牛马循环：指定模型专用 agent 反复执行",
+		"  localstore — ACC 本地凭据/配置存储（credential 0600 + config 0644，~/.serenity/）；doc 子命令输出规范",
 		"",
 		"The DSH platform tools remain available too (read/write/edit/glob/grep/web_search/ask_user_question/subagent/workflow/goal and more) — the ACC tools above are the serenity-native layer, not the only tools.",
 		"",
@@ -2233,6 +2638,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);
@@ -2283,12 +2704,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);
@@ -2296,6 +2718,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;
@@ -2319,7 +2766,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 就绪）");
@@ -2327,6 +2776,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;
@@ -2383,6 +2865,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)));
@@ -2398,9 +2881,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 {
@@ -2436,45 +2922,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) {
@@ -2517,10 +2964,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") {
@@ -2700,6 +3155,7 @@ const inject = [
 	"shellEnv",
 	"skills",
 	"agentLoop",
+	"agents",
 	"systemPrompt"
 ];
 const Config = z.object({
@@ -2727,6 +3183,7 @@ function apply(ctx, config) {
 		ctx.tools.register(neatTool);
 		ctx.tools.register(cceTool);
 		ctx.tools.register(createLoopTool(ctx));
+		ctx.tools.register(localstoreTool);
 	}
 	if (config.guards) registerGuards(ctx, { configPaths: config.serenityConfigPaths });
 	if (config.turnFlush) registerTurnFlush(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.16.3",
+  "version": "1.16.5",
   "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": {