@shgroup/dsh-serenity-hooks 1.105.0 → 1.108.0

package/lib/seams/guards.d.ts

@@ -107,10 +107,6 @@ export declare function getHostScheduleHiddenDiagnostics(): {
 };
 /** 会话销毁清理（lifecycle 调用）——方案 C 后由统一清理撤销，这里保留语义占位。 */
 export declare function forgetHostScheduleToolHiding(_sessionId: string): void;
-/** 专属工具隐藏诊断（排查"工具为什么不在清单里"） */
-export declare function getExclusiveToolsDiagnostics(): {
-    hidden: string[];
-};
 /** 轨迹约束工具面诊断（排查"某工具为什么不在 轨迹约束的清单里"） */
 export declare function getTrajectoryConstraintVisibilityDiagnostics(): {
     keys: string[];

package/lib/{service-Cndtf7q4.js → service-Z3aSR1cn.js}

@@ -1,4 +1,4 @@
-import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-B-h_A7uc.js";
+import { s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS } from "./ccc-BmpE3cQz.js";
 import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 //#region src/tools/localstore/service.ts

package/lib/service-xvjwsX3p.js

@@ -0,0 +1,249 @@
+import { d as hostSessions, r as cccRootForCwd } from "./ccc-roots-DPMwBywc.js";
+import { m as readTrajectorySubscriptions } from "./ccc-BmpE3cQz.js";
+import { F as isoLocal, w as sessionEvents } from "./bind-file-B0TuOP89.js";
+import { m as WAKE_CATCH_UP_MS, p as listCroCognitiveTrajectories } from "./scheduler-B0pB9mxI.js";
+import { n as readSimpleSettings } from "./settings-DY4_DYYY.js";
+import { r as subscriptionStats } from "./subscriptions-CyrfNpcG.js";
+import { containerClocks, containerWakes } from "./observation-BWpkA865.js";
+//#region src/trajectory/live.ts
+/**
+* trajectory/live.ts — 进程内 live 会话取数 + 精简诊断
+*
+* ── 为什么单独成模块（R↓，2026-09-15 S142「ACC 侧 autopilot 退场」S1 搬迁）──
+* 这两个函数原先住在 `autopilot-trajectory.ts`，但它们的**主语不是 autopilot**：
+* `listLiveSessions` 服务 `acc-diag` ① 段的"**哪个会话属于哪个 CCC**"（会话维度，
+* 不是 CCC 维度），而"**独立进程看不到运行时**"正是 `acc-diag` 存在的理由。
+* autopilot 退场后它们必须活下去 ⇒ 独立成模块，不再挂着已死机制的名字。
+*
+* ── 迁移边界（不搬什么，以及为什么）──────────────────────────────────────
+* 原 `diagLive` 还含两段，**均不搬**（其主语是 autopilot，随机制退场）：
+*   · `autopilotCccs`（逐 CCC 目标命中 / agent 定位诊断）—— 依赖 `readAutopilotSettings` /
+*     `getAutopilotStatus` / `resolveTargetAgent`
+*   · `panelResolved`（无参面板请求落到哪个 CCC）—— 面板区块随机制退场
+* 留下的 = **进程 cwd/CCC + live 会话清单**（`acc-diag` ① 段仍需要）。
+*
+* 判据纪律：本模块**不得**反向依赖 autopilot 判据层（那会让退场半途而废）。
+*
+* ── 🔴 2026-09-25 I2 收敛（约束文档 §2.7 违反清单，L1 违反之一）────────────────
+* **本模块的 `ctx` 参数类型从 `Context` 改为 `unknown`** —— 消除本文件唯一的 `W2` 接触
+* （直接 import 宿主 `cordis` 的类型）。
+*
+* **为什么这是"真解耦"而不是"把类型藏起来"（判据）：** `ctx` 在本模块**从不被解引用** ——
+* 它只被**原样透传**给 `hostSessions(ctx)`，而后者（`host/access.ts`，**L0**）的参数
+* 本就声明为 `ctx: unknown` ⇒ `Context` 这个 import **在语义上是多余的**，
+* 它没有参与任何类型检查，只贡献了一处 L1→宿主 的接触点。
+* 🔵 **证据**：grep 本文件 `ctx` 全部 5 处命中 —— 3 处在参数/调用位、2 处在注释，
+* **零处**属性访问（`ctx.xxx`）。
+*/
+/**
+* 从 dsh 会话 log 读取标题（latest-wins `session/title` 事件）——
+* **标题不在 `sessions.list()` 条目上**（wire/对象均无 title 字段；F3 命名经
+* `sessionTitle.rename` 写进 session log），必须从 events 提取（rebuild 同款读取模式）。
+*/
+function readSessionTitle(session) {
+	try {
+		const events = sessionEvents(session);
+		for (let i = events.length - 1; i >= 0; i--) {
+			const e = events[i];
+			if (e?.type === "session/title" && typeof e.data?.title === "string" && e.data.title.trim() !== "") return e.data.title.trim();
+		}
+	} catch {}
+	return null;
+}
+/**
+* 逐条 live 会话（`cccRoot` = 该会话 cwd 的 CCC 归属，无 → null）。
+*
+* CCC 枚举（"本机有哪些 CCC"）**不在这里**，归 `ccc-roots.listCccs`（并集语义）；
+* 本函数保留的是它**独有**的那部分：会话维度 + cwd 归属 + 标题 + id。
+*
+* @param ctx 插件上下文（**只透传**给 L0 取数口，本模块不解引用 ⇒ 类型为 `unknown`）
+* @returns 逐条 live 会话
+*/
+function listLiveSessions(ctx) {
+	const out = [];
+	try {
+		const sessions = hostSessions(ctx);
+		for (const s of sessions?.list?.() ?? []) {
+			const cwd = s?.header?.cwd ?? null;
+			out.push({
+				id: s?.id ?? "",
+				cwd,
+				cccRoot: cwd ? cccRootForCwd(cwd) : null,
+				title: readSessionTitle(s)
+			});
+		}
+	} catch {}
+	return out;
+}
+function diagLive(ctx) {
+	const processCwd = process.cwd();
+	return {
+		processCwd,
+		processCcc: cccRootForCwd(processCwd),
+		liveSessions: listLiveSessions(ctx)
+	};
+}
+//#endregion
+//#region src/tools/diag/service.ts
+/**
+* tools/diag/service.ts — 运行态诊断报告装配（原 `acc-diag` 工具；v1.106.0 并入 `dashboard diag`）
+*
+* ## 为什么并进 dashboard（owner 2026-11-01 裁「方案 C」）
+*
+* 原 `acc-diag` 是**专属工具**（要 CCC 在 `exclusiveTools` 里逐字点名才可见）。
+* owner 要的是「诊断入口随时可用」，而专属机制让入口本身成了特权的副产品：
+* 换个 CCC 就看不见，且"看不见"与"坏了"在现象上同形。⇒ 并入常驻的 `dashboard`，
+* 并**整体删除 `exclusiveTools` 机制**（那一版永远只有一个成员，机制成本高于收益）。
+*
+* ⚠️ **代价（owner 已知并确认）**：`dashboard` 常驻 ⇒ 本节对**所有轨迹**可见，
+* 而 ① 段的 live 会话清单是**全部 CCC** 的（跨容器）。这是方案 C 的既定后果，不是缺陷。
+*
+* 为什么单独成模块（R↓）：工具面（`tools/kit/index.ts`）只做"取 CCC 根 + 渲染"，
+* 装配逻辑放这里 ⇒ 纯函数可单测、不依赖 DSH 工具注册。
+*
+* 四段内容（数据来源各自单一真相源，本模块只聚合不复制语义）：
+*   ①  live 运行态 —— 插件进程内 `diagLive(ctx)`（进程 cwd/CCC + live 会话清单）
+*       ——**独立进程看不到运行时**，这正是本段存在的理由
+*   ①b 唤醒时钟 —— `containerClocks().wake`（唤醒调度器进程内快照：武装态/计数/上次跳过原因）
+*   ②  CRO 已注册清单 —— `listCroCognitiveTrajectories(root)`（v1.106.0 新增，owner 要求）
+*       **CRO 没有注册表**（见 `cro/core.ts` 文件头）：`continuous-re-occurrence.ts` 文件存在即启用
+*       ⇒ 本段是那个"隐式事实"的**唯一可见出口**。运维看不到它，就只能靠翻目录猜。
+*   ③  唤醒注册表 —— `wake-registry.json` 的**在办条目** ＋ **未来与已过期分开列**（v1.106.0）
+*       🔴 2026-09-19 §0Q 甲案：终态条目**结案即清除** ⇒ 本段只列在办项，不再是"历史全量"。
+*       🔴 v1.106.0 补一条判据（owner 2026-11-01 要"看未来会被唤起的"）：
+*          **过去的不看** ⇒ `at > now` 单独成组；**已过期但仍在办**的另列一组。
+*          两者必须分开，因为它们的**病情不同**：未来项 = 正常排队；过期项 = 补跑窗口里卡着
+*          （调度器没跑 / 目标不可解析），混在一起读会以为"排了好多活儿"。
+*
+* ── 2026-09-15：段数由四降为三（S142「ACC 侧 autopilot 退场」§1 二阶裁定）─────────────
+* ACC 侧 autopilot 整段退场后，报告里两段的**主语消失**，故删除（不是"暂时关掉"）：
+*   · 原 ② 面板解析 —— `diagLive.panelResolved` 的来源是"哪个 CCC 配了 autopilot"，
+*     面板区块同批删除 ⇒ 主语不存在。
+*   · 原 ④ 唤起条件链 —— 整段都是 ACC autopilot 的唤起条件（`buildWakeChain` +
+*     `autopilotRuntimeFacts`），实现模块已删 ⇒ 不留第二份条件链、也不留半死的手写版。
+*   · 原 ① 段的 autopilot CCC 渲染（逐 CCC 目标命中 / agent 定位）同批删除。
+*
+* 🔴 **已知缺口（登记，不静默丢弃）**：④「为什么这轮没唤起」的诊断在 **CCC 自管理链**上归零。
+* 新链的失败形态是"S151 漏了自排下一轮"或"调度器闸关/未 tick"，而删掉 ④ 后这两种病因都不可见。
+* 按所有者裁决本次**不补**（一句话可补，代价 = 一条新条件链：调度器 armed / 闸 / tick 在跑 /
+* 条目到期 / 补跑窗口 / 目标可解析 / CCC 闸）。**不得**以"顺手保留 ④"的方式把它偷偷带回。
+* ⚠️ v1.106.0 的 ③ 两分组**不是**这条缺口的补丁：分组只把"已过期在办"显形，
+* 没有回答"为什么没 tick"——那是 ①b 的 lastSkipReason 与 tick 次数的事，别混为一谈。
+*
+* C5「观察面归一」（2026-09-15）：① 走 `diagLive`（那是**live 运行态**的独有取数，没有第二个
+* 来源）；①b 时钟与 ③ 注册表经 `surface/observation.ts` 取（唯一取数出口）——**投影仍在本文件**
+* （诊断段不含 `message`，面板含；这是渲染差异，不是取数差异）。
+*/
+/** 人读渲染一行时钟状态（"为何没有 tick" 的第一手判据） */
+function renderClock(label, s) {
+	const ts = (ms) => ms === null ? "（从未）" : isoLocal(ms);
+	const parts = [
+		`armed=${s.armed}`,
+		`CRO 闸=${readSimpleSettings().croEnabled !== false}`,
+		`tick 次数=${s.ticks}`,
+		`上次 tick=${ts(s.lastTickAt)}`
+	];
+	if (s.armedAt !== null) parts.push(`武装于=${ts(s.armedAt)}`);
+	if (s.lastSkipReason) parts.push(`上次跳过: ${s.lastSkipReason}`);
+	return `${label}: ${parts.join(" ｜ ")}`;
+}
+/**
+* 装配报告（一次调用即全报告）。
+* @param ctx 插件上下文（进程内读 sessions/agents）
+* @param root 调用方 CCC 根（唤醒注册表取数目标）
+* @param nowMs 判"未来 / 已过期"的基准时刻（可注入 ⇒ 可单测，不依赖挂钟）
+* @returns 结构化报告（渲染由 {@link renderDiag} 负责）
+*/
+async function runDiag(ctx, root, nowMs = Date.now()) {
+	const live = diagLive(ctx);
+	const clocks = containerClocks();
+	const wakes = containerWakes(root);
+	const project = (e) => ({
+		id: e.id,
+		target: e.target,
+		at: e.at,
+		state: e.state,
+		createdBy: e.createdBy,
+		attempts: e.attempts ?? 0,
+		lastResult: e.lastResult ?? null
+	});
+	const future = [];
+	const overdue = [];
+	for (const e of wakes.entries) {
+		const at = Date.parse(e.at);
+		if (Number.isFinite(at) && at > nowMs) future.push(project(e));
+		else overdue.push(project(e));
+	}
+	return {
+		ccc: root,
+		live,
+		clocks: { wake: clocks.wake },
+		cro: listCroCognitiveTrajectories(root),
+		wakes: {
+			error: wakes.error,
+			future,
+			overdue,
+			pending: wakes.pending
+		},
+		nowMs,
+		subscriptions: subscriptionStats(),
+		subscriptionProblems: readTrajectorySubscriptions(root).problems
+	};
+}
+/** 人读渲染一行唤醒条目 */
+function renderWake(w) {
+	return `  · ${w.id} [${w.state}] at=${w.at} → ${w.target} by=${w.createdBy} attempts=${w.attempts}`;
+}
+/** 人读渲染（四段；空段也要显式说明"无"，避免"沉默 = 一切正常"的误读） */
+function renderDiag(r) {
+	const lines = [];
+	lines.push(`═══ ACC 运行态诊断（dashboard diag）═══`);
+	lines.push(`调用方 CCC: ${r.ccc}`);
+	lines.push(`报告时刻: ${isoLocal(r.nowMs)}`);
+	lines.push("");
+	lines.push(`── ① live 运行态（插件进程内）──`);
+	lines.push(`进程 cwd: ${r.live.processCwd}`);
+	lines.push(`进程 CCC: ${r.live.processCcc ?? "（无——进程 cwd 不在任何 CCC 内）"}`);
+	lines.push(`live 会话: ${r.live.liveSessions.length} 个`);
+	for (const s of r.live.liveSessions) lines.push(`  · ${s.id}${s.title ? `「${s.title}」` : ""} — ccc=${s.cccRoot ?? "(非 CCC)"} cwd=${s.cwd ?? "(无)"}`);
+	lines.push("");
+	lines.push(renderClock("唤醒调度器（wake-registry tick）", r.clocks.wake));
+	lines.push("");
+	lines.push(`── ② CRO 已启用轨迹（判据：目录下有 continuous-re-occurrence.ts；无注册表）──`);
+	if (r.cro.length === 0) lines.push("（无——本 CCC 没有轨迹启用 CRO）");
+	else {
+		lines.push(`共 ${r.cro.length} 条:`);
+		for (const d of r.cro) lines.push(`  · ${d}`);
+	}
+	lines.push("");
+	lines.push(`── ③ 唤醒注册表（在办项；已结案条目即时清除，历史见 SESSION.md）──`);
+	lines.push(`  （${r.ccc}/AGENT_SESSIONS/wake-registry.json）`);
+	if (r.wakes.error) lines.push(`⚠ 注册表读取问题: ${r.wakes.error}`);
+	lines.push(`在办 ${r.wakes.pending} 条 = 未来 ${r.wakes.future.length} + 已过期 ${r.wakes.overdue.length}｜补跑窗口 ${WAKE_CATCH_UP_MS / 36e5}h`);
+	lines.push(`· 未来（at > 报告时刻；正常排队）: ${r.wakes.future.length} 条`);
+	if (r.wakes.future.length === 0) lines.push("  （无）");
+	for (const w of r.wakes.future) {
+		lines.push(renderWake(w));
+		if (w.lastResult) lines.push(`      lastResult: ${w.lastResult}`);
+	}
+	lines.push(`· 已过期但仍在办（at ≤ 报告时刻；卡在补跑窗口，多半是调度器没 tick 或目标不可解析）: ${r.wakes.overdue.length} 条`);
+	if (r.wakes.overdue.length === 0) lines.push("  （无）");
+	for (const w of r.wakes.overdue) {
+		lines.push(renderWake(w));
+		if (w.lastResult) lines.push(`      lastResult: ${w.lastResult}`);
+	}
+	lines.push("");
+	lines.push(`── ⑤ 轨迹消息订阅（投递读数；只列发生过的投递，配置全表见 serenity.json）──`);
+	if (r.subscriptionProblems.length > 0) {
+		lines.push(`⚠ 配置坏项 ${r.subscriptionProblems.length} 条（**配了但不生效**）：`);
+		for (const p of r.subscriptionProblems) lines.push(`  · ${p}`);
+	}
+	if (r.subscriptions.length === 0) lines.push("（本进程内还没有任何订阅投递发生）");
+	else for (const s of r.subscriptions) {
+		const tail = s.failed > 0 ? `  ⚠ 最近失败：${s.lastError ?? "（无说明）"}` : "";
+		lines.push(`  · ${s.key} 成功 ${s.ok} ／ 失败 ${s.failed}${s.lastAt ? ` ｜ 最后 ${isoLocal(s.lastAt)}` : ""}${tail}`);
+	}
+	return lines.join("\n");
+}
+//#endregion
+export { renderDiag, runDiag };

package/lib/{session-CYqyod3z.js → session-BlgUdKH4.js}

@@ -1,8 +1,10 @@
-import { c as hostAgents, n as agentCwdFor, r as cccRootForCwd, s as hostAgentDefaultModel } from "./ccc-roots-BPicjCsj.js";
-import { f as readCognitiveTrajectorySkills, h as readUtf8, o as isSafeModeOn, u as readBlacklist } from "./ccc-B-h_A7uc.js";
-import { K as isoLocal, L as sessionsRoot, N as readActiveSessionMd, d as registerTrajectorySession$1, f as trajectoryDirNameForSession, o as readTrajectoryConstraintAt, p as unregisterTrajectorySession$1, u as trajectoryConstraintForSession, y as DEFAULT_SESSION_SCOPE } from "./profile-Dpg3wYO5.js";
-import { a as readGitTrack, i as localstorePath } from "./service-Cndtf7q4.js";
-import { d as constraintCognitiveTrajectory, m as profileMsmWhitelist, n as PLUGIN_SOURCE, o as readLastBound, p as createProfilePromptReader, u as buildTrajectoryBasePrompt, v as ACC_VERSION } from "./message-source-DoVtXnoe.js";
+import { c as hostAgents, n as agentCwdFor, r as cccRootForCwd, s as hostAgentDefaultModel } from "./ccc-roots-DPMwBywc.js";
+import { f as readCognitiveTrajectorySkills, h as readUtf8, o as isSafeModeOn, u as readBlacklist } from "./ccc-BmpE3cQz.js";
+import { F as isoLocal, T as sessionsRoot, s as DEFAULT_SESSION_SCOPE, x as readActiveSessionMd } from "./bind-file-B0TuOP89.js";
+import { a as readGitTrack, i as localstorePath } from "./service-Z3aSR1cn.js";
+import { a as createProfilePromptReader, n as buildTrajectoryBasePrompt, o as profileMsmWhitelist, r as constraintCognitiveTrajectory, u as ACC_VERSION } from "./rules-BLkYTPUy.js";
+import { d as registerTrajectorySession$1, f as trajectoryDirNameForSession, o as readTrajectoryConstraintAt, p as unregisterTrajectorySession$1, u as trajectoryConstraintForSession } from "./profile-BjBn_-be.js";
+import { n as PLUGIN_SOURCE, o as readLastBound } from "./message-source-BTIe2cVO.js";
 import { basename, dirname, join, resolve } from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";

package/lib/settings-DY4_DYYY.js

@@ -0,0 +1,145 @@
+import { f as hostSettings } from "./ccc-roots-DPMwBywc.js";
+//#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
+export { readSimpleSettings as n, registerSettingsSection as r, SERENITY_SETTINGS_NS as t };