3.1 TUI终端界面

界面 第三章：界面操作

OpenCode的TUI（Terminal User Interface）是主要的交互界面，在终端中提供丰富的功能和流畅的体验。

启动TUI

# 在当前目录启动
opencode

# 指定工作目录
opencode /path/to/project

文件引用

使用 @ 符号引用项目文件：

@src/main.js 帮我解释这个文件

输入 @ 后会触发模糊搜索，自动匹配文件。也可以指定行号：

@File#L37-42  # 引用37-42行

执行Shell命令

使用 ! 前缀执行命令，输出作为上下文提供给AI：

!ls -la
!git status
!npm run test

主要斜杠命令

命令功能快捷键
/connect添加提供商认证—
/compact压缩会话上下文ctrl+x c
/details切换工具执行详情ctrl+x d
/editor打开外部编辑器ctrl+x e
/export导出为Markdownctrl+x x
/models列出可用模型ctrl+x m
/new开始新会话ctrl+x n
/sessions管理会话ctrl+x l
/share分享会话ctrl+x s
/undo撤销更改ctrl+x u
/redo重做更改ctrl+x r

模式切换

按 Tab 键在两种模式间切换：

  • Build模式：完整工具访问，可修改文件
  • Plan模式：只读分析，不修改任何文件

输入编辑快捷键

支持Readline/Emacs风格的编辑：

快捷键功能
ctrl+a移到行首
ctrl+e移到行尾
ctrl+k删除到行尾
ctrl+w删除前一个词
ctrl+t交换字符

TUI配置选项

{
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    },
    "diff_style": "unified"
  }
}

外部编辑器

使用 /editor 或 ctrl+x e 在外部编辑器中编辑提示词。需要设置 EDITOR 环境变量：

export EDITOR="code --wait"  # VS Code
export EDITOR="vim"          # Vim

退出TUI

  • ctrl+c
  • ctrl+d
  • ctrl+x q（leader键 + q）

下一步

了解TUI操作后，接下来学习CLI命令行接口。