foliko 1.0.80 → 1.0.81

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 (235) hide show
  1. package/.agent/agents/code-assistant.json +14 -0
  2. package/.agent/agents/email-assistant.json +14 -0
  3. package/.agent/agents/file-assistant.json +15 -0
  4. package/.agent/agents/system-assistant.json +15 -0
  5. package/.agent/agents/web-assistant.json +12 -0
  6. package/.agent/data/ambient/goals.json +50 -0
  7. package/.agent/data/ambient/memories.json +7 -0
  8. package/.agent/data/default.json +15 -31894
  9. package/.agent/data/plugins-state.json +146 -181
  10. package/.agent/data/scheduler/tasks.json +1 -0
  11. package/.agent/mcp_config.json +1 -0
  12. package/.agent/package.json +8 -0
  13. package/.agent/plugins/__pycache__/test_plugin.cpython-312.pyc +0 -0
  14. package/.agent/plugins/system-info/index.js +387 -0
  15. package/.agent/plugins/system-info/package.json +4 -0
  16. package/.agent/plugins/system-info/test.js +40 -0
  17. package/.agent/plugins/test_plugin.py +304 -0
  18. package/.agent/plugins.json +14 -5
  19. package/.agent/python-scripts/test_sample.py +24 -0
  20. package/.agent/skills/sysinfo/SKILL.md +38 -0
  21. package/.agent/skills/sysinfo/system-info.sh +130 -0
  22. package/.agent/skills/workflow/SKILL.md +324 -0
  23. package/.agent/workflows/email-digest.json +50 -0
  24. package/.agent/workflows/file-backup.json +21 -0
  25. package/.agent/workflows/get-ip-notify.json +32 -0
  26. package/.agent/workflows/news-aggregator.json +93 -0
  27. package/.agent/workflows/news-dashboard-v2.json +94 -0
  28. package/.agent/workflows/notification-batch.json +32 -0
  29. package/.claude/settings.local.json +171 -171
  30. package/.env.example +56 -56
  31. package/cli/bin/foliko.js +12 -12
  32. package/cli/src/commands/chat.js +143 -143
  33. package/cli/src/commands/list.js +93 -93
  34. package/cli/src/index.js +75 -75
  35. package/cli/src/ui/chat-ui.js +201 -201
  36. package/cli/src/utils/ansi.js +40 -40
  37. package/cli/src/utils/markdown.js +292 -292
  38. package/examples/ambient-example.js +194 -194
  39. package/examples/basic.js +115 -115
  40. package/examples/bootstrap.js +121 -121
  41. package/examples/mcp-example.js +56 -56
  42. package/examples/skill-example.js +49 -49
  43. package/examples/test-chat.js +137 -137
  44. package/examples/test-mcp.js +85 -85
  45. package/examples/test-reload.js +59 -59
  46. package/examples/test-telegram.js +50 -50
  47. package/examples/test-tg-bot.js +45 -45
  48. package/examples/test-tg-simple.js +47 -47
  49. package/examples/test-tg.js +62 -62
  50. package/examples/test-think.js +43 -43
  51. package/examples/test-web-plugin.js +103 -103
  52. package/examples/test-weixin-feishu.js +103 -103
  53. package/examples/workflow.js +158 -158
  54. package/package.json +83 -83
  55. package/plugins/ai-plugin.js +102 -102
  56. package/plugins/ambient-agent/EventWatcher.js +113 -113
  57. package/plugins/ambient-agent/ExplorerLoop.js +640 -640
  58. package/plugins/ambient-agent/GoalManager.js +197 -197
  59. package/plugins/ambient-agent/Reflector.js +95 -95
  60. package/plugins/ambient-agent/StateStore.js +90 -90
  61. package/plugins/ambient-agent/constants.js +101 -101
  62. package/plugins/ambient-agent/index.js +579 -579
  63. package/plugins/audit-plugin.js +187 -187
  64. package/plugins/default-plugins.js +548 -548
  65. package/plugins/email/constants.js +64 -64
  66. package/plugins/email/handlers.js +461 -461
  67. package/plugins/email/index.js +278 -278
  68. package/plugins/email/monitor.js +269 -269
  69. package/plugins/email/parser.js +138 -138
  70. package/plugins/email/reply.js +151 -151
  71. package/plugins/email/utils.js +124 -124
  72. package/plugins/extension-executor-plugin.js +326 -326
  73. package/plugins/feishu-plugin.js +481 -481
  74. package/plugins/file-system-plugin.js +920 -877
  75. package/plugins/gate-trading.js +747 -747
  76. package/plugins/install-plugin.js +199 -199
  77. package/plugins/python-executor-plugin.js +367 -367
  78. package/plugins/python-plugin-loader.js +651 -651
  79. package/plugins/rules-plugin.js +294 -294
  80. package/plugins/scheduler-plugin.js +691 -691
  81. package/plugins/session-plugin.js +494 -494
  82. package/plugins/shell-executor-plugin.js +197 -197
  83. package/plugins/storage-plugin.js +263 -263
  84. package/plugins/subagent-plugin.js +845 -845
  85. package/plugins/telegram-plugin.js +482 -482
  86. package/plugins/think-plugin.js +345 -345
  87. package/plugins/tools-plugin.js +196 -196
  88. package/plugins/web-plugin.js +637 -637
  89. package/plugins/weixin-plugin.js +545 -545
  90. package/skills/find-skills/AGENTS.md +162 -162
  91. package/skills/find-skills/SKILL.md +133 -133
  92. package/skills/foliko-dev/SKILL.md +563 -583
  93. package/skills/python-plugin-dev/SKILL.md +238 -238
  94. package/src/capabilities/index.js +11 -11
  95. package/src/capabilities/skill-manager.js +609 -609
  96. package/src/capabilities/workflow-engine.js +1109 -1109
  97. package/src/core/agent-chat.js +141 -134
  98. package/src/core/agent.js +958 -958
  99. package/src/core/framework.js +465 -465
  100. package/src/core/index.js +19 -19
  101. package/src/core/plugin-base.js +262 -262
  102. package/src/core/plugin-manager.js +863 -863
  103. package/src/core/provider.js +114 -114
  104. package/src/core/sub-agent-config.js +264 -264
  105. package/src/core/system-prompt-builder.js +120 -120
  106. package/src/core/tool-registry.js +517 -517
  107. package/src/core/tool-router.js +297 -297
  108. package/src/executors/executor-base.js +58 -58
  109. package/src/executors/mcp-executor.js +845 -845
  110. package/src/index.js +25 -25
  111. package/src/utils/circuit-breaker.js +301 -301
  112. package/src/utils/error-boundary.js +363 -363
  113. package/src/utils/error.js +374 -374
  114. package/src/utils/event-emitter.js +97 -97
  115. package/src/utils/id.js +133 -133
  116. package/src/utils/index.js +217 -217
  117. package/src/utils/logger.js +181 -181
  118. package/src/utils/plugin-helpers.js +90 -90
  119. package/src/utils/retry.js +122 -122
  120. package/src/utils/sandbox.js +292 -292
  121. package/test/tool-registry-validation.test.js +218 -218
  122. package/website/script.js +136 -136
  123. package/.agent/.shared/ui-ux-pro-max/data/charts.csv +0 -26
  124. package/.agent/.shared/ui-ux-pro-max/data/colors.csv +0 -97
  125. package/.agent/.shared/ui-ux-pro-max/data/icons.csv +0 -101
  126. package/.agent/.shared/ui-ux-pro-max/data/landing.csv +0 -31
  127. package/.agent/.shared/ui-ux-pro-max/data/products.csv +0 -97
  128. package/.agent/.shared/ui-ux-pro-max/data/prompts.csv +0 -24
  129. package/.agent/.shared/ui-ux-pro-max/data/react-performance.csv +0 -45
  130. package/.agent/.shared/ui-ux-pro-max/data/stacks/flutter.csv +0 -53
  131. package/.agent/.shared/ui-ux-pro-max/data/stacks/html-tailwind.csv +0 -56
  132. package/.agent/.shared/ui-ux-pro-max/data/stacks/jetpack-compose.csv +0 -53
  133. package/.agent/.shared/ui-ux-pro-max/data/stacks/nextjs.csv +0 -53
  134. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxt-ui.csv +0 -51
  135. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxtjs.csv +0 -59
  136. package/.agent/.shared/ui-ux-pro-max/data/stacks/react-native.csv +0 -52
  137. package/.agent/.shared/ui-ux-pro-max/data/stacks/react.csv +0 -54
  138. package/.agent/.shared/ui-ux-pro-max/data/stacks/shadcn.csv +0 -61
  139. package/.agent/.shared/ui-ux-pro-max/data/stacks/svelte.csv +0 -54
  140. package/.agent/.shared/ui-ux-pro-max/data/stacks/swiftui.csv +0 -51
  141. package/.agent/.shared/ui-ux-pro-max/data/stacks/vue.csv +0 -50
  142. package/.agent/.shared/ui-ux-pro-max/data/styles.csv +0 -59
  143. package/.agent/.shared/ui-ux-pro-max/data/typography.csv +0 -58
  144. package/.agent/.shared/ui-ux-pro-max/data/ui-reasoning.csv +0 -101
  145. package/.agent/.shared/ui-ux-pro-max/data/ux-guidelines.csv +0 -100
  146. package/.agent/.shared/ui-ux-pro-max/data/web-interface.csv +0 -31
  147. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/core.cpython-313.pyc +0 -0
  148. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
  149. package/.agent/.shared/ui-ux-pro-max/scripts/core.py +0 -258
  150. package/.agent/.shared/ui-ux-pro-max/scripts/design_system.py +0 -1067
  151. package/.agent/.shared/ui-ux-pro-max/scripts/search.py +0 -106
  152. package/.agent/ARCHITECTURE.md +0 -288
  153. package/.agent/agents/ambient-agent.md +0 -57
  154. package/.agent/agents/debugger.md +0 -55
  155. package/.agent/agents/email-assistant.md +0 -49
  156. package/.agent/agents/file-manager.md +0 -42
  157. package/.agent/agents/python-developer.md +0 -60
  158. package/.agent/agents/scheduler.md +0 -59
  159. package/.agent/agents/web-developer.md +0 -45
  160. package/.agent/mcp_config_updated.json +0 -12
  161. package/.agent/rules/GEMINI.md +0 -273
  162. package/.agent/rules/allow-rule.md +0 -77
  163. package/.agent/rules/log-rule.md +0 -83
  164. package/.agent/rules/security-rule.md +0 -93
  165. package/.agent/scripts/auto_preview.py +0 -148
  166. package/.agent/scripts/checklist.py +0 -217
  167. package/.agent/scripts/session_manager.py +0 -120
  168. package/.agent/scripts/verify_all.py +0 -327
  169. package/.agent/skills/api-patterns/SKILL.md +0 -81
  170. package/.agent/skills/api-patterns/api-style.md +0 -42
  171. package/.agent/skills/api-patterns/auth.md +0 -24
  172. package/.agent/skills/api-patterns/documentation.md +0 -26
  173. package/.agent/skills/api-patterns/graphql.md +0 -41
  174. package/.agent/skills/api-patterns/rate-limiting.md +0 -31
  175. package/.agent/skills/api-patterns/response.md +0 -37
  176. package/.agent/skills/api-patterns/rest.md +0 -40
  177. package/.agent/skills/api-patterns/scripts/api_validator.py +0 -211
  178. package/.agent/skills/api-patterns/security-testing.md +0 -122
  179. package/.agent/skills/api-patterns/trpc.md +0 -41
  180. package/.agent/skills/api-patterns/versioning.md +0 -22
  181. package/.agent/skills/app-builder/SKILL.md +0 -75
  182. package/.agent/skills/app-builder/agent-coordination.md +0 -71
  183. package/.agent/skills/app-builder/feature-building.md +0 -53
  184. package/.agent/skills/app-builder/project-detection.md +0 -34
  185. package/.agent/skills/app-builder/scaffolding.md +0 -118
  186. package/.agent/skills/app-builder/tech-stack.md +0 -40
  187. package/.agent/skills/app-builder/templates/SKILL.md +0 -39
  188. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  189. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  190. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  191. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  192. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  193. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  194. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  195. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -122
  196. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -122
  197. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -169
  198. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -134
  199. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  200. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -119
  201. package/.agent/skills/architecture/SKILL.md +0 -55
  202. package/.agent/skills/architecture/context-discovery.md +0 -43
  203. package/.agent/skills/architecture/examples.md +0 -94
  204. package/.agent/skills/architecture/pattern-selection.md +0 -68
  205. package/.agent/skills/architecture/patterns-reference.md +0 -50
  206. package/.agent/skills/architecture/trade-off-analysis.md +0 -77
  207. package/.agent/skills/clean-code/SKILL.md +0 -201
  208. package/.agent/skills/doc.md +0 -177
  209. package/.agent/skills/frontend-design/SKILL.md +0 -418
  210. package/.agent/skills/frontend-design/animation-guide.md +0 -331
  211. package/.agent/skills/frontend-design/color-system.md +0 -311
  212. package/.agent/skills/frontend-design/decision-trees.md +0 -418
  213. package/.agent/skills/frontend-design/motion-graphics.md +0 -306
  214. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +0 -183
  215. package/.agent/skills/frontend-design/scripts/ux_audit.py +0 -722
  216. package/.agent/skills/frontend-design/typography-system.md +0 -345
  217. package/.agent/skills/frontend-design/ux-psychology.md +0 -1116
  218. package/.agent/skills/frontend-design/visual-effects.md +0 -383
  219. package/.agent/skills/i18n-localization/SKILL.md +0 -154
  220. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +0 -241
  221. package/.agent/skills/mcp-builder/SKILL.md +0 -176
  222. package/.agent/skills/web-design-guidelines/SKILL.md +0 -57
  223. package/.agent/workflows/brainstorm.md +0 -113
  224. package/.agent/workflows/create.md +0 -59
  225. package/.agent/workflows/debug.md +0 -103
  226. package/.agent/workflows/deploy.md +0 -176
  227. package/.agent/workflows/enhance.md +0 -63
  228. package/.agent/workflows/orchestrate.md +0 -237
  229. package/.agent/workflows/plan.md +0 -89
  230. package/.agent/workflows/preview.md +0 -81
  231. package/.agent/workflows/simple-test.md +0 -42
  232. package/.agent/workflows/status.md +0 -86
  233. package/.agent/workflows/structured-orchestrate.md +0 -180
  234. package/.agent/workflows/test.md +0 -144
  235. package/.agent/workflows/ui-ux-pro-max.md +0 -296
@@ -1,264 +1,264 @@
1
- /**
2
- * Storage 存储插件
3
- * 提供数据持久化存储,支持 JSON 文件存储
4
- */
5
-
6
- const { Plugin } = require('../src/core/plugin-base')
7
- const { logger } = require('../src/utils/logger')
8
- const log = logger.child('Storage')
9
- const { z } = require('zod')
10
- const fs = require('fs')
11
- const path = require('path')
12
-
13
- class StoragePlugin extends Plugin {
14
- constructor(config = {}) {
15
- super()
16
- this.name = 'storage'
17
- this.version = '1.0.0'
18
- this.description = '数据持久化存储插件,支持键值对存储'
19
- this.priority = 3
20
-
21
- this.system = true
22
-
23
- this.config = {
24
- type: config.type || 'json', // json 或 memory
25
- path: config.path || '.agent/data',
26
- namespace: config.namespace || 'default'
27
- }
28
-
29
- this._framework = null
30
- this._store = new Map()
31
- this._filePath = null
32
- }
33
-
34
- install(framework) {
35
- this._framework = framework
36
- return this
37
- }
38
-
39
- start(framework) {
40
- // 初始化存储
41
- if (this.config.type === 'json') {
42
- this._initJsonStore()
43
- }
44
-
45
- // 注册存储工具
46
- framework.registerTool({
47
- name: 'storage_set',
48
- description: '存储数据到键值存储',
49
- inputSchema: z.object({
50
- key: z.string().describe('存储键名'),
51
- value: z.any().describe('存储值'),
52
- namespace: z.string().optional().describe('命名空间,默认使用全局命名空间')
53
- }),
54
- execute: async (args) => {
55
- try {
56
- const ns = args.namespace || this.config.namespace
57
- const fullKey = `${ns}:${args.key}`
58
- this._store.set(fullKey, {
59
- value: args.value,
60
- updatedAt: new Date()
61
- })
62
-
63
- if (this.config.type === 'json') {
64
- await this._persistToFile()
65
- }
66
-
67
- return { success: true, key: args.key, namespace: ns }
68
- } catch (err) {
69
- return { success: false, error: err.message }
70
- }
71
- }
72
- })
73
-
74
- framework.registerTool({
75
- name: 'storage_get',
76
- description: '从键值存储获取数据',
77
- inputSchema: z.object({
78
- key: z.string().describe('存储键名'),
79
- namespace: z.string().optional().describe('命名空间')
80
- }),
81
- execute: async (args) => {
82
- const ns = args.namespace || this.config.namespace
83
- const fullKey = `${ns}:${args.key}`
84
- const entry = this._store.get(fullKey)
85
-
86
- if (!entry) {
87
- return { success: false, error: 'Key not found', key: args.key }
88
- }
89
-
90
- return {
91
- success: true,
92
- key: args.key,
93
- namespace: ns,
94
- value: entry.value,
95
- updatedAt: entry.updatedAt
96
- }
97
- }
98
- })
99
-
100
- framework.registerTool({
101
- name: 'storage_delete',
102
- description: '删除存储的数据',
103
- inputSchema: z.object({
104
- key: z.string().describe('存储键名'),
105
- namespace: z.string().optional().describe('命名空间')
106
- }),
107
- execute: async (args) => {
108
- const ns = args.namespace || this.config.namespace
109
- const fullKey = `${ns}:${args.key}`
110
- const existed = this._store.has(fullKey)
111
- this._store.delete(fullKey)
112
-
113
- if (this.config.type === 'json') {
114
- await this._persistToFile()
115
- }
116
-
117
- return { success: true, deleted: existed, key: args.key }
118
- }
119
- })
120
-
121
- framework.registerTool({
122
- name: 'storage_list',
123
- description: '列出命名空间下的所有键',
124
- inputSchema: z.object({
125
- namespace: z.string().optional().describe('命名空间,默认全局')
126
- }),
127
- execute: async (args) => {
128
- const ns = args.namespace || this.config.namespace
129
- const prefix = `${ns}:`
130
- const keys = []
131
-
132
- for (const key of this._store.keys()) {
133
- if (key.startsWith(prefix)) {
134
- keys.push(key.substring(prefix.length))
135
- }
136
- }
137
-
138
- return {
139
- success: true,
140
- namespace: ns,
141
- keys,
142
- count: keys.length
143
- }
144
- }
145
- })
146
-
147
- framework.registerTool({
148
- name: 'storage_clear',
149
- description: '清空命名空间下的所有数据',
150
- inputSchema: z.object({
151
- namespace: z.string().optional().describe('命名空间,默认全局')
152
- }),
153
- execute: async (args) => {
154
- const ns = args.namespace || this.config.namespace
155
- const prefix = `${ns}:`
156
- let count = 0
157
-
158
- for (const key of this._store.keys()) {
159
- if (key.startsWith(prefix)) {
160
- this._store.delete(key)
161
- count++
162
- }
163
- }
164
-
165
- if (this.config.type === 'json') {
166
- await this._persistToFile()
167
- }
168
-
169
- return { success: true, namespace: ns, cleared: count }
170
- }
171
- })
172
-
173
- return this
174
- }
175
-
176
- /**
177
- * 初始化 JSON 文件存储
178
- */
179
- _initJsonStore() {
180
- this._filePath = path.resolve(process.cwd(), this.config.path, `${this.config.namespace}.json`)
181
-
182
- // 确保目录存在
183
- const dir = path.dirname(this._filePath)
184
- if (!fs.existsSync(dir)) {
185
- fs.mkdirSync(dir, { recursive: true })
186
- }
187
-
188
- // 加载已有数据
189
- if (fs.existsSync(this._filePath)) {
190
- try {
191
- const content = fs.readFileSync(this._filePath, 'utf-8')
192
- const data = JSON.parse(content)
193
-
194
- for (const [key, entry] of Object.entries(data)) {
195
- this._store.set(key, entry)
196
- }
197
-
198
- log.info(` Loaded ${this._store.size} entries from ${this._filePath}`)
199
- } catch (err) {
200
- log.warn(` Failed to load storage file: ${err.message}`)
201
- }
202
- }
203
- }
204
-
205
- /**
206
- * 持久化到文件
207
- */
208
- async _persistToFile() {
209
- if (!this._filePath) return
210
-
211
- try {
212
- const data = Object.fromEntries(this._store)
213
- fs.writeFileSync(this._filePath, JSON.stringify(data, null, 2), 'utf-8')
214
- } catch (err) {
215
- log.error(` Failed to persist: ${err.message}`)
216
- }
217
- }
218
-
219
- /**
220
- * 获取存储实例(供其他插件使用)
221
- */
222
- getStore() {
223
- return this._store
224
- }
225
-
226
- /**
227
- * 直接设置值并自动持久化(供其他插件使用)
228
- * @param {string} key - 键
229
- * @param {any} value - 值
230
- */
231
- setDirect(key, value) {
232
- this._store.set(key, value)
233
- if (this.config.type === 'json') {
234
- this._persistToFile()
235
- }
236
- }
237
-
238
- /**
239
- * 删除键并自动持久化(供其他插件使用)
240
- * @param {string} key - 键
241
- */
242
- deleteDirect(key) {
243
- this._store.delete(key)
244
- if (this.config.type === 'json') {
245
- this._persistToFile()
246
- }
247
- }
248
-
249
- reload(framework) {
250
- this._framework = framework
251
- this._store.clear()
252
-
253
- if (this.config.type === 'json') {
254
- this._initJsonStore()
255
- }
256
- }
257
-
258
- uninstall(framework) {
259
- this._store.clear()
260
- this._framework = null
261
- }
262
- }
263
-
1
+ /**
2
+ * Storage 存储插件
3
+ * 提供数据持久化存储,支持 JSON 文件存储
4
+ */
5
+
6
+ const { Plugin } = require('../src/core/plugin-base')
7
+ const { logger } = require('../src/utils/logger')
8
+ const log = logger.child('Storage')
9
+ const { z } = require('zod')
10
+ const fs = require('fs')
11
+ const path = require('path')
12
+
13
+ class StoragePlugin extends Plugin {
14
+ constructor(config = {}) {
15
+ super()
16
+ this.name = 'storage'
17
+ this.version = '1.0.0'
18
+ this.description = '数据持久化存储插件,支持键值对存储'
19
+ this.priority = 3
20
+
21
+ this.system = true
22
+
23
+ this.config = {
24
+ type: config.type || 'json', // json 或 memory
25
+ path: config.path || '.agent/data',
26
+ namespace: config.namespace || 'default'
27
+ }
28
+
29
+ this._framework = null
30
+ this._store = new Map()
31
+ this._filePath = null
32
+ }
33
+
34
+ install(framework) {
35
+ this._framework = framework
36
+ return this
37
+ }
38
+
39
+ start(framework) {
40
+ // 初始化存储
41
+ if (this.config.type === 'json') {
42
+ this._initJsonStore()
43
+ }
44
+
45
+ // 注册存储工具
46
+ framework.registerTool({
47
+ name: 'storage_set',
48
+ description: '存储数据到键值存储',
49
+ inputSchema: z.object({
50
+ key: z.string().describe('存储键名'),
51
+ value: z.any().describe('存储值'),
52
+ namespace: z.string().optional().describe('命名空间,默认使用全局命名空间')
53
+ }),
54
+ execute: async (args) => {
55
+ try {
56
+ const ns = args.namespace || this.config.namespace
57
+ const fullKey = `${ns}:${args.key}`
58
+ this._store.set(fullKey, {
59
+ value: args.value,
60
+ updatedAt: new Date()
61
+ })
62
+
63
+ if (this.config.type === 'json') {
64
+ await this._persistToFile()
65
+ }
66
+
67
+ return { success: true, key: args.key, namespace: ns }
68
+ } catch (err) {
69
+ return { success: false, error: err.message }
70
+ }
71
+ }
72
+ })
73
+
74
+ framework.registerTool({
75
+ name: 'storage_get',
76
+ description: '从键值存储获取数据',
77
+ inputSchema: z.object({
78
+ key: z.string().describe('存储键名'),
79
+ namespace: z.string().optional().describe('命名空间')
80
+ }),
81
+ execute: async (args) => {
82
+ const ns = args.namespace || this.config.namespace
83
+ const fullKey = `${ns}:${args.key}`
84
+ const entry = this._store.get(fullKey)
85
+
86
+ if (!entry) {
87
+ return { success: false, error: 'Key not found', key: args.key }
88
+ }
89
+
90
+ return {
91
+ success: true,
92
+ key: args.key,
93
+ namespace: ns,
94
+ value: entry.value,
95
+ updatedAt: entry.updatedAt
96
+ }
97
+ }
98
+ })
99
+
100
+ framework.registerTool({
101
+ name: 'storage_delete',
102
+ description: '删除存储的数据',
103
+ inputSchema: z.object({
104
+ key: z.string().describe('存储键名'),
105
+ namespace: z.string().optional().describe('命名空间')
106
+ }),
107
+ execute: async (args) => {
108
+ const ns = args.namespace || this.config.namespace
109
+ const fullKey = `${ns}:${args.key}`
110
+ const existed = this._store.has(fullKey)
111
+ this._store.delete(fullKey)
112
+
113
+ if (this.config.type === 'json') {
114
+ await this._persistToFile()
115
+ }
116
+
117
+ return { success: true, deleted: existed, key: args.key }
118
+ }
119
+ })
120
+
121
+ framework.registerTool({
122
+ name: 'storage_list',
123
+ description: '列出命名空间下的所有键',
124
+ inputSchema: z.object({
125
+ namespace: z.string().optional().describe('命名空间,默认全局')
126
+ }),
127
+ execute: async (args) => {
128
+ const ns = args.namespace || this.config.namespace
129
+ const prefix = `${ns}:`
130
+ const keys = []
131
+
132
+ for (const key of this._store.keys()) {
133
+ if (key.startsWith(prefix)) {
134
+ keys.push(key.substring(prefix.length))
135
+ }
136
+ }
137
+
138
+ return {
139
+ success: true,
140
+ namespace: ns,
141
+ keys,
142
+ count: keys.length
143
+ }
144
+ }
145
+ })
146
+
147
+ framework.registerTool({
148
+ name: 'storage_clear',
149
+ description: '清空命名空间下的所有数据',
150
+ inputSchema: z.object({
151
+ namespace: z.string().optional().describe('命名空间,默认全局')
152
+ }),
153
+ execute: async (args) => {
154
+ const ns = args.namespace || this.config.namespace
155
+ const prefix = `${ns}:`
156
+ let count = 0
157
+
158
+ for (const key of this._store.keys()) {
159
+ if (key.startsWith(prefix)) {
160
+ this._store.delete(key)
161
+ count++
162
+ }
163
+ }
164
+
165
+ if (this.config.type === 'json') {
166
+ await this._persistToFile()
167
+ }
168
+
169
+ return { success: true, namespace: ns, cleared: count }
170
+ }
171
+ })
172
+
173
+ return this
174
+ }
175
+
176
+ /**
177
+ * 初始化 JSON 文件存储
178
+ */
179
+ _initJsonStore() {
180
+ this._filePath = path.resolve(process.cwd(), this.config.path, `${this.config.namespace}.json`)
181
+
182
+ // 确保目录存在
183
+ const dir = path.dirname(this._filePath)
184
+ if (!fs.existsSync(dir)) {
185
+ fs.mkdirSync(dir, { recursive: true })
186
+ }
187
+
188
+ // 加载已有数据
189
+ if (fs.existsSync(this._filePath)) {
190
+ try {
191
+ const content = fs.readFileSync(this._filePath, 'utf-8')
192
+ const data = JSON.parse(content)
193
+
194
+ for (const [key, entry] of Object.entries(data)) {
195
+ this._store.set(key, entry)
196
+ }
197
+
198
+ log.info(` Loaded ${this._store.size} entries from ${this._filePath}`)
199
+ } catch (err) {
200
+ log.warn(` Failed to load storage file: ${err.message}`)
201
+ }
202
+ }
203
+ }
204
+
205
+ /**
206
+ * 持久化到文件
207
+ */
208
+ async _persistToFile() {
209
+ if (!this._filePath) return
210
+
211
+ try {
212
+ const data = Object.fromEntries(this._store)
213
+ fs.writeFileSync(this._filePath, JSON.stringify(data, null, 2), 'utf-8')
214
+ } catch (err) {
215
+ log.error(` Failed to persist: ${err.message}`)
216
+ }
217
+ }
218
+
219
+ /**
220
+ * 获取存储实例(供其他插件使用)
221
+ */
222
+ getStore() {
223
+ return this._store
224
+ }
225
+
226
+ /**
227
+ * 直接设置值并自动持久化(供其他插件使用)
228
+ * @param {string} key - 键
229
+ * @param {any} value - 值
230
+ */
231
+ setDirect(key, value) {
232
+ this._store.set(key, value)
233
+ if (this.config.type === 'json') {
234
+ this._persistToFile()
235
+ }
236
+ }
237
+
238
+ /**
239
+ * 删除键并自动持久化(供其他插件使用)
240
+ * @param {string} key - 键
241
+ */
242
+ deleteDirect(key) {
243
+ this._store.delete(key)
244
+ if (this.config.type === 'json') {
245
+ this._persistToFile()
246
+ }
247
+ }
248
+
249
+ reload(framework) {
250
+ this._framework = framework
251
+ this._store.clear()
252
+
253
+ if (this.config.type === 'json') {
254
+ this._initJsonStore()
255
+ }
256
+ }
257
+
258
+ uninstall(framework) {
259
+ this._store.clear()
260
+ this._framework = null
261
+ }
262
+ }
263
+
264
264
  module.exports = StoragePlugin