附录 B · 斜杠命令与特殊前缀速查

斜杠命令在输入框以 / 开头触发；本附录收录 OpenCode V2 文档中明确出现的命令与特殊前缀。不同版本内置命令可能增减——在输入框输入 / 即可看到当前版本的完整实时列表，这是最可靠的查询方式。

---

B.1 斜杠命令（内置）

命令	作用
/agents	查看与选择 Agent
/models	查看与选择模型
/mcps	查看 MCP 服务器；远程服务器可在此完成 OAuth 登录
/connect	在 TUI 中绑定集成账号（搜索供应商等）
/undo	暂存「回退上一条回复」（含文件恢复）
/redo	取消暂存的回退
/commands	查看可用命令（含自定义命令）
/skills	查看可用 Skill

说明：上表是文档中明确提及者，并非全部。你自己在 .opencode/commands/*.md 定义的命令也会出现在 / 列表中（第 5 章）。部分功能（主题、设置等）主要走 Ctrl+P 命令面板而非斜杠命令。

B.2 三个特殊前缀符号

前缀	作用	示例
/	调用斜杠命令	/models
!	Shell 模式：你手动运行系统命令，输出进入会话	!git status
@	附加上下文：文件 / 目录	@src/app.ts、@src/app.ts#20-45

补充：

• Shell 模式在空输入框以 ! 开头进入，按 Esc 不执行直接退出；命令在会话工作目录下运行；
• 侧问（side question）可用 /btw（如当前版本提供）：问一句不改变主线的问题；
• 「AI 自动调用 shell 工具」与「你用 ! 手动跑」是两回事（第 7 章）。

---

B.3 斜杠命令 vs 命令面板

	斜杠命令 /	命令面板 Ctrl+P
内容	可作为「对话动作」发起的命令、用户自定义命令	应用级全部命令（设置、主题、退出、服务操作等）
典型用途	切模型 / Agent、undo、MCP 登录	改设置、切换主题、任何界面操作
可自定义	可（.opencode/commands/*.md）	一般通过插件扩展

选择原则：要「对 AI 说」的动作用 /；要「操作界面」的动作用 Ctrl+P。