---
title: "了解生态系统"
description: "基于 OpenCode 构建的项目与集成。"
verifiedAt: "2026-05-09"
---

OpenCode 生态里有插件、客户端、编辑器集成、后台代理、通知工具、认证扩展、上下文管理和第三方项目。生态页的价值不是让你一次装满，而是帮你判断：哪个项目解决当前问题，哪个项目会扩大权限、凭据或上下文边界。

> [!NOTE]
> **这一篇用 8 分钟换什么**：你会知道官方 ecosystem 列表怎么读，哪些类别值得先看，安装社区项目之前要检查什么，以及什么时候应该回到内置能力、MCP、custom tool 或 plugin。

## 先给结论：生态项目先按风险分层

社区项目不是“越多越好”。先按它会影响的边界判断。

```mermaid
flowchart LR
    Need["当前问题"] --> Builtin{"内置能力能解决?"}
    Builtin -->|能| Stop["不安装生态扩展"]
    Builtin -->|不能| Scope{"影响什么边界?"}
    Scope --> UI["UI / 通知 / 统计"]
    Scope --> Context["上下文 / 搜索 / 记忆"]
    Scope --> Runtime["沙箱 / worktree / 后台代理"]
    Scope --> Auth["认证 / 模型额度"]
    Auth --> Review["重点审查凭据与合规"]
    Runtime --> Review["重点审查文件和命令权限"]
    Context --> Review["重点审查数据外发"]

    style Stop fill:#dcfce7,stroke:#22c55e
    style Review fill:#fee2e2,stroke:#ef4444,stroke-width:2px
```

> [!WARNING]
> 生态项目通常不是 OpenCode 核心团队维护。安装前要看源码、权限、维护状态、issue、release 和是否会接触密钥、文件系统、Git、网络或模型请求。

## 1. 官方列表怎么读

官方 ecosystem 页是社区项目合集，也欢迎通过 PR 补充项目。完整生态还可以看：

<Cards>
  <Card title="OpenCode ecosystem" description="官方维护的生态项目入口，适合查最新收录项目。" href="https://opencode.ai/docs/ecosystem" />
  <Card title="awesome-opencode" description="社区整理的 OpenCode 资源列表。" href="https://github.com/awesome-opencode/awesome-opencode" />
  <Card title="opencode.cafe" description="聚合 OpenCode 生态和社区资源的社区站点。" href="https://opencode.cafe" />
  <Card title="Plugin 文档" description="安装插件前先理解 plugin 能改变哪些运行时行为。" href="/docs/opencode/official/02-agents-skills/plugins" />
</Cards>

这类列表变化快。本页只做阅读和选择路径，不替代你安装前的安全审查。

## 2. 按场景看代表项目

### 沙箱、后台代理和工作区

- [opencode-daytona](https://github.com/daytonaio/daytona/tree/main/libs/opencode-plugin)：在 Daytona 沙箱里运行 OpenCode 会话，支持 git 同步和实时预览。
- [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers)：多分支 devcontainer 隔离。
- [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents)：Claude Code 风格后台代理。
- [opencode-workspace](https://github.com/kdcokenny/opencode-workspace)：多代理编排套件。
- [opencode-worktree](https://github.com/kdcokenny/opencode-worktree)：Git worktree 管理。
- [opencode-conductor](https://github.com/derekbar90/opencode-conductor)：Context → Spec → Plan → Implement 生命周期自动化。

这组项目通常会触碰文件系统、Git 分支、后台进程或容器。安装前先确认回滚方式和权限边界。

### 认证、模型和额度

- [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)：使用 ChatGPT Plus / Pro 订阅替代 API 额度。
- [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth)：使用 Gemini 套餐替代 API 计费。
- [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth)：使用 Antigravity 免费模型。
- [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth)：Google Antigravity OAuth 插件。

这组项目风险最高，因为会处理账号、token、OAuth 或模型请求。先确认是否符合 provider 服务条款、组织合规和你的凭据管理方式。

### 上下文、搜索、编辑和安全

- [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject)：把 TypeScript / Svelte 类型注入文件读取。
- [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning)：修剪过时工具输出，降低 token 成本。
- [opencode-vibeguard](https://github.com/inkdust2021/opencode-vibeguard)：在调用 LLM 前替换 secrets / PII，并本地恢复。
- [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git)：为受支持 provider 添加带引用的 websearch。
- [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply)：用 Morph Fast Apply 加速编辑。
- [opencode-morph-plugin](https://github.com/morphllm/opencode-morph-plugin)：Fast Apply、WarpGrep 和上下文压缩。
- [opencode-firecrawl](https://github.com/firecrawl/opencode-firecrawl)：通过 Firecrawl CLI 做网页抓取、爬取和搜索。

这组项目会改变模型看到的上下文或编辑方式。重点看是否会把代码、日志、网页内容或敏感文本发送到第三方服务。

### 通知、监控和使用统计

- [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session)：注入 Helicone session headers。
- [opencode-wakatime](https://github.com/angristan/opencode-wakatime)：用 Wakatime 跟踪使用情况。
- [opencode-notificator](https://github.com/panta82/opencode-notificator)、[opencode-notifier](https://github.com/mohak34/opencode-notifier)、[opencode-notify](https://github.com/kdcokenny/opencode-notify)：桌面通知和声音提醒。
- [opencode-sentry-monitor](https://github.com/stolinski/opencode-sentry-monitor)：用 Sentry AI Monitoring 追踪和调试 agent。

这组通常风险较低，但仍要看它们会记录哪些事件、发送到哪里、是否包含提示词、文件路径或错误输出。

### Shell、终端和调度

- [opencode-pty](https://github.com/shekohex/opencode-pty.git)：允许 agent 在 PTY（pseudo terminal，伪终端——把后台进程伪装成有真实终端的样子，让需要交互输入的命令以为有人在屏幕前按键）里运行后台进程并发送交互输入。
- [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy)：防止依赖 TTY 的 shell 命令挂起。
- [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer)：根据上下文自动命名 Zellij 会话。
- [opencode-scheduler](https://github.com/different-ai/opencode-scheduler)：用 launchd / systemd 调度周期性任务。
- [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main)：清理 LLM 生成的 Markdown 表格。

PTY 和调度类项目尤其要谨慎。后台进程和定时任务容易绕过人工确认。

### 客户端、编辑器和项目

- [kimaki](https://github.com/remorses/kimaki)：用 Discord 控制 OpenCode 会话，基于 SDK。
- [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim)、[opencode.nvim](https://github.com/sudo-tee/opencode.nvim)：Neovim 集成。
- [portal](https://github.com/hosenur/portal)：通过 Tailscale（基于 WireGuard 的零配置组网工具，把分散在不同地方的设备组成一个虚拟内网）/ VPN 使用的移动优先 Web UI。
- [OpenChamber](https://github.com/btriapitsyn/openchamber)：OpenCode 的 Web / Desktop app 和 VS Code extension。
- [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian)：把 OpenCode 嵌入 Obsidian。
- [OpenWork](https://github.com/different-ai/openwork)：由 OpenCode 驱动的协作产品。
- [ocx](https://github.com/kdcokenny/ocx)：OpenCode 扩展管理器。
- [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad)：桌面、Web、移动和远程客户端。

客户端类项目要特别看登录态、远程访问、文件访问和网络暴露。移动或 Web UI 不是普通前端页面，它可能成为项目读写入口。

### Agent、模板和编排

- [Agentic](https://github.com/Cluster444/agentic)：结构化开发用的模块化 agent 和 command。
- [opencode-agents](https://github.com/darrenhinde/opencode-agents)：配置、提示词、agents 和 plugins。
- [opencode-skillful](https://github.com/zenobi-us/opencode-skillful)：通过 skill discovery / injection 延迟加载提示词。
- [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2)：把 OpenCode `/commands` 扩展成更强编排系统。
- [micode](https://github.com/vtemian/micode)：Brainstorm → Plan → Implement 工作流。
- [octto](https://github.com/vtemian/octto)：用于 AI brainstorming 的交互式浏览器 UI。
- [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/)：构建 OpenCode plugin 的模板。
- [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk)：通过 `@opencode-ai/sdk` 使用 OpenCode 的 Vercel AI SDK provider。

这组项目会改变工作流结构。先确认你的问题是不是 rules、commands、agents、skills 已经能解决，再引入更复杂的编排。

## 3. 安装前检查

安装任何社区项目前，先检查：

| 检查项 | 为什么 |
| --- | --- |
| 最近维护状态 | 长期没人维护的插件容易跟 OpenCode 版本脱节 |
| 权限和数据流 | 是否读取文件、执行命令、上传日志、发送 prompt |
| 凭据处理 | 是否接触 API key、OAuth、浏览器登录态 |
| 回滚方式 | 出问题时能否禁用、卸载或恢复配置 |
| 作用范围 | 是项目级、全局级，还是后台常驻 |

> [!IMPORTANT]
> 生态项目一旦进入全局配置，就会影响所有项目。先在非敏感仓库、本地隔离环境或项目级配置里验证。

## 接下来去哪

<Cards>
  <Card title="Plugin" description="生态项目大多通过 plugin 改变运行时行为，安装前先理解边界。" href="/docs/opencode/official/02-agents-skills/plugins" />
  <Card title="自定义工具" description="如果只是封装项目专有动作，custom tool 可能比外部生态项目更可控。" href="/docs/opencode/official/04-tools-mcp/custom-tools" />
  <Card title="MCP" description="需要外部系统上下文时优先看 MCP，而不是随意安装插件。" href="/docs/opencode/official/04-tools-mcp/mcp-servers" />
  <Card title="安全与团队使用" description="生态扩展会改变数据边界，真实项目先看安全基线。" href="/docs/opencode/understanding/08-security-share-team" />
</Cards>

## 官方资料

- OpenCode Ecosystem：[https://opencode.ai/docs/ecosystem](https://opencode.ai/docs/ecosystem)
- awesome-opencode：[https://github.com/awesome-opencode/awesome-opencode](https://github.com/awesome-opencode/awesome-opencode)
- opencode.cafe：[https://opencode.cafe](https://opencode.cafe)
