@shgroup/dsh-serenity-hooks 1.40.1 → 1.42.0

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.40.1",
+  "version": "1.42.0",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag；后两个按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 轨迹日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2（deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/deepseek-vision-patch.d.ts

@@ -0,0 +1,168 @@
+/**
+ * deepseek-vision-patch.ts — DeepSeek 模型的"支持图片"声明自动补齐（临时，S142 §26 §0x-9）
+ *
+ * ## 这东西用来干什么（D70：先用途、后机制）
+ *
+ * DSH 里"某个模型能不能收图"**不是自动识别的**，而是靠**声明**。
+ * 声明链（`dsh-llm-pi-ai/lib/index.js:682`）：
+ *
+ *     input: declaredInput(entry.input) ?? base?.input ?? [...request.defaultInput]
+ *
+ * 少数模型在**内置目录**里声明了 `["text","image"]`（如 `deepseek-v4-flash-vision-exp`）；
+ * 而**不在目录里**的模型走最后一段兜底，`DEFAULT_INPUT = ["text"]`（`:906`）
+ * ⇒ **明明支持图片的模型被当成"只能收文字"**（图片被丢/报错）。
+ *
+ * 本模块：启动时检查模型配置，**凡 id 含 `deepseek` 的模型**，把 `input` 补上 `"image"`。
+ * ⇒ 效果：DeepSeek 系模型**开箱能收图**，无需用户手配。
+ *
+ * ## 为什么叫"临时"（owner 2026-09-19 原话：「临时的我允许」「以后 dsh 做得更完善了我们这个功能再下掉」）
+ *
+ * 这是在**替上游补一个它还缺的声明**。⇒ 设计上必须**易于整体撤除**（见 §撤除）。
+ *
+ * ## 授权与边界（**不是后门**）
+ *
+ * owner 2026-09-19 14:5x 明确授权走**写入型**（§0x-9d 路线 c）：
+ * 「临时的我允许，还是要 patch，帮我做个逻辑，如果发现任何 deepseek 模型，都直接 patch 支持多模态」。
+ * ⇒ 与 `opencode-provider.ts` **同款通道、同款授权模式**（`ctx.settings.update` 写 `llm-pi-ai` 命名空间）。
+ * 🔴 **只补缺失，绝不覆盖用户已有声明**（判据 J4）；**只碰 deepseek 模型**（判据 J1/J2）。
+ *
+ * ## 注入通道（唯一可用且是官方的）—— 与 `opencode-provider.ts` 同源
+ *
+ * `ctx.settings.update('llm-pi-ai', patch)`：
+ *   ① 深合并（`mergeLayers` 逐层递归）② **先校验后落盘** ③ `writable` ⇒ 写入用户 settings 文档（0600）。
+ *
+ * ## 🔴 核心实现约束：深合并对**数组是整体替换**（本模块最易错处）
+ *
+ * 宿主原文（`dsh-settings/lib/index.js:203-216`，逐字）：
+ *   "Layer `over` onto `under`: plain objects merge recursively,
+ *    **every other value (arrays included) replaces the lower layer wholesale**."
+ *
+ * ⇒ 若只发 `{ providers: { r: { models: [ 一个元素 ] } } }`，宿主会把它当**整个 models 数组**
+ * ⇒ **静默冲掉该 route 上其它所有模型**。
+ * ⇒ 本模块**必须读出现有 `models` 全量 → 内存里改目标元素 → 把改过的整个数组回写**。
+ * （该行为已由 `tests/host/deepseek-vision-probe.test.ts` 的 W-1 **实测**钉住，非仅源码推断。）
+ *
+ * ⚠️ 两条同族陷阱（已在实现中处理）：
+ *   ① 回写元素必须 **spread 原对象**（否则丢 `name`/`contextWindow`/`compat` 等字段 = 静默改配置）；
+ *   ② `modelOverrides` 与 `models` **互斥**（`dsh-llm-pi-ai/lib/index.js:643`）⇒
+ *      某 route 未设 `models` 时**绝不新建** `models` 数组（会让该 route 当场校验失败）。
+ *
+ * ## 已知边界（诚实，不粉饰）
+ *
+ * 🔴 **本模块只作用于 `llm-pi-ai` 面**。`dsh-llm-deepseek` 有自己的 `DEFAULT_MODELS` +
+ * `inputModalities` 字段（`dsh-llm-deepseek/lib/index.js:1841-1884`），**是另一条声明链**。
+ * ⇒ 若某 deepseek 模型仍收不了图，第一步应判定它走哪条链，而不是断定本 patch 失效。
+ *
+ * ## 撤除（三层，从便宜到彻底）
+ *
+ *   ① **关开关**：CCC 配置 `visionPatch.enabled = false` ⇒ 停止再补（已写的值留着）
+ *   ② **整体移除**：删本文件 + `index.ts` 一行装配 ⇒ 功能彻底消失
+ *   ③ **清值**：手动编辑 `~/.dsh/settings.yaml` 删掉那些 `input`
+ *
+ * 🔴 **刻意不做"回滚已写入的值"**（R↓）：我们写的是**事实**（"该模型支持图片"），不是**偏好**；
+ * 停掉插件后它依然是事实。做回滚需要一份"哪些是我们写的"的**写入台账**——
+ * 那是第二真相源，属本仓已多次识别过的"只增不清"病族（§0z / §0A-5），**不值得为它引入**。
+ */
+import type { Context } from 'cordis';
+/** 触发判据：模型 id 含此串即补（**大小写不敏感**；owner：「任何 deepseek 模型」） */
+export declare const DEEPSEEK_ID_MARKER = "deepseek";
+/** 要补上的模态（判据 J3） */
+export declare const VISION_MODALITY = "image";
+/**
+ * 该模型 id 是否属于"要 patch"的对象（判据 J1）。
+ *
+ * ⚠️ **大小写不敏感**：目录里存在 `deepseek-*` 与 `DeepSeek-*` 两种写法
+ * （如 `dsh-llm-deepseek` 的 `name: "DeepSeek-V41-Flash"`）⇒ 只做小写比较。
+ */
+export declare function isDeepseekModelId(id: unknown): boolean;
+/** 该 `input` 声明是否**已含** image（判据 J3/J4：已含即跳过 ⇒ 幂等） */
+export declare function declaresImage(input: unknown): boolean;
+/**
+ * 计算目标 `input` 数组（**保序去重**；判据 J3）。
+ *
+ * 六种现状 → 结果（设计 §4.2 全表，测试逐条钉住）：
+ * | 现状 | 结果 |
+ * |---|---|
+ * | 未设（undefined） | `["text","image"]` |
+ * | `["text"]` | `["text","image"]` |
+ * | `[]` | `["text","image"]` 🔴 `declaredInput([])` 返回 undefined（`:293`）⇒ 空数组语义上等于未声明 |
+ * | `["image"]` | **不动**（已含 ⇒ 由调用方跳过） |
+ * | `["text","image"]` | **不动**（幂等） |
+ * | 非数组（脏数据） | `["text","image"]`（按"未设"处理，不猜用户意图） |
+ *
+ * @returns 新的 input 数组（已含 image 时原样返回副本）
+ */
+export declare function desiredInput(input: unknown): string[];
+interface DeepseekVisionPatchInput {
+    /** `llm-pi-ai` 命名空间**解析后**的值（`settings.get` 结果；undefined = 命名空间未注册） */
+    resolved: unknown;
+    /** 开关（CCC 配置 `visionPatch.enabled`）；undefined ⇒ 按默认 true */
+    enabled?: boolean;
+}
+/** 一条动作记录（日志 + 测试断言共用；不返回"秘密"、只返回做了什么） */
+export type DeepseekVisionAction = {
+    kind: 'patch-model';
+    route: string;
+    model: string;
+} | {
+    kind: 'skip-model';
+    route: string;
+    model: string;
+    reason: 'already-image';
+} | {
+    kind: 'idle';
+    reason: 'namespace-unregistered' | 'disabled' | 'no-deepseek-model';
+};
+export interface DeepseekVisionPatchPlan {
+    /** 传给 `settings.update` 的补丁；空对象 = 无事可做（**不写**，避免无谓触发 settings/updated） */
+    patch: Record<string, unknown>;
+    actions: readonly DeepseekVisionAction[];
+}
+/**
+ * 计算 patch 计划（**纯函数**：不读文件、不碰 ctx —— 便于穷举测试）。
+ *
+ * 判据顺序（R↓）：
+ *   ① 开关关闭 → idle `disabled`（**最先判**：关了就不该再看数据）
+ *   ② 命名空间未注册（`resolved === undefined`）→ idle，调用方负责重试（llm-pi-ai 可能后装载）
+ *   ③ 逐 route 遍历 `models` 数组：
+ *        · 目标是 deepseek 且未声明 image ⇒ 该模型换新 input
+ *        · 否则**原样保留**（非 deepseek 一律不动；已含 image 一律不动）
+ *      ⇒ 仅当**整个数组确有变化**时才产出 patch（幂等 ⇒ 稳态下零写入）
+ *   ④ 全无改动 → idle `no-deepseek-model`
+ *
+ * 🔴 **数组整写**：`patchProviders[route] = { models: 新数组 }` —— 新数组是**全量**
+ * （未改动的元素**原样带上**）。这是本模块最关键的实现约束，理由见文件头。
+ *
+ * 🔴 **绝不新建 `models`**：某 route 没有 `models`（用 `modelOverrides` 或目录默认）时**直接跳过**
+ * ——为它造一个 `models` 会让宿主拒掉整个 route（`:643` 二者互斥）。
+ */
+export declare function planDeepseekVisionPatch(input: DeepseekVisionPatchInput): DeepseekVisionPatchPlan;
+/** 动作 → 单行人读日志（无秘密） */
+export declare function describeDeepseekVisionAction(action: DeepseekVisionAction): string;
+/** 执行结果（调用方据此决定是否停止重试 / 日志） */
+export interface DeepseekVisionApplyResult {
+    /** 是否**真的写入了** */
+    wrote: boolean;
+    /** 命名空间是否已注册（false ⇒ 调用方应重试） */
+    registered: boolean;
+}
+/**
+ * 执行一次自动补齐。返回是否写入了（调用方据此决定是否停止重试）。
+ *
+ * 失败语义（F-08/F-07 纪律）：**任何失败都不抛给宿主**——
+ * apply 抛错 = 整个 dsh 启动失败。一律 try/catch + 响亮告警，
+ * 最坏情况退回"用户手配 input"。
+ */
+export declare function applyDeepseekVisionPatchOnce(ctx: Context, enabled?: boolean): Promise<DeepseekVisionApplyResult>;
+/**
+ * 装配 DeepSeek 多模态补丁。
+ *
+ * 触发面（三层，与 opencode-provider 同款）：
+ *   ① apply 时立即试一次
+ *   ② 命名空间尚未注册 → 退避重试（1s/3s/8s/20s/40s）
+ *   ③ `settings/updated` → 再试（用户热改 settings.yaml 时自愈；自身写入触发的复评是幂等空转）
+ *
+ * 🔴 不设"一次性完成"闸门：③ 必须能持续生效（用户随时可能新增 deepseek 模型）。
+ */
+export declare function registerDeepseekVisionPatch(ctx: Context, enabled?: boolean): void;
+export {};

package/lib/diag-ops.d.ts

@@ -11,7 +11,9 @@
  *   ①  live 运行态 —— 插件进程内 `diagLive(ctx)`（进程 cwd/CCC + live 会话清单）
  *       ——**独立进程看不到运行时**，这正是本工具存在的理由
  *   ①b 唤醒时钟 —— `containerClocks().wake`（唤醒调度器进程内快照：武装态/计数/上次跳过原因）
- *   ③  唤醒注册表 —— `wake-registry.json` 全量条目（state / at / target / lastResult）+ 补跑窗口
+ *   ③  唤醒注册表 —— `wake-registry.json` 的**在办条目**（state / at / target / lastResult）+ 补跑窗口
+ *       （🔴 2026-09-19 §0Q 甲案：终态条目**结案即清除** ⇒ 本段只列在办项，不再是"历史全量"；
+ *        历史由 SESSION.md / 工具输出承担——该承诺原本就写在 `wake-registry.ts` 注释里，本次做实）
  *
  * ── 2026-09-15：段数由四降为三（S142「ACC 侧 autopilot 退场」§1 二阶裁定）─────────────
  * ACC 侧 autopilot 整段退场后，报告里两段的**主语消失**，故删除（不是"暂时关掉"）：

package/lib/index.d.ts

@@ -72,6 +72,16 @@ export interface Config {
     opencodeProvider?: {
         autoConfigure?: boolean;
     };
+    /**
+     * v1.40.x DeepSeek 多模态临时补丁（plugin 全局；S142 owner 2026-09-19 令）：
+     * 给 id 含 `deepseek` 的模型补 `input: [...,"image"]`——因为 DSH 里"模型能否收图"靠**声明**，
+     * 而**不在内置目录里**的模型走 `DEFAULT_INPUT = ["text"]` 兜底 ⇒ 明明支持图片却被当成只能收文字。
+     * 缺省开（`!== false` 判定）。🔴 **临时功能**：owner「以后 dsh 做得更完善了我们这个功能再下掉」
+     * ⇒ 关闭 = 停止再补；**不回滚已写入的值**（写的是"该模型支持图片"这个**事实**，不是偏好）。
+     */
+    visionPatch?: {
+        enabled?: boolean;
+    };
 }
 export declare const Config: z<Config>;
 export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -7,7 +7,7 @@ import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPE
 import { a as readSkiffRoles, c as roleMsmWhitelist, d as systemPromptSource, f as trajectorySubset, i as isSkiffSessionId, l as roleToolWhitelist, n as buildSkiffBasePrompt, o as resolveRoleSystemPrompt, r as createRolePromptReader, s as resolveSkiffKind } from "./skiff-role-CEHL5cek.js";
 import { a as unregisterSkiffSession$1, i as skiffSessionSnapshot$1, n as skiffRoleFor$1, r as skiffSessionInfo$1, t as registerSkiffSession$1 } from "./skiff-registry-FTjoWQTQ.js";
 import { r as sessionsRootDir, t as hasSessionLogById } from "./session-cleanup-BtkSmry8.js";
-import { a as WAKE_CATCH_UP_MS, i as registerDisposer, n as sendToTrajectory, o as addWake, r as wakeSchedulerState, s as listWakes, t as registerWakeScheduler } from "./wake-scheduler-BRnPUnER.js";
+import { a as WAKE_CATCH_UP_MS, i as registerDisposer, n as sendToTrajectory, o as addWake, r as wakeSchedulerState, s as listWakes, t as registerWakeScheduler } from "./wake-scheduler-1AsvNQPW.js";
 import { a as FACE_PORTS, c as MECHANISM_PORTS, i as ACP_HTTP_PORT, l as SKIFF_DEBUG_PORT, n as registerSettingsSection, o as GATEWAY_PORT, s as MAIN_WEB_PORT, t as readSimpleSettings, u as WEIXIN_SEND_PORT } from "./settings-section-DMDUoQum.js";
 import { a as markdownToPlainText, c as sendTyping, i as getUpdates, l as sniffImageExt, n as downloadMedia, o as sendFileMessage, r as getConfig, s as sendTextMessage, t as TypingStatus } from "./weixin-api-CtFYm53S.js";
 import z from "@deepseek-ai/schemastery";
@@ -13570,7 +13570,7 @@ function opencodeRouteHeaders() {
 		"x-opencode-project": "global"
 	};
 }
-function isPlainObject(value) {
+function isPlainObject$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /** 该路由是否指向 opencode（按路由名，或按 baseURL 主机名——用户可能把路由改名） */
@@ -13622,14 +13622,14 @@ function planOpencodeAutoConfig(input) {
 			reason: "namespace-unregistered"
 		}]
 	};
-	const providers = isPlainObject(input.resolved) && isPlainObject(input.resolved.providers) ? input.resolved.providers : {};
+	const providers = isPlainObject$1(input.resolved) && isPlainObject$1(input.resolved.providers) ? input.resolved.providers : {};
 	const patchProviders = {};
 	let sawOpencodeRoute = false;
 	for (const [route, rawProfile] of Object.entries(providers)) {
-		const profile = isPlainObject(rawProfile) ? rawProfile : {};
+		const profile = isPlainObject$1(rawProfile) ? rawProfile : {};
 		if (!isOpencodeRoute(route, profile)) continue;
 		sawOpencodeRoute = true;
-		const existing = isPlainObject(profile.headers) ? profile.headers : {};
+		const existing = isPlainObject$1(profile.headers) ? profile.headers : {};
 		const sessionId = sessionIdentityValue(existing);
 		const wanted = {
 			...opencodeRouteHeaders(),
@@ -13740,7 +13740,7 @@ async function applyOpencodeAutoConfigOnce(ctx, env) {
 * 与本插件 apply **无先后保证**（两者都依赖 settings 服务）。首次读取拿到 undefined 是常态而非错误
 * （与 skiff 的 CCC root 重试同款问题、同款处置：v1.30.13 实证"只在 apply 时试一次 → 永不重试"）。
 */
-const NAMESPACE_RETRY_DELAYS_MS = [
+const NAMESPACE_RETRY_DELAYS_MS$1 = [
 	1e3,
 	3e3,
 	8e3,
@@ -13769,12 +13769,12 @@ function registerOpencodeAutoConfig(ctx) {
 	};
 	const scheduleRetry = () => {
 		if (retryTimer !== null || settled) return;
-		if (retries >= NAMESPACE_RETRY_DELAYS_MS.length) {
+		if (retries >= NAMESPACE_RETRY_DELAYS_MS$1.length) {
 			console.warn(`[serenity-hooks] opencode 路由自动配置放弃：重试 ${retries} 次仍等不到 ${LLM_PI_AI_NAMESPACE} 命名空间（未使用 pi-ai 适配器时正常；若要手配见 README）`);
 			settled = true;
 			return;
 		}
-		const delay = NAMESPACE_RETRY_DELAYS_MS[retries] ?? 0;
+		const delay = NAMESPACE_RETRY_DELAYS_MS$1[retries] ?? 0;
 		retryTimer = setTimeout(() => {
 			retryTimer = null;
 			retries += 1;
@@ -13802,6 +13802,250 @@ function registerOpencodeAutoConfig(ctx) {
 	sync();
 	registerDisposer(ctx, "opencode provider auto-config retry timer", clearRetry);
 }
+/** 要补上的模态（判据 J3） */
+const VISION_MODALITY = "image";
+/** 文本模态（补 `image` 时保证 `text` 在列——兜底现状就是 `["text"]`，故保持这个基线） */
+const TEXT_MODALITY = "text";
+/**
+* 该模型 id 是否属于"要 patch"的对象（判据 J1）。
+*
+* ⚠️ **大小写不敏感**：目录里存在 `deepseek-*` 与 `DeepSeek-*` 两种写法
+* （如 `dsh-llm-deepseek` 的 `name: "DeepSeek-V41-Flash"`）⇒ 只做小写比较。
+*/
+function isDeepseekModelId(id) {
+	return typeof id === "string" && id.toLowerCase().includes("deepseek");
+}
+/** 该 `input` 声明是否**已含** image（判据 J3/J4：已含即跳过 ⇒ 幂等） */
+function declaresImage(input) {
+	return Array.isArray(input) && input.includes("image");
+}
+/**
+* 计算目标 `input` 数组（**保序去重**；判据 J3）。
+*
+* 六种现状 → 结果（设计 §4.2 全表，测试逐条钉住）：
+* | 现状 | 结果 |
+* |---|---|
+* | 未设（undefined） | `["text","image"]` |
+* | `["text"]` | `["text","image"]` |
+* | `[]` | `["text","image"]` 🔴 `declaredInput([])` 返回 undefined（`:293`）⇒ 空数组语义上等于未声明 |
+* | `["image"]` | **不动**（已含 ⇒ 由调用方跳过） |
+* | `["text","image"]` | **不动**（幂等） |
+* | 非数组（脏数据） | `["text","image"]`（按"未设"处理，不猜用户意图） |
+*
+* @returns 新的 input 数组（已含 image 时原样返回副本）
+*/
+function desiredInput(input) {
+	if (!Array.isArray(input)) return [TEXT_MODALITY, VISION_MODALITY];
+	if (input.length === 0) return [TEXT_MODALITY, VISION_MODALITY];
+	const out = input.filter((m) => typeof m === "string");
+	if (out.includes("image")) return out;
+	if (!out.includes(TEXT_MODALITY)) out.unshift(TEXT_MODALITY);
+	out.push(VISION_MODALITY);
+	return out;
+}
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* 计算 patch 计划（**纯函数**：不读文件、不碰 ctx —— 便于穷举测试）。
+*
+* 判据顺序（R↓）：
+*   ① 开关关闭 → idle `disabled`（**最先判**：关了就不该再看数据）
+*   ② 命名空间未注册（`resolved === undefined`）→ idle，调用方负责重试（llm-pi-ai 可能后装载）
+*   ③ 逐 route 遍历 `models` 数组：
+*        · 目标是 deepseek 且未声明 image ⇒ 该模型换新 input
+*        · 否则**原样保留**（非 deepseek 一律不动；已含 image 一律不动）
+*      ⇒ 仅当**整个数组确有变化**时才产出 patch（幂等 ⇒ 稳态下零写入）
+*   ④ 全无改动 → idle `no-deepseek-model`
+*
+* 🔴 **数组整写**：`patchProviders[route] = { models: 新数组 }` —— 新数组是**全量**
+* （未改动的元素**原样带上**）。这是本模块最关键的实现约束，理由见文件头。
+*
+* 🔴 **绝不新建 `models`**：某 route 没有 `models`（用 `modelOverrides` 或目录默认）时**直接跳过**
+* ——为它造一个 `models` 会让宿主拒掉整个 route（`:643` 二者互斥）。
+*/
+function planDeepseekVisionPatch(input) {
+	const actions = [];
+	if (input.enabled === false) return {
+		patch: {},
+		actions: [{
+			kind: "idle",
+			reason: "disabled"
+		}]
+	};
+	if (input.resolved === void 0) return {
+		patch: {},
+		actions: [{
+			kind: "idle",
+			reason: "namespace-unregistered"
+		}]
+	};
+	const providers = isPlainObject(input.resolved) && isPlainObject(input.resolved.providers) ? input.resolved.providers : {};
+	const patchProviders = {};
+	for (const [route, rawProfile] of Object.entries(providers)) {
+		const models = (isPlainObject(rawProfile) ? rawProfile : {}).models;
+		if (!Array.isArray(models) || models.length === 0) continue;
+		let changed = false;
+		const nextModels = models.map((rawEntry) => {
+			if (!isPlainObject(rawEntry)) return rawEntry;
+			const id = rawEntry.id;
+			if (!isDeepseekModelId(id)) return rawEntry;
+			if (declaresImage(rawEntry.input)) {
+				actions.push({
+					kind: "skip-model",
+					route,
+					model: String(id),
+					reason: "already-image"
+				});
+				return rawEntry;
+			}
+			changed = true;
+			actions.push({
+				kind: "patch-model",
+				route,
+				model: String(id)
+			});
+			return {
+				...rawEntry,
+				input: desiredInput(rawEntry.input)
+			};
+		});
+		if (changed) patchProviders[route] = { models: nextModels };
+	}
+	if (Object.keys(patchProviders).length === 0) {
+		if (actions.length === 0) actions.push({
+			kind: "idle",
+			reason: "no-deepseek-model"
+		});
+		return {
+			patch: {},
+			actions
+		};
+	}
+	return {
+		patch: { providers: patchProviders },
+		actions
+	};
+}
+/**
+* 执行一次自动补齐。返回是否写入了（调用方据此决定是否停止重试）。
+*
+* 失败语义（F-08/F-07 纪律）：**任何失败都不抛给宿主**——
+* apply 抛错 = 整个 dsh 启动失败。一律 try/catch + 响亮告警，
+* 最坏情况退回"用户手配 input"。
+*/
+async function applyDeepseekVisionPatchOnce(ctx, enabled) {
+	const settings = hostSettings(ctx);
+	if (settings?.get === void 0 || settings.update === void 0) {
+		console.warn("[serenity-hooks] DeepSeek 多模态补丁跳过：settings 服务不可用（未能读写 llm-pi-ai 命名空间）");
+		return {
+			wrote: false,
+			registered: false
+		};
+	}
+	let resolved;
+	try {
+		resolved = settings.get.call(settings, LLM_PI_AI_NAMESPACE);
+	} catch (error) {
+		console.warn(`[serenity-hooks] DeepSeek 多模态补丁跳过：读取 ${LLM_PI_AI_NAMESPACE} 失败: ${String(error?.message ?? error)}`);
+		return {
+			wrote: false,
+			registered: false
+		};
+	}
+	const plan = planDeepseekVisionPatch({
+		resolved,
+		...enabled === void 0 ? {} : { enabled }
+	});
+	if (Object.keys(plan.patch).length === 0) return {
+		wrote: false,
+		registered: resolved !== void 0
+	};
+	try {
+		await settings.update.call(settings, LLM_PI_AI_NAMESPACE, plan.patch);
+	} catch (error) {
+		console.warn(`[serenity-hooks] ✗ DeepSeek 多模态补丁写入被拒: ${String(error?.message ?? error)}（可手动写入 llm-pi-ai.providers.<route>.models[].input）`);
+		return {
+			wrote: false,
+			registered: true
+		};
+	}
+	const changed = plan.actions.filter((a) => a.kind === "patch-model");
+	if (changed.length > 0) console.log(`[serenity-hooks] ✓ DeepSeek 多模态：为 ${changed.length} 个模型补上 image 声明（${changed.map((a) => `${a.route}/${a.model}`).join(", ")}）`);
+	return {
+		wrote: true,
+		registered: true
+	};
+}
+/**
+* 命名空间注册重试间隔（毫秒；累计 ~72s）。
+*
+* 为什么要重试：`llm-pi-ai` 只在**它自己的** `ctx.inject(['settings'])` 回调里注册命名空间，
+* 与本插件 apply **无先后保证**。首次读取拿到 undefined 是常态而非错误
+* （与 opencode-provider 同款问题、同款处置：v1.30.13 实证"只在 apply 时试一次 → 永不重试"）。
+*/
+const NAMESPACE_RETRY_DELAYS_MS = [
+	1e3,
+	3e3,
+	8e3,
+	2e4,
+	4e4
+];
+/**
+* 装配 DeepSeek 多模态补丁。
+*
+* 触发面（三层，与 opencode-provider 同款）：
+*   ① apply 时立即试一次
+*   ② 命名空间尚未注册 → 退避重试（1s/3s/8s/20s/40s）
+*   ③ `settings/updated` → 再试（用户热改 settings.yaml 时自愈；自身写入触发的复评是幂等空转）
+*
+* 🔴 不设"一次性完成"闸门：③ 必须能持续生效（用户随时可能新增 deepseek 模型）。
+*/
+function registerDeepseekVisionPatch(ctx, enabled) {
+	let settled = false;
+	let retryTimer = null;
+	let retries = 0;
+	const clearRetry = () => {
+		if (retryTimer !== null) {
+			clearTimeout(retryTimer);
+			retryTimer = null;
+		}
+	};
+	const scheduleRetry = () => {
+		if (retryTimer !== null || settled) return;
+		if (retries >= NAMESPACE_RETRY_DELAYS_MS.length) {
+			console.warn(`[serenity-hooks] DeepSeek 多模态补丁放弃：重试 ${retries} 次仍等不到 ${LLM_PI_AI_NAMESPACE} 命名空间（未使用 pi-ai 适配器时正常）`);
+			settled = true;
+			return;
+		}
+		const delay = NAMESPACE_RETRY_DELAYS_MS[retries] ?? 0;
+		retryTimer = setTimeout(() => {
+			retryTimer = null;
+			retries += 1;
+			sync();
+		}, delay);
+		retryTimer.unref?.();
+	};
+	function sync() {
+		applyDeepseekVisionPatchOnce(ctx, enabled).then((result) => {
+			if (result.registered) {
+				settled = true;
+				clearRetry();
+			} else if (!settled) scheduleRetry();
+		}).catch((error) => {
+			console.warn(`[serenity-hooks] DeepSeek 多模态补丁异常: ${String(error?.message ?? error)}`);
+			settled = true;
+			clearRetry();
+		});
+	}
+	try {
+		ctx.on?.call(ctx, "settings/updated", (ns) => {
+			if (ns === "llm-pi-ai") sync();
+		});
+	} catch {}
+	sync();
+	registerDisposer(ctx, "deepseek vision patch retry timer", clearRetry);
+}
 //#endregion
 //#region src/im-weixin.ts
 /**
@@ -14313,7 +14557,9 @@ function containerStatus(opts = {}) {
 *   ①  live 运行态 —— 插件进程内 `diagLive(ctx)`（进程 cwd/CCC + live 会话清单）
 *       ——**独立进程看不到运行时**，这正是本工具存在的理由
 *   ①b 唤醒时钟 —— `containerClocks().wake`（唤醒调度器进程内快照：武装态/计数/上次跳过原因）
-*   ③  唤醒注册表 —— `wake-registry.json` 全量条目（state / at / target / lastResult）+ 补跑窗口
+*   ③  唤醒注册表 —— `wake-registry.json` 的**在办条目**（state / at / target / lastResult）+ 补跑窗口
+*       （🔴 2026-09-19 §0Q 甲案：终态条目**结案即清除** ⇒ 本段只列在办项，不再是"历史全量"；
+*        历史由 SESSION.md / 工具输出承担——该承诺原本就写在 `wake-registry.ts` 注释里，本次做实）
 *
 * ── 2026-09-15：段数由四降为三（S142「ACC 侧 autopilot 退场」§1 二阶裁定）─────────────
 * ACC 侧 autopilot 整段退场后，报告里两段的**主语消失**，故删除（不是"暂时关掉"）：
@@ -14388,10 +14634,11 @@ function renderAccDiag(r) {
 	lines.push("");
 	lines.push(renderClock("唤醒调度器（wake-registry tick）", r.clocks.wake));
 	lines.push("");
-	lines.push(`── ③ 唤醒注册表（${r.ccc}/AGENT_SESSIONS/wake-registry.json）──`);
+	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.entries.length} 条（在办 ${r.wakes.pending}）｜补跑窗口 ${WAKE_CATCH_UP_MS / 36e5}h`);
-	if (r.wakes.entries.length === 0) lines.push("（无条目）");
+	if (r.wakes.entries.length === 0) lines.push("（无在办条目）");
 	for (const w of r.wakes.entries) {
 		lines.push(`  · ${w.id} [${w.state}] at=${w.at} → ${w.target} by=${w.createdBy} attempts=${w.attempts}`);
 		if (w.lastResult) lines.push(`      lastResult: ${w.lastResult}`);
@@ -14653,7 +14900,8 @@ const Config = z.object({
 		httpPort: z.number().min(1024).max(65535).default(ACP_HTTP_PORT)
 	}),
 	webFetch: z.object({ enabled: z.boolean().default(true) }),
-	opencodeProvider: z.object({ autoConfigure: z.boolean().default(true) })
+	opencodeProvider: z.object({ autoConfigure: z.boolean().default(true) }),
+	visionPatch: z.object({ enabled: z.boolean().default(true) })
 });
 function apply(ctx, config) {
 	try {
@@ -14717,6 +14965,7 @@ function apply(ctx, config) {
 	registerLifecycle(ctx);
 	if (config.webFetch?.enabled !== false) registerWebFetchProvider(ctx);
 	if (config.opencodeProvider?.autoConfigure !== false) registerOpencodeAutoConfig(ctx);
+	if (config.visionPatch?.enabled !== false) registerDeepseekVisionPatch(ctx, true);
 }
 /**
 * F4 Skiff 调试服务装配：启停 = 人工（设置面板 Skiff 区块开关，settings 持久化）。

package/lib/wake-registry.d.ts

@@ -118,8 +118,61 @@ export declare function splitDueWakes(registry: WakeRegistry, nowMs: number, cat
     due: WakeEntry[];
     expired: WakeEntry[];
 };
+/**
+ * 🔴 结案并**移除**一条（owner 2026-09-19 裁定「**直接删**」，S142 §0Q 甲案）。
+ *
+ * ## 为什么删（R↓）
+ *
+ * 本模块原本是「`pending` → 终态」但**终态条目永不移除** ⇒ 文件**只增**（实测 308 KB / 143+ 条）。
+ * owner 明令「应当**唤醒后就清理**的」⇒ 终态即删。
+ *
+ * **审计不丢**：由 **SESSION.md 与工具输出**承担——这正是本文件 `removeWake` 的既有注释承诺
+ * （*"审计由 SESSION.md 与工具输出承担——注册表只保留在办项"*）。
+ * ⚠️ 此前该承诺**并未兑现**（`updateWake` 只改 state 从不删行）⇒ 本次是**把承诺做实**。
+ *
+ * ## 与 `updateWake` 的分工（**别混用**）
+ *
+ * - `updateWake`：**仍在办**的推进（失败重试 `state:'pending'` + `attempts+1`）⇒ **保留行**；
+ * - `finalizeWake`：**不再办**的归宿（投递成功 / 超窗 missed）⇒ 写终态后**同一笔事务里删掉**。
+ *
+ * 🔴 **为什么两个动作要同一次写盘**：若先 `updateWake(delivered)` 再 `removeWake`，
+ * 中间被打断会留下一条"已终结但没删"的条目 ⇒ 又回到只增。
+ * 故本函数**读一次、改一次、删一次、写一次**（单次原子落盘）。
+ *
+ * @param root CCC 根
+ * @param id 条目 id
+ * @param terminal 终态（`delivered` / `missed` / `cancelled`）——写入仅用于**日志文案**，
+ *                 随即整行移除；保留该参数是为了让调用点语义自明（"它归到哪一档了"）。
+ * @param result 人读结果（进日志，不进表）
+ * @returns `removed` = 被移除的条目（供调用方打印"它是什么"）；不存在 → 稳定错误码
+ */
+export declare function finalizeWake(root: string, id: string, terminal: 'delivered' | 'missed' | 'cancelled', result: string): {
+    ok: boolean;
+    error: string | null;
+    removed: WakeEntry | null;
+};
+/**
+ * 一次性清除**存量终态条目**（`delivered` / `missed` / `cancelled`）。
+ *
+ * ## 为什么需要（不是可选）
+ *
+ * 本函数上线前，表里已积压 143+ 条终态记录（308 KB）⇒ **只改行为不改存量 = 文件不再涨但仍很大**。
+ * 故首次运行须清一次。**幂等**（无终态条目时空转，不写盘）。
+ *
+ * 审计不丢：与 `finalizeWake` 同理（终态本就属性"已结案"，其史由 SESSION.md 承担）。
+ * @param root CCC 根
+ * @returns 清掉几条（0 = 本来就没有）
+ */
+export declare function purgeFinalizedWakes(root: string): {
+    ok: boolean;
+    error: string | null;
+    purged: number;
+};
 /**
  * 更新一条（状态推进；调用方给最终状态与结果文案）。
+ *
+ * ⚠️ **只用于"仍在办"的推进**（主要是失败重试）。**终态请用 `finalizeWake`**——
+ * 否则该行会永远留下（这正是本表过去只增的根因，见 `finalizeWake` 注释）。
  * @param root CCC 根
  * @param id 条目 id
  * @param patch 要写入的字段

package/lib/{wake-scheduler-BRnPUnER.js → wake-scheduler-1AsvNQPW.js}

@@ -230,7 +230,109 @@ function splitDueWakes(registry, nowMs, catchUpMs = WAKE_CATCH_UP_MS) {
 	};
 }
 /**
+* 🔴 结案并**移除**一条（owner 2026-09-19 裁定「**直接删**」，S142 §0Q 甲案）。
+*
+* ## 为什么删（R↓）
+*
+* 本模块原本是「`pending` → 终态」但**终态条目永不移除** ⇒ 文件**只增**（实测 308 KB / 143+ 条）。
+* owner 明令「应当**唤醒后就清理**的」⇒ 终态即删。
+*
+* **审计不丢**：由 **SESSION.md 与工具输出**承担——这正是本文件 `removeWake` 的既有注释承诺
+* （*"审计由 SESSION.md 与工具输出承担——注册表只保留在办项"*）。
+* ⚠️ 此前该承诺**并未兑现**（`updateWake` 只改 state 从不删行）⇒ 本次是**把承诺做实**。
+*
+* ## 与 `updateWake` 的分工（**别混用**）
+*
+* - `updateWake`：**仍在办**的推进（失败重试 `state:'pending'` + `attempts+1`）⇒ **保留行**；
+* - `finalizeWake`：**不再办**的归宿（投递成功 / 超窗 missed）⇒ 写终态后**同一笔事务里删掉**。
+*
+* 🔴 **为什么两个动作要同一次写盘**：若先 `updateWake(delivered)` 再 `removeWake`，
+* 中间被打断会留下一条"已终结但没删"的条目 ⇒ 又回到只增。
+* 故本函数**读一次、改一次、删一次、写一次**（单次原子落盘）。
+*
+* @param root CCC 根
+* @param id 条目 id
+* @param terminal 终态（`delivered` / `missed` / `cancelled`）——写入仅用于**日志文案**，
+*                 随即整行移除；保留该参数是为了让调用点语义自明（"它归到哪一档了"）。
+* @param result 人读结果（进日志，不进表）
+* @returns `removed` = 被移除的条目（供调用方打印"它是什么"）；不存在 → 稳定错误码
+*/
+function finalizeWake(root, id, terminal, result) {
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error,
+		removed: null
+	};
+	const idx = registry.entries.findIndex((e) => e.id === id);
+	if (idx < 0) return {
+		ok: false,
+		error: `wake_not_found: ${id}`,
+		removed: null
+	};
+	const [removed] = registry.entries.splice(idx, 1);
+	const saved = saveWakeRegistry(root, registry);
+	if (!saved.ok) return {
+		ok: false,
+		error: saved.error,
+		removed: null
+	};
+	return {
+		ok: true,
+		error: null,
+		removed: {
+			...removed,
+			state: terminal,
+			lastResult: result
+		}
+	};
+}
+/**
+* 一次性清除**存量终态条目**（`delivered` / `missed` / `cancelled`）。
+*
+* ## 为什么需要（不是可选）
+*
+* 本函数上线前，表里已积压 143+ 条终态记录（308 KB）⇒ **只改行为不改存量 = 文件不再涨但仍很大**。
+* 故首次运行须清一次。**幂等**（无终态条目时空转，不写盘）。
+*
+* 审计不丢：与 `finalizeWake` 同理（终态本就属性"已结案"，其史由 SESSION.md 承担）。
+* @param root CCC 根
+* @returns 清掉几条（0 = 本来就没有）
+*/
+function purgeFinalizedWakes(root) {
+	const { registry, error } = loadWakeRegistry(root);
+	if (error) return {
+		ok: false,
+		error,
+		purged: 0
+	};
+	const kept = registry.entries.filter((e) => e.state === "pending");
+	const purged = registry.entries.length - kept.length;
+	if (purged === 0) return {
+		ok: true,
+		error: null,
+		purged: 0
+	};
+	const saved = saveWakeRegistry(root, {
+		...registry,
+		entries: kept
+	});
+	if (!saved.ok) return {
+		ok: false,
+		error: saved.error,
+		purged: 0
+	};
+	return {
+		ok: true,
+		error: null,
+		purged
+	};
+}
+/**
 * 更新一条（状态推进；调用方给最终状态与结果文案）。
+*
+* ⚠️ **只用于"仍在办"的推进**（主要是失败重试）。**终态请用 `finalizeWake`**——
+* 否则该行会永远留下（这正是本表过去只增的根因，见 `finalizeWake` 注释）。
 * @param root CCC 根
 * @param id 条目 id
 * @param patch 要写入的字段
@@ -801,6 +903,8 @@ async function runWakeTick(ctx) {
 	}
 	clock.noteSkipReason(null);
 	for (const root of roots) {
+		const purged = purgeFinalizedWakes(root);
+		if (purged.ok && purged.purged > 0) log.push(`· ${root}: 清除 ${purged.purged} 条已结案记录（存量首清）`);
 		const { registry, error } = loadWakeRegistry(root);
 		if (error) {
 			log.push(`✗ ${root}: ${error}`);
@@ -808,11 +912,8 @@ async function runWakeTick(ctx) {
 		}
 		const { due, expired } = splitDueWakes(registry, Date.now(), WAKE_CATCH_UP_MS);
 		for (const e of expired) {
-			updateWake(root, e.id, {
-				state: "missed",
-				lastResult: `超过补跑窗口（${WAKE_CATCH_UP_MS / 36e5}h）未投递`
-			});
-			log.push(`· ${root}: ${e.id} → missed（超补跑窗口）`);
+			finalizeWake(root, e.id, "missed", `超过补跑窗口（${WAKE_CATCH_UP_MS / 36e5}h）未投递`);
+			log.push(`· ${root}: ${e.id} → missed（超补跑窗口，已清除）`);
 		}
 		for (const e of due) {
 			const res = await deliverWake(ctx, root, e);
@@ -820,13 +921,17 @@ async function runWakeTick(ctx) {
 				log.push(`· ${root}: ${e.id} → 跳过（宿主服务未就绪，下个 tick 再试；不计失败）`);
 				continue;
 			}
-			updateWake(root, e.id, {
-				state: res.ok ? "delivered" : "pending",
-				attempts: e.attempts + 1,
-				lastResult: res.detail,
-				deliveredAt: res.ok ? isoLocal() : null
-			});
-			log.push(`· ${root}: ${e.id} → ${res.ok ? "delivered" : `重试（${res.detail}）`}`);
+			if (res.ok) {
+				finalizeWake(root, e.id, "delivered", res.detail);
+				log.push(`· ${root}: ${e.id} → delivered（已清除）`);
+			} else {
+				updateWake(root, e.id, {
+					state: "pending",
+					attempts: e.attempts + 1,
+					lastResult: res.detail
+				});
+				log.push(`· ${root}: ${e.id} → 重试（${res.detail}）`);
+			}
 		}
 	}
 	return log;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.40.1",
+  "version": "1.42.0",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2。",
   "license": "MIT",
   "repository": {