TUI

使用 OpenCode 终端用户界面。

OpenCode 提供了一个交互式终端界面（TUI），用于在项目中与 LLM 协作。

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

bash
复制
opencode

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

bash
复制
opencode /path/to/project

进入 TUI 后，你可以向它发送提示消息。

给我一个代码库的快速总结。

---

# 文件引用#

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

提示： 你也可以使用 @ 在消息中引用文件。

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

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

---

# Bash 命令#

以 ! 开头的消息会运行 shell 命令。

!ls -la

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

---

# 命令#

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

/help

大多数命令也有使用 ctrl+x 作为前导键的快捷键，其中 ctrl+x 是默认的前导键。了解更多。

以下是常用斜杠命令，具体可用命令取决于安装版本：

---

## update#

版本说明（核验：2026-10-12）： OpenCode v1.19.0（2026-10-11）↗ 不再自动安装更新，可使用下面的命令打开更新操作：

text
复制
/update

按 该版本的更新对话框实现↗，若检测到较新的 OpenCode 1 版本，会先提供 Update；当前已是该渠道最新 OpenCode 1 版本时，会提供升级到 OpenCode 2 的 Upgrade。检查成功并明确选择安装后才执行更新，完成后需重启。

跨主版本包含不兼容变更，操作前请阅读 OpenCode 2 文档↗。CLI 对应入口为 opencode upgrade --major，检查通知开关见 autoupdate。本节仅核验 v1.19.0 文档与源码，未执行更新，不代表所有版本都有相同命令与行为。

---

## 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#

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

/share

快捷键： ctrl+x s

---

## themes#

列出可用主题。

/theme

快捷键： ctrl+x t

---

## undo#

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

提示： 所做的任何文件更改也会被还原。

在内部，这使用 Git 来管理文件更改。所以你的项目需要是一个 Git 仓库。

/undo

快捷键： ctrl+x u

---

## unshare#

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

/unshare

---

# 编辑器设置#

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

## Linux/macOS#

bash
复制
1# nano 或 vim 示例
2export EDITOR=nano
3export EDITOR=vim
4
5# 对于 GUI 编辑器，如 VS Code、Cursor、VSCodium、Windsurf、Zed 等
6# 包含 --wait
7export EDITOR="code --wait"

要使其永久生效，将此添加到你的 shell 配置文件；~/.bashrc、~/.zshrc 等。

## Windows (CMD)#

cmd
复制
1set EDITOR=notepad
2
3# 对于 GUI 编辑器，如 VS Code、Cursor、VSCodium、Windsurf、Zed 等
4# 包含 --wait
5set EDITOR=code --wait

要使其永久生效，使用系统属性 > 环境变量。

## Windows (PowerShell)#

powershell
复制
1$env:EDITOR = "notepad"
2
3# 对于 GUI 编辑器，如 VS Code、Cursor、VSCodium、Windsurf、Zed 等
4# 包含 --wait
5$env:EDITOR = "code --wait"

要使其永久生效，将此添加到你的 PowerShell 配置文件。

常用编辑器选项包括：

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

注意： 某些编辑器（如 VS Code）需要使用 --wait 标志启动。

某些编辑器需要命令行参数以阻塞模式运行。--wait 标志使编辑器进程阻塞直到关闭。

---

# 配置#

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

json
复制
1{
2  "$schema": "https://opencode.ai/config.json",
3  "tui": {
4    "scroll_speed": 3,
5    "scroll_acceleration": {
6      "enabled": true
7    }
8  }
9}

## 选项#

• 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 会话中记住