@shgroup/dsh-serenity-hooks 1.68.0 → 1.69.0

package/dsh.plugin.json

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

package/lib/api.d.ts

@@ -34,11 +34,34 @@ interface StatusApiRegistration {
     configPaths?: string[];
 }
 /**
- * 从请求参数解析 workspace：优先 sessionId → 会话 header.cwd；其次 workspace 参数；
- * 无参 → 遍历 live sessions 找第一个 CCC 会话的 cwd（远程访问时 sessionId 可能缺失，
- * 回退 process.cwd()=$HOME 会错误显示"未激活"——v1.22.2 修复）；最后进程 cwd。
- * 纯逻辑（可单测）：resolveWorkspaceCore(sessionCwd, workspaceParam, listCwds)。
+ * 从请求参数解析 workspace：sessionId → 会话 header.cwd；其次 workspace 参数；
+ * 再次**唯一**的 CCC 会话 cwd；最后进程 cwd。
+ *
+ * 🔴🔴 **2026-10-18 修缺陷（owner 报「在别的 CCC 点开显示的还是 home-serenity 的信息」）**：
+ * 旧实现第 ③ 步是「**遍历 live sessions 找第一个 CCC 会话的 cwd**」—— 那是**跨工作区猜测**：
+ * 只要 sessionId 缺失或那条会话查不到（ACP/skiff 会话、尚未 materialize 的会话、远程访问），
+ * 它就会**静默返回另一个 CCC 的路径**，于是面板把**别人的轨迹/技能/安全模式**当成你的显示出来。
+ * 这比"显示未激活"危险得多 —— 用户会据此做判断（以为自己的 safe-mode 开着、以为那是自己的轨迹）。
+ *
+ * 修法与既有先例一致（`rebuild.ts` 对"跨轨迹猜测"的裁决：**响亮失败优于静默接错**）：
+ * **多个候选 ⇒ 不猜**。只有当 live sessions 里的 CCC 根**唯一**时才采用它
+ * （那正是 v1.22.2 要救的场景：单 CCC 部署 + 远程访问缺 sessionId）；
+ * 一旦出现**两个及以上**不同 CCC 根，就退回进程 cwd（→ 面板显示"未激活"），绝不挑一个顶替。
+ *
+ * @param sessionCwd sessionId 查到的会话 cwd（最权威）
+ * @param workspaceParam 显式 workspace 参数
+ * @param listCwds 枚举 live sessions 的 cwd（用于"唯一 CCC"兜底）
+ * @param fallback 最后兜底（进程 cwd）
  */
 export declare function resolveWorkspaceCore(sessionCwd: string | undefined, workspaceParam: string | undefined, listCwds: () => string[], fallback: string): string;
+/**
+ * 解析本次请求所属的 workspace。
+ * 🔴 2026-10-18：导出给 `registerVoyageApi` 复用（航行页词表按当前 CCC 注入）——
+ * **单一真相源**，⛔ 不让调用方另写一份"找 CCC"的逻辑。
+ */
+export declare function resolveWorkspace(ctx: Context, params: {
+    sessionId?: string;
+    workspace?: string;
+}): string;
 export declare function registerStatusApi(ctx: Context, opts?: StatusApiRegistration): void;
 export {};

package/lib/client.js

@@ -262,11 +262,11 @@ window.__ModuleLoader__.load({
 						className: cx("sp-voyage"),
 						"aria-hidden": "true",
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("iframe", {
-							src: `/serenity/voyage?card=1&v=${encodeURIComponent(status.accVersion)}`,
+							src: `/serenity/voyage?card=1&v=${encodeURIComponent(status.accVersion)}${status.root ? `&workspace=${encodeURIComponent(status.root)}` : ""}`,
 							title: "",
 							loading: "lazy",
 							tabIndex: -1
-						}, status.accVersion)
+						}, `${status.accVersion}|${status.root ?? ""}`)
 					})]
 				})]
 			});

package/lib/index.js

@@ -15117,17 +15117,42 @@ function requireWebUi(req, res, message) {
 	return false;
 }
 /**
-* 从请求参数解析 workspace：优先 sessionId → 会话 header.cwd；其次 workspace 参数；
-* 无参 → 遍历 live sessions 找第一个 CCC 会话的 cwd（远程访问时 sessionId 可能缺失，
-* 回退 process.cwd()=$HOME 会错误显示"未激活"——v1.22.2 修复）；最后进程 cwd。
-* 纯逻辑（可单测）：resolveWorkspaceCore(sessionCwd, workspaceParam, listCwds)。
+* 从请求参数解析 workspace：sessionId → 会话 header.cwd；其次 workspace 参数；
+* 再次**唯一**的 CCC 会话 cwd；最后进程 cwd。
+*
+* 🔴🔴 **2026-10-18 修缺陷（owner 报「在别的 CCC 点开显示的还是 home-serenity 的信息」）**：
+* 旧实现第 ③ 步是「**遍历 live sessions 找第一个 CCC 会话的 cwd**」—— 那是**跨工作区猜测**：
+* 只要 sessionId 缺失或那条会话查不到（ACP/skiff 会话、尚未 materialize 的会话、远程访问），
+* 它就会**静默返回另一个 CCC 的路径**，于是面板把**别人的轨迹/技能/安全模式**当成你的显示出来。
+* 这比"显示未激活"危险得多 —— 用户会据此做判断（以为自己的 safe-mode 开着、以为那是自己的轨迹）。
+*
+* 修法与既有先例一致（`rebuild.ts` 对"跨轨迹猜测"的裁决：**响亮失败优于静默接错**）：
+* **多个候选 ⇒ 不猜**。只有当 live sessions 里的 CCC 根**唯一**时才采用它
+* （那正是 v1.22.2 要救的场景：单 CCC 部署 + 远程访问缺 sessionId）；
+* 一旦出现**两个及以上**不同 CCC 根，就退回进程 cwd（→ 面板显示"未激活"），绝不挑一个顶替。
+*
+* @param sessionCwd sessionId 查到的会话 cwd（最权威）
+* @param workspaceParam 显式 workspace 参数
+* @param listCwds 枚举 live sessions 的 cwd（用于"唯一 CCC"兜底）
+* @param fallback 最后兜底（进程 cwd）
 */
 function resolveWorkspaceCore(sessionCwd, workspaceParam, listCwds, fallback) {
 	if (sessionCwd) return sessionCwd;
 	if (workspaceParam) return workspaceParam;
-	for (const cwd of listCwds()) if (cwd && cccRootForCwd(cwd)) return cwd;
+	const roots = /* @__PURE__ */ new Set();
+	for (const cwd of listCwds()) {
+		if (!cwd) continue;
+		const r = cccRootForCwd(cwd);
+		if (r) roots.add(r);
+	}
+	if (roots.size === 1) return [...roots][0];
 	return fallback;
 }
+/**
+* 解析本次请求所属的 workspace。
+* 🔴 2026-10-18：导出给 `registerVoyageApi` 复用（航行页词表按当前 CCC 注入）——
+* **单一真相源**，⛔ 不让调用方另写一份"找 CCC"的逻辑。
+*/
 function resolveWorkspace(ctx, params) {
 	let sessionCwd;
 	if (params.sessionId) sessionCwd = (hostSessions(ctx)?.get?.(params.sessionId))?.header?.cwd;
@@ -15652,6 +15677,126 @@ function registerAcpAccountsApi(ctx) {
 	});
 }
 //#endregion
+//#region src/voyage-vocab.ts
+/**
+* voyage-vocab.ts — 航行页词表改为**按当前 CCC 运行时注入**（纯逻辑，零 DSH 依赖）
+*
+* ## 为什么需要它（owner 2026-10-18 报的缺陷）
+* 资产 `assets/serenity-voyage.html` 的词表是**构建期扫描容器写死的常量**：
+*   `var VOCAB = {"skills":[...],"msms":[...],"zh":[...],"onto":[...],"counts":{...}}`
+* v2 改版把"写死名单"改成"构建期扫描"是为防名单漂移——方向对，但代价是：
+* **一份静态资产只能属于一个 CCC**。于是任何别的 CCC 打开动画，看到的都是
+* **构建它的那个 CCC** 的技能/工具/本体名字与计数。owner 原话：
+* 「为什么我在别的 CCC 点开显示的还是我们 home-serenity 的信息」「动画也有这个毛病」。
+*
+* ## 修法（owner 裁决：运行时按当前 CCC 注入）
+* 资产**保持静态**（一份文件服务所有 CCC，永不漂）；由它的**服务端路由**在返回前
+* 把 `var VOCAB = {...};` 那一行替换成从该请求所属 CCC 实况读出的词表。
+*
+* 三条判据（R↓）：
+*  ① **只替换那一行**（锚 = 行首 `var VOCAB = ` 到行尾 `;`）—— 资产里其余 3000+ 行
+*    three.js / 渲染代码**一个字节都不动**。
+*  ② **读不出来就走原样**：锚认不出、或原 VOCAB 解析失败 ⇒ **返回入参本身**，不报错。
+*    航行页是**装饰**，不该因为某个 CCC 缺目录、或资产结构变了就打不开（旁路容忍铁律）。
+*  ③ **`zh` 不来自容器**：中文隐喻词是作品的语汇装饰，属资产自身 ⇒ 注入时**保留原值**。
+*    实现上不"重建"整个对象，而是**在原对象上覆盖**四个实况键 —— 未列出的键自动保留。
+*/
+/** 资产里那一行的锚 —— `var VOCAB = {...};`（`.*?` 非贪婪 + 行尾分号） */
+const VOCAB_LINE_RE = /^var VOCAB = (\{.*\});[ \t]*$/m;
+/**
+* 扫描一个 CCC 的实况词表。**每一项独立容错**：任一来源缺失/读坏 ⇒ 该项为空，其余照常。
+*
+* | 字段 | 来源 | 为什么是它 |
+* |---|---|---|
+* | `skills` | `.opencode/skills/` 下含 `SKILL.md` 的目录名 | 与状态面板同一条判据 |
+* | `msms` | `mech-registry.json` 的注册名 | **MSM 的唯一真相源** |
+* | `onto` | `.opencode/skills/` 下含 `skill.ttl` 的目录名 | 增强型（建模过）的 skill |
+* | `counts` | 上述长度 ＋ 轨迹数 | 计数与词表同源，否则 HUD 与星场对不上 |
+*
+* @param root CCC 根
+*/
+function scanVoyageLiveVocab(root) {
+	const skills = scanSkillDirs(root, "SKILL.md");
+	const onto = scanSkillDirs(root, "skill.ttl");
+	const msms = scanMsmNames(root);
+	return {
+		skills,
+		msms,
+		onto,
+		counts: {
+			skill: skills.length,
+			msm: msms.length,
+			onto: onto.length,
+			session: scanTrajectoryCount(root)
+		}
+	};
+}
+/** 技能名：`.opencode/skills/<name>/<marker>` 存在的目录名（marker = `SKILL.md` 或 `skill.ttl`） */
+function scanSkillDirs(root, marker) {
+	const dir = join(root, ".opencode", "skills");
+	try {
+		if (!existsSync(dir)) return [];
+		return readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).filter((e) => existsSync(join(dir, e.name, marker))).map((e) => e.name).sort();
+	} catch {
+		return [];
+	}
+}
+/**
+* MSM 名：读 `mech-registry.json` 的 `msms[].name`。
+*
+* 🔴 **为什么不扫 `scripts/`**：注册表是 MSM 的**唯一真相源**；扫目录会把共享库
+* （`dev-kit/`、`lib/*`）也算成 MSM —— 本仓对"入口判据"已翻车多次。
+* ⚠️ 注册表若换了位置 ⇒ **静默降级为空**（装饰页不该因此打不开）。
+*/
+function scanMsmNames(root) {
+	const candidates = [join(root, ".opencode", "skills", "home-serenity", "references", "mech-registry.json"), join(root, ".opencode", "references", "mech-registry.json")];
+	for (const p of candidates) try {
+		if (!existsSync(p)) continue;
+		const names = (JSON.parse(readFileSync(p, "utf-8")).msms ?? []).map((m) => typeof m?.name === "string" ? m.name : "").filter((n) => n !== "");
+		if (names.length > 0) return [...new Set(names)].sort();
+	} catch {}
+	return [];
+}
+/** 轨迹数：`AGENT_SESSIONS/` 下非 `_` / `.` 前缀的目录（与轨迹层"活跃"判据一致） */
+function scanTrajectoryCount(root) {
+	const dir = join(root, "AGENT_SESSIONS");
+	try {
+		if (!existsSync(dir)) return 0;
+		return readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).filter((e) => !e.name.startsWith("_") && !e.name.startsWith(".")).length;
+	} catch {
+		return 0;
+	}
+}
+/**
+* 把实况词表注入资产 HTML。
+*
+* 做法 = **在原 VOCAB 对象上覆盖**四个实况键（不重建整个对象）⇒ `zh` 等装饰键自动保留。
+* 任一环节不成立就**原样返回**（见文件头判据②），因此：
+* @returns 注入后的 HTML；未注入时**与入参逐字节相同**
+*/
+function injectVoyageVocab(html, live) {
+	if (live === null) return html;
+	const m = VOCAB_LINE_RE.exec(html);
+	if (!m) return html;
+	let base;
+	try {
+		base = JSON.parse(m[1]);
+	} catch {
+		return html;
+	}
+	const merged = {
+		...base,
+		skills: live.skills,
+		msms: live.msms,
+		onto: live.onto,
+		counts: {
+			...typeof base.counts === "object" && base.counts !== null ? base.counts : {},
+			...live.counts
+		}
+	};
+	return html.replace(VOCAB_LINE_RE, () => `var VOCAB = ${JSON.stringify(merged)};`);
+}
+//#endregion
 //#region src/voyage-page.ts
 const VOYAGE_PATH = "/serenity/voyage";
 /**
@@ -15688,6 +15833,9 @@ function sendJson$2(res, status, body) {
 /**
 * 注册 `/serenity/voyage`（GET）。
 * @param opts.assetPath 覆盖资产路径（测试用；生产不传）
+* @param opts.resolveRoot 解析本次请求所属 CCC 根（生产由 api.ts 的 resolveWorkspace 提供）。
+*   🔴 **2026-10-18 新增**：词表按请求所属 CCC **运行时注入**（owner 报「在别的 CCC 点开
+*   显示的还是 home-serenity 的信息」）。不传 ⇒ 不注入（保持资产原样 = 旧行为）。
 */
 function registerVoyageApi(ctx, opts = {}) {
 	ctx.webServer.register({
@@ -15705,9 +15853,18 @@ function registerVoyageApi(ctx, opts = {}) {
 				sendJson$2(res, 500, { error: `voyage asset unavailable: ${err?.message ?? String(err)}` });
 				return;
 			}
+			let root = null;
+			try {
+				root = opts.resolveRoot?.(req) ?? null;
+			} catch {
+				root = null;
+			}
+			if (root !== null) try {
+				html = injectVoyageVocab(html, scanVoyageLiveVocab(root));
+			} catch {}
 			res.statusCode = 200;
 			res.setHeader("content-type", "text/html; charset=utf-8");
-			res.setHeader("cache-control", "private, max-age=86400");
+			res.setHeader("cache-control", root !== null ? "no-cache" : "private, max-age=86400");
 			res.setHeader("content-length", String(Buffer.byteLength(html)));
 			res.end(html);
 		}
@@ -25465,7 +25622,14 @@ function apply(ctx, config) {
 	});
 	if (config.api) {
 		registerStatusApi(ctx, { configPaths: config.serenityConfigPaths });
-		registerVoyageApi(ctx);
+		registerVoyageApi(ctx, { resolveRoot: (req) => {
+			const url = new URL(req.url ?? "/", "http://localhost");
+			const ws = resolveWorkspace(ctx, {
+				sessionId: url.searchParams.get("sessionId") ?? void 0,
+				workspace: url.searchParams.get("workspace") ?? void 0
+			});
+			return cccRootForCwd(ws);
+		} });
 	}
 	registerSettingsSection(ctx, config);
 	if (config.tools) registerDiagramTool(ctx);

package/lib/voyage-page.d.ts

@@ -21,6 +21,7 @@
  * 技能/公理/MSM/本体词元与实测容器规模数字。
  */
 import type { Context } from 'cordis';
+import type { IncomingMessage } from 'node:http';
 export declare const VOYAGE_PATH = "/serenity/voyage";
 /**
  * 资产相对包根的路径。
@@ -38,7 +39,11 @@ export declare function resetVoyageCache(): void;
 /**
  * 注册 `/serenity/voyage`（GET）。
  * @param opts.assetPath 覆盖资产路径（测试用；生产不传）
+ * @param opts.resolveRoot 解析本次请求所属 CCC 根（生产由 api.ts 的 resolveWorkspace 提供）。
+ *   🔴 **2026-10-18 新增**：词表按请求所属 CCC **运行时注入**（owner 报「在别的 CCC 点开
+ *   显示的还是 home-serenity 的信息」）。不传 ⇒ 不注入（保持资产原样 = 旧行为）。
  */
 export declare function registerVoyageApi(ctx: Context, opts?: {
     assetPath?: string;
+    resolveRoot?: (req: IncomingMessage) => string | null;
 }): void;

package/lib/voyage-vocab.d.ts

@@ -0,0 +1,51 @@
+/**
+ * voyage-vocab.ts — 航行页词表改为**按当前 CCC 运行时注入**（纯逻辑，零 DSH 依赖）
+ *
+ * ## 为什么需要它（owner 2026-10-18 报的缺陷）
+ * 资产 `assets/serenity-voyage.html` 的词表是**构建期扫描容器写死的常量**：
+ *   `var VOCAB = {"skills":[...],"msms":[...],"zh":[...],"onto":[...],"counts":{...}}`
+ * v2 改版把"写死名单"改成"构建期扫描"是为防名单漂移——方向对，但代价是：
+ * **一份静态资产只能属于一个 CCC**。于是任何别的 CCC 打开动画，看到的都是
+ * **构建它的那个 CCC** 的技能/工具/本体名字与计数。owner 原话：
+ * 「为什么我在别的 CCC 点开显示的还是我们 home-serenity 的信息」「动画也有这个毛病」。
+ *
+ * ## 修法（owner 裁决：运行时按当前 CCC 注入）
+ * 资产**保持静态**（一份文件服务所有 CCC，永不漂）；由它的**服务端路由**在返回前
+ * 把 `var VOCAB = {...};` 那一行替换成从该请求所属 CCC 实况读出的词表。
+ *
+ * 三条判据（R↓）：
+ *  ① **只替换那一行**（锚 = 行首 `var VOCAB = ` 到行尾 `;`）—— 资产里其余 3000+ 行
+ *    three.js / 渲染代码**一个字节都不动**。
+ *  ② **读不出来就走原样**：锚认不出、或原 VOCAB 解析失败 ⇒ **返回入参本身**，不报错。
+ *    航行页是**装饰**，不该因为某个 CCC 缺目录、或资产结构变了就打不开（旁路容忍铁律）。
+ *  ③ **`zh` 不来自容器**：中文隐喻词是作品的语汇装饰，属资产自身 ⇒ 注入时**保留原值**。
+ *    实现上不"重建"整个对象，而是**在原对象上覆盖**四个实况键 —— 未列出的键自动保留。
+ */
+/** 从 CCC 实况读出的词表（只含**会变**的四个键；`zh` 与其它装饰键不在其中） */
+export interface VoyageLiveVocab {
+    skills: string[];
+    msms: string[];
+    onto: string[];
+    counts: Record<string, number>;
+}
+/**
+ * 扫描一个 CCC 的实况词表。**每一项独立容错**：任一来源缺失/读坏 ⇒ 该项为空，其余照常。
+ *
+ * | 字段 | 来源 | 为什么是它 |
+ * |---|---|---|
+ * | `skills` | `.opencode/skills/` 下含 `SKILL.md` 的目录名 | 与状态面板同一条判据 |
+ * | `msms` | `mech-registry.json` 的注册名 | **MSM 的唯一真相源** |
+ * | `onto` | `.opencode/skills/` 下含 `skill.ttl` 的目录名 | 增强型（建模过）的 skill |
+ * | `counts` | 上述长度 ＋ 轨迹数 | 计数与词表同源，否则 HUD 与星场对不上 |
+ *
+ * @param root CCC 根
+ */
+export declare function scanVoyageLiveVocab(root: string): VoyageLiveVocab;
+/**
+ * 把实况词表注入资产 HTML。
+ *
+ * 做法 = **在原 VOCAB 对象上覆盖**四个实况键（不重建整个对象）⇒ `zh` 等装饰键自动保留。
+ * 任一环节不成立就**原样返回**（见文件头判据②），因此：
+ * @returns 注入后的 HTML；未注入时**与入参逐字节相同**
+ */
+export declare function injectVoyageVocab(html: string, live: VoyageLiveVocab | null): string;

package/package.json

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