跳转到内容
OpenCode
app.header.homeapp.header.docs

TUI

使用 opencode 终端用户界面。

opencode 提供交互式终端介面或 TUI，以便使用 LLM 处理您的专案。

执行opencode启动当前目录的TUI。

Terminal window
opencode

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

Terminal window
opencode /path/to/project

进入TUI后，您可以查看消息进行提示。

Give me a quick summary of the codebase.

文件參考

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

How is auth handled in @packages/functions/src/api/index.ts?

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

bash 命令

以!开始一条消息以执行shell命令。

!ls -la

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

命令

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

/help

大多数命令还是以使用 ctrl+x 作为主键的键系结，其中 ctrl+x 是默认主键。 了解更多。

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

连接

将提供商添加到 opencode。你可以从可用提供商中选择，并添加它们的 API 密钥。

/connect

紧凑

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

/compact

** 快捷键：** ctrl+x c

細節

切換工具执行详细信息。

/details

** 快捷键：** ctrl+x d

編輯

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

/editor

** 快捷键：** ctrl+x e

出口

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

/exit

** 快捷键：** ctrl+x q

出口

将当前对话汇出到 Markdown 并在默认编辑器中开启。使用 EDITOR 环境变数中设定的编辑器。 了解更多。

/export

** 快捷键：** ctrl+x x

幫助

显示幫助对话方塊。

/help

** 快捷键：** ctrl+x h

初始化

Create or update AGENTS.md file. Learn more.

/init

** 快捷键：** ctrl+x i

模型

列出可用模型。

/models

** 快捷键：** ctrl+x m

新的

开始新的会话。 别名： /clear

/new

** 快捷键：** ctrl+x n

重做

删除之前重做消除的讯息。仅在使用/undo后可用。

在内部，这使用 Git 来管理文件更改。所以你的专案需要 是一个Git存储库。

/redo

** 快捷键：** ctrl+x r

会话

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

/sessions

** 快捷键：** ctrl+x l

分享

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

/share

** 快捷键：** ctrl+x s

主题

列出可用的主题。

/theme

** 快捷键：** ctrl+x t

思維

切换对话中 thinking/reasoning 块的可视性。启用后，您可以看到支持增强套件思维的模型的推理过程。

/thinking

撤消

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

在内部，这使用 Git 来管理文件更改。所以你的专案需要 是一个Git存储库。

/undo

** 快捷键：** ctrl+x u

取消共享

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

/unshare

编辑器设置

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

Terminal window
# Example for nano or vim
export EDITOR=nano
export EDITOR=vim


# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

要使其永久存在，请将其添加到您的 shell 配置文件中； ~/.bashrc、~/.zshrc 等

流行的编辑器選項包括：

  • code - Visual Studio Code
  • cursor - 游标
  • windsurf - 风帆冲浪
  • nvim - Neovim 编辑器
  • vim - Vim 编辑器
  • nano - 奈米编辑器
  • notepad - Windows 文章书
  • subl - 崇高文字

某些编辑器需要命令列参数才能在阻止模式下执行。 --wait 标志使编辑器程序阻塞直至关闭。

配置

您可以使用 opencode 配置文件自定义 TUI 行为。

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

選項

  • scroll_acceleration - 启用 macOS 式滚动加速以实现平滑、自然的滚动。启用后，滚动速度会随着快速滚动滚动而增加，并在较慢的移动时保持精确。 **此设定优先于 scroll_speed 并在启用时覆盖它。 **
  • scroll_speed - 控制使用滚动控制器时 TUI 滚动的速度（简单：1）。默认为 3。 **注意：如果 scroll_acceleration.enabled 设置为 true，则忽略此设置。 **

定製化

您可以使用命令选项板（ctrl+x h 或 /help）自定义 TUI 查看的各个方面。这些设置在重新启动后仍然存在。

用户名称显示

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

  • 命令面板：搜索“用户名称”或“隐藏用户名称”
  • 该设置会自动保留，放在 TUI 会话中被记住