foliko 1.0.75 → 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.
- package/.claude/settings.local.json +159 -157
- package/cli/bin/foliko.js +12 -12
- package/cli/src/commands/chat.js +143 -143
- package/cli/src/commands/list.js +93 -93
- package/cli/src/index.js +75 -75
- package/cli/src/ui/chat-ui.js +201 -201
- package/cli/src/utils/ansi.js +40 -40
- package/cli/src/utils/markdown.js +292 -292
- package/examples/ambient-example.js +194 -194
- package/examples/basic.js +115 -115
- package/examples/bootstrap.js +121 -121
- package/examples/mcp-example.js +56 -56
- package/examples/skill-example.js +49 -49
- package/examples/test-chat.js +137 -137
- package/examples/test-mcp.js +85 -85
- package/examples/test-reload.js +59 -59
- package/examples/test-telegram.js +50 -50
- package/examples/test-tg-bot.js +45 -45
- package/examples/test-tg-simple.js +47 -47
- package/examples/test-tg.js +62 -62
- package/examples/test-think.js +43 -43
- package/examples/test-web-plugin.js +103 -103
- package/examples/test-weixin-feishu.js +103 -103
- package/examples/workflow.js +158 -158
- package/package.json +1 -1
- package/plugins/ai-plugin.js +102 -102
- package/plugins/ambient-agent/EventWatcher.js +113 -113
- package/plugins/ambient-agent/ExplorerLoop.js +640 -640
- package/plugins/ambient-agent/GoalManager.js +197 -197
- package/plugins/ambient-agent/Reflector.js +95 -95
- package/plugins/ambient-agent/StateStore.js +90 -90
- package/plugins/ambient-agent/constants.js +101 -101
- package/plugins/ambient-agent/index.js +579 -579
- package/plugins/audit-plugin.js +187 -187
- package/plugins/default-plugins.js +662 -662
- package/plugins/email/constants.js +64 -64
- package/plugins/email/handlers.js +461 -461
- package/plugins/email/index.js +278 -278
- package/plugins/email/monitor.js +269 -269
- package/plugins/email/parser.js +138 -138
- package/plugins/email/reply.js +151 -151
- package/plugins/email/utils.js +124 -124
- package/plugins/feishu-plugin.js +481 -481
- package/plugins/file-system-plugin.js +826 -826
- package/plugins/install-plugin.js +199 -199
- package/plugins/python-executor-plugin.js +367 -367
- package/plugins/python-plugin-loader.js +481 -481
- package/plugins/rules-plugin.js +294 -294
- package/plugins/scheduler-plugin.js +691 -691
- package/plugins/session-plugin.js +369 -369
- package/plugins/shell-executor-plugin.js +197 -197
- package/plugins/storage-plugin.js +240 -240
- package/plugins/subagent-plugin.js +845 -845
- package/plugins/telegram-plugin.js +482 -482
- package/plugins/think-plugin.js +345 -345
- package/plugins/tools-plugin.js +196 -196
- package/plugins/web-plugin.js +606 -606
- package/plugins/weixin-plugin.js +545 -545
- package/src/capabilities/index.js +11 -11
- package/src/capabilities/skill-manager.js +609 -609
- package/src/capabilities/workflow-engine.js +1109 -1109
- package/src/core/agent-chat.js +882 -882
- package/src/core/agent.js +892 -892
- package/src/core/framework.js +465 -465
- package/src/core/index.js +19 -19
- package/src/core/plugin-base.js +219 -219
- package/src/core/plugin-manager.js +863 -863
- package/src/core/provider.js +114 -114
- package/src/core/sub-agent-config.js +264 -264
- package/src/core/system-prompt-builder.js +120 -120
- package/src/core/tool-registry.js +517 -517
- package/src/core/tool-router.js +297 -297
- package/src/executors/executor-base.js +58 -58
- package/src/executors/mcp-executor.js +741 -741
- package/src/index.js +25 -25
- package/src/utils/circuit-breaker.js +301 -301
- package/src/utils/error-boundary.js +363 -363
- package/src/utils/error.js +374 -374
- package/src/utils/event-emitter.js +97 -97
- package/src/utils/id.js +133 -133
- package/src/utils/index.js +217 -217
- package/src/utils/logger.js +181 -181
- package/src/utils/plugin-helpers.js +90 -90
- package/src/utils/retry.js +122 -122
- package/src/utils/sandbox.js +292 -292
- package/test/tool-registry-validation.test.js +218 -218
- package/website/script.js +136 -136
- package/foliko-1.0.75.tgz +0 -0
package/src/utils/logger.js
CHANGED
|
@@ -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
|
+
};
|