概述

Agent 是 Tron 执行复杂多步骤任务的核心机制。当你提出一个需要多个操作才能完成的请求时，Tron 会以 Agent 模式自主规划并执行一系列步骤，包括读取文件、修改代码、运行命令等。

通过合理配置 Agent 行为，你可以在自动化效率和安全控制之间取得平衡，既享受 AI 自动化带来的便利，又不失对代码库的掌控。

Agent 模式

Tron 提供三种 Agent 模式，适用于不同的工作场景：

Tab 键切换

在 TUI 界面中，按 Tab 键可以在三种模式之间循环切换：

当前模式会在界面底部状态栏显示：Build（蓝色）、Ask（绿色）、Architect（紫色）。

自动批准

默认情况下，Tron 在执行某些危险操作前会询问确认。你可以通过 autoApprove 配置列表，指定哪些工具调用可以自动批准执行，无需手动确认：

// ~/.config/tron/config.json
{
  "agent": {
    "autoApprove": [
      "read_file",
      "list_files",
      "search_files",
      "read_directory"
    ]
  }
}

常用的可安全自动批准的工具：

• read_file — 读取文件内容（只读，安全）
• list_files — 列出目录文件（只读，安全）
• search_files — 在文件中搜索内容（只读，安全）
• read_directory — 读取目录结构（只读，安全）

最大步骤

为防止 Agent 陷入无限循环或执行过多操作，可以通过 maxAgentSteps 配置最大执行步骤数：

// ~/.config/tron/config.json
{
  "agent": {
    "maxAgentSteps": 100,
    "autoApprove": ["read_file", "list_files"]
  }
}

默认值为 100 步。当 Agent 达到最大步骤数时，会停止执行并报告当前进度，你可以选择继续或终止任务。对于复杂的大型重构任务，可以适当增大此值；对于日常小任务，保持默认值即可。

上下文管理

随着对话进行，上下文窗口会逐渐被消耗。Tron 的右侧面板会实时显示上下文使用情况，帮助你了解何时需要管理上下文：

管理上下文的两个主要命令：

• /clear — 清空整个对话历史，上下文使用率归零，适合开始全新任务
• /compact — 压缩对话历史，保留关键信息但减少 Token 占用，适合希望保留上下文记忆的场景