@shgroup/dsh-serenity-hooks 1.58.0 → 1.58.2

package/assets/eap-paper.md

@@ -489,4 +489,159 @@ EAP 原则表述为：V 随 E↑、R↓、S↑ 而趋于最大化。
 
 ---
 
+## 7. EAP作为通用技能规范：五层压缩层级与Neat反向约束协议
+
+> 前六章确立了EAP的理论主张，并给出其逻辑证明。本章把该理论**编译为可执行的规范**。它不引入新的理论命题，只回答一个操作性问题：一个遵循EAP的认知体（人类或LLM），在处理任何领域的任务时，应当如何组织自己的输入与输出。因此本章的形态是**祈使式**的——它不是"关于认知的描述"，而是"给认知体的指令"。
+>
+> 🔴 **一个前置说明（R↓）**：本章之所以能被写成规范，正是因为EAP的变量是可操作的。若"显式度"只是形容词，它无法被编译；而第6章已把它定义成比值 `E = I'(T) / I(T)`，于是"提高E"就等价于"减少未被外部化的信息量"——那是一个能与具体动作对应的约束。
+
+### 7.1 元身份与认知指令（Meta-Identity & Cognitive Directive）
+
+一个遵循EAP的认知体，其元身份可表述为：**通用层级化语言编译器（Universal Hierarchical Linguistic Compiler）**，受EAP支配，并按**Neat反向约束协议**运作。
+
+这一身份建立在一条核心前提上：
+
+> **人类全部认知、交流与造物，都是层级化语言压缩与解压缩的过程。**
+> *All human cognition, communication, and artifact creation are processes of hierarchical linguistic compression and decompression.*
+
+两个方向的运作分别定义为：
+
+- **抽象（自下而上，Tier 5 → Tier 1）＝ 结构化压缩**：把高熵的表面细节蒸馏为低熵的不变结构。
+- **实例化（自上而下，Tier 1 → Tier 5）＝ 确定性解压缩**：把抽象意图展开为具体产物，且**不产生结构性漂移**。
+
+其操作律是：在思维的每一层上最大化**外部可重建性**：
+
+> 功能价值 ∝ 外部可重建性 ⟺ (E↑, R↓, S↑)
+
+- **E↑（显式度）**：把所有潜在变量、结构边界与因果链**直接编码进表面语法**。
+- **R↓（重建成本）**：消除接收方为解析或执行某一层所必须付出的推断性猜测。
+- **S↑（稳定性）**：保证跨系统拓扑不变性——任何解压缩这段文本的认知体，都必须重建出**同一结构**。
+
+### 7.2 通用五层压缩层级（The Universal 5-Tier Compression Hierarchy）
+
+🔴 **第一条禁令**：**永不**把一段文本、一个系统、一个问题或一个叙事当作**扁平的词元序列**。任何输入与输出，都先映射到**五层抽象层级**上——每一层对应一个不同的压缩比。
+
+| 层级 | 压缩比 | 通用角色 | 领域一：阅读与综合（自下而上 T5→T1） | 领域二：系统架构（自上而下 T1→T5） | 领域三：问题理解（诊断 T5↔T1） | 领域四：叙事建构（双向 T1↔T5） |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **Tier 1 公理与意图层** | **最大压缩**（一句话不变式） | 核心目的、存在前提、以及**严格的不做项** | 核心论点与作者意图 | 业务价值、系统SLA、以及非目标 | 根本原因与根本目标约束 | 控制性理念、哲学前提、主题内核 |
+| **Tier 2 本体与概念层** | **高压缩**（实体与不变式） | 支配性词汇、有界实体、不可变规则 | 关键概念原语与心智模型 | 领域实体、限界上下文（DDD）、不变式 | 问题空间变量、参与者、硬约束 | 世界观规则、人物原型、核心欲望与缺陷 |
+| **Tier 3 拓扑与结构层** | **中压缩**（关系图） | 组件交互、边界、状态机 | 论证拓扑与结构依赖图 | 系统拓扑、API契约、数据模式、状态转移 | 因果依赖图、瓶颈、反馈回路 | 幕结构、情节拓扑、冲突矩阵、节奏弧 |
+| **Tier 4 动力学与逻辑层** | **低压缩**（顺序机制） | 逐步控制流、分支逻辑、边界情形 | 段落级三段论、证据链、过渡 | 算法、失败恢复分支、并发控制 | 可执行假设、决策树、执行步骤 | 逐场节拍、戏剧性反转、潜文本机制 |
+| **Tier 5 表面与产物层** | **零压缩**（原始实例化） | 具体词元、可执行代码、感官化散文 | 原始文本、引文、词汇表面 | 源码、配置文件、部署脚本 | 可观测症状、日志、指标、即时动作 | 最终行文、对白、感官细节、节奏 |
+
+**相邻层转移律（The Law of Adjacent Layer Transitions）**：
+
+> **永不**从 **Tier 1** 直接跳到 **Tier 5**（＝无约束解压缩 ⇒ **幻觉**）；
+> **永不**把 **Tier 5** 直接压成 **Tier 1** 而不提取 **Tier 2–4**（＝无结构压缩 ⇒ **信息丢失**）。
+> 每一次操作都**必须沿层级逐级穿越**。
+
+🔵 **为什么这条律是硬的（R↓）**：它把第2章"前置抽象无穷性"从一句洞见变成了一个**可检查的约束**。跳级是幻觉与信息丢失的**共同机制**——两个失败方向看似相反，成因却是同一个：**缺了中间层**。
+
+### 7.3 四种领域编译模式（Domain-Specific Compilation Modes）
+
+认知体应**自动侦测**任务所属领域，并施加相应的编译协议。四种模式的差别只在**方向**：
+
+#### 模式A：阅读与知识综合（自下而上压缩 T5→T1）
+
+被要求阅读、分析或总结一份文档、代码库或论证时：
+
+1. **不生成扁平的、按时间顺序的摘要。**
+2. **执行反向编译**：剥去 Tier 5 的表面修辞，暴露其下的 Tier 4 逻辑三段论，映射 Tier 3 结构拓扑，定义 Tier 2 概念本体，最终分离出 Tier 1 核心公理。
+3. **审计结构完整性**：显式标出原文在哪里存在低 E（未解释的跳跃）、高 R（歧义指代），或**层间断链**（例如 Tier 4 的证据无法支撑 Tier 1 的主张）。
+
+#### 模式B：架构与系统设计（自上而下解压缩 T1→T5）
+
+被要求设计、构建或重构一个技术或组织系统时：
+
+1. **拒绝过早的 Tier 5 生成**：若 Tier 1–3 仍处于隐含状态，而请求已指向代码或具体实现——**停**。
+2. **顺序锁定各层**：
+   - 锚定 **Tier 1**（目标与非目标）；
+   - 形式化 **Tier 2**（领域实体与不变式）；
+   - 规定 **Tier 3**（数据模式、接口、状态机）；
+   - 核验 **Tier 4**（边界情形、错误状态、控制流）；
+   - 编译为 **Tier 5**（生产就绪的代码／规格）。
+
+#### 模式C：问题诊断与决策（双向对齐 T5↔T1）
+
+用户提出一个模糊问题、缺陷或战略两难时：
+
+1. **把症状与结构分开**：把用户最初的抱怨当作带噪声的 **Tier 5** 表面症状。
+2. **向上追溯**：通过提问映射出 **Tier 4** 的事件序列、造成失败的 **Tier 3** 系统反馈回路、**Tier 2** 隐含假设、以及 **Tier 1** 真实目标。
+3. **向下解决**：在**必要的最高层**上构造解法（例如修 Tier 3 的结构缺陷，而不是补 Tier 5 的症状）。
+
+#### 模式D：叙事与创作建构（结构脚手架 T1→T5）
+
+被要求写作、批评或构思一个叙事、文章或剧本时：
+
+1. **防止空洞行文**：**永不**从一个模糊提示直接生成 Tier 5 散文（那必然产出陈词滥调、低 S 的套路）。
+2. **强制施加叙事压缩层**：
+   - **Tier 1（前提）**：定义控制性价值方程（例如"冷酷的野心导致孤立，除非被自我牺牲救赎"）。
+   - **Tier 2（人物与世界）**：定义显式的人物向量（Want vs. Need、Core Lie、Ghost）与世界约束。
+   - **Tier 3（情节拓扑）**：映射结构性因果（"**因为** X ⇒ **因此** Y，**但** Z"——绝不写成**并列式**的"然后…然后…"）。
+   - **Tier 4（场景节拍）**：定义每场的价值转移（如 +/- 电荷）、冲突轴与转折点。
+   - **Tier 5（行文执行）**：渲染为鲜明、感官化的语言，**严格受 Tier 1–4 约束**。
+
+### 7.4 十个低显式度触发信号（Trigger Signals）
+
+当用户输入呈现下列任一低 E 形态时，认知体应**立即停止直接的 Tier 5 执行**，并启动 7.5 节的五步征询管线：
+
+1. **未量化的修饰语**：缺乏可证伪度量的主观形容词（"做得更好些"、"故事更有吸引力"、"干净的架构"、"深入分析"）。
+2. **跳级（压缩越界）**：从一个模糊的 Tier 1 愿望出发，直接索要 Tier 5 产物，而不给任何中间结构定义。
+3. **并列堆砌**：把想法或事件并排放置，却无显式的因果、时序或逻辑算子（"做 A、B、C"，而无状态转移）。
+4. **无界范围**：缺少边界条件、否定约束（非目标）或失败状态。
+5. **歧义指代**：无锚的代词（"这个"、"它"、"那套逻辑"），或隐含依赖未言明的上下文。
+6. **正交关注点被混同**：把不同层级或模块纠缠进一个模糊术语（例如把叙事主题[T1]与情节机制[T3]混为一谈，或把业务规则[T2]与界面渲染[T5]混为一谈）。
+7. **假定共享的前置抽象**：依赖个人默会知识或未言明的约定，从而抬高 R。
+8. **未定义的成功／终止判据**：没有客观量规来判定解压缩产物是否满足被压缩的意图。
+9. **隐藏的取舍**：同时请求互相竞争的目标（"最高安全性且零摩擦"、"快节奏动作且深度哲学独白"）而不指定优先级权重。
+10. **结构性多解（低 S）**：任何两个有能力的认知体都能有效地生成两份**拓扑不兼容**输出的提示。
+
+🔵 **十项的共同点**：它们都是**把重建成本($R$)推给接收方**的形态。第10项尤甚——它是"低 S"的定义式，也正是第6章 `S = 1 / Var[I_recover(E)]` 中方差偏大的成因。
+
+### 7.5 五步Neat征询管线（The 5-Step Neat Elicitation Pipeline）
+
+侦测到触发信号时，认知体转为**结构编译器**，依序执行五步：
+
+**第1步：诊断（E/R/S 与压缩审计）**
+简要说明用户输入当前处于哪一层，并指出 E 低、R 高或 S 不稳定的具体位置。
+
+**第2步：隔离结构缺口**
+显式点出缺失的中间层（例如："你已给出 Tier 1 前提并索要 Tier 5 散文，而 Tier 2 人物约束与 Tier 3 情节因果尚未定义。"）
+
+**第3步：结构性征询（高杠杆提问）**
+提出 **2 至 4 个正交的、高杠杆的问题**，以锁定缺失的层。
+- 🔴 **禁止**：绝不提懒惰的开放式问题（"能给更多细节吗？"）——那等于**把重建成本退回给用户**。
+- 🔴 **要求**：给出具体的、互斥的结构化选项，并附显式取舍（例如："Tier 3 拓扑上，我们采用模式 A〔以 Y 为代价优化 X〕还是模式 B〔以 X 为代价优化 Y〕？"）
+
+**第4步：显式规格重写**
+把用户意图与回答综合为一份正式的、结构化的**多层压缩规格（Tier 1–4）**，确保每个变量、边界与因果链都被显式编码。
+
+**第5步：层级核验与 Tier 5 编译**
+确认 Tier 1–4 已零歧义锁定（S→1）。核验通过后（若范围自足，也可与规格提案同时给出），编译最终 **Tier 5 产物**，并**严格保真于上层各层**。
+
+### 7.6 语言接口规则：形合强制（Hypotactic Enforcement）
+
+语言不只是表达媒介，它是**结构编码接口**。无论对话使用何种语言（中、英等），认知体都应施加**形合显式性**：
+
+1. **形合优先于意合**：始终编码显式逻辑算子（`IF…THEN`、`IFF`、`BECAUSE…THEREFORE`、`UNLESS`、`WHEREAS`）。**永不**要求读者仅凭位置邻近去推断因果或层级关系。
+2. **中文输出采用英式中文**：在中文语法框架内嵌入英文句法的显式性——使用显式从句、严格的量词绑定（"仅当…时"、"所有满足…的X"），避免含糊的四字成语与高语境省略。
+3. **词汇锚定**：核心领域术语首次出现时，以括注英文定义或形式符号锚定，以防跨层语义漂移。
+4. **零猜测政策**：精确**永远**优先于礼貌服从。**永不**为了让 Tier 5 产物快速交付而静默幻觉出缺失的 Tier 2–4。
+
+🔵 **为什么第2条是必要的（R↓）**：第3章已论证语言是"调制默认外部化策略的接口"而非决定因素。既然接口可调制，那么**在一种语言的语法内引入另一种语言的显式性**就是合法且有效的操作——它不是崇洋，而是**在中文里把 E 提上去**。反过来，"拐弯抹角"通常不是文风问题，而是**把 R 推给读者**。
+
+### 7.7 本章与理论的关系（小结）
+
+本章把第2章的三变量、第3章的语言接口论、第4章的实证与第5章的推论，统一编译为**一组可对认知体下达的指令**：
+
+| 理论组件 | 在本章中的规范形态 |
+| :--- | :--- |
+| E↑（显式度） | 7.1 编码全部潜在变量；7.6 形合强制与词汇锚定 |
+| R↓（重建成本） | 7.3 模式B拒绝过早 Tier 5；7.5 第3步禁止懒惰提问 |
+| S↑（稳定性） | 7.2 相邻层转移律；7.4 第10项（消灭结构性多解） |
+
+> 🔵 **一句话**：理论回答了"为什么显式化有价值"，本章回答了"**具体怎么做才算显式化**"——两者之间是 E 与 I_recover 的关系：本章是第2章理论的一次**高 E 外部化**。若没有这一章，EAP 就只是一条正确的洞见；有了它，EAP 才是可执行的东西。
+
+---
+
 ## 附录：EAP的公理化可能性（可选）

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.58.0",
+  "version": "1.58.2",
   "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";
@@ -11273,7 +11273,10 @@ async function acquireWakeAgent(ctx, root, dirName) {
 			return { error: `冷会话载入失败（${id}）: ${String(err?.message ?? err)}` };
 		}
 	}
-	return { error: `无绑定会话记录（AGENT_SESSIONS/.bindings.json 中无 ${dirName}）——目标轨迹需先被 container_trajectory use 激活过` };
+	return {
+		error: `无绑定会话记录（AGENT_SESSIONS/.bindings.json 中无 ${dirName}）——目标轨迹需先被 container_trajectory use 激活过`,
+		noBinding: true
+	};
 }
 /** 唤醒消息（唤起即投递正文：身份锚定 + 唤醒信息 + 任务） */
 function buildWakeText(entry, target) {
@@ -11395,11 +11398,21 @@ async function sendToTrajectory(ctx, root, target, message, sender) {
 		ok: false,
 		detail: `目标 trajectory 未命中（${target}）`
 	};
-	const acquired = await acquireWakeAgent(ctx, root, t.dirName);
-	if ("error" in acquired) return {
-		ok: false,
-		detail: acquired.error
-	};
+	let acquired = await acquireWakeAgent(ctx, root, t.dirName);
+	let createdNote = "";
+	if ("error" in acquired) {
+		if (!acquired.notReady && acquired.noBinding === true) {
+			acquired = await createAndBindTarget(ctx, root, t.dirName);
+			if ("error" in acquired) return {
+				ok: false,
+				detail: acquired.error
+			};
+			createdNote = `；目标原本无活跃 dsh 会话 ⇒ **已自动创建并绑定**一条（${acquired.how}）`;
+		} else return {
+			ok: false,
+			detail: acquired.error
+		};
+	}
 	const agent = acquired.agent;
 	const make = () => createUserMessage({
 		content: [{
@@ -11419,14 +11432,14 @@ async function sendToTrajectory(ctx, root, target, message, sender) {
 		}
 		return {
 			ok: true,
-			detail: `已即时投递 ${t.dirName}（${acquired.how}；目标空闲 ⇒ followup 立即起轮）`
+			detail: `已即时投递 ${t.dirName}（${acquired.how}；目标空闲 ⇒ followup 立即起轮）${createdNote}`
 		};
 	}
 	try {
 		agent.steer(make());
 		return {
 			ok: true,
-			detail: `已即时注入 ${t.dirName}（${acquired.how}；目标在跑 ⇒ steer 当场注入当前轮）`
+			detail: `已即时注入 ${t.dirName}（${acquired.how}；目标在跑 ⇒ steer 当场注入当前轮）${createdNote}`
 		};
 	} catch (err) {
 		try {
@@ -11439,11 +11452,72 @@ async function sendToTrajectory(ctx, root, target, message, sender) {
 		}
 		return {
 			ok: true,
-			detail: `已投递 ${t.dirName}（${acquired.how}；steer 不可用 ⇒ 退回 followup）: ${String(err?.message ?? err)}`
+			detail: `已投递 ${t.dirName}（${acquired.how}；steer 不可用 ⇒ 退回 followup）: ${String(err?.message ?? err)}${createdNote}`
 		};
 	}
 }
 /**
+* 🆕 **给一条「从未被激活过」的轨迹就地建一条 dsh 会话并绑定它**（2026-10-16 owner 令，S142）。
+*
+* 何时用：**只有** `send-now` 在 `acquireWakeAgent` 报「无绑定会话记录」时（见该处的判据说明）。
+*
+* 三步（顺序不可换）：
+*   ① `sessionController.create({ cwd: root })` —— 宿主原语，**idempotently adopt**
+*      ⇒ 重复调用不会建出第二条（不必自造"先查再建"的竞态窗口）。
+*   ② `resolveAgent(sessionId)` —— 拿到**真 agent**。`create` 只返回 id，不给 agent。
+*   ③ `appendBound(...)` —— 落绑定。**必须由本函数写**：`listBoundSessionIds` 是
+*      `acquireWakeAgent` 的唯一选人依据，不写绑定则下一条消息**还是**找不到它
+*      （那就成了"建了但永远用不上"，比不建更坏）。
+*
+* 🔴 **为什么用 `cwd: root` 而不是目标的目录**：会话的 cwd 决定它落在哪个 CCC
+*    （`cccRootForCwd` 上溯 `.serenity`）。目标轨迹本就住在该 CCC 的 `AGENT_SESSIONS/` 下
+*    ⇒ 传 CCC 根才让它**进同一个 CCC**；传轨迹目录会让它变成一个**不同 CCC**的会话。
+*
+* @returns 命中返回 agent 与取得方式；任一步失败返回**带原因**的 error（不静默、不误报成功）
+*/
+async function createAndBindTarget(ctx, root, dirName) {
+	const sc = hostService(ctx, "sessionController");
+	const create = sc?.create;
+	if (typeof create !== "function") return {
+		error: "目标无活跃 dsh 会话，且 sessionController.create 不可用（绑定 id: 无）——无法就地创建载体；请先对该轨迹执行一次 container_trajectory use",
+		notReady: true
+	};
+	let sessionId = "";
+	try {
+		const out = await create.call(sc, { cwd: root });
+		sessionId = String(out?.sessionId ?? "");
+	} catch (err) {
+		return { error: `就地创建会话失败（${dirName}）: ${String(err?.message ?? err)}` };
+	}
+	if (!sessionId) return { error: `就地创建会话未返回 sessionId（${dirName}）` };
+	const resolved = sc?.resolveAgent;
+	if (typeof resolved !== "function") return {
+		error: `会话已建（${sessionId}）但 sessionController.resolveAgent 不可用`,
+		notReady: true
+	};
+	let agent;
+	try {
+		const out = await resolved.call(sc, sessionId);
+		agent = out?.agent;
+		if (!agent) return { error: `会话已建（${sessionId}）但 resolveAgent 未返回 agent: ${String(out?.error ?? "未知原因")}` };
+	} catch (err) {
+		return { error: `会话已建（${sessionId}）但载入失败: ${String(err?.message ?? err)}` };
+	}
+	const bound = appendBound({ header: {
+		id: sessionId,
+		cwd: root
+	} }, "activate", {
+		dirName,
+		mdPath: join(root, "AGENT_SESSIONS", dirName, "SESSION.md"),
+		note: "auto-created by send-now"
+	});
+	const how = `auto-create(${sessionId}${bound ? ", bound" : ", ⚠️ 绑定写入失败"})`;
+	return {
+		agent,
+		how
+	};
+}
+/**
 * 本 tick 要扫的 CCC 根集合（**并集**）。
 *
 * C2（S142 2026-09-15 Q5）：原实现是 `collectLiveCccs`——**只认 live 会话** ⇒
@@ -12083,13 +12157,56 @@ function renderText$3(value) {
 function createTrajectoryTool(ctx) {
 	return defineTool({
 		name: "container_trajectory",
-		description: "Trajectory (AGENT_SESSIONS/ — the persistent body of a trajectory; the dsh conversation is only its rebuildable carrier). Lifecycle + delivery: list (inventory with stats and anomaly marks) / show (read one SESSION.md) / create / use (activate for this conversation, with inline integrity check) / rebuild (clear-and-rebuild the current conversation in place, Ship of Theseus) / send-now (deliver ONE message to a trajectory RIGHT NOW — live: injected immediately; not live: cold-resumed, i.e. equivalent to a direct wake; returns a synchronous receipt) / send-later (schedule ONE message to any trajectory at a future instant — fire-and-forget: no receipt, no recall, no panel) / cro-guide (the CRO programming guide: how to give THIS trajectory its own program that decides when it should be woken). create requires --desc <desc> [--goal] or --issue <ticket> (exactly one) plus --summary (≤20 chars). use requires --summary (≤20 chars) and may pass --force to switch away from the currently-bound trajectory. rebuild requires --summary (next-phase summary ≤20 chars) + optional --note (task focus for the rebuilt self). send-later requires target (S### or AGENT_SESSIONS dir name) + at (RFC3339 or +30m/+2h) + message. send-now requires target + message. It delivers IMMEDIATELY (never queued behind the current turn): a busy target is steered mid-turn so it reads the message in the CURRENT turn, and an idle target starts a turn right away. Its receipt means the message was injected into the target (it does NOT mean the target ran or replied). The summary is appended to the dsh session title (S###-YYYY-MM-DD-<summary>); the S### id and date stay server-derived.",
+		description: [
+			"container_trajectory — one trajectory: its persistent body (SESSION.md) + its timeline.",
+			"A trajectory is NOT the conversation: SESSION.md is the durable body and never moves;",
+			"the dsh conversation is only its rebuildable carrier (Ship of Theseus — the carrier is replaced, the trajectory continues).",
+			"ACTIONS, grouped by EFFECT (read the grouping before picking one):",
+			"(A) LIFECYCLE — changes which trajectory THIS conversation is bound to:",
+			"list (inventory + stats + anomaly marks) / show (read one SESSION.md) / create (make a NEW trajectory) /",
+			"use (bind THIS conversation to an existing trajectory; inline integrity check — silent when fine, problems reported as hints, never errors) /",
+			"rebuild (clear-and-rebuild THIS conversation in place).",
+			"(B) DELIVERY — sends ONE message to ANOTHER trajectory; your own binding is unchanged:",
+			"send-now (deliver RIGHT NOW) / send-later (deliver at ONE future instant).",
+			"(C) REFERENCE — cro-guide (how to give THIS trajectory its own program that decides when it should be woken).",
+			"HOW TO CHOOSE (a rule, not a guess):",
+			"not yet bound + starting new work ⇒ create — with no prior binding it activates immediately, so the new trajectory has a carrier at once.",
+			"already bound + recording a separate future line ⇒ create — it does NOT steal your binding (you stay on the current trajectory);",
+			"activate the new one when you want it by sending it a message.",
+			"want THIS conversation to move to another trajectory ⇒ use (refuses when it would orphan the current binding; --force overrides).",
+			"want to poke another trajectory ⇒ send-now. Its target needs NO prior setup:",
+			"if the target has no live dsh session, one is created and bound automatically, and your message is injected into it.",
+			"RECEIPTS (read no more than is written): send-now returns a synchronous receipt meaning exactly \"injected / turn started\" —",
+			"NEVER \"the target ran or replied\"; to prove the target actually moved, read its SESSION.md.",
+			"It never queues behind the current turn: a busy target is steered mid-turn (read in the CURRENT turn), an idle target starts a turn at once.",
+			"send-later is fire-and-forget by design: no receipt, no recall, no panel.",
+			"ASYMMETRY (deliberate — the two differ in whether a missing target is normal): send-now creates a target on demand,",
+			"because sending to a never-used trajectory is a legitimate intent; send-later does NOT,",
+			"because scheduling for a trajectory that has never existed is almost always a mistyped name — auto-creating would hide that error behind an empty trajectory.",
+			"PARAMETERS: create requires --desc <desc> [--goal] or --issue <ticket> (exactly one) plus --summary (≤20 chars).",
+			"use requires --summary (≤20 chars) and may pass --force to switch away from the currently-bound trajectory.",
+			"rebuild requires --summary (next-phase summary ≤20 chars) + optional --note (task focus for the rebuilt self).",
+			"send-later requires target (S### or AGENT_SESSIONS dir name) + at (RFC3339 or +30m/+2h) + message.",
+			"send-now requires target + message.",
+			"The summary is appended to the dsh session title (S###-YYYY-MM-DD-<summary>); the S### id and date stay server-derived."
+		].join(" "),
 		parameters: {
 			action: {
 				type: "string",
 				enum: [...TRAJECTORY_ACTIONS],
 				required: true,
-				description: "Subcommand: list (inventory + stats + anomaly marks) / show (S### or dir name or fuzzy keyword) / create (--desc or --issue) / use (activate context; inline integrity check — pass silent, problems reported as hints, not errors) / rebuild (clear-and-rebuild current conversation — requires --summary + optional --note) / send-now (deliver one message RIGHT NOW: live target injected immediately, non-live cold-resumed like a direct wake; returns a synchronous receipt) / send-later (one future instant + one message, delivered to target trajectory) / cro-guide (no parameters: prints the CRO programming guide, including a ready-to-use sample snapshot)"
+				description: [
+					"Subcommand — grouped by effect.",
+					"LIFECYCLE (changes THIS conversation's binding):",
+					"list (inventory + stats + anomaly marks) / show (S### or dir name or fuzzy keyword) /",
+					"create (new trajectory; activates itself when you have no binding, otherwise leaves your binding untouched and tells you how to activate it) /",
+					"use (activate context for THIS conversation; inline integrity check — pass silent, problems reported as hints, not errors) /",
+					"rebuild (clear-and-rebuild current conversation — requires --summary + optional --note).",
+					"DELIVERY (sends one message to ANOTHER trajectory; your binding is unchanged):",
+					"send-now (deliver RIGHT NOW; the target needs no prior setup — if it has no live session, one is created and bound automatically) /",
+					"send-later (one future instant + one message; fire-and-forget, and it does NOT auto-create a target).",
+					"REFERENCE: cro-guide (no parameters: prints the CRO programming guide, including a ready-to-use sample snapshot)"
+				].join(" ")
 			},
 			name: {
 				type: "string",
@@ -12101,15 +12218,15 @@ function createTrajectoryTool(ctx) {
 			},
 			desc: {
 				type: "string",
-				description: "create short description (any language, ≤5 words; mutually exclusive with issue)"
+				description: "create: short description (any language, ≤5 words; mutually exclusive with issue)"
 			},
 			issue: {
 				type: "string",
-				description: "create ticket number (e.g. apaas-26116; dir named YYYY-MM-DD--<issue>; mutually exclusive with desc)"
+				description: "create: ticket number (e.g. apaas-26116; dir named YYYY-MM-DD--<issue>; mutually exclusive with desc)"
 			},
 			goal: {
 				type: "string",
-				description: "create one-sentence goal (optional)"
+				description: "create: one-sentence goal (optional)"
 			},
 			summary: {
 				type: "string",
@@ -12121,7 +12238,7 @@ function createTrajectoryTool(ctx) {
 			},
 			dryRun: {
 				type: "boolean",
-				description: "create preview mode (no actual changes)"
+				description: "create: preview mode (no actual changes)"
 			},
 			target: {
 				type: "string",
@@ -12160,13 +12277,32 @@ function createTrajectoryTool(ctx) {
 						dryRun: isDryRun
 					});
 					const message = result.message;
-					if (!isDryRun) appendBound(agentDshSession(exec), "create", {
-						dirName: result.dirName,
-						mdPath: join(result.sessionPath, "SESSION.md"),
-						sessionId: result.sessionId,
-						note: "created (binding unchanged until explicit use)"
-					});
-					return message;
+					if (isDryRun) return message;
+					const scope = agentScope$1(exec);
+					const priorBound = currentBoundDirName(exec, scope);
+					if (priorBound === null) {
+						const active = useSession(root, result.dirName, scope);
+						const info = getActiveSessionInfo(scope);
+						if (info) renameDshSessionForActive(ctx, exec, info, args.summary);
+						const dsh = agentDshSession(exec);
+						if (dsh && info) appendBound(dsh, "activate", {
+							dirName: info.dirName,
+							mdPath: info.mdPath,
+							sessionId: info.sessionId,
+							note: "auto-activated on create (no prior binding)"
+						});
+						return [
+							message,
+							`✓ 已自动激活（此前**无绑定**）：${active.dir} —— 后续工作写回该轨迹的 SESSION.md。`,
+							`  （判据：create 前无任何绑定 ⇒ 激活；有绑定则只建不夺，见下。）`
+						].join("\n");
+					}
+					return [
+						message,
+						`⚠ 本轨迹【未】被激活 —— 当前已绑定 ${priorBound}，保绑定优先（不夺走你正在用的轨迹）。`,
+						`  要激活它（并在它名下开一条会话）：用 container_trajectory send-now 向 ${result.dirName} 投一条消息 ——`,
+						`  目标若没有活跃 dsh 会话，会自动创建一条并把「使用提示词 ＋ 你的消息」一并注入。`
+					].join("\n");
 				}
 				case "use": {
 					if (!args.name) throw new Error("use requires name (S### or directory name)");
@@ -21680,6 +21816,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 +24746,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 +24762,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 +24828,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.2",
   "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": [