@shgroup/dsh-serenity-hooks 1.82.0 → 1.83.0

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.82.0",
+  "version": "1.83.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 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹声明 = 轨迹目录下的 trajectory.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / 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": {

package/lib/im/bridge.d.ts

@@ -29,6 +29,12 @@ import { type WeixinMessage } from './ilink.js';
 import { resolveInboundTarget, manualOutputFallbackNeeded, type ResolvedInboundTarget } from './inbound-event.js';
 export { manualOutputFallbackNeeded, resolveInboundTarget };
 export type { ResolvedInboundTarget };
+/** 记下最近一次入站带来的 `context_token`（**只存非空**；空串会把好票覆盖成坏票） */
+export declare function rememberContextToken(accountId: string, userId: string, token: string | undefined): void;
+/** 取该用户最近一次的 `context_token`（没有 ⇒ `undefined`，调用方按"裸发"处理并如实回执） */
+export declare function recallContextToken(accountId: string, userId: string): string | undefined;
+/** 测试辅助：清空 context_token 缓存（生产零调用；与 resetWeixinTypingCache 同款） */
+export declare function resetWeixinContextCache(): void;
 /** 测试辅助：清空 typing_ticket 缓存（生产零调用） */
 export declare function resetWeixinTypingCache(): void;
 /**

package/lib/index.js

@@ -9461,15 +9461,51 @@ async function createAndBindTarget(ctx, root, dirName) {
 		createdAsUser: true
 	});
 	const openingNote = deliverCarrierOpening(agent, buildCarrierOpening(parseTrajectoryCode(dirName) ?? dirName, trajectoryDescOf(dirName))) ? ", opening-as-user" : ", ⚠️ 开场白未投递";
+	const titleNote = renameCarrierTitle(ctx, agent, root, dirName);
 	const wsNote = workspaceId !== void 0 ? "" : await attachToWorkspace(ctx, root, sessionId);
 	const viaNote = workspaceId !== void 0 ? ", via-workspaceId(=用户同一形态)" : ", via-cwd+attach";
-	const how = `auto-create(${sessionId}${bound.ok ? ", bound" : `, ⚠️ 绑定写入失败（${bound.code}）`}${viaNote}${openingNote}${wsNote})`;
+	const how = `auto-create(${sessionId}${bound.ok ? ", bound" : `, ⚠️ 绑定写入失败（${bound.code}）`}${viaNote}${openingNote}${titleNote}${wsNote})`;
 	return {
 		agent,
 		how
 	};
 }
 /**
+* 把刚建的载体会话标题**钉成与 `use` 同一形态**（2026-10-21，owner 报「标题不规范」）。
+*
+* ## 为什么单独成函数
+*
+* 它是**全仓第二个**写会话标题的点（第一个是 `use`/`rebuild` 的 `renameDshSessionOnUse`）。
+* 集中在一处，将来若要改命名规则，判据仍在 `namingTitleFor` 一个地方。
+*
+* ## 三者顺序不可换
+*
+* 必须在 ③b（投开场白）**之后**调用：
+* - 开场白让 `titleInput.count` > 0，是标题得以成立的前提；
+* - 放在之后还有**降级好处**：万一 `rename` 失败，宿主自己的 fallback 标题仍在
+*   （难看但存在），而不是两者皆无。
+*
+* @returns 回执片段（成功 `, titled` ／ 失败 `, ⚠️ 标题未写（原因）`）—— **必须出声**，
+*   否则"标题没写"会表现成"这条轨迹就是这名字"（D186：守卫可以拒绝，但不许不出声）。
+*/
+function renameCarrierTitle(ctx, agent, root, dirName) {
+	try {
+		const titles = hostService(ctx, "sessionTitle");
+		if (!titles || typeof titles.rename !== "function") return ", ⚠️ 标题未写（sessionTitle 不可用）";
+		const session = agent.session;
+		if (!session || typeof session !== "object") return ", ⚠️ 标题未写（无 session）";
+		const title = namingTitleFor({
+			sessionId: parseTrajectoryCode(dirName) ?? dirName,
+			dirName,
+			mdPath: join(root, "AGENT_SESSIONS", dirName, "SESSION.md")
+		});
+		titles.rename(session, title);
+		return ", titled";
+	} catch (err) {
+		return `, ⚠️ 标题未写（${String(err?.message ?? err)}）`;
+	}
+}
+/**
 * 把刚建的会话挂进 **cwd 所属的那个工作区**（2026-10-17 缺陷修复）。
 *
 * 🔴 **为什么必须我们自己做（宿主源码取证，不是推断）**：
@@ -19776,7 +19812,9 @@ function installFeishuAccountImpl() {
 var bridge_exports = /* @__PURE__ */ __exportAll({
 	handleIncoming: () => handleIncoming,
 	handleMachineIncoming: () => handleMachineIncoming,
+	recallContextToken: () => recallContextToken,
 	registerWeixinBridge: () => registerWeixinBridge,
+	rememberContextToken: () => rememberContextToken,
 	resolveInboundTarget: () => resolveInboundTarget,
 	resolveWeixinAccount: () => resolveWeixinAccount,
 	sendProactiveText: () => sendProactiveText,
@@ -19800,6 +19838,52 @@ const MACHINE_SCOPE = "<machine>";
 const machineLoops = /* @__PURE__ */ new Map();
 /** typing_ticket 缓存（每 (accountId, fromUserId)；getconfig 一次后续复用——对齐参考实现 typingTicketCache） */
 const typingTicketByUser = /* @__PURE__ */ new Map();
+/**
+* 🔴 **最近一次 `context_token` 缓存**（每 `(accountId, userId)`）—— 2026-10-21，owner 报
+* 「久不在微信发言，认知轨迹主动发消息就不通」。
+*
+* ## 为什么必须有它（协议规范，不是我们的发明）
+*
+* 微信 iLink 协议的 `context_token` **不是"用户 ID"**，而是
+* **「当前对话上下文的会话能力令牌」**（[公开协议规范] §5.10）。规范逐字：
+*
+* - **文本回复：必填。图片/文件/视频回复：必填。**（§6.4）
+* - 「以 `(accountId, userId)` 为 key **缓存最近一次 `context_token`**」（§5.10 工程建议）
+* - 「**主动发消息能力**：公开实现普遍依赖**最近一次入站消息**带来的 `context_token`」（§12 对比表）
+*   —— 这是微信相对 Telegram/Slack 的**根本差异**（那两家只要知道 chat_id 就行）。
+* - 「协议里**未观察到**单独"打开会话"的 API」（§5.10）⇒ **没有任何办法主动"开一个会话"**，
+*   只能靠人发一条消息来刷新这张票。
+*
+* ## 🔴 修前我们是什么状态
+*
+* 收到 token 后**只用一次就丢**（唯一消费点是"回复这一条消息"）⇒ 那条回复发完，
+* 手上就**再没有票**了 ⇒ 之后任何**主动**发送都是裸发（不带 `context_token`）。
+* ⇒ 这与 owner 的观察完全吻合：**刚聊过就通**（票还在窗口内/刚被刷新），**隔久了就不通**。
+* ⚠️ 这**不是心跳问题** —— 规范里根本没有心跳；是**票没留住**。
+*
+* ## 边界（照规范原话）
+*
+* - **不跨用户复用、不跨 bot 账号复用**（key 含 accountId 与 userId 两段）。
+* - **不伪造 token**：只存服务端真给过的。
+* - **进程重启即丢失**（内存缓存）——规范也确认这条，因为**没有开新会话的 API**；
+*   重启后的第一条主动消息仍可能失败，这是**平台限制**，由 O3 的失败文案如实告知。
+*/
+const contextTokenByUser = /* @__PURE__ */ new Map();
+/** context_token 的缓存键（与 typing 同款两段式，但**语义不同**：这里存的是会话票） */
+function contextCacheKey(accountId, userId) {
+	return `${accountId}|${userId}`;
+}
+/** 记下最近一次入站带来的 `context_token`（**只存非空**；空串会把好票覆盖成坏票） */
+function rememberContextToken(accountId, userId, token) {
+	if (!userId) return;
+	const t = (token ?? "").trim();
+	if (t === "") return;
+	contextTokenByUser.set(contextCacheKey(accountId, userId), t);
+}
+/** 取该用户最近一次的 `context_token`（没有 ⇒ `undefined`，调用方按"裸发"处理并如实回执） */
+function recallContextToken(accountId, userId) {
+	return contextTokenByUser.get(contextCacheKey(accountId, userId));
+}
 function typingCacheKey(accountId, fromUserId) {
 	return `${accountId}|${fromUserId}`;
 }
@@ -19880,6 +19964,7 @@ async function sendTypingStop(cred, accountId, fromUserId) {
 async function handleIncoming(ctx, root, accountId, cred, msg, preset) {
 	const fromUserId = msg.from_user_id;
 	if (!fromUserId) return;
+	rememberContextToken(accountId, fromUserId, msg.context_token);
 	await handleInboundEvent(ctx, root, accountId, {
 		sendText: async ({ toUserId, text, replyRef }) => {
 			await sendTextMessage({
@@ -20210,18 +20295,45 @@ async function sendProactiveText(input) {
 	const { accountId, cred } = account;
 	const trajectory = matchWeixinRoute(settings.routes ?? [], toUserId) ?? "";
 	const sessionId = weixinSessionIdForTrajectory(trajectory !== "" ? trajectory : sanitizeFileName$1(toUserId) || "unknown");
+	/**
+	* 🔴 **带上最近一次的 `context_token`**（2026-10-21，协议规范 §5.10/§6.4）。
+	*
+	* 修前这里是**裸发**（`sendTextMessage` 不传 `contextToken`）。而规范把 `context_token`
+	* 定为「会话能力令牌」：主动发送**依赖最近一次入站消息**带来的那张票（§12 对比表逐字：
+	* 这正是微信相对 Telegram/Slack 的根本差异）。
+	* ⇒ 没有票时，服务端无法把消息关联到对话窗口 ⇒ 表现为"久不发言就发不出去"。
+	*
+	* ⚠️ **仍然允许无票发送**（不改成硬拒绝）：修前就是这么发的，而且**部分时机它是能成功的**
+	* （票还在服务端窗口内的那些时刻）。改成硬拒绝 = 把"有时能发"变成"永远不发"。
+	* ⇒ 取**尽力而为 + 如实回执**：能带就带；没票照发，但把"没票"这件事**写进回执**，
+	* 让人知道这一条是"运气发出去的"（D186：可以降级，但不许不出声）。
+	*/
+	const contextToken = recallContextToken(accountId, toUserId);
 	try {
 		await sendTextMessage({
 			baseUrl: cred.baseUrl,
 			token: cred.token,
 			toUserId,
-			text: input.text
+			text: input.text,
+			...contextToken === void 0 ? {} : { contextToken }
 		});
 	} catch (err) {
+		/**
+		* 🔴 **失败必须落盘**（2026-10-21，O1）。修前失败只回给调用方、**不写任何流水**
+		* （outgoing hook 只在**成功后**触发）⇒ 「失败过没有、失败成什么样」在盘上不可见
+		* ⇒ 下次报障只能猜。这里补上**只有失败才会产生**的那行日志。
+		*
+		* ⚠️ 按规范 §11：`ret=-2` 在社区实现里被误报成"rate limited"，
+		*    而真因常是**缺 `context_token`**（第三方实测）⇒ 故把「有没有票」一起记进日志，
+		*    这样一眼能分辨"票的问题"还是"账号/网络的问题"。
+		*/
+		const detail = err instanceof Error ? err.message : String(err);
+		console.warn(`[serenity-hooks] ✗ im 主动发送失败: account=${accountId} user=${toUserId} contextToken=${contextToken === void 0 ? "ABSENT(无票，裸发)" : "present"} err=${detail}`);
 		return {
 			ok: false,
 			code: "SEND_FAILED",
-			error: `发送失败: ${err instanceof Error ? err.message : String(err)}`
+			error: `发送失败: ${detail}`,
+			...contextToken === void 0 ? { remediation: "该用户近期未发过消息 ⇒ 手上没有 context_token（会话能力令牌）。协议没有\"主动开新会话\"的 API ⇒ 请先让用户在微信里发一条消息激活会话，再重试。" } : {}
 		};
 	}
 	if (settings.hook) invokeWeixinHook(root, settings.hook, buildOutgoingHookEvent({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.82.0",
+  "version": "1.83.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 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹声明 = 轨迹目录下的 trajectory.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / skiff.json 仍在读取族里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
   "license": "MIT",
   "repository": {