@shgroup/dsh-serenity-hooks 1.71.0 → 1.72.0

package/dsh.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.71.0",
+  "version": "1.72.0",
   "main": "lib/index.js",
-  "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/微信桥/认知轨迹唤醒注册表。skiff = 目录下有 skiff.json 的认知轨迹（约束面住在轨迹里）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
+  "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/微信桥/认知轨迹唤醒注册表。skiff = 目录下有 skiff.json 的认知轨迹（约束面住在轨迹里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
   "engines": {
     "dsh": ">=0.1.7-rc.1"
   },

package/lib/im/accounts.d.ts

@@ -0,0 +1,105 @@
+/**
+ * im/accounts.ts — **账号实现派发表**（P2，2026-10-19）
+ *
+ * ## 为什么是"账号"这一层（owner 定向，逐字）
+ *
+ * > 「飞书继承可以很方便的加到当前的体系里，**和微信一样，只不过是 account 方实现不同**。
+ * > **要整合到统一的配置中**。」
+ *
+ * 微信与飞书的差别**只在账号侧**：怎么连、怎么收、怎么发。而它们的**身份、路由、会话**
+ * 从来就是通道无关的：
+ * - 路由表 = `user → 轨迹编码`（不认渠道）
+ * - 会话 id = `skiff-weixin-<轨迹编码>`（由轨迹决定，不认渠道）
+ * - 一账号一 poller 的归属判据 = `(root, accountId, identity)`（不含渠道概念）
+ *
+ * ⇒ 抽象点是 `account.channel`，**不是**新造一个平行的"通道接口"。
+ *   本文件的全部职责：**channel 字符串 → 那个实现**。
+ *
+ * ## 这不是新设计（源码里早就留了口）
+ *
+ * `bridge.ts` 的机器级装配处原本写着：
+ * *「只有已实现的渠道能起 poller（**P2 才加第二个实现**）⇒ 未实现的出声但不静默跳过」*
+ * 且账号行 `HumanChannelAccountSettings` **本来就有 `channel` 字段**。
+ * ⇒ 本文件就是把那个"P2 预留位"填上。
+ *
+ * ## 为什么用「注册表 + 未命中响亮」而不是 switch
+ *
+ * switch 会把"支持哪些渠道"写死在装配逻辑里；注册表让**新增一个渠道实现 = 新增一个文件
+ * + 一次 register**，装配处一行不改（R3 家族式扩展）。而未命中**必须出声**——
+ * 静默跳过会表现成"某个账号莫名其妙不工作"，那是本轨反复踩过的一类最难查的故障。
+ */
+/** 一条账号的运行期凭据（各实现自解释；`weixin` 用 token/baseUrl/userId） */
+export interface ImAccountCredential {
+    token?: string;
+    baseUrl?: string;
+    userId?: string;
+    /** 飞书等：appId（凭据本体仍在 localstore） */
+    appId?: string;
+}
+/**
+ * 账号实现的**最小面**（只放装配处真正需要的东西）。
+ *
+ * 🔴 刻意**不**把"收消息"放进来：接收循环的形状（长轮询 vs WebSocket 回调）
+ * 两家根本不同，硬塞进一个签名只会让两边都别扭。装配处需要的是：
+ * ① 这个账号该不该起（凭据齐不齐）② 起起来 ③ 停 ④ 健康快照。
+ */
+export interface ImAccountImpl {
+    /** 实现名（= `account.channel` 的取值，如 `weixin`） */
+    readonly channel: string;
+    /**
+     * 凭据是否齐全到**可以起**（缺失 ⇒ 装配处跳过并出声，**不静默**）。
+     * @param cred 已从 localstore 读好的凭据（实现自己判断哪个字段必需）
+     */
+    isReady(cred: ImAccountCredential): boolean;
+    /**
+     * 凭据不全时**给人看的原因**（装配处的告警文案，可含 CC 特定措辞）。
+     * 缺省 ⇒ 装配处用通用文案。存在的理由：微信的文案是「无 token（未绑定）」，
+     * 那是有既有判据钉住的措辞（测试与排查手册都按它找），不该被本层统一措辞冲掉。
+     */
+    notReadyReason?(cred: ImAccountCredential): string;
+    /**
+     * 起这条账号的接收循环（fire-and-forget：实现内部自行循环，不得阻塞装配）。
+     * @returns 该账号的循环控制对象（装配处用它做停止与快照）
+     */
+    startLoop(input: ImAccountLoopInput): ImAccountLoop;
+}
+/**
+ * 起循环的输入。
+ *
+ * ⚠️ `root` 在**机器级模式**下是 `MACHINE_SCOPE` 哨兵（不是一个目录）——
+ * 这与既有语义一致（投到哪个 CCC 由**每条消息**的订阅表决定，不由账号决定）。
+ */
+export interface ImAccountLoopInput {
+    ctx: unknown;
+    root: string;
+    accountId: string;
+    cred: ImAccountCredential;
+    /** 真 = 机器级 poller（目标由订阅表逐条决定） */
+    machine: boolean;
+}
+/**
+ * 循环控制（装配处持有；`weixinBridgeStatus` 读它出健康快照）。
+ *
+ * 🔴 `lastPollAt` / `lastError` 是**面板读数面**的既有字段，名字不能改
+ * （`im-bridge status` 与设置面板都按这个形状读）。
+ */
+export interface ImAccountLoop {
+    stopped: boolean;
+    lastPollAt: number;
+    lastError?: string;
+}
+/** 注册账号实现（`index.ts` 装配时调用；重复 channel 覆盖——测试与热重载友好） */
+export declare function registerImAccountImpl(impl: ImAccountImpl): void;
+/** 取实现（未注册 ⇒ `null`，由调用方**响亮出声**，不要静默跳过） */
+export declare function getImAccountImpl(channel: string): ImAccountImpl | null;
+/** 已注册的实现名（诊断与错误文案用；顺序 = 注册顺序） */
+export declare function imAccountChannels(): string[];
+/** 测试辅助：清空派发表（生产零调用） */
+export declare function __resetImAccountImplsForTest(): void;
+/**
+ * 账号行的渠道归一（**单一处**）。
+ *
+ * 缺省 `weixin`：老配置平移到 `im` 段时不必补这个字段——owner 的"统一配置"
+ * 要能直接吃旧数据（与 `route.ts` 的 `normalizeImSection` 保持同一口径）。
+ */
+export declare function normalizeAccountChannel(channel: string | undefined): string;

package/lib/im/route.d.ts

@@ -11,7 +11,7 @@
  * 配置归属（S142 用户拍板）：**CCC 级**——serenity.json 结构 + localstore 凭据分离；
  * 不绑定具体 role（用户自选路由目标）。
  */
-import { type WeixinSettings, type WeixinRouteConfig, type WeixinAccountConfig } from '../kernel/ccc.js';
+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;
@@ -39,9 +39,31 @@ export declare function isWeixinSessionId(sessionId: string | undefined): boolea
  * 见 `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 缺省 = 官方默认） */

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/index.js

@@ -1,8 +1,8 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
 import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebServer, i as cccRootForExec, l as hostLlm, m as hostWeb, n as agentCwdFor, o as listCccs, p as hostSubagents, r as cccRootForCwd, s as hostAgents, t as NO_CCC_FROM_AGENT_CWD, u as hostService } from "./ccc-roots-jZYR2GVE.js";
-import { _ as resolveInside, a as findSerenityRoot$1, c as matchBlacklist, d as readCccName$1, f as readCheapWorkerConfig, h as readSafeModeHiddenTools, i as findGitRoot, l as pathInside, m as readExclusiveTools, n as SAFE_MODE_MARKER, o as isSafeModeOn, p as readCognitiveTrajectorySkills, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-Dkoa2oW3.js";
+import { _ as resolveInside, a as findSerenityRoot$1, c as matchBlacklist, d as readCccName$1, f as readCheapWorkerConfig, g as readUtf8, h as readSafeModeHiddenTools, i as findGitRoot, l as pathInside, m as readExclusiveTools, n as SAFE_MODE_MARKER, o as isSafeModeOn, p as readCognitiveTrajectorySkills, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-Dkoa2oW3.js";
 import { A as sessionEvents$1, C as listSessions, D as readActiveSessionMd, E as parseTrajectoryCode, F as useSession, I as isoLocal, L as localFileStamp, M as setActiveSessionInfo, N as showSession, O as readTrajectoryUid, P as summarize, R as localHuman, S as listActiveTrajectories, T as parseSessionContextFromEvents, _ as createSession, a as readSkiffProfileAt, b as getActiveSessionInfo, c as registerSkiffSession$1, d as unregisterSkiffSession$1, f as COGNITIVE_TRAJECTORY_ACTIONS, g as clearActiveSessionInfo, h as archiveSession, j as sessionsRoot, k as resolveSessionByTitle, l as skiffSessionInfo$1, m as UID_FILENAME, n as isSkiffSession, o as readSkiffProfileByCode, p as DEFAULT_SESSION_SCOPE, r as listSkiffProfiles, s as skiffProfileForSession, t as SKIFF_PROFILE_FILENAME, u as skiffTrajectoryDirNameFor, v as extractSessionMdPathFromText, w as namingTitleFor, y as findSession, z as localIdStamp } from "./profile-DyMJ_bfr.js";
-import { a as readWeixinCredential, c as sanitizeFileName$1, d as LOCALSTORE_SCOPES, f as checkLocalstoreGitCompliance, g as runLocalStore, h as readStore, i as matchWeixinRoute, l as weixinInboundDir, m as readGitTrack, n as extractWeixinText, o as readWeixinSettings, p as localstorePath, r as hasVoiceItem, t as extractWeixinMedia, u as weixinSessionIdForTrajectory } from "./route-CPneN5iv.js";
+import { a as readWeixinCredential, c as sanitizeFileName$1, d as LOCALSTORE_SCOPES, f as checkLocalstoreGitCompliance, g as runLocalStore, h as readStore, i as matchWeixinRoute, l as weixinInboundDir, m as readGitTrack, n as extractWeixinText, o as readWeixinSettings, p as localstorePath, r as hasVoiceItem, t as extractWeixinMedia, u as weixinSessionIdForTrajectory } from "./route-f7JlinIt.js";
 import { _ as resolveProfileSystemPrompt, a as GATEWAY_PORT, c as SKIFF_DEBUG_PORT, d as buildSkiffBasePrompt, f as createProfilePromptReader, g as profileToolWhitelist, h as profileSystemPromptSource, i as FACE_PORTS, l as WEIXIN_SEND_PORT, m as profileMsmWhitelist, n as readSimpleSettings, o as MAIN_WEB_PORT, p as profileCognitiveTrajectory, r as registerSettingsSection, s as MECHANISM_PORTS, u as SKIFF_PROFILE_HINT, v as ACC_VERSION, y as findPackageRoot } from "./settings-lt1i3OZv.js";
 import { a as pruneMissingBindings, c as setBindingStore, i as listBoundSessionIds, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND } from "./message-source-kVoNK0C5.js";
 import { REGISTERED_TOOLS } from "./invariant.js";
@@ -1823,6 +1823,141 @@ async function runMsmAsync(root, args) {
 	}
 }
 //#endregion
+//#region src/trajectory/prompt.ts
+/**
+* trajectory/prompt.ts — **轨迹提示词**（Trajectory Prompt）：一条轨迹"是谁、按什么章程工作"
+*
+* ## 概念（owner 2026-10-19 定向，逐字）
+*
+* > 「参考会话的系统提示词，我们建立**轨迹提示词**概念来代替人格。架构上会好很多」
+*
+* **轨迹提示词** = 一条认知轨迹的**可编辑章程声明**，由 ACC 按固定顺序装配进系统提示词。
+* 三个关键词各是一条判据：
+* - **可编辑**：住在 CCC（盘上），改它**不发版**（D23 归属判据的直接推论）
+* - **声明**：它声明**身份／章程／方法论**，**不声明能力**（能力面归 `skiff.json` 白名单与工具 schema）
+* - **固定顺序**：装配顺序由 ACC 定死（见 `seams/system-prompt.ts` 的 ⑧ 位）
+*
+* ## 为什么取代「人格」
+*
+* 「人格」把身份绑在"像不像一个人"上 ⇒ 因为叫人格，它被设计成**可以整体替换**
+* （`persona` 置换 EAP 块，即 review F-05/R-14 那个悬置冲突）。而身份与章程**不该被替换，
+* 只该被特化**。⇒ 本模块把"替换"改成"叠加"：容器层与质量层永远保留，轨迹提示词只往上加。
+*
+* ## 落点（为什么在轨迹目录里）
+*
+* `AGENT_SESSIONS/<轨迹目录>/PROMPT.md`
+*
+* - **跟着轨迹走**：`archive` 时整个目录搬走，章程不会掉队（旧形态 `.opencode/skiff/<name>.md`
+*   与轨迹**分居两处** —— 多条轨迹共用一份文件正是那个后果）。
+* - **每条轨迹都能有**：不只是 skiff。普通轨迹同样需要"我是谁、按什么章程"。
+* - 与 `SESSION.md`（身体：延续/日志）、`skiff.json`（约束面：能力）三件并列，
+*   各管一件事，不合并（合并会让"改能力"与"改身份"互相牵连）。
+*
+* ## 兼容（不静默坏）
+*
+* `PROMPT.md` 不存在时**不报错**（普通轨迹常态）。skiff 的旧字段 `systemPromptFile`
+* 在兼容期仍被读取——优先级见 {@link resolveTrajectoryPrompt}。
+*/
+/** 轨迹提示词的固定文件名（**判据就是它存在**——不是目录名前缀，也不是配置里的一行） */
+const TRAJECTORY_PROMPT_FILENAME = "PROMPT.md";
+/** 轨迹目录的 PROMPT.md 绝对路径（不论存在与否——调用方自己判存在性） */
+function trajectoryPromptPath(root, dirName) {
+	return join(sessionsRoot(root), dirName, TRAJECTORY_PROMPT_FILENAME);
+}
+/**
+* 该轨迹**有没有**轨迹提示词（单一判据）。
+*
+* 用途：兼容期的"让位"判定 —— 若已有 `PROMPT.md`，skiff 旧字段 `systemPromptFile`
+* 必须**让位**，否则同一份章程会在两处各注入一遍（第 ⑧ 段 ＋ `serenity-skiff` 段）。
+* 🔴 判据只有这一处：别在 skiff 那边自己拼路径再判（两处会漂）。
+*/
+function hasTrajectoryPrompt(root, dirName) {
+	try {
+		return existsSync(trajectoryPromptPath(root, dirName));
+	} catch {
+		return false;
+	}
+}
+/**
+* 轨迹提示词的**读取器**（长期热更新；改文件即生效，无需重启）。
+*
+* ## 为什么返回函数而不是字符串（R↓，实证代价）
+*
+* 旧实现把提示词**快照**进系统提示词段的闭包 ⇒ CCC 改了文件必须重启 dsh web 才生效
+* （实测：改完 18KB 提示词，live agent 仍用旧文本）。现形态由系统提示词段的 `text()`
+* **每轮调用**本读取器：按 **mtime + size** 缓存重读（命中缓存零 IO）。
+*
+* ## 三条失败语义（各治一个失败模式）
+*
+* - **文件不存在** ⇒ 返回空串（**不是错误**：普通轨迹没有章程是常态，且删掉即失效
+*   必须是立即可见的——这就是"删掉 PROMPT.md 即恢复默认"的机制）
+* - **读取失败** ⇒ 返回**上次成功内容**（⛔ 绝不返回空：空提示词会让轨迹失去章程），
+*   并按去重标签告警一次
+* - **首次就读不到** ⇒ 空串 ＋ 告警一次（区分"本来没有"与"有但读不了"）
+*
+* @param root CCC 根
+* @param dirName 轨迹目录名（**不是编码**：目录名才是落盘位置）
+*/
+function createTrajectoryPromptReader(root, dirName) {
+	const absPath = trajectoryPromptPath(root, dirName);
+	let cachedMtime = -1;
+	let cachedSize = -1;
+	let cachedText = "";
+	let warned = false;
+	return () => {
+		let st;
+		try {
+			st = statSync(absPath);
+		} catch (err) {
+			const code = err?.code;
+			cachedMtime = -1;
+			cachedSize = -1;
+			cachedText = "";
+			if (code !== "ENOENT" && !warned) {
+				warned = true;
+				console.warn(`[serenity-hooks] ✗ 轨迹提示词不可读（${absPath}）——按"没有章程"处理: ${String(err?.message ?? err)}`);
+			}
+			return "";
+		}
+		try {
+			if (st.mtimeMs === cachedMtime && st.size === cachedSize) return cachedText;
+			const text = readUtf8(absPath).trim();
+			const isReload = cachedMtime !== -1;
+			cachedMtime = st.mtimeMs;
+			cachedSize = st.size;
+			cachedText = text;
+			warned = false;
+			if (isReload) console.info(`[serenity-hooks] ↻ 轨迹提示词已热重载（${TRAJECTORY_PROMPT_FILENAME}，${text.length} 字符）`);
+			return text;
+		} catch (err) {
+			if (!warned) {
+				warned = true;
+				console.warn(`[serenity-hooks] ✗ 轨迹提示词读取失败（${absPath}）——沿用上次成功内容: ${String(err?.message ?? err)}`);
+			}
+			return cachedText;
+		}
+	};
+}
+/**
+* 装配用的**提示词段**（幂等：无内容 ⇒ 空串，宿主会丢弃空 section/空块）。
+*
+* 标记头 `=== Serenity Trajectory Prompt ===`：
+* ① 让模型知道"下面是**这条轨迹自己的章程**"，不是容器规则；
+* ② 让诊断可以按块名 grep。
+*
+* 🔴 这段**追加**在容器层与质量层之后，**永不替换它们**——那正是本概念相对「人格」的核心修正。
+*/
+function trajectoryPromptBlock(text) {
+	const body = text.trim();
+	if (body === "") return "";
+	return [
+		"",
+		"=== Serenity Trajectory Prompt ===",
+		body,
+		""
+	].join("\n");
+}
+//#endregion
 //#region src/role/worker/idle.ts
 /**
 * 等待 agent 空闲或销毁。
@@ -3441,7 +3576,7 @@ function sessionBlock(root, scope = DEFAULT_SESSION_SCOPE) {
 * Principles 剥离 MSM 原则段（指令遵循约束）——用户文本承接两处风格；本体论/关系段/
 * 操作边界（安全硬约束）永远保留。未配置 → 与 v1.23.0 逐字节一致（零影响）。
 */
-function serenitySystemPrompt(root, scope = DEFAULT_SESSION_SCOPE) {
+function serenitySystemPrompt(root, scope = DEFAULT_SESSION_SCOPE, dirName) {
 	const persona = readPersonaSettings();
 	const personaOn = persona.mode !== "" && persona.overrideText.trim() !== "";
 	const parts = [
@@ -3449,12 +3584,18 @@ function serenitySystemPrompt(root, scope = DEFAULT_SESSION_SCOPE) {
 		metaphorBlock(),
 		principlesBlock(root, personaOn),
 		cceBlock(),
-		personaOn ? personaBlock(persona.mode, persona.overrideText) : eapBlock()
+		eapBlock()
 	];
+	if (personaOn) {
+		const expr = personaBlock(persona.mode, persona.overrideText);
+		if (expr !== "") parts.push(expr);
+	}
 	const state = [safeModeBlock(root), localstoreBlock(root)].filter((b) => b !== "").join("\n");
 	if (state) parts.push(state);
 	const skill = entrySkillSectionText(root);
 	if (skill) parts.push(skill);
+	const trajPrompt = dirName === void 0 ? "" : trajectoryPromptBlock(createTrajectoryPromptReader(root, dirName)());
+	if (trajPrompt !== "") parts.push(trajPrompt);
 	parts.push(toolsBlock());
 	const session = sessionBlock(root, scope);
 	if (session) parts.push(session);
@@ -3501,6 +3642,23 @@ function agentScope$2(context) {
 	return (context.agent?.session)?.id ?? "default";
 }
 /**
+* 该会话**绑定的轨迹目录名**（有 ⇒ 注入第 ⑧ 段「轨迹提示词」；无 ⇒ `undefined`，不注入）。
+*
+* 🔴 为什么用**目录名**而不是编码或 label：`PROMPT.md` 的落盘位置是目录，
+* 而编码只是目录名里的一段。用 label 拼路径 = 把模糊匹配当精确匹配用（本轨已踩过）。
+*
+* ⚠️ 每次装配都重读绑定（**不缓存**）：绑定切换后提示词必须立刻跟上，
+* 这与 `serenity-trajectory-skills` section 的口径一致（动态注入，owner 令 2026-09-20）。
+*/
+function boundDirNameFor(session) {
+	try {
+		const name = readLastBound(session)?.dirName;
+		return typeof name === "string" && name !== "" ? name : void 0;
+	} catch {
+		return;
+	}
+}
+/**
 * 全局注册系统提示词 section（osp system.transform 的 DSH 等价）。
 * text 回调按 context.agent 的 cwd 上溯 .serenity → 返回该 CCC 的完整注入文本；
 * 非 CCC / 无 agent 返回空（不注入）。
@@ -3515,9 +3673,7 @@ function registerEntrySkillSectionGlobal(ctx) {
 				if (!cwd) return "";
 				const root = cccRootForCwd(cwd);
 				if (!root) return "";
-				const scope = agentScope$2(context);
-				if (isSkiffSession(root, scope)) return "";
-				const base = serenitySystemPrompt(root, scope);
+				const base = serenitySystemPrompt(root, agentScope$2(context), boundDirNameFor(context.agent?.session));
 				const codeLine = codeModeAdaptationLine(ctx, context.scope);
 				return codeLine ? `${base}\n${codeLine}` : base;
 			}
@@ -3549,8 +3705,7 @@ function registerEntrySkillSection(agent, root) {
 			name: "serenity-entry",
 			order: -50,
 			text: (context) => {
-				if (isSkiffSession(root, scope)) return "";
-				const base = serenitySystemPrompt(root, scope);
+				const base = serenitySystemPrompt(root, scope, boundDirNameFor(agent.session));
 				const codeLine = codeModeAdaptationLine(agent.ctx, context.scope);
 				return codeLine ? `${base}\n${codeLine}` : base;
 			}
@@ -3903,7 +4058,10 @@ async function createSkiffAgent(ctx, root, profile, defaultModel, sessionId) {
 		agent.ctx.systemPrompt.section({
 			name: "serenity-skiff",
 			order: -60,
-			text: () => [buildSkiffBasePrompt(profile.code), livePrompt()].filter(Boolean).join("\n")
+			text: () => {
+				const legacy = hasTrajectoryPrompt(root, profile.dirName) ? "" : livePrompt();
+				return [buildSkiffBasePrompt(profile.code), legacy].filter(Boolean).join("\n");
+			}
 		});
 	} catch (err) {
 		console.warn(`[serenity-hooks] skiff 系统提示词注册失败: ${String(err?.message ?? err)}`);
@@ -12671,11 +12829,14 @@ function validateSkiffConfig(root) {
 	const hc = readCheapWorkerConfig(root);
 	const allowedModels = hc ? new Set(hc.models) : null;
 	for (const p of profiles) {
-		try {
-			if (!resolveProfileSystemPrompt(root, p).trim()) issues.push(`trajectory "${p.code}": system prompt is empty (define systemPromptFile (recommended) or systemPrompt)`);
-		} catch (err) {
-			issues.push(`trajectory "${p.code}": ${String(err?.message ?? err)}`);
-		}
+		if (!(hasTrajectoryPrompt(root, p.dirName) || (() => {
+			try {
+				return resolveProfileSystemPrompt(root, p).trim() !== "";
+			} catch (err) {
+				issues.push(`trajectory "${p.code}": ${String(err?.message ?? err)}`);
+				return true;
+			}
+		})())) issues.push(`trajectory "${p.code}": no trajectory prompt (add ${TRAJECTORY_PROMPT_FILENAME} in the trajectory dir — recommended — or the legacy systemPromptFile/systemPrompt)`);
 		for (const m of p.msms) if (!registered.has(m)) issues.push(`trajectory "${p.code}": msms "${m}" is not registered in mech-registry.json`);
 		if (p.model && allowedModels && !allowedModels.has(p.model)) issues.push(`trajectory "${p.code}": model "${p.model}" not in cheap-worker.models (${[...allowedModels].join(", ") || "(none)"})`);
 	}
@@ -15413,11 +15574,11 @@ function registerStatusApi(ctx, opts = {}) {
 						sendJson$3(res, 400, { error: chk.error });
 						return;
 					}
-					const { readWeixinSettings } = await import("./route-CPneN5iv.js").then((n) => n.s);
+					const { readWeixinSettings } = await import("./route-f7JlinIt.js").then((n) => n.s);
 					const { weixinBridgeStatus } = await Promise.resolve().then(() => bridge_exports);
 					const settings = readWeixinSettings(chk.root);
 					const bridge = weixinBridgeStatus().find((b) => b.ccc === chk.root);
-					const { readWeixinCredential } = await import("./route-CPneN5iv.js").then((n) => n.s);
+					const { readWeixinCredential } = await import("./route-f7JlinIt.js").then((n) => n.s);
 					const accounts = (settings.accounts ?? []).map((a) => ({
 						accountId: a.accountId,
 						name: a.name ?? void 0,
@@ -15449,7 +15610,7 @@ function registerStatusApi(ctx, opts = {}) {
 					const { fetchQRCode } = await import("./ilink-DEpmE3yi.js").then((n) => n.a);
 					const { randomUUID } = await import("node:crypto");
 					for (const [key, v] of weixinLogins) if (Date.now() - v.startedAt > WEIXIN_LOGIN_TTL_MS) weixinLogins.delete(key);
-					const { readWeixinSettings } = await import("./route-CPneN5iv.js").then((n) => n.s);
+					const { readWeixinSettings } = await import("./route-f7JlinIt.js").then((n) => n.s);
 					const qr = await fetchQRCode({ botType: readWeixinSettings(root).botType ?? void 0 });
 					const loginKey = randomUUID();
 					weixinLogins.set(loginKey, {
@@ -15470,7 +15631,7 @@ function registerStatusApi(ctx, opts = {}) {
 						sendJson$3(res, 400, { error: "missing accountId" });
 						return;
 					}
-					const { removeWeixinAccount } = await import("./route-CPneN5iv.js").then((n) => n.s);
+					const { removeWeixinAccount } = await import("./route-f7JlinIt.js").then((n) => n.s);
 					const { syncCccBridge } = await Promise.resolve().then(() => bridge_exports);
 					removeWeixinAccount(root, body.accountId);
 					syncCccBridge(ctx, root);
@@ -15496,7 +15657,7 @@ function registerStatusApi(ctx, opts = {}) {
 							trajectory: code
 						});
 					}
-					const { saveWeixinRoutes } = await import("./route-CPneN5iv.js").then((n) => n.s);
+					const { saveWeixinRoutes } = await import("./route-f7JlinIt.js").then((n) => n.s);
 					const { findDirNameByCode } = await import("./profile-DyMJ_bfr.js").then((n) => n.i);
 					for (const r of routes) if (findDirNameByCode(root, r.trajectory) === null) {
 						sendJson$3(res, 400, { error: `unknown trajectory: ${r.trajectory} (no such trajectory code in ${root})` });
@@ -15508,7 +15669,7 @@ function registerStatusApi(ctx, opts = {}) {
 				}
 				if (body.action === "set-enabled") {
 					const enabled = body.enabled === true;
-					const { readWeixinSettings, setWeixinEnabled } = await import("./route-CPneN5iv.js").then((n) => n.s);
+					const { readWeixinSettings, setWeixinEnabled } = await import("./route-f7JlinIt.js").then((n) => n.s);
 					const { syncCccBridge } = await Promise.resolve().then(() => bridge_exports);
 					const settings = readWeixinSettings(root);
 					if (enabled && (settings.accounts ?? []).length === 0) {
@@ -15552,7 +15713,7 @@ function registerStatusApi(ctx, opts = {}) {
 					return;
 				}
 				const { pollQRStatus } = await import("./ilink-DEpmE3yi.js").then((n) => n.a);
-				const { readWeixinSettings } = await import("./route-CPneN5iv.js").then((n) => n.s);
+				const { readWeixinSettings } = await import("./route-f7JlinIt.js").then((n) => n.s);
 				const settings = readWeixinSettings(login.root);
 				const status = await pollQRStatus({
 					baseUrl: void 0,
@@ -15567,7 +15728,7 @@ function registerStatusApi(ctx, opts = {}) {
 							});
 							return;
 						}
-						const { upsertWeixinAccount, writeWeixinCredential, nextWeixinAccountId } = await import("./route-CPneN5iv.js").then((n) => n.s);
+						const { upsertWeixinAccount, writeWeixinCredential, nextWeixinAccountId } = await import("./route-f7JlinIt.js").then((n) => n.s);
 						const { syncCccBridge } = await Promise.resolve().then(() => bridge_exports);
 						const accountId = nextWeixinAccountId(settings);
 						upsertWeixinAccount(login.root, {
@@ -20721,6 +20882,105 @@ function invokeWeixinHook(root, hookRel, event) {
 	return activeRunner(root, hookRel, event);
 }
 //#endregion
+//#region src/im/accounts.ts
+const impls = /* @__PURE__ */ new Map();
+/** 注册账号实现（`index.ts` 装配时调用；重复 channel 覆盖——测试与热重载友好） */
+function registerImAccountImpl(impl) {
+	impls.set(impl.channel, impl);
+}
+/** 取实现（未注册 ⇒ `null`，由调用方**响亮出声**，不要静默跳过） */
+function getImAccountImpl(channel) {
+	return impls.get(channel) ?? null;
+}
+/** 已注册的实现名（诊断与错误文案用；顺序 = 注册顺序） */
+function imAccountChannels() {
+	return [...impls.keys()];
+}
+/**
+* 账号行的渠道归一（**单一处**）。
+*
+* 缺省 `weixin`：老配置平移到 `im` 段时不必补这个字段——owner 的"统一配置"
+* 要能直接吃旧数据（与 `route.ts` 的 `normalizeImSection` 保持同一口径）。
+*/
+function normalizeAccountChannel(channel) {
+	const v = (channel ?? "").trim();
+	return v === "" ? "weixin" : v;
+}
+//#endregion
+//#region src/im/weixin-account.ts
+/** 轮询间隔（getupdates 失败后重试；成功 = 立即续，长轮询本身 hold 35s） */
+const POLL_RETRY_MS = 3e3;
+/**
+* 微信的凭据就绪判据：**有 token** 才算绑定（baseUrl 留空 = 走官方默认）。
+* 与既有装配处逐字同义（原 `if (token === '') { …跳过… }`）。
+*/
+function weixinCredentialReady(cred) {
+	return typeof cred.token === "string" && cred.token.trim() !== "";
+}
+let deps = null;
+/** 装配时注入依赖（`bridge.ts` 在模块初始化末尾调用一次；见 `installWeixinAccountImpl`） */
+function setWeixinLoopDeps(d) {
+	deps = d;
+}
+/** 单账号轮询循环（**函数体逐字照搬自 bridge.ts 的 `runAccountLoop`，仅改类型与依赖来源**） */
+async function runWeixinAccountLoop(input, loop) {
+	if (!deps) {
+		loop.lastError = "weixin 实现未注入依赖（装配顺序错误）";
+		return;
+	}
+	const d = deps;
+	const ctx = input.ctx;
+	const cred = input.cred;
+	let buf = "";
+	while (!loop.stopped) {
+		loop.lastPollAt = Date.now();
+		try {
+			const resp = await d.getUpdates({
+				baseUrl: cred.baseUrl,
+				token: cred.token,
+				getUpdatesBuf: buf,
+				timeoutMs: 35e3
+			});
+			buf = resp.get_updates_buf ?? buf;
+			for (const msg of resp.msgs ?? []) {
+				if (loop.stopped) break;
+				if (msg.message_type !== 1) continue;
+				if (input.machine) await d.handleMachineIncoming(ctx, input.accountId, cred, msg);
+				else await d.handleIncoming(ctx, input.root, input.accountId, cred, msg);
+			}
+		} catch (err) {
+			loop.lastError = err instanceof Error ? err.message : String(err);
+			await new Promise((r) => setTimeout(r, POLL_RETRY_MS));
+		}
+	}
+}
+/** 微信账号实现（登记的 channel 名 = `weixin`；与配置里的取值一致） */
+const weixinAccountImpl = {
+	channel: "weixin",
+	isReady: weixinCredentialReady,
+	notReadyReason: () => "**无 token**（未绑定）",
+	startLoop(input) {
+		const loop = {
+			stopped: false,
+			lastPollAt: 0
+		};
+		runWeixinAccountLoop(input, loop);
+		return loop;
+	}
+};
+/**
+* 注册微信实现**并注入依赖**（`bridge.ts` 调用；幂等——重复注册覆盖同名 channel）。
+*
+* ⚠️ 必须在首次 `syncHumanChannel` / `syncCccBridge` **之前**发生。
+* `bridge.ts` 在**模块求值时**调用它一次（不是等到 `registerWeixinBridge`）——
+* 因为测试与面板会**直接**调 `syncCccBridge`，那时装配入口还没跑过；
+* 若依赖装配入口注册，那些路径会全部走进"未实现"分支（本轮实测：12 例红，根因就是它）。
+*/
+function installWeixinAccountImpl(d) {
+	setWeixinLoopDeps(d);
+	registerImAccountImpl(weixinAccountImpl);
+}
+//#endregion
 //#region src/im/bridge.ts
 var bridge_exports = /* @__PURE__ */ __exportAll({
 	handleIncoming: () => handleIncoming,
@@ -20747,8 +21007,6 @@ const bridges = /* @__PURE__ */ new Map();
 const MACHINE_SCOPE = "<machine>";
 /** 机器级 poller（账号 id → 循环）。与 `bridges` **互斥**：同一时刻只有一种模式在跑。 */
 const machineLoops = /* @__PURE__ */ new Map();
-/** 轮询间隔（getupdates 失败后重试延迟；成功 = 立即续轮询） */
-const POLL_RETRY_MS = 3e3;
 /** 媒体大小上限（M6：20MB，对齐 vlm-describe；超限降级告知不落盘） */
 const MEDIA_MAX_BYTES = 20971520;
 /** typing_ticket 缓存（每 (accountId, fromUserId)；getconfig 一次后续复用——对齐参考实现 typingTicketCache） */
@@ -20799,31 +21057,16 @@ async function sendTypingStop(cred, accountId, fromUserId) {
 		console.log(`[serenity-hooks] weixin-bridge typing stop skipped: ${err instanceof Error ? err.message : String(err)}`);
 	}
 }
-/** 单账号轮询循环：getupdates 长轮询 → 逐消息分发 → 回复回写 */
-async function runAccountLoop(ctx, root, accountId, cred, loop, machine = false) {
-	let buf = "";
-	while (!loop.stopped) {
-		loop.lastPollAt = Date.now();
-		try {
-			const resp = await getUpdates({
-				baseUrl: cred.baseUrl,
-				token: cred.token,
-				getUpdatesBuf: buf,
-				timeoutMs: 35e3
-			});
-			buf = resp.get_updates_buf ?? buf;
-			for (const msg of resp.msgs ?? []) {
-				if (loop.stopped) break;
-				if (msg.message_type !== 1) continue;
-				if (machine) await handleMachineIncoming(ctx, accountId, cred, msg);
-				else await handleIncoming(ctx, root, accountId, cred, msg);
-			}
-		} catch (err) {
-			loop.lastError = err instanceof Error ? err.message : String(err);
-			await new Promise((r) => setTimeout(r, POLL_RETRY_MS));
-		}
-	}
-}
+/**
+* 🔴 **2026-10-19（P2）`runAccountLoop` 已迁出本文件** —— 逐字搬到
+* `im/weixin-account.ts`，成为 `ImAccountImpl` 的一个实现（微信）。
+*
+* 为什么搬：装配处原先把渠道写死在这里（`channel !== 'weixin'` ⇒ 跳过）。
+* owner 定向「飞书和微信一样，只不过是 account 方实现不同」⇒ 起循环这个动作
+* 归**账号自己的实现**，装配处只按 `channel` 查派发表。
+* ⚠️ 依赖（`getUpdates` / `handleIncoming` / `handleMachineIncoming`）通过
+* `installWeixinAccountImpl` **注入**，避免 `bridge ⇄ weixin-account` 互相 import 成环。
+*/
 /**
 * 手动输出模式的**机制标记**（v1.30.10 引入；v1.30.16 按 S142 用户"这个词不能让 ACC 定义，
 * 要让 CCC 定义"重构）。
@@ -21225,10 +21468,23 @@ function syncCccBridge(ctx, root) {
 	if (!settings.enabled) return;
 	const requests = [];
 	const creds = /* @__PURE__ */ new Map();
+	/** 账号 id → 它的实现（P2：按 `channel` 查派发表） */
+	const implByAccount = /* @__PURE__ */ new Map();
 	for (const account of settings.accounts ?? []) {
 		if (account.enabled === false) continue;
+		const channel = normalizeAccountChannel(account.channel);
+		const impl = getImAccountImpl(channel);
+		if (!impl) {
+			if (!warnedChannels.has(`${account.accountId}:${channel}`)) {
+				warnedChannels.add(`${account.accountId}:${channel}`);
+				console.warn(`[serenity-hooks] ⚠ weixin-bridge: 账号 ${account.accountId}（ccc=${root}）的渠道 "${channel}" **本机未实现** ⇒ 不起循环（已实现：${imAccountChannels().join(", ") || "(无)"}）`);
+			}
+			continue;
+		}
 		const cred = readWeixinCredential(root, account.accountId);
 		if (!cred) continue;
+		if (!impl.isReady(cred)) continue;
+		implByAccount.set(account.accountId, impl);
 		creds.set(account.accountId, cred);
 		requests.push({
 			root,
@@ -21244,13 +21500,16 @@ function syncCccBridge(ctx, root) {
 	};
 	for (const claim of plan.claims) {
 		const cred = creds.get(claim.accountId);
-		if (!cred) continue;
-		const loop = {
-			stopped: false,
-			lastPollAt: 0
-		};
+		const impl = implByAccount.get(claim.accountId);
+		if (!cred || !impl) continue;
+		const loop = impl.startLoop({
+			ctx,
+			root,
+			accountId: claim.accountId,
+			cred,
+			machine: false
+		});
 		bridge.loops.set(claim.accountId, loop);
-		runAccountLoop(ctx, root, claim.accountId, cred, loop);
 	}
 	commitPollerClaims(plan);
 	if (bridge.loops.size > 0) {
@@ -21301,6 +21560,8 @@ function syncMachinePollers(ctx, hc) {
 	stopCccBridges();
 	const requests = [];
 	const creds = /* @__PURE__ */ new Map();
+	/** 账号 id → 它的实现（P2：**按 `channel` 查派发表**，不再写死 weixin） */
+	const implByAccount = /* @__PURE__ */ new Map();
 	for (const account of hc.accounts) {
 		const id = account.id;
 		if (account.enabled === false) continue;
@@ -21308,23 +21569,27 @@ function syncMachinePollers(ctx, hc) {
 			console.warn("[serenity-hooks] ⚠ human-channel: 机器级账号表有一行**缺 `id`** ⇒ 跳过（该行无法被订阅表引用）");
 			continue;
 		}
-		if (account.channel !== "weixin") {
-			if (!warnedChannels.has(`${id}:${account.channel ?? ""}`)) {
-				warnedChannels.add(`${id}:${account.channel ?? ""}`);
-				console.warn(`[serenity-hooks] ⚠ human-channel: 账号 ${id} 的渠道 "${account.channel ?? "(未填)"}" **本机未实现** ⇒ 不起 poller（当前只有 weixin）`);
+		const channel = normalizeAccountChannel(account.channel);
+		const impl = getImAccountImpl(channel);
+		if (!impl) {
+			if (!warnedChannels.has(`${id}:${channel}`)) {
+				warnedChannels.add(`${id}:${channel}`);
+				console.warn(`[serenity-hooks] ⚠ human-channel: 账号 ${id} 的渠道 "${account.channel ?? "(未填)"}" **本机未实现** ⇒ 不起 poller（已实现：${imAccountChannels().join(", ") || "(无)"}）`);
 			}
 			continue;
 		}
 		const token = (account.token ?? "").trim();
-		if (token === "") {
-			console.warn(`[serenity-hooks] ⚠ human-channel: 账号 ${id} **无 token**（未绑定）⇒ 不起 poller`);
-			continue;
-		}
-		creds.set(id, {
+		const cred = {
 			token,
 			baseUrl: "",
 			userId: account.userId
-		});
+		};
+		if (!impl.isReady(cred)) {
+			console.warn(`[serenity-hooks] ⚠ human-channel: 账号 ${id} ${impl.notReadyReason?.(cred) ?? "**凭据不全**"} ⇒ 不起 poller`);
+			continue;
+		}
+		implByAccount.set(id, impl);
+		creds.set(id, cred);
 		requests.push({
 			root: MACHINE_SCOPE,
 			accountId: id,
@@ -21336,13 +21601,16 @@ function syncMachinePollers(ctx, hc) {
 	stopMachineLoops();
 	for (const claim of plan.claims) {
 		const cred = creds.get(claim.accountId);
-		if (!cred) continue;
-		const loop = {
-			stopped: false,
-			lastPollAt: 0
-		};
+		const impl = implByAccount.get(claim.accountId);
+		if (!cred || !impl) continue;
+		const loop = impl.startLoop({
+			ctx,
+			root: MACHINE_SCOPE,
+			accountId: claim.accountId,
+			cred,
+			machine: true
+		});
 		machineLoops.set(claim.accountId, loop);
-		runAccountLoop(ctx, MACHINE_SCOPE, claim.accountId, cred, loop, true);
 	}
 	commitPollerClaims(plan);
 	if (machineLoops.size > 0) console.log(`[serenity-hooks] ✓ human-channel: 机器级 poller accounts=${[...machineLoops.keys()].join(",")}（与 CCC 无关）`);
@@ -21494,6 +21762,26 @@ function registerWeixinBridge(ctx) {
 		ctx.on("session/created", () => syncHumanChannel(ctx));
 	} catch {}
 }
+/**
+* 🔴 **P2 装配：微信实现登记进"账号实现派发表"**（模块求值时执行，不是等 `apply`）。
+*
+* ## 为什么必须在模块求值时做（本轮实测教训）
+*
+* 首版把这句放在 `registerWeixinBridge` 里 ⇒ 全量测试 **12 例红**，报的全是
+* 「`weixinBridgeStatus()` 空数组」。根因：测试与设置面板会**直接**调 `syncCccBridge` /
+* `syncHumanChannel`，那时装配入口还没跑过 ⇒ 派发表是空的 ⇒ 每条账号都走进
+* 「渠道未实现」分支（那分支是给**真正**未实现的渠道用的）。
+*
+* ⇒ 判据：**"谁能被调"决定"注册要在哪儿发生"**，不能按"装配流程"想当然。
+*
+* 注入的是本模块自己的函数（`getUpdates` / `handleIncoming` / `handleMachineIncoming`）——
+* 不需要 `weixin-account.ts import 回 bridge.ts`，避免两个文件互相 import 成环。
+*/
+installWeixinAccountImpl({
+	getUpdates,
+	handleIncoming,
+	handleMachineIncoming
+});
 //#endregion
 //#region src/im/send.ts
 /** 请求体上限（文本消息远小于此；防滥用） */

package/lib/kernel/ccc.d.ts

@@ -136,6 +136,12 @@ interface SerenityConfig {
      * 未配置或 enabled=false → 该 CCC 桥完全不启动（零资源占用）。
      */
     weixin?: WeixinSettings;
+    /**
+     * 🔴 **统一 IM 配置（2026-10-19，owner 定向）**：微信与飞书**只是账号实现不同**，
+     * 配置整合到这一段。存在且 `accounts` 是数组 ⇒ 优先于旧 `weixin` 段。
+     * 见 `ImSettings` 的注释（含"为什么判据不是'段存在'"的坑）。
+     */
+    im?: ImSettings;
     /**
      * 专属工具声明（v1.33，S142 §32.11）：**ACC 注册但默认对所有 CCC 隐藏**的工具，
      * 只有在自己这里声明的 CCC 可见（例：`["acc-diag"]` = ACC 负责人的运行态诊断）。
@@ -145,6 +151,73 @@ interface SerenityConfig {
      */
     exclusiveTools?: string[];
 }
+/**
+ * 🔴 **统一 IM 配置（2026-10-19 owner 定向：「飞书和微信一样，只不过是 account 方实现不同。
+ * 要整合到统一的配置中」）。**
+ *
+ * ## 为什么是"账号"这一层，不是"通道"这一层
+ *
+ * 微信与飞书的差别**只在账号侧**：怎么连、怎么收、怎么发。而它们的**身份、路由、会话**
+ * 从来就是通道无关的（`routes: user → 轨迹编码`；会话 id 由轨迹编码派生）。
+ * ⇒ 抽象点是 `account.channel`（这个字段本来就有，装配处也早写着"等第二个实现"），
+ * 不是新造一个平行的"通道接口"。
+ *
+ * ## 与旧 `weixin` 段的关系（向后兼容是硬要求）
+ *
+ * - `im` 段**存在且 `accounts` 是数组** ⇒ 用它；
+ * - 否则 ⇒ **回退读旧 `weixin` 段**（存量 CCC 零迁移，行为逐字不变）。
+ * - 旧段**不删不改**：回滚 = 删掉 `im` 段即可。
+ *
+ * 🔴 **为什么判据是「`accounts` 是数组」而不是「有没有 im 段」**：
+ * 本 CCC 的配置里**曾经**有过一个 `im` 段（退役的 ACP：`{channel:"acp", acp:{…}}`）。
+ * 若只判"段存在"，那份残留会被当成新配置读 ⇒ **读到一个没有 accounts 的对象** ⇒
+ * 表现为"配置没生效"且**不报错**。⇒ 形状判据必须能区分这两种 `im`。
+ */
+export interface ImSettings {
+    /** 总开关（缺省 false——未开零资源占用） */
+    enabled?: boolean;
+    /** 账号表：**每条账号自带 `channel`**（`weixin` / `feishu`），凭据在 localstore */
+    accounts?: ImAccountConfig[];
+    /** 消息路由：**通道用户 id → 认知轨迹编码**（通道无关；`*` 通配兜底） */
+    routes?: ImRouteConfig[];
+    /** 用户别名表：`{ "<别名>": "<localstore 凭据键>" }` */
+    aliases?: Record<string, string>;
+    /** 消息记录 hook（相对 CCC 根的脚本路径） */
+    hook?: string;
+    /** 桥是否自动回发 agent 的最终文本（缺省 true；微信侧语义见旧注释） */
+    autoReplyWithLastMessage?: boolean;
+    /** 手动输出模式的兜底（缺省 false = 严格静默） */
+    fallbackOnNoSend?: boolean;
+    /** iLink 专属：bot_type 取码参数（飞书账号忽略它） */
+    botType?: string;
+}
+/** 统一账号配置：**`channel` 决定用哪个实现**；其余字段各实现自查 */
+export interface ImAccountConfig {
+    /** 本地唯一键（如 wechat-1 / feishu-1） */
+    accountId: string;
+    /**
+     * 账号实现（缺省 `weixin`——旧配置平移到 `im` 段时不必补这个字段）。
+     * 未实现的 channel ⇒ **出声但不静默跳过**（装配处已有该分支）。
+     */
+    channel?: string;
+    /** 展示名（可选） */
+    name?: string;
+    /** 该账号开关（缺省 true） */
+    enabled?: boolean;
+}
+/**
+ * 统一路由配置：**通道用户 id → 认知轨迹编码**。
+ *
+ * 与旧 `WeixinRouteConfig` 语义完全相同（那是它的超集形态）；保留别名仅为读侧兼容。
+ */
+export interface ImRouteConfig {
+    /** 通道用户 id（微信 `xxx@im.wechat` / 飞书 `open_id`）；`*` = 通配兜底 */
+    user: string;
+    /** 目标认知轨迹编码 */
+    trajectory: string;
+    /** @deprecated 过渡别名（语义等同 `trajectory`） */
+    role?: string;
+}
 /**
  * 微信桥配置（CCC 级；S142 用户拍板）：
  * - 结构/路由/开关在 .opencode/serenity.json（git 管可重建）
@@ -152,6 +225,9 @@ interface SerenityConfig {
  *   扫码登录后插件自动写入（面板只显示"已绑定"），永不进 git 明文面
  * - 路由 user → role：exact 匹配优先，通配 `*` 兜底；role 必须是该 CCC skiff.roles 之一
  * - 多账号：accounts[] 每项 { accountId, name?, enabled }（本地唯一键，如 wechat-1）
+ *
+ * 🔴 2026-10-19：**本段已被统一 `im` 段取代**（见上方 `ImSettings`）。此处保留是因为
+ * 存量 CCC 的配置里写的就是它——读侧继续认，**不强制迁移**。
  */
 export interface WeixinSettings {
     /** 总开关（缺省 false——默认关，未开零资源占用） */

package/lib/{route-CPneN5iv.js → route-f7JlinIt.js}

@@ -302,6 +302,7 @@ var route_exports = /* @__PURE__ */ __exportAll({
 	hasVoiceItem: () => hasVoiceItem,
 	matchWeixinRoute: () => matchWeixinRoute,
 	nextWeixinAccountId: () => nextWeixinAccountId,
+	readImSettings: () => readImSettings,
 	readWeixinCredential: () => readWeixinCredential,
 	readWeixinSettings: () => readWeixinSettings,
 	removeWeixinAccount: () => removeWeixinAccount,
@@ -367,43 +368,88 @@ function routeTarget(row) {
 	return "";
 }
 /**
-* 读取 CCC 微信桥配置（未配置/未启用 → 归一默认）。
-* @returns 归一化 WeixinSettings（accounts/routes 数组清洗；空段 → 空数组）
+* **统一 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 出声但不静默跳过"）。
 */
-function readWeixinSettings(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+function readImSettings(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	const empty = () => ({
+		enabled: false,
+		accounts: [],
+		routes: []
+	});
 	try {
-		const w = loadSerenityConfig(root, paths).weixin;
-		if (!w || typeof w !== "object") return {
-			enabled: false,
-			accounts: [],
-			routes: []
-		};
-		return {
-			enabled: w.enabled === true,
-			botType: typeof w.botType === "string" && w.botType !== "" ? w.botType : void 0,
-			hook: typeof w.hook === "string" && w.hook.trim() !== "" ? w.hook.trim() : void 0,
-			autoReplyWithLastMessage: w.autoReplyWithLastMessage !== false,
-			fallbackOnNoSend: w.fallbackOnNoSend === true,
-			accounts: Array.isArray(w.accounts) ? w.accounts.filter((a) => typeof a === "object" && a !== null && typeof a.accountId === "string" && a.accountId !== "").map((a) => ({
-				accountId: a.accountId,
-				name: typeof a.name === "string" ? a.name : void 0,
-				enabled: a.enabled !== false
-			})) : [],
-			routes: Array.isArray(w.routes) ? w.routes.filter((r) => typeof r === "object" && r !== null && typeof r.user === "string" && r.user !== "" && typeof routeTarget(r) === "string").map((r) => ({
-				user: r.user,
-				trajectory: routeTarget(r)
-			})) : [],
-			aliases: readAliases(w)
-		};
+		const cfg = loadSerenityConfig(root, paths);
+		const unified = cfg.im;
+		if (isUnifiedImSection(unified)) return normalizeImSection(unified, empty());
+		const legacy = cfg.weixin;
+		if (!legacy || typeof legacy !== "object") return empty();
+		return normalizeImSection(legacy, empty());
 	} catch {
-		return {
-			enabled: false,
-			accounts: [],
-			routes: []
-		};
+		return empty();
 	}
 }
 /**
+* 判别一个 `im` 段是不是**新的统一形态**。
+*
+* 判据 = `accounts` 是数组 **且** 每行（若有）不带退役 ACP 的 `accountId` 之外的 ACP 形状；
+* 退役 ACP 形态的特征是顶层有 `channel:"acp"` 或 `acp` 对象。
+* ⇒ 两者**任一命中**即判为"退役残留"，不认。
+*/
+function isUnifiedImSection(v) {
+	if (!v || typeof v !== "object" || Array.isArray(v)) return false;
+	const obj = v;
+	if (obj.acp !== void 0 && (typeof obj.acp === "object" || typeof obj.acp === "string")) return false;
+	if (obj.channel === "acp") return false;
+	return Array.isArray(obj.accounts);
+}
+/** 段 → 归一形态（统一段与旧段**共用同一套归一语义**，避免两条读法各漂） */
+function normalizeImSection(w, d) {
+	const src = w;
+	const accountsIn = Array.isArray(src.accounts) ? src.accounts : [];
+	return {
+		enabled: src.enabled === true,
+		botType: typeof src.botType === "string" && src.botType !== "" ? src.botType : void 0,
+		hook: typeof src.hook === "string" && src.hook.trim() !== "" ? src.hook.trim() : void 0,
+		autoReplyWithLastMessage: src.autoReplyWithLastMessage !== false,
+		fallbackOnNoSend: src.fallbackOnNoSend === true,
+		accounts: accountsIn.filter((a) => typeof a === "object" && a !== null && typeof a.accountId === "string" && a.accountId !== "").map((a) => ({
+			accountId: a.accountId,
+			channel: typeof a.channel === "string" && a.channel.trim() !== "" ? a.channel.trim() : "weixin",
+			name: typeof a.name === "string" ? a.name : void 0,
+			enabled: a.enabled !== false
+		})),
+		routes: Array.isArray(src.routes) ? src.routes.filter((r) => typeof r === "object" && r !== null && typeof r.user === "string" && r.user !== "" && typeof routeTarget(r) === "string").map((r) => ({
+			user: r.user,
+			trajectory: routeTarget(r)
+		})) : [],
+		aliases: readAliases(src)
+	};
+}
+/**
+* 读取 CCC 微信桥配置（未配置/未启用 → 归一默认）。
+*
+* ⚠️ 2026-10-19 起它是 {@link readImSettings} 的**薄别名**（签名与返回形状不变）：
+* 旧调用点无需改动，但**配置来源已经统一**——`im` 段优先、`weixin` 段回退。
+* 保留名字是为了让既有调用点与测试**逐字不动**（P1 是纯重构，读数必须不变）。
+*/
+function readWeixinSettings(root, paths = DEFAULT_SERENITY_CONFIG_PATHS) {
+	return readImSettings(root, paths);
+}
+/**
 * 别名表清洗（v1.56.10）：键归一为小写、值必须是非空字符串；非法项静默丢弃。
 * 空/缺省 → `{}`（此时别名解析不可用，只能用裸 iLink 用户 id）。
 */

package/lib/seams/system-prompt.d.ts

@@ -109,7 +109,9 @@ export declare function sessionBlock(root: string, scope?: string): string;
  * Principles 剥离 MSM 原则段（指令遵循约束）——用户文本承接两处风格；本体论/关系段/
  * 操作边界（安全硬约束）永远保留。未配置 → 与 v1.23.0 逐字节一致（零影响）。
  */
-export declare function serenitySystemPrompt(root: string, scope?: string): string;
+export declare function serenitySystemPrompt(root: string, scope?: string, 
+/** 活跃轨迹目录名（给了才有第 ⑧ 段；未绑定轨迹 ⇒ undefined，不注入） */
+dirName?: string): string;
 /**
  * Code Mode 适配行：当前 scope 以 Code Mode 呈现工具时（run_code 可见），
  * ACC 块按 native 语义指引"直接调用工具"会与"只有 run_code 可直接调用"的执行

package/lib/trajectory/prompt.d.ts

@@ -0,0 +1,101 @@
+/**
+ * trajectory/prompt.ts — **轨迹提示词**（Trajectory Prompt）：一条轨迹"是谁、按什么章程工作"
+ *
+ * ## 概念（owner 2026-10-19 定向，逐字）
+ *
+ * > 「参考会话的系统提示词，我们建立**轨迹提示词**概念来代替人格。架构上会好很多」
+ *
+ * **轨迹提示词** = 一条认知轨迹的**可编辑章程声明**，由 ACC 按固定顺序装配进系统提示词。
+ * 三个关键词各是一条判据：
+ * - **可编辑**：住在 CCC（盘上），改它**不发版**（D23 归属判据的直接推论）
+ * - **声明**：它声明**身份／章程／方法论**，**不声明能力**（能力面归 `skiff.json` 白名单与工具 schema）
+ * - **固定顺序**：装配顺序由 ACC 定死（见 `seams/system-prompt.ts` 的 ⑧ 位）
+ *
+ * ## 为什么取代「人格」
+ *
+ * 「人格」把身份绑在"像不像一个人"上 ⇒ 因为叫人格，它被设计成**可以整体替换**
+ * （`persona` 置换 EAP 块，即 review F-05/R-14 那个悬置冲突）。而身份与章程**不该被替换，
+ * 只该被特化**。⇒ 本模块把"替换"改成"叠加"：容器层与质量层永远保留，轨迹提示词只往上加。
+ *
+ * ## 落点（为什么在轨迹目录里）
+ *
+ * `AGENT_SESSIONS/<轨迹目录>/PROMPT.md`
+ *
+ * - **跟着轨迹走**：`archive` 时整个目录搬走，章程不会掉队（旧形态 `.opencode/skiff/<name>.md`
+ *   与轨迹**分居两处** —— 多条轨迹共用一份文件正是那个后果）。
+ * - **每条轨迹都能有**：不只是 skiff。普通轨迹同样需要"我是谁、按什么章程"。
+ * - 与 `SESSION.md`（身体：延续/日志）、`skiff.json`（约束面：能力）三件并列，
+ *   各管一件事，不合并（合并会让"改能力"与"改身份"互相牵连）。
+ *
+ * ## 兼容（不静默坏）
+ *
+ * `PROMPT.md` 不存在时**不报错**（普通轨迹常态）。skiff 的旧字段 `systemPromptFile`
+ * 在兼容期仍被读取——优先级见 {@link resolveTrajectoryPrompt}。
+ */
+import type { SkiffProfile } from '../role/skiff/profile.js';
+/** 轨迹提示词的固定文件名（**判据就是它存在**——不是目录名前缀，也不是配置里的一行） */
+export declare const TRAJECTORY_PROMPT_FILENAME = "PROMPT.md";
+/** 一次解析的结果（`source` 说明正文**从哪来**，便于诊断与「为什么我改的不生效」） */
+export interface TrajectoryPromptResolution {
+    /** 提示词正文（已 trim）；无来源 ⇒ 空串 */
+    text: string;
+    /** 来源：轨迹目录的 PROMPT.md ／ skiff 旧字段 ／ 无 */
+    source: 'trajectory-file' | 'skiff-legacy' | 'none';
+    /** 实际读取的绝对路径（`none` ⇒ null） */
+    path: string | null;
+}
+/** 轨迹目录的 PROMPT.md 绝对路径（不论存在与否——调用方自己判存在性） */
+export declare function trajectoryPromptPath(root: string, dirName: string): string;
+/**
+ * 该轨迹**有没有**轨迹提示词（单一判据）。
+ *
+ * 用途：兼容期的"让位"判定 —— 若已有 `PROMPT.md`，skiff 旧字段 `systemPromptFile`
+ * 必须**让位**，否则同一份章程会在两处各注入一遍（第 ⑧ 段 ＋ `serenity-skiff` 段）。
+ * 🔴 判据只有这一处：别在 skiff 那边自己拼路径再判（两处会漂）。
+ */
+export declare function hasTrajectoryPrompt(root: string, dirName: string): boolean;
+/**
+ * 解析一条轨迹的**轨迹提示词**（一次性读；`create` / 诊断 / 预览用）。
+ *
+ * 🔴 热路径**不要**用它（那会每次工具调用都读盘）——热路径用 {@link createTrajectoryPromptReader}。
+ *
+ * 优先级（**确定性，只有这一条**）：
+ *   ① `<轨迹目录>/PROMPT.md` —— 新形态，**所有轨迹**都能有
+ *   ② skiff 的 `systemPromptFile` —— **兼容期**旧形态（存量 CCC 不必同批迁移）
+ *   ③ 无 ⇒ 空串（**不是错误**：没有章程的轨迹是常态）
+ *
+ * ⚠️ 读失败（权限/坏文件）⇒ 空串而不是抛错：提示词读不到不该阻断会话创建；
+ * 但**会告警**（见 reader 版本），不静默。
+ */
+export declare function resolveTrajectoryPrompt(root: string, dirName: string, legacyProfile?: SkiffProfile | null): TrajectoryPromptResolution;
+/**
+ * 轨迹提示词的**读取器**（长期热更新；改文件即生效，无需重启）。
+ *
+ * ## 为什么返回函数而不是字符串（R↓，实证代价）
+ *
+ * 旧实现把提示词**快照**进系统提示词段的闭包 ⇒ CCC 改了文件必须重启 dsh web 才生效
+ * （实测：改完 18KB 提示词，live agent 仍用旧文本）。现形态由系统提示词段的 `text()`
+ * **每轮调用**本读取器：按 **mtime + size** 缓存重读（命中缓存零 IO）。
+ *
+ * ## 三条失败语义（各治一个失败模式）
+ *
+ * - **文件不存在** ⇒ 返回空串（**不是错误**：普通轨迹没有章程是常态，且删掉即失效
+ *   必须是立即可见的——这就是"删掉 PROMPT.md 即恢复默认"的机制）
+ * - **读取失败** ⇒ 返回**上次成功内容**（⛔ 绝不返回空：空提示词会让轨迹失去章程），
+ *   并按去重标签告警一次
+ * - **首次就读不到** ⇒ 空串 ＋ 告警一次（区分"本来没有"与"有但读不了"）
+ *
+ * @param root CCC 根
+ * @param dirName 轨迹目录名（**不是编码**：目录名才是落盘位置）
+ */
+export declare function createTrajectoryPromptReader(root: string, dirName: string): () => string;
+/**
+ * 装配用的**提示词段**（幂等：无内容 ⇒ 空串，宿主会丢弃空 section/空块）。
+ *
+ * 标记头 `=== Serenity Trajectory Prompt ===`：
+ * ① 让模型知道"下面是**这条轨迹自己的章程**"，不是容器规则；
+ * ② 让诊断可以按块名 grep。
+ *
+ * 🔴 这段**追加**在容器层与质量层之后，**永不替换它们**——那正是本概念相对「人格」的核心修正。
+ */
+export declare function trajectoryPromptBlock(text: string): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.71.0",
-  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/微信桥/认知轨迹唤醒注册表。skiff = 目录下有 skiff.json 的认知轨迹（约束面住在轨迹里）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
+  "version": "1.72.0",
+  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/微信桥/认知轨迹唤醒注册表。skiff = 目录下有 skiff.json 的认知轨迹（约束面住在轨迹里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
   "license": "MIT",
   "repository": {
     "type": "git",