文档 - Tron CLI 文档

概述

Tron 内置多种工具，用于读取文件、执行命令、搜索代码等操作。这些工具是 Tron 理解和修改代码库的基础能力。你可以根据项目需求或安全策略，按需启用或禁用特定工具。

工具的启用状态会影响 Tron 能够完成的任务类型。禁用某些工具后，Tron 在执行相关操作时会提示工具不可用。

以下是 Tron 提供的所有内置工具：

工具名称	说明	默认状态
`read_file`	读取文件内容	启用
`write_file`	写入文件内容	启用
`edit_file`	编辑文件（局部修改）	启用
`execute_command`	在终端中执行 Shell 命令	启用
`search_files`	在项目中搜索文件和内容	启用
`web_search`	网页搜索（需配置搜索 API）	禁用
`browser`	控制浏览器（需配置 puppeteer 或 playwright）	禁用

💡

提示

web_search 和 browser 工具需要额外配置才能使用。你可以通过 MCP 服务来扩展这些能力，详见 MCP 服务。

在 config.json 中使用 disabledTools 数组来禁用指定工具。例如，禁用 execute_command 可以防止 Tron 在你的环境中执行任意命令：

json

// ~/.config/tron/config.json
{
  "disabledTools": [
    "execute_command",
    "browser"
  ]
}

禁用工具后，Tron 在尝试使用该工具时会明确告知用户工具不可用，并尝试寻找替代方案完成任务。

对于高风险操作（如执行命令、写入文件），Tron 默认会在执行前显示确认提示，要求用户明确授权。这一机制防止 Tron 在未经确认的情况下修改系统状态。

你可以配置自动批准规则，让 Tron 对特定类型的操作免于询问：

json

{
  "autoApprove": {
    "read_file": true,
    "search_files": true,
    "write_file": false,
    "execute_command": false
  }
}

详细的权限配置选项请参阅权限管理文档。

除内置工具外，你还可以为 Tron 创建自定义工具，扩展其能力边界。自定义工具通过定义工具名称、描述和执行脚本来实现，Tron 可以在对话中根据上下文自动调用这些工具。

关于如何创建和注册自定义工具，请参阅自定义工具文档。