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,181 +1,181 @@
1
- /**
2
- * Foliko Logger - 统一日志系统
3
- * 支持日志级别、命名空间、格式化输出
4
- */
5
-
6
- const LOG_LEVELS = {
7
- DEBUG: 0,
8
- INFO: 1,
9
- WARN: 2,
10
- ERROR: 3,
11
- NONE: 4,
12
- };
13
-
14
- const LEVEL_NAMES = ['DEBUG', 'INFO', 'WARN', 'ERROR'];
15
-
16
- class Logger {
17
- /**
18
- * @param {Object} options
19
- * @param {string} options.namespace - 日志命名空间
20
- * @param {number} options.level - 日志级别 (0-4)
21
- * @param {boolean} options.enableTimestamp - 是否显示时间戳
22
- * @param {boolean} options.enableColors - 是否使用颜色
23
- */
24
- constructor(options = {}) {
25
- this.namespace = options.namespace || 'app';
26
- this.level = options.level ?? LOG_LEVELS.INFO;
27
- this.enableTimestamp = options.enableTimestamp !== false;
28
- this.enableColors = options.enableColors !== false;
29
-
30
- // 颜色代码
31
- this.colors = {
32
- debug: '\x1b[36m', // 青色
33
- info: '\x1b[32m', // 绿色
34
- warn: '\x1b[33m', // 黄色
35
- error: '\x1b[31m', // 红色
36
- reset: '\x1b[0m',
37
- dim: '\x1b[2m', // 灰色
38
- };
39
- }
40
-
41
- /**
42
- * 创建子日志器
43
- * @param {string} namespace
44
- * @returns {Logger}
45
- */
46
- child(namespace) {
47
- return new Logger({
48
- namespace: `${this.namespace}:${namespace}`,
49
- level: this.level,
50
- enableTimestamp: this.enableTimestamp,
51
- enableColors: this.enableColors,
52
- });
53
- }
54
-
55
- /**
56
- * 设置日志级别
57
- * @param {string|number} level
58
- */
59
- setLevel(level) {
60
- if (typeof level === 'string') {
61
- this.level = LOG_LEVELS[level.toUpperCase()] ?? LOG_LEVELS.INFO;
62
- } else {
63
- this.level = level;
64
- }
65
- }
66
-
67
- /**
68
- * 格式化日志消息
69
- * @private
70
- */
71
- _format(level, levelName, args) {
72
- const color = this.colors[levelName.toLowerCase()] || '';
73
- const reset = this.colors.reset;
74
- const dim = this.colors.dim;
75
-
76
- const parts = [];
77
-
78
- // 命名空间
79
- parts.push(`${dim}[${this.namespace}]${reset}`);
80
-
81
- // 时间戳
82
- if (this.enableTimestamp) {
83
- const timestamp = new Date().toISOString().split('T')[1].slice(0, -1);
84
- parts.push(`${dim}${timestamp}${reset}`);
85
- }
86
-
87
- // 级别
88
- if (this.enableColors) {
89
- parts.push(`${color}${levelName.padEnd(5)}${reset}`);
90
- } else {
91
- parts.push(levelName.padEnd(5));
92
- }
93
-
94
- // 消息
95
- const message = args
96
- .map((arg) => {
97
- if (arg instanceof Error) {
98
- return `${arg.message}\n${arg.stack}`;
99
- }
100
- if (typeof arg === 'object') {
101
- try {
102
- return JSON.stringify(arg, null, 2);
103
- } catch {
104
- return String(arg);
105
- }
106
- }
107
- return String(arg);
108
- })
109
- .join(' ');
110
-
111
- parts.push(message);
112
- return parts.join(' ');
113
- }
114
-
115
- /**
116
- * 调试日志
117
- * @param {...any} args
118
- */
119
- debug(...args) {
120
- if (this.level <= LOG_LEVELS.DEBUG) {
121
- console.debug(this._format('debug', 'DEBUG', args));
122
- }
123
- }
124
-
125
- /**
126
- * 信息日志
127
- * @param {...any} args
128
- */
129
- info(...args) {
130
- if (this.level <= LOG_LEVELS.INFO) {
131
- console.log(this._format('info', 'INFO', args));
132
- }
133
- }
134
-
135
- /**
136
- * 警告日志
137
- * @param {...any} args
138
- */
139
- warn(...args) {
140
- if (this.level <= LOG_LEVELS.WARN) {
141
- console.warn(this._format('warn', 'WARN', args));
142
- }
143
- }
144
-
145
- /**
146
- * 错误日志
147
- * @param {...any} args
148
- */
149
- error(...args) {
150
- if (this.level <= LOG_LEVELS.ERROR) {
151
- console.error(this._format('error', 'ERROR', args));
152
- }
153
- }
154
-
155
- /**
156
- * 性能计时开始
157
- * @param {string} label
158
- * @returns {function} 结束计时函数
159
- */
160
- timer(label) {
161
- const start = process.hrtime.bigint();
162
- return () => {
163
- const end = process.hrtime.bigint();
164
- const ms = Number(end - start) / 1_000_000;
165
- this.debug(`${label}: ${ms.toFixed(2)}ms`);
166
- };
167
- }
168
- }
169
-
170
- // 全局日志器实例
171
- const globalLogger = new Logger({
172
- namespace: 'foliko',
173
- level: process.env.LOG_LEVEL ? LOG_LEVELS[process.env.LOG_LEVEL.toUpperCase()] : LOG_LEVELS.INFO,
174
- });
175
-
176
- // 导出
177
- module.exports = {
178
- Logger,
179
- logger: globalLogger,
180
- LOG_LEVELS,
181
- };
1
+ /**
2
+ * Foliko Logger - 统一日志系统
3
+ * 支持日志级别、命名空间、格式化输出
4
+ */
5
+
6
+ const LOG_LEVELS = {
7
+ DEBUG: 0,
8
+ INFO: 1,
9
+ WARN: 2,
10
+ ERROR: 3,
11
+ NONE: 4,
12
+ };
13
+
14
+ const LEVEL_NAMES = ['DEBUG', 'INFO', 'WARN', 'ERROR'];
15
+
16
+ class Logger {
17
+ /**
18
+ * @param {Object} options
19
+ * @param {string} options.namespace - 日志命名空间
20
+ * @param {number} options.level - 日志级别 (0-4)
21
+ * @param {boolean} options.enableTimestamp - 是否显示时间戳
22
+ * @param {boolean} options.enableColors - 是否使用颜色
23
+ */
24
+ constructor(options = {}) {
25
+ this.namespace = options.namespace || 'app';
26
+ this.level = options.level ?? LOG_LEVELS.INFO;
27
+ this.enableTimestamp = options.enableTimestamp !== false;
28
+ this.enableColors = options.enableColors !== false;
29
+
30
+ // 颜色代码
31
+ this.colors = {
32
+ debug: '\x1b[36m', // 青色
33
+ info: '\x1b[32m', // 绿色
34
+ warn: '\x1b[33m', // 黄色
35
+ error: '\x1b[31m', // 红色
36
+ reset: '\x1b[0m',
37
+ dim: '\x1b[2m', // 灰色
38
+ };
39
+ }
40
+
41
+ /**
42
+ * 创建子日志器
43
+ * @param {string} namespace
44
+ * @returns {Logger}
45
+ */
46
+ child(namespace) {
47
+ return new Logger({
48
+ namespace: `${this.namespace}:${namespace}`,
49
+ level: this.level,
50
+ enableTimestamp: this.enableTimestamp,
51
+ enableColors: this.enableColors,
52
+ });
53
+ }
54
+
55
+ /**
56
+ * 设置日志级别
57
+ * @param {string|number} level
58
+ */
59
+ setLevel(level) {
60
+ if (typeof level === 'string') {
61
+ this.level = LOG_LEVELS[level.toUpperCase()] ?? LOG_LEVELS.INFO;
62
+ } else {
63
+ this.level = level;
64
+ }
65
+ }
66
+
67
+ /**
68
+ * 格式化日志消息
69
+ * @private
70
+ */
71
+ _format(level, levelName, args) {
72
+ const color = this.colors[levelName.toLowerCase()] || '';
73
+ const reset = this.colors.reset;
74
+ const dim = this.colors.dim;
75
+
76
+ const parts = [];
77
+
78
+ // 命名空间
79
+ parts.push(`${dim}[${this.namespace}]${reset}`);
80
+
81
+ // 时间戳
82
+ if (this.enableTimestamp) {
83
+ const timestamp = new Date().toISOString().split('T')[1].slice(0, -1);
84
+ parts.push(`${dim}${timestamp}${reset}`);
85
+ }
86
+
87
+ // 级别
88
+ if (this.enableColors) {
89
+ parts.push(`${color}${levelName.padEnd(5)}${reset}`);
90
+ } else {
91
+ parts.push(levelName.padEnd(5));
92
+ }
93
+
94
+ // 消息
95
+ const message = args
96
+ .map((arg) => {
97
+ if (arg instanceof Error) {
98
+ return `${arg.message}\n${arg.stack}`;
99
+ }
100
+ if (typeof arg === 'object') {
101
+ try {
102
+ return JSON.stringify(arg, null, 2);
103
+ } catch {
104
+ return String(arg);
105
+ }
106
+ }
107
+ return String(arg);
108
+ })
109
+ .join(' ');
110
+
111
+ parts.push(message);
112
+ return parts.join(' ');
113
+ }
114
+
115
+ /**
116
+ * 调试日志
117
+ * @param {...any} args
118
+ */
119
+ debug(...args) {
120
+ if (this.level <= LOG_LEVELS.DEBUG) {
121
+ console.debug(this._format('debug', 'DEBUG', args));
122
+ }
123
+ }
124
+
125
+ /**
126
+ * 信息日志
127
+ * @param {...any} args
128
+ */
129
+ info(...args) {
130
+ if (this.level <= LOG_LEVELS.INFO) {
131
+ console.log(this._format('info', 'INFO', args));
132
+ }
133
+ }
134
+
135
+ /**
136
+ * 警告日志
137
+ * @param {...any} args
138
+ */
139
+ warn(...args) {
140
+ if (this.level <= LOG_LEVELS.WARN) {
141
+ console.warn(this._format('warn', 'WARN', args));
142
+ }
143
+ }
144
+
145
+ /**
146
+ * 错误日志
147
+ * @param {...any} args
148
+ */
149
+ error(...args) {
150
+ if (this.level <= LOG_LEVELS.ERROR) {
151
+ console.error(this._format('error', 'ERROR', args));
152
+ }
153
+ }
154
+
155
+ /**
156
+ * 性能计时开始
157
+ * @param {string} label
158
+ * @returns {function} 结束计时函数
159
+ */
160
+ timer(label) {
161
+ const start = process.hrtime.bigint();
162
+ return () => {
163
+ const end = process.hrtime.bigint();
164
+ const ms = Number(end - start) / 1_000_000;
165
+ this.debug(`${label}: ${ms.toFixed(2)}ms`);
166
+ };
167
+ }
168
+ }
169
+
170
+ // 全局日志器实例
171
+ const globalLogger = new Logger({
172
+ namespace: 'foliko',
173
+ level: process.env.LOG_LEVEL ? LOG_LEVELS[process.env.LOG_LEVEL.toUpperCase()] : LOG_LEVELS.INFO,
174
+ });
175
+
176
+ // 导出
177
+ module.exports = {
178
+ Logger,
179
+ logger: globalLogger,
180
+ LOG_LEVELS,
181
+ };
@@ -1,90 +1,90 @@
1
- /**
2
- * Plugin Helpers - 插件相关的辅助函数
3
- * 提供插件路径解析和扫描功能,供 PluginManager 和 DefaultPlugins 共用
4
- */
5
-
6
- const fs = require('fs');
7
- const path = require('path');
8
- const { safeJsonParse } = require('./index');
9
-
10
- /**
11
- * 解析插件路径
12
- * 支持两种结构:
13
- * 1. 文件夹结构: .agent/plugins/my-plugin/index.js
14
- * 2. 单文件结构: .agent/plugins/my-plugin.js
15
- * @param {string} pluginsDir - 插件目录
16
- * @param {string} name - 插件名称
17
- * @param {Object} options - 选项
18
- * @param {Object} options.logger - 日志器(可选)
19
- * @returns {{path: string, type: 'folder'|'file'}|null} 插件路径和类型
20
- */
21
- function resolvePluginPath(pluginsDir, name, options = {}) {
22
- const logger = options.logger;
23
- const folderPath = path.join(pluginsDir, name);
24
- const filePath = path.join(pluginsDir, `${name}.js`);
25
-
26
- // 文件夹优先
27
- if (fs.existsSync(folderPath) && fs.statSync(folderPath).isDirectory()) {
28
- const pkgPath = path.join(folderPath, 'package.json');
29
- if (fs.existsSync(pkgPath)) {
30
- try {
31
- const pkg = safeJsonParse(fs.readFileSync(pkgPath, 'utf-8'), {});
32
- const main = pkg.main || 'index.js';
33
- const mainPath = path.join(folderPath, main);
34
- if (fs.existsSync(mainPath)) {
35
- return { path: mainPath, type: 'folder' };
36
- }
37
- } catch (err) {
38
- logger?.warn(`Failed to parse package.json for ${name}:`, err.message);
39
- }
40
- }
41
- // 默认加载 index.js
42
- const indexPath = path.join(folderPath, 'index.js');
43
- if (fs.existsSync(indexPath)) {
44
- return { path: indexPath, type: 'folder' };
45
- }
46
- logger?.warn(`No entry point found for plugin folder: ${name}`);
47
- return null;
48
- }
49
-
50
- // 单文件回退
51
- if (fs.existsSync(filePath)) {
52
- return { path: filePath, type: 'file' };
53
- }
54
-
55
- return null;
56
- }
57
-
58
- /**
59
- * 扫描插件目录,返回所有插件名称
60
- * @param {string} pluginsDir - 插件目录
61
- * @returns {string[]} 插件名称列表
62
- */
63
- function scanPluginNames(pluginsDir) {
64
- if (!fs.existsSync(pluginsDir)) {
65
- return [];
66
- }
67
-
68
- const names = new Set();
69
- const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
70
-
71
- for (const entry of entries) {
72
- if (entry.isDirectory()) {
73
- // 文件夹插件
74
- names.add(entry.name);
75
- } else if (entry.isFile() && entry.name.endsWith('.js')) {
76
- // 单文件插件(排除与文件夹同名的)
77
- const baseName = entry.name.replace(/\.js$/, '');
78
- if (!names.has(baseName)) {
79
- names.add(baseName);
80
- }
81
- }
82
- }
83
-
84
- return Array.from(names);
85
- }
86
-
87
- module.exports = {
88
- resolvePluginPath,
89
- scanPluginNames,
90
- };
1
+ /**
2
+ * Plugin Helpers - 插件相关的辅助函数
3
+ * 提供插件路径解析和扫描功能,供 PluginManager 和 DefaultPlugins 共用
4
+ */
5
+
6
+ const fs = require('fs');
7
+ const path = require('path');
8
+ const { safeJsonParse } = require('./index');
9
+
10
+ /**
11
+ * 解析插件路径
12
+ * 支持两种结构:
13
+ * 1. 文件夹结构: .agent/plugins/my-plugin/index.js
14
+ * 2. 单文件结构: .agent/plugins/my-plugin.js
15
+ * @param {string} pluginsDir - 插件目录
16
+ * @param {string} name - 插件名称
17
+ * @param {Object} options - 选项
18
+ * @param {Object} options.logger - 日志器(可选)
19
+ * @returns {{path: string, type: 'folder'|'file'}|null} 插件路径和类型
20
+ */
21
+ function resolvePluginPath(pluginsDir, name, options = {}) {
22
+ const logger = options.logger;
23
+ const folderPath = path.join(pluginsDir, name);
24
+ const filePath = path.join(pluginsDir, `${name}.js`);
25
+
26
+ // 文件夹优先
27
+ if (fs.existsSync(folderPath) && fs.statSync(folderPath).isDirectory()) {
28
+ const pkgPath = path.join(folderPath, 'package.json');
29
+ if (fs.existsSync(pkgPath)) {
30
+ try {
31
+ const pkg = safeJsonParse(fs.readFileSync(pkgPath, 'utf-8'), {});
32
+ const main = pkg.main || 'index.js';
33
+ const mainPath = path.join(folderPath, main);
34
+ if (fs.existsSync(mainPath)) {
35
+ return { path: mainPath, type: 'folder' };
36
+ }
37
+ } catch (err) {
38
+ logger?.warn(`Failed to parse package.json for ${name}:`, err.message);
39
+ }
40
+ }
41
+ // 默认加载 index.js
42
+ const indexPath = path.join(folderPath, 'index.js');
43
+ if (fs.existsSync(indexPath)) {
44
+ return { path: indexPath, type: 'folder' };
45
+ }
46
+ logger?.warn(`No entry point found for plugin folder: ${name}`);
47
+ return null;
48
+ }
49
+
50
+ // 单文件回退
51
+ if (fs.existsSync(filePath)) {
52
+ return { path: filePath, type: 'file' };
53
+ }
54
+
55
+ return null;
56
+ }
57
+
58
+ /**
59
+ * 扫描插件目录,返回所有插件名称
60
+ * @param {string} pluginsDir - 插件目录
61
+ * @returns {string[]} 插件名称列表
62
+ */
63
+ function scanPluginNames(pluginsDir) {
64
+ if (!fs.existsSync(pluginsDir)) {
65
+ return [];
66
+ }
67
+
68
+ const names = new Set();
69
+ const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
70
+
71
+ for (const entry of entries) {
72
+ if (entry.isDirectory()) {
73
+ // 文件夹插件
74
+ names.add(entry.name);
75
+ } else if (entry.isFile() && entry.name.endsWith('.js')) {
76
+ // 单文件插件(排除与文件夹同名的)
77
+ const baseName = entry.name.replace(/\.js$/, '');
78
+ if (!names.has(baseName)) {
79
+ names.add(baseName);
80
+ }
81
+ }
82
+ }
83
+
84
+ return Array.from(names);
85
+ }
86
+
87
+ module.exports = {
88
+ resolvePluginPath,
89
+ scanPluginNames,
90
+ };