@shgroup/dsh-serenity-hooks 1.57.0 → 1.57.1

package/lib/config-ops.d.ts

@@ -51,15 +51,9 @@ interface PersonaSettings {
     /** 用户替换文本（替代 EAP 块 + MSM 原则段的原文） */
     overrideText: string;
 }
-/** F4d 建议问答页（v1.26.1，S142 用户：按认知容器暴露问答页供他人验证）：
- * 与 ACP HTTP 共用 3100 端口；key 首次启用自动生成（plugin 全局文件固定），无 key 不工作。
- * v1.26.2：按容器权限控制——allowed 白名单（容器名）；空 = 全部开放（向后兼容 v1.26.1 全局开放） */
-interface PublicAskSettings {
-    /** 访问 key（空 = 未生成；首次启用时 ensurePublicAskKey 自动生成随机 key 写回固定） */
-    key: string;
-    /** 开放容器白名单（CCC 目录名，如 home-serenity）；空数组 = 全部容器开放 */
-    allowed: string[];
-}
+/** F4d 建议问答页（v1.26.1）**已于 2026-10-15 整面退役**（owner 裁「砍掉外部问答」）
+ * ⇒ 原 `PublicAskSettings`（key ＋ 容器白名单）连同 `AdvancedSettings.publicAsk` 一并删除。
+ * 旧配置文件残留 `publicAsk` 节 ⇒ **静默忽略**（`mergeWithDefaults` 不再读它，幂等安全）。 */
 /**
  * 高级设定全量（~/.dsh/serenity-hooks.json 持久化形态；passHash 含 hash）。
  * review P2-3：**rebuild 已从高级配置删除**——rebuild 开关/阈值归"简单配置"
@@ -70,7 +64,6 @@ interface PublicAskSettings {
 interface AdvancedSettings {
     gateway: GatewaySettings;
     persona: PersonaSettings;
-    publicAsk: PublicAskSettings;
     /** 主动发送入口（v1.30.9）：**只绑 127.0.0.1** 的独立监听器——CCC 的 MSM 用它发消息给指定用户 */
     weixinApi: WeixinApiSettings;
 }
@@ -99,26 +92,6 @@ export declare function writeAdvancedSettings(settings: AdvancedSettings): void;
  * accounts 传入数组 → 整体替换；accounts 未传 → 保留现有。
  */
 export declare function updateAdvancedSettings(patch: Partial<AdvancedSettings>): AdvancedSettings;
-/**
- * 确保问答页访问 key 存在（首次启用自动生成 + 写回固定，用户拍板"配置时生成"）：
- * 读取全局配置 publicAsk.key；为空 → 生成 32 字节随机 hex（64 字符）→ 写回持久化。
- * @returns 当前固定 key（已生成则返回既有值——**幂等**，不会覆盖用户手改的 key）
- */
-export declare function ensurePublicAskKey(): string;
-/** 校验问答页访问 key（timing-safe；key 未生成 → 恒 false——没有 key 不工作） */
-export declare function verifyPublicAskKey(provided: string | undefined): boolean;
-/**
- * 轮换问答页访问 key（v1.26.5，S142 用户：公网开放 + 不好说要换 key 呢）：
- * 生成新 32 字节随机 hex（64 字符）→ 覆盖写回（**强制替换**——旧 key 立即失效）。
- * @returns 新 key（面板展示给管理员，重新分享给使用者）
- */
-export declare function rotatePublicAskKey(): string;
-/** 重置 IP 失败状态（测试/管理员解封） */
-export declare function resetPublicAskIpFail(ip: string): void;
-/** IP 当前是否锁定（到期自动解锁） */
-export declare function isPublicAskIpLocked(ip: string): boolean;
-/** 记录一次 key 校验失败；达到阈值 → 锁定（指数退避）。返回锁定剩余毫秒（0 = 未锁定） */
-export declare function recordPublicAskFail(ip: string): number;
 /**
  * 一次性迁移（v1.21.x → v1.22）：旧版把 `serenityAdvanced` 存在 CCC localstore.json；
  * 新版归 plugin 全局文件。全局文件已存在 → 跳过（幂等）；localstore 无旧节 → 跳过。
@@ -147,10 +120,6 @@ interface AdvancedSettingsWire {
         totpEnabled: boolean;
     };
     persona: PersonaSettings;
-    publicAsk: {
-        /** 开放容器白名单（v1.26.2：容器名数组；空 = 全部开放） */
-        allowed: string[];
-    };
 }
 /** 持久化 → wire（剥离 passHash/totpSecret；只留布尔） */
 export declare function toWire(settings: AdvancedSettings): AdvancedSettingsWire;

package/lib/face-host.d.ts

@@ -3,14 +3,16 @@
  *
  * ## 现状 → 本模块要收掉什么（取证：`…/acc-c4c5-current-state.md` §①/§③ 3.1）
  *
- * 插件自己 spawn 了**四个** node:http 监听器（B 3081 网关 / C 3082 微信发送 / D 3099 Skiff 调试
- * / E 3100 ACP+问答）。此前四处各写一份同款样板：`createServer` + `server.once('error')` +
+ * 插件自己 spawn 了**三个** node:http 监听器（B 3081 网关 / C 3082 微信发送 / D 3099 Skiff 调试）。
+ * ⚠️ **2026-10-15 变更**：原为四个（含 **E 3100 ACP+问答**），E 已随 owner「砍掉外部问答」令**整面退役**
+ * ⇒ 仍保有面 B/C/D 三个；本段保留"当年是四个"的记述，因为下方"两套拆卸"的病史由它解释。
+ * 此前四处各写一份同款样板：`createServer` + `server.once('error')` +
  * `listen(port, host)` + 模块级 `active` 变量 + `close()`；拆卸也分裂成**两套**——
  * `seams/lifecycle.ts` 有一个聚合 disposer，而 `gateway.ts` 与 `weixin-send-api.ts`
  * **各自另注册**一个（D/E 干脆没有自己的 disposer）。
  *
  * 本模块把"listener 生命周期"收成一处：**active 表 + 统一 listen/close + 统一错误与端口占用
- * 处理**。四个面各自只提供 `{ name, port, host, enabled, handler }`。
+ * 处理**。各面各自只提供 `{ name, port, host, enabled, handler }`。
  *
  * ## 🔴 共享的是「生命周期与样板」，**绝不是**「路由 / 监听器 / 鉴权」
  *
@@ -18,12 +20,12 @@
  *   · **A ↔ C 解耦**（`weixin-send-api.ts:4-7`）：3080 会被 3081 原样反代（连请求头），
  *     把 3082 的端点挂到 3080 上 = 已登录的外部家庭账号即可冒充 bot 发消息
  *     ⇒ 本模块**不提供**"把面挂到别的面"的能力，也不共享路由表；
- *   · **E ↔ D** 共用会话核心（acp-core → skiff-core）但各自独立 listener + 独立路由/HTML；
+ *   · （原 **E ↔ D** 共用会话核心但各自独立 listener 一条，**随 E 退役删除**）；
  *   · **B 是 A 的代理宿主**（把请求打到 `127.0.0.1:<主端口>`），不是另一个路由面。
  *
  * ## 面 A（3080）不在本模块之列
  * 它是**宿主 DSH 主 WebUI**，插件只往上挂 `/serenity/*` 路由（`ctx.webServer.register`），
- * **插件不起这个 listener** ⇒ 面宿主只持有 B/C/D/E 四个自起面。
+ * **插件不起这个 listener** ⇒ 面宿主只持有 B/C/D 三个自起面。
  *
  * ## 两个入口的分工（这是本模块唯一的"抽象决策"，别混）
  *   · {@link startFace} —— **机械启动**：把一个 handler 绑到 `host:port` 上。同名面若已在监听，

package/lib/index.d.ts

@@ -129,11 +129,6 @@ export interface Config {
         enabled?: boolean;
         debugPort?: number;
     };
-    /** F4c ACP（实验性）：HTTP JSON-RPC 端点启停（entry 默认值，运行时经 DSH settings） */
-    acp?: {
-        enabled?: boolean;
-        httpPort?: number;
-    };
     /** v1.30.12 web_fetch provider 接管（fake-ip / TUN 网络：宿主内置 provider 判「非公网」恒拒） */
     webFetch?: {
         enabled?: boolean;
@@ -173,12 +168,6 @@ export interface Config {
     skiffEnabled?: Volatile<boolean | undefined>;
     /** F4 Skiff 调试端口（面板层；部署层同义键 = `skiff.debugPort`） */
     skiffDebugPort?: Volatile<number | undefined>;
-    /** F4c ACP HTTP 端点总开关（面板层；部署层同义键 = `acp.enabled`） */
-    acpEnabled?: Volatile<boolean | undefined>;
-    /** F4c ACP HTTP 端口（面板层；部署层同义键 = `acp.httpPort`） */
-    acpHttpPort?: Volatile<number | undefined>;
-    /** F4d 建议问答页总开关（面板层；无部署层同义键） */
-    publicAskEnabled?: Volatile<boolean | undefined>;
     /** CRO（轨迹自编程唤起）总闸（面板层；无部署层同义键；缺省开） */
     croEnabled?: Volatile<boolean | undefined>;
     /** 无人值守代理回复总闸（面板层；无部署层同义键；缺省关） */
@@ -221,13 +210,6 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
         debugPort: z<number, number, "defined">;
     }>>, "plain">;
-    acp: z<Schemastery.ObjectS<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
-        httpPort: z<number, number, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
-        httpPort: z<number, number, "defined">;
-    }>>, "plain">;
     webFetch: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
@@ -279,9 +261,6 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     rebuildThresholdK: z<number, number, "volatile">;
     skiffEnabled: z<boolean, boolean, "volatile">;
     skiffDebugPort: z<number, number, "volatile">;
-    acpEnabled: z<boolean, boolean, "volatile">;
-    acpHttpPort: z<number, number, "volatile">;
-    publicAskEnabled: z<boolean, boolean, "volatile">;
     croEnabled: z<boolean, boolean, "volatile">;
     unattendedEnabled: z<boolean, boolean, "volatile">;
     diagramEnabled: z<boolean, boolean, "volatile">;
@@ -314,13 +293,6 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
         debugPort: z<number, number, "defined">;
     }>>, "plain">;
-    acp: z<Schemastery.ObjectS<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
-        httpPort: z<number, number, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: z<boolean, boolean, "defined">;
-        httpPort: z<number, number, "defined">;
-    }>>, "plain">;
     webFetch: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
@@ -372,9 +344,6 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     rebuildThresholdK: z<number, number, "volatile">;
     skiffEnabled: z<boolean, boolean, "volatile">;
     skiffDebugPort: z<number, number, "volatile">;
-    acpEnabled: z<boolean, boolean, "volatile">;
-    acpHttpPort: z<number, number, "volatile">;
-    publicAskEnabled: z<boolean, boolean, "volatile">;
     croEnabled: z<boolean, boolean, "volatile">;
     unattendedEnabled: z<boolean, boolean, "volatile">;
     diagramEnabled: z<boolean, boolean, "volatile">;