工具 (Tools)

这是什么？

工具 (Tools) 是 OpenCode 执行具体任务的能力单元。与只能生成文本的普通聊天机器人不同，OpenCode 可以通过调用工具来执行系统命令、读写文件、搜索代码库或访问互联网。

什么时候你会用到它？

• 当你要求 AI "查找所有引用了 User 类的地方" 时（AI 会调用 grep 或 ripgrep 工具）。
• 当你要求 AI "创建一个新文件" 或 "修改这个函数" 时（AI 会调用文件系统工具）。
• 当你需要 AI 运行测试用例并根据输出修复 Bug 时（AI 会调用终端执行工具）。

核心概念

• Read/Write：基础的文件读写能力。
• Terminal Execution：在沙箱或受控环境中执行 Shell 命令的能力。
• Web Browsing：通过浏览器工具获取最新网络实时信息的能力（如果启用）。

基本用法 / 配置说明

TODO：后续补充如何启用/禁用特定工具的配置示例

常见误解 / 注意事项

• 工具调用通常需要消耗额外的 Token，因为工具的输出会作为新的上下文反哺给模型。
• 某些高风险工具（如删除文件、网络请求）默认可能需要用户确认。

延伸阅读

TODO：后续补充