@shgroup/dsh-serenity-hooks 1.70.0 → 1.72.0

package/lib/{human-channel.d.ts → im/inbound.d.ts}

@@ -1,8 +1,8 @@
 /**
- * human-channel.ts — 人机信道的**机制层**（机器级；2026-09-26 owner 定案 ⇒ 方案 §2.6）
+ * im/inbound.ts — 人机信道的**机制层**（机器级；2026-09-26 owner 定案 ⇒ 方案 §2.6）
  *
  * ## 为什么单独一个模块（方案 §5-12）
- * 今天"机制"与"渠道实现"混在 `weixin-bridge.ts` 里。P0-2 要立的这条不变量是**机器级**的 ——
+ * 今天"机制"与"渠道实现"混在 `im/bridge.ts` 里。P0-2 要立的这条不变量是**机器级**的 ——
  * 它**跨 CCC**、且与"微信"无关（飞书桥／邮件桥同样要守）⇒ 抽到这里；`weixin-bridge` 只做接线。
  *
  * ## 本模块唯一的不变量
@@ -23,10 +23,10 @@
  *  ② **订阅表查询 ＋ 入站路由决策**（P0-3：`(账号, 用户) → (CCC, 角色)`）—— 见 §订阅表
  *  ③ **机器级留痕**（P0-3：未投递 ／ 目标不存在 ／ 表残缺）—— 见 §留痕。
  *     🔴 为什么这些必须机器级：它们**没有目标 CCC** ⇒ 落进任何 CCC 都是"编一个"目标。
- * **不碰**：轮询循环、凭据解析、会话投递 —— 那些是**渠道实现**，留在 `weixin-bridge.ts`。
+ * **不碰**：轮询循环、凭据解析、会话投递 —— 那些是**渠道实现**，留在 `im/bridge.ts`。
  * ⇒ 本模块**零 DSH 依赖**（只有 `node:crypto` ／ `node:fs`），可独立单测。
  */
-import type { HumanChannelSubscriptionSettings } from './settings-section.js';
+import type { HumanChannelSubscriptionSettings } from '../surface/settings.js';
 /** 一个"想为该账号起 poller"的请求（来自某 CCC） */
 export interface PollerRequest {
     /** 发起方 CCC 根（绝对路径） */

package/lib/{weixin-route.d.ts → im/route.d.ts}

@@ -1,5 +1,5 @@
 /**
- * weixin-route.ts — 微信桥 CCC 配置层纯逻辑（F4c-3，v1.27.0 实验性）
+ * im/route.ts — 微信桥 CCC 配置层纯逻辑（F4c-3，v1.27.0 实验性）
  *
  * 职责（零 DSH 依赖，可独立单测）：
  * - 读取 CCC 的 weixin 配置（.opencode/serenity.json weixin 段——结构/路由/开关）
@@ -11,18 +11,59 @@
  * 配置归属（S142 用户拍板）：**CCC 级**——serenity.json 结构 + localstore 凭据分离；
  * 不绑定具体 role（用户自选路由目标）。
  */
-import { type WeixinSettings, type WeixinRouteConfig, type WeixinAccountConfig } from './ccc.js';
-import type { WeixinMediaRef, WeixinMessageItem } from './weixin-api.js';
-/** 判定 sessionId 是否为微信桥会话（外部面——输出守卫/轨迹隐藏生效） */
+import { type WeixinSettings, type WeixinRouteConfig, type WeixinAccountConfig, type ImSettings } from '../kernel/ccc.js';
+import type { WeixinMediaRef, WeixinMessageItem } from './ilink.js';
+/** 判定 sessionId 是否为微信桥会话（**命名形态**判定；权力面判据见 `isSkiffSession`） */
 export declare function isWeixinSessionId(sessionId: string | undefined): boolean;
-/** 微信用户 → 固定会话 id（同用户长期同一会话，记忆延续；多用户天然隔离）。
- *  **v1.27.2 错位一位（用户拍板）**：`.slice(0, 16)` → `.slice(1, 17)`——旧规则生成的
- *  固定 id 已与磁盘损坏的持久化 log 绑定（dsh 不可硬删，create 同 id 必撞）→
- *  新规则下同用户生成**全新 id**，避开损坏 log；固定可重建语义不变（同用户恒同 id）。 */
-export declare function weixinSessionIdFor(fromUserId: string): string;
+/**
+ * **轨迹编码 → 固定的 dsh 会话 id**（2026-10-19 重做：身份挂在轨迹上，不挂在用户上）。
+ *
+ * ## 为什么改（owner 重做令的实际含义）
+ *
+ * 旧派生 = `skiff-weixin-<sha256(微信用户 id)>`：**同一条轨迹换一个用户就是另一条会话**，
+ * 而**同一个用户换一条轨迹也还是原来那条会话**（后者的症状：改路由之后，新轨迹的约束
+ * 对不上旧会话的历史工具清单）。⇒ 那不是"轨迹是一等公民"，那是"用户是一等公民"。
+ *
+ * 新派生 = **由轨迹编码决定**：同一条轨迹 ⇒ 恒同一条 dsh 会话（无论谁在跟它说话）；
+ * 换轨迹 ⇒ 新会话。这正是"skiff 是认知轨迹的一种"。
+ *
+ * ## 连带删掉的东西
+ *
+ * 旧实现有 `.weixin-session-gen.json` 换代计数器（`baseId-g<n>`），存在的唯一理由是
+ * "身份绑在用户上、载体（SESSION.md）可能先被归档" ⇒ 只能靠换代续命。
+ * 现在**身份就是轨迹**：轨迹没了就该报"目标不存在"（响亮），**不该静默续命**
+ * ⇒ 计数器整件删除。
+ *
+ * ⚠️ 会话 id 里保留 `skiff-weixin-` 前缀只为可读性；**它不含用户身份**，
+ * 因此也不会泄漏"谁在跟它说话"（旧形态的哈希虽是伪名，但它是**可复算的稳定标识**，
+ * 见 `privacy-scan` 的 `weixin-session-pseudonym` 规则 —— 新形态连这个问题都没有了）。
+ */
+export declare function weixinSessionIdForTrajectory(code: string): string;
+/**
+ * **统一 IM 配置的单一读取入口**（2026-10-19 owner 定向：微信与飞书只是账号实现不同，
+ * 整合到统一配置）。
+ *
+ * 读取顺序（**确定性，只有这一处**）：
+ *   ① `im` 段 —— 但**判据是 `accounts` 是数组**，不是"段存在"（见下 🔴）
+ *   ② 旧 `weixin` 段 —— 存量 CCC 零迁移
+ *   ③ 都没有 ⇒ 归一默认（`enabled:false`、空数组）
+ *
+ * 🔴 **为什么判据是「`accounts` 是数组」**：本 CCC 的配置里**曾经**有过一个 `im` 段
+ * （退役的 ACP 形态：`{channel:"acp", acp:{enabled, accounts:[…]}}`）。若只判"段存在"，
+ * 那份残留会被当成新配置读 ⇒ 得到一个没有 `accounts` 数组 ／ 或 `accounts` 形状完全不同的对象
+ * ⇒ 表现为**"配置没生效"且不报错**。⇒ 用可判别的形状把它排除掉（退役残留继续被静默忽略，
+ * 与 v1.59.0 的裁决一致）。
+ *
+ * ⚠️ 本函数**只做归一**，不判断"这个通道实现有没有"——那是装配处的事
+ * （`syncMachinePollers` 里有"未实现的 channel 出声但不静默跳过"）。
+ */
+export declare function readImSettings(root: string, paths?: string[]): ImSettings;
 /**
  * 读取 CCC 微信桥配置（未配置/未启用 → 归一默认）。
- * @returns 归一化 WeixinSettings（accounts/routes 数组清洗；空段 → 空数组）
+ *
+ * ⚠️ 2026-10-19 起它是 {@link readImSettings} 的**薄别名**（签名与返回形状不变）：
+ * 旧调用点无需改动，但**配置来源已经统一**——`im` 段优先、`weixin` 段回退。
+ * 保留名字是为了让既有调用点与测试**逐字不动**（P1 是纯重构，读数必须不变）。
  */
 export declare function readWeixinSettings(root: string, paths?: string[]): WeixinSettings;
 /** 账号凭据（localstore credential scope；baseUrl 缺省 = 官方默认） */
@@ -39,7 +80,7 @@ export declare function writeWeixinCredential(root: string, accountId: string, c
 export declare function clearWeixinCredential(root: string, accountId: string): void;
 /**
  * 路由匹配：exact user 优先，通配 `*` 兜底。
- * @returns 命中的 role 名；未命中 → null（无路由 → 消息不回复/忽略）
+ * @returns 命中的**轨迹编码**；未命中 → null（无路由 → 消息不回复/忽略）
  */
 export declare function matchWeixinRoute(routes: WeixinRouteConfig[], fromUserId: string): string | null;
 /**

package/lib/{weixin-send-api.d.ts → im/send.d.ts}

@@ -1,5 +1,5 @@
 /**
- * weixin-send-api.ts — 主动发送入口（S142 v1.30.9，用户需求"微信桥支持被调用发消息给指定用户"）
+ * im/send.ts — 主动发送入口（S142 v1.30.9，用户需求"微信桥支持被调用发消息给指定用户"）
  *
  * 形态（用户拍板 A2）：**独立监听器，只绑 127.0.0.1**（默认 3082，plugin 全局配置 weixinApi）。
  * 为什么不挂在主 webServer(3080) 上：3080 会被 3081 公网网关原样反代（含全部请求头），
@@ -22,8 +22,8 @@
  */
 import { type ServerResponse } from 'node:http';
 import type { Context } from 'cordis';
-import { type FaceSpec } from './face-host.js';
-import { weixinSendEndpoint } from './weixin-send-endpoint.js';
+import { type FaceSpec } from '../surface/faces.js';
+import { weixinSendEndpoint } from './endpoint.js';
 export { weixinSendEndpoint };
 /** 文本长度上限（微信侧单条消息实践上限；超限拒绝而非静默截断） */
 export declare const WEIXIN_SEND_MAX_TEXT = 4000;

package/lib/im/weixin-account.d.ts

@@ -0,0 +1,45 @@
+/**
+ * im/weixin-account.ts — 微信账号实现（P2：把既有微信轮询包成 `ImAccountImpl`）
+ *
+ * 🔴 **纯移动，零逻辑改动**。`runAccountLoop` 的函数体逐字来自 `bridge.ts`；
+ * 唯一新增的是把它**登记成"一种账号实现"**，这样装配处不必再写死 `channel === 'weixin'`。
+ *
+ * 为什么值得单独成一个文件（而不是留在 bridge.ts 里）：
+ * 装配处从此只认 `ImAccountImpl` 接口；微信与飞书是**并列的两个实现**，
+ * 而不是"微信是主角、别的往里塞"。这正是 owner「只不过是 account 方实现不同」的结构表达。
+ */
+import type { WeixinAccountCredential } from './route.js';
+import { type ImAccountImpl } from './accounts.js';
+/**
+ * 把实现所需的最小注入面收进来。
+ *
+ * ⚠️ 这些是**微信侧的运行依赖**（`getUpdates` / `handleIncoming` / `handleMachineIncoming`）。
+ * 用注入而不是 import，是为了让 `bridge.ts` 不因本文件而反向依赖 —— 否则两个文件互相
+ * import 会成环（本轨已有先例：`rebuild ⇄ tools/trajectory` 那个人工发现的环）。
+ */
+export interface WeixinLoopDeps {
+    getUpdates: (input: {
+        baseUrl: string;
+        token: string;
+        getUpdatesBuf: string;
+        timeoutMs: number;
+    }) => Promise<{
+        get_updates_buf?: string;
+        msgs?: Array<Record<string, unknown>>;
+    }>;
+    handleIncoming: (ctx: unknown, root: string, accountId: string, cred: WeixinAccountCredential, msg: never) => Promise<void>;
+    handleMachineIncoming: (ctx: unknown, accountId: string, cred: WeixinAccountCredential, msg: never) => Promise<void>;
+}
+/** 装配时注入依赖（`bridge.ts` 在模块初始化末尾调用一次；见 `installWeixinAccountImpl`） */
+export declare function setWeixinLoopDeps(d: WeixinLoopDeps): void;
+/** 微信账号实现（登记的 channel 名 = `weixin`；与配置里的取值一致） */
+export declare const weixinAccountImpl: ImAccountImpl;
+/**
+ * 注册微信实现**并注入依赖**（`bridge.ts` 调用；幂等——重复注册覆盖同名 channel）。
+ *
+ * ⚠️ 必须在首次 `syncHumanChannel` / `syncCccBridge` **之前**发生。
+ * `bridge.ts` 在**模块求值时**调用它一次（不是等到 `registerWeixinBridge`）——
+ * 因为测试与面板会**直接**调 `syncCccBridge`，那时装配入口还没跑过；
+ * 若依赖装配入口注册，那些路径会全部走进"未实现"分支（本轮实测：12 例红，根因就是它）。
+ */
+export declare function installWeixinAccountImpl(d: WeixinLoopDeps): void;

package/lib/{im-weixin.d.ts → im/weixin-channel.d.ts}

@@ -1,5 +1,5 @@
 /**
- * im-weixin.ts — 微信通道实现（`im-bridge` 的通道之一，v1.31.0）
+ * im/weixin-channel.ts — 微信通道实现（`im-bridge` 的通道之一，v1.31.0）
  *
  * 能力归 ACC（S142 用户洞察）：本文件吸收原 CCC MSM `.opencode/skills/home-serenity/scripts/
  * weixin-send.ts` 的 `send` / `send-file` / `users` 语义——协议、凭据、账号选择、别名解析、
@@ -10,7 +10,7 @@
  * - `send` 复用 `sendProactiveText`（唯一文本发送实现 + 唯一记录点）
  * - `sendFile` 走 iLink 上传（`weixin-api.sendFileMessage`）+ 同一 outgoing hook（带 `file` 元数据）
  */
-import type { ImChannel } from './im-bridge.js';
+import type { ImChannel } from './channels.js';
 /**
  * 解析该 CCC 的别名表（v1.56.10）。
  *