feat: 实现@tool协议完整功能 - JavaScript工具执行框架

 核心功能
- 新增ToolProtocol处理器,支持@tool://协议解析
- 实现PromptXToolCommand,统一MCP/CLI工具调用
- 完善ToolExecutor,支持工具实例化和参数验证
- 新增calculator和send-email示例工具

🔧 技术改进
- 优化PackageDiscovery统一资源扫描逻辑
- 增强CrossPlatformFileScanner支持.tool.js文件
- 完善ResourceManager集成ToolProtocol
- 更新MCP工具定义支持promptx_tool

📋 详细变更
Core:
- src/lib/core/resource/protocols/ToolProtocol.js: 新增工具协议处理器
- src/lib/commands/PromptXToolCommand.js: 新增工具命令处理器
- src/lib/tool/ToolExecutor.js: 增强工具执行器兼容性

Discovery:
- src/lib/core/resource/discovery/PackageDiscovery.js: 统一资源扫描
- src/lib/core/resource/discovery/CrossPlatformFileScanner.js: 支持tool文件
- src/lib/core/resource/discovery/ProjectDiscovery.js: 增加tool验证

Integration:
- src/lib/core/resource/resourceManager.js: 集成ToolProtocol
- src/lib/mcp/toolDefinitions.js: 新增promptx_tool定义
- src/lib/commands/MCPServerCommand.js: 支持tool参数转换
- src/bin/promptx.js: 新增tool命令行支持

Tools:
- prompt/tool/calculator.tool.js: 数学计算工具示例
- prompt/tool/send-email.tool.js: 邮件发送工具示例

Registry:
- src/package.registry.json: 自动生成包含2个tool资源

🧪 测试验证
-  @tool://calculator 数学计算: 25 + 37 = 62
-  @tool://send-email 邮件发送演示版本
-  CLI和MCP双模式支持
-  完整的错误处理和执行元数据
-  资源自动发现和注册

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
sean
2025-06-28 14:15:24 +08:00
parent 70093018f8
commit 40e0c01c59
17 changed files with 1725 additions and 646 deletions

View File

@ -96,6 +96,44 @@ program
}
})
// Tool命令
program
.command('tool <arguments>')
.description('🔧 tool锦囊 - 执行通过@tool协议声明的JavaScript工具')
.action(async (argumentsJson, options) => {
try {
let args = {};
// 支持两种调用方式:
// 1. 从MCP传来的对象通过cli.execute调用
// 2. 从CLI传来的JSON字符串直接命令行调用
if (typeof argumentsJson === 'object') {
args = argumentsJson;
} else if (typeof argumentsJson === 'string') {
try {
args = JSON.parse(argumentsJson);
} catch (error) {
console.error('❌ 参数解析错误请提供有效的JSON格式');
console.error('格式示例: \'{"tool_resource": "@tool://calculator", "parameters": {"operation": "add", "a": 25, "b": 37}}\'');
process.exit(1);
}
}
// 验证必需参数
if (!args.tool_resource || !args.parameters) {
console.error('❌ 缺少必需参数');
console.error('必需参数: tool_resource (工具资源引用), parameters (工具参数)');
console.error('格式示例: \'{"tool_resource": "@tool://calculator", "parameters": {"operation": "add", "a": 25, "b": 37}}\'');
process.exit(1);
}
await cli.execute('tool', args);
} catch (error) {
console.error(`❌ Tool命令执行失败: ${error.message}`);
process.exit(1);
}
})
// MCP Server命令
program
.command('mcp-server')