@shgroup/dsh-serenity-hooks 1.73.0 → 1.75.0

package/lib/im/hook.d.ts

@@ -33,7 +33,7 @@ interface WeixinHookEventBase {
     userId: string;
     /** 固定会话 id（同用户长期同一：skiff-weixin-xxx） */
     sessionId: string;
-    /** 路由命中的 skiff role */
+    /** 路由命中的 轨迹约束 role */
     role: string;
 }
 /** incoming 事件（用户 → bot）：文本（含语音转写）+ 媒体（已落盘 relPath） */

package/lib/im/inbound-event.d.ts

@@ -29,7 +29,7 @@
  * - ✅ 只负责：「一条已到达的消息，该投到哪条认知轨迹、怎么答、怎么记账」。
  */
 import type { Context } from 'cordis';
-import { type SkiffProfile } from '../trajectory/policy/profile.js';
+import { type TrajectoryConstraint } from '../trajectory/policy/profile.js';
 /**
  * 一条**已到达**的入站消息（归一后）。
  *
@@ -91,7 +91,7 @@ export interface ImAccountIo {
     }): Promise<void>;
 }
 /**
- * 路由解析结果：目标根 ＋ **轨迹编码** ＋ **该轨迹的 skiff 约束面**。
+ * 路由解析结果：目标根 ＋ **轨迹编码** ＋ **该轨迹的 轨迹约束面**。
  * `null` 从本函数出去 ⇒ **不投递**（未命中已留痕 ／ 目标不存在已响亮出声）。
  */
 export interface ResolvedInboundTarget {
@@ -99,11 +99,11 @@ export interface ResolvedInboundTarget {
     /** 目标认知轨迹编码（= 新模型里的"身份"；旧模型的角色名已退役） */
     trajectory: string;
     /**
-     * 该轨迹的 skiff 约束面。
-     * ⚠️ **可能为 `null`**：轨迹存在但没有 `skiff.json` ⇒ 它是一条**普通轨迹**，
-     * IM 桥照样可以往里投，只是不施加 skiff 约束。
+     * 该轨迹的 轨迹约束面。
+     * ⚠️ **可能为 `null`**：轨迹存在但没有 `trajectory-constraint.json` ⇒ 它是一条**普通轨迹**，
+     * IM 桥照样可以往里投，只是不施加 轨迹约束 约束。
      */
-    profile: SkiffProfile | null;
+    profile: TrajectoryConstraint | null;
 }
 /**
  * **入站路由的单一解析处**（P0-3）：机器级订阅表优先 → CCC 级回退；三档语义都在这里落地。

package/lib/im/route.d.ts

@@ -4,7 +4,7 @@
  * 职责（零 DSH 依赖，可独立单测）：
  * - 读取 CCC 的 weixin 配置（.opencode/serenity.json weixin 段——结构/路由/开关）
  * - 读取/写入 CCC localstore 的账号凭据（weixin.accounts.<accountId>.token/.baseUrl/.userId）
- * - 微信用户 → skiff 会话 id 映射（固定可重建：skiff-weixin-<sha256(userid)>.slice(1, 17)；
+ * - 微信用户 → 轨迹约束会话 id 映射（固定可重建：skiff-weixin-<sha256(userid)>.slice(1, 17)；
  *   v1.27.3 错位一位避开损坏 log）
  * - 路由匹配（exact user → 通配 * 兜底）
  *
@@ -13,7 +13,7 @@
  */
 import { type WeixinSettings, type WeixinRouteConfig, type WeixinAccountConfig, type ImSettings } from '../kernel/ccc.js';
 import type { WeixinMediaRef, WeixinMessageItem } from './ilink.js';
-/** 判定 sessionId 是否为微信桥会话（**命名形态**判定；权力面判据见 `isSkiffSession`） */
+/** 判定 sessionId 是否为微信桥会话（**命名形态**判定；权力面判据见 `isTrajectoryConstrained`） */
 export declare function isWeixinSessionId(sessionId: string | undefined): boolean;
 /**
  * **轨迹编码 → 固定的 dsh 会话 id**（2026-10-19 重做：身份挂在轨迹上，不挂在用户上）。
@@ -25,7 +25,7 @@ export declare function isWeixinSessionId(sessionId: string | undefined): boolea
  * 对不上旧会话的历史工具清单）。⇒ 那不是"轨迹是一等公民"，那是"用户是一等公民"。
  *
  * 新派生 = **由轨迹编码决定**：同一条轨迹 ⇒ 恒同一条 dsh 会话（无论谁在跟它说话）；
- * 换轨迹 ⇒ 新会话。这正是"skiff 是认知轨迹的一种"。
+ * 换轨迹 ⇒ 新会话。这正是"轨迹约束是认知轨迹的一种"。
  *
  * ## 连带删掉的东西
  *
@@ -91,6 +91,20 @@ export declare function readFeishuCredential(root: string, accountId: string): F
 export declare function writeFeishuCredential(root: string, accountId: string, cred: FeishuAccountCredential): void;
 /** 清除飞书账号凭据（移除账号时） */
 export declare function clearFeishuCredential(root: string, accountId: string): void;
+/**
+ * **按渠道判「该账号是否已绑定凭据」**（面板读数用；单一处）。
+ *
+ * 🔴 为什么需要它（2026-10-19 P2 面板实测缺陷）：面板原先对所有账号都调
+ * `readWeixinCredential`（只看 `WEIXIN_<A>_TOKEN`）。一个**飞书**账号的凭据在
+ * `FEISHU_<A>_APPID|SECRET`，走那条读法**必然读到 null** ⇒ 面板把一个配好的飞书账号
+ * 显示成「未绑定凭据」，用户据此以为没配上。
+ *
+ * 判据与装配处**同源**（`im/bridge.ts` 的 `readImCredentialByChannel`）：飞书要 appId **且**
+ * appSecret，微信只要有 token。两处若各写一份判据，就会重演"两个读数器给出不同答案"。
+ *
+ * ⚠️ 只回**布尔**，不回任何凭据值 —— 这是 wire 面。
+ */
+export declare function imCredentialBound(root: string, accountId: string, channel: string | undefined): boolean;
 /**
  * 路由匹配：exact user 优先，通配 `*` 兜底。
  * @returns 命中的**轨迹编码**；未命中 → null（无路由 → 消息不回复/忽略）
@@ -145,5 +159,13 @@ export declare function saveWeixinRoutes(root: string, routes: WeixinRouteConfig
  * 移除中间账号后不冲突（wechat-2 被删 → 新账号复用 wechat-2 而非跳到 4）。
  */
 export declare function nextWeixinAccountId(settings: WeixinSettings): string;
+/**
+ * 生成下一个可用飞书账号 id（`feishu-N`，N 取**最小未占用**）。
+ *
+ * 与 {@link nextWeixinAccountId} 分开而不是加参数：两者的**前缀不同**，
+ * 而前缀是给人看的（面板上一眼分清哪些账号来自哪个渠道）。
+ * 判据相同（最小未占用，删中间不跳号）。
+ */
+export declare function nextFeishuAccountId(settings: WeixinSettings): string;
 /** 切换总开关 */
 export declare function setWeixinEnabled(root: string, enabled: boolean): WeixinSettings;

package/lib/index.d.ts

@@ -68,7 +68,7 @@ export type HumanChannelSubscriptionConfig = {
     user?: string;
     /** 目标 CCC（别名） */
     ccc?: string;
-    /** 目标 skiff 角色名（∈ 该 CCC 的 `skiff.roles`） */
+    /** 目标 轨迹约束角色名（∈ 该 CCC 的 `轨迹约束.roles`） */
     role?: string;
 };
 export interface HumanChannelConfig {
@@ -76,8 +76,8 @@ export interface HumanChannelConfig {
     accounts?: HumanChannelAccountConfig[];
     /**
      * 订阅表：`(账号, 用户) → (CCC, 角色)` —— **收到**谁的消息。
-     * 🔴 机器级**显式表**，**不得**由"该 CCC 有没有 skiff 角色"推断（owner 2026-09-26 更正）：
-     * skiff 用途很多（传话员只是其一），推断会让**为别的目的建的 skiff 被静默误接上微信**。
+     * 🔴 机器级**显式表**，**不得**由"该 CCC 有没有 轨迹约束角色"推断（owner 2026-09-26 更正）：
+     * 轨迹约束 用途很多（传话员只是其一），推断会让**为别的目的建的 轨迹约束 被静默误接上微信**。
      */
     subscriptions?: HumanChannelSubscriptionConfig[];
     /** 主控（relay）：**唯一**可做跨 CCC 动作的 CCC */
@@ -124,8 +124,8 @@ export interface Config {
         enabled?: boolean;
         thresholdK?: number;
     };
-    /** F4 Skiff（实验性）：调试服务启停（entry 默认值，运行时经 DSH settings） */
-    skiff?: {
+    /** F4 轨迹约束（实验性）：调试服务启停（entry 默认值，运行时经 DSH settings） */
+    轨迹约束?: {
         enabled?: boolean;
         debugPort?: number;
     };