@shgroup/dsh-serenity-hooks 1.84.0 → 1.86.0

package/lib/index.js

@@ -1,14 +1,14 @@
 import { i as __toESM, n as __exportAll } from "./rolldown-runtime-B4iAMlE-.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-4LwGLCXa.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-BI_4UVcj.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, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-CyYJL4F2.js";
-import { A as sessionEvents, B as isoLocal, C as listSessions, E as parseTrajectoryCode, F as trajectoryDescOf, H as localHuman, I as useSession, L as TRAJECTORY_FILENAME, M as setActiveSessionInfo, N as showSession, O as readTrajectoryUid, P as summarize, R as TRAJECTORY_LEGACY_FILENAMES, S as listActiveTrajectories, T as parseSessionContextFromEvents, U as localIdStamp, V as localFileStamp, _ as createSession, a as readTrajectoryConstraintAt, b as getActiveSessionInfo, c as trajectoryConstraintForSession, f as COGNITIVE_TRAJECTORY_ACTIONS, g as clearActiveSessionInfo, h as archiveSession, j as sessionsRoot, k as resolveSessionByTitle, m as UID_FILENAME, n as isTrajectoryConstrained, o as readTrajectoryConstraintByCode, r as listTrajectoryConstraints, s as replacesDefaultIdentity, t as TRAJECTORY_CONSTRAINT_FILENAME, v as extractSessionMdPathFromText, w as namingTitleFor, y as findSession, z as readTrajectoryFile } from "./profile-CiRWh2a2.js";
+import { A as resolveSessionByTitle, B as readTrajectoryFile, C as listActiveTrajectories, D as parseTrajectoryCode, E as parseSessionContextFromEvents, F as summarize, H as localFileStamp, I as trajectoryDescOf, L as useSession, M as sessionsRoot, N as setActiveSessionInfo, P as showSession, R as TRAJECTORY_FILENAME, T as namingTitleFor, U as localHuman, V as isoLocal, W as localIdStamp, _ as clearActiveSessionInfo, b as findSession, c as replacesDefaultIdentity, g as archiveSession, h as UID_FILENAME, i as listTrajectoryConstraints, j as sessionEvents, k as readTrajectoryUid, l as trajectoryConstraintForSession, n as findDirNameByCode, o as readTrajectoryConstraintAt, p as COGNITIVE_TRAJECTORY_ACTIONS, r as isTrajectoryConstrained, s as readTrajectoryConstraintByCode, t as TRAJECTORY_CONSTRAINT_FILENAME, v as createSession, w as listSessions, x as getActiveSessionInfo, y as extractSessionMdPathFromText, z as TRAJECTORY_LEGACY_FILENAMES } from "./profile-vHheCJiU.js";
 import { n as checkLocalstoreGitCompliance, o as readStore, s as runLocalStore, t as LOCALSTORE_SCOPES } from "./service-DDmHSglV.js";
-import { _ as resolveConstraintSystemPrompt, a as listBoundSessionIds, d as constraintCognitiveTrajectory, f as constraintSystemPromptSource, g as profileWriteWhitelist, h as profileToolWhitelist, i as carrierState, l as TRAJECTORY_CONSTRAINT_HINT, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND, v as ACC_VERSION, y as findPackageRoot } from "./message-source-CfqdGIi2.js";
-import { A as buildResourceIndex, C as verifyPassword, D as recordToolUsage, E as verifyTotpCode, F as hasTrajectoryPrompt, M as isSafeSkillName, N as truncateContent, O as REFERENCE_DIR, P as TRAJECTORY_PROMPT_FILENAME, S as toWire, T as MECHANISM_PORTS, _ as registerEntrySkillSectionGlobal, a as trajectoryConstraintFor, b as projectKnownWorkspaces, c as trajectoryWorkspaceMdPath, d as CHEAP_WORKER_GUIDE, f as providerAvailabilityError, g as registerEntrySkillSection, h as registerCognitiveTrajectorySkillSection, i as getTrajectoryAgent, j as buildResourceNameSuffix, k as SKILL_ONTOLOGY_FILE, l as unregisterTrajectorySession, m as splitModel, n as createTrajectoryAgent, o as trajectoryConstraintMsmGate, p as requireWhitelistedModel, r as ensureWorkspacePromptSection, s as trajectoryConstraintParticipates, t as askTrajectory, u as workspaceCognitiveTrajectoryLine, v as applyWirePatch, w as FACE_PORTS, x as readAdvancedSettings, y as migrateLegacyLocalstore } from "./session-BF4C3hJL.js";
+import { _ as resolveConstraintSystemPrompt, a as listBoundSessionIds, d as constraintCognitiveTrajectory, f as constraintSystemPromptSource, g as profileWriteWhitelist, h as profileToolWhitelist, i as carrierState, l as TRAJECTORY_CONSTRAINT_HINT, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND, v as ACC_VERSION, y as findPackageRoot } from "./message-source-DRkQwfgh.js";
+import { A as buildResourceIndex, C as verifyPassword, D as recordToolUsage, E as verifyTotpCode, F as hasTrajectoryPrompt, M as isSafeSkillName, N as truncateContent, O as REFERENCE_DIR, P as TRAJECTORY_PROMPT_FILENAME, S as toWire, T as MECHANISM_PORTS, _ as registerEntrySkillSectionGlobal, a as trajectoryConstraintFor, b as projectKnownWorkspaces, c as trajectoryWorkspaceMdPath, d as CHEAP_WORKER_GUIDE, f as providerAvailabilityError, g as registerEntrySkillSection, h as registerCognitiveTrajectorySkillSection, i as getTrajectoryAgent, j as buildResourceNameSuffix, k as SKILL_ONTOLOGY_FILE, l as unregisterTrajectorySession, m as splitModel, n as createTrajectoryAgent, o as trajectoryConstraintMsmGate, p as requireWhitelistedModel, r as ensureWorkspacePromptSection, s as trajectoryConstraintParticipates, t as askTrajectory, u as workspaceCognitiveTrajectoryLine, v as applyWirePatch, w as FACE_PORTS, x as readAdvancedSettings, y as migrateLegacyLocalstore } from "./session-DZXSLLEx.js";
 import { n as hasSessionLogById, r as sessionsRootDir } from "./cleanup-C-92qnDs.js";
-import { n as readSimpleSettings, r as registerSettingsSection } from "./settings-Dj4_ppTC.js";
+import { n as readSimpleSettings, r as registerSettingsSection } from "./settings-H7TVDayZ.js";
+import { a as readFeishuCredential, d as weixinSessionIdForTrajectory, i as matchWeixinRoute, l as sanitizeFileName$1, n as extractWeixinText, o as readWeixinCredential, r as hasVoiceItem, s as readWeixinSettings, t as extractWeixinMedia, u as weixinInboundDir } from "./route-GtYJdR06.js";
 import { REGISTERED_TOOLS } from "./invariant.js";
-import { a as readFeishuCredential, d as weixinSessionIdForTrajectory, i as matchWeixinRoute, l as sanitizeFileName$1, n as extractWeixinText, o as readWeixinCredential, r as hasVoiceItem, s as readWeixinSettings, t as extractWeixinMedia, u as weixinInboundDir } from "./route-Dr0SFD8A.js";
 import { c as sendTextMessage, i as getUpdates, l as sendTyping, n as downloadMedia, o as markdownToPlainText, r as getConfig, s as sendFileMessage, t as TypingStatus, u as sniffImageExt } from "./ilink-BMk2w2KY.js";
 import { a as registerImAccountImpl, i as normalizeAccountChannel, n as getImAccountImpl, r as imAccountChannels } from "./accounts-BHQbakUh.js";
 import { createRequire } from "node:module";
@@ -9346,7 +9346,8 @@ async function sendToCognitiveTrajectory(ctx, root, target, message, sender) {
 		}],
 		source: PLUGIN_SOURCE
 	});
-	if (agent.status === "idle") {
+	const freshCarrier = createdNote !== "";
+	if (freshCarrier || agent.status === "idle") {
 		try {
 			agent.followup(make());
 		} catch (err) {
@@ -9357,7 +9358,7 @@ async function sendToCognitiveTrajectory(ctx, root, target, message, sender) {
 		}
 		return {
 			ok: true,
-			detail: `已即时投递 ${t.dirName}（${acquired.how}；目标空闲 ⇒ followup 立即起轮）${createdNote}`
+			detail: `已即时投递 ${t.dirName}（${acquired.how}；${freshCarrier ? "刚建的载体 ⇒ followup 排队，锚定先于任务" : "目标空闲 ⇒ followup 立即起轮"}）${createdNote}`
 		};
 	}
 	try {
@@ -11047,6 +11048,152 @@ const TRAJECTORY_SELF_GUIDE = [
   ⚠️ 以上四项都是**读取当前真实状态**，不是"保存成功"的回执。保存成功 ≠ 生效（本仓反复踩过）。`
 ].join("\n");
 //#endregion
+//#region src/tools/im-docs.ts
+/**
+* tools/im-docs.ts — 「IM 桥怎么用、怎么配路由」的**手册正文**（2026-10-22）
+*
+* ## 为什么需要这一章（owner 原话）
+*
+* 「我在测试飞书，发现 ACC 没提供 IM 桥使用说明和账户查询方法，**导致 CCC 没办法自己配路由**，
+*  这个要完善下」＋「配路由需要的是**账户到轨迹**，轨迹 CCC 知道，**账户 CCC 不知道**，
+*  需要有个能力让 CCC 查询用户配好的账户」。
+*
+* ⇒ 两件事被同时指出来：**没有说明面**（只能猜配置形状）＋ **没有查询面**（拿不到对方 id）。
+* 后者已由 `im-bridge action=contacts` 兑现；本章补前者。
+*
+* ## 🔴 写这一章时守的两条纪律
+*
+* 1. **只描述已经建成的东西**（D179）：本章出现的每个字段、每个动作，都必须在实现里存在。
+*    写"打算做"的功能进手册 = 教用户按图施工然后把自己锁死。
+* 2. **指针从读者真正打开的那个工具发出**（D178）：读这一章的人是 **CCC 的 agent**，
+*    它手边常用的入口是 `im-bridge`（工具描述已指向本章）。⛔ 不能只藏在 container_admin 里。
+*/
+const IM_BRIDGE_GUIDE = `# IM 桥（im-bridge）—— 怎么用、怎么配、怎么查
+
+## 一、它是什么
+
+一个 CCC 通过 IM 渠道（微信 / 飞书）跟家人收发消息的能力。
+**只作用于本容器**——没有"目标容器"参数（跨 CCC 发送不在能力面）。
+
+工具在**未配置任何 IM 渠道时根本不可见**（不是"看得到但被拒"）。
+⇒ 你看到这个工具，说明本 CCC 已配了至少一个渠道。
+
+## 二、五个动作
+
+| 动作 | 用途 | 关键参数 |
+|---|---|---|
+| \`send\` | 发一条文本 | \`user\`（对方）＋ \`text\` |
+| \`send-file\` | 发本容器内的一个文件 | \`user\` ＋ \`file\`（**CCC 根相对路径**）＋ 可选 \`caption\` |
+| \`users\` | 已配的**别名**表 | — |
+| \`status\` | 渠道健康 ＋ **账号** ＋ **当前路由**（含每条路由的目标是否存在） | — |
+| \`contacts\` | **跟本容器有过往来的人**（含对方 id）＋ 未配路由的 ／ 配了却没往来的 | — |
+
+⚠️ 渠道不一定支持全部动作（例如飞书目前不支持 \`send-file\`，会如实返回 \`ACTION_UNSUPPORTED\`）。
+**如实返回"不支持"比假装支持好**——后者会得到一条"发出去但对方收不到"的静默故障。
+
+## 三、🔴 配路由：先 \`contacts\`，再写，再 \`status\` 自检
+
+路由的形状（\`.opencode/serenity.json\` 的 \`im.routes\`）：
+
+\`\`\`json
+{
+  "im": {
+    "enabled": true,
+    "accounts": [
+      { "accountId": "wechat-1", "channel": "weixin", "enabled": true },
+      { "accountId": "feishu-1", "channel": "feishu", "enabled": true }
+    ],
+    "routes": [
+      { "user": "o9cq…@im.wechat", "trajectory": "zhaocai-xingzai" },
+      { "user": "ou_xxxxxxxx",     "trajectory": "llm-intel" }
+    ]
+  }
+}
+\`\`\`
+
+- \`user\` = **对方在该渠道内的 id**（不是我们的账号，也不是别名）
+  · 微信：形如 \`xxx@im.wechat\`
+  · 飞书：形如 \`ou_…\`（open_id）
+- \`trajectory\` = **认知轨迹编码**（目录名里那一段，如 \`S142\` / \`llm-intel\`）
+- \`*\` 可作为 \`user\` 的**通配兜底**（exact 优先）
+
+### 那个 \`user\` id 从哪里来 —— 这是本节存在的原因
+
+**你不知道对方 id，而它也不在任何配置文件里。** 它只出现在聊天记录中。
+⇒ 用 \`im-bridge({channel:"weixin", action:"contacts"})\`，它会给出：
+
+\`\`\`json
+{
+  "contacts": [
+    { "channel": "weixin", "userId": "o9cq…@im.wechat", "accountIds": ["wechat-1"],
+      "route": null, "firstSeen": "2026-09-04T…", "lastSeen": "2026-10-22T…", "messages": 1284 }
+  ],
+  "unrouted":     ["o9cq…@im.wechat"],
+  "orphanRoutes": ["ou_typo_never_seen"],
+  "sources":      ["AGENT_SESSIONS/_im-logs/weixin/2026-10-22.jsonl", "…"]
+}
+\`\`\`
+
+三行输出**各有用途，缺一行这个动作就只剩"列名字"**：
+
+| 字段 | 含义 | 你要做什么 |
+|---|---|---|
+| \`contacts[].userId\` | 对方 id | **复制它**填进 \`routes[].user\` |
+| \`unrouted\` | ⚠️ 有往来、但**没配路由** | 这些人的消息现在**无处可去** ⇒ 这就是该配的 |
+| \`orphanRoutes\` | ❓ 配了路由、但记录里**从没出现过** | 大概率 **id 写错**（或从未有人发过） |
+| \`sources\` | 实际读过的文件 | **否定性结论的可信度上限** = 这个列表；它空着就别下"没人"的结论 |
+
+### 写完怎么自检
+
+\`im-bridge({channel:"weixin", action:"status"})\` 的 \`routes[]\` 每条都带 **\`targetExists\`**：
+
+- \`true\` ⇒ 该轨迹目录真实存在，路由**有机会**生效
+- \`false\` ⇒ **轨迹编码写错了**（或那条轨迹已被归档/删除）
+
+🔴 这一格是"配了不生效"的**唯一机械信号**：写错一个编码**不会有任何报错**，
+消息进来找不到目标就静默不投递，你只会看到"没回音"。
+
+## 四、多账号 / 多渠道
+
+一个 CCC 绑多个账号是常态（owner 2026-10-22：「一个 CCC 绑定多个账户很常见」）。
+
+- **账号**在 \`im.accounts[]\`，每条自带 \`channel\`（缺省 \`weixin\`）
+- **路由是通道无关的**（\`user → trajectory\`）；同一轨迹可以被多个渠道的对端指向
+- \`contacts\` 的每条带 \`accountIds\`（该对端被哪些账号收过）——**多账号靠它区分**
+- 发消息时可用 \`account\` 参数指定用哪个账号（缺省：第一个启用且已绑定的）
+
+## 五、聊天记录落在哪
+
+\`\`\`
+AGENT_SESSIONS/_im-logs/<channel>/<YYYY-MM-DD>.jsonl
+\`\`\`
+
+- 按**渠道**分目录（\`weixin\` / \`feishu\`），按**本地自然天**分文件，逐行 JSON 追加
+- 老路径 \`AGENT_SESSIONS/_weixin-logs/\` 是**同一族的前代**（2026-10-22 之前的微信记录）；
+  读侧**两个都认**，⛔ 但**只往新路径写**
+- 每条事件带 \`channel\` 字段 ⇒ 飞书事件不会再混进微信目录（此前会，目录名会说谎）
+- 媒体的持久副本在 \`_im-logs/<channel>/media/<日期>/\`
+
+⚠️ **记录归 CCC**（\`im.hook\` 指向本容器的脚本），ACC 不认识存储格式 —— 这层分离是有意的。
+
+## 六、出错时
+
+工具返回**稳定错误码 + 可行动提示**，常见的：
+
+| 码 | 意思 | 怎么改 |
+|---|---|---|
+| \`CHANNEL_NOT_CONFIGURED\` | 本 CCC 没启用该渠道 | 看提示里的**那一半**（总开关 vs 缺账号，两者改法不同） |
+| \`ALIAS_UNKNOWN\` | \`user\` 既不是已配别名、也不是合法的裸 id | 先 \`action=users\` 看别名，或用 \`contacts\` 拿裸 id |
+| \`ACTION_UNSUPPORTED\` | 该渠道没实现这个动作 | 换动作；⛔ 不要重试 |
+| \`FILE_ESCAPE\` | \`file\` 跑出了 CCC 根 | 用容器内相对路径 |
+
+## 七、边界（明确不做）
+
+- ⛔ 跨 CCC 发送（只作用于本容器）
+- ⛔ 修改配置（\`contacts\` 只读；加路由要人/CCC 自己写 \`serenity.json\`）
+- ⛔ 判断"对方读没读"——记录只证明**已发出**
+`;
+//#endregion
 //#region src/tools/container-admin.ts
 /**
 * container-admin.ts — container_admin（v1.30：机务舱——容器管理面统一入口）
@@ -11197,6 +11344,11 @@ const DOCS_CHAPTERS = [
 		id: "trajectory-constraint",
 		summary: "轨迹约束（只讲限制面）：trajectory.json 的双白名单 ／ 模型 ／ 纪律参与项 ／ IM 路由",
 		render: () => TRAJECTORY_CONSTRAINT_GUIDE
+	},
+	{
+		id: "im-bridge",
+		summary: "IM 桥怎么用、怎么配路由、怎么查对方 id —— send/send-file/users/status/contacts 五个动作 ＋ 路由三步法（contacts → 写 → status 自检）",
+		render: () => IM_BRIDGE_GUIDE
 	}
 ];
 /**
@@ -11207,7 +11359,7 @@ const DOCS_CHAPTERS = [
 function createContainerAdminTool(ctx) {
 	return defineTool({
 		name: "container_admin",
-		description: "Container administration (the ship's maintenance bay — one entry for managing the CCC): config — CCC configuration: docs (usage-manual index) / docs <chapter> (one chapter in full) / view (current values) + 轨迹约束 (guide/validate/apply/list); msm — MSM registry management (register/deregister/check quality DC-M1~M4) + manuals (guide dev manual / catalog ACC capability directory / ccc-config CCC configuration reference). TRAJECTORY SELF-DOCS: a cognitive trajectory describing ITSELF — charter (PROMPT.md) / resident declaration / self-restriction (whitelists) ⇒ config docs trajectory-self; the restriction side only ⇒ config docs trajectory-constraint. Execution of registered MSMs belongs to the msm tool; this tool manages the container.",
+		description: "Container administration (the ship's maintenance bay — one entry for managing the CCC): config — CCC configuration: docs (usage-manual index) / docs <chapter> (one chapter in full) / view (current values) + 轨迹约束 (guide/validate/apply/list); msm — MSM registry management (register/deregister/check quality DC-M1~M4) + manuals (guide dev manual / catalog ACC capability directory / ccc-config CCC configuration reference). TRAJECTORY SELF-DOCS: a cognitive trajectory describing ITSELF — charter (PROMPT.md) / resident declaration / self-restriction (whitelists) ⇒ config docs trajectory-self; the restriction side only ⇒ config docs trajectory-constraint. IM BRIDGE: how to send / configure routes / look up the other party's channel user id — send / send-file / users / status / contacts + the three-step route recipe ⇒ config docs im-bridge. Execution of registered MSMs belongs to the msm tool; this tool manages the container.",
 		parameters: {
 			domain: {
 				type: "string",
@@ -11320,6 +11472,138 @@ function createContainerAdminTool(ctx) {
 	});
 }
 //#endregion
+//#region src/im/log-scan.ts
+/**
+* im/log-scan.ts — 读聊天记录落盘，汇总出「与谁有过往来」（`contacts` 的数据源）
+*
+* ## 这个文件解决什么
+*
+* owner 2026-10-22：「配路由需要的是**账户到轨迹**，轨迹 CCC 知道，**账户 CCC 不知道**，
+* 需要有个能力让 CCC 查询用户配好的账户」。这里的"账户"= **通道用户**（对方是谁），
+* 不是 IM 账号（我们自己登录的身份，`status` 早就能查）。
+*
+* 那个 id（微信 `xxx@im.wechat` / 飞书 `ou_…`）不在任何配置文件里 ——
+* 它**只在聊天记录里出现过**。⇒ 本文件把记录读成联系人表。
+*
+* ## 🔴 两条硬边界
+*
+* 1. **只读**：本文件不写任何东西。真相源仍是那些 jsonl（append-only 事件流），
+*    本文件只是它的一次投影 —— ⛔ 不产生第二真相源。
+* 2. **不猜渠道**：事件的 `channel` 字段为准；缺它（存量事件）⇒ 按
+*    `accountId → im.accounts[].channel` 回填，仍取不到才落 `weixin`
+*    （那是该字段存在之前唯一的渠道）。⛔ **绝不按 userId 的形状猜**
+*    （`ou_` 前缀 / `@im.wechat` 后缀都是命名习惯，不是判据 —— D167 认族不认名）。
+*/
+/** 日志根目录族（**新旧两代并存**：`_im-logs/<channel>/` 与存量 `_weixin-logs/`） */
+const IM_LOG_DIR_NEW = "_im-logs";
+const IM_LOG_DIR_LEGACY = "_weixin-logs";
+/** 某 CCC 下**存在**的日志目录（相对根），新代在前 */
+function imLogRoots(root) {
+	const out = [];
+	const newBase = join(root, "AGENT_SESSIONS", IM_LOG_DIR_NEW);
+	const legacy = join(root, "AGENT_SESSIONS", IM_LOG_DIR_LEGACY);
+	if (existsSync(newBase)) out.push(join("AGENT_SESSIONS", IM_LOG_DIR_NEW));
+	if (existsSync(legacy)) out.push(join("AGENT_SESSIONS", IM_LOG_DIR_LEGACY));
+	return out;
+}
+/** 收集某个日志根下所有 `*.jsonl`（含 `_im-logs/<channel>/` 一层；按文件名排序） */
+function jsonlFilesIn(root, rel) {
+	const abs = join(root, rel);
+	const out = [];
+	let entries = [];
+	try {
+		entries = readdirSync(abs, { withFileTypes: true }).map((d) => d.name);
+	} catch {
+		return out;
+	}
+	for (const name of entries.sort()) {
+		if (name.startsWith(".")) continue;
+		if (name.endsWith(".jsonl")) {
+			out.push(join(rel, name));
+			continue;
+		}
+		if (rel === join("AGENT_SESSIONS", "_im-logs")) {
+			const sub = join(rel, name);
+			try {
+				for (const child of readdirSync(join(root, sub)).sort()) if (child.endsWith(".jsonl")) out.push(join(sub, child));
+			} catch {}
+		}
+	}
+	return out;
+}
+/** 从文件名 / 所在目录猜渠道（**只作为回填的最后一级**，不是判据） */
+function channelFromPath(rel) {
+	const parts = rel.split("/");
+	const idx = parts.indexOf(IM_LOG_DIR_NEW);
+	const candidate = idx >= 0 && parts.length > idx + 2 ? parts[idx + 1] : void 0;
+	return candidate !== void 0 && candidate !== "" ? candidate : null;
+}
+/**
+* 扫描本 CCC 的全部聊天记录，按 `(channel, userId)` 汇总。
+*
+* @param root CCC 根
+* @param accountChannel 存量事件缺 `channel` 时的回填表（`accountId → channel`）
+* @returns 汇总结果 ＋ **扫描域** ＋ 读取错误（三者都不可省）
+*/
+function scanImContacts(root, accountChannel = {}) {
+	const byKey = /* @__PURE__ */ new Map();
+	const sources = [];
+	const errors = [];
+	for (const rel of imLogRoots(root)) for (const fileRel of jsonlFilesIn(root, rel)) {
+		sources.push(fileRel);
+		let text = "";
+		try {
+			text = readFileSync(join(root, fileRel), "utf8");
+		} catch (err) {
+			errors.push(`${fileRel}: ${err instanceof Error ? err.message : String(err)}`);
+			continue;
+		}
+		const pathChannel = channelFromPath(fileRel);
+		for (const line of text.split("\n")) {
+			const trimmed = line.trim();
+			if (trimmed === "") continue;
+			let ev;
+			try {
+				ev = JSON.parse(trimmed);
+			} catch {
+				errors.push(`${fileRel}: 有 1 行不是合法 JSON（已跳过）`);
+				continue;
+			}
+			const userId = typeof ev.userId === "string" ? ev.userId.trim() : "";
+			if (userId === "") continue;
+			const accountId = typeof ev.accountId === "string" ? ev.accountId.trim() : "";
+			const channel = (typeof ev.channel === "string" && ev.channel.trim() !== "" ? ev.channel.trim() : null) ?? pathChannel ?? (accountId !== "" ? accountChannel[accountId] ?? null : null) ?? "weixin";
+			const key = `${channel}\u0000${userId}`;
+			let entry = byKey.get(key);
+			if (!entry) {
+				entry = {
+					channel,
+					userId,
+					accountIds: [],
+					roleAtEvent: null,
+					firstSeen: null,
+					lastSeen: null,
+					messages: 0
+				};
+				byKey.set(key, entry);
+			}
+			if (accountId !== "" && !entry.accountIds.includes(accountId)) entry.accountIds.push(accountId);
+			if (typeof ev.role === "string" && ev.role.trim() !== "") entry.roleAtEvent = ev.role.trim();
+			const ts = typeof ev.ts === "number" && Number.isFinite(ev.ts) ? ev.ts : null;
+			if (ts !== null) {
+				if (entry.firstSeen === null || ts < entry.firstSeen) entry.firstSeen = ts;
+				if (entry.lastSeen === null || ts > entry.lastSeen) entry.lastSeen = ts;
+			}
+			entry.messages += 1;
+		}
+	}
+	return {
+		contacts: [...byKey.values()].sort((a, b) => (b.lastSeen ?? 0) - (a.lastSeen ?? 0)),
+		sources,
+		errors
+	};
+}
+//#endregion
 //#region src/im/channels.ts
 /**
 * im/channels.ts — IM 发送能力层（v1.31.0，S142 用户洞察）
@@ -11463,6 +11747,39 @@ async function runImBridge(root, req) {
 		action,
 		detail: { users: channel.listUsers(root) }
 	};
+	if (action === "contacts") {
+		if (!channel.listContacts) return fail("ACTION_UNSUPPORTED", `channel "${channelId}" has no record source for contacts`);
+		const settings = readWeixinSettings(root);
+		const accountChannel = {};
+		for (const account of settings.accounts ?? []) if (typeof account.accountId === "string" && account.accountId !== "") accountChannel[account.accountId] = typeof account.channel === "string" && account.channel !== "" ? account.channel : "weixin";
+		const scanned = scanImContacts(root, accountChannel);
+		const mine = scanned.contacts.filter((c) => c.channel === channelId);
+		/** 当前路由表（`user → trajectory`）；同一 user 多条时后者覆盖 */
+		const routeMap = /* @__PURE__ */ new Map();
+		for (const route of settings.routes ?? []) if (typeof route.user === "string" && route.user !== "") routeMap.set(route.user, typeof route.trajectory === "string" ? route.trajectory : "");
+		const contacts = mine.map((c) => ({
+			channel: c.channel,
+			userId: c.userId,
+			accountIds: c.accountIds,
+			route: routeMap.get(c.userId) ?? null,
+			firstSeen: c.firstSeen === null ? null : new Date(c.firstSeen).toISOString(),
+			lastSeen: c.lastSeen === null ? null : new Date(c.lastSeen).toISOString(),
+			messages: c.messages
+		}));
+		const seenUsers = new Set(mine.map((c) => c.userId));
+		return {
+			ok: true,
+			channel: channelId,
+			action,
+			detail: {
+				contacts,
+				unrouted: mine.filter((c) => !routeMap.has(c.userId)).map((c) => c.userId),
+				orphanRoutes: [...routeMap.keys()].filter((user) => !seenUsers.has(user)),
+				sources: scanned.sources,
+				...scanned.errors.length > 0 ? { errors: scanned.errors } : {}
+			}
+		};
+	}
 	if (action === "status") return {
 		ok: true,
 		channel: channelId,
@@ -13351,11 +13668,65 @@ function accMessage(root, configPaths, entrySkillMaxChars) {
 		source: PLUGIN_SOURCE
 	});
 }
-/** 每 agent 是否已注入过（进程内存态） */
+/**
+* 每 agent 是否已注入过 —— **只作为本进程内的快路径**，⛔ 不是判据。
+*
+* 🔴🔴 2026-10-22（owner 报「send-now 创建的会话消息注入两次」的取证结论）：
+* 此前**它就是判据**，于是 `pre-step` 那道门拿它回答"**这条会话**注入过没有"——
+* 而它实际回答的是"**本进程**注入过没有"。进程一换（`restart-web` / 看门狗拉起 /
+* 崩溃重启）它就清空 ⇒ 老会话被冷载入时 `pre-step` 判"没注入过" ⇒ **再注入一遍**。
+*
+* 实测铁证（同一会话两条 `[ACC] … active` 横幅，相隔 18.6 小时）：
+* 只有**跨过重启**的会话有两条，没跨的只有一条 ⇒ 重复的量 = 跨了几个进程。
+*
+* ⇒ 判据改为 {@link hasAccBanner}（读**会话历史**）。本 Set 降级为"同进程免重复扫"的优化：
+*   命中它就直接返回（省一次扫），⛔ 它为空**不代表**没注入过。
+*/
 const injected = /* @__PURE__ */ new Set();
 function agentKey(agent) {
 	return agent.session.id ?? "global";
 }
+/**
+* ACC 身份横幅在**会话历史**里的识别特征（结构判据，不依赖措辞顺序）。
+*
+* 🔴 为什么认 `source.kind` ＋ 正文前缀两件：
+*   - 只认正文 ⇒ 将来文案一改就静默失效（D151 同族：判据不能长在措辞上）；
+*   - 只认 `source.kind` ⇒ 本插件注入的**所有**消息都算（`skill-catalog` 块、假首轮横幅…）
+*     ⇒ 会把"别的注入出现过"误当成"身份横幅出现过"，导致**永不再注入**。
+* ⇒ 两者与：由本插件发出 **且** 正文以 ACC 横幅首词开头。
+*/
+const ACC_BANNER_PREFIX = "[ACC] Serenity cognitive container active";
+/**
+* 这条会话的历史里**是否已经有** ACC 身份横幅（= 判据的唯一权威）。
+*
+* 🔴 这是本条修复的核心：**"注入过没有"是会话的属性，不是进程的属性。**
+* 会话历史随会话走（落盘、重启后仍在），进程内状态随进程死。
+*
+* ⚠️ 读不到 events（受限宿主 / 投影未就绪）⇒ 返回 `false`（退回"注入一次"）。
+*   这是**偏保守**的选择：多注入一条横幅（可见、可清理）远好于
+*   **永远不再注入**（陈旧会话里 ACC 身份彻底缺失，且零信号）。
+*
+* @param session 目标会话（`sessionEvents` 能读的形状）
+*/
+function hasAccBanner(session) {
+	return sessionEvents(session).some((event) => {
+		const e = event;
+		if (e.type !== "user/message") return false;
+		if (e.data?.source?.kind !== PLUGIN_SOURCE.kind) return false;
+		return textOfUserMessage(e.data)?.trimStart().startsWith(ACC_BANNER_PREFIX) === true;
+	});
+}
+/** 从 `user/message` 的 content 块数组里拼出纯文本（无 text 块 ⇒ undefined） */
+function textOfUserMessage(data) {
+	const content = data?.content;
+	if (!Array.isArray(content)) return void 0;
+	const parts = [];
+	for (const block of content) {
+		const b = block;
+		if (b?.type === "text" && typeof b.text === "string") parts.push(b.text);
+	}
+	return parts.length === 0 ? void 0 : parts.join("");
+}
 function agentScope(agent) {
 	return agent.session.id ?? "default";
 }
@@ -13455,7 +13826,10 @@ function registerContext(ctx, opts = {}) {
 				}
 			}
 		} catch {}
-		if (injected.has(key)) return;
+		if (injected.has(key) || hasAccBanner(agent.session)) {
+			injected.add(key);
+			return;
+		}
 		injected.add(key);
 		agent.inject(accMessage(root, configPaths, entrySkillMaxChars));
 		syncSafeModeRestriction(agent, root);
@@ -13511,7 +13885,11 @@ function registerContext(ctx, opts = {}) {
 			registerEntrySkillSection(agent, root);
 			registerCognitiveTrajectorySkillSection(agent, root);
 		}
-		if (!root || injected.has(key) || downstream.kind !== "enter") return downstream;
+		if (!root || downstream.kind !== "enter") return downstream;
+		if (injected.has(key) || hasAccBanner(agent.session)) {
+			injected.add(key);
+			return downstream;
+		}
 		injected.add(key);
 		return {
 			kind: "enter",
@@ -14100,11 +14478,11 @@ function registerStatusApi(ctx, opts = {}) {
 						sendJson$2(res, 400, { error: chk.error });
 						return;
 					}
-					const { readWeixinSettings } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
+					const { readWeixinSettings } = await import("./route-GtYJdR06.js").then((n) => n.c);
 					const { weixinBridgeStatus } = await Promise.resolve().then(() => bridge_exports);
 					const settings = readWeixinSettings(chk.root);
 					const bridge = weixinBridgeStatus().find((b) => b.ccc === chk.root);
-					const { imCredentialBound } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
+					const { imCredentialBound } = await import("./route-GtYJdR06.js").then((n) => n.c);
 					const { normalizeAccountChannel } = await import("./accounts-BHQbakUh.js").then((n) => n.t);
 					const accounts = (settings.accounts ?? []).map((a) => {
 						const channel = normalizeAccountChannel(a.channel);
@@ -14141,7 +14519,7 @@ function registerStatusApi(ctx, opts = {}) {
 					const { fetchQRCode } = await import("./ilink-BMk2w2KY.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-Dr0SFD8A.js").then((n) => n.c);
+					const { readWeixinSettings } = await import("./route-GtYJdR06.js").then((n) => n.c);
 					const qr = await fetchQRCode({ botType: readWeixinSettings(root).botType ?? void 0 });
 					const loginKey = randomUUID();
 					weixinLogins.set(loginKey, {
@@ -14162,7 +14540,7 @@ function registerStatusApi(ctx, opts = {}) {
 						sendJson$2(res, 400, { error: "missing accountId" });
 						return;
 					}
-					const { removeWeixinAccount } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
+					const { removeWeixinAccount } = await import("./route-GtYJdR06.js").then((n) => n.c);
 					const { syncCccBridge } = await Promise.resolve().then(() => bridge_exports);
 					removeWeixinAccount(root, body.accountId);
 					syncCccBridge(ctx, root);
@@ -14188,8 +14566,8 @@ function registerStatusApi(ctx, opts = {}) {
 							trajectory: code
 						});
 					}
-					const { saveWeixinRoutes } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
-					const { findDirNameByCode } = await import("./profile-CiRWh2a2.js").then((n) => n.i);
+					const { saveWeixinRoutes } = await import("./route-GtYJdR06.js").then((n) => n.c);
+					const { findDirNameByCode } = await import("./profile-vHheCJiU.js").then((n) => n.a);
 					for (const r of routes) if (findDirNameByCode(root, r.trajectory) === null) {
 						sendJson$2(res, 400, { error: `unknown trajectory: ${r.trajectory} (no such trajectory code in ${root})` });
 						return;
@@ -14200,7 +14578,7 @@ function registerStatusApi(ctx, opts = {}) {
 				}
 				if (body.action === "set-enabled") {
 					const enabled = body.enabled === true;
-					const { readWeixinSettings, setWeixinEnabled } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
+					const { readWeixinSettings, setWeixinEnabled } = await import("./route-GtYJdR06.js").then((n) => n.c);
 					const { syncCccBridge } = await Promise.resolve().then(() => bridge_exports);
 					const settings = readWeixinSettings(root);
 					if (enabled && (settings.accounts ?? []).length === 0) {
@@ -14223,7 +14601,7 @@ function registerStatusApi(ctx, opts = {}) {
 						sendJson$2(res, 400, { error: "appId 与 appSecret 都必须填（只填一个等于没绑）" });
 						return;
 					}
-					const { readWeixinSettings, upsertWeixinAccount, writeFeishuCredential, nextFeishuAccountId } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
+					const { readWeixinSettings, upsertWeixinAccount, writeFeishuCredential, nextFeishuAccountId } = await import("./route-GtYJdR06.js").then((n) => n.c);
 					const { syncCccBridge } = await Promise.resolve().then(() => bridge_exports);
 					const before = readWeixinSettings(root);
 					const accountId = (body.accountId ?? "").trim() !== "" ? body.accountId.trim() : nextFeishuAccountId(before);
@@ -14273,7 +14651,7 @@ function registerStatusApi(ctx, opts = {}) {
 					return;
 				}
 				const { pollQRStatus } = await import("./ilink-BMk2w2KY.js").then((n) => n.a);
-				const { readWeixinSettings } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
+				const { readWeixinSettings } = await import("./route-GtYJdR06.js").then((n) => n.c);
 				const settings = readWeixinSettings(login.root);
 				const status = await pollQRStatus({
 					baseUrl: void 0,
@@ -14288,7 +14666,7 @@ function registerStatusApi(ctx, opts = {}) {
 							});
 							return;
 						}
-						const { upsertWeixinAccount, writeWeixinCredential, nextWeixinAccountId } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
+						const { upsertWeixinAccount, writeWeixinCredential, nextWeixinAccountId } = await import("./route-GtYJdR06.js").then((n) => n.c);
 						const { syncCccBridge } = await Promise.resolve().then(() => bridge_exports);
 						const accountId = nextWeixinAccountId(settings);
 						upsertWeixinAccount(login.root, {
@@ -18824,12 +19202,15 @@ function appendHumanChannelAudit(event) {
 const WEIXIN_HOOK_TIMEOUT_MS = 15e3;
 /** hook stderr/stdout 日志截断（防脚本刷屏） */
 const HOOK_LOG_MAX = 500;
+/** 存量调用点未传 `channel` 时的缺省值（本字段存在之前唯一的渠道） */
+const DEFAULT_HOOK_CHANNEL = "weixin";
 /** 构造 incoming 事件对象（纯函数，可测） */
 function buildIncomingHookEvent(input) {
 	return {
 		event: "incoming",
 		ts: Date.now(),
 		cccRoot: input.cccRoot,
+		channel: input.channel ?? DEFAULT_HOOK_CHANNEL,
 		accountId: input.accountId,
 		userId: input.userId,
 		sessionId: input.sessionId,
@@ -18846,6 +19227,7 @@ function buildOutgoingHookEvent(input) {
 		event: "outgoing",
 		ts: Date.now(),
 		cccRoot: input.cccRoot,
+		channel: input.channel ?? DEFAULT_HOOK_CHANNEL,
 		accountId: input.accountId,
 		userId: input.userId,
 		sessionId: input.sessionId,
@@ -19228,7 +19610,7 @@ const MEDIA_MAX_BYTES = 20971520;
 */
 async function resolveCccRootByAlias(ctx, alias) {
 	try {
-		const { listCccs } = await import("./ccc-roots-4LwGLCXa.js").then((n) => n.a);
+		const { listCccs } = await import("./ccc-roots-BI_4UVcj.js").then((n) => n.a);
 		const entries = await listCccs(ctx);
 		const byName = entries.find((e) => e.name === alias);
 		if (byName) return byName.root;
@@ -19296,7 +19678,7 @@ async function resolveInboundTarget(ctx, input) {
 		});
 		return null;
 	}
-	const { findDirNameByCode } = await import("./profile-CiRWh2a2.js").then((n) => n.i);
+	const { findDirNameByCode } = await import("./profile-vHheCJiU.js").then((n) => n.a);
 	if (findDirNameByCode(root, target.role) === null) {
 		const detail = `目标 CCC "${target.ccc}" 内没有编码为 "${target.role}" 的认知轨迹`;
 		console.error(`[serenity-hooks] ✗ human-channel: ${detail}（account=${input.account} user=${input.user}）—— 该消息**未投递**，请改订阅表里的目标编码`);
@@ -19525,6 +19907,7 @@ async function handleInboundEvent(ctx, root, accountId, io, event, preset) {
 			const hookRel = settings.hook;
 			if (hookRel) invokeWeixinHook(root, hookRel, buildIncomingHookEvent({
 				cccRoot: root,
+				channel,
 				accountId,
 				userId: fromUserId,
 				sessionId,
@@ -19551,6 +19934,7 @@ async function handleInboundEvent(ctx, root, accountId, io, event, preset) {
 				console.warn(`[serenity-hooks] ⚠ im 输出兜底：agent 本轮未发送（闸门打回用尽）→ 桥转发最终文本（session=${sessionId}, trajectory=${trajectory}）`);
 				if (hookRel) invokeWeixinHook(root, hookRel, buildOutgoingHookEvent({
 					cccRoot: root,
+					channel,
 					accountId,
 					userId: fromUserId,
 					sessionId,
@@ -19571,6 +19955,7 @@ async function handleInboundEvent(ctx, root, accountId, io, event, preset) {
 			});
 			if (hookRel) invokeWeixinHook(root, hookRel, buildOutgoingHookEvent({
 				cccRoot: root,
+				channel,
 				accountId,
 				userId: fromUserId,
 				sessionId,
@@ -20246,7 +20631,7 @@ function syncHumanChannel(ctx) {
 	(async () => {
 		try {
 			stopMachineLoops();
-			const { listCccs } = await import("./ccc-roots-4LwGLCXa.js").then((n) => n.a);
+			const { listCccs } = await import("./ccc-roots-BI_4UVcj.js").then((n) => n.a);
 			for (const entry of await listCccs(ctx)) syncCccBridge(ctx, entry.root);
 		} catch {}
 	})();
@@ -20343,6 +20728,7 @@ async function sendProactiveText(input) {
 	}
 	if (settings.hook) invokeWeixinHook(root, settings.hook, buildOutgoingHookEvent({
 		cccRoot: root,
+		channel: "weixin",
 		accountId,
 		userId: toUserId,
 		sessionId,
@@ -20537,7 +20923,7 @@ function matchCcc(input, candidates) {
 }
 /** 组装候选列表（`ccc-roots.listCccs` 投影 + `.serenity` 名；动态 import 保持本模块静态依赖轻量） */
 async function collectCandidates(ctx) {
-	const { listCccs } = await import("./ccc-roots-4LwGLCXa.js").then((n) => n.a);
+	const { listCccs } = await import("./ccc-roots-BI_4UVcj.js").then((n) => n.a);
 	const entries = await listCccs(ctx, { defaultRoot: process.cwd() });
 	const seen = /* @__PURE__ */ new Set();
 	const out = [];
@@ -21752,6 +22138,24 @@ function credentialValue$1(root, key) {
 function channelError$1(code, error, remediation) {
 	return /* @__PURE__ */ new Error(`${code}: ${error}${remediation ? ` — ${remediation}` : ""}`);
 }
+/**
+* 路由目标轨迹**是否存在**（`status` 的自检列）。
+*
+* 🔴 复用既有判据 `findDirNameByCode`（它扫活跃区并按编码解析）—— ⛔ 不在这里另写一套目录扫描，
+*    两份判据会漂（一处认归档、另一处不认，就会出现"这里说有、投递时说没有"）。
+*
+* ⚠️ 解析失败（`findDirNameByCode` 在**重码**时会抛）⇒ 返回 `false` 但**不吞掉原因**：
+*    重码本身也是"这个路由不可信"的一种形态，`status` 里会表现为 `targetExists:false`，
+*    配合 `cognitive_trajectory list` 可定位。不额外造一个错误码（键名已经够直白）。
+*/
+function trajectoryDirExists(root, code) {
+	if (typeof code !== "string" || code.trim() === "") return false;
+	try {
+		return findDirNameByCode(root, code.trim()) !== null;
+	} catch {
+		return false;
+	}
+}
 const weixinChannel = {
 	id: "weixin",
 	isEnabled(root) {
@@ -21830,6 +22234,7 @@ const weixinChannel = {
 			const trajectory = matchWeixinRoute(settings.routes ?? [], input.userId) ?? "";
 			invokeWeixinHook(input.root, settings.hook, buildOutgoingHookEvent({
 				cccRoot: input.root,
+				channel: "weixin",
 				accountId: account.accountId,
 				userId: input.userId,
 				sessionId: weixinSessionIdForTrajectory(trajectory !== "" ? trajectory : sanitizeFileName$1(input.userId) || "unknown"),
@@ -21861,10 +22266,14 @@ const weixinChannel = {
 			lastPollAt: account.lastPollAt,
 			...account.lastError ? { lastError: account.lastError } : {}
 		})));
-		const routes = (settings.routes ?? []).map((route) => ({
-			user: route.user,
-			role: route.trajectory
-		}));
+		const routes = (settings.routes ?? []).map((route) => {
+			const code = route.trajectory;
+			return {
+				user: route.user,
+				role: code,
+				targetExists: trajectoryDirExists(root, code)
+			};
+		});
 		return {
 			enabled: settings.enabled === true,
 			autoReplyWithLastMessage: settings.autoReplyWithLastMessage !== false,
@@ -21905,12 +22314,17 @@ const weixinChannel = {
 * ⇒ 校验**值的形状**（飞书 open_id 以 `ou_` 开头）：错配在**解析处**就失败，
 *    错误码是 `ALIAS_UNKNOWN` + 可行动提示。
 *
-* ## 🔴 为什么不 fire 记录 hook
+* ## 🔴 记录 hook：曾经不 fire，2026-10-22 起 fire（A83 已裁）
 *
-* `settings.hook` 的契约与消费方都是**微信的**：CCC 的 `scripts/weixin-message-hook.ts`
-* 把事件追加进 `AGENT_SESSIONS/_weixin-logs/<日期>.jsonl`。飞书事件若流进去，
-* 那个目录就**同时装两种渠道的数据而名字只说一种**（D151／D179 同族：名字开始撒谎）。
-* ⇒ 本期**不落记录**，并把它登记为待裁（A83）。工具描述里按渠道写清这件事。
+* **当时的理由**：`settings.hook` 的契约与消费方都是**微信的**，CCC 的
+* `scripts/weixin-message-hook.ts` 把事件追加进 `AGENT_SESSIONS/_weixin-logs/<日期>.jsonl`。
+* 飞书事件若流进去，那个目录就**同时装两种渠道的数据而名字只说一种**（D151／D179 同族）。
+*
+* **为什么现在可以 fire**：同批给 hook 事件加了 **`channel` 字段**（owner 2026-10-22：
+* 「一个 CCC 绑定多个账户很常见，聊天记录落盘要完善」）⇒ CCC 侧 hook 按渠道分流到
+* `_im-logs/<channel>/`，**目录名不再需要撒谎**。
+* ⇒ 所以这不是"决定记录"，而是"**让记录不再有害**之后才记录"。
+* ⚠️ 顺序有意义：**先有渠道字段，再有记录**。反过来做就会先造出一批分不清渠道的数据。
 */
 /**
 * 飞书 open_id 的形状前缀（官方形态：`ou_` ＋ 一串）。
@@ -22065,6 +22479,18 @@ const feishuChannel = {
 		const settings = readWeixinSettings(input.root);
 		const trajectory = matchWeixinRoute(settings.routes ?? [], input.userId) ?? "";
 		const sessionId = weixinSessionIdForTrajectory(trajectory !== "" ? trajectory : sanitizeFileName$1(input.userId) || "unknown");
+		if (settings.hook) invokeWeixinHook(input.root, settings.hook, buildOutgoingHookEvent({
+			cccRoot: input.root,
+			channel: "feishu",
+			accountId: account.accountId,
+			userId: input.userId,
+			sessionId,
+			role: trajectory,
+			reply: markdownToPlainText(input.text),
+			source: "proactive"
+		})).catch((err) => {
+			console.log(`[serenity-hooks] im hook outgoing(feishu) error: ${err instanceof Error ? err.message : String(err)}`);
+		});
 		return {
 			accountId: account.accountId,
 			userId: input.userId,
@@ -22118,7 +22544,8 @@ const ACTIONS = [
 	"send",
 	"send-file",
 	"users",
-	"status"
+	"status",
+	"contacts"
 ];
 function renderText(value) {
 	return [{
@@ -22133,7 +22560,7 @@ function renderText(value) {
 function createImBridgeTool() {
 	return defineTool({
 		name: "im-bridge",
-		description: `Send messages to family members through an IM channel configured for THIS container. This tool only acts on the current container (no target container parameter). It is hidden entirely when this container has no IM channel configured. Channels: ${imChannelIds().join(", ") || "(none registered)"}. Actions: send (text) / send-file (a file inside this container) / users (list configured recipients) / status (channel health). Not every channel supports every action (e.g. send-file may return ACTION_UNSUPPORTED). user accepts a configured alias (e.g. user-a, user-b) or a raw channel user id. Failures return a stable code plus a remediation hint.`,
+		description: `Send messages to family members through an IM channel configured for THIS container. This tool only acts on the current container (no target container parameter). It is hidden entirely when this container has no IM channel configured. Channels: ${imChannelIds().join(", ") || "(none registered)"}. Actions: send (text) / send-file (a file inside this container) / users (configured aliases) / status (channel health, accounts + current routes) / contacts (people this container has exchanged messages with — use this to find the \`user\` id when adding a route, since that id exists only in the chat logs). Not every channel supports every action (e.g. send-file may return ACTION_UNSUPPORTED). user accepts a configured alias or a raw channel user id. Docs: container_admin config docs im-bridge (how to add a route, where the other party's id comes from). Failures return a stable code plus a remediation hint.`,
 		parameters: {
 			channel: {
 				type: "string",
@@ -22144,7 +22571,7 @@ function createImBridgeTool() {
 				type: "string",
 				enum: [...ACTIONS],
 				required: true,
-				description: "send / send-file / users / status"
+				description: "send / send-file / users / status / contacts"
 			},
 			user: {
 				type: "string",