@zhin.js/core 1.0.25 → 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 (200) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +84 -342
  3. package/lib/adapter.d.ts +17 -0
  4. package/lib/adapter.d.ts.map +1 -1
  5. package/lib/adapter.js +84 -2
  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/ai-trigger.d.ts.map +1 -1
  88. package/lib/built/ai-trigger.js +7 -3
  89. package/lib/built/ai-trigger.js.map +1 -1
  90. package/lib/built/command.d.ts +33 -17
  91. package/lib/built/command.d.ts.map +1 -1
  92. package/lib/built/command.js +71 -44
  93. package/lib/built/command.js.map +1 -1
  94. package/lib/built/component.d.ts +42 -15
  95. package/lib/built/component.d.ts.map +1 -1
  96. package/lib/built/component.js +84 -52
  97. package/lib/built/component.js.map +1 -1
  98. package/lib/built/config.d.ts +54 -5
  99. package/lib/built/config.d.ts.map +1 -1
  100. package/lib/built/config.js +76 -10
  101. package/lib/built/config.js.map +1 -1
  102. package/lib/built/cron.d.ts +41 -18
  103. package/lib/built/cron.d.ts.map +1 -1
  104. package/lib/built/cron.js +106 -63
  105. package/lib/built/cron.js.map +1 -1
  106. package/lib/built/database.d.ts +55 -6
  107. package/lib/built/database.d.ts.map +1 -1
  108. package/lib/built/database.js +93 -22
  109. package/lib/built/database.js.map +1 -1
  110. package/lib/built/dispatcher.d.ts +118 -0
  111. package/lib/built/dispatcher.d.ts.map +1 -0
  112. package/lib/built/dispatcher.js +196 -0
  113. package/lib/built/dispatcher.js.map +1 -0
  114. package/lib/built/permission.d.ts +45 -5
  115. package/lib/built/permission.d.ts.map +1 -1
  116. package/lib/built/permission.js +56 -11
  117. package/lib/built/permission.js.map +1 -1
  118. package/lib/built/skill.d.ts +117 -0
  119. package/lib/built/skill.d.ts.map +1 -0
  120. package/lib/built/skill.js +191 -0
  121. package/lib/built/skill.js.map +1 -0
  122. package/lib/built/tool.d.ts +71 -164
  123. package/lib/built/tool.d.ts.map +1 -1
  124. package/lib/built/tool.js +212 -297
  125. package/lib/built/tool.js.map +1 -1
  126. package/lib/feature.d.ts +75 -0
  127. package/lib/feature.d.ts.map +1 -0
  128. package/lib/feature.js +69 -0
  129. package/lib/feature.js.map +1 -0
  130. package/lib/index.d.ts +4 -0
  131. package/lib/index.d.ts.map +1 -1
  132. package/lib/index.js +7 -0
  133. package/lib/index.js.map +1 -1
  134. package/lib/plugin.d.ts +25 -17
  135. package/lib/plugin.d.ts.map +1 -1
  136. package/lib/plugin.js +180 -20
  137. package/lib/plugin.js.map +1 -1
  138. package/lib/types.d.ts +4 -9
  139. package/lib/types.d.ts.map +1 -1
  140. package/package.json +4 -4
  141. package/src/adapter.ts +101 -2
  142. package/src/ai/agent.ts +772 -0
  143. package/src/ai/context-manager.ts +440 -0
  144. package/src/ai/conversation-memory.ts +774 -0
  145. package/src/ai/follow-up.ts +357 -0
  146. package/src/ai/index.ts +128 -0
  147. package/src/ai/init.ts +502 -0
  148. package/src/ai/output.ts +261 -0
  149. package/src/ai/providers/anthropic.ts +375 -0
  150. package/src/ai/providers/base.ts +173 -0
  151. package/src/ai/providers/index.ts +13 -0
  152. package/src/ai/providers/ollama.ts +292 -0
  153. package/src/ai/providers/openai.ts +167 -0
  154. package/src/ai/rate-limiter.ts +129 -0
  155. package/src/ai/service.ts +319 -0
  156. package/src/ai/session.ts +544 -0
  157. package/src/ai/tone-detector.ts +89 -0
  158. package/src/ai/tools.ts +218 -0
  159. package/src/ai/types.ts +296 -0
  160. package/src/ai/user-profile.ts +181 -0
  161. package/src/ai/zhin-agent.ts +845 -0
  162. package/src/built/ai-trigger.ts +6 -3
  163. package/src/built/command.ts +75 -69
  164. package/src/built/component.ts +94 -76
  165. package/src/built/config.ts +238 -128
  166. package/src/built/cron.ts +117 -101
  167. package/src/built/database.ts +128 -33
  168. package/src/built/dispatcher.ts +332 -0
  169. package/src/built/permission.ts +146 -54
  170. package/src/built/skill.ts +280 -0
  171. package/src/built/tool.ts +245 -366
  172. package/src/feature.ts +113 -0
  173. package/src/index.ts +7 -0
  174. package/src/plugin.ts +198 -33
  175. package/src/types.ts +6 -10
  176. package/tests/adapter.test.ts +153 -1
  177. package/tests/ai/agent.test.ts +614 -0
  178. package/tests/ai/ai-trigger.test.ts +368 -0
  179. package/tests/ai/context-manager.test.ts +413 -0
  180. package/tests/ai/conversation-memory.test.ts +128 -0
  181. package/tests/ai/follow-up.test.ts +175 -0
  182. package/tests/ai/integration.test.ts +584 -0
  183. package/tests/ai/output.test.ts +128 -0
  184. package/tests/ai/providers.integration.test.ts +227 -0
  185. package/tests/ai/rate-limiter.test.ts +108 -0
  186. package/tests/ai/session.test.ts +375 -0
  187. package/tests/ai/setup.ts +308 -0
  188. package/tests/ai/tone-detector.test.ts +80 -0
  189. package/tests/ai/tool.test.ts +800 -0
  190. package/tests/ai/tools-builtin.test.ts +346 -0
  191. package/tests/ai/user-profile.test.ts +73 -0
  192. package/tests/ai/zhin-agent.test.ts +177 -0
  193. package/tests/config.test.ts +46 -0
  194. package/tests/cron.test.ts +94 -5
  195. package/tests/dispatcher.test.ts +146 -0
  196. package/tests/feature.test.ts +145 -0
  197. package/tests/features-builtin.test.ts +191 -0
  198. package/tests/plugin.test.ts +88 -14
  199. package/tests/skill-feature.test.ts +179 -0
  200. package/tests/tool-feature.test.ts +254 -0
@@ -0,0 +1,72 @@
1
+ /**
2
+ * ToneDetector — 轻量级情绪/语气检测
3
+ *
4
+ * 通过标点符号、emoji 密度、关键词分析用户语气,
5
+ * 生成一条 hint 注入 system prompt,让 AI 的回复匹配用户情绪。
6
+ *
7
+ * 零 LLM 开销,纯正则/统计分析。
8
+ */
9
+ // 常见负面情绪词
10
+ const FRUSTRATED_WORDS = /不行|不对|又错|还是不|怎么回事|搞不定|烦死|崩溃|无语|什么鬼|bug|报错|失败|出问题/;
11
+ const SAD_WORDS = /难过|伤心|失落|遗憾|可惜|唉|哎|不开心|郁闷|心累/;
12
+ const URGENT_WORDS = /急|赶紧|马上|立刻|紧急|尽快|快点|asap|hurry/i;
13
+ const EXCITED_WORDS = /太好了|太棒了|厉害|牛|可以|成功|搞定|完美|赞|nice|amazing|awesome|cool/i;
14
+ /**
15
+ * 检测用户消息的情绪语气
16
+ */
17
+ export function detectTone(message) {
18
+ const len = message.length;
19
+ if (len === 0)
20
+ return { tone: 'neutral', hint: '' };
21
+ // 统计特征
22
+ const exclamations = (message.match(/!/g) || []).length + (message.match(/!/g) || []).length;
23
+ const questions = (message.match(/\?/g) || []).length + (message.match(/?/g) || []).length;
24
+ const ellipsis = (message.match(/\.\.\./g) || []).length + (message.match(/…/g) || []).length;
25
+ const capsRatio = len > 5 ? (message.match(/[A-Z]/g) || []).length / len : 0;
26
+ // emoji 检测(常见 Unicode 范围)
27
+ const emojiCount = (message.match(/[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{1F1E0}-\u{1F1FF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}]/gu) || []).length;
28
+ // 关键词检测
29
+ const isFrustrated = FRUSTRATED_WORDS.test(message);
30
+ const isSad = SAD_WORDS.test(message);
31
+ const isUrgent = URGENT_WORDS.test(message);
32
+ const isExcited = EXCITED_WORDS.test(message);
33
+ // 判定优先级: frustrated > urgent > sad > excited > questioning > neutral
34
+ if (isFrustrated || (exclamations >= 3 && !isExcited)) {
35
+ return {
36
+ tone: 'frustrated',
37
+ hint: '用户似乎有些沮丧或受挫,请用耐心、理解的语气回复,先表示共情再提供帮助。',
38
+ };
39
+ }
40
+ if (isUrgent) {
41
+ return {
42
+ tone: 'urgent',
43
+ hint: '用户似乎很着急,请直接给出解决方案,减少寒暄,优先效率。',
44
+ };
45
+ }
46
+ if (isSad || ellipsis >= 2) {
47
+ return {
48
+ tone: 'sad',
49
+ hint: '用户的语气似乎有些低落,请用温暖、关心的语气回复。',
50
+ };
51
+ }
52
+ if (isExcited || (emojiCount >= 2 && exclamations >= 1)) {
53
+ return {
54
+ tone: 'excited',
55
+ hint: '用户的心情不错,可以用更活泼、热情的语气回复。',
56
+ };
57
+ }
58
+ if (questions >= 2 || (questions >= 1 && len < 20)) {
59
+ return {
60
+ tone: 'questioning',
61
+ hint: '', // 提问是正常的,不需要特殊 hint
62
+ };
63
+ }
64
+ if (capsRatio > 0.5 && len > 10) {
65
+ return {
66
+ tone: 'frustrated',
67
+ hint: '用户使用了大量大写字母,可能在表达强烈情绪,请注意语气。',
68
+ };
69
+ }
70
+ return { tone: 'neutral', hint: '' };
71
+ }
72
+ //# sourceMappingURL=tone-detector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tone-detector.js","sourceRoot":"","sources":["../../src/ai/tone-detector.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @zhin.js/ai - Built-in Tools
3
+ * 内置工具集合 - 使用 ZhinTool 类定义
4
+ */
5
+ import { ZhinTool } from '../built/tool.js';
6
+ /**
7
+ * 计算器工具
8
+ * 支持基本运算和数学函数
9
+ */
10
+ export declare const calculatorTool: ZhinTool;
11
+ /**
12
+ * 时间工具
13
+ * 获取当前时间和日期
14
+ */
15
+ export declare const timeTool: ZhinTool;
16
+ /**
17
+ * 网页搜索工具
18
+ * 需要配置搜索 API
19
+ */
20
+ export declare const searchTool: ZhinTool;
21
+ /**
22
+ * 代码执行工具
23
+ * 在安全沙箱中执行 JavaScript
24
+ */
25
+ export declare const codeRunnerTool: ZhinTool;
26
+ /**
27
+ * HTTP 请求工具
28
+ * 发送 HTTP 请求获取数据
29
+ */
30
+ export declare const httpTool: ZhinTool;
31
+ /**
32
+ * 记忆工具
33
+ * 让 AI 记住重要信息
34
+ */
35
+ export declare const memoryTool: ZhinTool;
36
+ /**
37
+ * 获取所有内置工具(ZhinTool 实例)
38
+ * 注意:天气工具已移除,请使用 weather-tool 插件,支持多平台配置
39
+ */
40
+ export declare function getBuiltinTools(): ZhinTool[];
41
+ /**
42
+ * 获取所有可用的内置工具(包括可选工具)
43
+ */
44
+ export declare function getAllBuiltinTools(): ZhinTool[];
45
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/ai/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C;;;GAGG;AACH,eAAO,MAAM,cAAc,UA0BvB,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,QAAQ,UA+BjB,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,UAAU,UAanB,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,cAAc,UAwBvB,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,QAAQ,UA0CjB,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,UAAU,UAcnB,CAAC;AAEL;;;GAGG;AACH,wBAAgB,eAAe,IAAI,QAAQ,EAAE,CAK5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,EAAE,CAS/C"}
@@ -0,0 +1,206 @@
1
+ /**
2
+ * @zhin.js/ai - Built-in Tools
3
+ * 内置工具集合 - 使用 ZhinTool 类定义
4
+ */
5
+ import { ZhinTool } from '../built/tool.js';
6
+ /**
7
+ * 计算器工具
8
+ * 支持基本运算和数学函数
9
+ */
10
+ export const calculatorTool = new ZhinTool('calculator')
11
+ .desc('执行数学计算。支持基本运算(+、-、*、/、^)和数学函数(sin、cos、sqrt 等)')
12
+ .keyword('计算', '算', 'calc', '数学', '求值', '运算')
13
+ .tag('math', 'utility')
14
+ .param('expression', { type: 'string', description: '数学表达式,例如 "2 + 3 * 4" 或 "sqrt(16)"' }, true)
15
+ .execute(async ({ expression }) => {
16
+ try {
17
+ // 安全的数学表达式求值
18
+ const sanitized = expression
19
+ .replace(/[^0-9+\-*/().^eEsincosqrtabspowlogxMathPI\s]/g, '')
20
+ .replace(/\bsqrt\b/g, 'Math.sqrt')
21
+ .replace(/\bsin\b/g, 'Math.sin')
22
+ .replace(/\bcos\b/g, 'Math.cos')
23
+ .replace(/\btan\b/g, 'Math.tan')
24
+ .replace(/\blog\b/g, 'Math.log')
25
+ .replace(/\babs\b/g, 'Math.abs')
26
+ .replace(/\bpow\b/g, 'Math.pow')
27
+ .replace(/\bPI\b/g, 'Math.PI')
28
+ .replace(/\bE\b(?![0-9])/g, 'Math.E')
29
+ .replace(/\^/g, '**');
30
+ const result = new Function(`return ${sanitized}`)();
31
+ return { result, expression };
32
+ }
33
+ catch (error) {
34
+ return { error: '无法计算表达式', expression };
35
+ }
36
+ });
37
+ /**
38
+ * 时间工具
39
+ * 获取当前时间和日期
40
+ */
41
+ export const timeTool = new ZhinTool('get_time')
42
+ .desc('获取当前时间和日期信息')
43
+ .keyword('时间', '日期', '几点', '今天', '现在', 'time', 'date')
44
+ .tag('time', 'utility')
45
+ .param('timezone', { type: 'string', description: '时区,例如 "Asia/Shanghai" 或 "UTC"' })
46
+ .param('format', { type: 'string', description: '输出格式: full(完整), date(日期), time(时间), timestamp(时间戳)' })
47
+ .execute(async ({ timezone, format = 'full' }) => {
48
+ const now = new Date();
49
+ const options = {
50
+ timeZone: timezone || 'Asia/Shanghai',
51
+ };
52
+ switch (format) {
53
+ case 'date':
54
+ options.dateStyle = 'full';
55
+ break;
56
+ case 'time':
57
+ options.timeStyle = 'long';
58
+ break;
59
+ case 'timestamp':
60
+ return { timestamp: now.getTime(), iso: now.toISOString() };
61
+ default:
62
+ options.dateStyle = 'full';
63
+ options.timeStyle = 'long';
64
+ }
65
+ return {
66
+ formatted: now.toLocaleString('zh-CN', options),
67
+ timestamp: now.getTime(),
68
+ iso: now.toISOString(),
69
+ };
70
+ });
71
+ /**
72
+ * 网页搜索工具
73
+ * 需要配置搜索 API
74
+ */
75
+ export const searchTool = new ZhinTool('web_search')
76
+ .desc('在互联网上搜索信息(需要配置搜索 API)')
77
+ .keyword('搜索', '搜一下', '查找', '查一查', 'search', 'google')
78
+ .tag('search', 'web')
79
+ .param('query', { type: 'string', description: '搜索关键词' }, true)
80
+ .param('limit', { type: 'number', description: '返回结果数量(默认 5)' })
81
+ .execute(async ({ query, limit = 5 }) => {
82
+ // 默认实现提示需要配置
83
+ return {
84
+ query,
85
+ error: '搜索功能未配置,请提供搜索 API',
86
+ hint: '可以集成 SerpAPI、Bing Search API 或 Google Custom Search',
87
+ };
88
+ });
89
+ /**
90
+ * 代码执行工具
91
+ * 在安全沙箱中执行 JavaScript
92
+ */
93
+ export const codeRunnerTool = new ZhinTool('run_code')
94
+ .desc('执行 JavaScript 代码(在安全沙箱中)')
95
+ .keyword('代码', '执行', '运行', 'code', 'js', 'javascript')
96
+ .tag('code', 'dev')
97
+ .param('code', { type: 'string', description: 'JavaScript 代码' }, true)
98
+ .execute(async ({ code }) => {
99
+ try {
100
+ // 简单的沙箱执行(生产环境应使用 vm2 或 isolated-vm)
101
+ const result = new Function(`
102
+ 'use strict';
103
+ const console = { log: (...args) => args.join(' ') };
104
+ return (function() { ${code} })();
105
+ `)();
106
+ return {
107
+ success: true,
108
+ result: result !== undefined ? String(result) : 'undefined',
109
+ };
110
+ }
111
+ catch (error) {
112
+ return {
113
+ success: false,
114
+ error: error instanceof Error ? error.message : String(error),
115
+ };
116
+ }
117
+ });
118
+ /**
119
+ * HTTP 请求工具
120
+ * 发送 HTTP 请求获取数据
121
+ */
122
+ export const httpTool = new ZhinTool('http_request')
123
+ .desc('发送 HTTP 请求获取数据')
124
+ .keyword('http', 'api', '请求', '接口', 'url', 'fetch')
125
+ .tag('http', 'web')
126
+ .param('url', { type: 'string', description: '请求 URL' }, true)
127
+ .param('method', { type: 'string', description: 'HTTP 方法: GET, POST, PUT, DELETE(默认 GET)' })
128
+ .param('headers', { type: 'object', description: '请求头(JSON 对象)' })
129
+ .param('body', { type: 'string', description: '请求体(JSON 字符串)' })
130
+ .execute(async ({ url, method = 'GET', headers = {}, body }) => {
131
+ try {
132
+ const response = await fetch(url, {
133
+ method: method,
134
+ headers: {
135
+ 'Content-Type': 'application/json',
136
+ ...headers,
137
+ },
138
+ body: body ? body : undefined,
139
+ });
140
+ const contentType = response.headers.get('content-type') || '';
141
+ let data;
142
+ if (contentType.includes('application/json')) {
143
+ data = await response.json();
144
+ }
145
+ else {
146
+ data = await response.text();
147
+ // 限制文本长度
148
+ if (data.length > 5000) {
149
+ data = data.substring(0, 5000) + '... (truncated)';
150
+ }
151
+ }
152
+ return {
153
+ status: response.status,
154
+ statusText: response.statusText,
155
+ data,
156
+ };
157
+ }
158
+ catch (error) {
159
+ return {
160
+ error: error instanceof Error ? error.message : String(error),
161
+ };
162
+ }
163
+ });
164
+ /**
165
+ * 记忆工具
166
+ * 让 AI 记住重要信息
167
+ */
168
+ export const memoryTool = new ZhinTool('remember')
169
+ .desc('记住用户告诉你的重要信息,以便后续对话中使用')
170
+ .keyword('记住', '记忆', '记下', 'remember', '别忘了')
171
+ .tag('memory', 'context')
172
+ .param('key', { type: 'string', description: '记忆的标识符,如 "user_name", "preference"' }, true)
173
+ .param('value', { type: 'string', description: '要记住的内容' }, true)
174
+ .execute(async ({ key, value }, context) => {
175
+ // 这里需要与 session/context manager 集成
176
+ return {
177
+ success: true,
178
+ message: `已记住 ${key}: ${value}`,
179
+ key,
180
+ value,
181
+ };
182
+ });
183
+ /**
184
+ * 获取所有内置工具(ZhinTool 实例)
185
+ * 注意:天气工具已移除,请使用 weather-tool 插件,支持多平台配置
186
+ */
187
+ export function getBuiltinTools() {
188
+ return [
189
+ calculatorTool,
190
+ timeTool,
191
+ ];
192
+ }
193
+ /**
194
+ * 获取所有可用的内置工具(包括可选工具)
195
+ */
196
+ export function getAllBuiltinTools() {
197
+ return [
198
+ calculatorTool,
199
+ timeTool,
200
+ searchTool,
201
+ codeRunnerTool,
202
+ httpTool,
203
+ memoryTool,
204
+ ];
205
+ }
206
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/ai/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,264 @@
1
+ /**
2
+ * @zhin.js/ai - AI Service Types
3
+ * 统一的 AI 服务类型定义
4
+ */
5
+ /** 消息角色 */
6
+ export type MessageRole = 'system' | 'user' | 'assistant' | 'tool' | 'tool_call' | 'tool_result';
7
+ /** 聊天消息 */
8
+ export interface ChatMessage {
9
+ role: MessageRole;
10
+ content: string | ContentPart[];
11
+ name?: string;
12
+ tool_call_id?: string;
13
+ tool_calls?: ToolCall[];
14
+ }
15
+ /** 内容部分(支持多模态) */
16
+ export type ContentPart = {
17
+ type: 'text';
18
+ text: string;
19
+ } | {
20
+ type: 'image_url';
21
+ image_url: {
22
+ url: string;
23
+ detail?: 'auto' | 'low' | 'high';
24
+ };
25
+ } | {
26
+ type: 'audio';
27
+ audio: {
28
+ data: string;
29
+ format: 'wav' | 'mp3';
30
+ };
31
+ };
32
+ /** 工具调用 */
33
+ export interface ToolCall {
34
+ id: string;
35
+ type: 'function';
36
+ function: {
37
+ name: string;
38
+ arguments: string;
39
+ };
40
+ }
41
+ /** 工具定义 */
42
+ export interface ToolDefinition {
43
+ type: 'function';
44
+ function: {
45
+ name: string;
46
+ description: string;
47
+ parameters: JsonSchema;
48
+ };
49
+ }
50
+ /** JSON Schema */
51
+ export interface JsonSchema {
52
+ type: string;
53
+ properties?: Record<string, JsonSchema>;
54
+ required?: string[];
55
+ items?: JsonSchema;
56
+ enum?: any[];
57
+ description?: string;
58
+ default?: any;
59
+ [key: string]: any;
60
+ }
61
+ /** 聊天补全请求 */
62
+ export interface ChatCompletionRequest {
63
+ model: string;
64
+ messages: ChatMessage[];
65
+ tools?: ToolDefinition[];
66
+ tool_choice?: 'auto' | 'none' | 'required' | {
67
+ type: 'function';
68
+ function: {
69
+ name: string;
70
+ };
71
+ };
72
+ temperature?: number;
73
+ top_p?: number;
74
+ max_tokens?: number;
75
+ stream?: boolean;
76
+ stop?: string | string[];
77
+ presence_penalty?: number;
78
+ frequency_penalty?: number;
79
+ user?: string;
80
+ /** 是否启用模型思考(如 qwen3 的 <think> 模式)。设为 false 可跳过思考加速响应。 */
81
+ think?: boolean;
82
+ }
83
+ /** 聊天补全响应 */
84
+ export interface ChatCompletionResponse {
85
+ id: string;
86
+ object: 'chat.completion';
87
+ created: number;
88
+ model: string;
89
+ choices: ChatCompletionChoice[];
90
+ usage?: Usage;
91
+ }
92
+ /** 选择 */
93
+ export interface ChatCompletionChoice {
94
+ index: number;
95
+ message: ChatMessage;
96
+ finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
97
+ }
98
+ /** 用量统计 */
99
+ export interface Usage {
100
+ prompt_tokens: number;
101
+ completion_tokens: number;
102
+ total_tokens: number;
103
+ }
104
+ /** 流式响应块 */
105
+ export interface ChatCompletionChunk {
106
+ id: string;
107
+ object: 'chat.completion.chunk';
108
+ created: number;
109
+ model: string;
110
+ choices: ChatCompletionChunkChoice[];
111
+ usage?: Usage;
112
+ }
113
+ /** 流式选择 */
114
+ export interface ChatCompletionChunkChoice {
115
+ index: number;
116
+ delta: Partial<ChatMessage>;
117
+ finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
118
+ }
119
+ /** Provider 配置 */
120
+ export interface ProviderConfig {
121
+ apiKey?: string;
122
+ baseUrl?: string;
123
+ defaultModel?: string;
124
+ timeout?: number;
125
+ maxRetries?: number;
126
+ headers?: Record<string, string>;
127
+ }
128
+ /** Provider 接口 */
129
+ export interface AIProvider {
130
+ name: string;
131
+ models: string[];
132
+ /** 聊天补全 */
133
+ chat(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
134
+ /** 流式聊天补全 */
135
+ chatStream(request: ChatCompletionRequest): AsyncIterable<ChatCompletionChunk>;
136
+ /** 列出可用模型 */
137
+ listModels?(): Promise<string[]>;
138
+ /** 检查连接 */
139
+ healthCheck?(): Promise<boolean>;
140
+ }
141
+ /** Agent 工具 */
142
+ export interface AgentTool {
143
+ name: string;
144
+ description: string;
145
+ parameters: JsonSchema;
146
+ execute: (args: Record<string, any>) => Promise<any>;
147
+ /** 工具标签,用于分类和快速匹配 */
148
+ tags?: string[];
149
+ /** 触发关键词,用户消息包含这些词时优先选择此工具 */
150
+ keywords?: string[];
151
+ /** 所需权限级别 (0=所有人, 1=群管理, 2=群主, 3=Bot管理员, 4=拥有者) */
152
+ permissionLevel?: number;
153
+ }
154
+ /**
155
+ * 工具过滤选项
156
+ * 在 Agent.run() / runStream() 中启用程序化工具预过滤,
157
+ * 省去额外的 AI 意图分析往返
158
+ */
159
+ export interface ToolFilterOptions {
160
+ /** 调用者权限级别 (0-4),高于工具要求才能使用 */
161
+ callerPermissionLevel?: number;
162
+ /** 最大返回工具数量 (默认 10) */
163
+ maxTools?: number;
164
+ /** 最低相关性得分阈值,低于此分数的工具被过滤掉 (默认 0.1) */
165
+ minScore?: number;
166
+ }
167
+ /** Agent 配置 */
168
+ export interface AgentConfig {
169
+ provider: string;
170
+ model?: string;
171
+ systemPrompt?: string;
172
+ tools?: AgentTool[];
173
+ maxIterations?: number;
174
+ temperature?: number;
175
+ }
176
+ /** Agent 运行结果 */
177
+ export interface AgentResult {
178
+ content: string;
179
+ toolCalls: {
180
+ tool: string;
181
+ args: Record<string, any>;
182
+ result: any;
183
+ }[];
184
+ usage: Usage;
185
+ iterations: number;
186
+ }
187
+ /** 会话配置 */
188
+ export interface SessionConfig {
189
+ provider: string;
190
+ model?: string;
191
+ systemPrompt?: string;
192
+ maxHistory?: number;
193
+ expireMs?: number;
194
+ }
195
+ /** 会话 */
196
+ export interface Session {
197
+ id: string;
198
+ config: SessionConfig;
199
+ messages: ChatMessage[];
200
+ createdAt: number;
201
+ updatedAt: number;
202
+ metadata?: Record<string, any>;
203
+ }
204
+ /** AI 服务配置 */
205
+ export interface AIConfig {
206
+ enabled?: boolean;
207
+ defaultProvider?: string;
208
+ providers?: {
209
+ openai?: ProviderConfig;
210
+ anthropic?: ProviderConfig;
211
+ deepseek?: ProviderConfig;
212
+ moonshot?: ProviderConfig;
213
+ zhipu?: ProviderConfig;
214
+ ollama?: ProviderConfig & {
215
+ host?: string;
216
+ models?: string[];
217
+ };
218
+ custom?: ProviderConfig[];
219
+ };
220
+ sessions?: {
221
+ /** 最大历史消息数(数据库模式默认200,内存模式默认100) */
222
+ maxHistory?: number;
223
+ /** 会话过期时间(毫秒,数据库模式默认7天,内存模式默认24小时) */
224
+ expireMs?: number;
225
+ /** 是否使用数据库持久化存储(默认 true) */
226
+ useDatabase?: boolean;
227
+ };
228
+ context?: {
229
+ /** 是否启用消息记录(默认 true) */
230
+ enabled?: boolean;
231
+ /** 读取的最近消息数量(默认 100) */
232
+ maxRecentMessages?: number;
233
+ /** 触发总结的消息数量阈值(默认 50) */
234
+ summaryThreshold?: number;
235
+ /** 总结后保留的消息数量(默认 10) */
236
+ keepAfterSummary?: number;
237
+ /** 上下文最大 token 估算(默认 4000) */
238
+ maxContextTokens?: number;
239
+ /** 自定义总结提示词 */
240
+ summaryPrompt?: string;
241
+ };
242
+ /** AI 触发配置 */
243
+ trigger?: {
244
+ /** 是否启用(默认 true) */
245
+ enabled?: boolean;
246
+ /** 触发前缀列表(默认 ['#', 'AI:']) */
247
+ prefixes?: string[];
248
+ /** 是否响应 @ 机器人(默认 true) */
249
+ respondToAt?: boolean;
250
+ /** 是否响应私聊(默认 true) */
251
+ respondToPrivate?: boolean;
252
+ /** 触发关键词(可选) */
253
+ keywords?: string[];
254
+ /** 忽略的前缀(命令前缀,避免与命令冲突,默认 ['/', '!', '!']) */
255
+ ignorePrefixes?: string[];
256
+ /** 超时时间(毫秒,默认 60000) */
257
+ timeout?: number;
258
+ /** 思考中提示语(可选,设置后会在处理前发送) */
259
+ thinkingMessage?: string;
260
+ /** 错误提示模板(默认 '❌ AI 处理失败: {error}') */
261
+ errorTemplate?: string;
262
+ };
263
+ }
264
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @zhin.js/ai - AI Service Types
3
+ * 统一的 AI 服务类型定义
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}