3.4 KiB
3.4 KiB
title, icon, date, category, tag
| title | icon | date | category | tag | |||||
|---|---|---|---|---|---|---|---|---|---|
| OpenCode TUI 实战指南 | mdi:monitor-dashboard | 2026-03-06 |
|
|
OpenCode TUI 实战指南
这篇文章基于 OpenCode 官方文档的 TUI 章节，聚焦终端交互界面的 高频用法：怎么聊、怎么调、怎么把会话真正用起来。
一、先启动 TUI
直接在当前目录启动：
opencode
或者指定项目目录启动：
opencode /path/to/project
进入后就能直接提问，例如：
先给我快速总结一下这个仓库结构和技术栈。
二、两个最实用的输入能力
2.1 @ 文件引用
在消息里用 @ 引用文件，OpenCode 会做模糊匹配并把文件内容带入上下文。
@src/.vuepress/config.ts 这个配置里有哪些容易踩坑的点？
适合代码审查、定位问题、讲解现有实现。
2.2 ! Bash 命令
输入 ! 开头的内容，会按 shell 命令执行并把输出注入会话。
!git status
!npm run docs:build
这个能力非常适合“边看代码边验证”。
三、必须掌握的斜杠命令
3.1 会话与整理
/new
/sessions
/compact
/new：开新会话（清空当前上下文）。/sessions：快速切换历史会话。/compact：压缩上下文，长对话时很有用。
3.2 可视化与排障
/details
/thinking
/models
/details：显示或隐藏工具执行细节。/thinking：切换推理块显示（仅控制展示）。/models：查看可用模型并确认当前选择。
3.3 输出与分享
/export
/share
/unshare
/export：导出当前对话为 Markdown。/share：分享当前会话。/unshare：取消分享。
四、undo / redo 的正确理解
/undo
/redo
这两个命令不仅会撤销或重做消息，也会回滚或恢复文件变更。
注意：它依赖 Git 管理改动，所以项目目录最好是一个 Git 仓库。
五、编辑器联动（很建议配）
/editor 和 /export 都依赖 EDITOR 环境变量。
Linux / macOS 示例：
export EDITOR="code --wait"
如果你使用 vim / nvim / nano 也可以直接设置对应命令。
推荐使用带 --wait 的 GUI 编辑器，这样 TUI 会等待你编辑完成再返回。
六、TUI 配置项（滚动最常用）
可以在配置文件中设置：
{
"$schema": "https://opencode.ai/config.json",
"tui": {
"scroll_speed": 3,
"scroll_acceleration": {
"enabled": true
}
}
}
scroll_speed：滚动速度（最小1）。scroll_acceleration.enabled：类 macOS 滚动加速。
当加速开启时，会覆盖 scroll_speed 的效果。
七、一套我常用的 TUI 习惯
- 先用
@精准挂载关键文件，再提任务。 - 单次只做一类改动，必要时
/compact。 - 关键节点
/export，形成可复盘记录。 - 大改前先确认 Git 状态，便于
/undo使用。 - 需要自动化时再切到
opencode run。
八、结语
TUI 的核心不是“会聊天”，而是把上下文、命令执行和文件改动放在同一条工作流里。
如果你平时就在终端里开发，OpenCode TUI 会比网页对话更顺手。