@shgroup/dsh-serenity-hooks 1.58.0 → 1.58.1

package/dsh.plugin.json

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

package/lib/acp-face.d.ts

@@ -0,0 +1,149 @@
+/**
+ * acp-face.ts — **面 E：官方 ACP 面**（2026-10-16，owner 令「跑在 dsh web 进程内」）
+ *
+ * ## 它是什么
+ *
+ * 把**官方** `@deepseek-ai/dsh-acp` 挂进**本进程**（宿主 `dsh web` 那条 Cordis 树），
+ * 让标准 ACP 客户端（Agmente 等）经 **WebSocket** 登入本 CCC。
+ *
+ * ## 🔴 为什么是"自持面"而不是借宿主 `webServer`（本模块的核心设计决策）
+ *
+ * 两条路，**选乙**：
+ *   · 甲：`ctx.webServer.registerUpgrade({path})` —— 探针（P0′）走的那条；
+ *   · 乙：**本插件自己起一个 listener**（面宿主统一范式），在它上面挂 `'upgrade'` ← **本模块**
+ *
+ * 选乙的理由（按强度）：
+ *   ① 🔴 **不需要往 `HostWebServer` 本地接口补 `registerUpgrade`** —— 面宿主是**我们自己的**，
+ *      `FaceHandle.server` 就是原始 `node:http` server（`face-host.ts:81` 注释逐字指出
+ *      *"面若需挂自己的 server 级事件（gateway 的 `'upgrade'`）在此挂"*）⇒ **少动一处宿主缝**；
+ *   ② ✅ **先例在生产里跑着**：`gateway.ts:454` 的 `handle.server.on('upgrade', …)` 就是这条路；
+ *   ③ ✅ **与三个既有面同范式**（A 宿主监听／B C D 插件监听）⇒ **零新概念**；
+ *   ④ ✅ **端口独立**（不动宿主 `webServer.host/port`）—— 而 owner Q3 恰恰说
+ *      「**先 `0.0.0.0` 监听即可**」，自持面**可直接绑 `0.0.0.0`**（面自己的 `host`）⇒ 更贴那条裁决；
+ *   ⑤ ✅ **拆卸免费**（`stopAllFaces` 是"插件卸载/HMR 拆卸自起 listener 的唯一入口"）。
+ *
+ * ## 🔴 为什么不走 `AcpServer` 而直接调 `dsh-acp` 的 `apply`（P0′ 实测结论）
+ *
+ * `AcpServer` 的入参是 `{ agent: AgentConnector }`，而 **`dsh-acp` 不导出它的 connector**
+ * （它在 `apply` 内部自建）⇒ 走 `AcpServer` 就得**重写 `dsh-acp` 全部 onRequest 接线**。
+ * ⇒ 最短路 = 自己把 socket 适配成 ACP `Stream`，交给 `apply` 的 `config.stream`
+ * （其 JSDoc 逐字：*"Runtime-only transport override; production uses stdio"*）。
+ *
+ * ## ⚠️ 三个**已实测**的坑（照做，别重新发明）
+ *
+ * ① **直接调 `apply` 时，`inject` 要替 `dsh-acp` 声明它需要的全部服务** ——
+ *    实测逐字失败过：`cannot get property "sessionPersistence" without inject`
+ *    （抛自 `dsh-acp/lib/index.js:1074`）。故本模块 `inject` 含
+ *    `agents` / `llm` / `sessionPersistence` / `sessions`。
+ * ② **`dsh-acp` 的 `Config` schema 里没有 `stream` 字段** ⇒ 只能**程序化传入**，不可经 YAML。
+ * ③ **`wsToAcpStream` 的元素是"已解析的 JSON-RPC 消息"**（不是字节）——
+ *    官方 `ndJsonStream` 干的就是"字节 ↔ 消息"的分帧，我们照它的语义自己分帧（按行）。
+ *
+ * ## 🔴 安全边界（不许含混）
+ *
+ * **ACP 协议本身不做认证**（`dsh-acp` 的 `authenticate` 恒成功），而本面按 owner 裁决绑
+ * **`0.0.0.0`** ⇒ **必须有外部接入层兜底**（现为 Cloudflare Access）。
+ * ⛔ 「隧道不是 ACC 该关心的事」（Q3 裁决）**成立**，但「因此不需要认证层」**不成立** ——
+ * 故本模块的启动日志与 `status()` **都显式带这条前提**。
+ */
+import type { Context } from 'cordis';
+import { type FaceHandle } from './face-host.js';
+export declare function acpFaceActive(): boolean;
+export declare function acpFacePort(): number | null;
+/**
+ * 面是否在监听（意图读取）。
+ * ⚠️ 与 `startFace` 的关系同其余各面：**启动本身不读它**（`startFace` 是机械入口），
+ * 由装配层用它决定"起还是停"。
+ */
+export declare function acpFaceEnabled(): boolean;
+/** 面的运行统计（`dashboard` / 诊断面用；**只读快照**） */
+export interface AcpFaceStatus {
+    active: boolean;
+    port: number | null;
+    host: string;
+    enabled: boolean;
+    connections: number;
+    applied: number;
+    errors: Array<{
+        at: number;
+        applied: boolean;
+        error?: string;
+    }>;
+    /** 🔴 本面**没有内建认证** —— 这条随状态一起出，避免"看到 active 就以为它是安全的" */
+    authNote: string;
+}
+export declare function acpFaceStatus(): AcpFaceStatus;
+/**
+ * 启动面 E（幂等；重复调用只起一次）。
+ *
+ * 🔴 **失败语义**：本面**默认关**且是**可选面** ⇒ 起不来**不得**影响插件其余部分
+ * （调用方负责 catch；本函数把失败原样抛出，由装配层记日志）。
+ */
+export declare function startAcpFace(ctx: Context): Promise<FaceHandle>;
+/**
+ * 停面 E（幂等）。
+ *
+ * ⚠️ **与其余各面同款注意**：`stopFace` **不用** `closeAllConnections()`（那会掐断在飞的请求）；
+ *  WS 连接由 `wss.close()` 与 socket 自身生命周期收束。
+ */
+export declare function stopAcpFace(): boolean;
+/**
+ * 解析 ACP 会话该用的 `{provider, model}`。
+ *
+ * ## 🔴 为什么必须有这个函数（2026-10-16 容器实测抓出的**真缺陷**）
+ *
+ * 早先我们是**裸传** `provider: readAcpProvider(), model: readAcpModel()` —— 而它们读的是
+ * **环境变量**，默认**未设** ⇒ 传下去就是 `undefined`。后果**不是"用默认模型"**：
+ * 上游 `dsh-acp` 的 `agentOptions()`（`lib/index.js:1356-1361`）**只在字段非 undefined 时才带上**：
+ * ```js
+ * ...config.provider !== void 0 ? { provider: config.provider } : {},
+ * ...config.model    !== void 0 ? { model: config.model }    : {}
+ * ```
+ * ⇒ **我们传 undefined，agent 就真的没有模型** ⇒ 第一条 `session/prompt` 必失败，逐字报：
+ * `Internal error: turn failed: prompt variable "{{model}}" has no value for this assembly
+ *  (section "deployment:persona-prefix")`。
+ *
+ * ⚠️ **网页端不中招**（它经 `agent-default-model` 层拿到默认值）⇒ **只有 ACP 这条入口坏** ——
+ * 也就是说：**手机上第一条消息必然失败，而本机怎么试都正常**。
+ * 🔴 这个缺陷 **typecheck ／ 2812 条单测 ／ deploy 预检 全绿**（它是运行时合成形态，
+ * 静态面结构性地看不见）⇒ **只有"容器 ＋ 真模型"那一跑能抓到它**。
+ *
+ * ## 修法 = **读宿主自己的默认模型服务**（不另造真相源）
+ *
+ * 宿主暴露服务 `ctx.agentDefaultModel.currentSelection()`，其契约逐字写着
+ * *"Default model selection for Agents created **without an explicit model**"*
+ * （`dsh-agent-default-model/lib/types/index.d.ts`）—— 这正是"没显式指定时该用什么"的**权威出处**。
+ * ⇒ 我们只是**把它转交给 ACP**，不引入第二套缺省。
+ *
+ * 优先级（**显式 > 宿主默认**）：`SERENITY_ACP_PROVIDER/MODEL` 环境变量（调试用）＞ 宿主默认。
+ * ⚠️ **一处如实标注的弱化**：这里**不打日志**（每次连接都解析一次，打日志会刷屏）；
+ * 若宿主服务缺失，**退回"两个都 undefined"＝旧行为**（即那条已知会失败的形态）——
+ * 而不是静默编一个模型。⇒ 副作用是"没有默认模型时仍会失败"，但那**与宿主自身缺配置时的行为一致**。
+ *
+ * 🔵 **公开导出**（而非模块私有）：它是一个**纯函数 ＋ 有独立契约**的单元（本仓同类先例 =
+ * `host/access.ts` 的一组读取器），且**那个真缺陷正是在它这一层**（裸传 undefined）——
+ * 回归钉必须能**直接钉住它**，而不是隔着 WS 握手去间接观察（那样测不出"取到了什么"）。
+ */
+export declare function resolveAcpSelection(ctx: Context): {
+    provider?: string;
+    model?: string;
+};
+/**
+ * 装配（`index.ts` 的 `apply` 调用）：按**面板/部署键**启停面 E，配置变化热同步。
+ *
+ * 🔴 **W3 接线**（2026-10-16）：本轮之前 `startAcpFace` 虽已实现却**没有任何调用点**
+ * —— 即"面写好了但从不起"。本函数补上它，形式与两个兄弟面一致
+ * （`registerWeixinSendApi` ／ `registerDiagramTool`）：
+ *
+ * ① **反应式**：面板拨开关**只改配置、不重跑 `apply`**（v1.51.1 实测过的那条铁律）
+ *    ⇒ 必须监听事件才会"拨了就有反应"；
+ * ② 监听**宿主的真事件** `settings/document-updated`（按 ns 过滤），
+ *    ⛔ **不监听** `serenity/settings-changed` —— 那个事件**全仓没有任何 `emit` 点**
+ *    （＝死通道；见 `registerDiagramTool` 的注释），照它接线等于接了个永远不响的铃；
+ * ③ 再挂 `agent/created`／`session/created` 兜底（宿主事件面若换名，至少还有这条能自愈）；
+ * ④ 启动时同步一次（`apply` 时按当前配置定初始态）。
+ *
+ * ⚠️ **失败语义**：本面**默认关**且**依赖可选**（`dsh-acp` 是 peer）⇒ 起不来**只记日志**，
+ *    绝不抛出（抛出会让整个插件加载失败，而它只是一个可选面）。
+ */
+export declare function registerAcpFace(ctx: Context): void;

package/lib/index.d.ts

@@ -174,6 +174,16 @@ export interface Config {
     unattendedEnabled?: Volatile<boolean | undefined>;
     /** **diagram 工具总闸**（面板层；部署层同义键 = `diagram.enabled`；缺省关；D104） */
     diagramEnabled?: Volatile<boolean | undefined>;
+    /**
+     * 🔴 **面 E：官方 ACP 总闸**（面板层；部署层同义键 = `acpFace.enabled`；**缺省关**；2026-10-16）。
+     *
+     * ⚠️ **键名刻意不叫 `acpEnabled`** —— 那是**旧面 E（3100 自造问答面）**的键，
+     * 已随 owner「砍掉外部问答」裁决退役、现被**静默忽略**。复用同名会让"当年那份旧配置"
+     * 在新面上复活（判据：**退役的是功能，名字仍须留作"无人读"**，否则退役不彻底）。
+     */
+    acpFaceEnabled?: Volatile<boolean | undefined>;
+    /** 面 E 端口（面板层；部署层同义键 = `acpFace.port`；缺省 3200） */
+    acpFacePort?: Volatile<number | undefined>;
 }
 /** schemastery 的 schema 类型（别名只为可读；**名字取自全局命名空间**，见上方 TS2742 说明） */
 type SchemaOf<S, T = S> = Schemastery<S, T>;
@@ -230,6 +240,13 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, "plain">;
+    acpFace: z<Schemastery.ObjectS<NoInfer<{
+        enabled: z<boolean, boolean, "defined">;
+        port: z<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: z<boolean, boolean, "defined">;
+        port: z<number, number, "defined">;
+    }>>, "plain">;
     humanChannel: z<Schemastery.ObjectS<NoInfer<{
         accounts: z<HumanChannelAccountConfig[], HumanChannelAccountConfig[], "defined">;
         subscriptions: z<HumanChannelSubscriptionConfig[], HumanChannelSubscriptionConfig[], "defined">;
@@ -264,6 +281,8 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     croEnabled: z<boolean, boolean, "volatile">;
     unattendedEnabled: z<boolean, boolean, "volatile">;
     diagramEnabled: z<boolean, boolean, "volatile">;
+    acpFaceEnabled: z<boolean, boolean, "volatile">;
+    acpFacePort: z<number, number, "volatile">;
 }>>, Schemastery.ObjectT<NoInfer<{
     serenityConfigPaths: z<string[], string[], "defined">;
     tools: z<boolean, boolean, "defined">;
@@ -313,6 +332,13 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, "plain">;
+    acpFace: z<Schemastery.ObjectS<NoInfer<{
+        enabled: z<boolean, boolean, "defined">;
+        port: z<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: z<boolean, boolean, "defined">;
+        port: z<number, number, "defined">;
+    }>>, "plain">;
     humanChannel: z<Schemastery.ObjectS<NoInfer<{
         accounts: z<HumanChannelAccountConfig[], HumanChannelAccountConfig[], "defined">;
         subscriptions: z<HumanChannelSubscriptionConfig[], HumanChannelSubscriptionConfig[], "defined">;
@@ -347,6 +373,8 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     croEnabled: z<boolean, boolean, "volatile">;
     unattendedEnabled: z<boolean, boolean, "volatile">;
     diagramEnabled: z<boolean, boolean, "volatile">;
+    acpFaceEnabled: z<boolean, boolean, "volatile">;
+    acpFacePort: z<number, number, "volatile">;
 }>>, "plain">;
 export declare function apply(ctx: Context, config: Config): void;
 export {};

package/lib/index.js

@@ -3,7 +3,7 @@ import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebSe
 import { _ as resolveInside, a as findSerenityRoot$1, c as matchBlacklist, d as readCccName$1, f as readCheapWorkerConfig, h as readTrajectorySkills, i as findGitRoot, l as pathInside, m as readSafeModeHiddenTools, n as SAFE_MODE_MARKER, o as isSafeModeOn, p as readExclusiveTools, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-B0ZGL9lx.js";
 import { A as localIdStamp, C as setActiveSessionInfo, D as isoLocal, E as useSession, O as localFileStamp, S as sessionsRoot, T as summarize, _ as namingTitleFor, a as pruneMissingBindings, b as resolveSessionByTitle, c as setBindingStore, d as clearActiveSessionInfo, f as createSession, g as listSessions, h as getActiveSessionInfo, i as listBoundSessionIds, k as localHuman, l as DEFAULT_SESSION_SCOPE, m as findSession, n as PLUGIN_SOURCE, o as readLastBound, p as extractSessionMdPathFromText, r as appendBound, s as resolveSessionTrajectoryLabel, t as ACC_MESSAGE_KIND, u as TRAJECTORY_ACTIONS, v as parseSessionContextFromEvents, w as showSession, x as sessionEvents$1, y as readActiveSessionMd } from "./message-source-B4P3Uw6D.js";
 import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPES, f as checkLocalstoreGitCompliance, g as runLocalStore, h as readStore, i as matchWeixinRoute, l as weixinSessionIdFor, m as readGitTrack, n as extractWeixinText, o as readWeixinSettings, p as localstorePath, r as hasVoiceItem, s as sanitizeFileName$1, t as extractWeixinMedia } from "./weixin-route-B9gU1YXz.js";
-import { a as GATEWAY_PORT, c as SKIFF_DEBUG_PORT, d as skiffRoleFor$1, f as skiffSessionInfo$1, i as FACE_PORTS, l as WEIXIN_SEND_PORT, m as ACC_VERSION, n as readSimpleSettings, o as MAIN_WEB_PORT, p as unregisterSkiffSession$1, r as registerSettingsSection, s as MECHANISM_PORTS, u as registerSkiffSession$1 } from "./settings-section-DQIVsTqE.js";
+import { a as FACE_PORTS, c as MECHANISM_PORTS, d as registerSkiffSession$1, f as skiffRoleFor$1, h as ACC_VERSION, i as ACP_PORT, l as SKIFF_DEBUG_PORT, m as unregisterSkiffSession$1, n as readSimpleSettings, o as GATEWAY_PORT, p as skiffSessionInfo$1, r as registerSettingsSection, s as MAIN_WEB_PORT, u as WEIXIN_SEND_PORT } from "./settings-section-DGUQZo5j.js";
 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-B615L9MV.js";
 import { REGISTERED_TOOLS } from "./invariant.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-BrRcPiQs.js";
@@ -21680,6 +21680,300 @@ function registerWeixinSendApi(ctx) {
 	sync();
 }
 //#endregion
+//#region src/acp-face.ts
+/** 面名（面宿主幂等键；与 FACE_PORTS 的 id 同名，便于对账） */
+const FACE_ACP = "acp";
+/** 本面绑定的地址（取自集中端口表 —— **单一真相源**，不在本文件硬写） */
+const ACP_HOST = FACE_PORTS.acp.host ?? "127.0.0.1";
+/**
+* `dsh-acp` 需要的服务（**替它声明**，见文件头坑 ①）。
+*
+* 逐字出处 = `dsh-acp/lib/index.js` 的 `const inject = ["agents","llm","sessionPersistence","sessions"]`。
+* ⚠️ **少一个就在它内部抛错**（实测那条是 `sessionPersistence`）⇒ 这里是**照抄它的声明**，
+*    不是"我们觉得它需要什么"。⇒ 它升版改了 `inject`，这里要跟着改（列为**跨版本注意点**）。
+*/
+const ACP_REQUIRED_SERVICES = [
+	"agents",
+	"llm",
+	"sessionPersistence",
+	"sessions"
+];
+function acpFaceActive() {
+	return faceActive(FACE_ACP);
+}
+/**
+* 面是否在监听（意图读取）。
+* ⚠️ 与 `startFace` 的关系同其余各面：**启动本身不读它**（`startFace` 是机械入口），
+* 由装配层用它决定"起还是停"。
+*/
+function acpFaceEnabled() {
+	return readSimpleSettings().acpFaceEnabled;
+}
+/**
+* 把一条裸 WS socket 适配成 ACP `Stream`。
+*
+* 🔴 与官方 `ndJsonStream` **同语义**：我们自己做「消息 ↔ 文本帧」的分帧（按行）。
+*    实测注意（P0′）：`dsh-acp` 写出的每条消息**自带换行**，客户端同样 ⇒ 按行切分即正确。
+*    ⚠️ **空行要丢**；**非 JSON 帧要容忍**（桥/客户端可能插入控制帧）。
+*/
+function wsToAcpStream(ws, onWarn) {
+	return {
+		readable: new ReadableStream({ start(controller) {
+			let buf = "";
+			ws.on("message", (data) => {
+				buf += typeof data === "string" ? data : String(data);
+				let i;
+				while ((i = buf.indexOf("\n")) >= 0) {
+					const line = buf.slice(0, i);
+					buf = buf.slice(i + 1);
+					if (!line.trim()) continue;
+					try {
+						controller.enqueue(JSON.parse(line));
+					} catch {
+						onWarn(line.slice(0, 120));
+					}
+				}
+			});
+			ws.on("close", () => {
+				try {
+					controller.close();
+				} catch {}
+			});
+			ws.on("error", () => {
+				try {
+					controller.close();
+				} catch {}
+			});
+		} }),
+		writable: new WritableStream({ write(msg) {
+			ws.send(`${JSON.stringify(msg)}\n`);
+		} })
+	};
+}
+function newState() {
+	return {
+		handle: null,
+		wss: null,
+		connections: 0,
+		applied: 0,
+		lastErrors: [],
+		disposers: []
+	};
+}
+/** 当前面状态（供 `status()` / 诊断读；无监听时 `handle` 为 null） */
+let state = newState();
+/** 保留最近若干条连接错误（诊断窗口；不无限增长） */
+const MAX_ERR_KEEP = 8;
+/**
+* 启动面 E（幂等；重复调用只起一次）。
+*
+* 🔴 **失败语义**：本面**默认关**且是**可选面** ⇒ 起不来**不得**影响插件其余部分
+* （调用方负责 catch；本函数把失败原样抛出，由装配层记日志）。
+*/
+async function startAcpFace(ctx) {
+	const port = readSimpleSettings().acpFacePort;
+	let dshAcp;
+	let wsMod;
+	try {
+		dshAcp = await import("@deepseek-ai/dsh-acp");
+		wsMod = await import("ws");
+	} catch (err) {
+		const msg = String(err?.message ?? err);
+		throw new Error(`面 E 依赖不可用（${msg}）—— 需要宿主提供 @deepseek-ai/dsh-acp，且本插件能 resolve 到 ws`);
+	}
+	if (typeof dshAcp.apply !== "function") throw new Error("面 E：@deepseek-ai/dsh-acp 未导出 apply（版本不匹配？）");
+	const wss = new wsMod.WebSocketServer({ noServer: true });
+	const local = newState();
+	local.wss = wss;
+	const handle = await startFace({
+		name: FACE_ACP,
+		port,
+		host: ACP_HOST,
+		enabled: () => readSimpleSettings().acpFaceEnabled,
+		handler: (_req, res) => {
+			res.writeHead(426, {
+				"content-type": "text/plain; charset=utf-8",
+				"upgrade": "websocket",
+				"cache-control": "no-store"
+			});
+			res.end("This is an ACP (Agent Client Protocol) endpoint over WebSocket. Use an ACP client.\n");
+		}
+	});
+	local.handle = handle;
+	handle.server.on("upgrade", (req, socket, head) => {
+		local.connections += 1;
+		try {
+			wss.handleUpgrade(req, socket, head, (ws) => {
+				try {
+					const stream = wsToAcpStream(ws, (line) => {
+						console.log(`[serenity-hooks] 面 E：丢弃一条非 JSON 帧（前 120 字）: ${line}`);
+					});
+					const fiber = ctx.plugin({
+						inject: ACP_REQUIRED_SERVICES,
+						apply: (scoped) => {
+							const sel = resolveAcpSelection(scoped);
+							dshAcp.apply(scoped, {
+								stream,
+								provider: sel.provider,
+								model: sel.model
+							});
+						}
+					});
+					local.disposers.push(() => {
+						try {
+							fiber?.dispose?.();
+						} catch {}
+					});
+					local.applied += 1;
+				} catch (err) {
+					const msg = String(err?.message ?? err).slice(0, 200);
+					local.lastErrors.push({
+						at: Date.now(),
+						applied: false,
+						error: msg
+					});
+					if (local.lastErrors.length > MAX_ERR_KEEP) local.lastErrors.shift();
+					console.warn(`[serenity-hooks] ✗ 面 E：dsh-acp 接线失败: ${msg}`);
+					try {
+						ws.close(1011, "acp bridge failed");
+					} catch {}
+				}
+			});
+		} catch (err) {
+			console.warn(`[serenity-hooks] ✗ 面 E：WebSocket 握手失败: ${String(err?.message ?? err)}`);
+			try {
+				socket.destroy();
+			} catch {}
+		}
+	});
+	state = local;
+	console.log(`[serenity-hooks] ✓ 面 E（官方 ACP）：ws://${ACP_HOST}:${port}  ⚠️ 协议无认证，靠外部 Access 兜底`);
+	return handle;
+}
+/**
+* 停面 E（幂等）。
+*
+* ⚠️ **与其余各面同款注意**：`stopFace` **不用** `closeAllConnections()`（那会掐断在飞的请求）；
+*  WS 连接由 `wss.close()` 与 socket 自身生命周期收束。
+*/
+function stopAcpFace() {
+	const wss = state.wss;
+	if (wss) try {
+		wss.close();
+	} catch {}
+	state.disposers = [];
+	state.wss = null;
+	state.handle = null;
+	const stopped = stopFace(FACE_ACP);
+	if (stopped) console.log("[serenity-hooks] face acp: 已停止");
+	return stopped;
+}
+/** ACP 会话用的 provider（取 CCC 现有路由；留空 = 由宿主/请求监听器决定） */
+function readAcpProvider() {
+	return process.env.SERENITY_ACP_PROVIDER || void 0;
+}
+/** ACP 会话用的 model（同上） */
+function readAcpModel() {
+	return process.env.SERENITY_ACP_MODEL || void 0;
+}
+/**
+* 解析 ACP 会话该用的 `{provider, model}`。
+*
+* ## 🔴 为什么必须有这个函数（2026-10-16 容器实测抓出的**真缺陷**）
+*
+* 早先我们是**裸传** `provider: readAcpProvider(), model: readAcpModel()` —— 而它们读的是
+* **环境变量**，默认**未设** ⇒ 传下去就是 `undefined`。后果**不是"用默认模型"**：
+* 上游 `dsh-acp` 的 `agentOptions()`（`lib/index.js:1356-1361`）**只在字段非 undefined 时才带上**：
+* ```js
+* ...config.provider !== void 0 ? { provider: config.provider } : {},
+* ...config.model    !== void 0 ? { model: config.model }    : {}
+* ```
+* ⇒ **我们传 undefined，agent 就真的没有模型** ⇒ 第一条 `session/prompt` 必失败，逐字报：
+* `Internal error: turn failed: prompt variable "{{model}}" has no value for this assembly
+*  (section "deployment:persona-prefix")`。
+*
+* ⚠️ **网页端不中招**（它经 `agent-default-model` 层拿到默认值）⇒ **只有 ACP 这条入口坏** ——
+* 也就是说：**手机上第一条消息必然失败，而本机怎么试都正常**。
+* 🔴 这个缺陷 **typecheck ／ 2812 条单测 ／ deploy 预检 全绿**（它是运行时合成形态，
+* 静态面结构性地看不见）⇒ **只有"容器 ＋ 真模型"那一跑能抓到它**。
+*
+* ## 修法 = **读宿主自己的默认模型服务**（不另造真相源）
+*
+* 宿主暴露服务 `ctx.agentDefaultModel.currentSelection()`，其契约逐字写着
+* *"Default model selection for Agents created **without an explicit model**"*
+* （`dsh-agent-default-model/lib/types/index.d.ts`）—— 这正是"没显式指定时该用什么"的**权威出处**。
+* ⇒ 我们只是**把它转交给 ACP**，不引入第二套缺省。
+*
+* 优先级（**显式 > 宿主默认**）：`SERENITY_ACP_PROVIDER/MODEL` 环境变量（调试用）＞ 宿主默认。
+* ⚠️ **一处如实标注的弱化**：这里**不打日志**（每次连接都解析一次，打日志会刷屏）；
+* 若宿主服务缺失，**退回"两个都 undefined"＝旧行为**（即那条已知会失败的形态）——
+* 而不是静默编一个模型。⇒ 副作用是"没有默认模型时仍会失败"，但那**与宿主自身缺配置时的行为一致**。
+*
+* 🔵 **公开导出**（而非模块私有）：它是一个**纯函数 ＋ 有独立契约**的单元（本仓同类先例 =
+* `host/access.ts` 的一组读取器），且**那个真缺陷正是在它这一层**（裸传 undefined）——
+* 回归钉必须能**直接钉住它**，而不是隔着 WS 握手去间接观察（那样测不出"取到了什么"）。
+*/
+function resolveAcpSelection(ctx) {
+	const envProvider = readAcpProvider();
+	const envModel = readAcpModel();
+	if (envProvider && envModel) return {
+		provider: envProvider,
+		model: envModel
+	};
+	try {
+		const sel = hostInjected(ctx, "agentDefaultModel")?.currentSelection?.();
+		if (sel?.provider && sel?.model) return {
+			provider: sel.provider,
+			model: sel.model
+		};
+	} catch {}
+	return {
+		provider: envProvider,
+		model: envModel
+	};
+}
+/**
+* 装配（`index.ts` 的 `apply` 调用）：按**面板/部署键**启停面 E，配置变化热同步。
+*
+* 🔴 **W3 接线**（2026-10-16）：本轮之前 `startAcpFace` 虽已实现却**没有任何调用点**
+* —— 即"面写好了但从不起"。本函数补上它，形式与两个兄弟面一致
+* （`registerWeixinSendApi` ／ `registerDiagramTool`）：
+*
+* ① **反应式**：面板拨开关**只改配置、不重跑 `apply`**（v1.51.1 实测过的那条铁律）
+*    ⇒ 必须监听事件才会"拨了就有反应"；
+* ② 监听**宿主的真事件** `settings/document-updated`（按 ns 过滤），
+*    ⛔ **不监听** `serenity/settings-changed` —— 那个事件**全仓没有任何 `emit` 点**
+*    （＝死通道；见 `registerDiagramTool` 的注释），照它接线等于接了个永远不响的铃；
+* ③ 再挂 `agent/created`／`session/created` 兜底（宿主事件面若换名，至少还有这条能自愈）；
+* ④ 启动时同步一次（`apply` 时按当前配置定初始态）。
+*
+* ⚠️ **失败语义**：本面**默认关**且**依赖可选**（`dsh-acp` 是 peer）⇒ 起不来**只记日志**，
+*    绝不抛出（抛出会让整个插件加载失败，而它只是一个可选面）。
+*/
+function registerAcpFace(ctx) {
+	const sync = () => {
+		if (!acpFaceEnabled()) {
+			if (acpFaceActive()) stopAcpFace();
+			return;
+		}
+		if (acpFaceActive()) return;
+		startAcpFace(ctx).catch((err) => {
+			console.error(`[serenity-hooks] ✗ 面 E（官方 ACP）启动失败: ${String(err?.message ?? err)}`);
+		});
+	};
+	try {
+		ctx.on("settings/document-updated", (ns) => {
+			if (String(ns) === "serenity-hooks") sync();
+		});
+	} catch {}
+	for (const eventName of ["agent/created", "session/created"]) try {
+		ctx.on(eventName, () => {
+			sync();
+		});
+	} catch {}
+	sync();
+}
+//#endregion
 //#region src/seams/lifecycle.ts
 /** 从 Agent / Session / 事件负载中取会话 id（形状宽容：未知结构返回 null） */
 function sessionIdOf(value) {
@@ -24316,6 +24610,10 @@ const Config = z.object({
 	opencodeProvider: z.object({ autoConfigure: z.boolean().default(true) }),
 	visionPatch: z.object({ enabled: z.boolean().default(true) }),
 	diagram: z.object({ enabled: z.boolean().default(false) }),
+	acpFace: z.object({
+		enabled: z.boolean().default(false),
+		port: z.number().min(1024).max(65535).default(ACP_PORT)
+	}),
 	humanChannel: z.object({
 		accounts: z.array(humanChannelAccountSchema).default([]),
 		subscriptions: z.array(humanChannelSubscriptionSchema).default([]),
@@ -24328,7 +24626,9 @@ const Config = z.object({
 	skiffDebugPort: z.number().min(1024).max(65535).volatile(),
 	croEnabled: z.boolean().volatile(),
 	unattendedEnabled: z.boolean().volatile(),
-	diagramEnabled: z.boolean().volatile()
+	diagramEnabled: z.boolean().volatile(),
+	acpFaceEnabled: z.boolean().volatile(),
+	acpFacePort: z.number().min(1024).max(65535).volatile()
 });
 function apply(ctx, config) {
 	try {
@@ -24392,6 +24692,7 @@ function apply(ctx, config) {
 	registerWakeScheduler(ctx);
 	registerWeixinBridge(ctx);
 	registerWeixinSendApi(ctx);
+	registerAcpFace(ctx);
 	registerWeixinOutputGuard(ctx);
 	registerLifecycle(ctx);
 	if (config.webFetch?.enabled !== false) registerWebFetchProvider(ctx);

package/lib/ports.d.ts

@@ -20,8 +20,8 @@
  * 本模块是**零依赖叶模块**（纯常量，无 import）——output-guard（守卫词表）、config-ops
  * （默认值）、settings-section（面板默认）、index（Config 默认）都可安全引用而不引入依赖环。
  */
-/** 面标识（四个对外面；A 由宿主监听，B/C/D 由本插件监听） */
-export type FaceId = 'main' | 'gateway' | 'weixinSend' | 'skiffDebug';
+/** 面标识（五个对外面；A 由宿主监听，B/C/D/E 由本插件监听） */
+export type FaceId = 'main' | 'gateway' | 'weixinSend' | 'skiffDebug' | 'acp';
 /** 一个面的端口语义 */
 export interface PortSpec {
     /** 端口号 */
@@ -36,7 +36,7 @@ export interface PortSpec {
 /**
  * 集中端口表。
  * A=宿主主面（插件不监听）/ B=网关（可配，默认关）/ C=微信发送（默认开，仅 loopback）
- * / D=Skiff 调试（默认关）。
+ * / D=Skiff 调试（默认关）/ E=ACP（默认关，`0.0.0.0`）。
  */
 export declare const FACE_PORTS: Readonly<Record<FaceId, PortSpec>>;
 /** 宿主主 WebUI 端口（面 A：插件**不监听**，只读取；`readWebPort` 的回退值） */
@@ -47,6 +47,8 @@ export declare const GATEWAY_PORT: number;
 export declare const WEIXIN_SEND_PORT: number;
 /** Skiff 调试页端口默认值（面 D） */
 export declare const SKIFF_DEBUG_PORT: number;
+/** 官方 ACP 面端口默认值（面 E，2026-10-16） */
+export declare const ACP_PORT: number;
 /**
  * **机制端口**词表（output-guard 用：agent 在**用户可见输出**里提及内部端口即打回）。
  *

package/lib/{settings-section-DQIVsTqE.js → settings-section-DGUQZo5j.js}

@@ -41,7 +41,7 @@ function unregisterSkiffSession(sessionId) {
 /**
 * 集中端口表。
 * A=宿主主面（插件不监听）/ B=网关（可配，默认关）/ C=微信发送（默认开，仅 loopback）
-* / D=Skiff 调试（默认关）。
+* / D=Skiff 调试（默认关）/ E=ACP（默认关，`0.0.0.0`）。
 */
 const FACE_PORTS = {
 	main: {
@@ -67,6 +67,26 @@ const FACE_PORTS = {
 		host: "127.0.0.1",
 		defaultEnabled: false,
 		meaning: "Skiff 调试问答面（人工调试子角色；无认证，仅靠 loopback）"
+	},
+	/**
+	* 🔴 面 E：**官方 ACP 面**（2026-10-16，owner 令「跑在 dsh web 进程内」→ 已实测跑通）。
+	*
+	* 与已退役的**旧面 E（3100）不是一回事**，别混淆：
+	*  · 旧面 E = 当年**自造**的 HTTP＋HTML 问答面，2026-10-15 owner 裁「砍掉外部问答」时**整组退役**；
+	*  · 本面 = **官方 `@deepseek-ai/dsh-acp`**（官方 SDK ＋ 现成客户端 Agmente），
+	*    且**跑在宿主 web 进程内**（不另起进程、不需要 stdio 桥）。
+	*  ⇒ 端口**另选 3200**：既避开 3080/3081/3082/3099，也让"新旧一眼可分"。
+	*
+	* ⚠️ **安全边界（不许含混）**：**ACP 协议本身不做认证**（`dsh-acp` 的 `authenticate` 恒成功），
+	* 而本面按 owner 裁决绑 **`0.0.0.0`**（局域网内任何设备可连）⇒ **必须靠外部接入层兜底**
+	* （现为 Cloudflare Access）。⛔ **"隧道不是 ACC 该关心的事"（Q3 裁决）成立，但
+	* "所以不需要认证层"不成立** —— 交付文档与诊断输出里都要显式带这个前提。
+	*/
+	acp: {
+		port: 3200,
+		host: "0.0.0.0",
+		defaultEnabled: false,
+		meaning: "官方 ACP 面（Agmente 等标准客户端登入本 CCC；**协议无认证**，靠外部 Access 兜底）"
 	}
 };
 /** 宿主主 WebUI 端口（面 A：插件**不监听**，只读取；`readWebPort` 的回退值） */
@@ -77,6 +97,8 @@ const GATEWAY_PORT = FACE_PORTS.gateway.port;
 const WEIXIN_SEND_PORT = FACE_PORTS.weixinSend.port;
 /** Skiff 调试页端口默认值（面 D） */
 const SKIFF_DEBUG_PORT = FACE_PORTS.skiffDebug.port;
+/** 官方 ACP 面端口默认值（面 E，2026-10-16） */
+const ACP_PORT = FACE_PORTS.acp.port;
 /**
 * **机制端口**词表（output-guard 用：agent 在**用户可见输出**里提及内部端口即打回）。
 *
@@ -103,6 +125,8 @@ function defaultSimpleSettings() {
 		croEnabled: true,
 		unattendedEnabled: false,
 		diagramEnabled: false,
+		acpFaceEnabled: false,
+		acpFacePort: ACP_PORT,
 		humanChannel: defaultHumanChannelSettings()
 	};
 }
@@ -199,6 +223,8 @@ function simpleSettingsFromConfig(config) {
 		croEnabled: unwrapVolatile(config.croEnabled) ?? d.croEnabled,
 		unattendedEnabled: unwrapVolatile(config.unattendedEnabled) ?? d.unattendedEnabled,
 		diagramEnabled: unwrapVolatile(config.diagramEnabled) ?? config.diagram?.enabled ?? d.diagramEnabled,
+		acpFaceEnabled: unwrapVolatile(config.acpFaceEnabled) ?? config.acpFace?.enabled ?? d.acpFaceEnabled,
+		acpFacePort: unwrapVolatile(config.acpFacePort) ?? config.acpFace?.port ?? d.acpFacePort,
 		humanChannel: humanChannelSettingsFromConfig(config.humanChannel)
 	};
 }
@@ -237,4 +263,4 @@ function registerSettingsSection(ctx, config) {
 	} catch {}
 }
 //#endregion
-export { GATEWAY_PORT as a, SKIFF_DEBUG_PORT as c, skiffRoleFor as d, skiffSessionInfo as f, FACE_PORTS as i, WEIXIN_SEND_PORT as l, ACC_VERSION as m, readSimpleSettings as n, MAIN_WEB_PORT as o, unregisterSkiffSession as p, registerSettingsSection as r, MECHANISM_PORTS as s, SERENITY_SETTINGS_NS as t, registerSkiffSession as u };
+export { FACE_PORTS as a, MECHANISM_PORTS as c, registerSkiffSession as d, skiffRoleFor as f, ACC_VERSION as h, ACP_PORT as i, SKIFF_DEBUG_PORT as l, unregisterSkiffSession as m, readSimpleSettings as n, GATEWAY_PORT as o, skiffSessionInfo as p, registerSettingsSection as r, MAIN_WEB_PORT as s, SERENITY_SETTINGS_NS as t, WEIXIN_SEND_PORT as u };

package/lib/settings-section.d.ts

@@ -69,6 +69,13 @@ interface SimpleConfigFragment {
     diagram?: {
         enabled?: boolean;
     };
+    /** 🔴 面 E（官方 ACP，2026-10-16 owner 令「跑在 dsh web 进程内」）：部署层嵌套段。
+     *  ⚠️ **键名刻意不用 `acp.*`** —— 旧面 E 退役时 `acp.*` 是**被静默忽略**的遗留名，
+     *  复用会让"当年那份旧配置"在新面上复活（判据：退役 ≠ 删名，名字仍需保留为"无人读"）。 */
+    acpFace?: {
+        enabled?: boolean;
+        port?: number;
+    };
     /** human-channel（人机信道；**机器级**；2026-09-26 owner 定案）：账号 ／ 订阅表 ／ 主控 ／ 出站白名单 */
     humanChannel?: HumanChannelConfigFragment;
     gatewayEnabled?: PanelBoolean;
@@ -78,6 +85,9 @@ interface SimpleConfigFragment {
     croEnabled?: PanelBoolean;
     unattendedEnabled?: PanelBoolean;
     diagramEnabled?: PanelBoolean;
+    /** 🔴 面 E（官方 ACP，2026-10-16）：开关 ＋ 端口（面板层扁平键） */
+    acpFaceEnabled?: PanelBoolean;
+    acpFacePort?: PanelNumber;
 }
 /**
  * 设置面板命名空间 = **profile 条目 id**（v0.1.7 起；与旧 `settings.yaml` 段名逐字相同）。
@@ -122,6 +132,18 @@ interface SerenitySimpleSettings {
      *  零 token、不会被误调），同 `skiff` 的"未开启零资源占用"口径。
      *  依赖面：随包分发 3.8 MB 内置字体（`assets/diagram/`，wasm 对系统字体不可见）。 */
     diagramEnabled: boolean;
+    /** 🔴 **面 E：官方 ACP 总开关**（2026-10-16 owner 令「跑在 dsh web 进程内」；**缺省关**）。
+     *
+     *  开启后：ACC 在自己进程里起一个 **ACP 服务面**（面宿主统一建 listener），
+     *  标准 ACP 客户端（Agmente 等）经 WebSocket 登入本 CCC —— **不另起进程、不需 stdio 桥**。
+     *  **缺省关**：① 它把本 CCC 开给外部客户端；② ⚠️ **ACP 协议本身无认证**（`dsh-acp` 的
+     *  `authenticate` 恒成功），而本面按 owner 裁决绑 **`0.0.0.0`** ⇒ **开之前必须有外部接入层
+     *  兜底**（现为 Cloudflare Access）。缺省关 = "不配就没有暴露面"。
+     *  ⚠️ **与已退役的旧面 E（3100 自造问答面）无关**：本面是**官方** `@deepseek-ai/dsh-acp`。
+     *  实测（P0′，8/8）见 S142 `2026-10-16T0745-…-p0prime-inproc-findings.md`。 */
+    acpFaceEnabled: boolean;
+    /** 面 E 端口（默认 3200；避开 3080/3081/3082/3099 与已退役的 3100） */
+    acpFacePort: number;
     /** **human-channel（人机信道）机器级配置**（2026-09-26 owner 定案；P0-1 立 schema ＋ 投影）。
      *  三张表（账号 ／ 订阅 ／ 主控）＋ 出站白名单；**跨 CCC** ⇒ 归机器级，CCC 侧 `weixin.*` 随之退役
      *  （退役动作在 P0-2~P0-4；本版**只立机器级面**，旧面照旧）。缺省与归一规则见

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.58.0",
+  "version": "1.58.1",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.7-rc.1 与 0.2.0-rc.1（双档）。",
   "license": "MIT",
   "repository": {
@@ -45,7 +45,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@resvg/resvg-wasm": "2.6.2"
+    "@resvg/resvg-wasm": "2.6.2",
+    "ws": "^8.22.0"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -66,6 +67,7 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-acp": "^0.1.7-rc.1 || ^0.2.0-rc.1",
     "@deepseek-ai/dsh-agent": "^0.1.7-rc.1 || ^0.2.0-rc.1",
     "@deepseek-ai/dsh-agent-loop": "^0.1.7-rc.1 || ^0.2.0-rc.1",
     "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-rc.1 || ^0.2.0-rc.1",
@@ -85,6 +87,9 @@
     "cordis": "^4.0.0-rc.7"
   },
   "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-acp": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-host-webserver": {
       "optional": true
     },
@@ -109,6 +114,7 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-acp": "0.1.7-rc.1",
     "@deepseek-ai/dsh-agent": "0.1.7-rc.1",
     "@deepseek-ai/dsh-agent-loop": "0.1.7-rc.1",
     "@deepseek-ai/dsh-agent-preset-registry": "0.1.7-rc.1",
@@ -147,6 +153,7 @@
     "@types/node": "^20.0.0",
     "@types/qrcode-generator": "^1.0.6",
     "@types/react": "^18.2.0",
+    "@types/ws": "^8.18.2",
     "@vitest/coverage-v8": "^1.6.1",
     "marked": "^18.0.11",
     "qrcode-generator": "^2.0.4",
@@ -154,7 +161,8 @@
     "tsdown": "^0.22.14",
     "typescript": "^5.4.0",
     "unrun": "^0.3.1",
-    "vitest": "^1.6.0"
+    "vitest": "^1.6.0",
+    "ws": "8.22.0"
   },
   "pnpm": {
     "onlyBuiltDependencies": [