@shgroup/dsh-serenity-hooks 1.45.1 → 1.47.0

package/lib/{trajectory-bound-BPWKkzJC.js → message-source-Boc-AbHs.js}

@@ -918,4 +918,10 @@ function appendBound(session, action, rec) {
 	}
 }
 //#endregion
-export { useSession as C, localIdStamp as D, localHuman as E, summarize as S, localFileStamp as T, resolveSessionByTitle as _, resolveSessionTrajectoryLabel as a, setActiveSessionInfo as b, TRAJECTORY_ACTIONS as c, extractSessionMdPathFromText as d, findSession as f, readActiveSessionMd as g, parseSessionContextFromEvents as h, readLastBound as i, clearActiveSessionInfo as l, listSessions as m, listBoundSessionIds as n, setBindingStore as o, getActiveSessionInfo as p, pruneMissingBindings as r, DEFAULT_SESSION_SCOPE as s, appendBound as t, createSession as u, sessionEvents as v, isoLocal as w, showSession as x, sessionsRoot as y };
+//#region src/message-source.ts
+/** ACC 注入消息的 kind —— 唤醒 / 打回 / keeper 提醒 / 锚定轮 / rebuild 交接等一律同值。 */
+const ACC_MESSAGE_KIND = "plugin:dsh-serenity-hooks";
+/** ACC 注入消息的统一来源值（各缝共用；需要 `form` 时按 `ContextFormed` 另加字段）。 */
+const PLUGIN_SOURCE = { kind: ACC_MESSAGE_KIND };
+//#endregion
+export { showSession as C, localFileStamp as D, isoLocal as E, localHuman as O, setActiveSessionInfo as S, useSession as T, parseSessionContextFromEvents as _, pruneMissingBindings as a, sessionEvents as b, setBindingStore as c, clearActiveSessionInfo as d, createSession as f, listSessions as g, getActiveSessionInfo as h, listBoundSessionIds as i, localIdStamp as k, DEFAULT_SESSION_SCOPE as l, findSession as m, PLUGIN_SOURCE as n, readLastBound as o, extractSessionMdPathFromText as p, appendBound as r, resolveSessionTrajectoryLabel as s, ACC_MESSAGE_KIND as t, TRAJECTORY_ACTIONS as u, readActiveSessionMd as v, summarize as w, sessionsRoot as x, resolveSessionByTitle as y };

package/lib/message-source.d.ts

@@ -0,0 +1,28 @@
+/**
+ * message-source.ts — ACC 注入消息的来源标识（**单一真相源**，v1.47.0 / DSH 0.1.7-rc.1 适配）
+ *
+ * **为什么有这个文件**：DSH 0.1.7-rc.1（session format v3→v4）把消息来源从
+ * 「`kind: 'plugin'` ＋ `plugin` 字段」改成**每个生产者声明自己的 kind** ——
+ * `@deepseek-ai/dsh-llm` 的 `MessageSourceMap` 逐字写着：
+ * *"each producer declares its own `kind` in its own module; there is no shared
+ * catch-all `plugin` kind"*。⇒ 旧写法 `{ kind: 'plugin', plugin: 'dsh-serenity-hooks' }`
+ * **在类型层不再合法**（合并和类型里没有 `plugin` 这一支），必须用**模块声明合并**
+ * 补上自己的 kind（宿主 `dsh-session-title-llm` 与 `dsh-compaction` 都用此法）。
+ *
+ * **为什么取字面量 `plugin:dsh-serenity-hooks`**：v3→v4 迁移的 `producerKind()`
+ * （`session-format-v3-to-v4/src/sources.ts`）把**第一方之外**的旧生产者一律写为
+ * `plugin:${旧 plugin 字段}` ⇒ **存量会话升级后就是这个字面量**。新代码沿用同一字面量，
+ * 使同一生产者在旧数据与新数据里**只有一个 kind**（否则下游与我方读取面都要处理两种）。
+ */
+import type { ContextFormed, MessageSource } from '@deepseek-ai/dsh-llm';
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        'plugin:dsh-serenity-hooks': {
+            kind: 'plugin:dsh-serenity-hooks';
+        } & ContextFormed;
+    }
+}
+/** ACC 注入消息的 kind —— 唤醒 / 打回 / keeper 提醒 / 锚定轮 / rebuild 交接等一律同值。 */
+export declare const ACC_MESSAGE_KIND: "plugin:dsh-serenity-hooks";
+/** ACC 注入消息的统一来源值（各缝共用；需要 `form` 时按 `ContextFormed` 另加字段）。 */
+export declare const PLUGIN_SOURCE: MessageSource;

package/lib/output-guard-seam.d.ts

@@ -11,6 +11,15 @@
  * （dsh-serenity-hooks/container_trajectory rebuild/mech-registry），打回会瘫痪自身工作。
  */
 import type { Context } from 'cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+/** 读会话最后一个 assistant/message 文本（skiff-core 同款）
+ *  **2026-09-23（S142 D77）起导出**：`unattended-seam.ts` 复用同一读法（本容器纪律：
+ *  「同一读法只留一份」——两份 `lastAssistantText` 会在宿主改事件形状时**只修一处**）。
+ *  **v1.27.7：剥离 think 块再检测**（用户："不检查think内容（因为不输出）"）——
+ *  ` think…` 是模型思考过程，不进入用户可见输出；敏感词检测只针对**最终呈现文本**，
+ *  否则 think 内提及内部机制词（思考过程必然推演机制）会误打回。复用 stripThink
+ *  （v1.26.8 状态机，弃正则——同 v1.27.1 微信桥回复链路）。 */
+export declare function lastAssistantText(agent: Agent): string;
 /**
  * 注册输出守卫（index.ts apply 调用）：
  * turn-stopping 时检测最终输出，命中敏感词 → steer 打回重生成（官方机制，零改 DSH）。

package/lib/seams/context.d.ts

@@ -1,5 +1,5 @@
 /**
- * context.ts — 拦截缝：ACC 上下文注入（agent/session-start + agent/prompt-submit）
+ * context.ts — 拦截缝：ACC 上下文注入（agent/created + agent/prompt-submit）
  *
  * 对应 opencode-serenity-plugin 的 system.transform（ACC 身份/约束注入）+ Phase 2 访谈提示。
  *

package/lib/{settings-section-CIuyoSOX.js → settings-section-DTJW4smh.js}

@@ -1,6 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { a as hostSettings } from "./access-fiehjxV6.js";
-import z from "@deepseek-ai/schemastery";
 //#region src/ports.ts
 /**
 * 集中端口表。
@@ -62,43 +61,11 @@ const MECHANISM_PORTS = Object.keys(FACE_PORTS).map((id) => String(FACE_PORTS[id
 var settings_section_exports = /* @__PURE__ */ __exportAll({
 	SERENITY_SETTINGS_NS: () => SERENITY_SETTINGS_NS,
 	defaultSimpleSettings: () => defaultSimpleSettings,
-	entryDefaults: () => entryDefaults,
 	readSimpleSettings: () => readSimpleSettings,
-	registerSettingsSection: () => registerSettingsSection
+	registerSettingsSection: () => registerSettingsSection,
+	simpleSettingsFromConfig: () => simpleSettingsFromConfig
 });
-/** 简单配置命名空间（dsh 设置面板的 section id / settings.yaml section） */
-const SERENITY_SETTINGS_NS = "serenity-hooks";
-/** schemastery schema（与 DSH 各插件 Config 同款） */
-const simpleSettingsSchema = z.object({
-	gatewayEnabled: z.boolean().default(false),
-	rebuildEnabled: z.boolean().default(true),
-	rebuildThresholdK: z.number().min(50).max(4e3).default(400),
-	skiffEnabled: z.boolean().default(false),
-	skiffDebugPort: z.number().min(1024).max(65535).default(SKIFF_DEBUG_PORT),
-	acpEnabled: z.boolean().default(false),
-	acpHttpPort: z.number().min(1024).max(65535).default(ACP_HTTP_PORT),
-	publicAskEnabled: z.boolean().default(false),
-	croEnabled: z.boolean().default(true)
-});
-/** 从插件 Config 提取 entry 默认（settings base 层） */
-function entryDefaults(config) {
-	return {
-		gatewayEnabled: config.gateway?.enabled ?? false,
-		rebuildEnabled: config.rebuild?.enabled ?? true,
-		rebuildThresholdK: config.rebuild?.thresholdK ?? 400,
-		skiffEnabled: config.skiff?.enabled ?? false,
-		skiffDebugPort: config.skiff?.debugPort ?? SKIFF_DEBUG_PORT,
-		acpEnabled: config.acp?.enabled ?? false,
-		acpHttpPort: config.acp?.httpPort ?? ACP_HTTP_PORT,
-		publicAskEnabled: config.publicAsk?.enabled ?? false,
-		croEnabled: true
-	};
-}
-/** 运行时源（installSettingsSection 注入：settings scope 或 entry fallback） */
-let simpleSource = null;
-/** 缺 settings provider 的告警去重（进程级一次；降级路径可能被多次注册调用） */
-let warnedNoSettingsProvider = false;
-/** 进程级默认（无 settings 服务时的兜底） */
+/** 进程级默认（无 Config 可读时的兜底；与 Config 各字段的缺省一致） */
 function defaultSimpleSettings() {
 	return {
 		gatewayEnabled: false,
@@ -109,46 +76,65 @@ function defaultSimpleSettings() {
 		acpEnabled: false,
 		acpHttpPort: ACP_HTTP_PORT,
 		publicAskEnabled: false,
-		croEnabled: true
+		croEnabled: true,
+		unattendedEnabled: false
+	};
+}
+/**
+* Config（宿主 Loader 校验后的解析值）→ 扁平简单配置。**本文件唯一的读取语义**。
+*
+* 优先级：**面板层（扁平键）> 部署层（嵌套段）> 内建缺省**。
+* @param config - 插件 Config（`fiber.config` 或 apply 收到的 config）
+* @returns 扁平开关集合
+*/
+function simpleSettingsFromConfig(config) {
+	const d = defaultSimpleSettings();
+	return {
+		gatewayEnabled: config.gatewayEnabled ?? config.gateway?.enabled ?? d.gatewayEnabled,
+		rebuildEnabled: config.rebuildEnabled ?? config.rebuild?.enabled ?? d.rebuildEnabled,
+		rebuildThresholdK: config.rebuildThresholdK ?? config.rebuild?.thresholdK ?? d.rebuildThresholdK,
+		skiffEnabled: config.skiffEnabled ?? config.skiff?.enabled ?? d.skiffEnabled,
+		skiffDebugPort: config.skiffDebugPort ?? config.skiff?.debugPort ?? d.skiffDebugPort,
+		acpEnabled: config.acpEnabled ?? config.acp?.enabled ?? d.acpEnabled,
+		acpHttpPort: config.acpHttpPort ?? config.acp?.httpPort ?? d.acpHttpPort,
+		publicAskEnabled: config.publicAskEnabled ?? d.publicAskEnabled,
+		croEnabled: config.croEnabled ?? d.croEnabled,
+		unattendedEnabled: config.unattendedEnabled ?? d.unattendedEnabled
 	};
 }
+/** 运行时源（`registerSettingsSection` 装配：读本插件 fiber 的**当前** Config） */
+let simpleSource = null;
 /**
-* 读取当前简单配置（settings 解析值；无 provider/未注册 → entry 默认）。
-* 各功能（gateway/rebuild/naming）启动与运行时判断开关都经此函数。
+* 读取当前简单配置（各功能 gateway/rebuild/skiff/… 的启动与运行时判断都经此）。
+*
+* 源 = 本插件 fiber 的 `config`（宿主在配置变更时走 `fiber.update()` ⇒ `config` 始终最新，
+* **不必**依赖 apply 重跑，也不必缓存）。
+* @returns 扁平开关集合
 */
 function readSimpleSettings() {
 	return simpleSource ? simpleSource() : defaultSimpleSettings();
 }
 /**
-* 注册简单配置到 DSH settings（零改 DSH；settings.yaml 持久化 + 原生面板渲染）。
-* 注：插件 Config（cordis.yml 组合层）作为 base；用户文档层叠加其上。
-* 运行时读取简单配置统一经 `readSimpleSettings()`。
-* v1.28.0 适配 0.1.2-rc.1（B4）：`installSettingsSection`/`settingsNamespace` 便捷函数在
-* rc.1 消失 → 改 `SettingsProvider.installSection(owner, ns, schema, entry, hooks)`
-* （owner = consumer 插件 ctx；ns 直接字符串）。
+* 装配简单配置读取面（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 hooks = {
-		setSource: (get) => {
-			simpleSource = get;
-		},
-		onChange: () => {
-			try {
-				ctx.emit?.("serenity/settings-changed");
-			} catch {}
-		}
-	};
-	const settingsAny = hostSettings(ctx);
-	if (settingsAny) {
-		settingsAny.installSection.call(settingsAny, ctx, SERENITY_SETTINGS_NS, simpleSettingsSchema, entryDefaults(config), hooks);
-		return;
-	}
-	if (!warnedNoSettingsProvider) {
-		warnedNoSettingsProvider = true;
-		console.warn("[serenity-hooks] ✗ settings 服务不可用 → 简单配置降级为 entry 默认值（面板开关/阈值改动不生效；检查宿主 settings provider 是否装载）");
-	}
-	hooks.setSource(() => ({}));
-	hooks.onChange();
+	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 { FACE_PORTS as a, MECHANISM_PORTS as c, ACP_HTTP_PORT as i, SKIFF_DEBUG_PORT as l, registerSettingsSection as n, GATEWAY_PORT as o, settings_section_exports as r, MAIN_WEB_PORT as s, readSimpleSettings as t, WEIXIN_SEND_PORT as u };

package/lib/settings-section.d.ts

@@ -1,22 +1,40 @@
 /**
- * settings-section.ts — 简单配置注册（dsh 原生设置面板，v1.21 分层）
+ * settings-section.ts — 简单配置读取（dsh 原生设置面板；v1.21 分层，**v1.47 A 案移植到 0.1.7 表单模型**）
  *
  * 分层决策（S142）：**简单配置（开关/阈值）→ dsh 原生设置面板**；
  * **复杂配置（账号列表）→ 宁静号高级面板**（localstore + /serenity/config）。
  *
- * 本模块承载简单配置层：`SettingsProvider.installSection(ctx, 'serenity-hooks', schema, entry)`
- * 注册 `serenity-hooks` namespace——三功能总开关 + F2 阈值。
- * （v1.28.0 适配 0.1.2-rc.1：installSettingsSection/settingsNamespace 便捷函数消失 → 方法调用）
+ * ## 🔴 v0.1.7 起（A 案）：**"安装 section"这件事整段退场**
  *
- * 运行时降级守卫（版本鲁棒性）：旧 RC（staging 架构）api-proxy 有
- * `WEB_SETTINGS_NAMESPACES` 静态白名单，第三方 ns 会收到 settings-not-exposed
- * ——client 面板读不到。新 RC（官方 master）已删除白名单（全量 describe）。
- * 本模块不依赖白名单状态：register 总是执行（host 侧零成本）；
- * **client 侧**（SettingsSection 组件）以 describe 结果为据——ns 不在描述列表
- * 则显示降级提示（引导去宁静号面板），在则渲染 schema 表单。零配置自动适配。
+ * 宿主把 `SettingsProvider.installSection` 换成 `SettingsForms`：设置页不再由插件
+ * "注册一个 namespace + schema + entry + hooks"，而是**由插件自己的 cordis `Config`
+ * schema 投影成表单**（`packages/settings/settings` 的 `describe()` 遍历 profile 条目）。
+ * ⇒ 命名空间**就是 profile 条目 id** —— 本插件 = `serenity-hooks`
+ * （见 `cordis.patch.yml` 的 `- insert: - id: serenity-hooks`）。
+ *
+ * ## 为什么旧扁平键**原样保留**（这是本文件最容易被后人改错的地方）
+ *
+ * 旧模型把简单配置存成 `~/.dsh/settings.yaml` 的 `serenity-hooks:` 段，字段名是**扁平**的
+ * （`gatewayEnabled` / `skiffEnabled` / …）。新模型的命名空间**逐字相同**
+ * （`serenity-hooks`），而宿主的 `SettingsForms.importLegacyDocument()` 会把该段
+ * **按同名条目导入**；schemastery 的 object 解析在非 strict 模式下 `merge(result, data)`
+ * ⇒ **未声明的键会被保留而非报错**。⇒ 只要这些扁平键**仍在本插件 Config 里声明**，
+ * **旧值就自动随宿主导入搬过来，零迁移代码**（这正是宿主的迁移惯例：`LEGACY_SECTION_ENTRIES`
+ * 只重映射**段名**，从不改写字段名）。
+ *
+ * ## 两层拼写（**有意保留，不是重复真相源**）
+ *
+ * | 层 | 拼写 | 谁写 | 语义 |
+ * |---|---|---|---|
+ * | **面板层**（用户层） | 扁平键 `gatewayEnabled` | 设置面板 / 宿主 legacy 导入 | 用户在界面上改的那个 |
+ * | **部署层** | 嵌套段 `gateway.enabled` | `cordis.yml` / bundle patch | 部署时的缺省 |
+ *
+ * 读取优先级 = **面板层 > 部署层 > 内建缺省**（`simpleSettingsFromConfig`）。
+ * 🔴 面板层的键**故意不带 schemastery 默认值** —— 有默认值就永远非 `undefined`，
+ * 部署层会被无声压死（"未设置"必须可观测）。
  */
 import type { Context } from 'cordis';
-/** 插件 Config 的简单配置片段（index.ts Config 组合；settings entry base） */
+/** 插件 Config 的简单配置片段（index.ts 的 Config 子集；面板层 + 部署层两种拼写） */
 interface SimpleConfigFragment {
     gateway?: {
         enabled?: boolean;
@@ -35,68 +53,92 @@ interface SimpleConfigFragment {
         enabled?: boolean;
         httpPort?: number;
     };
-    /** F4d 建议问答页（实验性）：按认知容器暴露问答页供他人验证（全局开关；与 ACP 共用端口） */
-    publicAsk?: {
-        enabled?: boolean;
-    };
+    gatewayEnabled?: boolean;
+    rebuildEnabled?: boolean;
+    rebuildThresholdK?: number;
+    skiffEnabled?: boolean;
+    skiffDebugPort?: number;
+    acpEnabled?: boolean;
+    acpHttpPort?: number;
+    publicAskEnabled?: boolean;
+    croEnabled?: boolean;
+    unattendedEnabled?: boolean;
 }
-/** 简单配置命名空间（dsh 设置面板的 section id / settings.yaml section） */
-export declare const SERENITY_SETTINGS_NS = "serenity-hooks";
 /**
- * 简单配置 schema（schemastery）：三功能总开关 + F2 阈值 + F4 Skiff 启停。
- * 与 DSH settings 的 schema 语义一致（z.object 布尔/数字）。
+ * 设置面板命名空间 = **profile 条目 id**（v0.1.7 起；与旧 `settings.yaml` 段名逐字相同）。
  */
+export declare const SERENITY_SETTINGS_NS = "serenity-hooks";
+/** 简单配置的扁平形态（运行时读取的统一形状；各功能门控只看它） */
 interface SerenitySimpleSettings {
     /** F1 双端口网关总开关 */
     gatewayEnabled: boolean;
     /** F2 超限重建总开关 */
     rebuildEnabled: boolean;
-    /** F2 触发阈值（需求① S142 用户拍板：百分比比例 → K 数值；projectedTokens ≥ thresholdK*1000 触发，纯绝对无窗口比例保护） */
+    /** F2 触发阈值（需求① S142 用户拍板：百分比比例 → K 数值；projectedTokens ≥ thresholdK*1000 触发） */
     rebuildThresholdK: number;
     /** F4 Skiff 调试服务总开关（实验性；默认关——不随插件加载自动启动，人工开启） */
     skiffEnabled: boolean;
     /** F4 Skiff 调试端口（默认 3099，仅 127.0.0.1） */
     skiffDebugPort: number;
-    /** F4c ACP HTTP JSON-RPC 端点总开关（实验性；默认关——人工开启） */
+    /** F4c ACP HTTP JSON-RPC 端点总开关（实验性；默认关） */
     acpEnabled: boolean;
     /** F4c ACP HTTP 端口（默认 3100，仅 127.0.0.1） */
     acpHttpPort: number;
     /** F4d 建议问答页总开关（实验性；默认关——按认知容器暴露问答页，key 认证） */
     publicAskEnabled: boolean;
-    /** **CRO（轨迹自编程唤起）总开关** —— 2026-09-21 所有者令新增。
+    /** **CRO（轨迹自编程唤起）总开关**（2026-09-21 所有者令新增；**缺省开**）。
      *
      *  CRO = 轨迹目录下放一个 `continuous-re-occurrence.ts`，由 ACC 的 5min tick spawn，
      *  由**程序**决定"要不要唤、何时唤、唤起的提示词是什么"。
-     *
-     *  **缺省开**：① 它已在生产上稳定运行（S151 / S185 各有程序在跑）；② 它的**默认存在感为零**
-     *  ——没有程序文件的轨迹本来就不参与；③ 缺省关会让"已上线的程序突然不跑"（等于静默回退）。
-     *  **只关 CRO 阶段**：`send-later` / `send-now` / 唤醒表投递**照常**（见 `cro.ts` 头注的承诺）。
-     *
-     *  ⚠️ 与它**同时废止**的键：`wakeSchedulerEnabled`（所有者 2026-09-21 令「send-later 的开关
-     *  不再重要了，砍掉」）——唤醒调度器**不再有任何闸**（恒开）；旧配置里的该键**静默忽略**。 */
+     *  缺省开的理由：① 已在生产稳定运行（S151 / S185）；② 默认存在感为零（没有程序文件的轨迹
+     *  本来就不参与）；③ 缺省关会让"已上线的程序突然不跑"。
+     *  **只关 CRO 阶段**：`send-later` / `send-now` / 唤醒表投递**照常**。
+     *  ⚠️ 与它**同时废止**的键：`wakeSchedulerEnabled`（唤醒调度器现恒开、无闸；旧键静默忽略）。 */
     croEnabled: boolean;
+    /** **无人值守代理回复（unattended proxy）总开关**（2026-09-23 所有者令新增；**缺省关**）。
+     *
+     *  开启后：CCC 会话**被 LLM 主动停止**且无人应答时，ACC 注入一次**代理用户的结构化回复**，
+     *  以**验证码（nonce）**作「合法收束」判据 —— **未回码 ⇒ 继续，回码 ⇒ 放过**。
+     *  **缺省关**：它把**人**从回路里拿掉（失败模式是静默的）。
+     *  **排除面**：仅有 CRO 程序的轨迹不适用（所有者 2026-09-23 裁决：口径由"宽"改"窄"
+     *  —— 原"任何自排唤醒都排除"会让本机制永远够不着靠续接绳活着的维护会话；改窄后
+     *  **自排绳不再排除**，绳退化为**长周期保险丝**）。设计全文见 S142 的 **D77**。 */
+    unattendedEnabled: boolean;
 }
-/** 从插件 Config 提取 entry 默认（settings base 层） */
-export declare function entryDefaults(config: SimpleConfigFragment): SerenitySimpleSettings;
-/** 进程级默认（无 settings 服务时的兜底） */
+/** 进程级默认（无 Config 可读时的兜底；与 Config 各字段的缺省一致） */
 export declare function defaultSimpleSettings(): SerenitySimpleSettings;
 /**
- * 读取当前简单配置（settings 解析值；无 provider/未注册 → entry 默认）。
- * 各功能（gateway/rebuild/naming）启动与运行时判断开关都经此函数。
+ * Config（宿主 Loader 校验后的解析值）→ 扁平简单配置。**本文件唯一的读取语义**。
+ *
+ * 优先级：**面板层（扁平键）> 部署层（嵌套段）> 内建缺省**。
+ * @param config - 插件 Config（`fiber.config` 或 apply 收到的 config）
+ * @returns 扁平开关集合
+ */
+export declare function simpleSettingsFromConfig(config: SimpleConfigFragment): SerenitySimpleSettings;
+/**
+ * 读取当前简单配置（各功能 gateway/rebuild/skiff/… 的启动与运行时判断都经此）。
+ *
+ * 源 = 本插件 fiber 的 `config`（宿主在配置变更时走 `fiber.update()` ⇒ `config` 始终最新，
+ * **不必**依赖 apply 重跑，也不必缓存）。
+ * @returns 扁平开关集合
  */
 export declare function readSimpleSettings(): SerenitySimpleSettings;
 /**
- * 测试注入钩子（生产零调用）：替换/恢复运行时源，便于单测各功能门控
- * （registerSettingsSection 的 setSource 回调在 mock dsh-settings 时不会触发）。
+ * 测试注入钩子（生产零调用）：替换/恢复运行时源，便于单测各功能门控。
  */
 export declare function __setSimpleSourceForTest(source: (() => SerenitySimpleSettings) | null): void;
 /**
- * 注册简单配置到 DSH settings（零改 DSH；settings.yaml 持久化 + 原生面板渲染）。
- * 注：插件 Config（cordis.yml 组合层）作为 base；用户文档层叠加其上。
- * 运行时读取简单配置统一经 `readSimpleSettings()`。
- * v1.28.0 适配 0.1.2-rc.1（B4）：`installSettingsSection`/`settingsNamespace` 便捷函数在
- * rc.1 消失 → 改 `SettingsProvider.installSection(owner, ns, schema, entry, hooks)`
- * （owner = consumer 插件 ctx；ns 直接字符串）。
+ * 装配简单配置读取面（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 不可用时的兜底）
  */
 export declare function registerSettingsSection(ctx: Context, config: SimpleConfigFragment): void;
 export {};

package/lib/skills-discovery.d.ts

@@ -1,14 +1,16 @@
 /**
  * skills-discovery.ts — CCC 入口 skill 自动发现（纯逻辑，零 DSH 依赖）
  *
- * 发现全部入口技能（原文全量，不截断）：
+ * 发现全部入口技能（原文全量，不截断）—— **现行三个来源**（原为四个，**来源 3 已于 2026-09-21 删除**）：
  *   0. **`.serenity` 记号文件内容 = 顶层入口 skill 名**（CCC 记号文件的权威语义，
  *      tiangong-serenity 的 .serenity 内容为 `tg-serenity`）—— 最高优先
  *   1. `.dsh/entry-skill` 指针文件（内容 = skill 名）—— 兼容旧约定
  *   2. `.opencode/skills/*-serenity/SKILL.md` —— 自动扫描该 CCC 的顶层入口
  *      （home-serenity / tg-serenity / pangu-serenity …，命名模式 `*-serenity`）
- *   3. `.dsh/skills/*-serenity/SKILL.md` —— 自动扫描 ACC/harness 入口（acc-serenity 等）
- * 按名去重；顺序 = 记号文件 → 指针 → opencode 入口 → dsh 入口。
+ *   ~~3. `.dsh/skills/*-serenity/SKILL.md`（扫 ACC 装进 CCC 的技能副本）~~ —— 🔴 **已删**：
+ *      owner 2026-09-21 令「连模板和安装命令一起删」（B 案）。**判据、实测证据与日期逐字记在
+ *      `findEntrySkills()` 体内那一段注释里**——本头部只留结论，**不复述判据**（避免两处会漂的真相源）。
+ * 按名去重；顺序 = 记号文件 → 指针 → opencode 入口。
  *
  * 任何 CCC 都能自动注入其顶层入口 skill 全文（不硬编码名字）。
  */

package/lib/trajectory-skills.d.ts

@@ -81,8 +81,10 @@ export declare function mergeSkillNames(cccSkills: readonly string[], trajSkills
  * @param mdPath 轨迹的 SESSION.md 路径（**来自绑定的 `mdPath`**，不用 label 拼）
  * @param maxChars 总长上限（字符）
  * @param cccSkills CCC 级声明（`readTrajectorySkills`；缺省空 = 只有轨迹级，行为与 v1.43 一致）
+ * @param onInjectedNames 观测回调（本次请求实际带上的 skill 名；**纯观测**，供用量统计用——
+ *        回调抛错被吞，**不影响注入正文**）
  * @returns 注入正文；两条来源皆无声明 → `''`（空串 = 宿主不产出该 section 块）；
  *          SESSION.md 缺失/读失败 → 响亮提示（若同时有 CCC 级声明，则提示在前、正文随后——
  *          **提示不因"别处有内容"而被吞掉**）
  */
-export declare function buildTrajectorySkillsSection(root: string, mdPath: string, maxChars?: number, cccSkills?: readonly string[]): string;
+export declare function buildTrajectorySkillsSection(root: string, mdPath: string, maxChars?: number, cccSkills?: readonly string[], onInjectedNames?: (names: readonly string[]) => void): string;