@shgroup/dsh-serenity-hooks 1.105.0 → 1.108.0

package/lib/{channels-bAiZlY07.js → channels-Dty_NIl_.js}

@@ -1,150 +1,6 @@
-import { f as hostSettings } from "./ccc-roots-BPicjCsj.js";
-import { c as readWeixinSettings, o as readImSettings } from "./route-CmEoKp9w.js";
+import { c as readWeixinSettings, o as readImSettings } from "./route-reyv8qcB.js";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-//#region src/surface/settings.ts
-/**
-* 设置面板命名空间 = **profile 条目 id**（v0.1.7 起；与旧 `settings.yaml` 段名逐字相同）。
-*/
-const SERENITY_SETTINGS_NS = "serenity-hooks";
-/** 进程级默认（无 Config 可读时的兜底；与 Config 各字段的缺省一致） */
-function defaultSimpleSettings() {
-	return {
-		gatewayEnabled: false,
-		rebuildThresholdK: 400,
-		croEnabled: true,
-		diagramEnabled: false,
-		humanChannel: defaultHumanChannelSettings()
-	};
-}
-/**
-* volatile 字段的**结构化解包**（v1.47.2；本文件读取语义的第一道）。
-*
-* ## 为什么必须有它（两个事实的合成，缺一即错）
-* ① **0.1.7 的面板层字段必须标 `.volatile()`** —— 否则本插件命名空间整个不进宿主的
-*    `settings.describe()`（`volatileForm()` 只认 `meta.volatile`）⇒ **设置面板那一节消失**。
-* ② **标了之后，运行期拿到的是引用包装，不是裸值** —— schemastery 的 `Schema.resolve()` 对
-*    `meta.volatile` **无条件**包 `createVolatile(value)`，且该分支排在"缺省值回退"那一段
-*    **之前** ⇒ **"用户没设过"的字段也是恒真对象**（`.get()` 返回 `undefined`），**不是 `undefined`**。
-*
-* ⇒ 若这里不解包，下面十行的 `??` 链会**短路在这层包装上** ⇒ 网关 / 轨迹约束 会被
-* **无意打开**（比"面板不显示"更坏：静默改变对外暴露面）。
-*
-* ## 为什么用结构判定
-* 可观察形状就是"有 `get()`"（cosmokit 的 `isVolatile` 也这么判）；本模块不引它的运行时依赖。
-*
-* @param value - volatile 引用 ｜ 裸值 ｜ undefined
-* @returns 解包后的裸值（引用 ⇒ `.get()`；裸值原样；缺省 ⇒ `undefined`）
-*/
-function unwrapVolatile(value) {
-	if (value === void 0 || value === null) return void 0;
-	if (typeof value.get === "function") return value.get();
-	return value;
-}
-/** human-channel 的内建缺省（与 `Config` 的 schema 缺省**同源**：这里是读取面，那里是解析面） */
-function defaultHumanChannelSettings() {
-	return {
-		accounts: [],
-		subscriptions: [],
-		relayCcc: null,
-		sendingAllow: ["*"]
-	};
-}
-/** 取"有内容的字符串"（首尾空白剥掉；空白串 ⇒ `undefined`）—— 面板空文本框会写 `''`，那是"没填"不是"填了个空名" */
-function nonEmptyText(value) {
-	if (typeof value !== "string") return void 0;
-	const trimmed = value.trim();
-	return trimmed === "" ? void 0 : trimmed;
-}
-/**
-* `humanChannel` 片段 → 运行时归一形态。**优先级：显式值 > 内建缺省**（与 `simpleSettingsFromConfig` 同族）。
-*
-* 🔴 三处"缺省 vs 显式"的语义差别，别写反：
-*  ① `sending.allow: []` ⇒ **`[]`**（"谁都不许"），**不是**回退到 `['*']` —— 故用 `??`
-*     （只对 `undefined`/`null` 回退）。⚠️ **别拿 `??`→`||` 当变异探针**：空数组在 JS 里是
-*     **真值** ⇒ 两种写法在这个输入上**恰好同效**，那是**非变异**（会得出"测试不承重"的假结论）。
-*  ② `relay.ccc` 空白 ⇒ `null`（"没填"与"没这一项"同义），**不是**把空白当 CCC 名；
-*  ③ 账号 `enabled` 缺省 **true**（老账号表里 `enabled` 不写就是开）。
-*
-* 🔴 **旧 CCC 侧 `weixin.*` 不在这里、也不该在这里**：机器级面**只**认 `humanChannel`
-*   （硬切无别名，同 D61 先例）⇒ 传进来的旧键**一律不进结构**（回归钉见
-*   `tests/human-channel-config.test.ts`；CCC 侧旧读取面的退役在 P0-2~P0-4）。
-* @param fragment - `Config.humanChannel`（可能整个不存在 —— 那是**合法**初始态）
-* @returns 归一形态（永不 `undefined`）
-*/
-function humanChannelSettingsFromConfig(fragment) {
-	const d = defaultHumanChannelSettings();
-	if (!fragment) return d;
-	return {
-		accounts: (fragment.accounts ?? []).map((a) => ({
-			id: nonEmptyText(a?.id),
-			channel: nonEmptyText(a?.channel),
-			enabled: a?.enabled !== false,
-			token: a?.token,
-			userId: a?.userId
-		})),
-		subscriptions: (fragment.subscriptions ?? []).map((s) => ({
-			account: nonEmptyText(s?.account),
-			user: nonEmptyText(s?.user),
-			ccc: nonEmptyText(s?.ccc),
-			role: nonEmptyText(s?.role)
-		})),
-		relayCcc: nonEmptyText(fragment.relay?.ccc) ?? d.relayCcc,
-		sendingAllow: fragment.sending?.allow ?? d.sendingAllow
-	};
-}
-/**
-* Config（宿主 Loader 校验后的解析值）→ 扁平简单配置。**本文件唯一的读取语义**。
-*
-* 优先级：**面板层（扁平键）> 部署层（嵌套段）> 内建缺省**。
-* @param config - 插件 Config（`fiber.config` 或 apply 收到的 config）
-* @returns 扁平开关集合
-*/
-function simpleSettingsFromConfig(config) {
-	const d = defaultSimpleSettings();
-	return {
-		gatewayEnabled: unwrapVolatile(config.gatewayEnabled) ?? config.gateway?.enabled ?? d.gatewayEnabled,
-		rebuildThresholdK: unwrapVolatile(config.rebuildThresholdK) ?? config.rebuild?.thresholdK ?? d.rebuildThresholdK,
-		croEnabled: unwrapVolatile(config.croEnabled) ?? d.croEnabled,
-		diagramEnabled: unwrapVolatile(config.diagramEnabled) ?? config.diagram?.enabled ?? d.diagramEnabled,
-		humanChannel: humanChannelSettingsFromConfig(config.humanChannel)
-	};
-}
-/** 运行时源（`registerSettingsSection` 装配：读本插件 fiber 的**当前** Config） */
-let simpleSource = null;
-/**
-* 读取当前简单配置（各功能 gateway/rebuild/轨迹约束/… 的启动与运行时判断都经此）。
-*
-* 源 = 本插件 fiber 的 `config`（宿主在配置变更时走 `fiber.update()` ⇒ `config` 始终最新，
-* **不必**依赖 apply 重跑，也不必缓存）。
-* @returns 扁平开关集合
-*/
-function readSimpleSettings() {
-	return simpleSource ? simpleSource() : defaultSimpleSettings();
-}
-/**
-* 装配简单配置读取面（v1.21 分层；**v0.1.7 起不再注册任何 section**）。
-*
-* 两件事：
-*  1. 把"本插件自己的 Config"接成简单配置源 —— 读 `ctx.fiber.config`（宿主 `fiber.update()`
-*     保证最新），拿不到 fiber 时退回 apply 收到的 `config`。
-*  2. 关掉宿主按 Config schema **自动生成**的通用页（`settings.configure({ auto: false })`）——
-*     门面是我们的自定义页 `client/SettingsSection.tsx`（同一个命名空间，同一份数据）。
-*
-* ⚠️ 两个失败都不阻断插件装载（面板是附属能力，绝不能成为启动单点）。
-* @param ctx - 插件上下文
-* @param config - apply 收到的 Config（fiber.config 不可用时的兜底）
-*/
-function registerSettingsSection(ctx, config) {
-	const fiber = ctx.fiber;
-	const readConfig = () => fiber?.config ?? config;
-	simpleSource = () => simpleSettingsFromConfig(readConfig());
-	const settings = hostSettings(ctx);
-	try {
-		settings?.configure?.({ auto: false }, fiber);
-	} catch {}
-}
-//#endregion
 //#region src/im/log-scan.ts
 /**
 * im/log-scan.ts — 读聊天记录落盘，汇总出「与谁有过往来」（`contacts` 的数据源）
@@ -599,4 +455,4 @@ async function runImBridge(root, req) {
 	return fail("ACTION_UNKNOWN", `unknown action "${action}"`);
 }
 //#endregion
-export { SERENITY_SETTINGS_NS as a, runImBridge as i, isImWiredTrajectory as n, readSimpleSettings as o, registerImChannel as r, registerSettingsSection as s, imChannelIds as t };
+export { runImBridge as i, isImWiredTrajectory as n, registerImChannel as r, imChannelIds as t };

package/lib/client.js

@@ -4754,10 +4754,135 @@ Instruction-following style:
 						title: "会话清理",
 						desc: "删除 N 天前无活动的 DSH 会话（手动，不可恢复）",
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SessionCleanupBlock, {})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Collapse, {
+						title: "轨迹订阅",
+						desc: "观察者盯一组成员，任一轮结束即通知（只读；配置在 serenity.json）",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SubscriptionsBlock, {})
 					})
 				]
 			});
 		}
+		/**
+		* 「轨迹订阅」块（v1.108.0，owner 2026-11-01 P3）。
+		*
+		* 🔴 **只读**，且刻意分两栏显示「意图」与「实际」：
+		* · **意图栏** = 配置里写了谁盯谁；**实际栏** = 真的发生过投递的键。
+		* · 两者**必须分开看**：一个配了却不出现在实际栏的订阅 = **还没触发过**（不是"在工作"）；
+		*   出现在实际栏且 `failed>0` = **触发了但送不到**（那才是要修的）。
+		*   把这两件事合成一句话，人就分不出来了（这正是 diag ⑤ 段同一个理由）。
+		*
+		* ⚠️ 计数是**进程内**的（重启清零）—— UI 上必须写明，否则"0"会被读成"从来没配过"。
+		*/
+		function SubscriptionsBlock() {
+			const [data, setData] = (0, react.useState)(null);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(null);
+			const load = async () => {
+				setBusy(true);
+				setError(null);
+				try {
+					const res = await fetch("/serenity/subscriptions", { headers: {
+						accept: "application/json",
+						"x-serenity-ui": "1"
+					} });
+					if (!res.ok) {
+						const body = await res.json().catch(() => null);
+						setError(body?.error ?? `HTTP ${res.status}`);
+						return;
+					}
+					setData(await res.json());
+				} catch (err) {
+					setError(err instanceof Error ? err.message : String(err));
+				} finally {
+					setBusy(false);
+				}
+			};
+			(0, react.useEffect)(() => {
+				load();
+			}, []);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "ss-field",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "ss-row",
+						style: {
+							display: "flex",
+							alignItems: "center",
+							gap: 8
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							className: "ss-btn",
+							disabled: busy,
+							onClick: () => void load(),
+							children: busy ? "读取中…" : "刷新读数"
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							style: {
+								opacity: .7,
+								fontSize: 12
+							},
+							children: "投递计数只在宿主进程内有效（重启清零）；配置全表在 .opencode/serenity.json"
+						})]
+					}),
+					error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "ss-error",
+						children: ["⚠ ", error]
+					}),
+					data !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+						data.problems.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "ss-error",
+							children: [
+								"⚠ 配置坏项 ",
+								data.problems.length,
+								" 条（配了但不生效）：",
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+									style: { margin: "4px 0 0 16px" },
+									children: data.problems.map((p, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: p }, i))
+								})
+							]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h4", {
+							style: { margin: "12px 0 4px" },
+							children: "配置（意图：谁盯谁）"
+						}),
+						data.subscriptions.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: { opacity: .7 },
+							children: "（未配置任何订阅 —— 在 .opencode/serenity.json 里写 trajectorySubscriptions）"
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+							style: { margin: "0 0 0 16px" },
+							children: data.subscriptions.map((s, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", { children: s.watcher }),
+								" 盯 ",
+								s.members.join("、"),
+								s.note !== null ? `（${s.note}）` : ""
+							] }, i))
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h4", {
+							style: { margin: "12px 0 4px" },
+							children: "投递（实际：发生了没有）"
+						}),
+						data.deliveries.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: { opacity: .7 },
+							children: "（本进程内还没有任何投递发生 —— 配了但没出现 = 还没触发过，不等于在工作）"
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+							style: { margin: "0 0 0 16px" },
+							children: data.deliveries.map((d, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+								d.key,
+								"：成功 ",
+								d.ok,
+								" ／ 失败 ",
+								d.failed,
+								d.failed > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									className: "ss-error",
+									children: ["　⚠ ", d.lastError ?? "（无说明）"]
+								})
+							] }, i))
+						})
+					] })
+				]
+			});
+		}
 		/** 「会话清理」块（v1.29 需求③，S142 用户拍板：lastActive + 手动按钮 + 直接物理删）：
 		*  天数输入 → GET 预览（dryRun 列表）→ 确认 → POST 执行。live 会话由服务端保护跳过。 */
 		function SessionCleanupBlock() {