概述
TUI(Terminal User Interface)是 Tron 的主要交互界面,提供丰富的终端可视化体验。直接在终端中运行 tron 命令即可进入 TUI 模式:
cd /path/to/your/project
tron
界面布局
TUI 界面分为三个主要区域:主聊天区(左侧)、上下文面板(右侧)和底部状态栏。
── 主聊天区 ───────────────────────────────────────────────
Tron
你好!我已准备好协助你处理代码任务。当前项目是 my-project,有什么需要帮助的?
你
帮我解释 @src/utils/parser.ts 这个文件
◎ 正在读取文件...
Build
·
claude-opus-4-6
·
── 底部状态栏 ──────────────────────────────────────
输入消息或斜杠命令...
- 主聊天区(左):显示对话历史、AI 响应、工具调用过程
- 上下文面板(右):实时显示 Token 用量、费用、LSP 状态、引用文件列表
- 底部状态栏:显示当前模式、模型、会话名称、项目路径和快捷键提示
交互模式
Tron TUI 提供三种交互模式,按 Tab 键循环切换:
| 模式 | 说明 | 适用场景 |
|---|---|---|
| Build(默认) | AI 可以读取和修改文件 | 编写代码、重构、修复 Bug |
| Ask | 只读模式,AI 不会修改文件 | 代码解释、问题解答、学习 |
| Architect | 规划模式,先制定方案再执行 | 复杂功能规划、架构设计 |
建议
处理重要功能时,建议先切换到 Architect 模式制定计划,确认方案后再切换到 Build 模式执行。
上下文引用
在输入框中使用 @ 前缀可以快速引用项目文件,将文件内容加入到 AI 的上下文中:
你
重构 @src/api/auth.ts 的 JWT 验证逻辑,参考 @src/api/user.ts 的实现风格
✓ 已加载 src/api/auth.ts (256 行)
✓ 已加载 src/api/user.ts (189 行)
在输入框中按 @ 键会弹出文件搜索面板,支持模糊匹配项目中的所有文件。
斜杠命令
在输入框中输入 / 即可触发斜杠命令菜单。主要命令如下:
| 命令 | 说明 |
|---|---|
/init |
分析项目结构,生成 AGENTS.md 初始化文件 |
/connect |
配置或切换 AI 供应商和模型 |
/clear |
清空当前对话上下文,释放 Token |
/undo |
撤销最近一次文件修改 |
/redo |
重做上次撤销的操作 |
/help |
查看所有可用命令和快捷键 |
/exit |
退出 Tron TUI |
键盘快捷键
常用键盘快捷键:
| 快捷键 | 功能 |
|---|---|
| Ctrl+P | 打开命令面板,快速搜索和执行命令 |
| Tab | 循环切换交互模式(Build / Ask / Architect) |
| Ctrl+C | 中断当前 AI 响应 |
| Ctrl+L | 清屏(保留对话历史) |
| ↑ / ↓ | 浏览历史输入记录 |
| Ctrl+Z | 撤销最近文件修改 |
| Esc | 关闭弹出面板或取消当前操作 |