dsh-qqbot-plus 0.0.0-stage → 0.1.3

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 +192 -0
  2. package/CHANGELOG_EN.md +192 -0
  3. package/LICENSE +21 -0
  4. package/README.md +294 -2
  5. package/README_EN.md +262 -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,95 @@
1
+ /**
2
+ * dsh-im-qqbot 插件配置 Schema
3
+ */
4
+ import Schema from '@deepseek-ai/schemastery';
5
+ export interface AccessControlConfig {
6
+ /** C2C 访问模式 */
7
+ c2cMode: 'open' | 'allowlist' | 'disabled';
8
+ /** C2C 白名单(user openid) */
9
+ c2cAllow: string[];
10
+ /** 群聊访问模式 */
11
+ groupMode: 'open' | 'allowlist' | 'disabled';
12
+ /** 群聊白名单(group openid) */
13
+ groupAllow: string[];
14
+ }
15
+ export interface MediaConfig {
16
+ /** 是否启用富媒体理解(图片/视频下载 + 工具分析) */
17
+ enabled: boolean;
18
+ /** 富媒体下载大小上限(MB),默认 200 */
19
+ maxMB: number;
20
+ /** 富媒体存活时长(小时,TTL),默认 24,0 = 永不过期 */
21
+ ttlHours: number;
22
+ }
23
+ export interface VisionConfig {
24
+ /** 是否启用视觉理解(qqbot_describe_image 工具) */
25
+ enabled: boolean;
26
+ /** 视觉模型 provider(dsh 注册的 llm adapter,如 pi-ai) */
27
+ provider: string;
28
+ /** 视觉模型 id(如 qwen-vl-max) */
29
+ model: string;
30
+ /** 默认描述 prompt(调用未显式指定时使用) */
31
+ defaultPrompt: string;
32
+ /** 图片字节上限,默认 10MB */
33
+ maxBytes: number;
34
+ /** 输出 token 上限 */
35
+ maxTokens: number;
36
+ /** 视觉调用超时(ms) */
37
+ timeoutMs: number;
38
+ }
39
+ /** 附件发送配置(qqbot_send_file 工具与 present 交付物投递共用) */
40
+ export interface SendFileConfig {
41
+ /** 是否启用路径白名单(默认 true,仅允许 media + cwd + extraRoots;关闭则任意路径) */
42
+ restrictPaths: boolean;
43
+ /** 额外允许访问的根目录(media 和 agent cwd 始终默认允许) */
44
+ extraRoots: string[];
45
+ /** 是否把 present 声明的交付文件在轮末发送到当前会话 */
46
+ sendPresentedFiles: boolean;
47
+ /** 单轮最多投递的交付文件数 */
48
+ maxFiles: number;
49
+ }
50
+ export interface ImQQBotConfig {
51
+ /** QQ Bot AppID */
52
+ appId: string;
53
+ /** QQ Bot AppSecret */
54
+ appSecret: string;
55
+ /** dsh LLM 提供商名称 */
56
+ provider?: string;
57
+ /** 模型名称 */
58
+ model?: string;
59
+ /** Agent preset id */
60
+ preset?: string;
61
+ /** Agent 工作目录(缺省 ~/.dsh-qqbot/workspace,不随宿主进程 cwd) */
62
+ cwd?: string;
63
+ /** 是否启用群消息 @mention 门控 */
64
+ requireMention: boolean;
65
+ /** 单条消息最大长度(QQ 限制约 5000 字符) */
66
+ textChunkLimit: number;
67
+ /** 是否启用流式输出(群聊始终不启用) */
68
+ streaming: boolean;
69
+ /** 每会话最大闲置时长(ms),超时自动回收 */
70
+ sessionIdleTimeout: number;
71
+ /** 并发队列最大长度 */
72
+ maxQueue: number;
73
+ /** 处理超时(ms),超时中断当前 LLM 调用 */
74
+ processingTimeoutMs: number;
75
+ /** 待答问题超时(ms),超时自动拒绝并提示(ask_user_question) */
76
+ askTimeoutMs: number;
77
+ /** 群历史缓冲条数 */
78
+ historyLimit: number;
79
+ /** 访问控制 */
80
+ access: AccessControlConfig;
81
+ /** 是否展示工具调用成功结果(工具错误始终展示) */
82
+ showToolResults: boolean;
83
+ /** 调试模式 */
84
+ debug: boolean;
85
+ /** 富媒体理解(图片/视频) */
86
+ media: MediaConfig;
87
+ /** 视觉理解(qqbot_describe_image 工具,走 dsh llm + attachments) */
88
+ vision: VisionConfig;
89
+ /** 附件发送(qqbot_send_file 工具与交付物投递共用) */
90
+ sendFile: SendFileConfig;
91
+ }
92
+ /** 访问控制子 Schema(独立导出:config 路由的服务端校验复用) */
93
+ export declare const AccessControlSchema: Schema<AccessControlConfig>;
94
+ export declare const ConfigSchema: Schema<ImQQBotConfig>;
95
+ //# sourceMappingURL=config.d.ts.map
package/lib/config.js ADDED
@@ -0,0 +1,88 @@
1
+ /**
2
+ * dsh-im-qqbot 插件配置 Schema
3
+ */
4
+ import Schema from '@deepseek-ai/schemastery';
5
+ /** 访问控制子 Schema(独立导出:config 路由的服务端校验复用) */
6
+ export const AccessControlSchema = Schema.object({
7
+ c2cMode: Schema.union(['open', 'allowlist', 'disabled']).default('open').description('C2C访问模式(默认开放)'),
8
+ c2cAllow: Schema.array(Schema.string()).default([]).description('C2C白名单(QQ OpenID)'),
9
+ groupMode: Schema.union(['open', 'allowlist', 'disabled']).default('open').description('群聊访问模式(默认开放:群自带进群门槛 + @bot 触发)'),
10
+ groupAllow: Schema.array(Schema.string()).default([]).description('群聊白名单(群 OpenID)'),
11
+ });
12
+ export const ConfigSchema = Schema.object({
13
+ appId: Schema.string().default('').description('QQ 机器人 AppID'),
14
+ appSecret: Schema.string().default('').description('QQ 机器人 AppSecret'),
15
+ provider: Schema.string().description('LLM provider name'),
16
+ model: Schema.string().description('Model name'),
17
+ preset: Schema.string().description('Agent preset id'),
18
+ cwd: Schema.string().description('Agent working directory (default ~/.dsh/dsh-qqbot-plus/workspace)'),
19
+ requireMention: Schema.boolean().default(true).description('群聊是否需要@bot触发'),
20
+ allowSilence: Schema.boolean().default(true).description('允许它不出声:这一轮可以判断没必要接,安静过去,不用硬回'),
21
+ sharedSession: Schema.boolean().default(false).description('群聊和私聊共用同一条会话(默认关:各聊各的,回复不会串到别的群/私聊)'),
22
+ textChunkLimit: Schema.number().default(4500).description('单条消息最大字符数'),
23
+ streaming: Schema.boolean().default(true).description('是否启用流式输出(群聊始终不启用)'),
24
+ sessionIdleTimeout: Schema.number().default(30 * 60 * 1000).description('会话闲置超时(ms)'),
25
+ maxQueue: Schema.number().default(20).description('并发队列最大长度'),
26
+ processingTimeoutMs: Schema.number().default(30 * 60 * 1000).description('处理超时(ms),超时中断当前 LLM 调用'),
27
+ askTimeoutMs: Schema.number().default(5 * 60 * 1000).description('待答问题超时(ms),超时自动拒绝并提示'),
28
+ historyLimit: Schema.number().default(10).description('群历史缓冲条数'),
29
+ access: AccessControlSchema.default({
30
+ c2cMode: 'open',
31
+ c2cAllow: [],
32
+ groupMode: 'open',
33
+ groupAllow: [],
34
+ }).description('访问控制'),
35
+ midTurnSteer: Schema.boolean().default(true).description('干活时插话:正在跑的时候新消息直接插进下一步,不等这一轮结束'),
36
+ burstWindowMs: Schema.number().default(2500).description('连发合并:安静这么久(ms)才算说完,连着的几句合成一条投;0 = 不合并'),
37
+ maxBurstMs: Schema.number().default(12000).description('连发合并:一直发个不停时最多等这么久(ms)就必须投'),
38
+ maxBurstCount: Schema.number().default(6).description('连发合并:攒到这么多条立刻投'),
39
+ resumeOnBoot: Schema.boolean().default(true).description('重启接话检查:宿主重启后只在系统提示里加一行「先调 qq_resume_check」,由工具按需读停机时长与对方最后一条话;不往任何会话注入消息'),
40
+ debug: Schema.boolean().default(false),
41
+ media: Schema.object({
42
+ enabled: Schema.boolean().default(true).description('是否启用富媒体理解(图片/视频下载 + 工具分析)'),
43
+ maxMB: Schema.number().default(200).description('富媒体下载大小上限(MB)'),
44
+ ttlHours: Schema.number().default(24).description('富媒体存活时长(小时),0=永不过期'),
45
+ }).default({
46
+ enabled: true,
47
+ maxMB: 200,
48
+ ttlHours: 24,
49
+ }).description('富媒体理解配置'),
50
+ vision: Schema.object({
51
+ enabled: Schema.boolean().default(false).description('是否启用视觉理解(qqbot_describe_image 工具)'),
52
+ provider: Schema.string().default('').description('视觉模型 provider(dsh 注册的 llm adapter,如 pi-ai)'),
53
+ model: Schema.string().default('').description('视觉模型 id(如 qwen-vl-max)'),
54
+ defaultPrompt: Schema.string().default('Describe this image in detail.').description('默认描述 prompt'),
55
+ maxBytes: Schema.number().default(10 * 1024 * 1024).description('图片字节上限'),
56
+ maxTokens: Schema.number().default(1024).description('输出 token 上限'),
57
+ timeoutMs: Schema.number().default(120000).description('视觉调用超时(ms)'),
58
+ }).default({
59
+ enabled: false,
60
+ provider: '',
61
+ model: '',
62
+ defaultPrompt: 'Describe this image in detail.',
63
+ maxBytes: 10 * 1024 * 1024,
64
+ maxTokens: 1024,
65
+ timeoutMs: 120000,
66
+ }).description('视觉理解配置'),
67
+ sendFile: Schema.object({
68
+ restrictPaths: Schema.boolean().default(true).description('是否启用路径白名单(默认 true,仅允许 media + cwd + extraRoots)'),
69
+ extraRoots: Schema.array(Schema.string()).default([]).description('额外允许访问的根目录'),
70
+ sendPresentedFiles: Schema.boolean().default(true).description('是否将 present 声明的交付文件发送到当前会话'),
71
+ maxFiles: Schema.number().default(4).description('单轮最多投递的交付文件数'),
72
+ }).default({
73
+ restrictPaths: true,
74
+ extraRoots: [],
75
+ sendPresentedFiles: true,
76
+ maxFiles: 4,
77
+ }).description('附件发送配置'),
78
+ memory: Schema.object({
79
+ enabled: Schema.boolean().default(true).description('是否启用人设/画像注入'),
80
+ personaFile: Schema.string().default('').description('人设文件(留空 = ~/.dsh/dsh-qqbot-plus/persona.md)'),
81
+ portraitFile: Schema.string().default('').description('画像文件(留空 = ~/.dsh/dsh-qqbot-plus/portrait.md)'),
82
+ }).default({
83
+ enabled: true,
84
+ personaFile: '',
85
+ portraitFile: '',
86
+ }).description('人设 / 画像(长期记忆在 humanlike 与 memory 两块,不在这里)'),
87
+ });
88
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1,9 @@
1
+ /**
2
+ * QQ 文本回复 → 结构化答案(纯函数,便于单测)。
3
+ *
4
+ * 逐题解析:一次解析一个问题的答案。
5
+ */
6
+ import type { UserQuestion, UserQuestionAnswer } from './question-channel.ts';
7
+ /** 把用户对单个问题的文本回复解析为答案 */
8
+ export declare function parseAnswer(question: UserQuestion, text: string): UserQuestionAnswer;
9
+ //# sourceMappingURL=answer-parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"answer-parser.d.ts","sourceRoot":"","sources":["../../src/features/answer-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,yBAAyB;AACzB,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAmBpF"}
@@ -0,0 +1,23 @@
1
+ /** 把用户对单个问题的文本回复解析为答案 */
2
+ export function parseAnswer(question, text) {
3
+ const opts = question.options ?? [];
4
+ if (opts.length > 0) {
5
+ // 纯数字/分隔符 → 按编号选择
6
+ if (/^[\d\s,,、;;./]+$/.test(text)) {
7
+ const nums = [...text.matchAll(/\d+/g)]
8
+ .map((m) => parseInt(m[0], 10))
9
+ .filter((n) => n >= 1 && n <= opts.length);
10
+ if (nums.length > 0) {
11
+ const picked = question.multiSelect ? nums : nums.slice(0, 1);
12
+ const selected = [...new Set(picked.map((n) => opts[n - 1]?.label).filter((l) => typeof l === 'string'))];
13
+ return { id: question.id, selected };
14
+ }
15
+ }
16
+ // 文本与某个选项 label 完全一致(忽略大小写)
17
+ const exact = opts.find((o) => o.label.toLowerCase() === text.toLowerCase());
18
+ if (exact)
19
+ return { id: question.id, selected: [exact.label] };
20
+ }
21
+ return { id: question.id, selected: [], custom: text };
22
+ }
23
+ //# sourceMappingURL=answer-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"answer-parser.js","sourceRoot":"","sources":["../../src/features/answer-parser.ts"],"names":[],"mappings":"AAOA,yBAAyB;AACzB,MAAM,UAAU,WAAW,CAAC,QAAsB,EAAE,IAAY;IAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,kBAAkB;QAClB,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;iBACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;iBAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9D,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACvH,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC;YACvC,CAAC;QACH,CAAC;QACD,4BAA4B;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7E,IAAI,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC"}
@@ -0,0 +1,94 @@
1
+ /**
2
+ * ApprovalChannel — 把 dsh 的审批 seam(`approval/request` waterfall)桥接到 QQ。
3
+ *
4
+ * 接入方式:监听 `approval/request` waterfall,按 `request.agent.id` 路由到 QQ
5
+ * 会话;非 QQ 会话委托链上其他 answerer(`next()`),多通道(Web/TUI)共存。
6
+ *
7
+ * 每个会话同一时间最多一个 pending 审批(审批是阻塞式的);outcome 是 dsh
8
+ * 协议的闭合集合,无 allow-always,只提供「允许一次 / 拒绝」两个按钮。
9
+ */
10
+ import type { EventOptions } from '@deepseek-ai/cordis';
11
+ import type { InteractionEvent } from '@tencent-connect/qqbot-nodejs';
12
+ import type { ChatScope, Logger, ReplyTarget } from '../types.ts';
13
+ export type ApprovalOutcome = 'allowed-once' | 'rejected' | 'cancelled' | 'unavailable';
14
+ /** session log 中 tool/call 事件的最小结构(commandOf 回显命令用) */
15
+ interface ApprovalSessionEvent {
16
+ type: string;
17
+ data?: {
18
+ callId?: unknown;
19
+ arguments?: unknown;
20
+ [key: string]: unknown;
21
+ };
22
+ }
23
+ export interface ApprovalRequest {
24
+ agent: {
25
+ id: string;
26
+ /**
27
+ * dsh-agent 的 `Agent.session` 在类型上是必选,但审批请求可能来自跨进程或
28
+ * 投影后的上下文,运行时拿不到 live session(类型契约与运行时的 gap)。此时
29
+ * 只是无法回显命令原文,不应让整个审批失败,故这里标为可选。
30
+ */
31
+ session?: {
32
+ snapshotEvents?(): readonly ApprovalSessionEvent[];
33
+ };
34
+ };
35
+ toolName: string;
36
+ /** 关联的 tool/call 事件 id,用于从 session log 找回被 gate 的命令 */
37
+ callId?: string;
38
+ /** asker 的人类可读解释 */
39
+ reason?: string;
40
+ signal?: AbortSignal;
41
+ }
42
+ export interface ApprovalSessionRecordLike {
43
+ sessionKey: string;
44
+ scope: ChatScope;
45
+ replyTarget: ReplyTarget;
46
+ }
47
+ export interface ApprovalChannelManagerLike {
48
+ findBySessionId(sessionId: string): ApprovalSessionRecordLike | undefined;
49
+ getSessionRecord(scope: ChatScope, peerId: string): ApprovalSessionRecordLike | undefined;
50
+ }
51
+ export interface ApprovalChannelSenderLike {
52
+ sendMarkdown(target: ReplyTarget, content: string, opts?: {
53
+ keyboard?: unknown;
54
+ }): Promise<unknown>;
55
+ }
56
+ /** 配置投影(审批按钮校验 allowlist 用) */
57
+ export interface ApprovalChannelConfigLike {
58
+ access: {
59
+ c2cMode: 'open' | 'allowlist' | 'disabled';
60
+ c2cAllow: readonly string[];
61
+ };
62
+ }
63
+ /** approval/request waterfall 的 answerer handler */
64
+ export interface ApprovalChannelContext {
65
+ on(event: string, handler: (...args: unknown[]) => unknown, options?: EventOptions): () => boolean;
66
+ }
67
+ export declare class ApprovalChannel {
68
+ private readonly pending;
69
+ private readonly manager;
70
+ private readonly sender;
71
+ private readonly logger;
72
+ private readonly config;
73
+ constructor(manager: ApprovalChannelManagerLike, sender: ApprovalChannelSenderLike, config: ApprovalChannelConfigLike, logger: Logger);
74
+ /**
75
+ * 注册 approval/request waterfall answerer。
76
+ *
77
+ * 不再探测 approval 服务是否已挂载:它是 optional peer,挂载时机可能晚于
78
+ * 本插件的 apply,一次性探测失败会让通道永久失效。监听事件本身不依赖服务
79
+ * 存在——服务就绪后请求自然经过同一条瀑布,未挂载时不会有请求到达。
80
+ *
81
+ * `global` 是必需的:approval/request 按 agent 作用域派发,根作用域注册的
82
+ * 监听器不带 global 会被作用域过滤掉。
83
+ */
84
+ install(ctx: ApprovalChannelContext): void;
85
+ /** 会话回收时清理其 pending 审批,避免 Promise 悬挂 */
86
+ cancelPending(sessionKey: string): void;
87
+ /** 按钮点击决策:解码 button_data,校验点击者授权,settle pending 审批 */
88
+ handleInteraction(event: InteractionEvent): boolean;
89
+ /** 走 QQ 通道:发审批消息 + 挂起 Promise,等待用户决策 */
90
+ private park;
91
+ private removeAbort;
92
+ }
93
+ export {};
94
+ //# sourceMappingURL=approval-channel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval-channel.d.ts","sourceRoot":"","sources":["../../src/features/approval-channel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,158 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { decodeButtonData } from "./button-utils.js";
3
+ import { buildApprovalKeyboard, buildApprovalText } from "./approval-renderer.js";
4
+ const COMMAND_CLIP = 500;
5
+ /**
6
+ * 从 session log 按 callId 找回被 gate 的命令(审批请求本身不重复携带 arguments)。
7
+ * 对齐 TUI/web 的 `commandOf` 语义。
8
+ */
9
+ function commandOf(req) {
10
+ if (req.callId === undefined)
11
+ return undefined;
12
+ // 审批请求可能来自没有 live session 的上下文(例如跨进程/投影后的 Agent),
13
+ // 此时只是拿不到命令原文,不能因此让整个审批失败。
14
+ const events = req.agent.session?.snapshotEvents?.();
15
+ if (!Array.isArray(events))
16
+ return undefined;
17
+ for (let i = events.length - 1; i >= 0; i -= 1) {
18
+ const event = events[i];
19
+ if (!event || event.type !== 'tool/call')
20
+ continue;
21
+ const data = event.data;
22
+ if (String(data?.callId) !== String(req.callId))
23
+ continue;
24
+ const raw = data?.arguments;
25
+ if (typeof raw !== 'string')
26
+ return undefined;
27
+ try {
28
+ const parsed = JSON.parse(raw);
29
+ if (parsed !== null && typeof parsed === 'object' && 'command' in parsed) {
30
+ const command = parsed.command;
31
+ if (typeof command === 'string')
32
+ return command;
33
+ }
34
+ }
35
+ catch {
36
+ // 非 JSON,回退到原始字符串
37
+ }
38
+ return raw.length <= COMMAND_CLIP ? raw : `${raw.slice(0, COMMAND_CLIP)}…`;
39
+ }
40
+ return undefined;
41
+ }
42
+ export class ApprovalChannel {
43
+ pending = new Map();
44
+ manager;
45
+ sender;
46
+ logger;
47
+ config;
48
+ constructor(manager, sender, config, logger) {
49
+ this.manager = manager;
50
+ this.sender = sender;
51
+ this.config = config;
52
+ this.logger = logger;
53
+ }
54
+ /**
55
+ * 注册 approval/request waterfall answerer。
56
+ *
57
+ * 不再探测 approval 服务是否已挂载:它是 optional peer,挂载时机可能晚于
58
+ * 本插件的 apply,一次性探测失败会让通道永久失效。监听事件本身不依赖服务
59
+ * 存在——服务就绪后请求自然经过同一条瀑布,未挂载时不会有请求到达。
60
+ *
61
+ * `global` 是必需的:approval/request 按 agent 作用域派发,根作用域注册的
62
+ * 监听器不带 global 会被作用域过滤掉。
63
+ */
64
+ install(ctx) {
65
+ const self = this;
66
+ ctx.on('approval/request', (req, next) => {
67
+ const request = req;
68
+ const nextFn = next;
69
+ const record = self.manager.findBySessionId(request.agent.id);
70
+ if (record)
71
+ return self.park(record, request);
72
+ return nextFn();
73
+ }, { global: true, prepend: true });
74
+ this.logger.info('im-qqbot: QQ approval channel installed');
75
+ }
76
+ /** 会话回收时清理其 pending 审批,避免 Promise 悬挂 */
77
+ cancelPending(sessionKey) {
78
+ const entry = this.pending.get(sessionKey);
79
+ if (!entry)
80
+ return;
81
+ this.pending.delete(sessionKey);
82
+ this.removeAbort(entry);
83
+ entry.resolve('cancelled');
84
+ }
85
+ /** 按钮点击决策:解码 button_data,校验点击者授权,settle pending 审批 */
86
+ handleInteraction(event) {
87
+ const peerId = event.group_openid ?? event.user_openid;
88
+ if (!peerId)
89
+ return false;
90
+ const scope = event.group_openid ? 'group' : 'c2c';
91
+ const record = this.manager.getSessionRecord(scope, peerId);
92
+ if (!record)
93
+ return false;
94
+ const entry = this.pending.get(record.sessionKey);
95
+ if (!entry)
96
+ return false;
97
+ const data = event.data?.resolved?.button_data;
98
+ if (!data)
99
+ return false;
100
+ const button = decodeButtonData(data);
101
+ if (!button || button.t !== 'approval')
102
+ return false;
103
+ // nonce 必须匹配 pending:旧卡片/其它会话的卡片点击不 settle(#94-3)
104
+ if (button.n !== entry.nonce) {
105
+ this.logger.warn(`im-qqbot: approval button nonce mismatch: key=${record.sessionKey}`);
106
+ return false;
107
+ }
108
+ // 白名单模式下审批只认名单内用户;点击者身份缺失同样拒绝(fail-closed,#94-3)
109
+ const clicker = event.group_member_openid ?? event.user_openid;
110
+ if (this.config.access.c2cMode === 'allowlist'
111
+ && (!clicker || !this.config.access.c2cAllow.includes(clicker))) {
112
+ this.logger.warn(`im-qqbot: approval button rejected (clicker not allowlisted): user=${clicker ?? '(missing)'} key=${record.sessionKey}`);
113
+ return false;
114
+ }
115
+ this.pending.delete(record.sessionKey);
116
+ this.removeAbort(entry);
117
+ entry.resolve(button.d === 'allow' ? 'allowed-once' : 'rejected');
118
+ return true;
119
+ }
120
+ /** 走 QQ 通道:发审批消息 + 挂起 Promise,等待用户决策 */
121
+ async park(record, request) {
122
+ const key = record.sessionKey;
123
+ // 会话回收/取消可能在发送前发生:signal 已 abort 则直接失败
124
+ if (request.signal?.aborted)
125
+ return 'cancelled';
126
+ const command = commandOf(request);
127
+ const nonce = randomUUID().slice(0, 8);
128
+ try {
129
+ await this.sender.sendMarkdown(record.replyTarget, buildApprovalText(request, command), { keyboard: buildApprovalKeyboard(nonce) });
130
+ }
131
+ catch (err) {
132
+ const msg = err instanceof Error ? err.message : String(err);
133
+ this.logger.error(`im-qqbot: approval send failed key=${key}: ${msg}`);
134
+ return 'unavailable'; // 无法呈现审批,fail-closed
135
+ }
136
+ return new Promise((resolve) => {
137
+ const entry = { record, request, resolve, nonce };
138
+ if (request.signal) {
139
+ const onAbort = () => {
140
+ if (this.pending.get(key) !== entry)
141
+ return;
142
+ this.pending.delete(key);
143
+ resolve('cancelled');
144
+ };
145
+ entry.onAbort = onAbort;
146
+ request.signal.addEventListener('abort', onAbort, { once: true });
147
+ }
148
+ this.pending.set(key, entry);
149
+ this.logger.info(`im-qqbot: approval sent to QQ, waiting for decision key=${key}`);
150
+ });
151
+ }
152
+ removeAbort(entry) {
153
+ if (entry.onAbort && entry.request.signal) {
154
+ entry.request.signal.removeEventListener('abort', entry.onAbort);
155
+ }
156
+ }
157
+ }
158
+ //# sourceMappingURL=approval-channel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval-channel.js","sourceRoot":"","sources":["../../src/features/approval-channel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * QQ 审批的文本渲染与按钮键盘构建(纯函数,便于单测)。
3
+ *
4
+ * 单次审批:一次只渲染一个审批请求(每个会话同时只有一个 pending 审批)。
5
+ */
6
+ import type { InlineKeyboard } from '@tencent-connect/qqbot-nodejs';
7
+ import type { ApprovalRequest } from './approval-channel.ts';
8
+ /** 把审批请求渲染成 QQ 文本(含被 gate 的命令回显) */
9
+ export declare function buildApprovalText(request: ApprovalRequest, command?: string): string;
10
+ /**
11
+ * 构建审批键盘:两按钮(允许一次 / 拒绝),button_data 携带本审批的 nonce。
12
+ *
13
+ * dsh 审批协议 outcome 是闭合集合(allowed-once/rejected/cancelled/unavailable),
14
+ * 无 allow-always,因此只提供两个按钮;`group_id` 相同实现单选互斥变灰。
15
+ * nonce 与 pending 匹配,旧卡片/其它会话卡片点击不 settle(#94-3)。
16
+ */
17
+ export declare function buildApprovalKeyboard(nonce: string): InlineKeyboard;
18
+ //# sourceMappingURL=approval-renderer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval-renderer.d.ts","sourceRoot":"","sources":["../../src/features/approval-renderer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,oCAAoC;AACpC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBpF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAwBnE"}
@@ -0,0 +1,52 @@
1
+ import { encodeButtonData } from "./button-utils.js";
2
+ /** 把审批请求渲染成 QQ 文本(含被 gate 的命令回显) */
3
+ export function buildApprovalText(request, command) {
4
+ const lines = ['🔐 **执行审批**', ''];
5
+ lines.push(`🔧 工具: ${request.toolName}`);
6
+ if (command) {
7
+ lines.push('');
8
+ lines.push('```');
9
+ lines.push(command);
10
+ lines.push('```');
11
+ }
12
+ if (request.reason) {
13
+ lines.push('');
14
+ lines.push(`📝 ${request.reason}`);
15
+ }
16
+ lines.push('');
17
+ lines.push('> 👇 点击下方按钮确认是否允许执行');
18
+ return lines.join('\n');
19
+ }
20
+ /**
21
+ * 构建审批键盘:两按钮(允许一次 / 拒绝),button_data 携带本审批的 nonce。
22
+ *
23
+ * dsh 审批协议 outcome 是闭合集合(allowed-once/rejected/cancelled/unavailable),
24
+ * 无 allow-always,因此只提供两个按钮;`group_id` 相同实现单选互斥变灰。
25
+ * nonce 与 pending 匹配,旧卡片/其它会话卡片点击不 settle(#94-3)。
26
+ */
27
+ export function buildApprovalKeyboard(nonce) {
28
+ const allow = {
29
+ id: 'approval-allow',
30
+ render_data: { label: '✅ 允许一次', visited_label: '✓ 已允许', style: 1 },
31
+ action: {
32
+ type: 1,
33
+ permission: { type: 2 },
34
+ click_limit: 1,
35
+ data: encodeButtonData({ t: 'approval', d: 'allow', n: nonce }),
36
+ },
37
+ group_id: 'approval',
38
+ };
39
+ const deny = {
40
+ id: 'approval-deny',
41
+ render_data: { label: '❌ 拒绝', visited_label: '✓ 已拒绝', style: 0 },
42
+ action: {
43
+ type: 1,
44
+ permission: { type: 2 },
45
+ click_limit: 1,
46
+ data: encodeButtonData({ t: 'approval', d: 'deny', n: nonce }),
47
+ },
48
+ group_id: 'approval',
49
+ };
50
+ return { content: { rows: [{ buttons: [allow, deny] }] } };
51
+ }
52
+ //# sourceMappingURL=approval-renderer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval-renderer.js","sourceRoot":"","sources":["../../src/features/approval-renderer.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,oCAAoC;AACpC,MAAM,UAAU,iBAAiB,CAAC,OAAwB,EAAE,OAAgB;IAC1E,MAAM,KAAK,GAAa,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,KAAK,GAAG;QACZ,EAAE,EAAE,gBAAgB;QACpB,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE;QAClE,MAAM,EAAE;YACN,IAAI,EAAE,CAAC;YACP,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YACvB,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;SAChE;QACD,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE;QAChE,MAAM,EAAE;YACN,IAAI,EAAE,CAAC;YACP,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YACvB,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;SAC/D;QACD,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;AAC7D,CAAC"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * 按钮渲染与 button_data 编码的共享工具(QuestionChannel / ApprovalChannel 共用)。
3
+ *
4
+ * 统一 button_data 编码:所有回调按钮的 data 都带顶层 `t` 判别字段,
5
+ * 供 `dispatchInteraction` 分发器统一路由到对应 channel,避免多通道
6
+ * 各自 try 导致误判。
7
+ */
8
+ import type { InlineKeyboard } from '@tencent-connect/qqbot-nodejs';
9
+ /** QQ 按钮 label 有长度限制,超长截断(正文保留完整文本;多列布局下阈值更短) */
10
+ export declare const BUTTON_LABEL_MAX = 10;
11
+ /** 单选按钮每行个数(多列布局,减少选项多时的刷屏) */
12
+ export declare const BUTTONS_PER_ROW = 2;
13
+ /** 截断按钮 label,超长补省略号 */
14
+ export declare function buttonLabel(text: string | undefined): string;
15
+ /** 问答按钮:q=问题 id,i=选项下标 */
16
+ export interface QuestionButtonData {
17
+ t: 'question';
18
+ q: string;
19
+ i: number;
20
+ }
21
+ /** 审批按钮:d=决策,n=本审批的 nonce(与 pending 匹配,防旧卡片混淆 #94-3) */
22
+ export interface ApprovalButtonData {
23
+ t: 'approval';
24
+ d: 'allow' | 'deny';
25
+ n?: string;
26
+ }
27
+ export type ButtonData = QuestionButtonData | ApprovalButtonData;
28
+ /** 编码 button_data(JSON 字符串) */
29
+ export declare function encodeButtonData(data: ButtonData): string;
30
+ /** 解码 button_data;非法 JSON 或缺少合法 `t` 时返回 undefined */
31
+ export declare function decodeButtonData(raw: string): ButtonData | undefined;
32
+ /** 构建内联键盘的行数组(供 buildKeyboard/buildApprovalKeyboard 复用类型) */
33
+ export type KeyboardRows = InlineKeyboard['content']['rows'];
34
+ //# sourceMappingURL=button-utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"button-utils.d.ts","sourceRoot":"","sources":["../../src/features/button-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,+BAA+B;AAC/B,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,wBAAwB;AACxB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG5D;AAID,0BAA0B;AAC1B,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,UAAU,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,UAAU,CAAC;IACd,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEjE,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAUpE;AAED,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}
@@ -0,0 +1,27 @@
1
+ /** QQ 按钮 label 有长度限制,超长截断(正文保留完整文本;多列布局下阈值更短) */
2
+ export const BUTTON_LABEL_MAX = 10;
3
+ /** 单选按钮每行个数(多列布局,减少选项多时的刷屏) */
4
+ export const BUTTONS_PER_ROW = 2;
5
+ /** 截断按钮 label,超长补省略号 */
6
+ export function buttonLabel(text) {
7
+ const s = String(text ?? '').trim();
8
+ return s.length > BUTTON_LABEL_MAX ? s.slice(0, BUTTON_LABEL_MAX - 1) + '…' : s;
9
+ }
10
+ /** 编码 button_data(JSON 字符串) */
11
+ export function encodeButtonData(data) {
12
+ return JSON.stringify(data);
13
+ }
14
+ /** 解码 button_data;非法 JSON 或缺少合法 `t` 时返回 undefined */
15
+ export function decodeButtonData(raw) {
16
+ try {
17
+ const parsed = JSON.parse(raw);
18
+ if (parsed !== null && typeof parsed === 'object' && (parsed.t === 'question' || parsed.t === 'approval')) {
19
+ return parsed;
20
+ }
21
+ }
22
+ catch {
23
+ // fall through
24
+ }
25
+ return undefined;
26
+ }
27
+ //# sourceMappingURL=button-utils.js.map