1. OpenCode Agent 系统概述
OpenCode 的 Agent 系统是一个革命性的 AI 编程辅助架构,它通过主从 Agent 的协同工作模式,将传统的线性编程流程转变为高效的并行处理系统。这个设计理念源自现代软件开发中常见的团队分工模式 - 就像在真实开发团队中,项目经理负责整体协调,而专业开发人员各自负责特定模块一样。
1.1 核心架构设计
系统采用分层架构设计:
code复制主 Agent 层 (Build/Plan)
│
├─ 自动任务分发 ──► 通用子 Agent (@general)
│
├─ 自动任务分发 ──► 代码探索子 Agent (@explore)
│
└─ 手动调用接口 ──► 用户自定义子 Agent (@your-agent)
这种架构带来了三个显著优势:
- 职责分离:主 Agent 专注于任务调度和整体协调,子 Agent 则深耕专业领域
- 资源优化:可以根据任务类型分配不同的计算资源(如为代码审查使用轻量级模型)
- 安全隔离:通过权限控制确保关键操作受到保护
1.2 主 Agent 类型解析
OpenCode 提供两种主 Agent,各自针对不同的工作场景:
| Agent 类型 | 核心功能 | 典型使用场景 | 模型推荐配置 |
|---|---|---|---|
| Build | 全功能开发助手 | 代码编写、系统实现、调试 | Claude Sonnet 等大模型 |
| Plan | 只读分析与规划 | 架构设计、任务分解、方案评估 | Claude Haiku 等快速模型 |
实际使用中发现,Plan Agent 在大型项目初期规划阶段特别有价值。它能在不修改代码的情况下,快速分析项目结构并提出优化建议,避免了早期设计失误。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 子 Agent 系统深度解析
2.1 内置子 Agent 功能矩阵
OpenCode 预置了两个专业子 Agent,形成基础能力矩阵:
| 子 Agent | 核心能力 | 权限配置 | 典型调用场景 |
|---|---|---|---|
| @general | 多步骤任务处理 | 读写权限可控 | 复杂逻辑实现、第三方库研究 |
| @explore |
