diff --git a/plugins/code_editor.py b/plugins/code_editor.py index 0ba87dd..48b779e 100644 --- a/plugins/code_editor.py +++ b/plugins/code_editor.py @@ -1,5 +1,5 @@ """ -代码工具插件 - 统一的代码编辑与搜索能力 +代码工具 - 统一的代码编辑与搜索能力 合并原 code_editor + code_search,消除重复 """ import os @@ -49,7 +49,7 @@ class Plugin: def get_tool_info(self): return { "name": "code_editor", - "description": "代码编辑与搜索 - 精准替换、批量编辑、代码搜索、符号提取、依赖分析、diff对比", + "description": "代码编辑与搜索 — 精准替换、批量编辑、代码搜索、符号提取、依赖分析、diff对比", "keywords": ["编辑", "修改", "代码", "文件", "edit", "replace", "search", "diff", "find", "grep", "符号", "structure", "imports", "todo", "callers"], "usage": self.usage diff --git a/plugins/tool_search.py b/plugins/tool_search.py index b1fb5e4..a576b1b 100644 --- a/plugins/tool_search.py +++ b/plugins/tool_search.py @@ -1,11 +1,11 @@ """ -工具搜索插件 - 支持按需发现工具 +工具搜索助手 - 支持按需发现工具 """ import json class Liugin: - """工具搜索插件 - 允许 AI 按需搜索和发现可用工具""" + """工具搜索助手 - 允许 AI 按需搜索和发现可用工具""" def __init__(self): self.usage = """工具搜索使用方法: @@ -16,7 +16,7 @@ tool_search <关键词> - 根据关键词搜索可用工具 - tool_search 网络 - 搜索与网络相关的工具 - tool_search 图片 - 搜索与图片相关的工具 -此插件帮助 AI 在需要特定功能时快速找到合适的工具, +此工具帮助 AI 在需要特定功能时快速找到合适的工具, 而不是预加载所有工具到上下文中。""" self.cli = None @@ -27,7 +27,7 @@ tool_search <关键词> - 根据关键词搜索可用工具 def get_tool_info(self): return { "name": "tool_search", - "description": "工具搜索插件,支持按需发现和搜索可用工具。当你不确定有哪些工具可用时,可以使用此工具搜索相关功能的工具。", + "description": "工具搜索助手,支持按需发现和搜索可用工具。当你不确定有哪些工具可用时,可以使用此工具搜索相关功能的工具。", "keywords": ["搜索", "工具", "发现", "search", "tool", "find", "可用工具", "工具列表"], "usage": """tool_search 工具使用说明: JSON格式示例: @@ -45,7 +45,7 @@ JSON格式示例: def get_mcp_definition(self): return { "name": "tool_search", - "description": "工具搜索插件,搜索可用工具的用法和信息", + "description": "工具搜索助手,搜索可用工具的用法和信息", "inputSchema": { "type": "object", "properties": { @@ -120,7 +120,7 @@ JSON格式示例: return "\n".join(result_lines) else: - return "错误:无法访问插件管理器。" + return "错误:无法访问工具管理器。" except Exception as e: return f"工具搜索失败: {str(e)}" \ No newline at end of file diff --git a/xcli_core/cli_core.py b/xcli_core/cli_core.py index 631ff46..2045eba 100644 --- a/xcli_core/cli_core.py +++ b/xcli_core/cli_core.py @@ -100,11 +100,21 @@ class AICLI(BaseAICLI, ClawliMixin, ToolMixin, CodeExecMixin, DisplayMixin, Hist 在调用任何工具之前,你必须先使用 tool_search 查询该工具的详细用法、参数格式和示例。 这是硬性要求,没有例外。即使你认为自己知道工具的用法,也必须先查询确认。 +【⚠️ 工具调用格式 — 必须使用 JSON】 +所有工具都必须通过 JSON 指令调用,格式如下: +{{"action": "use_tool", "tool": "工具名", "args": "操作 参数"}} + +禁止直接写 "工具名 操作 参数",必须包在 JSON 里。 +例如: + ✅ 正确: {{"action": "use_tool", "tool": "code_editor", "args": "find . keyword *.py"}} + ❌ 错误: code_editor find . keyword *.py + ❌ 错误: code_editor("find . keyword *.py") + 执行流程: 第一步:用 tool_search 查询工具用法 -{"action": "use_tool", "tool": "tool_search", "args": "你要用的工具名"} +{{"action": "use_tool", "tool": "tool_search", "args": "你要用的工具名"}} 第二步:阅读 tool_search 返回的详细说明(包括参数格式、操作列表、示例) -第三步:根据返回的说明,正确构造工具调用指令 +第三步:根据返回的说明,用 JSON 格式正确调用工具 为什么要这样做: - 工具的参数格式可能已更新,你的记忆可能过时 @@ -116,17 +126,20 @@ class AICLI(BaseAICLI, ClawliMixin, ToolMixin, CodeExecMixin, DisplayMixin, Hist 用户: "帮我修复 src/app.py 第 10 行的 bug" 你的思考过程: 1. 需要先查看代码 → 先查 code_editor 怎么读取文件 -2. tool_search "code_editor" → 发现 read_range 操作 -3. 调用 code_editor read_range src/app.py 5 15 → 拿到代码 +2. {{"action": "use_tool", "tool": "tool_search", "args": "code_editor"}} → 发现 read_range 操作 +3. {{"action": "use_tool", "tool": "code_editor", "args": "read_range src/app.py 5 15"}} → 拿到代码 4. 需要修改代码 → 已经在第一步查过 code_editor,知道 edit 格式 -5. 调用 code_editor edit src/app.py 旧代码 <<<>>> 新代码 +5. {{"action": "use_tool", "tool": "code_editor", "args": "edit src/app.py +旧代码 +<<<>>> +新代码"}} 示例流程(Git 操作): 用户: "帮我提交代码" 你的思考过程: 1. 需要 git 操作 → 先查 git_tools 怎么用 -2. tool_search "git_tools" → 发现 smart-commit 操作 -3. 调用 git_tools smart-commit → 自动提交""" +2. {{"action": "use_tool", "tool": "tool_search", "args": "git_tools"}} → 发现 smart-commit 操作 +3. {{"action": "use_tool", "tool": "git_tools", "args": "smart-commit"}} → 自动提交""" if liugin_prompts: prompt = f"""{base_prompt} @@ -226,9 +239,9 @@ multi 操作支持一次修改多处: return response.strip() def get_liugin_usage_prompts(self): - """获取插件和技能提示词""" + """获取可用工具提示词""" if not self.liugin_manager.tools: - return "当前没有可用的工具插件." + return "当前没有可用的工具." prompts = [] prompts.append("可用的工具列表:\n") @@ -243,14 +256,14 @@ multi 操作支持一次修改多处: plugins.append(tool) if plugins: - prompts.append("## Plugin 工具(使用 tool_search 查询详细用法):") + prompts.append("## 内置工具(使用 tool_search 查询详细用法):") for tool in plugins: tool_name = tool.get('name', '') tool_desc = tool.get('description', '') prompts.append(f"- {tool_name}: {tool_desc}") if skills: - prompts.append("\n## Agent Skills(已加载详细指令):") + prompts.append("\n## 扩展技能(已加载详细指令):") for tool in skills: tool_name = tool.get('name', '') tool_desc = tool.get('description', '')