File size: 12,674 Bytes

# 工具参考大全

> 完整收录 Codev 中所有 AI 可调用的工具（约 60+），按功能分类。

---

## 核心文件操作

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **Read** (FileReadTool) | 核心 | 读取文件内容，支持 PDF、图片、Jupyter Notebook。自动推断文件编码和语言 | `file_path` (必填), `offset`, `limit`, `pages` (PDF), `stop_sequence` |
| **Edit** (FileEditTool) | 核心 | 对现有文件执行精确字符串替换。支持 diff 显示、git diff 跟踪、行尾风格检测 | `file_path` (必填), `old_string` (必填), `new_string` (必填), `replace_all`, `is_undo` |
| **Write** (FileWriteTool) | 核心 | 创建新文件或覆盖写文件。不支持替换编辑（用途与 Edit 互补） | `file_path` (必填), `content` (必填) |
| **Glob** (GlobTool) | 核心 | 使用 glob 模式快速搜索文件名。支持 `.gitignore` 排除规则 | `pattern` (必填), `path` (可选) |
| **Grep** (GrepTool) | 核心 | 使用正则表达式搜索文件内容。基于 ripgrep，支持多种输出模式 | `pattern` (必填), `path` (可选), `glob`, `output_mode`, `-B`, `-A`, `-C`, `-i`, `type`, `head_limit`, `multiline` |
| **NotebookEdit** (NotebookEditTool) | 核心 | 编辑 Jupyter Notebook (.ipynb) 文件的单元格。支持 replace / insert / delete 模式 | `notebook_path` (必填), `cell_id`, `new_source`, `cell_type`, `edit_mode` |

---

## 命令执行

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **Bash** (BashTool) | 核心 | 执行 Shell 命令。支持超时控制、后台执行、沙箱模式。自动检测 search/read 类命令以折叠显示 | `command` (必填), `timeout` (可选), `description` (可选), `run_in_background` (可选), `dangerouslyDisableSandbox` (可选) |
| **Agent** (AgentTool) | 核心 | 启动独立的子代理执行子任务。支持指定代理类型、模型、隔离方式、团队协作 | `description` (必填), `prompt` (必填), `subagent_type`, `model`, `run_in_background`, `name`, `team_name`, `mode`, `isolation` (worktree/remote), `cwd` |
| **PowerShell** (PowerShellTool) | 命令 | Windows PowerShell 命令执行。仅在 Windows 平台可用 | `command` (必填), `timeout`, `description`, `run_in_background` |
| **TaskStop** (TaskStopTool) | 命令 | 停止正在运行的后台任务。继承自废弃的 KillShell 工具 | `task_id` (可选), `shell_id` (废弃) |
| **TaskOutput** (TaskOutputTool) | 命令 | 获取后台任务的执行输出。支持阻塞等待和超时控制 | `task_id` (必填), `block` (默认 true), `timeout` (默认 30000ms) |

---

## 搜索

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **WebSearch** (WebSearchTool) | 搜索 | 执行网络搜索。支持 Tavily API 和本地 SearXNG 两种后端（优先本地 SearXNG） | `query` (必填, 最少 2 字符) |
| **WebFetch** (WebFetchTool) | 搜索 | 抓取指定 URL 的内容，并对内容执行 prompt 处理（提取、总结等） | `url` (必填), `prompt` (必填) |
| **LocationTool** (LocationTool) | 搜索 | 地理位置与地图搜索。中国大陆使用高德地图，海外使用 Google Maps。支持地理编码、POI 搜索、路线规划、行程规划 | `action` (必填), `location` (必填), `destination`, `query`, `radius`, `mode`, `waypoints`, `type`, `region`, `language` |
| **ToolSearch** (ToolSearchTool) | 搜索 | 搜索延迟加载的工具。当 ToolSearch 启用时，部分工具的 schema 不会随初始提示发送，需通过此工具查询后再调用 | `query` (必填, 支持 "select:name" 精确选择), `max_results` (默认 5) |

---

## MCP (Model Context Protocol)

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **ListMcpResources** (ListMcpResourcesTool) | MCP | 列出已连接 MCP 服务器提供的可用资源 | `server` (可选, 过滤) |
| **ReadMcpResource** (ReadMcpResourceTool) | MCP | 读取 MCP 资源内容。支持文本和二进制内容（二进制会保存到磁盘） | `server` (必填), `uri` (必填) |
| **MCPTool** (动态) | MCP | 由 MCP 服务器动态注册的工具。名称格式 `mcp__server__tool`。数量和功能取决于已连接的 MCP 服务器 | 由 MCP 服务器定义 |
| **McpAuth** (MCP) | MCP | MCP 服务器授权管理。当工具调用返回 McpAuthError 时触发重授权流程 | 由 MCP 服务器定义 |

---

## 任务管理 (Todo V2)

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **TaskCreate** (TaskCreateTool) | 任务 | 创建新的任务项。支持设置负责人（owner）、依赖关系、元数据 | `subject` (必填), `description` (必填), `activeForm`, `metadata` |
| **TaskGet** (TaskGetTool) | 任务 | 通过 ID 获取单个任务的详细信息 | `taskId` (必填) |
| **TaskUpdate** (TaskUpdateTool) | 任务 | 更新任务的状态、描述、负责人、依赖关系、元数据。支持标记为 "deleted" 删除 | `taskId` (必填), `subject`, `description`, `status`, `addBlocks`, `addBlockedBy`, `owner`, `metadata` |
| **TaskList** (TaskListTool) | 任务 | 列出所有任务的概览（ID、标题、状态、负责人、阻塞关系） | 无参数 |
| **TodoWrite** (TodoWriteTool) | 任务 | (遗留) 会话级任务清单管理。V1 版本，当 Todo V2 未启用时生效 | `todos` (必填) |

---

## 团队与多代理

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **TeamCreate** (TeamCreateTool) | 团队 | 创建新团队并设置团队领导。支持指定代理类型，自动生成团队文件 | `team_name` (必填), `description`, `agent_type` |
| **TeamDelete** (TeamDeleteTool) | 团队 | 删除已存在的团队 | `team_id` (必填) |
| **SendMessage** (SendMessageTool) | 团队 | 向指定队友发送消息。支持普通文本和结构化消息（关闭请求/响应、计划审批等） | `to` (必填), `message` (必填), `type`, `request_id` |
| **ListPeers** (ListPeersTool) | 团队 | 列出本地 UDS 对等节点（统一数据空间连接的对等体） | 无参数 |

---

## 规划与工作树

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **EnterPlanMode** (EnterPlanModeTool) | 规划 | 进入规划模式。在执行复杂任务前，可用于探索和设计方案 | 无参数 |
| **ExitPlanMode** (ExitPlanModeV2Tool) | 规划 | 退出规划模式。提交最终计划并恢复为之前的权限模式 | `plan` (必填), `plan_approval`, `output`, `mode` |
| **EnterWorktree** (EnterWorktreeTool) | 规划 | 创建隔离的 git worktree 并将会话切换到其中。用于安全地进行实验性修改 | `name` (可选) |
| **ExitWorktree** (ExitWorktreeTool) | 规划 | 退出 git worktree 并返回原工作目录。支持 keep（保留）或 remove（删除） | `action` (必填, keep/remove), `discard_changes` |

---

## 技能

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **Skill** (SkillTool) | 技能 | 执行 Markdown 定义的技能。技能可以是打包的、用户自定义的、插件提供的或 MCP 提供的 | 参数取决于具体技能 |
| **DiscoverSkills** (DiscoverSkillsTool) | 技能 | 发现新的可用技能。扫描技能目录并返回当前可用的技能列表 | 无参数 |

---

## 目标系统 (Goal)

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **GoalCreate** (GoalCreateTool) | 目标 | 创建新的会话目标。当当前无活跃目标时生效 | `objective` (必填) |
| **GoalGet** (GoalGetTool) | 目标 | 查看当前活跃目标的状态、经过时间、续用次数 | 无参数 |
| **GoalUpdate** (GoalUpdateTool) | 目标 | 声明目标完成或受阻。需提供原因说明 | `goal_id` (必填), `status` (必填, complete/blocked), `reason` (必填) |

---

## Friend 虚拟宠物

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **FriendEmotion** (FriendEmotionTool) | Friend | 控制 VRM 虚拟形象的表情和情绪状态。设置情绪类型、强度，调整自身心情指数 | `emotion` (必填, 如 happy/sad/angry), `intensity` (0-1, 默认 1), `mood_delta` (-3 到 +3) |
| **FriendScreenObserve** (FriendScreenObserveTool) | Friend | 捕获当前桌面屏幕截图，供 LLM "观察" 用户桌面环境。返回图片路径 | 无参数 |

---

## 特殊工具

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **AskUserQuestion** (AskUserQuestionTool) | 特殊 | 向用户提出 1-4 个多选题以澄清需求或做决策。走独立问答通道（不占用权限确认队列），本地 TUI 弹独立 overlay，桥接模式下同时转发给远程用户（claude.ai）竞速应答 | `questions` (必填, 1-4 个, 每题含 `question`/`header`/`options[{label,description,preview?}]` 2-4 个/`multiSelect`) |
| **Config** (ConfigTool) | 特殊 | 读取或修改 Claude Code 配置设置（ant 内部版本） | `setting` (必填), `value` (可选) |
| **Sleep** (SleepTool) | 特殊 | 让代理休眠一段时间。用于延迟执行或等待条件成熟 | 取决于实现 |
| **CronCreate** (CronCreateTool) | 特殊 | 创建定时触发任务（cron 调度） | 取决于实现 |
| **CronDelete** (CronDeleteTool) | 特殊 | 删除已存在的 cron 任务 | 取决于实现 |
| **CronList** (CronListTool) | 特殊 | 列出所有已注册的 cron 任务 | 取决于实现 |
| **RemoteTrigger** (RemoteTriggerTool) | 特殊 | 远程触发任务执行 | 取决于实现 |
| **Monitor** (MonitorTool) | 特殊 | 监控资源或任务状态 | 取决于实现 |
| **Brief** (BriefTool) | 特殊 | 生成简报输出。在 KAIROS/BRIEF 模式下可用 | 取决于实现 |
| **Snip** (SnipTool) | 特殊 | 强制截断历史上下文。HISTORY_SNIP feature 控制 | 取决于实现 |
| **SubscribePR** (SubscribePRTool) | 特殊 | 订阅 GitHub PR 的通知 | 取决于实现 |
| **PushNotification** (PushNotificationTool) | 特殊 | 发送推送通知 | 取决于实现 |
| **SendUserFile** (SendUserFileTool) | 特殊 | 向用户发送文件 | 取决于实现 |

---

## Workflow

| 工具名称 | 分类 | 用途描述 | 关键参数 |
|----------|------|----------|----------|
| **WorkflowTool** (WorkflowTool) | Workflow | 执行多步骤工作流脚本。工作流由 YAML/JSON 定义，支持顺序执行、条件分支、变量传递 | 取决于工作流定义 |

---

## Ant 内部工具

以下工具仅在 `USER_TYPE=ant` 的内部构建中可用，公开构建中被过滤：

| 工具名称 | 分类 | 用途描述 |
|----------|------|----------|
| **REPLTool** | Ant 内部 | REPL 模式的 VM 执行器。在 REPL 模式下包装 Bash/Read/Edit 等工具 |
| **TungstenTool** | Ant 内部 | Tungsten 内部工具 |
| **SuggestBackgroundPRTool** | Ant 内部 | 后台 PR 建议工具 |
| **CtxInspectTool** | Ant 内部 | 上下文折叠检查（CONTEXT_COLLAPSE） |
| **TerminalCaptureTool** | Ant 内部 | 终端面板捕获（TERMINAL_PANEL） |
| **OverflowTestTool** | Ant 内部 | 溢出测试工具 |
| **VerifyPlanExecutionTool** | Ant 内部 | 计划执行验证 |
| **TestingPermissionTool** | Ant 内部 | 测试权限工具（仅 NODE_ENV=test） |
| **WebBrowserTool** | Ant 内部 | 网页浏览器工具 |

---

## feature-flag 条件编译对照

以下工具根据 feature flag 条件编译，在公开构建中通过 bun build DCE 消除：

| Feature Flag | 包含的工具 |
|--------------|-----------|
| `PROACTIVE` / `KAIROS` | SleepTool |
| `AGENT_TRIGGERS` | CronCreateTool, CronDeleteTool, CronListTool |
| `AGENT_TRIGGERS_REMOTE` | RemoteTriggerTool |
| `MONITOR_TOOL` | MonitorTool |
| `KAIROS` | SendUserFileTool, PushNotificationTool |
| `KAIROS_PUSH_NOTIFICATION` | PushNotificationTool |
| `KAIROS_GITHUB_WEBHOOKS` | SubscribePRTool |
| `WORKFLOW_SCRIPTS` | WorkflowTool |
| `COORDINATOR_MODE` | 协调模式相关工具 |
| `HISTORY_SNIP` | SnipTool |
| `UDS_INBOX` | ListPeersTool |
| `ENABLE_LSP_TOOL` | LSPTool |
| `WEB_BROWSER_TOOL` | WebBrowserTool |
| `OVERFLOW_TEST_TOOL` | OverflowTestTool |
| `CONTEXT_COLLAPSE` | CtxInspectTool |
| `TERMINAL_PANEL` | TerminalCaptureTool |

---

> 注: 本参考基于 `/home/yuki/Code/Agent/Codev/src/tools.ts` 的 `getAllBaseTools()` 函数。MCP 工具的完整列表取决于用户配置的 MCP 服务器，未在此表中逐一列出。