@shgroup/dsh-serenity-hooks 1.26.17 → 1.27.0

package/lib/weixin-api-b8HLmcPE.js

@@ -0,0 +1,211 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { randomBytes } from "node:crypto";
+//#region src/weixin-api.ts
+/**
+* weixin-api.ts — 微信个人号 iLink Bot API 客户端（F4c-3，v1.27.0 实验性）
+*
+* 纯 fetch 客户端（Node ≥ 18 原生 fetch + node:crypto），零第三方依赖——
+* 对齐 openclaw-weixin 插件 api.ts 语义（协议全解见 docs/weixin-bot-api.md）。
+*
+* 定位：**Mech 传输层**——只做 HTTP 编解码与请求头，不含业务逻辑（路由/会话映射
+* 在 weixin-route.ts / weixin-bridge.ts）。所有函数可单测（fetch 注入 mock）。
+*
+* 关键协议事实（实证裸调 2026-08-31）：
+* - get_bot_qrcode 无需任何凭据即可取码（无 OpenClaw 账号体系/平台审核）
+* - 鉴权后请求头：AuthorizationType: ilink_bot_token + X-WECHAT-UIN（随机防重放）
+*   + Authorization: Bearer <bot_token> + iLink-App-Id/ClientVersion
+* - getupdates 长轮询 35s hold；游标 get_updates_buf 从响应原样带回续传
+* - sendmessage 必须回带 context_token 关联对话
+*/
+var weixin_api_exports = /* @__PURE__ */ __exportAll({
+	ILINK_CDN_BASE_URL: () => ILINK_CDN_BASE_URL,
+	ILINK_DEFAULT_BASE_URL: () => ILINK_DEFAULT_BASE_URL,
+	MessageItemType: () => MessageItemType,
+	MessageState: () => MessageState,
+	MessageType: () => MessageType,
+	buildClientVersion: () => buildClientVersion,
+	fetchQRCode: () => fetchQRCode,
+	getUpdates: () => getUpdates,
+	markdownToPlainText: () => markdownToPlainText,
+	pollQRStatus: () => pollQRStatus,
+	sendTextMessage: () => sendTextMessage
+});
+/** iLink API Base URL（腾讯官方） */
+const ILINK_DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
+/** iLink-App-Id（openclaw-weixin 同款） */
+const ILINK_APP_ID = "bot";
+/** 通道版本（对齐 openclaw-weixin 2.1.1；buildClientVersion 编码） */
+const CHANNEL_VERSION = "2.1.1";
+/** 版本号 → ClientVersion 整数：(major<<16)|(minor<<8)|patch */
+function buildClientVersion(version) {
+	const parts = version.split(".").map((p) => parseInt(p, 10));
+	const major = parts[0] ?? 0;
+	const minor = parts[1] ?? 0;
+	const patch = parts[2] ?? 0;
+	return (major & 255) << 16 | (minor & 255) << 8 | patch & 255;
+}
+const CLIENT_VERSION = buildClientVersion(CHANNEL_VERSION);
+/** 随机 X-WECHAT-UIN（uint32 → base64；每请求不同，防重放） */
+function randomWechatUin() {
+	const uint32 = randomBytes(4).readUInt32BE(0);
+	return Buffer.from(String(uint32), "utf-8").toString("base64");
+}
+function ensureTrailingSlash(url) {
+	return url.endsWith("/") ? url : `${url}/`;
+}
+function buildCommonHeaders() {
+	return {
+		"iLink-App-Id": ILINK_APP_ID,
+		"iLink-App-ClientVersion": String(CLIENT_VERSION)
+	};
+}
+function buildHeaders(token) {
+	return {
+		"Content-Type": "application/json",
+		AuthorizationType: "ilink_bot_token",
+		"X-WECHAT-UIN": randomWechatUin(),
+		...token ? { Authorization: `Bearer ${token}` } : {},
+		...buildCommonHeaders()
+	};
+}
+let currentFetch = (...args) => fetch(...args);
+async function apiGet(params) {
+	const base = ensureTrailingSlash(params.baseUrl);
+	const url = new URL(params.endpoint, base);
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), params.timeoutMs);
+	try {
+		const res = await currentFetch(url.toString(), {
+			method: "GET",
+			headers: buildCommonHeaders(),
+			signal: controller.signal
+		});
+		clearTimeout(timer);
+		const rawText = await res.text();
+		if (!res.ok) throw new Error(`${params.endpoint} ${res.status}: ${rawText}`);
+		return rawText;
+	} catch (err) {
+		clearTimeout(timer);
+		throw err;
+	}
+}
+async function apiPost(params) {
+	const base = ensureTrailingSlash(params.baseUrl);
+	const url = new URL(params.endpoint, base);
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), params.timeoutMs);
+	try {
+		const res = await currentFetch(url.toString(), {
+			method: "POST",
+			headers: buildHeaders(params.token),
+			body: params.body,
+			signal: controller.signal
+		});
+		clearTimeout(timer);
+		const rawText = await res.text();
+		if (!res.ok) throw new Error(`${params.endpoint} ${res.status}: ${rawText}`);
+		return rawText;
+	} catch (err) {
+		clearTimeout(timer);
+		throw err;
+	}
+}
+/** 取登录二维码（无需凭据；实证裸调可用） */
+async function fetchQRCode(params) {
+	const botType = params.botType ?? "3";
+	const rawText = await apiGet({
+		baseUrl: params.baseUrl ?? "https://ilinkai.weixin.qq.com",
+		endpoint: `ilink/bot/get_bot_qrcode?bot_type=${encodeURIComponent(botType)}`,
+		timeoutMs: params.timeoutMs ?? 5e3
+	});
+	return JSON.parse(rawText);
+}
+async function pollQRStatus(params) {
+	try {
+		const rawText = await apiGet({
+			baseUrl: params.baseUrl ?? "https://ilinkai.weixin.qq.com",
+			endpoint: `ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(params.qrcode)}`,
+			timeoutMs: params.timeoutMs ?? 35e3
+		});
+		return JSON.parse(rawText);
+	} catch {
+		return { status: "wait" };
+	}
+}
+/** 长轮询收消息（35s hold；超时返回空 msgs 不报错——对齐 openclaw-weixin） */
+async function getUpdates(params) {
+	const timeout = params.timeoutMs ?? 35e3;
+	try {
+		const rawText = await apiPost({
+			baseUrl: params.baseUrl,
+			endpoint: "ilink/bot/getupdates",
+			body: JSON.stringify({ get_updates_buf: params.getUpdatesBuf ?? "" }),
+			token: params.token,
+			timeoutMs: timeout
+		});
+		return JSON.parse(rawText);
+	} catch (err) {
+		if (err instanceof Error && err.name === "AbortError") return {
+			ret: 0,
+			msgs: [],
+			get_updates_buf: params.getUpdatesBuf
+		};
+		throw err;
+	}
+}
+const MessageType = {
+	NONE: 0,
+	USER: 1,
+	BOT: 2
+};
+const MessageState = {
+	NEW: 0,
+	GENERATING: 1,
+	FINISH: 2
+};
+const MessageItemType = {
+	NONE: 0,
+	TEXT: 1,
+	IMAGE: 2,
+	VOICE: 3,
+	FILE: 4,
+	VIDEO: 5
+};
+/** 发文本消息（必须回带 context_token 关联对话；md→plain 内置——微信不支持 Markdown） */
+async function sendTextMessage(params) {
+	const clientId = params.clientId ?? `dsp-weixin-${randomBytes(4).toString("hex")}`;
+	await apiPost({
+		baseUrl: params.baseUrl,
+		endpoint: "ilink/bot/sendmessage",
+		body: JSON.stringify({ msg: {
+			from_user_id: "",
+			to_user_id: params.toUserId,
+			client_id: clientId,
+			message_type: MessageType.BOT,
+			message_state: MessageState.FINISH,
+			item_list: [{
+				type: MessageItemType.TEXT,
+				text_item: { text: markdownToPlainText(params.text) }
+			}],
+			...params.contextToken ? { context_token: params.contextToken } : {}
+		} }),
+		token: params.token,
+		timeoutMs: params.timeoutMs ?? 15e3
+	});
+}
+/** Markdown → 纯文本（代码块/图片/链接/表格/标题/粗斜体/删除线 7 类） */
+function markdownToPlainText(text) {
+	let result = text;
+	result = result.replace(/```[^\n]*\n?([\s\S]*?)```/g, (_, code) => code.trim());
+	result = result.replace(/!\[[^\]]*\]\([^)]*\)/g, "");
+	result = result.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1");
+	result = result.replace(/^\|.*\|[ \t]*$/gm, "");
+	result = result.replace(/^#+\s*/gm, "");
+	result = result.replace(/\*\*([^*]+)\*\*/g, "$1");
+	result = result.replace(/\*([^*]+)\*/g, "$1");
+	result = result.replace(/`([^`]+)`/g, "$1");
+	result = result.replace(/~~([^~]+)~~/g, "$1");
+	return result.trim();
+}
+//#endregion
+export { sendTextMessage as n, weixin_api_exports as r, getUpdates as t };

package/lib/weixin-api.d.ts

@@ -0,0 +1,119 @@
+/**
+ * weixin-api.ts — 微信个人号 iLink Bot API 客户端（F4c-3，v1.27.0 实验性）
+ *
+ * 纯 fetch 客户端（Node ≥ 18 原生 fetch + node:crypto），零第三方依赖——
+ * 对齐 openclaw-weixin 插件 api.ts 语义（协议全解见 docs/weixin-bot-api.md）。
+ *
+ * 定位：**Mech 传输层**——只做 HTTP 编解码与请求头，不含业务逻辑（路由/会话映射
+ * 在 weixin-route.ts / weixin-bridge.ts）。所有函数可单测（fetch 注入 mock）。
+ *
+ * 关键协议事实（实证裸调 2026-08-31）：
+ * - get_bot_qrcode 无需任何凭据即可取码（无 OpenClaw 账号体系/平台审核）
+ * - 鉴权后请求头：AuthorizationType: ilink_bot_token + X-WECHAT-UIN（随机防重放）
+ *   + Authorization: Bearer <bot_token> + iLink-App-Id/ClientVersion
+ * - getupdates 长轮询 35s hold；游标 get_updates_buf 从响应原样带回续传
+ * - sendmessage 必须回带 context_token 关联对话
+ */
+/** iLink API Base URL（腾讯官方） */
+export declare const ILINK_DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
+/** CDN Base（媒体上传/下载；P3 媒体期用） */
+export declare const ILINK_CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
+/** 版本号 → ClientVersion 整数：(major<<16)|(minor<<8)|patch */
+export declare function buildClientVersion(version: string): number;
+/** fetch 注入点（测试替换；生产 = 全局 fetch） */
+export type FetchLike = typeof fetch;
+/** 测试注入：替换全局 fetch 实现（生产零调用） */
+export declare function __setWeixinFetchForTest(fn: FetchLike | null): void;
+/** 取登录二维码（无需凭据；实证裸调可用） */
+export declare function fetchQRCode(params: {
+    baseUrl?: string;
+    botType?: string;
+    timeoutMs?: number;
+}): Promise<{
+    qrcode: string;
+    qrcode_img_content: string;
+}>;
+/** 扫码状态（轮询；1s 间隔建议，5min 有效） */
+export interface QrStatusResult {
+    status: string;
+    bot_token?: string;
+    ilink_bot_id?: string;
+    baseurl?: string;
+    ilink_user_id?: string;
+    redirect_host?: string;
+}
+export declare function pollQRStatus(params: {
+    baseUrl?: string;
+    qrcode: string;
+    timeoutMs?: number;
+}): Promise<QrStatusResult>;
+export interface WeixinMessageItem {
+    type?: number;
+    msg_id?: string;
+    text_item?: {
+        text?: string;
+    };
+    image_item?: Record<string, unknown>;
+    voice_item?: Record<string, unknown>;
+    file_item?: Record<string, unknown>;
+    video_item?: Record<string, unknown>;
+}
+export interface WeixinMessage {
+    seq?: number;
+    message_id?: number;
+    from_user_id?: string;
+    to_user_id?: string;
+    client_id?: string;
+    create_time_ms?: number;
+    session_id?: string;
+    group_id?: string;
+    message_type?: number;
+    message_state?: number;
+    item_list?: WeixinMessageItem[];
+    context_token?: string;
+}
+export interface GetUpdatesResp {
+    ret?: number;
+    errcode?: number;
+    errmsg?: string;
+    msgs?: WeixinMessage[];
+    get_updates_buf?: string;
+    longpolling_timeout_ms?: number;
+}
+/** 长轮询收消息（35s hold；超时返回空 msgs 不报错——对齐 openclaw-weixin） */
+export declare function getUpdates(params: {
+    baseUrl: string;
+    token: string;
+    getUpdatesBuf?: string;
+    timeoutMs?: number;
+}): Promise<GetUpdatesResp>;
+export declare const MessageType: {
+    readonly NONE: 0;
+    readonly USER: 1;
+    readonly BOT: 2;
+};
+export declare const MessageState: {
+    readonly NEW: 0;
+    readonly GENERATING: 1;
+    readonly FINISH: 2;
+};
+export declare const MessageItemType: {
+    readonly NONE: 0;
+    readonly TEXT: 1;
+    readonly IMAGE: 2;
+    readonly VOICE: 3;
+    readonly FILE: 4;
+    readonly VIDEO: 5;
+};
+/** 发文本消息（必须回带 context_token 关联对话；md→plain 内置——微信不支持 Markdown） */
+export declare function sendTextMessage(params: {
+    baseUrl: string;
+    token: string;
+    toUserId: string;
+    text: string;
+    contextToken?: string;
+    clientId?: string;
+    timeoutMs?: number;
+}): Promise<void>;
+/** Markdown → 纯文本（代码块/图片/链接/表格/标题/粗斜体/删除线 7 类） */
+export declare function markdownToPlainText(text: string): string;

package/lib/weixin-bridge.d.ts

@@ -0,0 +1,56 @@
+/**
+ * weixin-bridge.ts — 微信桥装配（F4c-3，v1.27.0 实验性）
+ *
+ * **CCC 级**：dsh 一个进程含多个 CCC，每个 CCC 独立对接微信桥（S142 用户拍板）——
+ * 扫描 live CCC → 每 CCC 读 weixin 配置（enabled + accounts + routes）→
+ * 启动该 CCC 该账号的 iLink 轮询循环。消息 → weixin-route 路由 → AcpServer 直调
+ * （session/new + session/prompt，同进程不经网络——acp-core 传输无关设计）。
+ *
+ * 实验性质：未配置/未启用 → 完全不启动（零资源占用）。配置变化（面板写入）
+ * → 热重建受影响 CCC 的桥（对齐 gateway 热重建模式）。
+ *
+ * 外部面纯净（D9/D11 延续）：微信桥会话 = 外部面——session/prompt 走
+ * includeTrajectory:false（对外不返回轨迹）；skiff 角色白名单即授权（G9）。
+ */
+import type { Context } from 'cordis';
+import { type WeixinAccountCredential } from './weixin-route.js';
+/**
+ * 处理单条微信消息：路由 → skiff 会话（固定 id 创建/延续）→ 提问 → 回复回写。
+ *
+ * 会话语义：`weixinSessionIdFor(fromUserId)` 固定可重建——同用户长期同一会话；
+ * 进程内已有（getSkiffAgent 命中）→ 延续；无（首次/进程重启）→ createSkiffAgent
+ * 以固定 id 新建（角色不变，记忆从新开始——重启后自动重建，与 3100 问答页同语义）。
+ */
+export declare function handleIncoming(ctx: Context, root: string, _accountId: string, cred: WeixinAccountCredential, msg: {
+    from_user_id?: string;
+    context_token?: string;
+    item_list?: Array<{
+        type?: number;
+        text_item?: {
+            text?: string;
+        };
+    }>;
+}): Promise<void>;
+/**
+ * 启动/重建某 CCC 的桥：读配置 → 对每个 enabled + 有凭据的账号启动轮询循环。
+ * 已存在（配置变化热重建）→ 先停旧循环再启动新的。
+ */
+export declare function syncCccBridge(ctx: Context, root: string): void;
+/** 停止某 CCC 的桥（移除账号/禁用时） */
+export declare function stopCccBridge(root: string): void;
+/** 停止全部桥（插件 dispose） */
+export declare function stopAllBridges(): void;
+/** 桥状态快照（面板数据源）：每 CCC → 每账号 → 轮询健康 */
+export declare function weixinBridgeStatus(): Array<{
+    ccc: string;
+    accounts: Array<{
+        accountId: string;
+        lastPollAt: number;
+        lastError?: string;
+    }>;
+}>;
+/**
+ * 装配（index.ts 调用）：扫描 live CCC 启动桥 + 监听会话变化。
+ * 事件驱动（对齐 autotrajectory v1.26.15）：live 会话出现 → 同步该 CCC 桥。
+ */
+export declare function registerWeixinBridge(ctx: Context): void;