TUI

使用 OpenCode terminal 用戶介面。

OpenCode 提供了一個交互式 terminal 介面或 TUI，供您與 LLM 一起處理項目。

運行 OpenCode 會啟動當前目錄的 TUI。

opencode

或者您可以為特定的工作目錄啟動它。

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

Most commands also have keybind using ctrl+x as the leader key, where ctrl+x is the default leader key. 了解更多。

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

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

thinking

切換對話中思維/推理塊的可見性。啟用後，您可以看到支持擴展思維的模型的推理過程。

/thinking

undo

撤消對話中的最後一條消息。刪除最近的用戶消息、所有後續響應以及任何文件更改。

在內部，這使用 Git 來管理文件更改。所以你的項目需要是一個 Git 存儲庫。

/undo

按鍵綁定： ctrl+x u

unshare

取消共享當前會話。了解更多。

/unshare

編輯器設置

/editor 和/export 命令都使用EDITOR 環境變量中指定的編輯器。

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

To make it permanent, add this to your shell profile; ~/.bashrc, ~/.zshrc, etc.

set EDITOR=notepad

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

To make it permanent, use System Properties > Environment Variables.

$env:EDITOR = "notepad"

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

To make it permanent, add this to your PowerShell profile.

流行的編輯器選項包括：

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）。默認為3。 **注意：如果scroll_acceleration.enabled 設置為true，則忽略此設置。 **

定制化

您可以使用命令選項板（ctrl+x h 或/help）自定義 TUI 視圖的各個方面。這些設置在重新啟動後仍然存在。

用戶名顯示

切換您的用戶名是否出現在聊天消息中。通過以下方式訪問：

命令面板：搜索“用戶名”或“隱藏用戶名”
該設置會自動保留並在 TUI 會話中被記住