OpenCode

1. 安装

1.1. Windows

scoop install main/opencode           # 安装OpenCode
echo 'export EDITOR=vim' >> ~/.bashrc # 设置外部编辑器

1.2. Linux

npm install -g opencode-ai            # 安装OpenCode
echo 'export EDITOR=vim' >> ~/.bashrc # 设置外部编辑器

2. 基础

  • OpenCode将所有会话数据保存到同一个SQLite数据库中, 通常位于~/.local/share/opencode/opencode.db(Linux)或%USERPROFILE%\.local\share\opencode\opencode.db(Windows)
  • OpenCode用不同的目录来隔离不同的项目, 每个目录内仅保存该项目关联的会话(/sessions, 目录感知)
  • OpenCode包括Plan模式和Build模式, Plan模式不会进行任何修改, 只提供建议, Build模式会根据Plan模式的建议进行修改
  • OpenCode的操作权限包括:
    • allow: 直接执行, 不询问
    • ask: 询问后执行
    • deny: 拒绝执行
  • 操作权限的设置可通过配置文件实现, 配置文件位于%USERPROFILE%\.config\opencode\下的opencode.json或opencode.jsonc(带注释)

3. 使用

一般使用tui(Terminal User Interface)模式, 进入项目目录后, 直接运行opencode即可

4. 常用命令

4.1. /models

列出当前可用模型, 进行切换模型

4.2. /variants

推理等级, 表示思考强度和token消耗快慢

4.3. /connect

添加新的提供商, 设置密钥

4.4. /init

OpenCode会分析项目结构和编码规范, 在根目录下生成一个AGENTS.md文件

4.5. /compact

压缩当前项目的会话数据, 减少上下文长度, 减少token消耗

4.6. /exit

退出OpenCode

4.7. /session

列出当前项目的所有会话

4.8. /new

创建一个新的会话

4.9. /rename

重命名当前会话标题

4.10. /fork

从当前会话中任一历史结点创建一个新的会话分支, 该会话分支将继承该结点之前的所有上下文, 避免污染当前会话

4.11. /timeline

显示当前会话的所有历史结点, 选择一个结点, 用于还原到任一历史结点, 或复制提交消息到粘贴板, 或进行fork操作

4.12. /undo, /redo

撤销/重做当前会话的操作, 仅在Build模式下有效

4.13. /editor

调用外部编辑器来输入

  • export EDITOR=vim 临时设置
  • echo 'export EDITOR=vim' >> ~/.bashrc 永久设置

5. 辅助功能

5.1. Ctrl+P

显示所有命令和快捷键

5.2. Esc

打断当前思考或执行操作

@

引用文件或目录, 将其内容作为上下文传递给模型

5.3. 显示窗口滚动条

按Ctrl+P打开命令窗口, 输入Toggle session scrollbar, 回车即可显示窗口滚动条

Copyright © gendloop 2024 all right reserved,powered by Gitbook该文件修订时间: 2026-11-18 15:20:15

results matching ""

    No results matching ""