ZapMyCo 的内置工具系统为 AI Agent 提供了与本地环境和用户交互的能力。大多数工具在 zapmyco run <content> 一次性执行模式下可用，而交互式工具（如 ask_user、task_*）在交互模式（zapmyco 无参数）下也可用。

工具速查

工具名称	功能	能力
web_fetch	获取网页内容	将指定 URL 的网页转换为 Markdown，供 AI 分析
web_search	搜索网络	搜索实时信息（新闻、文档、趋势等）
shell_exec	执行命令	在本地系统执行 shell 命令并返回输出
file_read	读取文件内容	按行号范围读取本地文件内容，支持分段查看
file_search	搜索文件内容	在本地文件系统中搜索文件内容，支持正则表达式
file_find	查找文件	按 glob 通配符模式（如 `*/.rs`）在本地文件系统中查找文件
file_edit	编辑文件内容	五种模式：line_range（推荐）、append、insert_after、批量编辑、旧模式
file_write	写入文件	创建新文件或完整覆盖已有文件，含预读检查和二进制检测
ask_user	询问用户	向用户提出选项问题并获取回答，支持单选/多选和自定义输入
task_create	创建任务	创建新任务以跟踪复杂多步骤工作进度
task_get	查看任务	按 ID 获取单个任务的详情和状态
task_list	列出任务	列出当前所有任务及其状态概览
task_update	更新任务	更新任务的状态、字段和依赖关系

按类别浏览

工具	说明	文档
`web_fetch`	获取指定 URL 的网页内容	查看详情
`web_search`	搜索网络获取实时信息	查看详情

AI Agent 会自动组合两者：先用 web_search 找到相关页面，再用 web_fetch 获取具体内容。

工具	说明	文档
`shell_exec`	在本地系统执行 shell 命令	查看详情

执行命令前会弹出确认提示，需用户授权。

文件操作工具之间可以组合使用：先用 file_find 定位文件，用 file_search 搜索内容，用 file_read 查看上下文，再用 file_edit 或 file_write 进行修改。

工具	说明	文档
`ask_user`	向用户提出选项问题并获取回答	查看详情

AI Agent 会自动组合任务工具完成复杂工作流：先拆解为子任务、跟踪进度、按需查看详情、更新状态。

ToolHandler 枚举通过 #[non_exhaustive] 标记，预留了扩展能力，未来版本将持续新增工具数量。

版本	新增工具	说明
v0.29+	`web_fetch`, `web_search`, `shell_exec`	初始工具：网络获取、网络搜索、命令执行
v0.31+	`file_read`, `file_search`, `file_find`	文件操作：读取、内容搜索、文件查找
v0.32+	`file_edit`, `file_write`, `ask_user`	文件编辑、文件写入、用户询问
v0.33+	`task_create`, `task_get`, `task_list`, `task_update`	任务管理系统
v0.34+	`file_edit` 重构	新增 line_range、append、insert_after、批量编辑模式，内容验证算法
未来	待定	敬请期待