dsh-qqbot-plus 0.0.0-stage → 0.1.2

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 (301) hide show
  1. package/CHANGELOG.md +188 -0
  2. package/CHANGELOG_EN.md +188 -0
  3. package/LICENSE +21 -0
  4. package/README.md +281 -2
  5. package/README_EN.md +248 -0
  6. package/cordis.patch.yml +163 -0
  7. package/cordis.yml +112 -0
  8. package/install.sh +108 -0
  9. package/lib/alarms.js +371 -0
  10. package/lib/client.js +2411 -0
  11. package/lib/commands/auth.d.ts +18 -0
  12. package/lib/commands/auth.d.ts.map +1 -0
  13. package/lib/commands/auth.js +15 -0
  14. package/lib/commands/auth.js.map +1 -0
  15. package/lib/commands/help.d.ts +10 -0
  16. package/lib/commands/help.d.ts.map +1 -0
  17. package/lib/commands/help.js +39 -0
  18. package/lib/commands/help.js.map +1 -0
  19. package/lib/commands/index.d.ts +15 -0
  20. package/lib/commands/index.d.ts.map +1 -0
  21. package/lib/commands/index.js +30 -0
  22. package/lib/commands/index.js.map +1 -0
  23. package/lib/commands/misc.d.ts +21 -0
  24. package/lib/commands/misc.d.ts.map +1 -0
  25. package/lib/commands/misc.js +93 -0
  26. package/lib/commands/misc.js.map +1 -0
  27. package/lib/commands/model.d.ts +6 -0
  28. package/lib/commands/model.d.ts.map +1 -0
  29. package/lib/commands/model.js +63 -0
  30. package/lib/commands/model.js.map +1 -0
  31. package/lib/commands/new.js +17 -0
  32. package/lib/commands/preset.d.ts +8 -0
  33. package/lib/commands/preset.d.ts.map +1 -0
  34. package/lib/commands/preset.js +56 -0
  35. package/lib/commands/preset.js.map +1 -0
  36. package/lib/commands/session.d.ts +14 -0
  37. package/lib/commands/session.d.ts.map +1 -0
  38. package/lib/commands/session.js +34 -0
  39. package/lib/commands/session.js.map +1 -0
  40. package/lib/commands/status.d.ts +7 -0
  41. package/lib/commands/status.d.ts.map +1 -0
  42. package/lib/commands/status.js +26 -0
  43. package/lib/commands/status.js.map +1 -0
  44. package/lib/commands/types.d.ts +21 -0
  45. package/lib/commands/types.d.ts.map +1 -0
  46. package/lib/commands/types.js +2 -0
  47. package/lib/commands/types.js.map +1 -0
  48. package/lib/config.d.ts +95 -0
  49. package/lib/config.js +88 -0
  50. package/lib/features/answer-parser.d.ts +9 -0
  51. package/lib/features/answer-parser.d.ts.map +1 -0
  52. package/lib/features/answer-parser.js +23 -0
  53. package/lib/features/answer-parser.js.map +1 -0
  54. package/lib/features/approval-channel.d.ts +94 -0
  55. package/lib/features/approval-channel.d.ts.map +1 -0
  56. package/lib/features/approval-channel.js +158 -0
  57. package/lib/features/approval-channel.js.map +1 -0
  58. package/lib/features/approval-renderer.d.ts +18 -0
  59. package/lib/features/approval-renderer.d.ts.map +1 -0
  60. package/lib/features/approval-renderer.js +52 -0
  61. package/lib/features/approval-renderer.js.map +1 -0
  62. package/lib/features/button-utils.d.ts +34 -0
  63. package/lib/features/button-utils.d.ts.map +1 -0
  64. package/lib/features/button-utils.js +27 -0
  65. package/lib/features/button-utils.js.map +1 -0
  66. package/lib/features/history-store.d.ts +8 -0
  67. package/lib/features/history-store.d.ts.map +1 -0
  68. package/lib/features/history-store.js +23 -0
  69. package/lib/features/history-store.js.map +1 -0
  70. package/lib/features/question-channel.d.ts +96 -0
  71. package/lib/features/question-channel.d.ts.map +1 -0
  72. package/lib/features/question-channel.js +234 -0
  73. package/lib/features/question-channel.js.map +1 -0
  74. package/lib/features/question-renderer.d.ts +20 -0
  75. package/lib/features/question-renderer.d.ts.map +1 -0
  76. package/lib/features/question-renderer.js +70 -0
  77. package/lib/features/question-renderer.js.map +1 -0
  78. package/lib/fishcheck/measure.js +230 -0
  79. package/lib/fishcheck/rules.js +99 -0
  80. package/lib/fishmeme/plugin.js +605 -0
  81. package/lib/fishmeme/routes.js +141 -0
  82. package/lib/fishmemory/plugin.js +1052 -0
  83. package/lib/gateway/bootstrap.d.ts +12 -0
  84. package/lib/gateway/bootstrap.d.ts.map +1 -0
  85. package/lib/gateway/bootstrap.js +200 -0
  86. package/lib/gateway/bootstrap.js.map +1 -0
  87. package/lib/gateway/index.d.ts +3 -0
  88. package/lib/gateway/index.d.ts.map +1 -0
  89. package/lib/gateway/index.js +3 -0
  90. package/lib/gateway/index.js.map +1 -0
  91. package/lib/gateway/middleware-setup.d.ts +12 -0
  92. package/lib/gateway/middleware-setup.d.ts.map +1 -0
  93. package/lib/gateway/middleware-setup.js +82 -0
  94. package/lib/gateway/middleware-setup.js.map +1 -0
  95. package/lib/host/adapter.d.ts +48 -0
  96. package/lib/host/adapter.d.ts.map +1 -0
  97. package/lib/host/adapter.js +127 -0
  98. package/lib/host/adapter.js.map +1 -0
  99. package/lib/humanlike/ENV_PROMPT.md +28 -0
  100. package/lib/humanlike/affinity.js +316 -0
  101. package/lib/humanlike/learn.js +343 -0
  102. package/lib/humanlike/life.js +899 -0
  103. package/lib/humanlike/mind.js +323 -0
  104. package/lib/humanlike/plugin.js +587 -0
  105. package/lib/humanlike/reach.js +119 -0
  106. package/lib/humanlike/real.js +276 -0
  107. package/lib/humanlike/rules.js +67 -0
  108. package/lib/humanlike/settings-api.js +159 -0
  109. package/lib/humanlike/settings.js +370 -0
  110. package/lib/humanlike/together.js +251 -0
  111. package/lib/identity/paths.js +27 -0
  112. package/lib/identity/persona.js +75 -0
  113. package/lib/identity/portrait.js +25 -0
  114. package/lib/identity/runtime.js +78 -0
  115. package/lib/index.d.ts +15 -0
  116. package/lib/index.js +117 -0
  117. package/lib/media/draft-tool.js +442 -0
  118. package/lib/media/draft-tool.js.bak-to-182027 +389 -0
  119. package/lib/media/media-cleaner.d.ts +19 -0
  120. package/lib/media/media-cleaner.d.ts.map +1 -0
  121. package/lib/media/media-cleaner.js +81 -0
  122. package/lib/media/media-cleaner.js.map +1 -0
  123. package/lib/media/say-tool.js +72 -0
  124. package/lib/media/send-file-tool.d.ts +12 -0
  125. package/lib/media/send-file-tool.d.ts.map +1 -0
  126. package/lib/media/send-file-tool.js +122 -0
  127. package/lib/media/send-file-tool.js.map +1 -0
  128. package/lib/media/send-media.d.ts +61 -0
  129. package/lib/media/send-media.d.ts.map +1 -0
  130. package/lib/media/send-media.js +104 -0
  131. package/lib/media/send-media.js.map +1 -0
  132. package/lib/media/vision-tool.d.ts +22 -0
  133. package/lib/media/vision-tool.d.ts.map +1 -0
  134. package/lib/media/vision-tool.js +288 -0
  135. package/lib/media/vision-tool.js.map +1 -0
  136. package/lib/middleware/attachment.d.ts +11 -0
  137. package/lib/middleware/attachment.d.ts.map +1 -0
  138. package/lib/middleware/attachment.js +30 -0
  139. package/lib/middleware/attachment.js.map +1 -0
  140. package/lib/middleware/question-answer.d.ts +10 -0
  141. package/lib/middleware/question-answer.d.ts.map +1 -0
  142. package/lib/middleware/question-answer.js +19 -0
  143. package/lib/middleware/question-answer.js.map +1 -0
  144. package/lib/model/index.d.ts +10 -0
  145. package/lib/model/index.d.ts.map +1 -0
  146. package/lib/model/index.js +9 -0
  147. package/lib/model/index.js.map +1 -0
  148. package/lib/model/model-resolver.d.ts +102 -0
  149. package/lib/model/model-resolver.d.ts.map +1 -0
  150. package/lib/model/model-resolver.js +206 -0
  151. package/lib/model/model-resolver.js.map +1 -0
  152. package/lib/model/prefs-store.d.ts +50 -0
  153. package/lib/model/prefs-store.d.ts.map +1 -0
  154. package/lib/model/prefs-store.js +215 -0
  155. package/lib/model/prefs-store.js.map +1 -0
  156. package/lib/model/settings-reader.d.ts +19 -0
  157. package/lib/model/settings-reader.d.ts.map +1 -0
  158. package/lib/model/settings-reader.js +76 -0
  159. package/lib/model/settings-reader.js.map +1 -0
  160. package/lib/model/types.d.ts +15 -0
  161. package/lib/model/types.d.ts.map +1 -0
  162. package/lib/model/types.js +5 -0
  163. package/lib/model/types.js.map +1 -0
  164. package/lib/resume-check.js +122 -0
  165. package/lib/resume-tool.js +29 -0
  166. package/lib/rules.js +57 -0
  167. package/lib/session/idle-evictor.d.ts +18 -0
  168. package/lib/session/idle-evictor.d.ts.map +1 -0
  169. package/lib/session/idle-evictor.js +31 -0
  170. package/lib/session/idle-evictor.js.map +1 -0
  171. package/lib/session/index.d.ts +9 -0
  172. package/lib/session/index.d.ts.map +1 -0
  173. package/lib/session/index.js +8 -0
  174. package/lib/session/index.js.map +1 -0
  175. package/lib/session/pick-agent.js +116 -0
  176. package/lib/session/session-id.d.ts +5 -0
  177. package/lib/session/session-id.d.ts.map +1 -0
  178. package/lib/session/session-id.js +15 -0
  179. package/lib/session/session-id.js.map +1 -0
  180. package/lib/session/session-manager.d.ts +138 -0
  181. package/lib/session/session-manager.d.ts.map +1 -0
  182. package/lib/session/session-manager.js +1157 -0
  183. package/lib/session/session-manager.js.bak-target +1081 -0
  184. package/lib/session/session-manager.js.bak-title-20261118 +1119 -0
  185. package/lib/session/session-manager.js.map +1 -0
  186. package/lib/session/types.d.ts +162 -0
  187. package/lib/session/types.d.ts.map +1 -0
  188. package/lib/session/types.js +2 -0
  189. package/lib/session/types.js.map +1 -0
  190. package/lib/setup/bind-routes.d.ts +78 -0
  191. package/lib/setup/bind-routes.d.ts.map +1 -0
  192. package/lib/setup/bind-routes.js +588 -0
  193. package/lib/setup/bind-routes.js.bak-join-163944 +761 -0
  194. package/lib/setup/bind-routes.js.map +1 -0
  195. package/lib/setup/binding-service.d.ts +86 -0
  196. package/lib/setup/binding-service.d.ts.map +1 -0
  197. package/lib/setup/binding-service.js +175 -0
  198. package/lib/setup/binding-service.js.map +1 -0
  199. package/lib/setup/index.d.ts +50 -0
  200. package/lib/setup/index.d.ts.map +1 -0
  201. package/lib/setup/index.js +163 -0
  202. package/lib/setup/index.js.map +1 -0
  203. package/lib/setup/persist.d.ts +42 -0
  204. package/lib/setup/persist.d.ts.map +1 -0
  205. package/lib/setup/persist.js +344 -0
  206. package/lib/setup/persist.js.map +1 -0
  207. package/lib/setup/presenters.d.ts +40 -0
  208. package/lib/setup/presenters.d.ts.map +1 -0
  209. package/lib/setup/presenters.js +84 -0
  210. package/lib/setup/presenters.js.map +1 -0
  211. package/lib/setup/qr-svg.d.ts +9 -0
  212. package/lib/setup/qr-svg.d.ts.map +1 -0
  213. package/lib/setup/qr-svg.js +33 -0
  214. package/lib/setup/qr-svg.js.map +1 -0
  215. package/lib/shared/bind-protocol.d.ts +42 -0
  216. package/lib/shared/bind-protocol.d.ts.map +1 -0
  217. package/lib/shared/bind-protocol.js +33 -0
  218. package/lib/shared/bind-protocol.js.map +1 -0
  219. package/lib/shared/dirs.d.ts +10 -0
  220. package/lib/shared/dirs.d.ts.map +1 -0
  221. package/lib/shared/dirs.js +20 -0
  222. package/lib/shared/dirs.js.map +1 -0
  223. package/lib/shared/http-body.js +43 -0
  224. package/lib/shared/index.d.ts +8 -0
  225. package/lib/shared/index.d.ts.map +1 -0
  226. package/lib/shared/index.js +8 -0
  227. package/lib/shared/index.js.map +1 -0
  228. package/lib/shared/json-file.js +34 -0
  229. package/lib/shared/orders.js +26 -0
  230. package/lib/shared/scope.d.ts +14 -0
  231. package/lib/shared/scope.d.ts.map +1 -0
  232. package/lib/shared/scope.js +12 -0
  233. package/lib/shared/scope.js.map +1 -0
  234. package/lib/shared/send-helper.d.ts +11 -0
  235. package/lib/shared/send-helper.d.ts.map +1 -0
  236. package/lib/shared/send-helper.js +13 -0
  237. package/lib/shared/send-helper.js.map +1 -0
  238. package/lib/shared/utils.d.ts +31 -0
  239. package/lib/shared/utils.d.ts.map +1 -0
  240. package/lib/shared/utils.js +228 -0
  241. package/lib/shared/utils.js.map +1 -0
  242. package/lib/tool-guard.js +74 -0
  243. package/lib/transport/attachment.d.ts +41 -0
  244. package/lib/transport/attachment.d.ts.map +1 -0
  245. package/lib/transport/attachment.js +191 -0
  246. package/lib/transport/attachment.js.map +1 -0
  247. package/lib/transport/chunker.d.ts +14 -0
  248. package/lib/transport/chunker.d.ts.map +1 -0
  249. package/lib/transport/chunker.js +78 -0
  250. package/lib/transport/chunker.js.map +1 -0
  251. package/lib/transport/deliverables.d.ts +20 -0
  252. package/lib/transport/deliverables.d.ts.map +1 -0
  253. package/lib/transport/deliverables.js +72 -0
  254. package/lib/transport/deliverables.js.map +1 -0
  255. package/lib/transport/events.d.ts +117 -0
  256. package/lib/transport/events.d.ts.map +1 -0
  257. package/lib/transport/events.js +112 -0
  258. package/lib/transport/events.js.map +1 -0
  259. package/lib/transport/inbound.d.ts +11 -0
  260. package/lib/transport/inbound.d.ts.map +1 -0
  261. package/lib/transport/inbound.js +511 -0
  262. package/lib/transport/inbound.js.map +1 -0
  263. package/lib/transport/index.d.ts +10 -0
  264. package/lib/transport/index.d.ts.map +1 -0
  265. package/lib/transport/index.js +10 -0
  266. package/lib/transport/index.js.map +1 -0
  267. package/lib/transport/msgid-cache.d.ts +23 -0
  268. package/lib/transport/msgid-cache.d.ts.map +1 -0
  269. package/lib/transport/msgid-cache.js +57 -0
  270. package/lib/transport/msgid-cache.js.map +1 -0
  271. package/lib/transport/notify.js +147 -0
  272. package/lib/transport/outbound-buffer.d.ts +42 -0
  273. package/lib/transport/outbound-buffer.d.ts.map +1 -0
  274. package/lib/transport/outbound-buffer.js +68 -0
  275. package/lib/transport/outbound-buffer.js.map +1 -0
  276. package/lib/transport/outbound.d.ts +42 -0
  277. package/lib/transport/outbound.d.ts.map +1 -0
  278. package/lib/transport/outbound.js +183 -0
  279. package/lib/transport/outbound.js.map +1 -0
  280. package/lib/transport/reply-limiter.d.ts +31 -0
  281. package/lib/transport/reply-limiter.d.ts.map +1 -0
  282. package/lib/transport/reply-limiter.js +50 -0
  283. package/lib/transport/reply-limiter.js.map +1 -0
  284. package/lib/transport/reply-target.d.ts +32 -0
  285. package/lib/transport/reply-target.d.ts.map +1 -0
  286. package/lib/transport/reply-target.js +64 -0
  287. package/lib/transport/reply-target.js.map +1 -0
  288. package/lib/transport/streaming-writer.d.ts +55 -0
  289. package/lib/transport/streaming-writer.d.ts.map +1 -0
  290. package/lib/transport/streaming-writer.js +122 -0
  291. package/lib/transport/streaming-writer.js.map +1 -0
  292. package/lib/transport/tool-presenter.d.ts +37 -0
  293. package/lib/transport/tool-presenter.d.ts.map +1 -0
  294. package/lib/transport/tool-presenter.js +116 -0
  295. package/lib/transport/tool-presenter.js.map +1 -0
  296. package/lib/turn-check.js +85 -0
  297. package/lib/types.d.ts +39 -0
  298. package/lib/types.js +5 -0
  299. package/locale/en.json +6 -0
  300. package/locale/zh.json +6 -0
  301. package/package.json +127 -4
@@ -0,0 +1,442 @@
1
+ /**
2
+ * 起草—确认:让模型先 qq_draft 起稿,再 qq_confirm 发出去。
3
+ *
4
+ * 和 dsh-qq 那套一致:回复正文永远不自动发;想发几条就重复 draft + confirm,
5
+ * 每条是独立的一条 QQ 消息;本轮结束还没确认的草稿直接作废。
6
+ * 这一轮不想说话就 qq_skip(只写日志,不发任何东西)。
7
+ *
8
+ * @module dsh-qqbot-plus/media/draft-tool
9
+ */
10
+ import { statSync, readFileSync } from 'node:fs'
11
+ import { homedir } from 'node:os'
12
+ import { isAbsolute, join, resolve } from 'node:path'
13
+ import { fileURLToPath } from 'node:url'
14
+ import { chunkMarkdownText } from '../transport/chunker.js'
15
+ import { notifySendFailure, classifySendError } from '../transport/notify.js'
16
+ import { isPathAllowed, resolveAgentCwd } from './send-media.js'
17
+ import { markSpoke, endTurn } from '../turn-check.js'
18
+
19
+ const textResult = (value) => [{ type: 'text', text: String(value) }]
20
+
21
+ /** 草稿/发送回执里给人看的去处标签:私聊 QQ <id>,群 QQ 群 <id>。 */
22
+ function targetLabel(target) {
23
+ if (!target || !target.targetId) return 'QQ'
24
+ return target.scope === 'group' ? `QQ 群 ${target.targetId}` : `QQ ${target.targetId}`
25
+ }
26
+
27
+ /**
28
+ * 这一轮的来处:'qq' = QQ 发来的,'auto' = 插件心跳叫醒的,'console' = 控制台/面板里敲的。
29
+ * 判据两样:消息正文有没有投递前缀([私聊 …] / [群「…」 …]),以及消息的 source.kind。
30
+ */
31
+ const AUTO_KINDS = new Set(['bili-autonomy', 'xhs-autonomy', 'bili-duty-scan', 'dsh-day', 'day-wake', 'humanlike', 'resume'])
32
+ /** 注入消息的识别:这些不是他说的,判来处时要跳过。 */
33
+ const INJECTED_RE = /^(Current runtime context|\[Reference attachments\]|Time sampled|\[Compressed conversation section\]|<system-reminder|<skill|<available_skills>|The available skill catalog changed|Use only names in this replacement catalog|(宿主刚重启过)/m
34
+
35
+ /** 最后一条 QQ 入站是不是刚刚。事件里翻不到人话时的最后一道判据。
36
+ * 窗口给到 10 分钟:一个回合里可能先跑了几分钟工具,收尾时才起草;
37
+ * 90 秒会把「他刚在群里问我」误判成 console,宁可多发一条。 */
38
+ function justInbound(ms = 10 * 60_000) {
39
+ try {
40
+ const raw = readFileSync(join(homedir(), '.dsh', 'dsh-qqbot-plus', 'runtime.json'), 'utf8')
41
+ const at = Date.parse(String(JSON.parse(raw)?.lastInbound?.at ?? ''))
42
+ if (!Number.isFinite(at)) return false
43
+ return Date.now() - at <= ms
44
+ }
45
+ catch {
46
+ return false
47
+ }
48
+ }
49
+
50
+ /** 这条消息是不是通道刚收到的那条入站(runtime.json 的 lastInbound.text)。 */
51
+ function isInboundText(text) {
52
+ try {
53
+ const raw = readFileSync(join(homedir(), '.dsh', 'dsh-qqbot-plus', 'runtime.json'), 'utf8')
54
+ const want = String(JSON.parse(raw)?.lastInbound?.text ?? '').trim()
55
+ if (want === '' || text === '') return false
56
+ return text.includes(want) || want.includes(text.slice(0, 40))
57
+ }
58
+ catch {
59
+ return false
60
+ }
61
+ }
62
+
63
+ function originOf(agent) {
64
+ try {
65
+ const session = agent?.session
66
+ const events = typeof session?.snapshotEvents === 'function' ? session.snapshotEvents() : session?.events
67
+ if (!Array.isArray(events)) return 'console'
68
+ // 往上最多看 8 条真人消息:这一轮里还夹着宿主注入的快照、重启提示、技能目录,
69
+ // 只看「最近一条」会被它们挡住,只看「第一条命中的」会先撞到 console。
70
+ const seen = []
71
+ for (let i = events.length - 1; i >= 0 && seen.length < 8; i -= 1) {
72
+ const event = events[i]
73
+ if (event?.type !== 'user/message' && event?.type !== 'user') continue
74
+ const text = String(event.text ?? event.content?.[0]?.text ?? '')
75
+ if (text === '') continue
76
+ if (INJECTED_RE.test(text)) continue
77
+ seen.push({ text, kind: String(event.source?.kind ?? '') })
78
+ }
79
+ for (const item of seen) {
80
+ if (/^\[(私聊|群「)/.test(item.text)) return 'qq'
81
+ if (isInboundText(item.text)) return 'qq'
82
+ }
83
+ for (const item of seen) {
84
+ if (AUTO_KINDS.has(item.kind)) return 'auto'
85
+ }
86
+ // 事件里翻不到这一轮的人话(有时候当前回合的消息还没进快照):
87
+ // 通道刚收到过 QQ 消息就按 QQ 算——宁可多发一条,不要让他等着。
88
+ return justInbound() ? 'qq' : 'console'
89
+ }
90
+ catch {
91
+ return 'console'
92
+ }
93
+ }
94
+
95
+ /** 人话体检:起草时顺手量一遍,只提示不改字、不阻断(源码在 lib/fishcheck/,抄自 dsh-fishcheck)。 */
96
+ let __fishcheck = null
97
+ async function fishHint(text) {
98
+ if (typeof text !== 'string' || text.trim().length < 20) return ''
99
+ try {
100
+ if (__fishcheck === null) __fishcheck = await import('../fishcheck/measure.js')
101
+ const r = __fishcheck.analyze(text)
102
+ if (r.score < 22) return ''
103
+ const tops = r.problems.slice(0, 3).map((p) => p.text)
104
+ return `体检 ${r.score} 分(${r.verdict}):${tops.join(' · ')}`
105
+ }
106
+ catch {
107
+ return ''
108
+ }
109
+ }
110
+
111
+ /** 语音文件允许的根目录(breeze_voice 落盘的地方)。 */
112
+ const VOICE_ROOT = join(homedir(), '.dsh', 'dsh-breeze-voice', 'audio')
113
+ /** 读回来的媒体上限,与 SDK 那侧一致。 */
114
+ const MAX_INLINE_BYTES = 50 * 1024 * 1024
115
+
116
+ /** data: URL → Buffer(只认 base64 段)。 */
117
+ function readDataUrl(text, field) {
118
+ const comma = text.indexOf(',')
119
+ if (comma < 0 || !/;base64/i.test(text.slice(0, comma))) {
120
+ throw new Error(`qq_draft: ${field} 的 data URL 需要 base64 编码`)
121
+ }
122
+ const buffer = Buffer.from(text.slice(comma + 1), 'base64')
123
+ if (buffer.byteLength === 0) throw new Error(`qq_draft: ${field} 的 data URL 解出来是空的`)
124
+ if (buffer.byteLength > MAX_INLINE_BYTES) throw new Error(`qq_draft: ${field} 太大(${buffer.byteLength} 字节)`)
125
+ return buffer
126
+ }
127
+
128
+ /** 本机/局域网地址:腾讯那侧拉不到,得自己下成 buffer。 */
129
+ function isLocalHost(hostname) {
130
+ const host = String(hostname ?? '').toLowerCase().replace(/^\[|\]$/g, '')
131
+ return host === 'localhost' || host === '127.0.0.1' || host === '0.0.0.0' || host === '::1' || host.endsWith('.local')
132
+ }
133
+
134
+ async function readLocalUrl(url, field) {
135
+ let response
136
+ try {
137
+ response = await fetch(url)
138
+ }
139
+ catch (error) {
140
+ throw new Error(`qq_draft: ${field} 的本机地址读不到(${url}):${error?.message ?? error}`)
141
+ }
142
+ if (!response.ok) throw new Error(`qq_draft: ${field} 的本机地址返回 ${response.status}:${url}`)
143
+ const buffer = Buffer.from(await response.arrayBuffer())
144
+ if (buffer.byteLength === 0) throw new Error(`qq_draft: ${field} 的本机地址内容是空的:${url}`)
145
+ if (buffer.byteLength > MAX_INLINE_BYTES) throw new Error(`qq_draft: ${field} 太大(${buffer.byteLength} 字节)`)
146
+ return buffer
147
+ }
148
+
149
+ export function registerDraftTools(ctx, sender, mediaSender, manager, config, logger) {
150
+ const tools = ctx.get('tools')
151
+ if (!tools?.register) {
152
+ logger.warn('im-qqbot: tools 服务不可用,qq_draft/qq_confirm 未注册')
153
+ return
154
+ }
155
+ /** sessionId → 草稿(同一会话只留最近一份) */
156
+ const drafts = new Map()
157
+ const chunkLimit = config.textChunkLimit ?? 4500
158
+ const cwd = resolveAgentCwd(config.cwd)
159
+ const mediaPolicy = config.sendFile ?? {}
160
+ const recordOf = (agent) => (agent === undefined ? undefined : manager.findByAgent(agent))
161
+ const sessionKeyOf = (record) => record.agent?.session?.id ?? record.sessionId
162
+ /** 会话表里所有能发的门(每个键 = 私聊或群的一条会话)。 */
163
+ const doors = () => {
164
+ const out = []
165
+ for (const record of manager.sessions?.values?.() ?? []) {
166
+ const target = record?.replyTarget
167
+ if (!target || typeof target.targetId !== 'string' || target.targetId === '') continue
168
+ out.push({ record, target, scope: target.scope === 'group' ? 'group' : 'c2c' })
169
+ }
170
+ return out
171
+ }
172
+ /** 目标反查那条会话(记忆要记在收件人自己那条上,不能记在叫醒我的那条)。 */
173
+ const recordForTarget = (target) => {
174
+ if (!target || typeof target.targetId !== 'string') return undefined
175
+ const scope = target.scope === 'group' ? 'group' : 'c2c'
176
+ return doors().find((door) => door.scope === scope && door.target.targetId === target.targetId)?.record
177
+ }
178
+ /**
179
+ * 解析 qq_draft 的 `to`。
180
+ * - 不给:回给这一轮的来处(照旧)
181
+ * - private / 私聊 / 主人:他的私聊(当前就在私聊里就沿用那条,带 msgId 走被动回复)
182
+ * - group / 群:群
183
+ * - private:<openid> / group:<openid>:直接指定
184
+ * 主动换门时 msgId 留空——那不是回复,是主动消息(平台有额度,别乱用)。
185
+ */
186
+ const targetFor = (record, to) => {
187
+ const raw = String(to ?? '').trim()
188
+ if (raw === '') return record?.replyTarget ?? null
189
+ const explicit = raw.match(/^(c2c|private|私聊|group|群|群聊)\s*[::]\s*(\S+)$/i)
190
+ if (explicit) {
191
+ const scope = /^(group|群|群聊)$/i.test(explicit[1]) ? 'group' : 'c2c'
192
+ return { scope, targetId: explicit[2], msgId: '' }
193
+ }
194
+ const lower = raw.toLowerCase()
195
+ const wantPrivate = /^(private|c2c|私聊|主人|owner|me|我)$/.test(lower)
196
+ const wantGroup = /^(group|群|群聊|这个群)$/.test(lower)
197
+ if (!wantPrivate && !wantGroup) {
198
+ throw new Error(`qq_draft: to 只认 private / group(也可以 private:<openid>、group:<openid>),收到的是「${raw}」`)
199
+ }
200
+ const scope = wantPrivate ? 'c2c' : 'group'
201
+ const here = record?.replyTarget
202
+ if (here && (here.scope === 'group' ? 'group' : 'c2c') === scope) return here
203
+ const hit = doors().find((door) => door.scope === scope)
204
+ if (hit) return { scope, targetId: hit.target.targetId, msgId: '' }
205
+ throw new Error(wantPrivate
206
+ ? 'qq_draft: 会话表里还没有他的私聊门——让他先在 QQ 上私聊你一句,之后才发得过去'
207
+ : 'qq_draft: 会话表里还没有群门——群里得先有人说过话')
208
+ }
209
+ /**
210
+ * 解析一个媒体参数:
211
+ * - http(s) 公网 URL:原样交给 SDK 拉取
212
+ * - 本机 / 局域网 URL:自己读成 buffer(腾讯服务器拉不到会报「上传URL错误」)
213
+ * - data: URL:解成 buffer
214
+ * - file:// URL 与本地路径:校验存在性与白名单后给 localPath,相对路径按会话 cwd 解析
215
+ */
216
+ const sourceOf = async (raw, field, record) => {
217
+ const text = String(raw ?? '').trim()
218
+ if (text === '') return null
219
+ const sessionCwd = typeof record?.agent?.session?.header?.cwd === 'string' ? record.agent.session.header.cwd : ''
220
+ if (text.startsWith('data:')) return { buffer: readDataUrl(text, field) }
221
+ if (/^https?:\/\//i.test(text)) {
222
+ let parsed
223
+ try {
224
+ parsed = new URL(text)
225
+ }
226
+ catch {
227
+ throw new Error(`qq_draft: ${field} 不是合法 URL:${text}`)
228
+ }
229
+ if (isLocalHost(parsed.hostname)) return await readLocalUrl(text, field)
230
+ return { url: text }
231
+ }
232
+ let file = text
233
+ if (/^file:\/\//i.test(text)) {
234
+ try {
235
+ file = fileURLToPath(text)
236
+ }
237
+ catch {
238
+ throw new Error(`qq_draft: ${field} 不是合法的 file:// 路径:${text}`)
239
+ }
240
+ }
241
+ // 相对路径按会话实际工作目录解析;共享会话时那是 dsh-qq 的工作区。
242
+ if (!isAbsolute(file)) file = resolve(sessionCwd === '' ? cwd : sessionCwd, file)
243
+ let info
244
+ try {
245
+ info = statSync(file)
246
+ }
247
+ catch {
248
+ throw new Error(`qq_draft: ${field} 指向的本地文件不存在:${file}`)
249
+ }
250
+ if (!info.isFile()) throw new Error(`qq_draft: ${field} 不是一个文件:${file}`)
251
+ const extraRoots = [
252
+ cwd,
253
+ ...(sessionCwd === '' ? [] : [sessionCwd]),
254
+ ...(Array.isArray(mediaPolicy.extraRoots) ? mediaPolicy.extraRoots : []),
255
+ ...(field === 'voice' ? [VOICE_ROOT] : []),
256
+ ]
257
+ const allowed = isPathAllowed(file, {
258
+ restrictPaths: mediaPolicy.restrictPaths !== false,
259
+ extraRoots,
260
+ }, sessionCwd === '' ? cwd : sessionCwd)
261
+ if (!allowed) throw new Error(`qq_draft: ${field} 的路径不在允许范围(media / agent 工作目录)内:${file}`)
262
+ return { localPath: file }
263
+ }
264
+
265
+ tools.register({
266
+ name: 'qq_draft',
267
+ description: '先起一份 QQ 消息草稿(文本 / 图片 / 视频 / 文件 / 语音),一个字都不发。要发得再调 qq_confirm(decision="send");本轮结束前没确认的草稿会直接作废。想发几条就重复 draft + confirm。',
268
+ parameters: {
269
+ type: 'object',
270
+ properties: {
271
+ text: { type: 'string', description: '要发送的文本;QQ 里没有 Markdown 渲染,尽量简短' },
272
+ to: { type: 'string', description: '发给谁:不给 = 回给这一轮的来处;private = 他的私聊(不在私聊里也算主动发给他);group = 群;也可 private:<openid> / group:<openid>' },
273
+ image: { type: 'string', description: '图片:http(s) 链接、file:// 或本地路径(相对路径按会话工作目录解析)' },
274
+ video: { type: 'string', description: '视频:http(s) 链接、file:// 或本地路径' },
275
+ file: { type: 'string', description: '普通文件:http(s) 链接、file:// 或本地路径' },
276
+ voice: { type: 'string', description: '语音:本地路径或 http(s) 链接;一次草稿只放一条语音' },
277
+ },
278
+ required: [],
279
+ additionalProperties: false,
280
+ },
281
+ output: { schema: { type: 'string' }, render: (_args, value) => textResult(value) },
282
+ async execute(args, exec) {
283
+ const origin = originOf(exec.agent)
284
+ const to = String(args.to ?? '').trim()
285
+ if (origin === 'console' && to === '') {
286
+ throw new Error('qq_draft: 这一轮是在控制台说的,正文就是回复,不要往 QQ 发;真想主动发给他就带上 to("private" 发私聊、"group" 发群)')
287
+ }
288
+ const record = recordOf(exec.agent)
289
+ const target = targetFor(record, to)
290
+ if (target === null || typeof target.targetId !== 'string' || target.targetId === '') {
291
+ throw new Error(origin === 'qq'
292
+ ? 'qq_draft: 这条是从 QQ 来的,但会话表里没有它的收件人记录——先别发,把情况写进正文'
293
+ : origin === 'auto'
294
+ ? 'qq_draft: 这一轮是心跳叫醒的,又没给 to,没有收件人——给 to="private" 发私聊,或者把话写进正文'
295
+ : 'qq_draft: 没有收件人——给 to="private" 或 to="group"')
296
+ }
297
+ const text = String(args.text ?? '').trim()
298
+ const image = await sourceOf(args.image, 'image', record)
299
+ const video = await sourceOf(args.video, 'video', record)
300
+ const file = await sourceOf(args.file, 'file', record)
301
+ const voice = await sourceOf(args.voice, 'voice', record)
302
+ if (text === '' && image === null && video === null && file === null && voice === null) {
303
+ throw new Error('qq_draft: 草稿是空的,至少给 text / image / video / file / voice 之一')
304
+ }
305
+ const key = record === undefined ? String(exec.agent?.session?.id ?? 'qq') : sessionKeyOf(record)
306
+ drafts.set(key, { text, image, video, file, voice, replyTarget: target, createdAt: Date.now() })
307
+ const lines = [`[草稿已备好 → ${targetLabel(target)}]`]
308
+ lines.push(text === '' ? '正文:(没有文字,只有附件)' : `正文:${text}`)
309
+ const extras = [
310
+ image === null ? null : '图片',
311
+ video === null ? null : '视频',
312
+ file === null ? null : '文件',
313
+ voice === null ? null : '语音',
314
+ ].filter(Boolean)
315
+ if (extras.length > 0) lines.push(`附件:${extras.join(' / ')}`)
316
+ const hint = await fishHint(text)
317
+ if (hint !== '') lines.push('', hint)
318
+ lines.push(
319
+ '',
320
+ '还一个字都没发出去。要发 → qq_confirm(decision="send");不发了 → qq_confirm(decision="cancel")。',
321
+ '本轮结束前没确认的草稿会直接作废。',
322
+ )
323
+ return lines.join('\n')
324
+ },
325
+ })
326
+
327
+ tools.register({
328
+ name: 'qq_confirm',
329
+ description: '把最近这份草稿发出去(decision="send"),或者作废它(decision="cancel")。只有最近一份草稿能被确认;想发下一条就再 qq_draft。',
330
+ parameters: {
331
+ type: 'object',
332
+ properties: {
333
+ decision: { type: 'string', enum: ['send', 'cancel'], description: 'send 发出去;cancel 作废' },
334
+ },
335
+ required: ['decision'],
336
+ additionalProperties: false,
337
+ },
338
+ output: { schema: { type: 'string' }, render: (_args, value) => textResult(value) },
339
+ async execute(args, exec) {
340
+ const record = recordOf(exec.agent)
341
+ const key = record === undefined ? String(exec.agent?.session?.id ?? 'qq') : sessionKeyOf(record)
342
+ const draft = drafts.get(key)
343
+ if (draft === undefined) throw new Error('qq_confirm: 现在没有待确认的草稿(先用 qq_draft 起草)')
344
+ const decision = String(args.decision ?? '').trim()
345
+ if (decision === 'cancel') {
346
+ drafts.delete(key)
347
+ // record 在桌面/控制台会话里可能是 undefined,这里必须用可选链。
348
+ return `草稿作废了,没有发到 ${targetLabel(draft.replyTarget ?? record?.replyTarget)}。`
349
+ }
350
+ if (decision !== 'send') throw new Error('qq_confirm: decision 只能是 send 或 cancel')
351
+ const target = draft.replyTarget ?? record?.replyTarget
352
+ if (!target || typeof target.targetId !== 'string' || target.targetId === '') {
353
+ throw new Error('qq_confirm: 这份草稿没有收件人——重新 qq_draft 并且指明 to')
354
+ }
355
+ // 记忆记在收件人自己那条会话上:从群里喊出来的私聊,不能记进群那条的情节里。
356
+ const memRecord = recordForTarget(target) ?? record
357
+ // 每成功发掉一块就从草稿里清掉:中途某个附件失败时,重试不会把已经发过的内容再发一遍。
358
+ const sentText = []
359
+ const chunks = chunkMarkdownText(draft.text ?? '', chunkLimit).filter((chunk) => chunk.trim() !== '')
360
+ for (let index = 0; index < chunks.length; index += 1) {
361
+ const chunk = chunks[index]
362
+ try {
363
+ await sender.sendMarkdown(target, chunk)
364
+ }
365
+ catch (error) {
366
+ // 剩下的留在草稿里给重试
367
+ draft.text = chunks.slice(index).join('\n')
368
+ notifySendFailure(memRecord, error, { kind: 'text', sent: sentText.length, total: chunks.length })
369
+ throw new Error(`qq_confirm: 第 ${sentText.length + 1} 块(共 ${chunks.length} 块)没发出去:${classifySendError(error)}`)
370
+ }
371
+ sentText.push(chunk)
372
+ draft.text = chunks.slice(index + 1).join('\n')
373
+ }
374
+ // 媒体:发失败就留在草稿里,并且让模型当场知道(工具也会抛,但注入能保证下一个 step 看见)
375
+ const sendMedia = async (field, label, run) => {
376
+ if (draft[field] == null) return
377
+ try {
378
+ await run(draft[field])
379
+ }
380
+ catch (error) {
381
+ notifySendFailure(memRecord, error, { kind: 'file', name: label, dedup: field })
382
+ throw new Error(`qq_confirm: ${label}没发出去:${classifySendError(error)}`)
383
+ }
384
+ draft[field] = null
385
+ }
386
+ await sendMedia('image', '图片', (source) => mediaSender.sendImage(target, source))
387
+ await sendMedia('video', '视频', (source) => mediaSender.sendVideo(target, source))
388
+ await sendMedia('voice', '语音', (source) => mediaSender.sendVoice(target, source))
389
+ await sendMedia('file', '文件', (source) => {
390
+ const { fileName, ...rest } = source
391
+ return mediaSender.sendFile(target, rest, fileName === undefined ? undefined : { fileName })
392
+ })
393
+ drafts.delete(key)
394
+ markSpoke(key)
395
+ return `已发送到 ${targetLabel(target)}。还有下一句就继续 qq_draft + qq_confirm;不要只写在回复正文里。`
396
+ },
397
+ })
398
+
399
+ tools.register({
400
+ name: 'qq_skip',
401
+ description: '这一轮不出声:不往 QQ 发任何东西。对方只是随口一句、话还没说完、或者你不想接,就用它——聊天里不是每句都要回。要说话用 qq_draft + qq_confirm。',
402
+ parameters: {
403
+ type: 'object',
404
+ properties: {
405
+ reason: { type: 'string', description: '为什么这轮不说话(只写进日志,不发给对方)' },
406
+ },
407
+ additionalProperties: false,
408
+ },
409
+ output: { schema: { type: 'string' }, render: (_args, value) => textResult(value) },
410
+ async execute(args, exec) {
411
+ const record = recordOf(exec.agent)
412
+ if (record === undefined) throw new Error('qq_skip: 这一轮不是从 QQ 来的,安静着就好')
413
+ if (config.allowSilence === false) throw new Error('qq_skip: 这里设成了每轮都要回,不能跳过(用 qq_draft + qq_confirm 回一句)')
414
+ const reason = typeof args.reason === 'string' ? args.reason.trim() : ''
415
+ logger.info(`im-qqbot: 这一轮不出声 ${record.sessionKey ?? ''}${reason === '' ? '' : ' · ' + reason}`)
416
+ markSpoke(sessionKeyOf(record))
417
+ return '好,这一轮不发了。'
418
+ },
419
+ })
420
+
421
+ // 本轮结束还没确认的草稿作废 —— 桥绝不替模型补发。
422
+ ctx.on('session/event', (session, event) => {
423
+ if (event?.type !== 'turn/end') return
424
+ try {
425
+ const result = endTurn(session?.id)
426
+ if (result.missed) logger.warn?.(`im-qqbot: 本轮没有发任何消息(累计 ${result.misses} 次)`)
427
+ } catch { /* 记账失败不影响回合结束 */ }
428
+ // 起草时的键有两种:record 存在时是 sessionKeyOf(record)(可能是 record.sessionId),
429
+ // record 缺失时回落成字符串 'qq'。凡是可能属于这一轮的,都按同一回合作废。
430
+ const key = session?.id
431
+ if (typeof key !== 'string') return
432
+ for (const candidate of [key, 'qq']) {
433
+ const draft = drafts.get(candidate)
434
+ if (draft === undefined) continue
435
+ drafts.delete(candidate)
436
+ const preview = String(draft.text ?? '').slice(0, 40)
437
+ logger.info(`im-qqbot: 草稿没确认,作废 ${preview}`)
438
+ }
439
+ })
440
+
441
+ logger.info('im-qqbot: qq_draft / qq_confirm / qq_skip 工具已注册')
442
+ }