OpenCode Guide

第七章:实战技巧 —— 掌控智能体

掌握 OpenCode 的核心不是写出完美的代码,而是学会如何高效地与它协作。以下是每个高级用户必须掌握的技巧。

1. 核心工作流:先思考,后执行

OpenCode 提供两个内置 agent,通过 Tab 键快速切换:

Plan Mode plan agent (只读规划)
Build Mode build agent (默认执行)
  • plan agent (建议优先使用):在此模式下,OpenCode 无法修改文件。它会分析你的需求,给出一份详尽的执行计划。你可以对计划提出质疑、修改细节,直到满意。
  • build agent:在此模式下,OpenCode 会获得文件写入权限,开始真正地修改代码、运行命令。
技巧: 对于大型功能,先在 plan agent 下讨论清楚。一旦达成一致,切换到 build agent 并说:“Sounds good! Go ahead.”

2. 精准提供上下文 (@ 符号)

不要指望 AI 自动猜到你要修改哪个文件。使用 @ 符号可以触发模糊搜索,将特定的文件、文件夹甚至是整个模块作为上下文传递给 AI。

示例:"参考 @auth.ts 里的逻辑,在 @settings.ts 里实现同样的功能。"

3. 撤销与回溯 (/undo)

如果 OpenCode 的修改不符合预期,千万不要手动一个个文件去改回。使用 /undo 命令可以一键回滚。你可以连续运行多次 /undo 来回退到之前的任何状态。

4. 图片识别 (视觉能力)

如果你有一个 UI 需求,直接把截图拖进终端!OpenCode 可以分析图片的布局、颜色,并将其转化为代码。这在还原设计稿时非常高效。

常用命令速查表

命令 描述
/init 初始化当前项目 (生成 AGENTS.md)
/connect 配置模型提供商
/models 查看并切换当前可用模型
/undo 撤销上一次代码变更
/redo 重做刚刚撤销的修改
/share 生成并分享当前会话链接