@shgroup/dsh-serenity-hooks 1.30.14 → 1.30.15

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.30.14",
+  "version": "1.30.15",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——10 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/autopilot-trajectory）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/自主巡航。适配 DSH 0.1.2-rc.1（deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/ccc.d.ts

@@ -178,6 +178,15 @@ export interface WeixinRouteConfig {
 export interface SkiffRoleConfig {
     /** 角色模型（provider/model；CCC 直接指定，无白名单校验——用户拍板） */
     model?: string;
+    /**
+     * 角色类型（v1.30.15，S142 用户拍板"skiff 应该区分的类型是临时和长期"）：
+     * - `temporary`：临时 skiff——不绑定 trajectory（无 SESSION.md 工作台），
+     *   提示词按创建时快照注入（"注入发生一次"）。
+     * - `persistent`：长期 skiff——绑定 trajectory（自动建/恢复 SESSION.md 工作台），
+     *   提示词**每轮动态重读文件**（改 `systemPromptFile` 即生效，无需重启）。
+     * 缺省（未写）= 隐式推断：调用方传入稳定 sessionId → persistent，否则 temporary。
+     */
+    kind?: 'temporary' | 'persistent';
     /** MSM 白名单（独立）：该角色可 exec 的 MSM 名列表；缺省空 = 无 MSM 通道 */
     msms?: string[];
     /** 非 MSM 工具白名单（独立）：平台/ACC 工具名列表；缺省空 = 仅 MSM 通道 */
@@ -191,7 +200,8 @@ export interface SkiffRoleConfig {
     /** 角色系统提示词（CCC 完整定义：人格/认知边界/回答风格） */
     systemPrompt?: string;
     /** 角色系统提示词文件（推荐：相对 CCC 根引用 md 文件——超长提示词在 JSON 内嵌不可读；
-     *  优先于 systemPrompt；文件缺失/逃逸 → resolveRoleSystemPrompt 抛错） */
+     *  优先于 systemPrompt；文件缺失/逃逸 → resolveRoleSystemPrompt 抛错。
+     *  persistent 型每轮重读（mtime 缓存），改文件即生效） */
     systemPromptFile?: string;
 }
 /**

package/lib/index.js

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { a as findSerenityRoot, c as matchBlacklist, d as readCccName$2, f as readHandymanConfig, i as findGitRoot, l as pathInside, m as resolveInside, n as SAFE_MODE_MARKER, o as isSafeModeOn, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-DAsSHsub.js";
-import { a as resolveRoleSystemPrompt, i as readSkiffRoles, l as systemPromptSource, r as isSkiffSessionId, s as roleToolWhitelist } from "./skiff-role-DlrbHPLD.js";
-import { A as skiffRoleFor, C as listActiveHandymen, D as splitModel, E as requireWhitelistedModel, O as writeFailedStatus, S as handymanProgressPaths, T as readProgress, _ as unregisterSkiffSession, a as startSkiffDebugServer, b as HANDYMAN_GUIDE, c as askSkiff, d as ensureWorkspacePromptSection, f as getSkiffAgent, g as skiffTrajectoryEnabled, h as skiffSessionSnapshot, k as writeProgress, l as createSkiffAgent, m as skiffSessionInfo, n as jscSafeJsonText, o as stopSkiffDebugServer, p as skiffMsmGate, r as renderSkiffMarkdown, s as stripThink, t as discoverCccs, u as ensureSkiffSession, v as workspaceTrajectoryLine, w as newStopToken, x as buildRoundPrompt, y as waitAgentIdle } from "./skiff-debug-DYXDdzu3.js";
+import { a as readSkiffRoles, d as systemPromptSource, i as isSkiffSessionId, l as roleToolWhitelist, o as resolveRoleSystemPrompt } from "./skiff-role-BYvNnwv1.js";
+import { A as skiffRoleFor, C as listActiveHandymen, D as splitModel, E as requireWhitelistedModel, O as writeFailedStatus, S as handymanProgressPaths, T as readProgress, _ as unregisterSkiffSession, a as startSkiffDebugServer, b as HANDYMAN_GUIDE, c as askSkiff, d as ensureWorkspacePromptSection, f as getSkiffAgent, g as skiffTrajectoryEnabled, h as skiffSessionSnapshot, k as writeProgress, l as createSkiffAgent, m as skiffSessionInfo, n as jscSafeJsonText, o as stopSkiffDebugServer, p as skiffMsmGate, r as renderSkiffMarkdown, s as stripThink, t as discoverCccs, u as ensureSkiffSession, v as workspaceTrajectoryLine, w as newStopToken, x as buildRoundPrompt, y as waitAgentIdle } from "./skiff-debug-C5ulZKCa.js";
 import { i as hostSessions, n as hostInjected, o as hostWeb, r as hostService, s as hostWebServer, t as hostAgents } from "./access-dU_vG1q8.js";
 import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPES, f as checkLocalstoreGitCompliance, h as runLocalStore, i as matchWeixinRoute, l as weixinSessionIdFor, m as readGitTrack, n as extractWeixinText, o as readWeixinSettings, p as localstorePath, r as hasVoiceItem, s as sanitizeFileName$1, t as extractWeixinMedia } from "./weixin-route-BD_yYAZz.js";
 import { C as useSession, S as summarize, _ as resolveSessionByTitle, a as archiveSessions, b as setActiveSessionInfo, c as createSession, d as getActiveSessionInfo, f as healthCheck, g as readActiveSessionMd, h as qaCheck, i as SESSION_ACTIONS, l as extractSessionMdPathFromText, m as parseSessionContextFromEvents, n as readLastBound, o as clearActiveSessionInfo, p as listSessions, r as DEFAULT_SESSION_SCOPE, s as closeSession, t as appendBound, u as findSession, v as sessionEvents, x as showSession, y as sessionsRoot } from "./session-bound-BpTayaIS.js";
@@ -6478,7 +6478,7 @@ function registerStatusApi(ctx, opts = {}) {
 					workspace: url.searchParams.get("workspace") ?? void 0
 				});
 				const root = findSerenityRoot(workspace) ?? "";
-				const { discoverCccs } = await import("./skiff-debug-DYXDdzu3.js").then((n) => n.i);
+				const { discoverCccs } = await import("./skiff-debug-C5ulZKCa.js").then((n) => n.i);
 				sendJson$2(res, 200, { cccs: await discoverCccs(ctx, root) });
 			} catch (err) {
 				sendJson$2(res, 400, { error: err.message ?? String(err) });
@@ -6675,7 +6675,7 @@ function registerStatusApi(ctx, opts = {}) {
 						return;
 					}
 					const { saveWeixinRoutes } = await import("./weixin-route-BD_yYAZz.js").then((n) => n.u);
-					const { readSkiffRoles } = await import("./skiff-role-DlrbHPLD.js").then((n) => n.c);
+					const { readSkiffRoles } = await import("./skiff-role-BYvNnwv1.js").then((n) => n.u);
 					const roles = readSkiffRoles(root);
 					for (const r of routes) if (!roles.has(r.role)) {
 						sendJson$2(res, 400, { error: `unknown role: ${r.role} (not in ${root} skiff.roles)` });
@@ -9897,7 +9897,7 @@ function matchCcc(input, candidates) {
 }
 /** 组装候选列表（discoverCccs 投影 + `.serenity` 名；动态 import 保持本模块静态依赖轻量） */
 async function collectCandidates(ctx) {
-	const { discoverCccs } = await import("./skiff-debug-DYXDdzu3.js").then((n) => n.i);
+	const { discoverCccs } = await import("./skiff-debug-C5ulZKCa.js").then((n) => n.i);
 	const entries = await discoverCccs(ctx, process.cwd());
 	const seen = /* @__PURE__ */ new Set();
 	const out = [];

package/lib/{skiff-debug-DYXDdzu3.js → skiff-debug-C5ulZKCa.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { a as findSerenityRoot, f as readHandymanConfig } from "./ccc-DAsSHsub.js";
-import { a as resolveRoleSystemPrompt, i as readSkiffRoles, n as buildSkiffBasePrompt, o as roleMsmWhitelist, r as isSkiffSessionId, u as trajectorySubset } from "./skiff-role-DlrbHPLD.js";
+import { a as readSkiffRoles, c as roleMsmWhitelist, f as trajectorySubset, i as isSkiffSessionId, n as buildSkiffBasePrompt, o as resolveRoleSystemPrompt, r as createRolePromptReader, s as resolveSkiffKind } from "./skiff-role-BYvNnwv1.js";
 import { i as hostSessions, r as hostService, t as hostAgents } from "./access-dU_vG1q8.js";
 import { b as setActiveSessionInfo, c as createSession, d as getActiveSessionInfo, n as readLastBound, t as appendBound } from "./session-bound-BpTayaIS.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
@@ -458,15 +458,20 @@ async function createSkiffAgent(ctx, root, roleName, role, defaultModel, session
 	};
 	const handle = await createOrResumeAgent(ctx, id, root, model, setup, sessionId !== void 0);
 	const agent = handle.agent;
-	let cccPrompt = "";
-	try {
-		cccPrompt = resolveRoleSystemPrompt(root, role);
-	} catch (err) {
-		console.warn(`[serenity-hooks] skiff 角色 "${roleName}" 系统提示词解析失败（回退仅基础段）: ${String(err?.message ?? err)}`);
-	}
+	const kind = resolveSkiffKind(role, sessionId !== void 0);
+	const rolePrompt = kind === "persistent" ? createRolePromptReader(root, role) : (() => {
+		let snapshot = "";
+		try {
+			snapshot = resolveRoleSystemPrompt(root, role);
+		} catch (err) {
+			console.warn(`[serenity-hooks] skiff 角色 "${roleName}" 系统提示词解析失败（回退仅基础段）: ${String(err?.message ?? err)}`);
+		}
+		return () => snapshot;
+	})();
+	rolePrompt();
 	let workspaceMdPath = null;
 	try {
-		workspaceMdPath = ensureSkiffSession(root, agent, roleName, role, sessionId !== void 0);
+		workspaceMdPath = ensureSkiffSession(root, agent, roleName, role, kind === "persistent");
 	} catch (err) {
 		console.warn(`[serenity-hooks] skiff 角色 "${roleName}" 专属 SESSION 处理失败（不影响 agent 创建）: ${String(err?.message ?? err)}`);
 	}
@@ -474,7 +479,7 @@ async function createSkiffAgent(ctx, root, roleName, role, defaultModel, session
 		agent.ctx.systemPrompt.section({
 			name: "serenity-skiff",
 			order: -60,
-			text: () => [buildSkiffBasePrompt(roleName, role), cccPrompt].filter(Boolean).join("\n")
+			text: () => [buildSkiffBasePrompt(roleName, role), rolePrompt()].filter(Boolean).join("\n")
 		});
 	} catch (err) {
 		console.warn(`[serenity-hooks] skiff 系统提示词注册失败: ${String(err?.message ?? err)}`);

package/lib/{skiff-role-DlrbHPLD.js → skiff-role-BYvNnwv1.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { m as resolveInside, p as readUtf8, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-DAsSHsub.js";
-import { existsSync } from "node:fs";
+import { existsSync, statSync } from "node:fs";
 //#region src/skiff-role.ts
 /**
 * skiff-role.ts — Skiff（F4，v1.25.0 实验性）角色层纯逻辑（零 DSH 依赖，可独立单测）
@@ -15,9 +15,11 @@ import { existsSync } from "node:fs";
 var skiff_role_exports = /* @__PURE__ */ __exportAll({
 	SKIFF_SESSION_PREFIX: () => SKIFF_SESSION_PREFIX,
 	buildSkiffBasePrompt: () => buildSkiffBasePrompt,
+	createRolePromptReader: () => createRolePromptReader,
 	isSkiffSessionId: () => isSkiffSessionId,
 	readSkiffRoles: () => readSkiffRoles,
 	resolveRoleSystemPrompt: () => resolveRoleSystemPrompt,
+	resolveSkiffKind: () => resolveSkiffKind,
 	roleMsmWhitelist: () => roleMsmWhitelist,
 	roleToolWhitelist: () => roleToolWhitelist,
 	systemPromptSource: () => systemPromptSource,
@@ -43,6 +45,7 @@ function readSkiffRoles(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
 			if (name.trim() === "") continue;
 			out.set(name.trim(), {
 				model: typeof role.model === "string" ? role.model : void 0,
+				kind: role.kind === "temporary" || role.kind === "persistent" ? role.kind : void 0,
 				msms: Array.isArray(role.msms) ? role.msms.filter((m) => typeof m === "string") : void 0,
 				tools: Array.isArray(role.tools) ? role.tools.filter((t) => typeof t === "string") : void 0,
 				trajectory: role.trajectory && typeof role.trajectory === "object" ? {
@@ -103,6 +106,65 @@ function systemPromptSource(role) {
 	if (role?.systemPrompt?.trim()) return "inline";
 	return "none";
 }
+function resolveSkiffKind(role, hasStableId) {
+	const k = role?.kind;
+	if (k === "temporary" || k === "persistent") return k;
+	return hasStableId ? "persistent" : "temporary";
+}
+/**
+* 角色提示词**读取器**（v1.30.15，方案 A：长期型热更新）。
+*
+* 为什么是函数而不是字符串（R↓）：旧实现 `createSkiffAgent` 在创建时把
+* `resolveRoleSystemPrompt(...)` 的结果**快照**进系统提示词段闭包 → CCC 改了
+* `zhaocai.md` 必须重启 dsh web 才生效（本轮实证：改完 18KB 提示词，live agent 仍用旧文本）。
+* 现形态返回一个读取函数，由系统提示词段的 `text()` **每轮调用**：
+*   - `systemPromptFile`：按 **mtime + size** 缓存重读（命中缓存零 IO；未变不解析）
+*     → 改文件即生效，**无需重启**；变更时打一行 info 日志（可观测，便于确认热更生效）
+*   - 内嵌 `systemPrompt`：静态（JSON 配置改动仍需重启/重载配置）
+*   - 读取失败：返回**上次成功内容**（绝不返回空——空提示词会让角色失去人格与纪律），
+*     并按标签去重告警一次
+* @param root CCC 根
+* @param role 角色配置
+*/
+function createRolePromptReader(root, role) {
+	const file = role?.systemPromptFile?.trim();
+	if (!file) {
+		const inline = role?.systemPrompt ?? "";
+		return () => inline;
+	}
+	let abs = null;
+	try {
+		abs = resolveInside(root, file);
+	} catch (err) {
+		console.warn(`[serenity-hooks] ✗ skiff 角色提示词路径非法（${file}）: ${String(err?.message ?? err)}`);
+	}
+	if (abs === null) return () => "";
+	const absPath = abs;
+	let cachedMtime = -1;
+	let cachedSize = -1;
+	let cachedText = "";
+	let warned = false;
+	return () => {
+		try {
+			const st = statSync(absPath);
+			if (st.mtimeMs === cachedMtime && st.size === cachedSize) return cachedText;
+			const text = readUtf8(absPath).trim();
+			const isReload = cachedMtime !== -1;
+			cachedMtime = st.mtimeMs;
+			cachedSize = st.size;
+			cachedText = text;
+			warned = false;
+			if (isReload) console.info(`[serenity-hooks] ↻ skiff 角色提示词已热重载（${file}，${text.length} 字符）`);
+			return text;
+		} catch (err) {
+			if (!warned) {
+				warned = true;
+				console.warn(`[serenity-hooks] ✗ skiff 角色提示词读取失败（${file}）——沿用上次成功内容: ${String(err?.message ?? err)}`);
+			}
+			return cachedText;
+		}
+	};
+}
 /**
 * Skiff 基础提示词（dsp 只给这部分；CCC 的 systemPrompt 段由调用方拼接）：
 * 身份 + 可用 MSM/工具清单 + 调用协议 + 边界声明。动态生成（清单来自角色白名单）。
@@ -125,4 +187,4 @@ function buildSkiffBasePrompt(roleName, role) {
 	return lines.join("\n");
 }
 //#endregion
-export { resolveRoleSystemPrompt as a, skiff_role_exports as c, readSkiffRoles as i, systemPromptSource as l, buildSkiffBasePrompt as n, roleMsmWhitelist as o, isSkiffSessionId as r, roleToolWhitelist as s, SKIFF_SESSION_PREFIX as t, trajectorySubset as u };
+export { readSkiffRoles as a, roleMsmWhitelist as c, systemPromptSource as d, trajectorySubset as f, isSkiffSessionId as i, roleToolWhitelist as l, buildSkiffBasePrompt as n, resolveRoleSystemPrompt as o, createRolePromptReader as r, resolveSkiffKind as s, SKIFF_SESSION_PREFIX as t, skiff_role_exports as u };

package/lib/skiff-role.d.ts

@@ -43,6 +43,30 @@ export declare function roleMsmWhitelist(role: SkiffRoleConfig | undefined): Set
 export declare function resolveRoleSystemPrompt(root: string, role: SkiffRoleConfig | undefined): string;
 /** 角色系统提示词来源（validate/list 展示用） */
 export declare function systemPromptSource(role: SkiffRoleConfig | undefined): 'file' | 'inline' | 'none';
+/**
+ * 角色类型（v1.30.15，S142 用户拍板）：
+ * - 显式 `role.kind` 优先（`temporary` / `persistent`）
+ * - 缺省 = 隐式推断：调用方给出**稳定 sessionId** → persistent；否则 temporary
+ *   （存量配置零迁移；微信桥传固定会话 id → persistent，ACP/调试页随机 id → temporary）
+ */
+export type SkiffKind = 'temporary' | 'persistent';
+export declare function resolveSkiffKind(role: SkiffRoleConfig | undefined, hasStableId: boolean): SkiffKind;
+/**
+ * 角色提示词**读取器**（v1.30.15，方案 A：长期型热更新）。
+ *
+ * 为什么是函数而不是字符串（R↓）：旧实现 `createSkiffAgent` 在创建时把
+ * `resolveRoleSystemPrompt(...)` 的结果**快照**进系统提示词段闭包 → CCC 改了
+ * `zhaocai.md` 必须重启 dsh web 才生效（本轮实证：改完 18KB 提示词，live agent 仍用旧文本）。
+ * 现形态返回一个读取函数，由系统提示词段的 `text()` **每轮调用**：
+ *   - `systemPromptFile`：按 **mtime + size** 缓存重读（命中缓存零 IO；未变不解析）
+ *     → 改文件即生效，**无需重启**；变更时打一行 info 日志（可观测，便于确认热更生效）
+ *   - 内嵌 `systemPrompt`：静态（JSON 配置改动仍需重启/重载配置）
+ *   - 读取失败：返回**上次成功内容**（绝不返回空——空提示词会让角色失去人格与纪律），
+ *     并按标签去重告警一次
+ * @param root CCC 根
+ * @param role 角色配置
+ */
+export declare function createRolePromptReader(root: string, role: SkiffRoleConfig | undefined): () => string;
 /**
  * Skiff 基础提示词（dsp 只给这部分；CCC 的 systemPrompt 段由调用方拼接）：
  * 身份 + 可用 MSM/工具清单 + 调用协议 + 边界声明。动态生成（清单来自角色白名单）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.30.14",
+  "version": "1.30.15",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：10 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/autopilot-trajectory）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/自主巡航。适配 DSH 0.1.2-rc.1。",
   "license": "MIT",
   "repository": {