foliko 1.0.74 → 1.0.76

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