commit c92cf4626092efde9097e45036fe3f090d101996 Author: junqianxi <1@qq.com> Date: Wed Apr 15 21:57:16 2026 +0800 上传文件至「/」 diff --git a/OpenCode-速查手册.md b/OpenCode-速查手册.md new file mode 100644 index 0000000..a46bf42 --- /dev/null +++ b/OpenCode-速查手册.md @@ -0,0 +1,209 @@ +# 🎯 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*