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,1081 @@
1
+ /**
2
+ * SessionManager — 管理 QQ peer → dsh Agent 的映射和生命周期
3
+ *
4
+ * sessionKey 格式: `qqbot:${appId}:${kind}:${peerId}`
5
+ * - c2c: peerId = senderId (用户 openid)
6
+ * - group: peerId = groupOpenid
7
+ *
8
+ * sessionKey → sessionId 的映射存于 prefs(`model-prefs.json`),新会话 id 由
9
+ * `mintSessionId()` 铸造(`session-` + UUID,与宿主一致)。0.5.x 的 SHA-256 确定性
10
+ * 派生 id 仅用于探测存量会话并迁移,不再用于新建——确定性 id 跨进程必然相同,
11
+ * 两个进程各自新建会把同一 id 写入不同 project 目录。
12
+ *
13
+ * 支持 agent-presets 系统:通过 setup hook 在 create/resume 时
14
+ * 挂载 preset(工具集、prompt sections 等),实现场景化配置。
15
+ */
16
+ import { legacyDerivedSessionId, mintSessionId } from "./session-id.js";
17
+ import { SessionId } from '@deepseek-ai/dsh-session';
18
+ import { createUserMessage } from '@deepseek-ai/dsh-llm';
19
+ import { createHostAdapter } from "../host/adapter.js";
20
+ import { mkdirSync, existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
21
+ import { resolveAgentCwd, PLUGIN_HOME } from "../shared/dirs.js";
22
+ import { ModelResolver } from "../model/model-resolver.js";
23
+ import { IdleEvictor } from "./idle-evictor.js";
24
+ import { MemoryRuntime, expandHome } from "../memory/runtime.js";
25
+ import { defaultPersonaFile, defaultPortraitFile } from "../memory/paths.js";
26
+ import { homedir } from 'node:os';
27
+ import { join, resolve } from 'node:path';
28
+ /**
29
+ * 机器人自己的共享会话 id:只生成一次,落在 PLUGIN_HOME/shared-session.json。
30
+ * 群聊和私聊都指向同一条 session,但这条会话由本插件创建、在
31
+ * ~/.dsh/dsh-qqbot-plus/workspace 下,不再依赖 dsh-qq。
32
+ */
33
+ function resolveOwnSharedSession(logger) {
34
+ const file = join(PLUGIN_HOME, 'shared-session.json');
35
+ try {
36
+ if (existsSync(file)) {
37
+ const data = JSON.parse(readFileSync(file, 'utf8'));
38
+ const id = typeof data?.sessionId === 'string' ? data.sessionId.trim() : '';
39
+ if (id !== '')
40
+ return id;
41
+ }
42
+ }
43
+ catch {
44
+ // 文件坏了就重新生成一个
45
+ }
46
+ const id = mintSessionId();
47
+ writeSharedSession(id, logger);
48
+ logger.info?.(`im-qqbot: 创建自己的共享会话 ${id}`);
49
+ return id;
50
+ }
51
+ /** 把共享会话 id 落盘(换会话时也要走这里)。 */
52
+ function writeSharedSession(id, logger) {
53
+ const file = join(PLUGIN_HOME, 'shared-session.json');
54
+ try {
55
+ mkdirSync(PLUGIN_HOME, { recursive: true });
56
+ writeFileSync(file, JSON.stringify({ sessionId: id, createdAt: new Date().toISOString() }, null, 2), 'utf8');
57
+ }
58
+ catch (error) {
59
+ logger.warn?.(`im-qqbot: 保存共享会话 id 失败 ${String(error)}`);
60
+ }
61
+ }
62
+ /** ManualCompactionError 各 code 的友好提示 */
63
+ const COMPACTION_ERROR_HINTS = {
64
+ busy: '压缩服务忙,请稍后重试',
65
+ cancelled: '压缩已取消',
66
+ changed: '历史在压缩过程中发生变化,请重试',
67
+ commit: '压缩提交失败',
68
+ persistence: '压缩完成但保存失败',
69
+ };
70
+ /** 复刻宿主 latestCompletedPrefixBoundary:最后一个 turn/end 起到下一 turn 开始前的边界 */
71
+ export function latestCompletedPrefixBoundary(events) {
72
+ const list = events;
73
+ let lastTurnEndSeq;
74
+ for (let i = list.length - 1; i >= 0; i -= 1) {
75
+ const candidate = list[i];
76
+ if (candidate?.type === 'turn/end') {
77
+ lastTurnEndSeq = candidate.seq;
78
+ break;
79
+ }
80
+ }
81
+ if (lastTurnEndSeq === undefined)
82
+ return undefined;
83
+ let boundary = lastTurnEndSeq;
84
+ for (const next of list.slice(boundary + 1)) {
85
+ if (next.type === 'turn/start'
86
+ || (next.type === 'user/message' && next.surfaceOp === 'append')
87
+ || next.type === 'agent/inbox/spliced')
88
+ break;
89
+ if (next.seq !== undefined)
90
+ boundary = next.seq;
91
+ }
92
+ return boundary;
93
+ }
94
+ export class SessionManager {
95
+ sessions = new Map();
96
+ /**
97
+ * 同 key 正在进行的 getOrCreate(singleflight)。
98
+ *
99
+ * 斜杠命令与待答问题截获位于 concurrencyGuard 之前(见 gateway/middleware-setup),
100
+ * 与普通消息不串行:同 key 并发进入会各自 resume/create,产出两个 agent,
101
+ * 后写入 sessions 的覆盖前者且前者无人 dispose(泄漏)。
102
+ */
103
+ inflight = new Map();
104
+ evictor;
105
+ modelResolver;
106
+ ctx;
107
+ host;
108
+ agents;
109
+ config;
110
+ logger;
111
+ /** 由 bootstrap 注入的问答通道(ask_user_question → QQ),会话回收时清理其待答问题 */
112
+ questionChannel;
113
+ /** 由 bootstrap 注入的审批通道(approval/request → QQ),会话回收时清理其待批审批 */
114
+ approvalChannel;
115
+ constructor(ctx, agents, config, logger) {
116
+ this.ctx = ctx;
117
+ this.agents = agents;
118
+ this.config = config;
119
+ this.logger = logger;
120
+ this.host = createHostAdapter(ctx, logger);
121
+ this.logger.info(`host adapter capabilities: ${this.host.capabilities.join(', ')}`);
122
+ this.modelResolver = new ModelResolver(ctx, config, logger);
123
+ // 默认每个 peer 各一条会话(跟官方原版一致):群聊和私聊的上下文、草稿、回复目标
124
+ // 互不干扰。想回到「群聊/私聊共用一条」的旧行为,把 config.sharedSession 打开。
125
+ this.sharedSessionId = config.sharedSession === true ? resolveOwnSharedSession(logger) : null;
126
+ // 共用 session 时,同一条会话可能对应多个 peer,出站消息要回到「最后说话的那个」。
127
+ this.activeBySession = new Map();
128
+ if (this.sharedSessionId !== null) {
129
+ this.logger.info(`im-qqbot: 使用自己的共享会话 ${this.sharedSessionId}`);
130
+ }
131
+ else {
132
+ this.logger.info('im-qqbot: 每个群/私聊各用一条独立会话');
133
+ }
134
+ this.memory = this.createMemory();
135
+ // 共用 session 时所有 peer 共用同一个 agent,闲置回收会把别人正在用的会话关掉,所以不挂 evictor。
136
+ this.evictor = this.sharedSessionId !== null
137
+ ? undefined
138
+ : new IdleEvictor(this.sessions, config.sessionIdleTimeout, (key, record) => {
139
+ this.logger.info(`evicting idle session: key=${key}`);
140
+ this.sessions.delete(key);
141
+ record.agent.cancel({ kind: 'user' });
142
+ void record.handle.dispose().catch(() => { });
143
+ // 回收会话时统一清理其待答问题/待批审批,避免 pending 悬挂泄漏
144
+ this.questionChannel?.cancelPending(key);
145
+ this.approvalChannel?.cancelPending(key);
146
+ });
147
+ this.registerScopePromptInjection();
148
+ }
149
+ /**
150
+ * 通过 system-prompt/assemble waterfall 注入群聊/私聊额外 system prompt。
151
+ *
152
+ * 该事件在每次 turn 构建 request 时触发;此处按会话 scope(群聊/私聊)
153
+ * 追加对应的额外 prompt section。会话尚未建立(首次 assemble)或未配置
154
+ * 额外 prompt 时原样返回,不做改动。
155
+ */
156
+ registerScopePromptInjection() {
157
+ const assemble = async (_assembly, context, next) => {
158
+ const assembled = await next();
159
+ if (!context.agent)
160
+ return assembled;
161
+ const record = this.findByAgent(context.agent);
162
+ if (!record)
163
+ return assembled;
164
+ const sections = [...(assembled.sections ?? [])];
165
+ const base = sections.length;
166
+ // 人设(order 20)→ 画像(4800)→ 通道附加提示(90)。
167
+ // 顺序只影响拼装位置;人设最靠前,记忆里的事实最后作参考。
168
+ const persona = this.memory?.personaText();
169
+ if (persona)
170
+ sections.push({ name: 'qqbot:persona', order: 20, text: persona });
171
+ const portrait = this.memory?.portraitText();
172
+ if (portrait)
173
+ sections.push({ name: 'qqbot:portrait', order: 4800, text: portrait });
174
+ // 记忆不在这里:长期记忆和转录归 dsh-fishmemory 插件(它自己听 session
175
+ // 事件、自己注入索引与「这一轮你可能要用到的」)。这里只放稳定的人设和画像。
176
+ const prompt = record.scope === 'group' ? this.config.groupPrompt : this.config.directPrompt;
177
+ if (prompt)
178
+ sections.push({ name: 'qqbot:scope-prompt', order: 90, text: prompt });
179
+ if (sections.length === base)
180
+ return assembled;
181
+ return { ...assembled, sections };
182
+ };
183
+ this.ctx.on('system-prompt/assemble', assemble);
184
+ }
185
+ /**
186
+ * 记忆运行时:用自己的数据目录(~/.dsh/dsh-qqbot-plus)。
187
+ * 首次运行从 dsh-qq 复制一份人设/画像/记忆(不移动原文件),之后完全独立,
188
+ * 以后卸载 dsh-qq 也不影响这里的记忆。
189
+ */
190
+ createMemory() {
191
+ const settings = this.config.memory ?? {};
192
+ const home = PLUGIN_HOME;
193
+ const pick = (value, fallback) => {
194
+ const text = expandHome(value, homedir()) || fallback;
195
+ return text;
196
+ };
197
+ try {
198
+ return new MemoryRuntime({
199
+ logger: this.logger,
200
+ ctx: this.ctx,
201
+ enabled: settings.enabled !== false,
202
+ allowSilence: this.config.allowSilence !== false,
203
+ personaFile: pick(settings.personaFile, defaultPersonaFile()),
204
+ portraitFile: pick(settings.portraitFile, defaultPortraitFile()),
205
+ });
206
+ }
207
+ catch (error) {
208
+ this.logger.warn?.(`im-qqbot: 记忆初始化失败 ${String(error)}`);
209
+ return undefined;
210
+ }
211
+ }
212
+ /**
213
+ * 动态获取 agentPresets 服务(可选,未注入时返回 undefined)
214
+ */
215
+ getPresetsService() {
216
+ try {
217
+ return this.ctx.get('agentPresets');
218
+ }
219
+ catch {
220
+ return undefined;
221
+ }
222
+ }
223
+ /**
224
+ * 从 session 持久化 header 读 session 当初的 preset(started 锁定语义)。
225
+ * 读不到(服务缺失 / session 不存在 / 未记录 agentPreset)返回 undefined。
226
+ */
227
+ async resolvePersistedPreset(sessionId) {
228
+ return (await this.host.sessionHeader(sessionId))?.agentPreset;
229
+ }
230
+ // ── 模型相关(委托给 ModelResolver) ──
231
+ getEffectiveModel(scope, peerId) {
232
+ return this.modelResolver.getEffectiveRoute(this.sessionKey(scope, peerId));
233
+ }
234
+ /**
235
+ * 获取指定 peer 的生效 preset(per-peer 覆盖 > config.preset)
236
+ */
237
+ getEffectivePreset(scope, peerId) {
238
+ return this.getEffectivePresetByKey(this.sessionKey(scope, peerId));
239
+ }
240
+ /** 按 sessionKey 解析生效 preset */
241
+ getEffectivePresetByKey(key) {
242
+ return this.modelResolver.getPreset(key) ?? this.config.preset;
243
+ }
244
+ /**
245
+ * 列出所有可用 preset(/preset 命令用)
246
+ */
247
+ async listPresets() {
248
+ const presets = this.getPresetsService();
249
+ if (!presets)
250
+ return [];
251
+ try {
252
+ const list = await presets.list();
253
+ return list.map((p) => ({ id: p.id, name: p.name, description: p.description }));
254
+ }
255
+ catch (err) {
256
+ this.logger.warn(`list presets failed: ${err instanceof Error ? err.message : String(err)}`);
257
+ return [];
258
+ }
259
+ }
260
+ /**
261
+ * 切换模型(fork + 重建会话,保留历史)
262
+ */
263
+ async setModelOverride(scope, peerId, route) {
264
+ const key = this.sessionKey(scope, peerId);
265
+ this.modelResolver.setOverride(key, route);
266
+ const record = this.sessions.get(key);
267
+ if (!record) {
268
+ this.logger.info(`model pref saved (no active session): key=${key} → ${route.provider}/${route.model}`);
269
+ return;
270
+ }
271
+ await this.rebuildSession(record, { route });
272
+ this.logger.info(`model switched via fork: key=${key} → ${route.provider}/${route.model}`);
273
+ }
274
+ /**
275
+ * 切换指定 peer 的 agent preset(per-peer 覆盖)
276
+ *
277
+ * 已开始的会话保持锁定(blank-session contract):只持久化为新会话默认,
278
+ * 不 fork/rebuild 当前会话,避免历史工具调用与新 preset 工具集冲突。
279
+ */
280
+ async setPresetOverride(scope, peerId, presetId) {
281
+ const key = this.sessionKey(scope, peerId);
282
+ // 1. 校验 preset 存在 + 可加载(broken 拒绝)
283
+ const presets = this.getPresetsService();
284
+ if (!presets)
285
+ return { ok: false, reason: 'unavailable' };
286
+ let resolved;
287
+ try {
288
+ resolved = await presets.resolve(presetId);
289
+ }
290
+ catch (err) {
291
+ return { ok: false, reason: 'unknown-preset', message: err instanceof Error ? err.message : String(err) };
292
+ }
293
+ if (resolved.broken !== undefined) {
294
+ return { ok: false, reason: 'broken', message: resolved.broken };
295
+ }
296
+ // 2. 持久化 per-peer 覆盖(新会话生效)
297
+ this.modelResolver.setPreset(key, presetId);
298
+ const hasActive = this.sessions.has(key);
299
+ this.logger.info(`preset pref saved: key=${key} → ${presetId}${hasActive ? ' (active session locked, next session applies)' : ''}`);
300
+ return { ok: true, presetId };
301
+ }
302
+ /**
303
+ * 清除 per-peer preset 覆盖,回到 config.preset / 默认(新会话生效)
304
+ */
305
+ async clearPresetOverride(scope, peerId) {
306
+ const key = this.sessionKey(scope, peerId);
307
+ this.modelResolver.clearPreset(key);
308
+ this.logger.info(`preset pref cleared: key=${key} (next session applies)`);
309
+ return { ok: true };
310
+ }
311
+ /**
312
+ * fork + 重建会话(保留历史,换 model)
313
+ *
314
+ * options.route 缺省时沿用当前生效值。preset 沿用当前生效 preset(getEffectivePresetByKey)。
315
+ * fork 不可用或失败时降级为 dispose(下次消息重建)。
316
+ */
317
+ async rebuildSession(record, options) {
318
+ const key = record.sessionKey;
319
+ // 对齐宿主官方 fork(commands.fork):buildForkSeed 产物原样作 seed,
320
+ // create 传 inheritedEventCount + isSeeded + parentSession
321
+ const events = this.host.sessionEvents(record.agent.session);
322
+ const boundary = latestCompletedPrefixBoundary(events);
323
+ if (boundary === undefined) {
324
+ this.logger.warn(`fork unavailable (no completed turn), fallback to dispose: key=${key}`);
325
+ this.sessions.delete(key);
326
+ record.agent.cancel({ kind: 'user' });
327
+ await record.handle.dispose().catch(() => { });
328
+ return;
329
+ }
330
+ const seed = await this.host.buildForkSeed(events, boundary);
331
+ if (seed === undefined) {
332
+ this.logger.warn(`fork seed unavailable (old host), fallback to dispose: key=${key}`);
333
+ this.sessions.delete(key);
334
+ record.agent.cancel({ kind: 'user' });
335
+ await record.handle.dispose().catch(() => { });
336
+ return;
337
+ }
338
+ const childId = SessionId(mintSessionId());
339
+ const effectiveRoute = options.route ?? this.modelResolver.getEffectiveRoute(key);
340
+ const composed = await this.composePreset(this.getEffectivePresetByKey(key));
341
+ const created = await this.agents.create({
342
+ sessionId: childId,
343
+ seed,
344
+ inheritedEventCount: boundary + 1,
345
+ meta: {
346
+ cwd: this.workspaceDir(),
347
+ isSeeded: true,
348
+ // 旧版宿主的 delivery 豁免要求 parentSession,新版忽略——都传
349
+ parentSession: record.sessionId,
350
+ ...(composed.agentPreset ? { agentPreset: composed.agentPreset } : {}),
351
+ },
352
+ ...(effectiveRoute ? { agentOptions: effectiveRoute } : {}),
353
+ ...(composed.setup ? { setup: composed.setup } : {}),
354
+ });
355
+ this.modelResolver.setSessionId(key, childId);
356
+ const oldHandle = record.handle;
357
+ record.sessionId = childId;
358
+ record.agent = created.agent;
359
+ record.handle = created;
360
+ record.agentPreset = composed.agentPreset;
361
+ record.lastActivity = Date.now();
362
+ void oldHandle.dispose().catch(() => { });
363
+ this.logger.info(`session rebuilt via fork: key=${key} preset=${composed.agentPreset ?? 'none'} sessionId=${childId}`);
364
+ }
365
+ clearModelOverride(scope, peerId) {
366
+ const key = this.sessionKey(scope, peerId);
367
+ this.modelResolver.clearOverride(key);
368
+ this.modelResolver.clearSessionId(key);
369
+ }
370
+ async listAvailableModels() {
371
+ return this.modelResolver.listModels();
372
+ }
373
+ listProviders() {
374
+ return this.modelResolver.listProviders();
375
+ }
376
+ // ── 会话状态 / 统计 ──
377
+ getSessionRecord(scope, peerId) {
378
+ return this.sessions.get(this.sessionKey(scope, peerId));
379
+ }
380
+ getStatus(scope, peerId) {
381
+ const record = this.getSessionRecord(scope, peerId);
382
+ const route = this.getEffectiveModel(scope, peerId);
383
+ return {
384
+ active: !!record,
385
+ sessionId: record?.sessionId,
386
+ provider: route?.provider,
387
+ model: route?.model,
388
+ preset: record?.agentPreset,
389
+ lastActivity: record?.lastActivity,
390
+ messageCount: this.countMessages(record),
391
+ };
392
+ }
393
+ getTokenUsage(scope, peerId) {
394
+ const record = this.getSessionRecord(scope, peerId);
395
+ const stats = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
396
+ if (!record)
397
+ return stats;
398
+ const events = this.host.sessionEvents(record.agent.session);
399
+ if (!events)
400
+ return stats;
401
+ for (const event of events) {
402
+ if (event.type !== 'assistant/message' || !event.usage)
403
+ continue;
404
+ stats.input += event.usage.input ?? 0;
405
+ stats.output += event.usage.output ?? 0;
406
+ stats.cacheRead += event.usage.cacheRead ?? 0;
407
+ stats.cacheWrite += event.usage.cacheWrite ?? 0;
408
+ }
409
+ return stats;
410
+ }
411
+ exportMarkdown(scope, peerId) {
412
+ const record = this.getSessionRecord(scope, peerId);
413
+ if (!record)
414
+ return '';
415
+ const events = this.host.sessionEvents(record.agent.session);
416
+ if (!events || events.length === 0)
417
+ return '';
418
+ const lines = [`# QQ 会话导出\n`, `> session: ${record.sessionId}\n`];
419
+ for (const event of events) {
420
+ if (event.type === 'user/message') {
421
+ const text = extractMessageText(event.message);
422
+ if (text)
423
+ lines.push(`## 用户\n\n${text}\n`);
424
+ }
425
+ else if (event.type === 'assistant/message') {
426
+ const text = extractMessageText(event.message);
427
+ if (text)
428
+ lines.push(`## 助手\n\n${text}\n`);
429
+ }
430
+ }
431
+ return lines.join('\n');
432
+ }
433
+ countMessages(record) {
434
+ if (!record)
435
+ return 0;
436
+ const events = this.host.sessionEvents(record.agent.session);
437
+ if (!events)
438
+ return 0;
439
+ let count = 0;
440
+ for (const event of events) {
441
+ if (event.type === 'user/message' || event.type === 'assistant/message') {
442
+ count += 1;
443
+ }
444
+ }
445
+ return count;
446
+ }
447
+ // ── Session 生命周期管理 ──
448
+ sessionKey(scope, peerId) {
449
+ return `qqbot:${this.config.appId}:${scope}:${peerId}`;
450
+ }
451
+ /** prefs 命中沿用;共用 session 时永远指向那一条,miss 才回落到 0.5.x 派生候选 */
452
+ currentSessionId(sessionKey) {
453
+ if (this.sharedSessionId !== null)
454
+ return this.sharedSessionId;
455
+ return this.modelResolver.getSessionId(sessionKey) ?? legacyDerivedSessionId(sessionKey);
456
+ }
457
+ /** 候选命中后落盘,后续永远走 prefs(共用 session 时不写,免得多一份映射) */
458
+ persistSessionId(sessionKey, sessionId) {
459
+ if (this.sharedSessionId !== null)
460
+ return;
461
+ if (this.modelResolver.getSessionId(sessionKey) !== sessionId) {
462
+ this.modelResolver.setSessionId(sessionKey, sessionId);
463
+ }
464
+ }
465
+ /** 记下「这条会话最后是哪个 peer 在说话」,出站按它找回回复目标。 */
466
+ markActive(record) {
467
+ if (record?.sessionId !== undefined)
468
+ this.activeBySession.set(record.sessionId, record.sessionKey);
469
+ }
470
+ async composePreset(presetId) {
471
+ const presets = this.getPresetsService();
472
+ if (!presets)
473
+ return {};
474
+ try {
475
+ const resolved = await presets.resolve(presetId);
476
+ const resolvedId = resolved.id;
477
+ return {
478
+ agentPreset: resolvedId,
479
+ setup: async (agentCtx) => {
480
+ await presets.mount(agentCtx, resolvedId);
481
+ },
482
+ };
483
+ }
484
+ catch (err) {
485
+ this.logger.warn(`im-qqbot: preset ${presetId ?? '(default)'} unavailable: ${err instanceof Error ? err.message : String(err)} — using host composition`);
486
+ return {};
487
+ }
488
+ }
489
+ /** 获取或恢复或创建会话(get → resume → create);同 key 并发合并为一次 */
490
+ async getOrCreate(scope, peerId, senderId, replyTarget) {
491
+ const key = this.sessionKey(scope, peerId);
492
+ const existing = this.sessions.get(key);
493
+ if (existing) {
494
+ existing.replyTarget = replyTarget;
495
+ existing.lastActivity = Date.now();
496
+ this.markActive(existing);
497
+ return existing;
498
+ }
499
+ // singleflight:同 key 并发复用同一次 resume/create,后到者只更新回复目标
500
+ const pending = this.inflight.get(key);
501
+ if (pending) {
502
+ const shared = await pending;
503
+ shared.replyTarget = replyTarget;
504
+ shared.lastActivity = Date.now();
505
+ this.markActive(shared);
506
+ return shared;
507
+ }
508
+ const task = this.openSession(key, scope, peerId, senderId, replyTarget);
509
+ this.inflight.set(key, task);
510
+ try {
511
+ const record = await task;
512
+ this.markActive(record);
513
+ return record;
514
+ }
515
+ finally {
516
+ this.inflight.delete(key);
517
+ }
518
+ }
519
+ /** getOrCreate 的实际打开流程(已通过 singleflight 保证同 key 串行) */
520
+ async openSession(key, scope, peerId, senderId, replyTarget) {
521
+ const route = this.modelResolver.getEffectiveRoute(key);
522
+ // prefs 命中 = 已知存量会话;miss 时取 0.5.x 派生 id 仅作存量探测候选,不用于新建
523
+ const candidateIsLegacy = this.modelResolver.getSessionId(key) === undefined;
524
+ let sessionId = SessionId(this.currentSessionId(key));
525
+ this.logger.info(`getOrCreate: key=${key} route=${route ? `${route.provider}/${route.model}` : 'host-default'} sessionId=${sessionId}`);
526
+ let agent;
527
+ let handle;
528
+ let agentPreset;
529
+ const live = this.agents.get(sessionId);
530
+ if (live) {
531
+ agent = live;
532
+ this.persistSessionId(key, sessionId);
533
+ this.logger.info(`reusing live agent: key=${key}`);
534
+ }
535
+ else {
536
+ // preset 只解析一次:resume/create 共用同一组合,避免重复 resolve/mount 目录。
537
+ // 优先 session 当初的 preset(started 锁定语义),无则用当前 effective preset。
538
+ const persistedPreset = await this.resolvePersistedPreset(sessionId);
539
+ let presetId = persistedPreset ?? this.getEffectivePresetByKey(key);
540
+ let composed = await this.composePreset(presetId);
541
+ // session 记着的 preset 已经不在了(比如提供它的插件被卸载):回落到当前
542
+ // 配置的 preset,否则这一轮会带着空 preset 恢复——没有工具集也没有 prompt。
543
+ if (presetId !== undefined && composed.agentPreset === undefined) {
544
+ const fallbackId = this.getEffectivePresetByKey(key);
545
+ if (fallbackId !== undefined && fallbackId !== presetId) {
546
+ this.logger.warn(`im-qqbot: session preset ${presetId} 不可用,回落到 ${fallbackId}`);
547
+ presetId = fallbackId;
548
+ composed = await this.composePreset(fallbackId);
549
+ }
550
+ }
551
+ agentPreset = composed.agentPreset;
552
+ try {
553
+ const resumeRoute = this.modelResolver.getResumeRoute(key);
554
+ const resumed = await this.agents.resume({
555
+ resumeSessionId: sessionId,
556
+ ...(resumeRoute ? { agentOptions: resumeRoute } : {}),
557
+ ...(composed.setup ? { setup: composed.setup } : {}),
558
+ });
559
+ agent = resumed.agent;
560
+ handle = resumed;
561
+ // 0.5.x 迁移:候选命中老会话,沿用并落盘
562
+ this.persistSessionId(key, sessionId);
563
+ this.logger.info(`resumed session: key=${key} preset=${agentPreset ?? 'none'} route=${resumeRoute ? `${resumeRoute.provider}/${resumeRoute.model}` : 'session-own'}`);
564
+ }
565
+ catch (err) {
566
+ if (!(await this.mayCreateAfterResumeFailure(key, sessionId, err)))
567
+ throw err;
568
+ // 共用 session 时固定用自己那条 id,不铸造新 id,否则各 peer 会分叉。
569
+ sessionId = this.sharedSessionId !== null
570
+ ? SessionId(this.sharedSessionId)
571
+ : this.resolveCreateId(key, sessionId, candidateIsLegacy);
572
+ const created = await this.agents.create({
573
+ sessionId,
574
+ meta: {
575
+ cwd: this.workspaceDir(),
576
+ ...(agentPreset ? { agentPreset } : {}),
577
+ },
578
+ ...(route ? { agentOptions: route } : {}),
579
+ ...(composed.setup ? { setup: composed.setup } : {}),
580
+ });
581
+ agent = created.agent;
582
+ handle = created;
583
+ this.persistSessionId(key, sessionId);
584
+ this.logger.info(`created new session: key=${key} sessionId=${sessionId} preset=${agentPreset ?? 'none'}`);
585
+ }
586
+ }
587
+ const record = {
588
+ sessionKey: key,
589
+ sessionId,
590
+ agent,
591
+ handle: handle ?? { agent, dispose: async () => { } },
592
+ replyTarget,
593
+ scope,
594
+ peerId,
595
+ senderId,
596
+ lastActivity: Date.now(),
597
+ agentPreset,
598
+ };
599
+ this.sessions.set(key, record);
600
+ // 挂工作区 + 起默认标题(失败不影响收发)。
601
+ void this.attachWorkspace(sessionId, agent).catch((error) => {
602
+ this.logger.warn(`im-qqbot: 挂工作区失败 ${error instanceof Error ? error.message : String(error)}`);
603
+ });
604
+ return record;
605
+ }
606
+ /**
607
+ * resume 失败后是否允许首次创建。
608
+ *
609
+ * 只有「会话确实不在盘上」才可创建:损坏/占用/后端故障沿用同一 id 重建,会把
610
+ * 同一 sessionId 写进多个 project 目录,宿主 `list()` 随后报 duplicate,会话
611
+ * 列表整体打不开(对齐宿主 `restoreOrCreateConfigured` 的 fail-loud 语义)。
612
+ *
613
+ * @returns 允许创建返回 true;拒绝时已记录 warn,调用方应抛出原 resume 错误。
614
+ */
615
+ async mayCreateAfterResumeFailure(key, sessionId, resumeError) {
616
+ const context = `key=${key} sessionId=${sessionId} resumeErr=${errorText(resumeError)}`;
617
+ let exists;
618
+ try {
619
+ exists = await this.host.sessionExists(sessionId);
620
+ }
621
+ catch (probeError) {
622
+ // 求证本身失败(持久化后端故障):无法断言不在盘上,按存在处理
623
+ this.logger.warn(`refusing to recreate session, existence unknown: ${context} probeErr=${errorText(probeError)}`);
624
+ return false;
625
+ }
626
+ if (exists === true) {
627
+ this.logger.warn(`refusing to recreate existing session: ${context}`);
628
+ return false;
629
+ }
630
+ if (exists === undefined) {
631
+ // 宿主无 sessionPersistence.stat:没有求证手段,只能按 resume 结果创建(= 修复前行为)
632
+ this.logger.warn(`creating session without existence check (host lacks sessionPersistence.stat): ${context}`);
633
+ }
634
+ return true;
635
+ }
636
+ /**
637
+ * 确认候选会话缺失后决定用哪个 id 新建。
638
+ *
639
+ * - resume 等待期间 prefs 被并发改写(换新会话):采用 prefs 的最新 id,
640
+ * 否则内存与 prefs 指向不同会话,重启后用户被切走;
641
+ * - 候选来自 0.5.x 确定性派生:一律铸造新 id,确定性 id 不进入新建路径;
642
+ * - 候选来自 prefs 且确认缺失:沿用该 id 新建,prefs 无需改写。
643
+ */
644
+ resolveCreateId(key, candidate, candidateIsLegacy) {
645
+ const latest = this.modelResolver.getSessionId(key);
646
+ if (latest !== undefined && latest !== candidate) {
647
+ this.logger.info(`adopting concurrently written session id: key=${key} sessionId=${latest}`);
648
+ return SessionId(latest);
649
+ }
650
+ if (candidateIsLegacy) {
651
+ const minted = SessionId(mintSessionId());
652
+ this.logger.info(`migrated to minted session id: key=${key} sessionId=${minted}`);
653
+ return minted;
654
+ }
655
+ return candidate;
656
+ }
657
+ findBySessionId(sessionId) {
658
+ // 共用 session 时多个 peer 指向同一条会话:先按「最后说话的那个」找。
659
+ const activeKey = this.activeBySession.get(sessionId);
660
+ if (activeKey !== undefined) {
661
+ const active = this.sessions.get(activeKey);
662
+ if (active !== undefined && active.sessionId === sessionId)
663
+ return active;
664
+ }
665
+ for (const record of this.sessions.values()) {
666
+ if (record.sessionId === sessionId)
667
+ return record;
668
+ }
669
+ return undefined;
670
+ }
671
+ findByAgent(agent) {
672
+ const sessionId = agent?.session?.id;
673
+ if (typeof sessionId === 'string') {
674
+ const record = this.findBySessionId(sessionId);
675
+ if (record !== undefined) {
676
+ if (record.agent === agent)
677
+ return record;
678
+ // 同一条会话被另一个入口复活(比如控制台打开了同一条 id)时,
679
+ // 身份对不上,但门还是那一扇:用现有记录,并把 agent 指到活着的这个。
680
+ record.agent = agent;
681
+ return record;
682
+ }
683
+ }
684
+ for (const record of this.sessions.values()) {
685
+ if (record.agent === agent)
686
+ return record;
687
+ }
688
+ // 兜底:回合可能是别的插件(dsh-day 的心跳)把这条会话唤醒后直接跑起来的,
689
+ // 这时 agent 对象不是 qqbot 手里那个,session.id 也可能读不到。
690
+ // 只配了一个 peer(当前就是私聊一条)时,sessions 里只有一条记录,就认它。
691
+ if (this.sessions.size === 1) {
692
+ const only = this.sessions.values().next().value
693
+ if (only !== undefined) {
694
+ only.agent = agent ?? only.agent
695
+ this.logger.warn('qq_draft: 会话不在本通道表里,按唯一记录兜底(外部插件唤醒的回合)')
696
+ return only
697
+ }
698
+ }
699
+ return undefined;
700
+ }
701
+ async remove(scope, peerId) {
702
+ const key = this.sessionKey(scope, peerId);
703
+ // 共享会话模式下所有 peer 都固定指向同一条 id:只换 key 的映射不会生效,
704
+ // 必须换一个新的共享 id,并放下所有活着的 agent,下一条消息才会建一条干净会话。
705
+ // 旧会话本身留在盘上(历史不删),侧栏里仍能看到。
706
+ if (this.sharedSessionId !== null) {
707
+ const next = mintSessionId();
708
+ writeSharedSession(next, this.logger);
709
+ this.sharedSessionId = next;
710
+ this.activeBySession.clear();
711
+ const records = [...this.sessions.values()];
712
+ this.sessions.clear();
713
+ this.inflight.clear();
714
+ const handles = new Set(records.map((record) => record.handle));
715
+ for (const record of records) {
716
+ record.agent.cancel({ kind: 'user' });
717
+ }
718
+ await Promise.allSettled([...handles].map((handle) => handle.dispose().catch(() => { })));
719
+ this.logger.info(`shared session rotated: ${key} → ${next}`);
720
+ return;
721
+ }
722
+ const record = this.sessions.get(key);
723
+ this.modelResolver.setSessionId(key, mintSessionId());
724
+ if (!record)
725
+ return;
726
+ this.sessions.delete(key);
727
+ record.agent.cancel({ kind: 'user' });
728
+ await record.handle.dispose().catch(() => { });
729
+ this.logger.info(`session removed: key=${key}`);
730
+ }
731
+ /** Agent 工作目录:显式配置优先,缺省独立目录 ~/.dsh/dsh-qqbot-plus/workspace(不随宿主进程 cwd) */
732
+ workspaceCache;
733
+ workspaceDir() {
734
+ if (this.workspaceCache)
735
+ return this.workspaceCache;
736
+ const dir = resolveAgentCwd(this.config.cwd);
737
+ mkdirSync(dir, { recursive: true });
738
+ this.workspaceCache = dir;
739
+ return dir;
740
+ }
741
+ /** 运行时状态:记录上次停机时间与最后一条未回完的消息,供重启说明/接话使用。 */
742
+ runtimeFile() {
743
+ return join(PLUGIN_HOME, 'runtime.json');
744
+ }
745
+ readRuntime() {
746
+ try {
747
+ return JSON.parse(readFileSync(this.runtimeFile(), 'utf8'));
748
+ }
749
+ catch {
750
+ return {};
751
+ }
752
+ }
753
+ writeRuntime(patch) {
754
+ try {
755
+ mkdirSync(PLUGIN_HOME, { recursive: true });
756
+ writeFileSync(this.runtimeFile(), JSON.stringify({ ...this.readRuntime(), ...patch }, null, 2), 'utf8');
757
+ }
758
+ catch {
759
+ // 状态文件写不了不影响收发
760
+ }
761
+ }
762
+ /** 网关启动时调用一次:算出停机间隔,取出最后一条未回完的消息与上次的发送目标。 */
763
+ beginBoot() {
764
+ const state = this.readRuntime();
765
+ const stoppedAt = Number(state.stoppedAt) || 0;
766
+ this.bootGapMs = stoppedAt > 0 ? Math.max(0, Date.now() - stoppedAt) : 0;
767
+ this.lastInbound = state.lastInbound ?? null;
768
+ this.lastTarget = state.lastTarget ?? this.lastInbound?.replyTarget ?? null;
769
+ this.writeRuntime({ startedAt: Date.now(), stoppedAt: null });
770
+ // 开机就上锁,不等第一条消息把会话拉起来。registry 还没就绪时留空,
771
+ // 后面 attachWorkspace 打开会话时还会再装一次。
772
+ this.protectWorkspace();
773
+ }
774
+ /** 重启后给模型一个内部事件:自己检查上一轮有没有没做完/没回的事,不往 QQ 发任何东西。 */
775
+ async resumeInterrupted(logger) {
776
+ if (this.bootGapMs < 5000)
777
+ return;
778
+ const info = this.lastInbound;
779
+ const target = this.lastTarget;
780
+ const scope = info?.scope ?? target?.scope;
781
+ const peerId = info?.peerId ?? target?.targetId;
782
+ if (!scope || !peerId)
783
+ return;
784
+ const age = Date.now() - Date.parse(info?.at ?? '');
785
+ const hasRecent = Boolean(info) && age >= 0 && age <= 12 * 3600 * 1000;
786
+ try {
787
+ const record = await this.getOrCreate(scope, peerId, info?.senderId ?? peerId, info?.replyTarget ?? target);
788
+ if (!record.agent || record.agent.status !== 'idle')
789
+ return;
790
+ const lines = [
791
+ '(宿主刚重启过。先自己检查上一轮:有没有没做完的事、有没有对方最后一条还没回?',
792
+ ];
793
+ if (hasRecent && info?.text)
794
+ lines.push('对方最后说的是:' + String(info.text).slice(0, 300));
795
+ lines.push('有就继续做完、需要说话就用 qq_draft + qq_confirm 发出去;没有就 qq_skip。别主动提重启这件事。)');
796
+ record.agent.followup(createUserMessage({ content: [{ type: 'text', text: lines.join('\n') }], source: { kind: 'user' } }));
797
+ logger.info(`im-qqbot: 已给模型投递重启自检事件 ${scope}:${peerId}`);
798
+ }
799
+ catch (error) {
800
+ logger.warn(`im-qqbot: 重启自检事件投递失败 ${String(error)}`);
801
+ }
802
+ }
803
+ noteInbound(info) {
804
+ this.lastInbound = info;
805
+ this.writeRuntime({ lastInbound: info, lastTarget: info.replyTarget });
806
+ }
807
+ clearInbound() {
808
+ if (!this.lastInbound)
809
+ return;
810
+ this.lastInbound = null;
811
+ this.writeRuntime({ lastInbound: null });
812
+ }
813
+ markStopped() {
814
+ this.writeRuntime({ stoppedAt: Date.now() });
815
+ }
816
+ /** 取一个可用的 workspaceRegistry(list() 不抛才说明真的就绪)。 */
817
+ workspaceRegistry() {
818
+ let registry;
819
+ try {
820
+ registry = this.ctx.get('workspaceRegistry');
821
+ }
822
+ catch {
823
+ return undefined;
824
+ }
825
+ if (!registry || typeof registry.list !== 'function' || typeof registry.create !== 'function')
826
+ return undefined;
827
+ try {
828
+ registry.list();
829
+ }
830
+ catch {
831
+ return undefined;
832
+ }
833
+ return registry;
834
+ }
835
+ /** 把会话挂到机器人自己的工作区,并顺手起标题、上锁。 */
836
+ async attachWorkspace(sessionId, agent) {
837
+ const registry = this.workspaceRegistry();
838
+ if (!registry)
839
+ return;
840
+ const cwd = this.workspaceDir();
841
+ let workspace = null;
842
+ try {
843
+ workspace = (await registry.resolveByPath?.(cwd)) ?? null;
844
+ }
845
+ catch {
846
+ return;
847
+ }
848
+ if (!workspace) {
849
+ try {
850
+ workspace = await registry.create(cwd, 'QQ机器人');
851
+ }
852
+ catch {
853
+ // 标题被占用时退一步,工作区本身还是要建出来。
854
+ try {
855
+ workspace = await registry.create(cwd, 'QQ机器人(机器人)');
856
+ }
857
+ catch {
858
+ return;
859
+ }
860
+ }
861
+ }
862
+ if (typeof workspace?.attachSession === 'function') {
863
+ const members = Array.isArray(workspace.sessionIds) ? workspace.sessionIds : [];
864
+ if (!members.includes(sessionId))
865
+ await workspace.attachSession(sessionId);
866
+ }
867
+ this.protectWorkspace(registry);
868
+ this.nameSession(sessionId, agent);
869
+ }
870
+ /** 给会话一个默认标题(已经有标题就保持不动)。 */
871
+ nameSession(sessionId, agent) {
872
+ const session = agent?.session;
873
+ if (!session || session.id !== sessionId)
874
+ return;
875
+ let service;
876
+ try {
877
+ service = this.ctx.get('sessionTitle');
878
+ }
879
+ catch {
880
+ return;
881
+ }
882
+ if (typeof service?.rename !== 'function' || typeof service.get !== 'function')
883
+ return;
884
+ try {
885
+ const current = service.get(session)?.title;
886
+ if (typeof current === 'string' && current !== '')
887
+ return;
888
+ service.rename(session, 'QQ机器人');
889
+ }
890
+ catch {
891
+ // 会话正好在追加事件时会被短暂拒绝,下一次挂载再试即可。
892
+ }
893
+ }
894
+ /** 这个 workspaceId 是不是机器人自己的工作区。 */
895
+ isOwnWorkspace(workspaceId, registry = this.workspaceRegistry()) {
896
+ if (typeof workspaceId !== 'string' || workspaceId === '' || !registry)
897
+ return false;
898
+ try {
899
+ const workspace = registry.get?.(workspaceId);
900
+ if (!workspace || typeof workspace.path !== 'string')
901
+ return false;
902
+ return resolve(workspace.path) === resolve(this.workspaceDir());
903
+ }
904
+ catch {
905
+ return false;
906
+ }
907
+ }
908
+ /** 这个 sessionId 是不是机器人自己的会话。 */
909
+ isOwnSession(sessionId, registry = this.workspaceRegistry()) {
910
+ if (typeof sessionId !== 'string' || sessionId === '')
911
+ return false;
912
+ for (const record of this.sessions.values()) {
913
+ if (record.sessionId === sessionId)
914
+ return true;
915
+ }
916
+ if (!registry)
917
+ return false;
918
+ try {
919
+ for (const workspace of registry.list()) {
920
+ if (typeof workspace?.path !== 'string')
921
+ continue;
922
+ if (resolve(workspace.path) !== resolve(this.workspaceDir()))
923
+ continue;
924
+ if (Array.isArray(workspace.sessionIds) && workspace.sessionIds.includes(sessionId))
925
+ return true;
926
+ }
927
+ }
928
+ catch {
929
+ return false;
930
+ }
931
+ return false;
932
+ }
933
+ /** 工作区与会话上锁:别的 UI 删除/归档会被拒绝。 */
934
+ protectWorkspace(registry = this.workspaceRegistry()) {
935
+ if (!registry || typeof registry.delete !== 'function')
936
+ return;
937
+ if (this.workspaceProtection?.registry === registry)
938
+ return;
939
+ if (this.workspaceProtection) {
940
+ try {
941
+ this.workspaceProtection.dispose();
942
+ }
943
+ catch { /* ignore */ }
944
+ }
945
+ const manager = this;
946
+ const originalDelete = registry.delete;
947
+ const originalArchive = registry.archiveSession;
948
+ const deleteGuard = async function (workspaceId) {
949
+ if (manager.isOwnWorkspace(workspaceId, registry)) {
950
+ const error = new Error('im-qqbot: QQ 工作区由插件管理,不能删除');
951
+ error.code = 'im-qqbot/protected-workspace';
952
+ throw error;
953
+ }
954
+ return originalDelete.apply(this, arguments);
955
+ };
956
+ const archiveGuard = typeof originalArchive === 'function'
957
+ ? async function (sessionId) {
958
+ if (manager.isOwnSession(sessionId, registry)) {
959
+ const error = new Error('im-qqbot: QQ 会话由插件管理,不能归档');
960
+ error.code = 'im-qqbot/protected-session';
961
+ throw error;
962
+ }
963
+ return originalArchive.apply(this, arguments);
964
+ }
965
+ : originalArchive;
966
+ const dispose = () => {
967
+ try {
968
+ if (registry.delete === deleteGuard)
969
+ registry.delete = originalDelete;
970
+ }
971
+ catch { /* ignore */ }
972
+ try {
973
+ if (registry.archiveSession === archiveGuard)
974
+ registry.archiveSession = originalArchive;
975
+ }
976
+ catch { /* ignore */ }
977
+ if (this.workspaceProtection?.dispose === dispose)
978
+ this.workspaceProtection = null;
979
+ };
980
+ try {
981
+ registry.delete = deleteGuard;
982
+ if (typeof originalArchive === 'function')
983
+ registry.archiveSession = archiveGuard;
984
+ this.workspaceProtection = { registry, dispose };
985
+ this.logger.info('im-qqbot: QQ 工作区与会话已上锁(不能删除/归档)');
986
+ }
987
+ catch (error) {
988
+ this.logger.warn(`im-qqbot: 工作区上锁失败 ${String(error)}`);
989
+ }
990
+ }
991
+ /**
992
+ * 原地压缩当前会话历史(保留 sessionId,用摘要替换旧历史)。
993
+ *
994
+ * compaction 是 preset 作用域服务,经 host adapter 从会话 preset 解析,
995
+ * 全局注册的部署再兜底。这是「压缩上下文」的语义,区别于 remove() 的「换新会话」。
996
+ */
997
+ async compact(scope, peerId, revive) {
998
+ const key = this.sessionKey(scope, peerId);
999
+ let record = this.sessions.get(key);
1000
+ if (!record) {
1001
+ // 无活跃会话(重启/闲置回收)时从磁盘拉起,历史在磁盘上仍可压缩
1002
+ if (!revive)
1003
+ return { ok: false, reason: 'no-session' };
1004
+ record = await this.getOrCreate(scope, peerId, revive.senderId, revive.replyTarget);
1005
+ }
1006
+ if (record.agent.status !== 'idle')
1007
+ return { ok: false, reason: 'busy' };
1008
+ const compaction = (await this.host.serviceFor(record.agent, 'compaction')
1009
+ ?? this.host.globalService('compaction'));
1010
+ if (!compaction)
1011
+ return { ok: false, reason: 'unavailable' };
1012
+ const route = this.modelResolver.getEffectiveRoute(key);
1013
+ const agentCtx = {
1014
+ session: record.agent.session,
1015
+ options: { provider: route?.provider, model: route?.model },
1016
+ runMaintenance: record.agent.runMaintenance.bind(record.agent),
1017
+ };
1018
+ try {
1019
+ const result = await compaction.compactNow(agentCtx, new AbortController().signal);
1020
+ if (result === null)
1021
+ return { ok: true, shadowed: 0, tokens: 0 };
1022
+ return { ok: true, shadowed: result.shadowedSeqs.length, tokens: result.shadowedTokenCount };
1023
+ }
1024
+ catch (err) {
1025
+ const code = err?.code;
1026
+ // summary = 摘要没有更小 = 历史不足以压缩,属正常结果而非失败
1027
+ if (code === 'summary') {
1028
+ return { ok: true, shadowed: 0, tokens: 0 };
1029
+ }
1030
+ // 其他 ManualCompactionError 预期失败,给友好文案(debug 记录,不 warn 刷屏)
1031
+ if (code !== undefined && code in COMPACTION_ERROR_HINTS) {
1032
+ this.logger.debug(`compact declined: key=${key} code=${code}`);
1033
+ return { ok: false, reason: 'failed', message: COMPACTION_ERROR_HINTS[code] };
1034
+ }
1035
+ const message = err instanceof Error ? err.message : String(err);
1036
+ this.logger.warn(`compact failed: key=${key} err=${message}`);
1037
+ return { ok: false, reason: 'failed', message };
1038
+ }
1039
+ }
1040
+ async disposeAll() {
1041
+ this.markStopped();
1042
+ this.evictor?.dispose?.();
1043
+ this.workspaceProtection?.dispose?.();
1044
+ const records = [...this.sessions.values()];
1045
+ this.sessions.clear();
1046
+ for (const record of records) {
1047
+ record.agent.cancel({ kind: 'user' });
1048
+ }
1049
+ // 共享会话不随插件重载销毁:销毁会触发宿主 session/disposed → 桌面端收到
1050
+ // api-session/removed,把侧栏里这一行摘掉;持久化会话要等下次全量重连
1051
+ // 才会回来(表现为「会话突然看不到了」)。留在宿主里,下次重载直接复用。
1052
+ const keepAlive = this.sharedSessionId;
1053
+ const disposals = records
1054
+ .filter((record) => keepAlive === null || record.sessionId !== keepAlive)
1055
+ .map((record) => record.handle.dispose());
1056
+ await Promise.allSettled(disposals);
1057
+ this.memory?.dispose();
1058
+ this.logger.info(`all sessions disposed (count=${records.length}, kept=${records.length - disposals.length})`);
1059
+ }
1060
+ get size() {
1061
+ return this.sessions.size;
1062
+ }
1063
+ }
1064
+ /** 错误文案(日志用) */
1065
+ function errorText(err) {
1066
+ return err instanceof Error ? err.message : String(err);
1067
+ }
1068
+ /** 从消息对象中提取纯文本(用于导出/统计) */
1069
+ function extractMessageText(message) {
1070
+ const blocks = message?.content;
1071
+ if (!blocks || !Array.isArray(blocks))
1072
+ return '';
1073
+ const parts = [];
1074
+ for (const block of blocks) {
1075
+ if (block.type === 'text' && block.text) {
1076
+ parts.push(block.text);
1077
+ }
1078
+ }
1079
+ return parts.join('\n').trim();
1080
+ }
1081
+ //# sourceMappingURL=session-manager.js.map