# 🎯 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*