斜杠命令参考

命令速查

命令	别名	快捷键	用途
`/help`	-	`Ctrl+X H`	显示帮助对话框
`/new`	`/clear`	`Ctrl+X N`	开始新会话
`/undo`	-	`Ctrl+X U`	撤销上一条消息
`/redo`	-	`Ctrl+X R`	重做撤销的消息
`/compact`	`/summarize`	`Ctrl+X C`	压缩/总结当前会话
`/connect`	-	-	添加 AI Provider
`/models`	-	`Ctrl+X M`	列出可用模型
`/sessions`	`/resume`, `/continue`	`Ctrl+X L`	列出和切换会话
`/share`	-	`Ctrl+X S`	创建公开链接分享对话
`/unshare`	-	-	取消分享当前会话
`/export`	-	`Ctrl+X X`	导出对话为 Markdown
`/themes`	-	-	列出可用主题
`/editor`	-	`Ctrl+X E`	打开外部编辑器编写消息
`/init`	-	`Ctrl+X I`	创建/更新 AGENTS.md
`/details`	-	`Ctrl+X D`	切换工具执行详情显示
`/thinking`	-	-	切换 AI 思考过程显示
`/exit`	`/quit`, `/q`	`Ctrl+X Q`	退出 OpenCode

会话控制

/new

开始新的对话会话。这会清除当前上下文并重新开始。

别名: /clear
快捷键: Ctrl+X N

适用场景

新任务：开始处理不同的问题
上下文重置：清除累积的上下文以减少 token 使用
全新开始：在没有先前对话历史的情况下开始

/undo

撤销对话中的上一条消息。这需要一个 Git 仓库。

快捷键: Ctrl+X U

适用场景

纠正错误：移除错误的问题
流程控制：回溯对话以尝试不同的方法
上下文清理：移除导致对话偏离主题的消息

/redo

重做之前撤销的消息。这需要一个 Git 仓库。

快捷键: Ctrl+X R

适用场景

恢复消息：找回已撤销的内容
流程恢复：在撤销后恢复对话流程
实验：尝试不同的对话路径

/compact

压缩和总结当前会话，以减少 token 使用同时保留上下文。

别名: /summarize
快捷键: Ctrl+X C

适用场景

长对话：减少扩展会话中的 token
成本优化：在保持上下文的同时降低 API 成本
性能：通过减少上下文大小来加速响应

导航和切换

/models

显示已配置 Provider 的所有可用 AI 模型列表。

快捷键: Ctrl+X M

适用场景

模型选择：为当前任务选择最佳模型
Provider 比较：查看各 Provider 提供的模型
功能匹配：查找具有特定功能的模型

/sessions

列出所有对话会话并在它们之间切换。

别名: /resume, /continue
快捷键: Ctrl+X L

适用场景

上下文切换：在不同项目间跳转
会话历史：查看过往对话
多项目工作：管理多个正在进行的任务

/themes

列出 TUI 界面的可用颜色主题。

适用场景

UI 自定义：个性化您的 OpenCode 界面
可见性：调整颜色以获得更好的可读性
偏好：匹配您的终端主题

工具集成

/editor

打开外部编辑器来编写更长的消息或提示。

快捷键: Ctrl+X E

适用场景

长提示：编写详细的指令
格式化输入：使用编辑器的功能
多行消息：更轻松地编写复杂查询

/export

以 Markdown 格式导出当前对话。

快捷键: Ctrl+X X

适用场景

文档记录：保存对话以供参考
共享：与团队成员分享对话
归档：保留重要交互的记录

创建当前对话的公开可分享链接。

快捷键: Ctrl+X S

适用场景

协作：与同事分享对话
支持请求：在寻求帮助时提供上下文
知识分享：传播有用的 AI 交互

/unshare

移除先前分享的对话的公开访问权限。

适用场景

隐私控制：撤销对话的公开访问
清理：删除旧的分享链接
安全：取消分享意外分享的敏感内容

系统配置

/connect

交互式地向 OpenCode 添加新的 AI Provider。

适用场景

设置：配置新的 AI Provider
添加 Provider：增加更多模型选项
密钥更新：更新或更改 Provider 凭据

/init

在您的项目中创建或更新 AGENTS.md 文件，以帮助 OpenCode 理解您的项目结构。

快捷键: Ctrl+X I

适用场景

项目设置：为新项目初始化 OpenCode
上下文改进：帮助 AI 理解项目结构
配置：更新项目元数据

/details

切换详细工具执行信息的显示。

快捷键: Ctrl+X D

适用场景

调试：查看 AI 正在执行的工具
学习：了解 OpenCode 的工作原理
透明度：详细监控 AI 操作

/thinking

切换 AI 思考过程和推理的显示。

适用场景

理解：查看 AI 如何处理问题
调试：识别推理问题
学习：从 AI 解决问题的方法中学习

帮助和退出

/help

显示帮助对话框，包含可用命令和快捷键。

快捷键: Ctrl+X H

适用场景

快速参考：查找可用命令
学习：发现新功能
快捷键：查找键盘快捷键

/exit

退出 OpenCode TUI。

别名: /quit, /q
快捷键: Ctrl+X Q

特殊语法

文件引用：`@filename`

在提示中引用文件内容，将其添加到对话上下文中。

语法

@path/to/file.ext

示例

解释这段代码：@src/main.go

将 @components/Header.tsx 重构为使用 hooks

审查这些文件：@api/users.ts @api/auth.ts

适用场景

代码审查：让 AI 分析特定文件
重构：为代码更改提供上下文
解释：获取代码的详细解释

Shell 命令：`!command`

执行 Shell 命令并将其输出包含在对话上下文中。

语法

!shell-command

示例

最近有什么变化？!git log -10 --oneline

分析测试失败：!npm test

审查目录结构：!tree -L 2 src/

适用场景

动态上下文：包含当前系统状态
错误分析：与 AI 分享错误输出
状态检查：在问题中包含命令输出

自定义命令

您可以通过在特定目录中放置 Markdown 文件来创建自定义斜杠命令。

文件位置

项目级（所有平台）：

<PROJECT_DIR>/.opencode/commands/

全局级（macOS/Linux）：

~/.config/opencode/commands/
# 或
$XDG_CONFIG_HOME/opencode/commands/

全局级（Windows）：

%APPDATA%\opencode\commands\

文件格式

自定义命令文件使用带 YAML 前置数据的 Markdown：

---
description: 命令的简短描述
agent: optional-agent-name
model: optional-model-name
---

命令内容或提示模板。

您可以使用占位符：
- $ARGUMENTS 用于用户提供的参数
- @filename 用于文件引用
- !command 用于 shell 命令

命名

文件名（不含 .md 扩展名）成为命令名称：

review-pr.md → /review-pr
generate-tests.md → /generate-tests

示例

文件：.opencode/commands/review-pr.md

---
description: 审查拉取请求更改
model: anthropic/claude-3.5-sonnet
---

请审查以下 PR 更改并提供：
1. 代码质量评估
2. 潜在的错误或问题
3. 改进建议

!git diff origin/main...HEAD

文件：.opencode/commands/explain.md

---
description: 详细解释代码
---

请详细解释：@$ARGUMENTS

包括：
- 目的和功能
- 关键组件
- 使用或违反的最佳实践
- 改进建议

最佳实践

其他提示：

使命令专注于单一任务
使用描述性名称
记录预期的参数
先在安全环境中测试命令
对项目级命令进行版本控制

斜杠命令参考

命令速查

会话控制

/new

/undo

/redo

/compact

导航和切换

/models

/sessions

/themes

工具集成

/editor

/export

/share

/unshare

系统配置

/connect

/init

/details

/thinking

帮助和退出

/help

/exit

特殊语法

文件引用：@filename

Shell 命令：!command

自定义命令

文件位置

文件格式

命名

示例

最佳实践

文件引用：`@filename`

Shell 命令：`!command`