@zhin.js/core 1.0.24 → 1.0.26

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 (211) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +84 -342
  3. package/lib/adapter.d.ts +45 -1
  4. package/lib/adapter.d.ts.map +1 -1
  5. package/lib/adapter.js +182 -1
  6. package/lib/adapter.js.map +1 -1
  7. package/lib/ai/agent.d.ts +126 -0
  8. package/lib/ai/agent.d.ts.map +1 -0
  9. package/lib/ai/agent.js +645 -0
  10. package/lib/ai/agent.js.map +1 -0
  11. package/lib/ai/context-manager.d.ts +213 -0
  12. package/lib/ai/context-manager.d.ts.map +1 -0
  13. package/lib/ai/context-manager.js +313 -0
  14. package/lib/ai/context-manager.js.map +1 -0
  15. package/lib/ai/conversation-memory.d.ts +181 -0
  16. package/lib/ai/conversation-memory.d.ts.map +1 -0
  17. package/lib/ai/conversation-memory.js +581 -0
  18. package/lib/ai/conversation-memory.js.map +1 -0
  19. package/lib/ai/follow-up.d.ts +131 -0
  20. package/lib/ai/follow-up.d.ts.map +1 -0
  21. package/lib/ai/follow-up.js +265 -0
  22. package/lib/ai/follow-up.js.map +1 -0
  23. package/lib/ai/index.d.ts +29 -0
  24. package/lib/ai/index.d.ts.map +1 -0
  25. package/lib/ai/index.js +34 -0
  26. package/lib/ai/index.js.map +1 -0
  27. package/lib/ai/init.d.ts +30 -0
  28. package/lib/ai/init.d.ts.map +1 -0
  29. package/lib/ai/init.js +424 -0
  30. package/lib/ai/init.js.map +1 -0
  31. package/lib/ai/output.d.ts +93 -0
  32. package/lib/ai/output.d.ts.map +1 -0
  33. package/lib/ai/output.js +176 -0
  34. package/lib/ai/output.js.map +1 -0
  35. package/lib/ai/providers/anthropic.d.ts +23 -0
  36. package/lib/ai/providers/anthropic.d.ts.map +1 -0
  37. package/lib/ai/providers/anthropic.js +322 -0
  38. package/lib/ai/providers/anthropic.js.map +1 -0
  39. package/lib/ai/providers/base.d.ts +43 -0
  40. package/lib/ai/providers/base.d.ts.map +1 -0
  41. package/lib/ai/providers/base.js +135 -0
  42. package/lib/ai/providers/base.js.map +1 -0
  43. package/lib/ai/providers/index.d.ts +12 -0
  44. package/lib/ai/providers/index.d.ts.map +1 -0
  45. package/lib/ai/providers/index.js +9 -0
  46. package/lib/ai/providers/index.js.map +1 -0
  47. package/lib/ai/providers/ollama.d.ts +25 -0
  48. package/lib/ai/providers/ollama.d.ts.map +1 -0
  49. package/lib/ai/providers/ollama.js +243 -0
  50. package/lib/ai/providers/ollama.js.map +1 -0
  51. package/lib/ai/providers/openai.d.ts +46 -0
  52. package/lib/ai/providers/openai.d.ts.map +1 -0
  53. package/lib/ai/providers/openai.js +132 -0
  54. package/lib/ai/providers/openai.js.map +1 -0
  55. package/lib/ai/rate-limiter.d.ts +38 -0
  56. package/lib/ai/rate-limiter.d.ts.map +1 -0
  57. package/lib/ai/rate-limiter.js +86 -0
  58. package/lib/ai/rate-limiter.js.map +1 -0
  59. package/lib/ai/service.d.ts +81 -0
  60. package/lib/ai/service.d.ts.map +1 -0
  61. package/lib/ai/service.js +274 -0
  62. package/lib/ai/service.js.map +1 -0
  63. package/lib/ai/session.d.ts +186 -0
  64. package/lib/ai/session.d.ts.map +1 -0
  65. package/lib/ai/session.js +443 -0
  66. package/lib/ai/session.js.map +1 -0
  67. package/lib/ai/tone-detector.d.ts +19 -0
  68. package/lib/ai/tone-detector.d.ts.map +1 -0
  69. package/lib/ai/tone-detector.js +72 -0
  70. package/lib/ai/tone-detector.js.map +1 -0
  71. package/lib/ai/tools.d.ts +45 -0
  72. package/lib/ai/tools.d.ts.map +1 -0
  73. package/lib/ai/tools.js +206 -0
  74. package/lib/ai/tools.js.map +1 -0
  75. package/lib/ai/types.d.ts +264 -0
  76. package/lib/ai/types.d.ts.map +1 -0
  77. package/lib/ai/types.js +6 -0
  78. package/lib/ai/types.js.map +1 -0
  79. package/lib/ai/user-profile.d.ts +56 -0
  80. package/lib/ai/user-profile.d.ts.map +1 -0
  81. package/lib/ai/user-profile.js +130 -0
  82. package/lib/ai/user-profile.js.map +1 -0
  83. package/lib/ai/zhin-agent.d.ts +165 -0
  84. package/lib/ai/zhin-agent.d.ts.map +1 -0
  85. package/lib/ai/zhin-agent.js +707 -0
  86. package/lib/ai/zhin-agent.js.map +1 -0
  87. package/lib/built/adapter-process.d.ts +4 -0
  88. package/lib/built/adapter-process.d.ts.map +1 -1
  89. package/lib/built/adapter-process.js +94 -0
  90. package/lib/built/adapter-process.js.map +1 -1
  91. package/lib/built/ai-trigger.d.ts +89 -0
  92. package/lib/built/ai-trigger.d.ts.map +1 -0
  93. package/lib/built/ai-trigger.js +166 -0
  94. package/lib/built/ai-trigger.js.map +1 -0
  95. package/lib/built/command.d.ts +33 -17
  96. package/lib/built/command.d.ts.map +1 -1
  97. package/lib/built/command.js +71 -44
  98. package/lib/built/command.js.map +1 -1
  99. package/lib/built/component.d.ts +42 -15
  100. package/lib/built/component.d.ts.map +1 -1
  101. package/lib/built/component.js +84 -52
  102. package/lib/built/component.js.map +1 -1
  103. package/lib/built/config.d.ts +54 -5
  104. package/lib/built/config.d.ts.map +1 -1
  105. package/lib/built/config.js +76 -10
  106. package/lib/built/config.js.map +1 -1
  107. package/lib/built/cron.d.ts +41 -18
  108. package/lib/built/cron.d.ts.map +1 -1
  109. package/lib/built/cron.js +106 -63
  110. package/lib/built/cron.js.map +1 -1
  111. package/lib/built/database.d.ts +55 -6
  112. package/lib/built/database.d.ts.map +1 -1
  113. package/lib/built/database.js +93 -22
  114. package/lib/built/database.js.map +1 -1
  115. package/lib/built/dispatcher.d.ts +118 -0
  116. package/lib/built/dispatcher.d.ts.map +1 -0
  117. package/lib/built/dispatcher.js +196 -0
  118. package/lib/built/dispatcher.js.map +1 -0
  119. package/lib/built/permission.d.ts +45 -5
  120. package/lib/built/permission.d.ts.map +1 -1
  121. package/lib/built/permission.js +56 -11
  122. package/lib/built/permission.js.map +1 -1
  123. package/lib/built/skill.d.ts +117 -0
  124. package/lib/built/skill.d.ts.map +1 -0
  125. package/lib/built/skill.js +191 -0
  126. package/lib/built/skill.js.map +1 -0
  127. package/lib/built/tool.d.ts +188 -0
  128. package/lib/built/tool.d.ts.map +1 -0
  129. package/lib/built/tool.js +749 -0
  130. package/lib/built/tool.js.map +1 -0
  131. package/lib/feature.d.ts +75 -0
  132. package/lib/feature.d.ts.map +1 -0
  133. package/lib/feature.js +69 -0
  134. package/lib/feature.js.map +1 -0
  135. package/lib/index.d.ts +6 -0
  136. package/lib/index.d.ts.map +1 -1
  137. package/lib/index.js +11 -0
  138. package/lib/index.js.map +1 -1
  139. package/lib/plugin.d.ts +53 -18
  140. package/lib/plugin.d.ts.map +1 -1
  141. package/lib/plugin.js +301 -31
  142. package/lib/plugin.js.map +1 -1
  143. package/lib/types.d.ts +248 -9
  144. package/lib/types.d.ts.map +1 -1
  145. package/lib/utils.d.ts.map +1 -1
  146. package/lib/utils.js +38 -12
  147. package/lib/utils.js.map +1 -1
  148. package/package.json +4 -4
  149. package/src/adapter.ts +206 -2
  150. package/src/ai/agent.ts +772 -0
  151. package/src/ai/context-manager.ts +440 -0
  152. package/src/ai/conversation-memory.ts +774 -0
  153. package/src/ai/follow-up.ts +357 -0
  154. package/src/ai/index.ts +128 -0
  155. package/src/ai/init.ts +502 -0
  156. package/src/ai/output.ts +261 -0
  157. package/src/ai/providers/anthropic.ts +375 -0
  158. package/src/ai/providers/base.ts +173 -0
  159. package/src/ai/providers/index.ts +13 -0
  160. package/src/ai/providers/ollama.ts +292 -0
  161. package/src/ai/providers/openai.ts +167 -0
  162. package/src/ai/rate-limiter.ts +129 -0
  163. package/src/ai/service.ts +319 -0
  164. package/src/ai/session.ts +544 -0
  165. package/src/ai/tone-detector.ts +89 -0
  166. package/src/ai/tools.ts +218 -0
  167. package/src/ai/types.ts +296 -0
  168. package/src/ai/user-profile.ts +181 -0
  169. package/src/ai/zhin-agent.ts +845 -0
  170. package/src/built/adapter-process.ts +99 -0
  171. package/src/built/ai-trigger.ts +259 -0
  172. package/src/built/command.ts +75 -69
  173. package/src/built/component.ts +94 -76
  174. package/src/built/config.ts +238 -128
  175. package/src/built/cron.ts +117 -101
  176. package/src/built/database.ts +128 -33
  177. package/src/built/dispatcher.ts +332 -0
  178. package/src/built/permission.ts +146 -54
  179. package/src/built/skill.ts +280 -0
  180. package/src/built/tool.ts +928 -0
  181. package/src/feature.ts +113 -0
  182. package/src/index.ts +11 -0
  183. package/src/plugin.ts +359 -69
  184. package/src/types.ts +306 -11
  185. package/src/utils.ts +37 -13
  186. package/tests/adapter.test.ts +153 -1
  187. package/tests/ai/agent.test.ts +614 -0
  188. package/tests/ai/ai-trigger.test.ts +368 -0
  189. package/tests/ai/context-manager.test.ts +413 -0
  190. package/tests/ai/conversation-memory.test.ts +128 -0
  191. package/tests/ai/follow-up.test.ts +175 -0
  192. package/tests/ai/integration.test.ts +584 -0
  193. package/tests/ai/output.test.ts +128 -0
  194. package/tests/ai/providers.integration.test.ts +227 -0
  195. package/tests/ai/rate-limiter.test.ts +108 -0
  196. package/tests/ai/session.test.ts +375 -0
  197. package/tests/ai/setup.ts +308 -0
  198. package/tests/ai/tone-detector.test.ts +80 -0
  199. package/tests/ai/tool.test.ts +800 -0
  200. package/tests/ai/tools-builtin.test.ts +346 -0
  201. package/tests/ai/user-profile.test.ts +73 -0
  202. package/tests/ai/zhin-agent.test.ts +177 -0
  203. package/tests/component-new.test.ts +17 -6
  204. package/tests/config.test.ts +46 -0
  205. package/tests/cron.test.ts +94 -5
  206. package/tests/dispatcher.test.ts +146 -0
  207. package/tests/feature.test.ts +145 -0
  208. package/tests/features-builtin.test.ts +191 -0
  209. package/tests/plugin.test.ts +88 -14
  210. package/tests/skill-feature.test.ts +179 -0
  211. package/tests/tool-feature.test.ts +254 -0
@@ -0,0 +1,131 @@
1
+ /**
2
+ * FollowUpStore — 定时跟进任务的持久化存储
3
+ *
4
+ * 解决纯 setTimeout 重启即丢失的问题:
5
+ * 1. 创建任务时同步写入数据库
6
+ * 2. 执行完成 / 过期后从数据库中删除
7
+ * 3. 机器人启动时从数据库加载所有未完成任务,重新挂定时器
8
+ * 4. 同一会话创建新任务时,自动取消旧的 pending 任务(防止重复提醒)
9
+ *
10
+ * ai_followups 表:
11
+ * ┌──────────────────────────────────────────────────────────────────┐
12
+ * │ id (PK) | session_id | platform | sender_id | scene_id │
13
+ * │ | message | fire_at | created_at | status │
14
+ * └──────────────────────────────────────────────────────────────────┘
15
+ */
16
+ export declare const AI_FOLLOWUP_MODEL: {
17
+ session_id: {
18
+ type: "text";
19
+ nullable: boolean;
20
+ };
21
+ platform: {
22
+ type: "text";
23
+ nullable: boolean;
24
+ };
25
+ bot_id: {
26
+ type: "text";
27
+ nullable: boolean;
28
+ };
29
+ sender_id: {
30
+ type: "text";
31
+ nullable: boolean;
32
+ };
33
+ scene_id: {
34
+ type: "text";
35
+ nullable: boolean;
36
+ };
37
+ scene_type: {
38
+ type: "text";
39
+ nullable: boolean;
40
+ };
41
+ message: {
42
+ type: "text";
43
+ nullable: boolean;
44
+ };
45
+ /** 触发时间戳 (ms) */
46
+ fire_at: {
47
+ type: "integer";
48
+ nullable: boolean;
49
+ };
50
+ created_at: {
51
+ type: "integer";
52
+ default: number;
53
+ };
54
+ /** pending | fired | cancelled */
55
+ status: {
56
+ type: "text";
57
+ default: string;
58
+ };
59
+ };
60
+ export interface FollowUpRecord {
61
+ id?: number;
62
+ session_id: string;
63
+ platform: string;
64
+ bot_id: string;
65
+ sender_id: string;
66
+ scene_id: string;
67
+ scene_type: string;
68
+ message: string;
69
+ fire_at: number;
70
+ created_at: number;
71
+ status: string;
72
+ }
73
+ /**
74
+ * 数据库模型接口(与 RelatedModel 的链式查询 API 对齐)
75
+ */
76
+ interface DbModel {
77
+ select(...fields: string[]): any;
78
+ create(data: Record<string, any>): Promise<any>;
79
+ update(data: Partial<any>): any;
80
+ delete(condition: Record<string, any>): any;
81
+ }
82
+ /**
83
+ * 发送提醒的回调函数
84
+ *
85
+ * 由 ZhinAgent 在 init 阶段注入,负责把提醒消息发到正确的会话。
86
+ */
87
+ export type FollowUpSender = (record: FollowUpRecord) => Promise<void>;
88
+ export declare class FollowUpManager {
89
+ private store;
90
+ /** 内存中活跃的定时器: recordId → timer */
91
+ private timers;
92
+ private sender;
93
+ constructor();
94
+ /** 注入消息发送回调 */
95
+ setSender(sender: FollowUpSender): void;
96
+ /** 升级到数据库存储 */
97
+ upgradeToDatabase(model: DbModel): void;
98
+ /**
99
+ * 创建一个跟进任务
100
+ *
101
+ * 重要:同一会话的旧 pending 任务会被自动取消,防止重复提醒。
102
+ *
103
+ * @returns 人类可读的确认文本
104
+ */
105
+ schedule(params: {
106
+ sessionId: string;
107
+ platform: string;
108
+ botId: string;
109
+ senderId: string;
110
+ sceneId: string;
111
+ sceneType: string;
112
+ message: string;
113
+ delayMinutes: number;
114
+ }): Promise<string>;
115
+ /**
116
+ * 取消指定会话的所有 pending 任务
117
+ */
118
+ cancelBySession(sessionId: string): Promise<number>;
119
+ /**
120
+ * 启动时从数据库恢复所有未完成的跟进任务
121
+ */
122
+ restore(): Promise<number>;
123
+ /**
124
+ * 为一条记录挂定时器
125
+ */
126
+ private scheduleTimer;
127
+ private scheduleTimerWithDelay;
128
+ dispose(): void;
129
+ }
130
+ export {};
131
+ //# sourceMappingURL=follow-up.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"follow-up.d.ts","sourceRoot":"","sources":["../../src/ai/follow-up.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ5B,iBAAiB;;;;;;;;;IAGjB,kCAAkC;;;;;CAEnC,CAAC;AAMF,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,OAAO;IACf,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAChC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAuFvE,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAiB;IAC9B,kCAAkC;IAClC,OAAO,CAAC,MAAM,CAAyD;IACvE,OAAO,CAAC,MAAM,CAA+B;;IAM7C,eAAe;IACf,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIvC,eAAe;IACf,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOvC;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4DnB;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBzD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,IAAI,IAAI;CAOhB"}
@@ -0,0 +1,265 @@
1
+ /**
2
+ * FollowUpStore — 定时跟进任务的持久化存储
3
+ *
4
+ * 解决纯 setTimeout 重启即丢失的问题:
5
+ * 1. 创建任务时同步写入数据库
6
+ * 2. 执行完成 / 过期后从数据库中删除
7
+ * 3. 机器人启动时从数据库加载所有未完成任务,重新挂定时器
8
+ * 4. 同一会话创建新任务时,自动取消旧的 pending 任务(防止重复提醒)
9
+ *
10
+ * ai_followups 表:
11
+ * ┌──────────────────────────────────────────────────────────────────┐
12
+ * │ id (PK) | session_id | platform | sender_id | scene_id │
13
+ * │ | message | fire_at | created_at | status │
14
+ * └──────────────────────────────────────────────────────────────────┘
15
+ */
16
+ import { Logger } from '@zhin.js/logger';
17
+ const logger = new Logger(null, 'FollowUp');
18
+ // ============================================================================
19
+ // 数据库模型
20
+ // ============================================================================
21
+ export const AI_FOLLOWUP_MODEL = {
22
+ session_id: { type: 'text', nullable: false },
23
+ platform: { type: 'text', nullable: false },
24
+ bot_id: { type: 'text', nullable: false },
25
+ sender_id: { type: 'text', nullable: false },
26
+ scene_id: { type: 'text', nullable: false },
27
+ scene_type: { type: 'text', nullable: false },
28
+ message: { type: 'text', nullable: false },
29
+ /** 触发时间戳 (ms) */
30
+ fire_at: { type: 'integer', nullable: false },
31
+ created_at: { type: 'integer', default: 0 },
32
+ /** pending | fired | cancelled */
33
+ status: { type: 'text', default: 'pending' },
34
+ };
35
+ // ============================================================================
36
+ // 内存实现
37
+ // ============================================================================
38
+ class MemoryFollowUpStore {
39
+ records = [];
40
+ nextId = 1;
41
+ async create(record) {
42
+ const full = { ...record, id: this.nextId++ };
43
+ this.records.push(full);
44
+ return full;
45
+ }
46
+ async markFired(id) {
47
+ const r = this.records.find(r => r.id === id);
48
+ if (r)
49
+ r.status = 'fired';
50
+ }
51
+ async cancel(id) {
52
+ const r = this.records.find(r => r.id === id);
53
+ if (r)
54
+ r.status = 'cancelled';
55
+ }
56
+ async getPending() {
57
+ return this.records.filter(r => r.status === 'pending');
58
+ }
59
+ async getPendingBySession(sessionId) {
60
+ return this.records.filter(r => r.status === 'pending' && r.session_id === sessionId);
61
+ }
62
+ dispose() {
63
+ this.records = [];
64
+ }
65
+ }
66
+ // ============================================================================
67
+ // 数据库实现
68
+ // ============================================================================
69
+ class DatabaseFollowUpStore {
70
+ model;
71
+ constructor(model) {
72
+ this.model = model;
73
+ }
74
+ async create(record) {
75
+ const created = await this.model.create(record);
76
+ return { ...record, id: created.id ?? created };
77
+ }
78
+ async markFired(id) {
79
+ await this.model.update({ status: 'fired' }).where({ id });
80
+ }
81
+ async cancel(id) {
82
+ await this.model.update({ status: 'cancelled' }).where({ id });
83
+ }
84
+ async getPending() {
85
+ return this.model.select().where({ status: 'pending' });
86
+ }
87
+ async getPendingBySession(sessionId) {
88
+ return this.model.select().where({ status: 'pending', session_id: sessionId });
89
+ }
90
+ dispose() { }
91
+ }
92
+ // ============================================================================
93
+ // FollowUpManager
94
+ // ============================================================================
95
+ export class FollowUpManager {
96
+ store;
97
+ /** 内存中活跃的定时器: recordId → timer */
98
+ timers = new Map();
99
+ sender = null;
100
+ constructor() {
101
+ this.store = new MemoryFollowUpStore();
102
+ }
103
+ /** 注入消息发送回调 */
104
+ setSender(sender) {
105
+ this.sender = sender;
106
+ }
107
+ /** 升级到数据库存储 */
108
+ upgradeToDatabase(model) {
109
+ const old = this.store;
110
+ this.store = new DatabaseFollowUpStore(model);
111
+ old.dispose();
112
+ logger.debug('FollowUpManager: 已升级到数据库存储');
113
+ }
114
+ /**
115
+ * 创建一个跟进任务
116
+ *
117
+ * 重要:同一会话的旧 pending 任务会被自动取消,防止重复提醒。
118
+ *
119
+ * @returns 人类可读的确认文本
120
+ */
121
+ async schedule(params) {
122
+ const { sessionId, platform, botId, senderId, sceneId, sceneType, message, delayMinutes } = params;
123
+ // ── 详细参数日志(方便排查问题) ──
124
+ logger.debug(`[跟进] 收到请求: delay_minutes=${delayMinutes}, message="${message}", session=${sessionId}`);
125
+ // 限制最大延迟 7 天
126
+ const maxDelay = 7 * 24 * 60;
127
+ const actualDelay = Math.min(Math.max(delayMinutes, 1), maxDelay);
128
+ const delayMs = actualDelay * 60 * 1000;
129
+ const fireAt = Date.now() + delayMs;
130
+ // ── 自动取消同一会话的旧 pending 任务 ──
131
+ const existingPending = await this.store.getPendingBySession(sessionId);
132
+ if (existingPending.length > 0) {
133
+ for (const old of existingPending) {
134
+ if (old.id != null) {
135
+ // 取消数据库记录
136
+ await this.store.cancel(old.id);
137
+ // 清除内存中的定时器
138
+ const timer = this.timers.get(old.id);
139
+ if (timer) {
140
+ clearTimeout(timer);
141
+ this.timers.delete(old.id);
142
+ }
143
+ logger.debug(`[跟进] 自动取消旧任务: id=${old.id}, "${old.message}"`);
144
+ }
145
+ }
146
+ }
147
+ const record = await this.store.create({
148
+ session_id: sessionId,
149
+ platform,
150
+ bot_id: botId,
151
+ sender_id: senderId,
152
+ scene_id: sceneId,
153
+ scene_type: sceneType,
154
+ message,
155
+ fire_at: fireAt,
156
+ created_at: Date.now(),
157
+ status: 'pending',
158
+ });
159
+ // 挂定时器
160
+ this.scheduleTimer(record);
161
+ const readableTime = actualDelay >= 1440
162
+ ? `${(actualDelay / 1440).toFixed(1)} 天后`
163
+ : actualDelay >= 60
164
+ ? `${(actualDelay / 60).toFixed(1)} 小时后`
165
+ : `${actualDelay} 分钟后`;
166
+ // 精确触发时间(方便日志对照)
167
+ const fireDate = new Date(fireAt);
168
+ const fireTimeStr = fireDate.toLocaleString('zh-CN', { hour12: false });
169
+ logger.debug(`[跟进] 已创建: id=${record.id}, delay=${actualDelay}分钟(${delayMs}ms), 触发时间=${fireTimeStr}, "${message}"`);
170
+ return `✅ 已安排提醒,将在 ${readableTime}(${fireTimeStr})提醒你:${message}`;
171
+ }
172
+ /**
173
+ * 取消指定会话的所有 pending 任务
174
+ */
175
+ async cancelBySession(sessionId) {
176
+ const pending = await this.store.getPendingBySession(sessionId);
177
+ let count = 0;
178
+ for (const record of pending) {
179
+ if (record.id != null) {
180
+ await this.store.cancel(record.id);
181
+ const timer = this.timers.get(record.id);
182
+ if (timer) {
183
+ clearTimeout(timer);
184
+ this.timers.delete(record.id);
185
+ }
186
+ count++;
187
+ }
188
+ }
189
+ if (count > 0) {
190
+ logger.debug(`[跟进] 已取消 ${count} 个待执行任务 (session=${sessionId})`);
191
+ }
192
+ return count;
193
+ }
194
+ /**
195
+ * 启动时从数据库恢复所有未完成的跟进任务
196
+ */
197
+ async restore() {
198
+ const pending = await this.store.getPending();
199
+ const now = Date.now();
200
+ let restored = 0;
201
+ for (const record of pending) {
202
+ if (record.fire_at <= now) {
203
+ // 已过期但未执行 → 立即触发(延迟 2 秒,等系统完全就绪)
204
+ const overdueSec = Math.round((now - record.fire_at) / 1000);
205
+ logger.debug(`[跟进恢复] id=${record.id} 已过期 ${overdueSec}s,立即触发`);
206
+ this.scheduleTimerWithDelay(record, 2000);
207
+ restored++;
208
+ }
209
+ else {
210
+ // 还没到时间 → 重新挂定时器
211
+ this.scheduleTimer(record);
212
+ const remainMs = record.fire_at - now;
213
+ const remainMin = (remainMs / 60_000).toFixed(1);
214
+ logger.debug(`[跟进恢复] id=${record.id} 剩余 ${remainMin} 分钟, "${record.message}"`);
215
+ restored++;
216
+ }
217
+ }
218
+ if (restored > 0) {
219
+ logger.info(`[跟进恢复] 共恢复 ${restored} 个待执行任务`);
220
+ }
221
+ return restored;
222
+ }
223
+ /**
224
+ * 为一条记录挂定时器
225
+ */
226
+ scheduleTimer(record) {
227
+ const delay = Math.max(record.fire_at - Date.now(), 0);
228
+ this.scheduleTimerWithDelay(record, delay);
229
+ }
230
+ scheduleTimerWithDelay(record, delayMs) {
231
+ if (!record.id)
232
+ return;
233
+ // 清除旧定时器(如果有)
234
+ const existing = this.timers.get(record.id);
235
+ if (existing)
236
+ clearTimeout(existing);
237
+ const timer = setTimeout(async () => {
238
+ try {
239
+ this.timers.delete(record.id);
240
+ // 发送提醒
241
+ if (this.sender) {
242
+ await this.sender(record);
243
+ logger.info(`[跟进提醒] 已发送: id=${record.id}, "${record.message}"`);
244
+ }
245
+ else {
246
+ logger.warn(`[跟进提醒] 无法发送 (sender 未注入): id=${record.id}`);
247
+ }
248
+ // 标记完成
249
+ await this.store.markFired(record.id);
250
+ }
251
+ catch (e) {
252
+ logger.warn(`[跟进提醒] 发送失败: id=${record.id}`, e);
253
+ }
254
+ }, delayMs);
255
+ this.timers.set(record.id, timer);
256
+ }
257
+ dispose() {
258
+ for (const timer of this.timers.values()) {
259
+ clearTimeout(timer);
260
+ }
261
+ this.timers.clear();
262
+ this.store.dispose();
263
+ }
264
+ }
265
+ //# sourceMappingURL=follow-up.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"follow-up.js","sourceRoot":"","sources":["../../src/ai/follow-up.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * @zhin.js/core — AI 模块
3
+ *
4
+ * 原 @zhin.js/ai 包已合并至此,所有 AI 能力内置在 core 中。
5
+ */
6
+ export type { AIConfig, AIProvider, ProviderConfig, ChatMessage, ChatCompletionRequest, ChatCompletionResponse, ChatCompletionChunk, ContentPart, ToolCall, MessageRole, AgentTool, AgentConfig, AgentResult, } from './types.js';
7
+ export { AIService } from './service.js';
8
+ export { Agent, createAgent } from './agent.js';
9
+ export { SessionManager, createMemorySessionManager, createDatabaseSessionManager, AI_SESSION_MODEL, } from './session.js';
10
+ export { createContextManager, CHAT_MESSAGE_MODEL, CONTEXT_SUMMARY_MODEL, } from './context-manager.js';
11
+ export type { ContextManager, ContextConfig, MessageRecord, } from './context-manager.js';
12
+ export { ZhinAgent } from './zhin-agent.js';
13
+ export type { ZhinAgentConfig, OnChunkCallback } from './zhin-agent.js';
14
+ export { ConversationMemory, AI_MESSAGE_MODEL, AI_SUMMARY_MODEL, } from './conversation-memory.js';
15
+ export type { ConversationMemoryConfig } from './conversation-memory.js';
16
+ export { UserProfileStore, AI_USER_PROFILE_MODEL, } from './user-profile.js';
17
+ export { RateLimiter } from './rate-limiter.js';
18
+ export type { RateLimitConfig, RateLimitResult } from './rate-limiter.js';
19
+ export { FollowUpManager, AI_FOLLOWUP_MODEL } from './follow-up.js';
20
+ export type { FollowUpRecord, FollowUpSender } from './follow-up.js';
21
+ export { detectTone } from './tone-detector.js';
22
+ export type { Tone } from './tone-detector.js';
23
+ export { parseOutput, renderToPlainText, renderToSatori, } from './output.js';
24
+ export type { OutputElement, TextElement, ImageElement, AudioElement, VideoElement, CardElement, FileElement, CardField, CardButton, } from './output.js';
25
+ export { calculatorTool, timeTool, searchTool, codeRunnerTool, httpTool, memoryTool, getBuiltinTools, getAllBuiltinTools, } from './tools.js';
26
+ export { BaseProvider, OpenAIProvider, DeepSeekProvider, MoonshotProvider, ZhipuProvider, AnthropicProvider, OllamaProvider, } from './providers/index.js';
27
+ export type { OpenAIConfig, AnthropicConfig, OllamaConfig, } from './providers/index.js';
28
+ export { initAIModule } from './init.js';
29
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EAEX,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGzE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,cAAc,EACd,QAAQ,EACR,UAAU,EACV,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * @zhin.js/core — AI 模块
3
+ *
4
+ * 原 @zhin.js/ai 包已合并至此,所有 AI 能力内置在 core 中。
5
+ */
6
+ // ── AI Service ──
7
+ export { AIService } from './service.js';
8
+ // ── Agent ──
9
+ export { Agent, createAgent } from './agent.js';
10
+ // ── Session ──
11
+ export { SessionManager, createMemorySessionManager, createDatabaseSessionManager, AI_SESSION_MODEL, } from './session.js';
12
+ // ── Context Manager ──
13
+ export { createContextManager, CHAT_MESSAGE_MODEL, CONTEXT_SUMMARY_MODEL, } from './context-manager.js';
14
+ // ── ZhinAgent ──
15
+ export { ZhinAgent } from './zhin-agent.js';
16
+ // ── Conversation Memory ──
17
+ export { ConversationMemory, AI_MESSAGE_MODEL, AI_SUMMARY_MODEL, } from './conversation-memory.js';
18
+ // ── User Profile ──
19
+ export { UserProfileStore, AI_USER_PROFILE_MODEL, } from './user-profile.js';
20
+ // ── Rate Limiter ──
21
+ export { RateLimiter } from './rate-limiter.js';
22
+ // ── Follow-Up ──
23
+ export { FollowUpManager, AI_FOLLOWUP_MODEL } from './follow-up.js';
24
+ // ── Tone Detector ──
25
+ export { detectTone } from './tone-detector.js';
26
+ // ── 多模态输出 ──
27
+ export { parseOutput, renderToPlainText, renderToSatori, } from './output.js';
28
+ // ── 内置工具 ──
29
+ export { calculatorTool, timeTool, searchTool, codeRunnerTool, httpTool, memoryTool, getBuiltinTools, getAllBuiltinTools, } from './tools.js';
30
+ // ── Providers ──
31
+ export { BaseProvider, OpenAIProvider, DeepSeekProvider, MoonshotProvider, ZhipuProvider, AnthropicProvider, OllamaProvider, } from './providers/index.js';
32
+ // ── 初始化 ──
33
+ export { initAIModule } from './init.js';
34
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhD,gBAAgB;AAChB,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,wBAAwB;AACxB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAO9B,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,4BAA4B;AAC5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAGlC,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,cAAc;AACd,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAarB,aAAa;AACb,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,cAAc,EACd,QAAQ,EACR,UAAU,EACV,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAO9B,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * AI 模块初始化
3
+ *
4
+ * 将 AI 服务注册到 Zhin 插件系统中:
5
+ * - AIService context
6
+ * - ZhinAgent 全局大脑
7
+ * - AI 触发处理器 (via MessageDispatcher)
8
+ * - 数据库会话/上下文持久化
9
+ * - 消息记录中间件
10
+ * - AI 管理工具
11
+ */
12
+ import { AIService } from './service.js';
13
+ declare module '../plugin.js' {
14
+ namespace Plugin {
15
+ interface Contexts {
16
+ ai: AIService;
17
+ }
18
+ }
19
+ }
20
+ /**
21
+ * 初始化 AI 模块
22
+ *
23
+ * 在 setup.ts 中调用:
24
+ * ```ts
25
+ * import { initAIModule } from '@zhin.js/core';
26
+ * initAIModule();
27
+ * ```
28
+ */
29
+ export declare function initAIModule(): void;
30
+ //# sourceMappingURL=init.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/ai/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAoBzC,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,QAAQ;YAChB,EAAE,EAAE,SAAS,CAAC;SACf;KACF;CACF;AAsCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAkZnC"}