@shgroup/dsh-serenity-hooks 1.46.0 → 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/unattended-ops.d.ts

@@ -0,0 +1,247 @@
+/**
+ * unattended-ops.ts — 无人值守代理回复（unattended proxy）机制层（S142 **D77**，owner 2026-09-23 提案）
+ *
+ * ## 这东西用来干什么（白话）
+ *
+ * 用户发个任务就走开。现在模型干完一段就停下来等回话，用户不在 ⇒ **会话挂在那儿不动**。
+ * 本机制 = 用户走开后，系统**代替用户说一句"继续"**：让它自己跑完；干完了用一个**验证码**报告；
+ * 卡住了先自己想办法；真不能定的**写下来等用户回来**。
+ *
+ * ## 归属（D23：ACC 管机制与数据，CCC 管措辞与纪律）
+ *
+ * | 面 | 归谁 | 内容 |
+ * |---|---|---|
+ * | **机制** | 🔴 **ACC（本模块）** | 触发判定 / 验证码 / 四选一结构 / 轮上限 / 流水 |
+ * | **不可代批的*具体内容*** | **CCC 纪律** | ACC 只给**通用下限**（{@link UNATTENDED_BLOCKED_FLOOR}），CCC 可加严 |
+ *
+ * 🔵 下限之所以落在 ACC（而不是"完全交给 CCC"）：**没有这张清单，"自行解决"＝把所有把关点自动放行**。
+ * 最终内容仍待 owner 一句（设计 §13-5）——本版先给**保守下限**，CCC 只能在其上加严、不得放宽。
+ *
+ * ## 🔴 核心原则：单一续驱者（single-driver）
+ *
+ * > **一个会话同一时刻只应有一个"续驱者"：用户 ／ CRO ／ 自排绳 ／ 无人值守代理。**
+ *
+ * 口径（owner 2026-09-23 19:1x 裁决）= **窄口径：只排除「有 CRO 程序的轨迹」**。
+ * 原「宽口径」（任何自排唤醒都排除）**作废** —— 它会让本机制**永远够不着靠续接绳活着的会话**，
+ * 等于**放弃"代替旧机制"**（绳因此退化为**长周期保险丝**：6–12h 一条）。
+ *
+ * ## 🔴 铁律（与 `cro.ts` / `cro-log.ts` 同族，勿破）
+ *
+ * **本模块的每个导出函数都不抛错**：写盘 / 解析 / 裁剪失败一律返回结构化失败。
+ * ⇒ 代理机制的任何问题**不影响 turn 收尾**、不影响既有链路（唤醒投递 / 输出守卫 / rebuild）。
+ *
+ * ## 🔴 为什么不构成第二真相源（勿删此论证）
+ *
+ * | 载体 | 谁写 | 主语 | 回答 |
+ * |---|---|---|---|
+ * | `<轨迹目录>/unattended-log.json`（**本模块**） | **ACC** | ACC | 「**我注入了什么、判了什么、放过没有**」 |
+ * | `<轨迹目录>/SESSION.md` | **LLM（CCC）** | CCC | 「**这轮发生了什么、为什么这么定**」 |
+ *
+ * **内容不重叠**：本模块只记**机械事实**（轮次 / 验证码 / 判定理由码 / 是否放过），**不写散文**；
+ * LLM 侧的散文与理由归 SESSION.md。完整审计 = 两者合看（本模块 = 注入面｜SESSION.md = 判断面）。
+ *
+ * ## 🔴 验证码形态（禁用 4 位字母码）
+ *
+ * 注入文本**自带**"请回复 ABCD" ⇒ 模型**复述指令**即**假完成**（高概率，不是小概率）
+ * ⇒ 用**每轮新生成**的 nonce ＋ **包装 ＋ 独占一行**（`[[UNATTENDED-DONE:<hex>]]`），
+ * 明写「**旧码作废**」，校验**只认当前轮**（防上下文里的旧码复活）。
+ * 先例 = `handyman` background 的 `SERENITY_HANDYMAN_DONE_<16hex>`（同族实现）。
+ */
+/** 完成码包装前缀（**独占一行**才有意义；见文件头"禁用 4 位字母码"） */
+export declare const UNATTENDED_DONE_PREFIX = "[[UNATTENDED-DONE:";
+/** 完成码包装后缀 */
+export declare const UNATTENDED_DONE_SUFFIX = "]]";
+/** 注入消息的**首行标记**（幂等可辨：模型与事后审计都能一眼看出这是代理消息，不是用户消息） */
+export declare const UNATTENDED_PROXY_MARK = "[[UNATTENDED-PROXY v1]]";
+/** 🔴 合成消息**固定身份句**（owner 已裁：「形如用户消息，但首句自报身份与权限边界」） */
+export declare const UNATTENDED_IDENTITY_LINE = "\u65E0\u4EBA\u503C\u5B88\u4EE3\u7406 \u00B7 \u975E\u672C\u4EBA";
+/** nonce 字节数 ⇒ 16 个 hex 字符（与 handyman 同量级；够长到不可能被复述猜中） */
+export declare const UNATTENDED_NONCE_BYTES = 8;
+/** 生成一枚新 nonce（**每轮一枚**；旧码作废由调用方在文本里声明） */
+export declare function newNonce(): string;
+/** 完成码全文（注入文本展示用；校验走 {@link hasDoneToken}） */
+export declare function doneToken(nonce: string): string;
+/**
+ * 出现过的完成码 nonce 列表（按出现顺序、去重；**小写归一**）。
+ * 容忍 8–64 位 hex（模型可能手抄多/少几个字符 ⇒ 那就不匹配，属预期：只认本轮那枚）。
+ */
+export declare function parseDoneNonces(text: string): string[];
+/** 本轮收尾文本里是否出现过**当前轮**那枚码（唯一合法收束判据） */
+export declare function hasDoneToken(text: string, nonce: string): boolean;
+/** 单个会话在一个"代理段"内的**轮次上限**（设计建议 10–20；取 15——远小于 handyman 的 100） */
+export declare const UNATTENDED_MAX_ROUNDS = 15;
+/** 一个"代理段"的**墙钟上限**（自第一次注入起算；跨轮累计，防"轮次没到但烧了一天"） */
+export declare const UNATTENDED_MAX_WALL_MS: number;
+/** 触及即停（写待办/交接，**不循环**）——**CCC 的纪律更严则从严** */
+export declare const UNATTENDED_BLOCKED_FLOOR: readonly string[];
+/** 注入消息装配输入 */
+export interface ProxyMessageInput {
+    /** 本轮轮次号（1 起） */
+    round: number;
+    /** 轮上限（写进文本让模型知道还剩几轮） */
+    maxRounds: number;
+    /** 本轮 nonce */
+    nonce: string;
+    /** 不可代批清单（缺省 = {@link UNATTENDED_BLOCKED_FLOOR}） */
+    blocked?: readonly string[];
+}
+/** 组装一次代理注入消息（**形如用户消息，但首句自报身份与权限边界**） */
+export declare function buildProxyMessage(input: ProxyMessageInput): string;
+/**
+ * 组装一次**假完成打回**消息（设计 §7 的机械核验分支：声称已通知用户，但本轮无发送记录）。
+ *
+ * ⚠️ 同样带**新 nonce**：它是一次"再来一轮"，不是"放过"。
+ */
+export declare function buildFalseNotifyRebuke(input: ProxyMessageInput): string;
+/** 收尾文本是否**声称**已联系用户（见 {@link NOTIFY_CLAIM_PATTERNS} 的误判方向说明） */
+export declare function claimsUserNotification(text: string): boolean;
+/**
+ * **不许开**的会话（设计 §3 的"建议写死"，本版**确实写死**）：
+ * `skiff-`（F4 问答 / **微信桥会话也是这个前缀** —— 桥那侧的"用户"是**家人**，
+ * 代理替家人说话 = **冒充**）｜ `acp-`（对外程序化面）｜ `handyman-`（自主 worker，已有自己的完成码循环）。
+ *
+ * ⚠️ **`rebuild-` 不在排除面**（与 `output-guard-seam.ts` 的取向**刻意不同**）：重建会话是
+ * **同一轨迹的载体**（内部维护面），不是对外面；把它排除会让"重建后就没人推了"。
+ */
+export declare function isProxyExcludedSessionId(sessionId: string): boolean;
+/** 判定所需事实（**全部由 seam 取好**，本函数不做任何 I/O、不读时钟） */
+export interface UnattendedFacts {
+    /** 总闸（settings `unattendedEnabled`，缺省关） */
+    enabled: boolean;
+    /** 本会话所属 CCC 根；null = 不在任何 CCC 内 */
+    root: string | null;
+    /** 是 CCC 内**主会话**（`delegationDepth === 0`；子代理/无头运行不算） */
+    isMainSession: boolean;
+    /** 会话 id 在排除面（{@link isProxyExcludedSessionId}） */
+    sessionIdExcluded: boolean;
+    /** **本轮由真实用户消息发起**（`agent/inbox/claimed` + source.kind === 'user'） */
+    userInitiated: boolean;
+    /** 该轨迹**有 CRO 程序**（窄口径的唯一排除项） */
+    hasCroProgram: boolean;
+    /** 该会话当前的代理段状态；null = 尚未开始 */
+    run: ProxyRun | null;
+    /** 当前时刻（epoch ms，由调用方注入 ⇒ 用例可穷举时间边界） */
+    nowMs: number;
+    /** 收尾文本里出现的当前轮候选码（{@link parseDoneNonces} 的首个；无 ⇒ null） */
+    doneNonce: string | null;
+    /** 收尾文本**声称**已通知用户（{@link claimsUserNotification}） */
+    claimsNotify: boolean;
+    /** 本轮窗口内 ACC 侧**确实**发出过消息（{@link hasOutboundSendSince}） */
+    outboundSeen: boolean;
+}
+/** 判定结论（`reason` 是**机器可读理由码**：写进流水，便于事后 grep 归因） */
+export interface UnattendedVerdict {
+    action: 'skip' | 'accept' | 'inject' | 'cap';
+    reason: string;
+    /** 轮次号：`inject` = **即将注入**的那一轮；`accept` / `cap` = 当前轮；`skip` = 0 */
+    round: number;
+}
+/**
+ * 一次判定的**唯一入口**（纯函数）。
+ *
+ * 顺序即语义（R↓，勿随意调换）：
+ *  1. **闸/空间/会话资格**（关着、不在 CCC、非主会话、排除面）⇒ skip；
+ *  2. **单一续驱者**：用户刚发起 ⇒ skip（人就在场）；该轨迹有 CRO ⇒ skip（程序在驱动）；
+ *  3. **合法收束优先于轮上限** —— 最后一轮交的码必须算数（否则等于永远收不了尾）；
+ *  4. 交码 ＋ 声称已通知 ＋ **无发送记录** ⇒ 假完成，走下一轮（reason=`false-notify`）；
+ *  5. 墙钟 / 轮上限 ⇒ cap（**停下不动**，退回改造前的行为，不产生新风险）；
+ *  6. 其余 ⇒ inject 下一轮。
+ */
+export declare function decideUnattendedAction(f: UnattendedFacts): UnattendedVerdict;
+/** 一个会话的"代理段"状态（自第一次注入起算，直到 放过 / 上限 / 用户回来） */
+export interface ProxyRun {
+    /** 已注入到第几轮 */
+    round: number;
+    /** **当前轮**的 nonce（校验只认它） */
+    nonce: string;
+    /** 第一次注入的时刻（墙钟上限的起算点，**跨轮累计**） */
+    startedAt: number;
+}
+/** 取该会话的代理段（无 ⇒ null） */
+export declare function getProxyRun(sessionId: string): ProxyRun | null;
+/** 开始 / 推进一段代理（`startedAt` 由调用方给出 ⇒ 跨轮保留首次值） */
+export declare function setProxyRun(sessionId: string, run: ProxyRun): void;
+/** 结束该会话的代理段（放过 / 上限 / 用户回来 / 载体销毁） */
+export declare function clearProxyRun(sessionId: string): void;
+/** 当前在代理的会话 id（诊断 / 测试用） */
+export declare function proxyRunSessionIds(): string[];
+/** 当前代理中、已注入轮数的合计（`acc-diag` 观测面用） */
+export declare function activeProxyRoundTotal(): number;
+/** 记下"这个载体的这一轮是真实用户发起的" */
+export declare function noteUserTurn(sessionId: string, turn: number): void;
+/** 该载体的这一轮是否由真实用户发起（判据 = `noteUserTurn` 写入的最新一条） */
+export declare function isUserTurn(sessionId: string, turn: number | null | undefined): boolean;
+/** 清掉该载体的用户轮次记录（载体销毁时） */
+export declare function clearUserTurn(sessionId: string): void;
+/** 清空全部进程内运行态（disposer；**不碰磁盘**） */
+export declare function clearUnattendedState(): void;
+/** 测试辅助：复位（生产零调用） */
+export declare function __resetUnattendedForTest(): void;
+/** 每个 CCC 保留的最近发送条数（环形裁剪 ⇒ 表大小有界） */
+export declare const UNATTENDED_OUTBOUND_KEEP = 20;
+/** 发送记录保留窗（超出即丢：它只服务"这一轮到底发没发"这个瞬时问题） */
+export declare const UNATTENDED_OUTBOUND_TTL_MS: number;
+/**
+ * 记一次**成功的**出站发送（`im-bridge` 工具面在通道返回成功后调用）。
+ *
+ * ⚠️ **覆盖边界（诚实标注）**：只覆盖 **ACC 自己这条通道**（`im-bridge` 的 send / send-file）。
+ * CCC 自有的发送通道（如 `mail-tool` MSM）**ACC 看不见** ⇒ 那类"已通知"落到
+ * {@link hasOutboundSendSince} = false ⇒ 会被判成假完成。⇒ 本版口径：**代理模式下"联系用户"
+ * 只认 ACC 通道**；这与设计 §7 的原话（im-bridge 记日志）一致，边界写在此处以免误读。
+ */
+export declare function noteOutboundSend(root: string, atMs?: number): void;
+/** 自 `sinceMs` 起该 CCC 是否有过成功出站发送（**只读，不清表**——清理归写入侧的裁剪） */
+export declare function hasOutboundSendSince(root: string, sinceMs: number, nowMs?: number): boolean;
+/** 发送记录表大小（诊断 / 测试用） */
+export declare function outboundSendRoots(): string[];
+/** 固定文件名（与 `cro-wake-log.json` 并排、主语分明：那份记"我叫了什么"，这份记"我代说了什么"） */
+export declare const UNATTENDED_LOG_FILENAME = "unattended-log.json";
+/** 保留窗 = 2 日（与 CRO 流水同值；**常量** ⇒ 无需人工清理动作） */
+export declare const UNATTENDED_LOG_RETENTION_MS: number;
+/** 一条代理流水（**成功与失败都记**，与 CRO 流水同规格） */
+export interface UnattendedLogEntry {
+    /** 时刻（当地 RFC3339 带偏移，遵 D67） */
+    at: string;
+    /** 事件：inject（注入了一轮）/ accept（交码放过）/ cap（撞上限停下）/ yield（用户回来、让位） */
+    event: 'inject' | 'accept' | 'cap' | 'yield';
+    /** 轮次号 */
+    round: number;
+    /** 该轮 nonce（yield / cap 时 = 停下时的当前码；无 ⇒ null，**不留空白**） */
+    nonce: string | null;
+    /** 机器可读理由码（判定函数的 `reason`） */
+    reason: string;
+    /** 载体 dsh 会话 id（多载体轨迹可分辨） */
+    sessionId: string;
+}
+/** 文件形态（与 `wake-registry.json` / `cro-wake-log.json` 同款：`{version, entries}`） */
+export interface UnattendedLog {
+    version: number;
+    entries: UnattendedLogEntry[];
+}
+/** 日志绝对路径 */
+export declare function unattendedLogPath(root: string, dirName: string): string;
+/** 读取流水（**永不抛**；读坏 ⇒ 当作空档 + 返回 error 文本） */
+export declare function loadUnattendedLog(root: string, dirName: string): {
+    log: UnattendedLog;
+    error: string | null;
+};
+/**
+ * 按窗裁剪（**纯函数** ⇒ 可穷举测试）。
+ * 🔴 `at` 不可解析者**一律丢弃**并在返回值里报数（`dropped`）——**不静默吞掉**（同 `cro-log.ts` 纪律）。
+ */
+export declare function pruneUnattendedLogEntries(entries: UnattendedLogEntry[], nowMs: number, windowMs?: number): {
+    kept: UnattendedLogEntry[];
+    pruned: number;
+    dropped: number;
+};
+/**
+ * 追加一条流水并按窗裁剪（**本模块的落盘入口；永不抛**）。
+ *
+ * 顺序 = 读 → 追加 → 裁剪 → **原子写**（tmp + rename）。任一步失败 ⇒ `{ok:false, error}`，**不抛**
+ * ——调用方只记一行 console 日志 ⇒ **代理机制的问题绝不影响 turn 收尾**。
+ */
+export declare function appendUnattendedLog(root: string, dirName: string, entry: Omit<UnattendedLogEntry, 'at'>, nowMs?: number): {
+    ok: boolean;
+    error: string | null;
+    kept: number;
+};