@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,206 @@
1
+ /** 渠道扫码会话:同一渠道同时只保留一次尝试。 */
2
+ import type { ChannelId } from '../../engine/session-id.js'
3
+ import { CHANNEL_META } from '../meta.js'
4
+ import { qrPayloadOf, remainingSeconds, sleep, type PairingBegin, type PairingPhase, type PairingView } from './shared.js'
5
+ import { renderQrDataUrl } from './render.js'
6
+ import { beginDingtalkQr } from './dingtalk.js'
7
+ import { beginFeishuQr } from './feishu.js'
8
+ import { beginWecomQr } from './wecom.js'
9
+ import { beginWeixinQr } from './weixin.js'
10
+
11
+ export interface PairingHubOptions {
12
+ onSuccess?: (channelId: ChannelId, credentials: Record<string, string>) => Promise<void>
13
+ log?: (line: string) => void
14
+ }
15
+
16
+ interface Session {
17
+ channelId: ChannelId
18
+ status: PairingPhase
19
+ qrUrl?: string
20
+ qrImage?: string
21
+ expiresAt?: number
22
+ pollIntervalMs: number
23
+ hint?: string
24
+ error?: string
25
+ extra?: Record<string, string>
26
+ controller: AbortController
27
+ begin?: PairingBegin
28
+ }
29
+
30
+ export class PairingHub {
31
+ private readonly sessions = new Map<string, Session>()
32
+ private readonly onSuccess?: PairingHubOptions['onSuccess']
33
+ private readonly log: (line: string) => void
34
+
35
+ constructor(options: PairingHubOptions = {}) {
36
+ this.onSuccess = options.onSuccess
37
+ this.log = options.log ?? (() => undefined)
38
+ }
39
+
40
+ supports(id: ChannelId): boolean {
41
+ const kind = CHANNEL_META[id]?.kind
42
+ return kind === 'qr' || kind === 'qr-or-credentials'
43
+ }
44
+
45
+ view(id: ChannelId): PairingView {
46
+ const session = this.sessions.get(id)
47
+ if (!session) return { channelId: id, status: 'idle' }
48
+ return {
49
+ channelId: id,
50
+ status: session.status,
51
+ qrUrl: session.qrUrl,
52
+ qrImage: session.qrImage,
53
+ expiresAt: session.expiresAt,
54
+ remainingSeconds: remainingSeconds(session.expiresAt),
55
+ hint: session.hint,
56
+ error: session.error,
57
+ }
58
+ }
59
+
60
+ async start(id: ChannelId, extra: Record<string, string> = {}): Promise<PairingView> {
61
+ if (!this.supports(id)) throw new Error(`${id} 不支持扫码绑定`)
62
+ this.cancel(id)
63
+ const session: Session = {
64
+ channelId: id,
65
+ status: 'starting',
66
+ pollIntervalMs: 3000,
67
+ extra,
68
+ controller: new AbortController(),
69
+ }
70
+ this.sessions.set(id, session)
71
+ try {
72
+ const begun = await this.begin(id, session.controller.signal)
73
+ if (this.sessions.get(id) !== session) return this.view(id)
74
+ session.begin = begun
75
+ const payload = qrPayloadOf(begun)
76
+ session.qrUrl = payload.qrUrl
77
+ session.qrImage = payload.qrImage
78
+ if (!session.qrImage && session.qrUrl) {
79
+ try { session.qrImage = await renderQrDataUrl(session.qrUrl) } catch { /* 前端再兜底 */ }
80
+ }
81
+ session.expiresAt = begun.expiresAt
82
+ session.pollIntervalMs = begun.pollIntervalMs
83
+ session.status = 'waiting'
84
+ session.hint = hintOf(id)
85
+ void this.loop(session)
86
+ return this.view(id)
87
+ } catch (error) {
88
+ if (this.sessions.get(id) !== session) return this.view(id)
89
+ session.status = 'failed'
90
+ session.error = error instanceof Error ? error.message : String(error)
91
+ this.log(`[pairing] ${id} 生成二维码失败:${session.error}`)
92
+ return this.view(id)
93
+ }
94
+ }
95
+
96
+ async refresh(id: ChannelId): Promise<PairingView> {
97
+ const extra = this.sessions.get(id)?.extra ?? {}
98
+ return this.start(id, extra)
99
+ }
100
+
101
+ cancel(id: ChannelId): PairingView {
102
+ const session = this.sessions.get(id)
103
+ if (!session) return this.view(id)
104
+ session.controller.abort()
105
+ if (session.status !== 'success') {
106
+ session.status = 'cancelled'
107
+ session.qrUrl = undefined
108
+ session.qrImage = undefined
109
+ }
110
+ return this.view(id)
111
+ }
112
+
113
+ dispose(): void {
114
+ for (const id of [...this.sessions.keys()]) this.cancel(id as ChannelId)
115
+ this.sessions.clear()
116
+ }
117
+
118
+ private async begin(id: ChannelId, signal: AbortSignal): Promise<PairingBegin> {
119
+ switch (id) {
120
+ case 'wecom':
121
+ return beginWecomQr(signal)
122
+ case 'dingtalk':
123
+ return beginDingtalkQr(signal)
124
+ case 'feishu':
125
+ return beginFeishuQr('feishu', signal)
126
+ case 'lark':
127
+ return beginFeishuQr('lark', signal)
128
+ case 'weixin':
129
+ return beginWeixinQr(signal)
130
+ default:
131
+ throw new Error(`${id} 不支持扫码绑定`)
132
+ }
133
+ }
134
+
135
+ private async loop(session: Session): Promise<void> {
136
+ const begun = session.begin
137
+ if (!begun) return
138
+ while (!session.controller.signal.aborted && this.sessions.get(session.channelId) === session) {
139
+ if (session.expiresAt && Date.now() >= session.expiresAt) {
140
+ session.status = 'expired'
141
+ session.error = '二维码已过期'
142
+ session.qrUrl = undefined
143
+ session.qrImage = undefined
144
+ return
145
+ }
146
+ try {
147
+ const polled = await begun.poll(session.controller.signal)
148
+ if (this.sessions.get(session.channelId) !== session) return
149
+ if (polled.pollIntervalMs) session.pollIntervalMs = polled.pollIntervalMs
150
+ if (polled.status === 'success' && polled.credentials) {
151
+ session.status = 'success'
152
+ session.qrUrl = undefined
153
+ session.qrImage = undefined
154
+ session.hint = '绑定成功'
155
+ const credentials = { ...session.extra, ...polled.credentials }
156
+ try {
157
+ await this.onSuccess?.(session.channelId, credentials)
158
+ } catch (error) {
159
+ session.status = 'failed'
160
+ session.error = error instanceof Error ? error.message : String(error)
161
+ this.log(`[pairing] ${session.channelId} 保存凭据失败:${session.error}`)
162
+ }
163
+ return
164
+ }
165
+ if (polled.status === 'scanned') {
166
+ session.status = 'scanned'
167
+ session.hint = '已扫码,请在手机上确认'
168
+ } else if (polled.status === 'expired' || polled.status === 'failed') {
169
+ session.status = polled.status
170
+ session.error = polled.error
171
+ session.qrUrl = undefined
172
+ session.qrImage = undefined
173
+ return
174
+ } else if (session.status !== 'scanned') {
175
+ session.status = 'waiting'
176
+ }
177
+ } catch (error) {
178
+ if (session.controller.signal.aborted) return
179
+ this.log(`[pairing] ${session.channelId} 轮询失败:${error instanceof Error ? error.message : String(error)}`)
180
+ }
181
+ try {
182
+ await sleep(session.pollIntervalMs, session.controller.signal)
183
+ } catch {
184
+ return
185
+ }
186
+ }
187
+ }
188
+ }
189
+
190
+ function hintOf(id: ChannelId): string {
191
+ switch (id) {
192
+ case 'weixin':
193
+ return '请使用微信扫描二维码完成绑定'
194
+ case 'feishu':
195
+ return '请使用飞书扫描二维码,将自动创建机器人'
196
+ case 'lark':
197
+ return '请使用 Lark 扫描二维码完成配对'
198
+ case 'wecom':
199
+ return '请使用企业微信扫描二维码,快捷绑定机器人'
200
+ case 'dingtalk':
201
+ return '请使用钉钉扫描二维码,自动创建机器人'
202
+ default:
203
+ return '请使用对应 App 扫描二维码'
204
+ }
205
+ }
206
+
@@ -0,0 +1,7 @@
1
+ /** 把扫码内容画成本地 data URL,避免前端把链接当成图片。 */
2
+ export async function renderQrDataUrl(payload: string): Promise<string> {
3
+ const QRCode = await import('qrcode') as { default?: { toDataURL(text: string, opts?: object): Promise<string> }; toDataURL?(text: string, opts?: object): Promise<string> }
4
+ const toDataURL = QRCode.toDataURL ?? QRCode.default?.toDataURL
5
+ if (!toDataURL) throw new Error('缺少二维码生成库 qrcode')
6
+ return toDataURL(payload, { width: 240, margin: 1, errorCorrectionLevel: 'M' })
7
+ }
@@ -0,0 +1,80 @@
1
+ /** 扫码绑定公共工具。 */
2
+
3
+ export function cleanString(value: unknown): string | undefined {
4
+ return typeof value === 'string' && value.trim() ? value.trim() : undefined
5
+ }
6
+
7
+ export function asRecord(value: unknown): Record<string, unknown> {
8
+ return value && typeof value === 'object' && !Array.isArray(value)
9
+ ? value as Record<string, unknown>
10
+ : {}
11
+ }
12
+
13
+ export async function readJson(response: Response, label: string): Promise<Record<string, unknown>> {
14
+ let body: unknown
15
+ try {
16
+ body = await response.json()
17
+ } catch (error) {
18
+ throw new Error(`${label} 返回了非 JSON`, { cause: error })
19
+ }
20
+ if (!response.ok) throw new Error(`${label} HTTP ${response.status}`)
21
+ return asRecord(body)
22
+ }
23
+
24
+ export function sleep(ms: number, signal?: AbortSignal): Promise<void> {
25
+ return new Promise((resolve, reject) => {
26
+ if (signal?.aborted) {
27
+ reject(signal.reason ?? new Error('aborted'))
28
+ return
29
+ }
30
+ const timer = setTimeout(resolve, ms)
31
+ signal?.addEventListener('abort', () => {
32
+ clearTimeout(timer)
33
+ reject(signal.reason ?? new Error('aborted'))
34
+ }, { once: true })
35
+ })
36
+ }
37
+
38
+ export function remainingSeconds(expiresAt?: number, now = Date.now()): number | undefined {
39
+ if (!expiresAt) return undefined
40
+ return Math.max(0, Math.ceil((expiresAt - now) / 1000))
41
+ }
42
+
43
+ export type PairingPhase = 'idle' | 'starting' | 'waiting' | 'scanned' | 'success' | 'expired' | 'failed' | 'cancelled'
44
+
45
+ export interface PairingView {
46
+ channelId: string
47
+ status: PairingPhase
48
+ qrUrl?: string
49
+ qrImage?: string
50
+ expiresAt?: number
51
+ remainingSeconds?: number
52
+ hint?: string
53
+ error?: string
54
+ }
55
+
56
+ export interface PairingBegin {
57
+ qrUrl?: string
58
+ qrImage?: string
59
+ expiresAt?: number
60
+ pollIntervalMs: number
61
+ poll: (signal?: AbortSignal) => Promise<PairingPoll>
62
+ }
63
+
64
+ export interface PairingPoll {
65
+ status: 'waiting' | 'scanned' | 'success' | 'expired' | 'failed'
66
+ credentials?: Record<string, string>
67
+ error?: string
68
+ pollIntervalMs?: number
69
+ }
70
+ export function isRasterQr(value?: string): boolean {
71
+ if (!value) return false
72
+ return /^data:image\//i.test(value) || /\.(png|jpe?g|gif|webp)(\?|$)/i.test(value)
73
+ }
74
+
75
+ export function qrPayloadOf(begun: { qrUrl?: string; qrImage?: string }): { qrUrl?: string; qrImage?: string } {
76
+ if (isRasterQr(begun.qrImage)) return { qrUrl: begun.qrUrl, qrImage: begun.qrImage }
77
+ const qrUrl = begun.qrUrl || begun.qrImage
78
+ return { qrUrl, qrImage: undefined }
79
+ }
80
+
@@ -0,0 +1,78 @@
1
+ /** 企业微信扫码:快捷绑定拿 Bot ID + Secret。 */
2
+ import { asRecord, cleanString, readJson, type PairingBegin, type PairingPoll } from './shared.js'
3
+
4
+ const GENERATE_URL = 'https://work.weixin.qq.com/ai/qc/generate'
5
+ const POLL_URL = 'https://work.weixin.qq.com/ai/qc/query_result'
6
+ const QR_TTL_MS = 5 * 60_000
7
+ const POLL_INTERVAL_MS = 3_000
8
+
9
+ function defaultPlatform(): number {
10
+ if (process.platform === 'win32') return 2
11
+ if (process.platform === 'linux') return 3
12
+ return 1
13
+ }
14
+
15
+ function safeVerificationUrl(value: unknown): string | undefined {
16
+ const raw = cleanString(value)
17
+ if (!raw) return undefined
18
+ try {
19
+ const url = new URL(raw)
20
+ return url.protocol === 'https:' && url.hostname === 'work.weixin.qq.com' && (!url.port || url.port === '443')
21
+ ? url.href
22
+ : undefined
23
+ } catch {
24
+ return undefined
25
+ }
26
+ }
27
+
28
+ export function parseWecomGenerate(body: unknown, now = Date.now()): { scode: string; verificationUrl: string; expiresAt: number } {
29
+ const data = asRecord(asRecord(body).data)
30
+ const scode = cleanString(data.scode)
31
+ const verificationUrl = safeVerificationUrl(data.auth_url)
32
+ if (!scode || !verificationUrl) throw new Error('企业微信二维码服务返回数据不完整')
33
+ return { scode, verificationUrl, expiresAt: now + QR_TTL_MS }
34
+ }
35
+
36
+ export function parseWecomPoll(body: unknown): PairingPoll {
37
+ const data = asRecord(asRecord(body).data)
38
+ const state = cleanString(data.status)?.toLowerCase()
39
+ if (state === 'success') {
40
+ const bot = asRecord(data.bot_info)
41
+ const botId = cleanString(bot.botid) ?? cleanString(bot.botId)
42
+ const secret = cleanString(bot.secret)
43
+ if (!botId || !secret) throw new Error('企业微信扫码结果缺少 Bot 凭据')
44
+ return { status: 'success', credentials: { botId, secret } }
45
+ }
46
+ if (state === 'expired' || state === 'timeout') return { status: 'expired', error: '二维码已过期' }
47
+ if (state === 'fail' || state === 'failed' || state === 'error') return { status: 'failed', error: '扫码未完成' }
48
+ return { status: 'waiting' }
49
+ }
50
+
51
+ export async function beginWecomQr(signal?: AbortSignal): Promise<PairingBegin> {
52
+ const url = new URL(GENERATE_URL)
53
+ url.searchParams.set('source', 'dsh-im-connect')
54
+ url.searchParams.set('plat', String(defaultPlatform()))
55
+ const body = await readJson(await fetch(url, {
56
+ method: 'GET',
57
+ redirect: 'error',
58
+ signal: signal ?? AbortSignal.timeout(10_000),
59
+ headers: { accept: 'application/json' },
60
+ }), '企业微信生成二维码')
61
+ const begun = parseWecomGenerate(body)
62
+ return {
63
+ qrUrl: begun.verificationUrl,
64
+ expiresAt: begun.expiresAt,
65
+ pollIntervalMs: POLL_INTERVAL_MS,
66
+ poll: async (pollSignal) => {
67
+ const pollUrl = new URL(POLL_URL)
68
+ pollUrl.searchParams.set('scode', begun.scode)
69
+ const polled = await readJson(await fetch(pollUrl, {
70
+ method: 'GET',
71
+ redirect: 'error',
72
+ signal: pollSignal ?? AbortSignal.timeout(10_000),
73
+ headers: { accept: 'application/json' },
74
+ }), '企业微信查询扫码')
75
+ return parseWecomPoll(polled)
76
+ },
77
+ }
78
+ }
@@ -0,0 +1,78 @@
1
+ /** 微信 iLink 扫码登录。 */
2
+ import { asRecord, cleanString, type PairingBegin, type PairingPoll } from './shared.js'
3
+
4
+ const BASE_URL = 'https://ilinkai.weixin.qq.com'
5
+
6
+ function pickStr(obj: Record<string, unknown>, ...keys: string[]): string | undefined {
7
+ for (const key of keys) {
8
+ const value = cleanString(obj[key])
9
+ if (value) return value
10
+ }
11
+ return undefined
12
+ }
13
+
14
+ export function weixinHeaders(uin = Buffer.from(String(Math.floor(Math.random() * 0xffffffff)), 'utf8').toString('base64')): Record<string, string> {
15
+ return {
16
+ 'content-type': 'application/json',
17
+ 'iLink-App-ClientVersion': '1',
18
+ 'X-WECHAT-UIN': uin,
19
+ }
20
+ }
21
+
22
+ export function parseWeixinQr(body: unknown): { qrcodeId: string; qrUrl: string } {
23
+ const record = asRecord(body)
24
+ const qrcodeId = pickStr(record, 'qrcode', 'qrcode_id')
25
+ const qrUrl = pickStr(record, 'qrcode_img_content', 'qrcode_url', 'url')
26
+ if (!qrcodeId || !qrUrl) throw new Error('微信二维码字段缺失')
27
+ return { qrcodeId, qrUrl }
28
+ }
29
+
30
+ export function parseWeixinStatus(body: unknown): PairingPoll {
31
+ const record = asRecord(body)
32
+ const status = String(record.status ?? '')
33
+ if (Number(record.ret ?? 0) === 0 && status === 'confirmed') {
34
+ const botToken = pickStr(record, 'bot_token')
35
+ const allowedUserId = pickStr(record, 'ilink_user_id')
36
+ const baseUrl = pickStr(record, 'baseurl', 'base_url')
37
+ if (!botToken) throw new Error('微信确认登录但缺少 token')
38
+ const credentials: Record<string, string> = { botToken, bound: '1' }
39
+ if (allowedUserId) credentials.allowedUserId = allowedUserId
40
+ if (baseUrl) credentials.baseUrl = baseUrl
41
+ return { status: 'success', credentials }
42
+ }
43
+ if (status === 'expired') return { status: 'expired', error: '二维码已过期' }
44
+ if (status === 'scaned' || status === 'scanned') return { status: 'scanned' }
45
+ return { status: 'waiting' }
46
+ }
47
+
48
+ async function post(path: string, headers: Record<string, string>, signal?: AbortSignal): Promise<Record<string, unknown>> {
49
+ const response = await fetch(`${BASE_URL}${path}`, {
50
+ method: 'POST',
51
+ headers,
52
+ body: '{}',
53
+ signal: signal ?? AbortSignal.timeout(40_000),
54
+ })
55
+ if (!response.ok) throw new Error(`微信 ${path} HTTP ${response.status}`)
56
+ const data = asRecord(await response.json())
57
+ const ret = Number(data.ret ?? 0)
58
+ const errcode = Number(data.errcode ?? 0)
59
+ if (path.includes('get_qrcode_status') && ret === 1 && errcode === 0) return data
60
+ if (ret !== 0 || errcode !== 0) throw new Error(`微信 ${path} ret=${ret} errcode=${errcode}`)
61
+ return data
62
+ }
63
+
64
+ export async function beginWeixinQr(signal?: AbortSignal): Promise<PairingBegin> {
65
+ const headers = weixinHeaders()
66
+ const begun = parseWeixinQr(await post('/ilink/bot/get_bot_qrcode?bot_type=3', headers, signal ?? AbortSignal.timeout(15_000)))
67
+ return {
68
+ qrUrl: begun.qrUrl,
69
+ expiresAt: Date.now() + 5 * 60_000,
70
+ pollIntervalMs: 2000,
71
+ poll: async (pollSignal) => parseWeixinStatus(await post(
72
+ `/ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(begun.qrcodeId)}`,
73
+ headers,
74
+ pollSignal,
75
+ )),
76
+ }
77
+ }
78
+
@@ -0,0 +1,145 @@
1
+ import type { ChannelAdapter, ImMessage, ReplyStream } from '../engine/types.js'
2
+ import { JsonStateFile } from '../engine/json-state.js'
3
+
4
+ export interface TelegramConfig {
5
+ token?: string
6
+ stateDir?: string
7
+ }
8
+
9
+ interface TgUpdate {
10
+ update_id: number
11
+ message?: {
12
+ message_id: number
13
+ chat: { id: number; type: string }
14
+ from?: { id: number; username?: string; first_name?: string; is_bot?: boolean }
15
+ text?: string
16
+ caption?: string
17
+ entities?: Array<{ type: string; offset: number; length: number }>
18
+ reply_to_message?: { from?: { id: number } }
19
+ }
20
+ }
21
+
22
+ const API = 'https://api.telegram.org'
23
+
24
+ export function createTelegramChannel(config: TelegramConfig, log: (line: string) => void): ChannelAdapter | undefined {
25
+ const token = config.token?.trim()
26
+ if (!token) return undefined
27
+ const cursorFile = new JsonStateFile(config.stateDir ? `${config.stateDir.replace(/[\\/]$/, '')}/cursor.json` : '', { offset: 0 })
28
+ const persist = Boolean(config.stateDir)
29
+
30
+ let handler: ((msg: ImMessage) => void | Promise<void>) | undefined
31
+ let offset = persist ? cursorFile.read().offset : 0
32
+ let stopped = false
33
+ let lastError = ''
34
+ let botId = ''
35
+ let username = ''
36
+
37
+ async function api<T>(method: string, body: Record<string, unknown>): Promise<T> {
38
+ const res = await fetch(`${API}/bot${token}/${method}`, {
39
+ method: 'POST',
40
+ headers: { 'content-type': 'application/json' },
41
+ body: JSON.stringify(body),
42
+ })
43
+ const data = (await res.json()) as { ok: boolean; description?: string; error_code?: number; result: T }
44
+ if (!data.ok) {
45
+ const error = new Error(`telegram ${method}: ${data.description ?? 'unknown'}`)
46
+ if (data.error_code === 401) (error as Error & { code?: string }).code = 'telegram-401'
47
+ throw error
48
+ }
49
+ return data.result
50
+ }
51
+
52
+ function mentioned(message: NonNullable<TgUpdate['message']>): boolean {
53
+ if (!username || !message.text || !Array.isArray(message.entities)) return false
54
+ return message.entities.some((entity) => {
55
+ if (entity.type !== 'mention') return false
56
+ return message.text!.slice(entity.offset, entity.offset + entity.length).toLowerCase() === `@${username.toLowerCase()}`
57
+ })
58
+ }
59
+
60
+ async function pollLoop(): Promise<void> {
61
+ while (!stopped) {
62
+ try {
63
+ const updates = await api<TgUpdate[]>('getUpdates', {
64
+ offset,
65
+ timeout: 25,
66
+ allowed_updates: ['message'],
67
+ })
68
+ lastError = ''
69
+ for (const update of updates) {
70
+ offset = update.update_id + 1
71
+ if (persist) cursorFile.write({ offset })
72
+ const message = update.message
73
+ if (!message || message.from?.is_bot) continue
74
+ if (!['private', 'group', 'supergroup'].includes(message.chat.type)) continue
75
+ const direct = message.chat.type === 'private'
76
+ const addressed = direct
77
+ || String(message.reply_to_message?.from?.id ?? '') === botId
78
+ || mentioned(message)
79
+ let text = message.text ?? message.caption ?? ''
80
+ if (username) text = text.replace(new RegExp(`@${username}\\b`, 'ig'), '').trim()
81
+ void handler?.({
82
+ chatId: String(message.chat.id),
83
+ userId: message.from ? String(message.from.id) : undefined,
84
+ username: message.from?.username ?? message.from?.first_name,
85
+ text,
86
+ kind: direct ? 'dm' : 'group',
87
+ addressed,
88
+ messageId: String(update.update_id),
89
+ })
90
+ }
91
+ } catch (error) {
92
+ lastError = error instanceof Error ? error.message : String(error)
93
+ log(`[telegram] 轮询错误: ${lastError}`)
94
+ if (stopped) break
95
+ await new Promise((resolve) => setTimeout(resolve, 3000))
96
+ }
97
+ }
98
+ }
99
+
100
+ return {
101
+ id: 'telegram',
102
+ label: 'Telegram',
103
+ maxMessageLength: 4000,
104
+ async start() {
105
+ stopped = false
106
+ const me = await api<{ id: number; username?: string; is_bot: boolean }>('getMe', {})
107
+ botId = String(me.id)
108
+ username = me.username ?? ''
109
+ const hook = await api<{ url?: string }>('getWebhookInfo', {})
110
+ if (hook.url) throw Object.assign(new Error('该 Telegram 机器人已配置 Webhook,请先在原服务中移除。'), { code: 'webhook-configured' })
111
+ log('[telegram] 开始长轮询')
112
+ void pollLoop()
113
+ },
114
+ async stop() {
115
+ stopped = true
116
+ if (persist) cursorFile.write({ offset })
117
+ },
118
+ async send(chatId, text) {
119
+ await api('sendMessage', { chat_id: Number(chatId), text })
120
+ },
121
+ async sendAction(chatId) {
122
+ await api('sendChatAction', { chat_id: Number(chatId), action: 'typing' }).catch(() => undefined)
123
+ },
124
+ async beginReply(chatId): Promise<ReplyStream> {
125
+ const first = await api<{ message_id: number }>('sendMessage', { chat_id: Number(chatId), text: '…' })
126
+ let last = '…'
127
+ return {
128
+ async update(text) {
129
+ const next = text.slice(0, 4000) || '…'
130
+ if (next === last) return
131
+ last = next
132
+ await api('editMessageText', { chat_id: Number(chatId), message_id: first.message_id, text: next }).catch(() => undefined)
133
+ },
134
+ async finish(text) {
135
+ const next = text.slice(0, 4000) || last
136
+ await api('editMessageText', { chat_id: Number(chatId), message_id: first.message_id, text: next }).catch(async () => {
137
+ await api('sendMessage', { chat_id: Number(chatId), text: next })
138
+ })
139
+ },
140
+ }
141
+ },
142
+ setMessageHandler(h) { handler = h },
143
+ status() { return stopped ? '已停止' : lastError ? `轮询中(${lastError})` : '轮询中' },
144
+ }
145
+ }