TUI

使用 OpenCode 终端用户界面。

OpenCode 提供了一个交互式终端界面（TUI），用于与 LLM 协同处理您的项目。

运行 OpenCode 会为当前目录启动 TUI。

opencode

或者，您可以为特定的工作目录启动它。

opencode /path/to/project

进入 TUI 后，您可以通过消息提示它。

给我一个代码库的快速摘要。

文件引用

您可以在消息中使用 @ 来引用文件。这会在当前工作目录中进行模糊文件搜索。

@packages/functions/src/api/index.ts 中是如何处理身份验证的？

文件内容会自动添加到对话中。

Bash 命令

以 ! 开头的消息将运行一个 shell 命令。

!ls -la

命令的输出将作为工具结果添加到对话中。

命令

使用 OpenCode TUI 时，您可以输入 / 后跟命令名来快速执行操作。例如：

/help

大多数命令也有关键字绑定，使用 ctrl+x 作为引导键，其中 ctrl+x 是默认的引导键。了解更多。

以下是所有可用的斜杠命令：

connect

向 OpenCode 添加一个提供者。允许您从可用的提供者中选择并添加其 API 密钥。

/connect

compact

压缩当前会话。别名：/summarize

/compact

关键字绑定： ctrl+x c

details

切换工具执行详情显示。

/details

关键字绑定： ctrl+x d

editor

打开外部编辑器来编写消息。使用您在 EDITOR 环境变量中设置的编辑器。了解更多。

/editor

关键字绑定： ctrl+x e

exit

退出 OpenCode。别名：/quit、/q

/exit

快捷键： ctrl+x q

export

将当前对话导出为 Markdown 格式并在默认编辑器中打开。使用 EDITOR 环境变量中设置的编辑器。了解更多。

/export

快捷键： ctrl+x x

help

显示帮助对话框。

/help

快捷键： ctrl+x h

init

创建或更新 AGENTS.md 文件。了解更多。

/init

快捷键： ctrl+x i

models

列出可用模型。

/models

快捷键： ctrl+x m

new

开始一个新会话。别名：/clear

/new

快捷键： ctrl+x n

redo

重做先前撤销的消息。仅在使用了 /undo 之后可用。

在内部，此命令使用 Git 来管理文件更改。因此你的项目必须是一个 Git 仓库。

/redo

快捷键： ctrl+x r

sessions

列出会话并在会话之间切换。别名：/resume、/continue

/sessions

快捷键： ctrl+x l

分享当前会话。了解更多。

/share

快捷键： ctrl+x s

themes

列出可用主题。

/theme

快捷键： ctrl+x t

undo

撤销对话中的最后一条消息。移除最新的用户消息、所有后续响应以及任何文件更改。

在内部，此命令使用 Git 来管理文件更改。因此你的项目必须是一个 Git 仓库。

/undo

快捷键： ctrl+x u

unshare

取消分享当前会话。了解更多。

/unshare

编辑器设置

/editor 和 /export 命令都使用您在 EDITOR 环境变量中指定的编辑器。

# 以 nano 或 vim 为例
export EDITOR=nano
export EDITOR=vim

# 对于 GUI 编辑器，如 VS Code, Cursor, VSCodium, Windsurf, Zed 等。
# 需要包含 --wait 参数
export EDITOR="code --wait"

要永久设置，请将此添加到您的 shell 配置文件中；例如 ~/.bashrc, ~/.zshrc 等。

set EDITOR=notepad

# 对于 GUI 编辑器，如 VS Code, Cursor, VSCodium, Windsurf, Zed 等。
# 需要包含 --wait 参数
set EDITOR=code --wait

要永久设置，请使用 系统属性 > 环境变量。

$env:EDITOR = "notepad"

# 对于 GUI 编辑器，如 VS Code, Cursor, VSCodium, Windsurf, Zed 等。
# 需要包含 --wait 参数
$env:EDITOR = "code --wait"

要永久设置，请将此添加到您的 PowerShell 配置文件中。

常用的编辑器选项包括：

code - Visual Studio Code
cursor - Cursor
windsurf - Windsurf
nvim - Neovim 编辑器
vim - Vim 编辑器
nano - Nano 编辑器
notepad - Windows 记事本
subl - Sublime Text

一些编辑器需要命令行参数才能在阻塞模式下运行。--wait 标志使编辑器进程在关闭前保持阻塞状态。

配置

您可以通过 OpenCode 配置文件自定义 TUI 行为。

{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

选项

scroll_acceleration - 启用 macOS 风格的滚动加速，实现平滑、自然的滚动体验。启用后，快速滚动手势会提高滚动速度，而慢速移动则保持精确。此设置优先于 scroll_speed，启用时会覆盖它。
scroll_speed - 控制使用滚动命令时 TUI 的滚动速度（最小值：1）。在 Unix 系统上默认为 1，在 Windows 上默认为 3。注意：如果 scroll_acceleration.enabled 设置为 true，此设置将被忽略。

自定义

您可以使用命令面板（ctrl+x h 或 /help）自定义 TUI 视图的各个方面。这些设置在重启后仍然有效。

用户名显示

切换您的用户名是否出现在聊天消息中。可通过以下方式访问：

命令面板：搜索 “username” 或 “hide username”
设置会自动保存，并在 TUI 会话之间记住