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,366 +1,368 @@
1
- /**
2
- * Python 执行器插件
3
- * 使用 child_process 执行 Python 代码和脚本
4
- */
5
-
6
- const { Plugin } = require('../src/core/plugin-base')
7
- const { spawn } = require('child_process')
8
- const fs = require('fs')
9
- const path = require('path')
10
- const os = require('os')
11
- const { z } = require('zod')
12
-
13
- class PythonExecutorPlugin extends Plugin {
14
- constructor(config = {}) {
15
- super()
16
- this.name = 'python-executor'
17
- this.version = '1.0.0'
18
- this.description = 'Python 执行器,用于运行 Python 代码和脚本,禁止传入无用的emoji'
19
- this.priority = 15
20
-
21
- this.config = {
22
- pythonPath: config.pythonPath || 'python', // python 或 python3
23
- timeout: config.timeout || 120000, // 2分钟超时
24
- baseDir: config.baseDir || '.agent/python-scripts',
25
- pipPath: config.pipPath || null // 可选,自定义 pip 路径
26
- }
27
-
28
- this.system = true
29
-
30
- this._framework = null
31
- this._tempDir = null
32
- }
33
-
34
- install(framework) {
35
- this._framework = framework
36
-
37
- // 确保临时目录存在
38
- this._tempDir = path.join(os.tmpdir(), `vb-python-${process.pid}`)
39
- if (!fs.existsSync(this._tempDir)) {
40
- fs.mkdirSync(this._tempDir, { recursive: true })
41
- }
42
-
43
- return this
44
- }
45
-
46
- start(framework) {
47
- // 注册 python-execute 工具
48
- framework.registerTool({
49
- name: 'python-execute',
50
- description: '执行 Python 代码,禁止传入无用的emoji',
51
- inputSchema: z.object({
52
- code: z.string().describe('Python 代码'),
53
- timeout: z.number().optional().describe('超时时间(毫秒),默认 120000'),
54
- input_data: z.record(z.any()).optional().describe('输入数据对象,可在代码中通过 input_data.get("key") 访问')
55
- }),
56
- execute: async (args) => {
57
- return this._executePython(args.code, args.timeout || this.config.timeout, args.input_data)
58
- }
59
- })
60
-
61
- // 注册 python_script 工具
62
- framework.registerTool({
63
- name: 'python_script',
64
- description: '执行 Python 脚本文件',
65
- inputSchema: z.object({
66
- scriptPath: z.string().describe('Python 脚本文件路径'),
67
- args: z.string().optional().describe('传递给脚本的命令行参数'),
68
- timeout: z.number().optional().describe('超时时间(毫秒)')
69
- }),
70
- execute: async (args) => {
71
- return this._executeScript(args.scriptPath, args.args, args.timeout || this.config.timeout)
72
- }
73
- })
74
-
75
- // 注册 pip_install 工具
76
- framework.registerTool({
77
- name: 'pip_install',
78
- description: '安装 Python 包',
79
- inputSchema: z.object({
80
- package: z.string().describe('包名 (例如: numpy, pandas>=1.0)'),
81
- upgrade: z.boolean().optional().describe('是否升级已存在的包'),
82
- timeout: z.number().optional().describe('超时时间(毫秒)')
83
- }),
84
- execute: async (args) => {
85
- return this._pipInstall(args.package, args.upgrade, args.timeout || this.config.timeout)
86
- }
87
- })
88
-
89
- return this
90
- }
91
-
92
- /**
93
- * 执行 Python 代码
94
- * @private
95
- */
96
- _executePython(code, timeout, inputData) {
97
- return new Promise((resolve) => {
98
- const startTime = Date.now()
99
- let output = ''
100
- let errorOutput = ''
101
-
102
- // 创建临时脚本文件
103
- const tempFile = path.join(this._tempDir, `temp_${Date.now()}.py`)
104
-
105
- // 注入 input_data 变量
106
- let inputDataSetup = ''
107
- if (inputData) {
108
- const inputDataJson = JSON.stringify(inputData).replace(/'/g, "\\'")
109
- inputDataSetup = `import json\ninput_data = json.loads('${inputDataJson}')\n`
110
- } else {
111
- inputDataSetup = `input_data = {}\n`
112
- }
113
-
114
- // 包装代码,添加错误处理
115
- const wrappedCode = `
116
- import sys
117
- import traceback
118
- ${inputDataSetup}
119
- try:
120
- ${code.split('\n').map(line => ' ' + line).join('\n')}
121
- except SystemExit:
122
- pass
123
- except Exception:
124
- traceback.print_exc()
125
- sys.exit(1)
126
- `
127
-
128
- fs.writeFileSync(tempFile, wrappedCode, 'utf-8')
129
-
130
- const proc = spawn(this.config.pythonPath, [tempFile], {
131
- timeout,
132
- env: { ...process.env }
133
- })
134
-
135
- proc.stdout.on('data', (data) => {
136
- output += data.toString()
137
- })
138
-
139
- proc.stderr.on('data', (data) => {
140
- errorOutput += data.toString()
141
- })
142
-
143
- proc.on('close', (code) => {
144
- // 清理临时文件
145
- try {
146
- fs.unlinkSync(tempFile)
147
- } catch (e) { }
148
-
149
- const elapsed = Date.now() - startTime
150
-
151
- // 限制返回数据大小,避免上下文超限(限制为 5000 字符)
152
- const MAX_OUTPUT_LENGTH = 5000
153
- let truncatedOutput = output
154
- let truncated = false
155
- if (output.length > MAX_OUTPUT_LENGTH) {
156
- truncatedOutput = output.substring(0, MAX_OUTPUT_LENGTH) + `\n... [输出已截断,总长度 ${output.length} 字符]`
157
- truncated = true
158
- }
159
-
160
- resolve({
161
- success: code === 0,
162
- exitCode: code,
163
- stdout: truncatedOutput,
164
- stderr: errorOutput.length > MAX_OUTPUT_LENGTH
165
- ? errorOutput.substring(0, MAX_OUTPUT_LENGTH) + `\n... [错误输出已截断]`
166
- : errorOutput,
167
- elapsed,
168
- timedOut: code === null,
169
- truncated
170
- })
171
- })
172
-
173
- proc.on('error', (err) => {
174
- // 清理临时文件
175
- try {
176
- fs.unlinkSync(tempFile)
177
- } catch (e) { }
178
-
179
- resolve({
180
- success: false,
181
- error: err.message
182
- })
183
- })
184
-
185
- setTimeout(() => {
186
- if (!proc.killed) {
187
- proc.kill('SIGTERM')
188
- try {
189
- fs.unlinkSync(tempFile)
190
- } catch (e) { }
191
-
192
- // 限制返回数据大小
193
- const MAX_OUTPUT_LENGTH = 5000
194
- const truncatedOutput = output.length > MAX_OUTPUT_LENGTH
195
- ? output.substring(0, MAX_OUTPUT_LENGTH) + `\n... [输出已截断,总长度 ${output.length} 字符]`
196
- : output
197
-
198
- resolve({
199
- success: false,
200
- error: `Python execution timed out after ${timeout}ms`,
201
- stdout: truncatedOutput,
202
- stderr: errorOutput.length > MAX_OUTPUT_LENGTH
203
- ? errorOutput.substring(0, MAX_OUTPUT_LENGTH) + `\n... [错误输出已截断]`
204
- : errorOutput,
205
- timedOut: true
206
- })
207
- }
208
- }, timeout)
209
- })
210
- }
211
-
212
- /**
213
- * 执行 Python 脚本文件
214
- * @private
215
- */
216
- _executeScript(scriptPath, args, timeout) {
217
- return new Promise((resolve) => {
218
- const startTime = Date.now()
219
- let output = ''
220
- let errorOutput = ''
221
-
222
- // 检查文件是否存在
223
- if (!fs.existsSync(scriptPath)) {
224
- resolve({
225
- success: false,
226
- error: `Script file not found: ${scriptPath}`
227
- })
228
- return
229
- }
230
-
231
- const procArgs = [scriptPath]
232
- if (args) {
233
- procArgs.push(...args.split(' '))
234
- }
235
-
236
- const proc = spawn(this.config.pythonPath, procArgs, {
237
- timeout,
238
- env: { ...process.env }
239
- })
240
-
241
- proc.stdout.on('data', (data) => {
242
- output += data.toString()
243
- })
244
-
245
- proc.stderr.on('data', (data) => {
246
- errorOutput += data.toString()
247
- })
248
-
249
- proc.on('close', (code) => {
250
- const elapsed = Date.now() - startTime
251
- resolve({
252
- success: code === 0,
253
- exitCode: code,
254
- stdout: output,
255
- stderr: errorOutput,
256
- elapsed,
257
- timedOut: code === null
258
- })
259
- })
260
-
261
- proc.on('error', (err) => {
262
- resolve({
263
- success: false,
264
- error: err.message
265
- })
266
- })
267
-
268
- setTimeout(() => {
269
- if (!proc.killed) {
270
- proc.kill('SIGTERM')
271
- resolve({
272
- success: false,
273
- error: `Script execution timed out after ${timeout}ms`,
274
- stdout: output,
275
- stderr: errorOutput,
276
- timedOut: true
277
- })
278
- }
279
- }, timeout)
280
- })
281
- }
282
-
283
- /**
284
- * 安装 Python 包
285
- * @private
286
- */
287
- _pipInstall(packageName, upgrade, timeout) {
288
- return new Promise((resolve) => {
289
- const startTime = Date.now()
290
- let output = ''
291
- let errorOutput = ''
292
-
293
- const pipPath = this.config.pipPath || this.config.pythonPath.replace('python', 'pip')
294
- const args = [packageName]
295
- if (upgrade) args.unshift('-U')
296
- if (upgrade === undefined && packageName.includes('>=')) args.unshift('-U')
297
-
298
- const proc = spawn(pipPath, ['install', ...args], {
299
- timeout,
300
- env: { ...process.env }
301
- })
302
-
303
- proc.stdout.on('data', (data) => {
304
- output += data.toString()
305
- })
306
-
307
- proc.stderr.on('data', (data) => {
308
- errorOutput += data.toString()
309
- })
310
-
311
- proc.on('close', (code) => {
312
- const elapsed = Date.now() - startTime
313
- resolve({
314
- success: code === 0,
315
- exitCode: code,
316
- stdout: output,
317
- stderr: errorOutput,
318
- elapsed,
319
- package: packageName,
320
- upgraded: upgrade || packageName.includes('>=')
321
- })
322
- })
323
-
324
- proc.on('error', (err) => {
325
- resolve({
326
- success: false,
327
- error: err.message,
328
- package: packageName
329
- })
330
- })
331
-
332
- setTimeout(() => {
333
- if (!proc.killed) {
334
- proc.kill('SIGTERM')
335
- resolve({
336
- success: false,
337
- error: `pip install timed out after ${timeout}ms`,
338
- stdout: output,
339
- stderr: errorOutput,
340
- timedOut: true,
341
- package: packageName
342
- })
343
- }
344
- }, timeout)
345
- })
346
- }
347
-
348
- reload(framework) {
349
- this._framework = framework
350
- }
351
-
352
- uninstall(framework) {
353
- // 清理临时目录
354
- if (this._tempDir && fs.existsSync(this._tempDir)) {
355
- try {
356
- fs.rmSync(this._tempDir, { recursive: true, force: true })
357
- } catch (e) {
358
- console.warn(`[PythonExecutor] Failed to cleanup temp dir: ${e.message}`)
359
- }
360
- }
361
- this._framework = null
362
- this._tempDir = null
363
- }
364
- }
365
-
1
+ /**
2
+ * Python 执行器插件
3
+ * 使用 child_process 执行 Python 代码和脚本
4
+ */
5
+
6
+ const { Plugin } = require('../src/core/plugin-base')
7
+ const { logger } = require('../src/utils/logger')
8
+ const log = logger.child('PythonExecutor')
9
+ const { spawn } = require('child_process')
10
+ const fs = require('fs')
11
+ const path = require('path')
12
+ const os = require('os')
13
+ const { z } = require('zod')
14
+
15
+ class PythonExecutorPlugin extends Plugin {
16
+ constructor(config = {}) {
17
+ super()
18
+ this.name = 'python-executor'
19
+ this.version = '1.0.0'
20
+ this.description = 'Python 执行器,用于运行 Python 代码和脚本,禁止传入无用的emoji'
21
+ this.priority = 15
22
+
23
+ this.config = {
24
+ pythonPath: config.pythonPath || 'python', // python 或 python3
25
+ timeout: config.timeout || 120000, // 2分钟超时
26
+ baseDir: config.baseDir || '.agent/python-scripts',
27
+ pipPath: config.pipPath || null // 可选,自定义 pip 路径
28
+ }
29
+
30
+ this.system = true
31
+
32
+ this._framework = null
33
+ this._tempDir = null
34
+ }
35
+
36
+ install(framework) {
37
+ this._framework = framework
38
+
39
+ // 确保临时目录存在
40
+ this._tempDir = path.join(os.tmpdir(), `vb-python-${process.pid}`)
41
+ if (!fs.existsSync(this._tempDir)) {
42
+ fs.mkdirSync(this._tempDir, { recursive: true })
43
+ }
44
+
45
+ return this
46
+ }
47
+
48
+ start(framework) {
49
+ // 注册 python-execute 工具
50
+ framework.registerTool({
51
+ name: 'python-execute',
52
+ description: '执行 Python 代码,禁止传入无用的emoji',
53
+ inputSchema: z.object({
54
+ code: z.string().describe('Python 代码'),
55
+ timeout: z.number().optional().describe('超时时间(毫秒),默认 120000'),
56
+ input_data: z.record(z.any()).optional().describe('输入数据对象,可在代码中通过 input_data.get("key") 访问')
57
+ }),
58
+ execute: async (args) => {
59
+ return this._executePython(args.code, args.timeout || this.config.timeout, args.input_data)
60
+ }
61
+ })
62
+
63
+ // 注册 python_script 工具
64
+ framework.registerTool({
65
+ name: 'python_script',
66
+ description: '执行 Python 脚本文件',
67
+ inputSchema: z.object({
68
+ scriptPath: z.string().describe('Python 脚本文件路径'),
69
+ args: z.string().optional().describe('传递给脚本的命令行参数'),
70
+ timeout: z.number().optional().describe('超时时间(毫秒)')
71
+ }),
72
+ execute: async (args) => {
73
+ return this._executeScript(args.scriptPath, args.args, args.timeout || this.config.timeout)
74
+ }
75
+ })
76
+
77
+ // 注册 pip_install 工具
78
+ framework.registerTool({
79
+ name: 'pip_install',
80
+ description: '安装 Python ',
81
+ inputSchema: z.object({
82
+ package: z.string().describe('包名 (例如: numpy, pandas>=1.0)'),
83
+ upgrade: z.boolean().optional().describe('是否升级已存在的包'),
84
+ timeout: z.number().optional().describe('超时时间(毫秒)')
85
+ }),
86
+ execute: async (args) => {
87
+ return this._pipInstall(args.package, args.upgrade, args.timeout || this.config.timeout)
88
+ }
89
+ })
90
+
91
+ return this
92
+ }
93
+
94
+ /**
95
+ * 执行 Python 代码
96
+ * @private
97
+ */
98
+ _executePython(code, timeout, inputData) {
99
+ return new Promise((resolve) => {
100
+ const startTime = Date.now()
101
+ let output = ''
102
+ let errorOutput = ''
103
+
104
+ // 创建临时脚本文件
105
+ const tempFile = path.join(this._tempDir, `temp_${Date.now()}.py`)
106
+
107
+ // 注入 input_data 变量
108
+ let inputDataSetup = ''
109
+ if (inputData) {
110
+ const inputDataJson = JSON.stringify(inputData).replace(/'/g, "\\'")
111
+ inputDataSetup = `import json\ninput_data = json.loads('${inputDataJson}')\n`
112
+ } else {
113
+ inputDataSetup = `input_data = {}\n`
114
+ }
115
+
116
+ // 包装代码,添加错误处理
117
+ const wrappedCode = `
118
+ import sys
119
+ import traceback
120
+ ${inputDataSetup}
121
+ try:
122
+ ${code.split('\n').map(line => ' ' + line).join('\n')}
123
+ except SystemExit:
124
+ pass
125
+ except Exception:
126
+ traceback.print_exc()
127
+ sys.exit(1)
128
+ `
129
+
130
+ fs.writeFileSync(tempFile, wrappedCode, 'utf-8')
131
+
132
+ const proc = spawn(this.config.pythonPath, [tempFile], {
133
+ timeout,
134
+ env: { ...process.env }
135
+ })
136
+
137
+ proc.stdout.on('data', (data) => {
138
+ output += data.toString()
139
+ })
140
+
141
+ proc.stderr.on('data', (data) => {
142
+ errorOutput += data.toString()
143
+ })
144
+
145
+ proc.on('close', (code) => {
146
+ // 清理临时文件
147
+ try {
148
+ fs.unlinkSync(tempFile)
149
+ } catch (e) { }
150
+
151
+ const elapsed = Date.now() - startTime
152
+
153
+ // 限制返回数据大小,避免上下文超限(限制为 5000 字符)
154
+ const MAX_OUTPUT_LENGTH = 5000
155
+ let truncatedOutput = output
156
+ let truncated = false
157
+ if (output.length > MAX_OUTPUT_LENGTH) {
158
+ truncatedOutput = output.substring(0, MAX_OUTPUT_LENGTH) + `\n... [输出已截断,总长度 ${output.length} 字符]`
159
+ truncated = true
160
+ }
161
+
162
+ resolve({
163
+ success: code === 0,
164
+ exitCode: code,
165
+ stdout: truncatedOutput,
166
+ stderr: errorOutput.length > MAX_OUTPUT_LENGTH
167
+ ? errorOutput.substring(0, MAX_OUTPUT_LENGTH) + `\n... [错误输出已截断]`
168
+ : errorOutput,
169
+ elapsed,
170
+ timedOut: code === null,
171
+ truncated
172
+ })
173
+ })
174
+
175
+ proc.on('error', (err) => {
176
+ // 清理临时文件
177
+ try {
178
+ fs.unlinkSync(tempFile)
179
+ } catch (e) { }
180
+
181
+ resolve({
182
+ success: false,
183
+ error: err.message
184
+ })
185
+ })
186
+
187
+ setTimeout(() => {
188
+ if (!proc.killed) {
189
+ proc.kill('SIGTERM')
190
+ try {
191
+ fs.unlinkSync(tempFile)
192
+ } catch (e) { }
193
+
194
+ // 限制返回数据大小
195
+ const MAX_OUTPUT_LENGTH = 5000
196
+ const truncatedOutput = output.length > MAX_OUTPUT_LENGTH
197
+ ? output.substring(0, MAX_OUTPUT_LENGTH) + `\n... [输出已截断,总长度 ${output.length} 字符]`
198
+ : output
199
+
200
+ resolve({
201
+ success: false,
202
+ error: `Python execution timed out after ${timeout}ms`,
203
+ stdout: truncatedOutput,
204
+ stderr: errorOutput.length > MAX_OUTPUT_LENGTH
205
+ ? errorOutput.substring(0, MAX_OUTPUT_LENGTH) + `\n... [错误输出已截断]`
206
+ : errorOutput,
207
+ timedOut: true
208
+ })
209
+ }
210
+ }, timeout)
211
+ })
212
+ }
213
+
214
+ /**
215
+ * 执行 Python 脚本文件
216
+ * @private
217
+ */
218
+ _executeScript(scriptPath, args, timeout) {
219
+ return new Promise((resolve) => {
220
+ const startTime = Date.now()
221
+ let output = ''
222
+ let errorOutput = ''
223
+
224
+ // 检查文件是否存在
225
+ if (!fs.existsSync(scriptPath)) {
226
+ resolve({
227
+ success: false,
228
+ error: `Script file not found: ${scriptPath}`
229
+ })
230
+ return
231
+ }
232
+
233
+ const procArgs = [scriptPath]
234
+ if (args) {
235
+ procArgs.push(...args.split(' '))
236
+ }
237
+
238
+ const proc = spawn(this.config.pythonPath, procArgs, {
239
+ timeout,
240
+ env: { ...process.env }
241
+ })
242
+
243
+ proc.stdout.on('data', (data) => {
244
+ output += data.toString()
245
+ })
246
+
247
+ proc.stderr.on('data', (data) => {
248
+ errorOutput += data.toString()
249
+ })
250
+
251
+ proc.on('close', (code) => {
252
+ const elapsed = Date.now() - startTime
253
+ resolve({
254
+ success: code === 0,
255
+ exitCode: code,
256
+ stdout: output,
257
+ stderr: errorOutput,
258
+ elapsed,
259
+ timedOut: code === null
260
+ })
261
+ })
262
+
263
+ proc.on('error', (err) => {
264
+ resolve({
265
+ success: false,
266
+ error: err.message
267
+ })
268
+ })
269
+
270
+ setTimeout(() => {
271
+ if (!proc.killed) {
272
+ proc.kill('SIGTERM')
273
+ resolve({
274
+ success: false,
275
+ error: `Script execution timed out after ${timeout}ms`,
276
+ stdout: output,
277
+ stderr: errorOutput,
278
+ timedOut: true
279
+ })
280
+ }
281
+ }, timeout)
282
+ })
283
+ }
284
+
285
+ /**
286
+ * 安装 Python 包
287
+ * @private
288
+ */
289
+ _pipInstall(packageName, upgrade, timeout) {
290
+ return new Promise((resolve) => {
291
+ const startTime = Date.now()
292
+ let output = ''
293
+ let errorOutput = ''
294
+
295
+ const pipPath = this.config.pipPath || this.config.pythonPath.replace('python', 'pip')
296
+ const args = [packageName]
297
+ if (upgrade) args.unshift('-U')
298
+ if (upgrade === undefined && packageName.includes('>=')) args.unshift('-U')
299
+
300
+ const proc = spawn(pipPath, ['install', ...args], {
301
+ timeout,
302
+ env: { ...process.env }
303
+ })
304
+
305
+ proc.stdout.on('data', (data) => {
306
+ output += data.toString()
307
+ })
308
+
309
+ proc.stderr.on('data', (data) => {
310
+ errorOutput += data.toString()
311
+ })
312
+
313
+ proc.on('close', (code) => {
314
+ const elapsed = Date.now() - startTime
315
+ resolve({
316
+ success: code === 0,
317
+ exitCode: code,
318
+ stdout: output,
319
+ stderr: errorOutput,
320
+ elapsed,
321
+ package: packageName,
322
+ upgraded: upgrade || packageName.includes('>=')
323
+ })
324
+ })
325
+
326
+ proc.on('error', (err) => {
327
+ resolve({
328
+ success: false,
329
+ error: err.message,
330
+ package: packageName
331
+ })
332
+ })
333
+
334
+ setTimeout(() => {
335
+ if (!proc.killed) {
336
+ proc.kill('SIGTERM')
337
+ resolve({
338
+ success: false,
339
+ error: `pip install timed out after ${timeout}ms`,
340
+ stdout: output,
341
+ stderr: errorOutput,
342
+ timedOut: true,
343
+ package: packageName
344
+ })
345
+ }
346
+ }, timeout)
347
+ })
348
+ }
349
+
350
+ reload(framework) {
351
+ this._framework = framework
352
+ }
353
+
354
+ uninstall(framework) {
355
+ // 清理临时目录
356
+ if (this._tempDir && fs.existsSync(this._tempDir)) {
357
+ try {
358
+ fs.rmSync(this._tempDir, { recursive: true, force: true })
359
+ } catch (e) {
360
+ log.warn(` Failed to cleanup temp dir: ${e.message}`)
361
+ }
362
+ }
363
+ this._framework = null
364
+ this._tempDir = null
365
+ }
366
+ }
367
+
366
368
  module.exports = { PythonExecutorPlugin }