@michengai/dsh-im-connect 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (162) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +39 -0
  3. package/client.js +1479 -0
  4. package/cordis.patch.yml +4 -0
  5. package/lib/channels/dingtalk-card.d.ts +24 -0
  6. package/lib/channels/dingtalk-card.d.ts.map +1 -0
  7. package/lib/channels/dingtalk-card.js +182 -0
  8. package/lib/channels/dingtalk-card.js.map +1 -0
  9. package/lib/channels/dingtalk.d.ts +7 -0
  10. package/lib/channels/dingtalk.d.ts.map +1 -0
  11. package/lib/channels/dingtalk.js +107 -0
  12. package/lib/channels/dingtalk.js.map +1 -0
  13. package/lib/channels/factory.d.ts +4 -0
  14. package/lib/channels/factory.d.ts.map +1 -0
  15. package/lib/channels/factory.js +24 -0
  16. package/lib/channels/factory.js.map +1 -0
  17. package/lib/channels/feishu.d.ts +8 -0
  18. package/lib/channels/feishu.d.ts.map +1 -0
  19. package/lib/channels/feishu.js +73 -0
  20. package/lib/channels/feishu.js.map +1 -0
  21. package/lib/channels/meta.d.ts +20 -0
  22. package/lib/channels/meta.d.ts.map +1 -0
  23. package/lib/channels/meta.js +69 -0
  24. package/lib/channels/meta.js.map +1 -0
  25. package/lib/channels/qr/dingtalk.d.ts +12 -0
  26. package/lib/channels/qr/dingtalk.d.ts.map +1 -0
  27. package/lib/channels/qr/dingtalk.js +69 -0
  28. package/lib/channels/qr/dingtalk.js.map +1 -0
  29. package/lib/channels/qr/feishu.d.ts +14 -0
  30. package/lib/channels/qr/feishu.d.ts.map +1 -0
  31. package/lib/channels/qr/feishu.js +87 -0
  32. package/lib/channels/qr/feishu.js.map +1 -0
  33. package/lib/channels/qr/hub.d.ts +22 -0
  34. package/lib/channels/qr/hub.d.ts.map +1 -0
  35. package/lib/channels/qr/hub.js +193 -0
  36. package/lib/channels/qr/hub.js.map +1 -0
  37. package/lib/channels/qr/render.d.ts +3 -0
  38. package/lib/channels/qr/render.d.ts.map +1 -0
  39. package/lib/channels/qr/render.js +9 -0
  40. package/lib/channels/qr/render.js.map +1 -0
  41. package/lib/channels/qr/shared.d.ts +39 -0
  42. package/lib/channels/qr/shared.d.ts.map +1 -0
  43. package/lib/channels/qr/shared.js +51 -0
  44. package/lib/channels/qr/shared.js.map +1 -0
  45. package/lib/channels/qr/wecom.d.ts +10 -0
  46. package/lib/channels/qr/wecom.d.ts.map +1 -0
  47. package/lib/channels/qr/wecom.js +81 -0
  48. package/lib/channels/qr/wecom.js.map +1 -0
  49. package/lib/channels/qr/weixin.d.ts +10 -0
  50. package/lib/channels/qr/weixin.d.ts.map +1 -0
  51. package/lib/channels/qr/weixin.js +77 -0
  52. package/lib/channels/qr/weixin.js.map +1 -0
  53. package/lib/channels/telegram.d.ts +7 -0
  54. package/lib/channels/telegram.d.ts.map +1 -0
  55. package/lib/channels/telegram.js +133 -0
  56. package/lib/channels/telegram.js.map +1 -0
  57. package/lib/channels/wecom.d.ts +28 -0
  58. package/lib/channels/wecom.d.ts.map +1 -0
  59. package/lib/channels/wecom.js +168 -0
  60. package/lib/channels/wecom.js.map +1 -0
  61. package/lib/channels/weixin.d.ts +41 -0
  62. package/lib/channels/weixin.d.ts.map +1 -0
  63. package/lib/channels/weixin.js +678 -0
  64. package/lib/channels/weixin.js.map +1 -0
  65. package/lib/client.js +1479 -0
  66. package/lib/engine/access.d.ts +11 -0
  67. package/lib/engine/access.d.ts.map +1 -0
  68. package/lib/engine/access.js +11 -0
  69. package/lib/engine/access.js.map +1 -0
  70. package/lib/engine/agent-options.d.ts +25 -0
  71. package/lib/engine/agent-options.d.ts.map +1 -0
  72. package/lib/engine/agent-options.js +19 -0
  73. package/lib/engine/agent-options.js.map +1 -0
  74. package/lib/engine/approval.d.ts +9 -0
  75. package/lib/engine/approval.d.ts.map +1 -0
  76. package/lib/engine/approval.js +38 -0
  77. package/lib/engine/approval.js.map +1 -0
  78. package/lib/engine/assistant-settings.d.ts +17 -0
  79. package/lib/engine/assistant-settings.d.ts.map +1 -0
  80. package/lib/engine/assistant-settings.js +35 -0
  81. package/lib/engine/assistant-settings.js.map +1 -0
  82. package/lib/engine/credentials.d.ts +17 -0
  83. package/lib/engine/credentials.d.ts.map +1 -0
  84. package/lib/engine/credentials.js +51 -0
  85. package/lib/engine/credentials.js.map +1 -0
  86. package/lib/engine/gateway.d.ts +46 -0
  87. package/lib/engine/gateway.d.ts.map +1 -0
  88. package/lib/engine/gateway.js +333 -0
  89. package/lib/engine/gateway.js.map +1 -0
  90. package/lib/engine/json-state.d.ts +8 -0
  91. package/lib/engine/json-state.d.ts.map +1 -0
  92. package/lib/engine/json-state.js +24 -0
  93. package/lib/engine/json-state.js.map +1 -0
  94. package/lib/engine/merge.d.ts +21 -0
  95. package/lib/engine/merge.d.ts.map +1 -0
  96. package/lib/engine/merge.js +55 -0
  97. package/lib/engine/merge.js.map +1 -0
  98. package/lib/engine/router.d.ts +88 -0
  99. package/lib/engine/router.d.ts.map +1 -0
  100. package/lib/engine/router.js +309 -0
  101. package/lib/engine/router.js.map +1 -0
  102. package/lib/engine/seen-store.d.ts +12 -0
  103. package/lib/engine/seen-store.d.ts.map +1 -0
  104. package/lib/engine/seen-store.js +38 -0
  105. package/lib/engine/seen-store.js.map +1 -0
  106. package/lib/engine/session-id.d.ts +30 -0
  107. package/lib/engine/session-id.d.ts.map +1 -0
  108. package/lib/engine/session-id.js +53 -0
  109. package/lib/engine/session-id.js.map +1 -0
  110. package/lib/engine/session-store.d.ts +13 -0
  111. package/lib/engine/session-store.d.ts.map +1 -0
  112. package/lib/engine/session-store.js +38 -0
  113. package/lib/engine/session-store.js.map +1 -0
  114. package/lib/engine/split.d.ts +2 -0
  115. package/lib/engine/split.d.ts.map +1 -0
  116. package/lib/engine/split.js +41 -0
  117. package/lib/engine/split.js.map +1 -0
  118. package/lib/engine/types.d.ts +52 -0
  119. package/lib/engine/types.d.ts.map +1 -0
  120. package/lib/engine/types.js +2 -0
  121. package/lib/engine/types.js.map +1 -0
  122. package/lib/index.d.ts +22 -0
  123. package/lib/index.d.ts.map +1 -0
  124. package/lib/index.js +53 -0
  125. package/lib/index.js.map +1 -0
  126. package/lib/manager.d.ts +103 -0
  127. package/lib/manager.d.ts.map +1 -0
  128. package/lib/manager.js +543 -0
  129. package/lib/manager.js.map +1 -0
  130. package/package.json +63 -0
  131. package/src/channels/dingtalk-card.ts +191 -0
  132. package/src/channels/dingtalk.ts +113 -0
  133. package/src/channels/factory.ts +32 -0
  134. package/src/channels/feishu.ts +77 -0
  135. package/src/channels/meta.ts +89 -0
  136. package/src/channels/qr/dingtalk.ts +71 -0
  137. package/src/channels/qr/feishu.ts +90 -0
  138. package/src/channels/qr/hub.ts +206 -0
  139. package/src/channels/qr/render.ts +7 -0
  140. package/src/channels/qr/shared.ts +80 -0
  141. package/src/channels/qr/wecom.ts +78 -0
  142. package/src/channels/qr/weixin.ts +78 -0
  143. package/src/channels/telegram.ts +145 -0
  144. package/src/channels/wecom.ts +182 -0
  145. package/src/channels/weixin.ts +712 -0
  146. package/src/engine/access.ts +17 -0
  147. package/src/engine/agent-options.ts +24 -0
  148. package/src/engine/approval.ts +45 -0
  149. package/src/engine/assistant-settings.ts +41 -0
  150. package/src/engine/credentials.ts +64 -0
  151. package/src/engine/gateway.ts +330 -0
  152. package/src/engine/json-state.ts +20 -0
  153. package/src/engine/merge.ts +60 -0
  154. package/src/engine/router.ts +333 -0
  155. package/src/engine/seen-store.ts +36 -0
  156. package/src/engine/session-id.ts +65 -0
  157. package/src/engine/session-store.ts +45 -0
  158. package/src/engine/split.ts +29 -0
  159. package/src/engine/types.ts +55 -0
  160. package/src/index.ts +81 -0
  161. package/src/manager.ts +571 -0
  162. package/src/optional-modules.d.ts +13 -0
@@ -0,0 +1,678 @@
1
+ /**
2
+ * 微信渠道适配器:腾讯官方 iLink Bot 协议(ilinkai.weixin.qq.com)。
3
+ * 与 OpenClaw 官方插件 @tencent-weixin/openclaw-weixin 同协议:
4
+ * - 扫码登录 → 长轮询收消息 → context_token 回复
5
+ * - 媒体收发:图片/语音/文件/视频,CDN AES-128-ECB 加密上传/下载
6
+ * - "正在输入"状态(getconfig → sendtyping)
7
+ *
8
+ * ⚠️ 仅私聊、一个账号一个 poller;建议使用专用小号。
9
+ * 使用本渠道即表示同意《微信ClawBot功能使用条款》(腾讯官方产品,非逆向方案)。
10
+ * @module dsh-im-gateway/channels/wechat
11
+ */
12
+ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
13
+ import { readFile } from 'node:fs/promises';
14
+ import { join, basename } from 'node:path';
15
+ import { createCipheriv, createDecipheriv, createHash, randomBytes } from 'node:crypto';
16
+ const BASE_URL = 'https://ilinkai.weixin.qq.com';
17
+ /** CDN 基址(官方插件同款)。 */
18
+ export const CDN_BASE_URL = 'https://novac2c.cdn.weixin.qq.com/c2c';
19
+ /** 消息 item 类型:1=文本 2=图片 3=语音 4=文件 5=视频。 */
20
+ const ITEM_TEXT = 1;
21
+ const ITEM_IMAGE = 2;
22
+ const ITEM_VOICE = 3;
23
+ const ITEM_FILE = 4;
24
+ const ITEM_VIDEO = 5;
25
+ /** 上传媒体类型:1=图片 2=视频 3=文件。 */
26
+ const UPLOAD_IMAGE = 1;
27
+ const UPLOAD_VIDEO = 2;
28
+ const UPLOAD_FILE = 3;
29
+ // ── AES-128-ECB(CDN 加解密,与官方插件一致)─────────────────────
30
+ /** PKCS7 填充后的密文大小。 */
31
+ export function aesEcbPaddedSize(plaintextSize) {
32
+ return Math.ceil((plaintextSize + 1) / 16) * 16;
33
+ }
34
+ export function encryptAesEcb(plaintext, key) {
35
+ const cipher = createCipheriv('aes-128-ecb', key, null);
36
+ return Buffer.concat([cipher.update(plaintext), cipher.final()]);
37
+ }
38
+ export function decryptAesEcb(ciphertext, key) {
39
+ const decipher = createDecipheriv('aes-128-ecb', key, null);
40
+ return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
41
+ }
42
+ /**
43
+ * 解析 CDNMedia.aes_key 为 16 字节原始 key。
44
+ * 野外有两种编码:base64(16 原始字节)(图片)或 base64(hex 字符串)(文件/语音/视频)。
45
+ */
46
+ export function parseAesKey(aesKeyBase64, label = 'aes') {
47
+ const decoded = Buffer.from(aesKeyBase64, 'base64');
48
+ if (decoded.length === 16)
49
+ return decoded;
50
+ if (decoded.length === 32 && /^[0-9a-fA-F]{32}$/.test(decoded.toString('ascii'))) {
51
+ return Buffer.from(decoded.toString('ascii'), 'hex');
52
+ }
53
+ throw new Error(`${label}: aes_key 无法解析(base64 解码后 ${decoded.length} 字节,应为 16 字节或 32 字符 hex)`);
54
+ }
55
+ /** 构建 CDN 下载 URL。 */
56
+ export function buildCdnDownloadUrl(encryptedQueryParam, cdnBaseUrl = CDN_BASE_URL) {
57
+ return `${cdnBaseUrl}/download?encrypted_query_param=${encodeURIComponent(encryptedQueryParam)}`;
58
+ }
59
+ // ── 工具函数 ────────────────────────────────────────────────────
60
+ function pickStr(obj, ...keys) {
61
+ for (const k of keys) {
62
+ const v = obj[k];
63
+ if (v !== undefined && v !== null && v !== '')
64
+ return String(v);
65
+ }
66
+ return undefined;
67
+ }
68
+ function normalizeId(v) {
69
+ if (typeof v === 'string')
70
+ return v || undefined;
71
+ if (typeof v === 'number' && Number.isFinite(v))
72
+ return String(Math.trunc(v));
73
+ if (v && typeof v === 'object') {
74
+ const inner = pickStr(v, 'id', 'value', 'str');
75
+ if (inner !== undefined)
76
+ return normalizeId(inner);
77
+ }
78
+ return undefined;
79
+ }
80
+ function guessExt(name) {
81
+ const m = name.match(/\.([a-zA-Z0-9]+)$/);
82
+ return m ? `.${m[1].toLowerCase()}` : '.bin';
83
+ }
84
+ export function mimeFromExt(ext) {
85
+ const map = {
86
+ '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png', '.gif': 'image/gif', '.webp': 'image/webp', '.bmp': 'image/bmp',
87
+ '.mp4': 'video/mp4', '.mov': 'video/quicktime', '.avi': 'video/x-msvideo', '.mkv': 'video/x-matroska',
88
+ '.pdf': 'application/pdf', '.doc': 'application/msword', '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
89
+ '.xls': 'application/vnd.ms-excel', '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
90
+ '.zip': 'application/zip', '.txt': 'text/plain', '.md': 'text/markdown', '.json': 'application/json',
91
+ '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.silk': 'audio/silk', '.amr': 'audio/amr',
92
+ };
93
+ return map[ext] ?? 'application/octet-stream';
94
+ }
95
+ /** 从 CDNMedia 取下载 URL(encrypt_query_param 优先,full_url 兜底)。 */
96
+ function cdnUrlOf(mediaRef) {
97
+ if (!mediaRef)
98
+ return undefined;
99
+ const param = pickStr(mediaRef, 'encrypt_query_param');
100
+ if (param)
101
+ return buildCdnDownloadUrl(param);
102
+ return pickStr(mediaRef, 'full_url');
103
+ }
104
+ // ── 渠道工厂 ────────────────────────────────────────────────────
105
+ export function createWeixinChannel(config, log, stateDir) {
106
+ if (!config.enabled)
107
+ return undefined;
108
+ const dir = config.stateDir ?? stateDir;
109
+ const mediaDir = join(dir, 'media');
110
+ const statePath = join(dir, 'wechat-state.json');
111
+ const loginPath = join(dir, 'wechat-login.txt');
112
+ let state = loadState();
113
+ let handler;
114
+ let stopped = false;
115
+ let botToken = '';
116
+ let statusText = '未登录';
117
+ /** 当前登录二维码 URL(UI 轮询用)。 */
118
+ let currentLoginUrl;
119
+ const uin = Buffer.from(String(Math.floor(Math.random() * 0xffffffff)), 'utf8').toString('base64');
120
+ /** typing_ticket 按用户缓存。 */
121
+ const typingTickets = new Map();
122
+ function loadState() {
123
+ try {
124
+ const raw = readFileSync(statePath, 'utf8');
125
+ const parsed = JSON.parse(raw);
126
+ return {
127
+ allowedUserId: parsed.allowedUserId,
128
+ contextTokens: parsed.contextTokens ?? {},
129
+ botToken: parsed.botToken,
130
+ baseUrl: parsed.baseUrl,
131
+ syncBuf: parsed.syncBuf,
132
+ };
133
+ }
134
+ catch {
135
+ return { contextTokens: {} };
136
+ }
137
+ }
138
+ function flush() {
139
+ try {
140
+ mkdirSync(dir, { recursive: true });
141
+ writeFileSync(statePath, JSON.stringify(state, null, 2));
142
+ }
143
+ catch (err) {
144
+ log(`[weixin] 状态落盘失败: ${err instanceof Error ? err.message : String(err)}`);
145
+ }
146
+ }
147
+ function headers() {
148
+ const h = {
149
+ 'content-type': 'application/json',
150
+ 'iLink-App-ClientVersion': '1',
151
+ 'X-WECHAT-UIN': uin,
152
+ };
153
+ if (botToken) {
154
+ h['Authorization'] = `Bearer ${botToken}`;
155
+ h['AuthorizationType'] = 'ilink_bot_token';
156
+ }
157
+ return h;
158
+ }
159
+ async function request(path, body, timeoutMs, tolerateRet1 = false) {
160
+ const baseUrl = state.baseUrl && state.baseUrl.trim() !== '' ? state.baseUrl : BASE_URL;
161
+ const res = await fetch(`${baseUrl}${path}`, {
162
+ method: 'POST',
163
+ headers: headers(),
164
+ body: JSON.stringify(body),
165
+ signal: AbortSignal.timeout(timeoutMs),
166
+ });
167
+ if (!res.ok)
168
+ throw new Error(`weixin ${path} http ${res.status}`);
169
+ const data = (await res.json());
170
+ const ret = Number(data.ret ?? 0);
171
+ const errcode = Number(data.errcode ?? 0);
172
+ if (tolerateRet1 && ret === 1 && errcode === 0)
173
+ return data;
174
+ if (ret !== 0 || errcode !== 0) {
175
+ throw new Error(`weixin ${path} ret=${ret} errcode=${errcode} ${String(data.errmsg ?? '')}`);
176
+ }
177
+ return data;
178
+ }
179
+ async function loginLoop() {
180
+ while (!stopped) {
181
+ let qr;
182
+ try {
183
+ qr = await request('/ilink/bot/get_bot_qrcode?bot_type=3', {}, 15_000);
184
+ }
185
+ catch (err) {
186
+ log(`[weixin] 获取二维码失败,5s 后重试: ${err instanceof Error ? err.message : String(err)}`);
187
+ await sleep(5000);
188
+ continue;
189
+ }
190
+ const qrcodeId = pickStr(qr, 'qrcode', 'qrcode_id');
191
+ const qrUrl = pickStr(qr, 'qrcode_img_content', 'qrcode_url', 'url');
192
+ if (!qrcodeId || !qrUrl) {
193
+ log('[weixin] 二维码字段缺失,5s 后重试');
194
+ await sleep(5000);
195
+ continue;
196
+ }
197
+ statusText = '等待扫码';
198
+ currentLoginUrl = qrUrl;
199
+ log(`[weixin] 请用微信扫码登录: ${qrUrl}`);
200
+ try {
201
+ mkdirSync(dir, { recursive: true });
202
+ writeFileSync(loginPath, `${qrUrl}\n`);
203
+ }
204
+ catch { /* 忽略 */ }
205
+ while (!stopped) {
206
+ let st;
207
+ try {
208
+ st = await request(`/ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(qrcodeId)}`, {}, 40_000, true);
209
+ }
210
+ catch {
211
+ await sleep(2000);
212
+ continue;
213
+ }
214
+ const status = String(st.status ?? '');
215
+ if (Number(st.ret ?? 0) === 0 && status === 'confirmed') {
216
+ const token = pickStr(st, 'bot_token');
217
+ const userId = pickStr(st, 'ilink_user_id');
218
+ if (!token || !userId)
219
+ throw new Error('weixin confirmed 但缺少 token/user');
220
+ botToken = token;
221
+ // 持久化登录态:重启后免扫码
222
+ state.botToken = token;
223
+ const newBaseUrl = pickStr(st, 'baseurl', 'base_url');
224
+ if (newBaseUrl)
225
+ state.baseUrl = newBaseUrl;
226
+ if (!state.allowedUserId) {
227
+ state.allowedUserId = userId;
228
+ log(`[weixin] 已绑定白名单用户 ${userId}(仅该用户可驱动)`);
229
+ }
230
+ else if (state.allowedUserId !== userId) {
231
+ log(`[weixin] 扫码用户 ${userId} 不在白名单(白名单=${state.allowedUserId})`);
232
+ return false;
233
+ }
234
+ flush();
235
+ statusText = '已登录';
236
+ currentLoginUrl = undefined;
237
+ log('[weixin] 登录完成(登录态已保存,重启无需重复扫码)');
238
+ return true;
239
+ }
240
+ if (status === 'expired') {
241
+ log('[weixin] 二维码已过期,重新获取');
242
+ break;
243
+ }
244
+ await sleep(2000);
245
+ }
246
+ }
247
+ return false;
248
+ }
249
+ /** 下载 + 解密 CDN 媒体。 */
250
+ async function downloadCdn(mediaRef, aesKey) {
251
+ const url = cdnUrlOf(mediaRef);
252
+ if (!url)
253
+ return undefined;
254
+ try {
255
+ const res = await fetch(url, { signal: AbortSignal.timeout(60_000) });
256
+ if (!res.ok)
257
+ throw new Error(`CDN 下载 HTTP ${res.status}`);
258
+ const buf = Buffer.from(await res.arrayBuffer());
259
+ const plain = aesKey ? decryptAesEcb(buf, aesKey) : buf;
260
+ return { buf: plain, contentType: res.headers.get('content-type') ?? undefined };
261
+ }
262
+ catch (err) {
263
+ log(`[weixin] 媒体下载失败: ${err instanceof Error ? err.message : String(err)}`);
264
+ return undefined;
265
+ }
266
+ }
267
+ /** 保存媒体字节到媒体目录。 */
268
+ function saveMediaBuf(buf, ext, prefix, name) {
269
+ mkdirSync(mediaDir, { recursive: true });
270
+ const fileName = name ? name.replace(/[^\w.\-\u4e00-\u9fa5]+/g, '_') : `${prefix}-${Date.now()}${ext}`;
271
+ const filePath = join(mediaDir, fileName.endsWith(ext) || fileName.includes('.') ? fileName : `${fileName}${ext}`);
272
+ writeFileSync(filePath, buf);
273
+ return filePath;
274
+ }
275
+ /** 从 media 引用取 AES key(image_item.aeskey hex 优先,media.aes_key base64 兜底)。 */
276
+ function aesKeyOf(mediaRef, hexKey, label) {
277
+ if (hexKey)
278
+ return Buffer.from(hexKey, 'hex');
279
+ if (mediaRef) {
280
+ const b64 = pickStr(mediaRef, 'aes_key');
281
+ if (b64)
282
+ return parseAesKey(b64, label);
283
+ }
284
+ return undefined;
285
+ }
286
+ // ── 媒体下载项(每条媒体一个惰性任务)────────────────────────
287
+ async function downloadImageItem(item) {
288
+ const img = item.image_item;
289
+ const mediaRef = img?.media;
290
+ const aesKey = aesKeyOf(mediaRef, img ? pickStr(img, 'aeskey') : undefined, 'wechat-image');
291
+ const dl = await downloadCdn(mediaRef, aesKey);
292
+ if (!dl)
293
+ return { kind: 'image', name: 'image' };
294
+ // 从 CDN Content-Type 推断真实图片类型(避免 saveImage 校验失败)
295
+ const ct = dl.contentType?.split(';')[0]?.trim().toLowerCase() ?? '';
296
+ const ext = ct === 'image/png' ? '.png' : ct === 'image/gif' ? '.gif' : ct === 'image/webp' ? '.webp' : '.jpg';
297
+ const mediaType = ct.startsWith('image/') ? ct : 'image/jpeg';
298
+ const saved = saveMediaBuf(dl.buf, ext, 'image', `image${ext}`);
299
+ return { kind: 'image', path: saved, mediaType, name: basename(saved) };
300
+ }
301
+ async function downloadVoiceItem(item) {
302
+ const voice = item.voice_item;
303
+ const mediaRef = voice?.media;
304
+ const aesKey = aesKeyOf(mediaRef, undefined, 'wechat-voice');
305
+ const dl = await downloadCdn(mediaRef, aesKey);
306
+ if (!dl)
307
+ return { kind: 'file', name: 'voice.silk' };
308
+ const saved = saveMediaBuf(dl.buf, '.silk', 'voice', 'voice.silk');
309
+ return { kind: 'file', path: saved, mediaType: 'audio/silk', name: basename(saved) };
310
+ }
311
+ async function downloadFileItem(item) {
312
+ const fileItem = item.file_item;
313
+ const mediaRef = fileItem?.media;
314
+ const aesKey = aesKeyOf(mediaRef, undefined, 'wechat-file');
315
+ const dl = await downloadCdn(mediaRef, aesKey);
316
+ const fileName = fileItem ? pickStr(fileItem, 'file_name') ?? 'file.bin' : 'file.bin';
317
+ if (!dl)
318
+ return { kind: 'file', name: fileName };
319
+ const ext = guessExt(fileName);
320
+ const saved = saveMediaBuf(dl.buf, ext, 'file', fileName);
321
+ return { kind: 'file', path: saved, name: fileName, mediaType: mimeFromExt(ext) };
322
+ }
323
+ async function downloadVideoItem(item) {
324
+ const videoItem = item.video_item;
325
+ const mediaRef = videoItem?.media;
326
+ const aesKey = aesKeyOf(mediaRef, undefined, 'wechat-video');
327
+ const dl = await downloadCdn(mediaRef, aesKey);
328
+ if (!dl)
329
+ return { kind: 'video', name: 'video.mp4' };
330
+ const saved = saveMediaBuf(dl.buf, '.mp4', 'video', 'video.mp4');
331
+ return { kind: 'video', path: saved, mediaType: 'video/mp4', name: basename(saved) };
332
+ }
333
+ // ── 入站解析 ─────────────────────────────────────────────────
334
+ /** 解析入站消息:文本 + 媒体(异步下载任务列表)。 */
335
+ function parseInbound(raw) {
336
+ if (!raw || typeof raw !== 'object')
337
+ return null;
338
+ let m = raw;
339
+ if (m.message && typeof m.message === 'object')
340
+ m = { ...m, ...m.message };
341
+ if (m.message_type !== undefined && Number(m.message_type) !== 1)
342
+ return null;
343
+ const fromUserId = pickStr(m, 'from_user_id', 'from_user');
344
+ if (!fromUserId)
345
+ return null;
346
+ const parts = [];
347
+ const media = [];
348
+ if (typeof m.text === 'string')
349
+ parts.push(m.text);
350
+ if (Array.isArray(m.item_list)) {
351
+ for (const rawItem of m.item_list) {
352
+ const it = rawItem;
353
+ const type = Number(it.type ?? 0);
354
+ try {
355
+ if (type === ITEM_TEXT) {
356
+ const textItem = it.text_item;
357
+ const t = textItem ? pickStr(textItem, 'text') : undefined;
358
+ if (t)
359
+ parts.push(t);
360
+ }
361
+ else if (type === ITEM_IMAGE) {
362
+ media.push(Promise.resolve().then(() => downloadImageItem(it)));
363
+ }
364
+ else if (type === ITEM_VOICE) {
365
+ const voiceItem = it.voice_item;
366
+ const asr = voiceItem ? pickStr(voiceItem, 'text') : undefined;
367
+ if (asr) {
368
+ // 官方服务端转文字:直接拼进文本
369
+ parts.push(`[语音] ${asr}`);
370
+ }
371
+ else {
372
+ media.push(Promise.resolve().then(() => downloadVoiceItem(it)));
373
+ }
374
+ }
375
+ else if (type === ITEM_FILE) {
376
+ media.push(Promise.resolve().then(() => downloadFileItem(it)));
377
+ }
378
+ else if (type === ITEM_VIDEO) {
379
+ media.push(Promise.resolve().then(() => downloadVideoItem(it)));
380
+ }
381
+ }
382
+ catch (err) {
383
+ log(`[weixin] 媒体解析失败: ${err instanceof Error ? err.message : String(err)}`);
384
+ }
385
+ }
386
+ }
387
+ const text = parts.join('').trim();
388
+ const messageId = String(normalizeId(m.message_id) ?? normalizeId(m.msg_id) ?? `${fromUserId}:${String(m.create_time_ms ?? m.create_time ?? 0)}`);
389
+ const contextToken = pickStr(m, 'context_token');
390
+ return { fromUserId, contextToken, text, media, messageId };
391
+ }
392
+ async function pollLoop() {
393
+ // 已有保存的登录态 → 跳过扫码直接轮询(重启免扫码)
394
+ if (state.botToken) {
395
+ botToken = state.botToken;
396
+ statusText = '已登录(自动恢复)';
397
+ log('[weixin] 检测到已保存的登录态,跳过扫码直接轮询');
398
+ }
399
+ else if (!(await loginLoop())) {
400
+ return;
401
+ }
402
+ let cursor = state.syncBuf ?? '';
403
+ let staleCount = 0;
404
+ while (!stopped) {
405
+ let data;
406
+ try {
407
+ data = await request('/ilink/bot/getupdates', { get_updates_buf: cursor, base_info: { channel_version: '1.0.0' } }, (config.pollTimeoutSecs ?? 70) * 1000 + 5000);
408
+ }
409
+ catch (err) {
410
+ if (stopped)
411
+ return;
412
+ const msg = err instanceof Error ? err.message : String(err);
413
+ // token 失效(服务端 errcode -14,与官方插件 STALE_TOKEN_ERRCODE 一致)
414
+ if (msg.includes('ret=-14') || msg.includes('errcode=-14') || msg.includes('-14')) {
415
+ staleCount += 1;
416
+ if (staleCount >= 3) {
417
+ log('[weixin] 登录态已失效(连续 3 次),清除登录信息,需要重新扫码');
418
+ state.botToken = undefined;
419
+ state.syncBuf = undefined;
420
+ flush();
421
+ if (!(await loginLoop()))
422
+ return;
423
+ staleCount = 0;
424
+ cursor = state.syncBuf ?? '';
425
+ continue;
426
+ }
427
+ log(`[weixin] 登录态失效(${staleCount}/3),5 分钟后重试(若持续失效请重新扫码)`);
428
+ await sleep(300_000);
429
+ continue;
430
+ }
431
+ staleCount = 0;
432
+ log(`[weixin] 长轮询失败,5s 后重试: ${msg}`);
433
+ await sleep(5000);
434
+ continue;
435
+ }
436
+ staleCount = 0;
437
+ const nextCursor = pickStr(data, 'get_updates_buf', 'cursor', 'sync_buf') ?? cursor;
438
+ if (nextCursor !== cursor) {
439
+ cursor = nextCursor;
440
+ state.syncBuf = cursor;
441
+ }
442
+ const rawList = data.msgs ?? data.messages ?? data.updates;
443
+ if (Array.isArray(rawList)) {
444
+ for (const raw of rawList) {
445
+ try {
446
+ const parsed = parseInbound(raw);
447
+ if (!parsed)
448
+ continue;
449
+ if (parsed.contextToken)
450
+ state.contextTokens[parsed.fromUserId] = parsed.contextToken;
451
+ if (state.allowedUserId && parsed.fromUserId !== state.allowedUserId)
452
+ continue;
453
+ const media = await Promise.all(parsed.media);
454
+ if (parsed.text === '' && media.length === 0)
455
+ continue;
456
+ void handler?.({
457
+ chatId: parsed.fromUserId,
458
+ userId: parsed.fromUserId,
459
+ text: parsed.text,
460
+ media,
461
+ context: { contextToken: parsed.contextToken },
462
+ });
463
+ }
464
+ catch { /* 单条失败跳过 */ }
465
+ }
466
+ }
467
+ flush();
468
+ }
469
+ }
470
+ // ── 出站:文本 / 媒体 / typing ────────────────────────────────
471
+ async function sendRaw(toUserId, item, clientId) {
472
+ const contextToken = state.contextTokens[toUserId];
473
+ await request('/ilink/bot/sendmessage', {
474
+ msg: {
475
+ from_user_id: '',
476
+ to_user_id: toUserId,
477
+ client_id: clientId,
478
+ message_type: 2,
479
+ message_state: 2,
480
+ context_token: contextToken ?? '',
481
+ item_list: [item],
482
+ },
483
+ base_info: { channel_version: '1.0.0' },
484
+ }, 15_000);
485
+ }
486
+ async function sendText(toUserId, text) {
487
+ await sendRaw(toUserId, { type: ITEM_TEXT, text_item: { text } }, `dsh-im-connect:${Date.now()}:${Math.floor(Math.random() * 1e6)}`);
488
+ }
489
+ /** typing:getconfig 拿 ticket(按用户缓存),sendtyping 发状态。 */
490
+ async function sendTypingStatus(toUserId, status) {
491
+ try {
492
+ let cached = typingTickets.get(toUserId);
493
+ if (!cached || Date.now() >= cached.nextFetchAt) {
494
+ const resp = await request('/ilink/bot/getconfig', { ilink_user_id: toUserId, context_token: state.contextTokens[toUserId] ?? '', base_info: { channel_version: '1.0.0' } }, 15_000);
495
+ const ticket = pickStr(resp, 'typing_ticket');
496
+ if (!ticket)
497
+ return;
498
+ cached = { ticket, nextFetchAt: Date.now() + 5 * 60_000 };
499
+ typingTickets.set(toUserId, cached);
500
+ }
501
+ await request('/ilink/bot/sendtyping', { ilink_user_id: toUserId, typing_ticket: cached.ticket, status, base_info: { channel_version: '1.0.0' } }, 10_000);
502
+ }
503
+ catch (err) {
504
+ log(`[weixin] typing 发送失败(忽略): ${err instanceof Error ? err.message : String(err)}`);
505
+ }
506
+ }
507
+ /** 上传本地文件到 CDN(与官方插件流程一致),返回组装媒体项所需参数。 */
508
+ async function uploadToCdn(filePath, toUserId, mediaType) {
509
+ const plaintext = await readFile(filePath);
510
+ const rawsize = plaintext.length;
511
+ const rawfilemd5 = createHash('md5').update(plaintext).digest('hex');
512
+ const filesize = aesEcbPaddedSize(rawsize);
513
+ const filekey = randomBytes(16).toString('hex');
514
+ const aeskey = randomBytes(16);
515
+ const resp = await request('/ilink/bot/getuploadurl', {
516
+ filekey,
517
+ media_type: mediaType,
518
+ to_user_id: toUserId,
519
+ rawsize,
520
+ rawfilemd5,
521
+ filesize,
522
+ no_need_thumb: true,
523
+ aeskey: aeskey.toString('hex'),
524
+ }, 20_000);
525
+ const uploadFullUrl = pickStr(resp, 'upload_full_url')?.trim();
526
+ const uploadParam = pickStr(resp, 'upload_param');
527
+ if (!uploadFullUrl && !uploadParam)
528
+ throw new Error('getuploadurl 未返回上传地址');
529
+ const cdnUrl = uploadFullUrl ?? `${CDN_BASE_URL}/upload?encrypted_query_param=${encodeURIComponent(uploadParam)}&filekey=${encodeURIComponent(filekey)}`;
530
+ const ciphertext = encryptAesEcb(plaintext, aeskey);
531
+ const upRes = await fetch(cdnUrl, {
532
+ method: 'POST',
533
+ headers: { 'content-type': 'application/octet-stream' },
534
+ body: new Uint8Array(ciphertext),
535
+ signal: AbortSignal.timeout(120_000),
536
+ });
537
+ if (upRes.status !== 200) {
538
+ const errMsg = upRes.headers.get('x-error-message') ?? `HTTP ${upRes.status}`;
539
+ throw new Error(`CDN 上传失败: ${errMsg}`);
540
+ }
541
+ const downloadParam = upRes.headers.get('x-encrypted-param');
542
+ if (!downloadParam)
543
+ throw new Error('CDN 上传响应缺少 x-encrypted-param');
544
+ return { downloadParam, aeskeyHex: aeskey.toString('hex'), rawsize, filesizeCiphertext: filesize };
545
+ }
546
+ /** 发送媒体文件(按 MIME 路由 图片/视频/文件),caption 作为前导文本。 */
547
+ async function sendMediaFile(toUserId, filePath, caption) {
548
+ const mime = mimeFromExt(guessExt(filePath));
549
+ const now = Date.now();
550
+ let item;
551
+ if (mime.startsWith('image/')) {
552
+ const up = await uploadToCdn(filePath, toUserId, UPLOAD_IMAGE);
553
+ item = {
554
+ type: ITEM_IMAGE,
555
+ image_item: {
556
+ media: {
557
+ encrypt_query_param: up.downloadParam,
558
+ aes_key: Buffer.from(up.aeskeyHex).toString('base64'),
559
+ encrypt_type: 1,
560
+ },
561
+ mid_size: up.filesizeCiphertext,
562
+ },
563
+ };
564
+ }
565
+ else if (mime.startsWith('video/')) {
566
+ const up = await uploadToCdn(filePath, toUserId, UPLOAD_VIDEO);
567
+ item = {
568
+ type: ITEM_VIDEO,
569
+ video_item: {
570
+ media: {
571
+ encrypt_query_param: up.downloadParam,
572
+ aes_key: Buffer.from(up.aeskeyHex).toString('base64'),
573
+ encrypt_type: 1,
574
+ },
575
+ video_size: up.filesizeCiphertext,
576
+ },
577
+ };
578
+ }
579
+ else {
580
+ const up = await uploadToCdn(filePath, toUserId, UPLOAD_FILE);
581
+ item = {
582
+ type: ITEM_FILE,
583
+ file_item: {
584
+ media: {
585
+ encrypt_query_param: up.downloadParam,
586
+ aes_key: Buffer.from(up.aeskeyHex).toString('base64'),
587
+ encrypt_type: 1,
588
+ },
589
+ file_name: basename(filePath),
590
+ len: String(up.rawsize),
591
+ },
592
+ };
593
+ }
594
+ if (caption)
595
+ await sendText(toUserId, caption);
596
+ await sendRaw(toUserId, item, `dsh-im-connect:${now}`);
597
+ }
598
+ return {
599
+ id: 'weixin',
600
+ label: '微信',
601
+ maxMessageLength: 1200,
602
+ async start() {
603
+ stopped = false;
604
+ statusText = '登录中';
605
+ void pollLoop();
606
+ },
607
+ async stop() {
608
+ stopped = true;
609
+ flush();
610
+ },
611
+ async send(chatId, text) {
612
+ await sendText(chatId, text);
613
+ },
614
+ async sendAction(chatId) {
615
+ await sendTypingStatus(chatId, 1);
616
+ },
617
+ async sendMedia(chatId, filePath, caption) {
618
+ await sendMediaFile(chatId, filePath, caption);
619
+ },
620
+ loginUrl() {
621
+ return currentLoginUrl;
622
+ },
623
+ authorizes(userId) {
624
+ // 已绑定扫码白名单:仅放行该用户(其余在轮询层已过滤)
625
+ if (state.allowedUserId)
626
+ return state.allowedUserId === userId;
627
+ // 尚未登录/未绑定白名单:交给网关全局白名单决定
628
+ return undefined;
629
+ },
630
+ setMessageHandler(h) {
631
+ handler = h;
632
+ },
633
+ status() {
634
+ return statusText;
635
+ },
636
+ };
637
+ }
638
+ function sleep(ms) {
639
+ return new Promise((resolve) => setTimeout(resolve, ms));
640
+ }
641
+ export function weixinStatePath(stateDir) {
642
+ return join(stateDir, 'wechat-state.json');
643
+ }
644
+ export function persistWeixinLogin(stateDir, data) {
645
+ mkdirSync(stateDir, { recursive: true });
646
+ const file = weixinStatePath(stateDir);
647
+ let prev = { contextTokens: {} };
648
+ try {
649
+ const parsed = JSON.parse(readFileSync(file, 'utf8'));
650
+ prev = {
651
+ allowedUserId: parsed.allowedUserId,
652
+ contextTokens: parsed.contextTokens ?? {},
653
+ botToken: parsed.botToken,
654
+ baseUrl: parsed.baseUrl,
655
+ syncBuf: parsed.syncBuf,
656
+ };
657
+ }
658
+ catch { /* 首次写入 */ }
659
+ const next = {
660
+ ...prev,
661
+ botToken: data.botToken,
662
+ allowedUserId: data.allowedUserId || prev.allowedUserId,
663
+ baseUrl: data.baseUrl || prev.baseUrl,
664
+ };
665
+ writeFileSync(file, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
666
+ }
667
+ export function clearWeixinLogin(stateDir) {
668
+ const file = weixinStatePath(stateDir);
669
+ try {
670
+ const parsed = JSON.parse(readFileSync(file, 'utf8'));
671
+ writeFileSync(file, `${JSON.stringify({
672
+ allowedUserId: parsed.allowedUserId,
673
+ contextTokens: parsed.contextTokens ?? {},
674
+ }, null, 2)}\n`, 'utf8');
675
+ }
676
+ catch { /* 无登录态 */ }
677
+ }
678
+ //# sourceMappingURL=weixin.js.map