# 内置工具清单

用于给智能体提供基本的功能，如文件操作、项目管理、任务管理等。

> 最后更新：2026-06-29
> 更新说明：与实际 `common/tool/` 目录的代码对齐

---

## 文件管理 file

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | read_file | 文件读取 | ✅ 已实现 |
| 2 | write_file | 文件写入 | ✅ 已实现 |
| 3 | edit_file | 文件编辑 | ✅ 已实现 |
| 4 | copy_file | 复制文件 | ✅ 已实现 |
| 5 | cut_file | 剪切文件 | ✅ 已实现 |
| 6 | remove_file | 删除文件 | ✅ 已实现 |
| 7 | make_dir | 创建目录 | ✅ 已实现 |
| 8 | remove_dir | 删除目录 | ✅ 已实现 |
| 9 | search_file | 搜索文件 | ✅ 已实现 |
| 10 | search_dir | 搜索目录 | ✅ 已实现 |
| 11 | grep | 内容搜索 | ✅ 已实现 |
| 12 | glob | 通配符搜索 | ✅ 已实现 |
| 13 | ls | 文件列表 | ✅ 已实现 |
| 14 | read_text | 读取文本文件 | ✅ 已实现 |
| 15 | write_text | 编写文本文件 | ✅ 已实现 |
| 16 | read_doc | 文档阅读 | ✅ 已实现 |
| 17 | search_replace | 搜索替换 | ✅ 已实现 |
| 18 | zip | 压缩文件 | ✅ 已实现 |
| 19 | unzip | 解压文件 | ✅ 已实现 |
| 20 | docx | Word文档读写（Markdown↔docx，生成/读取） | ✅ 已实现 |
| 21 | pdf | PDF文档读取（转Markdown） | ✅ 已实现 |

## 项目管理 project

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | create_project | 创建项目 | ✅ 已实现 |
| 2 | del_project | 删除项目 | ✅ 已实现 |
| 3 | set_project | 修改项目 | ✅ 已实现 |
| 4 | get_project_list | 列出项目 | ✅ 已实现 |
| 5 | get_project_detail | 查看项目详情 | ✅ 已实现 |
| 6 | switch_project | 切换项目 | ✅ 已实现 |

## 任务管理 task

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | create_task | 创建任务 | ✅ 已实现 |
| 2 | del_task | 删除任务 | ✅ 已实现 |
| 3 | get_task_list | 列出任务 | ✅ 已实现 |
| 4 | get_task_detail | 查看任务详情 | ✅ 已实现 |
| 5 | get_agent_tasks | 获取智能体的任务列表 | ✅ 已实现 |
| 6 | set_task_status | 修改任务状态 | ✅ 已实现 |

## 智能体管理 agent

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | create_agent | 创建智能体 | ✅ 已实现 |
| 2 | set_agent | 修改智能体 | ✅ 已实现 |
| 3 | call_agent | 呼叫智能体 | ✅ 已实现 |
| 4 | get_agent_list | 列出智能体 | ✅ 已实现 |
| 5 | get_agent_detail | 查看智能体详情 | ✅ 已实现 |
| 6 | get_agent_status | 获取智能体工作状态 | ✅ 已实现 |
| 7 | assign_agent_work | 分配智能体工作 | ✅ 已实现 |
| 8 | read_agent_prompt | 读取智能体提示词 | ✅ 已实现 |
| 9 | read_agent_stage_prompt | 读取智能体的阶段提示词 | ✅ 已实现 |
| 10 | set_agent_stage | 修改决策阶段 | ✅ 已实现 |

## 技能管理 skill

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | create_skill | 创建技能 | ✅ 已实现 |
| 2 | set_skill | 修改技能 | ✅ 已实现 |
| 3 | get_skill_list | 列出技能 | ✅ 已实现 |
| 4 | get_skill_detail | 查看技能详情 | ✅ 已实现 |
| 5 | read_skill | 读取技能使用说明 | ✅ 已实现 |
| 6 | endow_skills | 赋予技能 | ✅ 已实现 |
| 7 | execute_skill | 执行技能 | ✅ 已实现 |
| 8 | get_agent_skills | 获取智能体的技能列表 | ✅ 已实现 |

> 注：`read_skill_guide` 已由 `read_skill` 替代，功能一致。

## 工具管理 tool

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | create_tool | 创建工具 | ✅ 已实现 |
| 2 | set_tool | 修改工具 | ✅ 已实现 |
| 3 | get_tool_list | 列出工具 | ✅ 已实现 |
| 4 | get_tool_detail | 查看工具详情 | ✅ 已实现 |
| 5 | get_agent_tools | 获取智能体的工具列表 | ✅ 已实现 |
| 6 | provide_tools | 提供工具 | ✅ 已实现 |
| 7 | test_tool | 测试工具 | ✅ 已实现 |

## 代码管理 code / develop

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | exec_code | 代码执行（沙箱隔离，支持python/node） | ✅ 已实现 |
| 2 | run_script | 脚本执行（js/python/sh/bat/bash等） | ✅ 已实现 |
| 3 | diff_check | 差异对比工具（LCS算法，unified diff格式） | ✅ 已实现 |
| 4 | e2e_test | E2E端到端测试工具（需 `npx playwright install`） | ✅ 已实现 |
| 5 | build_html_ui | 构建HTML UI | ✅ 已实现 |
| 6 | get_diagnostics | 诊断信息获取 | ✅ 已实现 |
| 7 | open_preview | 预览打开 | ✅ 已实现 |
| 8 | apply_patch | 应用代码补丁（解析unified diff，支持dry_run预览） | ✅ 已实现 |

## 系统管理 system

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | shell | 执行Shell命令 | ✅ 已实现 |
| 2 | run_command | 运行命令 | ✅ 已实现 |
| 3 | git | Git操作 | ✅ 已实现 |
| 4 | npm | npm执行工具 | ✅ 已实现 |
| 5 | auto_operation | 自动化操作 | ✅ 已实现 |
| 6 | retry_middleware | 重试中间件 | ✅ 已实现 |
<!-- powershell/cmd：由 shell + run_command 已覆盖，无需独立工具 -->

## 网络请求 web

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | http_request | HTTP请求（GET/POST/PUT/DELETE/HEAD） | ✅ 已实现 |
| 2 | fetch_html | 获取网页内容 | ✅ 已实现 |
| 3 | web_fetch | 网页抓取 | ✅ 已实现 |
| 4 | web_search | 网络搜索 | ✅ 已实现 |
| 5 | search_codebase | 代码库搜索 | ✅ 已实现 |
| 6 | browser | 操作浏览器（Playwright驱动） | ✅ 已实现 |
| 7 | download | 下载文件 | ✅ 已实现 |
| 8 | iot_control | 物联网控制 | ✅ 已实现 |

## 数据管理 data

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | sql | SQL查询和操作 | ✅ 已实现 |
| 2 | cache | 缓存数据管理 | ✅ 已实现 |
| 3 | excel | Excel操作 | ✅ 已实现 |

## 媒体管理 media

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | image | 图片处理 | ✅ 已实现 |
| 2 | video | 视频处理 | ✅ 已实现 |
| 3 | audio | 音频处理 | ✅ 已实现 |
| 4 | canvas | 画布绘制 | ✅ 已实现 |
| 5 | abcjs | 五线谱生成 | ✅ 已实现 |
| 6 | ocr | 文字识别 | ✅ 已实现 |
| 7 | TTS | 文本转语音 | ✅ 已实现 |
| 8 | asr | 语音转文本 | ✅ 已实现 |
| 9 | translate | 翻译 | ✅ 已实现 |
| 10 | generate_image | AI生成图片 | ✅ 已实现 |
| 11 | generate_video | AI生成视频 | ✅ 已实现 |
| 12 | generate_audio | AI生成语音 | ✅ 已实现 |
| 13 | stable_diffusion | Stable Diffusion生成 | ✅ 已实现 |
| 14 | comfyui | ComfyUI生成 | ✅ 已实现 |
<!-- mermaid：需配合 UI 聊天界面展示图表，当前无前端界面，暂不实现 -->

## 提示词管理 prompt

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | create_prompt | 创建提示词 | ✅ 已实现 |
| 2 | set_prompt | 修改提示词 | ✅ 已实现 |
| 3 | del_prompt | 删除提示词 | ✅ 已实现 |
| 4 | get_prompt_list | 获取提示词列表 | ✅ 已实现 |
| 5 | get_prompt_detail | 获取提示词详情 | ✅ 已实现 |
| 6 | read_prompt | 读取提示词 | ✅ 已实现 |

## 会话管理 session

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | new_session | 新建会话 | ✅ 已实现 |
| 2 | send_message | 发送消息（跨渠道） | ✅ 已实现 |

## 待办事项 todo

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | add_todos | 添加待办 | ✅ 已实现 |
| 2 | set_todos | 设置待办 | ✅ 已实现 |
| 3 | set_todo_status | 修改待办状态 | ✅ 已实现 |
| 4 | get_agent_todos | 获取待办列表 | ✅ 已实现 |

## 工作提示词管理 work

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | create_work | 创建工作提示词 | ✅ 已实现 |
| 2 | set_work | 修改工作提示词 | ✅ 已实现 |
| 3 | del_work | 删除工作提示词 | ✅ 已实现 |
| 4 | read_work | 读取工作提示词 | ✅ 已实现 |
| 5 | get_work_list | 获取工作提示词列表 | ✅ 已实现 |
| 6 | get_work_detail | 获取工作提示词详情 | ✅ 已实现 |

## 用户协作 user

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | ask_user | 询问用户 | ✅ 已实现 |
| 2 | notify_user | 通知用户 | ✅ 已实现 |
| 3 | create_user | 创建用户（仅 admin 可操作） | ✅ 已实现 |
| 4 | set_user | 修改用户（仅 admin 可操作） | ✅ 已实现 |
| 5 | remove_user | 删除用户（仅 admin 可操作） | ✅ 已实现 |
| 6 | get_user_list | 列出用户 | ✅ 已实现 |
| 7 | get_user_detail | 查看用户详情 | ✅ 已实现 |

## MCP管理 mcp

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | get_mcp_tool_list | 获取MCP工具列表（自动初始化，支持指定或遍历全部） | ✅ 已实现 |
| 2 | use_mcp_tool | 使用MCP工具（自动初始化，自动报错提示） | ✅ 已实现 |

## 系统工具 trae

| # | 工具名 | 标题 | 状态 |
|---|--------|------|:----:|
| 1 | check_command_status | 检查命令状态 | ✅ 已实现 |
| 2 | stop_command | 停止命令 | ✅ 已实现 |

---

## 汇总统计

| 状态 | 数量 |
|:----|:----:|
| ✅ 已实现 | 85 项 |
| 🚧 未完成/未测试 | 0 项 |
| ❌ 无 | — |
| **合计** | **86 项** |

> 注：`powershell`/`cmd` 由 `shell` + `run_command` 已覆盖，无需独立工具；`mermaid` 需配合 UI 聊天界面展示图表，当前暂不实现。