OpenCode 应用实例与实操指南

针对常见开发场景的 OpenCode 使用示例：初始化、搭建功能、重构、调试、CI 改动与安全检查。

本页提供若干简短的实操配方，展示如何在日常开发工作中使用 OpenCode。每个配方都包含命令示例和建议的代理工作流（Plan → Build → Verify）。

1）初始化仓库上下文

首次在仓库中使用 OpenCode 时，生成项目上下文，帮助代理理解文件结构与依赖。

opencode init
# 输出示例：Analyzing project structure... Created AGENTS.md

工作流提示：先用 Plan 模式查看分析结果；首次写文件时把权限设为 ask。

2）快速搭建新功能（API + 测试）

目标：添加 POST /api/widgets，包括处理器、校验与测试。

流程与命令：

1. Plan：让代理列出将要创建的文件。

示例提示：“Plan: Add a new POST /api/widgets endpoint. List files, handlers, tests, and migrations (if any).”

2. Build：在确认计划后允许写入。

代理可能创建的文件：

• src/pages/api/widgets.ts
• src/lib/widgets.service.ts
• test/widgets.test.ts

3. Verify：运行测试并请代理修复失败项。

npm test -- test/widgets.test.ts

3）跨文件大规模重构

目标：将 getUserProfile 重命名为 fetchUserProfile，并更新所有 import 与文档。

建议：

• 用 Plan 模式生成安全的重构步骤并列出受影响文件。
• 如代理漏查文件，可使用 @explore find getUserProfile 强制搜索。
• 分阶段应用更改，每阶段跑类型检查或测试。

示例命令：