awesome-opencode 生态深度调研报告

生成时间: 2026-06-18 任务: 调研 OpenCode 生态及其与 Hermes Agent 的关系

1. 项目概况

1.1 OpenCode CLI（已归档）

1.2 Crush（官方继任者）

Crush 由 Charm 团队维护，支持 macOS / Linux / Windows / FreeBSD / OpenBSD / NetBSD / Android。

1.3 OpenCode Go（云 API 服务）

2. OpenCode CLI 核心功能

2.1 功能总览

2.2 命令行界面

opencode              # 启动 TUI
opencode -p "prompt"  # 单次非交互模式
opencode -c /path     # 指定工作目录
opencode -d           # 调试模式
opencode -f json      # JSON 输出

3. Crush（继任者）增强功能

3.1 重大增强

3.2 许可证差异

4. 架构分析

4.1 OpenCode 内部架构

opencode/
├── cmd/              # Cobra CLI 入口
├── internal/
│   ├── app/          # 核心应用服务
│   ├── config/       # 配置管理
│   ├── db/           # SQLite 数据库操作及迁移
│   ├── llm/          # LLM 提供商 + 工具集成
│   ├── tui/          # TUI 组件（Bubble Tea）
│   ├── logging/      # 日志基础设施
│   ├── message/      # 消息处理
│   ├── session/      # 会话管理
│   └── lsp/          # LSP 协议集成
└── go.mod            # Go 1.24.0

4.2 Crush 内部架构

crush/
├── cmd/              # CLI 入口
├── internal/
│   ├── agent/        # Agent 编排 + 工具 + 技能
│   │   ├── prompt/   # 提示词模板
│   │   ├── templates/# coder/task/title 模板
│   │   ├── tools/    # 内置工具集
│   │   │   └── mcp/  # MCP 工具集成
│   │   └── hyper/    # Charm Hyper provider
│   ├── backend/      # Agent 后端
│   ├── config/       # 配置 + 动态 MCP
│   ├── proto/        # 协议定义
│   ├── server/       # 服务端（crush serve）
│   └── ui/           # TUI + chat 组件
└── go.mod            # Go 1.26.4 + Charm v2

4.3 关键依赖对比

5. 支持的 LLM 提供商

5.1 OpenCode CLI

OpenAI（GPT-4.1/4o/o1/o3）、Anthropic（Claude 4/3.7/3.5）、Google Gemini、AWS Bedrock、Azure OpenAI、Groq、OpenRouter、GitHub Copilot、VertexAI、自托管。

5.2 Crush（通过 Catwalk）

Anthropic、OpenAI、Google Gemini、AWS Bedrock、Azure OpenAI、Groq、OpenRouter、Charm Hyper、Synthetic、Z.ai、MiniMax、Hugging Face、Cerebras、io.net、Alibaba、Avian、OpenCode（Zen & Go）、VertexAI、自定义兼容端点、Ollama、LM Studio。

5.3 OpenCode Go 云 API 模型清单

共 20 个模型，按 OpenAI 兼容 API 格式提供。

6. MCP 集成分析

6.1 OpenCode

• 传输: stdio, SSE
• 配置: .opencode.json 的 mcpServers 段
• 安全: 权限系统（每次调用需批准）
• 库: mark3labs/mcp-go v0.17.0

6.2 Crush

• 传输: stdio, HTTP, SSE（三传输）
• 增强特性:
  • Shell 值展开（$VAR,$(command)）
  • HTTP 传输自定义 Header
  • 每服务器独立超时设置
  • disabled_tools 支持禁用特定工具
  • Docker MCP 支持
• 代码结构: internal/agent/tools/mcp/

6.3 OpenCode Go 云 API 的 MCP 关系

OpenCode Go 云 API 本身不提供 MCP 服务器能力。它是模型推理网关。MCP 是 CLI 客户端的能力。

7. 与 Hermes Agent 的关系（重点）

7.1 集成模式

        Hermes Agent
            |
            |  模型推理（chat/completions）
            v
    +------------------+
    | OpenCode Go API  |  <-- 云网关（交易模式）
    | /zen/go/v1      |
    +--------+---------+
             |
    +--------+---------+
    | 模型聚合 20 个  |
    | DeepSeek / Qwen  |
    | GLM / Kimi / MM  |
    +------------------+

7.2 Hermes 配置中的 OpenCode

model:
  default: deepseek-v4-flash
  provider: opencode-go
  base_url: https://opencode.ai/zen/go/v1
  api_mode: chat_completions
  api_key: ${OPENCODE_GO_API_KEY}
 
auxiliary:
  vision:
    provider: opencode-go
    model: mimo-v2.5

7.3 Hermes 的 OpenCode 监控脚本

7.4 3 层自动降级架构

7.5 互补性分析

7.6 核心洞察

1. OpenCode Go 云 API 是 Hermes 的模型生命线：Hermes 的默认推理链路完全依赖 opencode-go 网关。若此服务不可用，将触发自动降级到 DeepSeek 直连。

2. Hermes 不直接使用 OpenCode CLI 或 Crush：Hermes 没有集成 OpenCode/Crush 作为子代理或工具。它使用的是 opencode-go 的云 API 端点。

3. OpenCode Go 模型聚合解决了中国区模型访问痛点：通过单一 API 端点，Hermes 可访问 DeepSeek、Qwen、GLM、Kimi、MiniMax 等多种中国顶级模型。

4. 三方生态拓扑:

Hermes Agent --模型推理--> OpenCode Go Cloud API
                              |
              DeepSeek  MiniMax  Kimi  GLM  Qwen  Mimo

5. Crush 作为 OpenCode 继任者 与 Hermes 无直接集成，但其 agentskills.io 标准和 Hermes Skills 系统概念一致，有互操作潜力。

8. 结论与建议

关键发现

1. OpenCode 生态已分裂为三部分：Archived 原始 CLI、Charm 的 Crush（25k+ stars）、商业云 API（opencode.ai/zen/go）。

2. Hermes 只消费云 API 部分，不使用 CLI 客户端。OpenCode/Crush 的 TUI、MCP 客户端、LSP、技能系统等与 Hermes 当前架构无直接关联。

3. OpenCode Go 云 API 对 Hermes 至关重要，不仅是默认提供商，还通过 3 层降级确保推理可靠性。

4. Crush 增长迅猛（25k+ vs 原版 13k），社区认可度高。

潜在集成方向

附录

A. OpenCode CLI 工具列表

B. Crush 内置工具

bash, edit, view, ls, grep, glob, fetch, web_fetch, web_search, sourcegraph, crush_info, crush_logs, download, diagnostics, job_kill, job_output, list_mcp_resources, read_mcp_resource, lsp_restart, mcp-*（动态）, references, rg, search, todos。

C. 参考资料

1. OpenCode 源码: https://github.com/opencode-ai/opencode
2. Crush 源码: https://github.com/charmbracelet/crush
3. Catwalk 提供商数据库: https://github.com/charmbracelet/catwalk
4. OpenCode Go 云 API: https://opencode.ai/zen/go/v1
5. Agent Skills 标准: https://agentskills.io
6. Hermes Agent 文档: https://hermes-agent.nousresearch.com/docs

2026-10-09 Codex 审阅

本文原始 Go 项目 opencode-ai/opencode 确已归档，其后续为 Charm Crush；这条项目线不能与当前仍维护、TypeScript 实现的 anomalyco/opencode 混为一谈。当前 OpenCode Go 官方页列出 Go $10/月、GoPlus$40/月两个计划，具有用量限制；原文 $60/月、20 个模型及本地账户路由均为旧记录，不能当成当前报价或账户状态。Zen 官方页另采用按量付费。Crush 的 FSL-1.1-MIT 为源码可见许可，不能笼统说所有商业部署都禁止，具体限制应读完整许可。本文 Hermes 提供商、监控脚本、自动降级状态未在本轮做运行验证，也不构成自动启用付费保底的授权。

• 归档 Go 项目
• 当前 OpenCode 项目
• Crush 完整许可
• OpenCode Go 官方计划
• Zen 官方定价模式