210 lines
4.6 KiB
Markdown
210 lines
4.6 KiB
Markdown
# 🎯 OpenCode 速查手册
|
||
|
||
> **使用前必读**：遇到不懂的命令，直接复制给我翻译！
|
||
|
||
---
|
||
|
||
## 🚀 快速入门
|
||
|
||
```bash
|
||
# 启动 OpenCode
|
||
opencode
|
||
|
||
# 直接提问
|
||
opencode "帮我写一个函数"
|
||
|
||
# 查看帮助
|
||
/help
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 所有 / 命令速查
|
||
|
||
### 基础操作
|
||
|
||
| 命令 | 中文 | 用途 | 快捷键 | 别名 |
|
||
|-----|-----|------|-------|------|
|
||
| `/help` | 帮助 | 显示所有命令说明 | `Ctrl+x h` | - |
|
||
| `/exit` | 退出 | 退出程序 | `Ctrl+x q` | `/quit`, `/q` |
|
||
| `/new` | 新建 | 开始全新会话 | `Ctrl+x n` | `/clear` |
|
||
| `/undo` | 撤销 | 撤销上一步 | `Ctrl+x u` | - |
|
||
| `/redo` | 重做 | 恢复撤销 | `Ctrl+x r` | - |
|
||
|
||
### 会话管理
|
||
|
||
| 命令 | 中文 | 用途 | 快捷键 | 别名 |
|
||
|-----|-----|------|-------|------|
|
||
| `/sessions` | 会话 | 查看历史会话 | `Ctrl+x l` | `/resume`, `/continue` |
|
||
| `/compact` | 精简 | 压缩对话历史 | `Ctrl+x c` | `/summarize` |
|
||
| `/share` | 分享 | 生成分享链接 | `Ctrl+x s` | - |
|
||
| `/unshare` | 取消分享 | 删除分享链接 | - | - |
|
||
| `/export` | 导出 | 保存对话记录 | `Ctrl+x x` | - |
|
||
|
||
### 工具设置
|
||
|
||
| 命令 | 中文 | 用途 | 快捷键 |
|
||
|-----|-----|------|-------|
|
||
| `/details` | 详情 | 显示执行细节 | `Ctrl+x d` |
|
||
| `/thinking` | 思考 | 显示AI推理过程 | - |
|
||
| `/editor` | 编辑器 | 用外部编辑器 | `Ctrl+x e` |
|
||
| `/models` | 模型 | 切换AI模型 | `Ctrl+x m` |
|
||
| `/themes` | 主题 | 切换界面主题 | `Ctrl+x t` |
|
||
| `/connect` | 连接 | 添加API配置 | - |
|
||
| `/init` | 初始化 | 创建项目配置 | `Ctrl+x i` |
|
||
|
||
---
|
||
|
||
## 🎮 必知快捷键
|
||
|
||
### 最常用的 5 个
|
||
|
||
| 快捷键 | 功能 |
|
||
|-------|------|
|
||
| `Tab` | 自动补全（最重要！） |
|
||
| `↑ / ↓` | 命令历史 |
|
||
| `Ctrl + L` | 清空屏幕 |
|
||
| `Ctrl + C` | 取消/中断 |
|
||
| `Esc` | 退出当前操作 |
|
||
|
||
### OpenCode 专用快捷键
|
||
|
||
| 快捷键 | 功能 |
|
||
|-------|------|
|
||
| `Ctrl+x h` | 打开帮助 |
|
||
| `Ctrl+x n` | 新建会话 |
|
||
| `Ctrl+x u` | 撤销 |
|
||
| `Ctrl+x r` | 重做 |
|
||
| `Ctrl+x l` | 会话列表 |
|
||
| `Ctrl+x c` | 精简会话 |
|
||
| `Ctrl+x s` | 分享 |
|
||
| `Ctrl+x x` | 导出 |
|
||
| `Ctrl+x d` | 显示详情 |
|
||
| `Ctrl+x e` | 打开编辑器 |
|
||
| `Ctrl+x m` | 模型列表 |
|
||
| `Ctrl+x t` | 切换主题 |
|
||
| `Ctrl+x i` | 初始化 |
|
||
| `Ctrl+x q` | 退出 |
|
||
|
||
---
|
||
|
||
## 💡 常见使用场景
|
||
|
||
### 场景 1：我想新建一个会话
|
||
```
|
||
输入：/new
|
||
或按：Ctrl+x n
|
||
```
|
||
|
||
### 场景 2：我想撤销刚才的操作
|
||
```
|
||
输入：/undo
|
||
或按：Ctrl+x u
|
||
```
|
||
|
||
### 场景 3：对话太长了，想精简一下
|
||
```
|
||
输入：/compact
|
||
或按：Ctrl+x c
|
||
```
|
||
|
||
### 场景 4：我想分享给朋友看
|
||
```
|
||
输入：/share
|
||
或按：Ctrl+x s
|
||
```
|
||
|
||
### 场景 5：我想用 VS Code 写代码
|
||
```
|
||
输入：/editor
|
||
或按：Ctrl+x e
|
||
（需设置 EDITOR 环境变量）
|
||
```
|
||
|
||
### 场景 6：我想查看历史会话
|
||
```
|
||
输入：/sessions
|
||
或按：Ctrl+x l
|
||
```
|
||
|
||
### 场景 7：我不知道怎么办了
|
||
```
|
||
输入：/help
|
||
或按：Ctrl+x h
|
||
```
|
||
|
||
---
|
||
|
||
## 🖥️ 终端基础命令
|
||
|
||
| 命令 | 用途 |
|
||
|-----|------|
|
||
| `ls` | 列出文件 |
|
||
| `ls -la` | 详细列表 |
|
||
| `cd 目录` | 进入目录 |
|
||
| `cd ..` | 返回上级 |
|
||
| `pwd` | 显示路径 |
|
||
| `mkdir 文件夹` | 创建文件夹 |
|
||
| `rm 文件` | 删除文件 |
|
||
| `cp 文件1 文件2` | 复制文件 |
|
||
| `mv 文件1 文件2` | 移动/重命名 |
|
||
|
||
---
|
||
|
||
## 📝 提问模板
|
||
|
||
### ❌ 错误示范
|
||
```
|
||
"帮我写代码"
|
||
"为什么报错"
|
||
"帮我看看"
|
||
```
|
||
|
||
### ✅ 正确示范
|
||
```
|
||
"用 Python 写一个登录函数，包含密码加密"
|
||
"这段代码报错了：{粘贴错误信息}，帮我修复"
|
||
"帮我看看 src/app.js 这个文件，有没有性能问题"
|
||
```
|
||
|
||
---
|
||
|
||
## 🆘 遇到问题怎么办？
|
||
|
||
| 问题 | 解决方法 |
|
||
|-----|---------|
|
||
| 命令不认识 | 复制给我："这个命令怎么用？" |
|
||
| 不知道怎么说 | 直接描述需求，我会引导你 |
|
||
| 想要快捷键列表 | 说："快捷键" |
|
||
| 想看所有命令 | 说："命令" |
|
||
| 想退出 | 按 `Ctrl+x q` 或输入 `/exit` |
|
||
|
||
---
|
||
|
||
## 📌 记住这 5 个就够用
|
||
|
||
1. **`/help`** - 不知道怎么办时就打这个
|
||
2. **`/new`** - 想重新开始时用
|
||
3. **`/undo`** - 做错时赶紧撤销
|
||
4. **`/share`** - 想分享时用
|
||
5. **`/compact`** - 对话太长时精简
|
||
|
||
---
|
||
|
||
## 🔗 有用的中文文档
|
||
|
||
| 文件 | 说明 |
|
||
|-----|------|
|
||
| `~/.opencode/zh-all-commands.md` | 所有命令详解 |
|
||
| `~/.opencode/zh-shortcuts.md` | 快捷键完整版 |
|
||
| `~/.opencode/zh-quick-start.md` | 快速入门 |
|
||
| `~/.opencode/zh-commands.md` | 命令速查表 |
|
||
|
||
---
|
||
|
||
> **最后记住**：有任何问题，直接问我！我会用中文回答你。😊
|
||
|
||
---
|
||
|
||
*文档创建时间：2026-02-06*
|