了解生态系统
基于 OpenCode 构建的项目与集成。
OpenCode 生态里有插件、客户端、编辑器集成、后台代理、通知工具、认证扩展、上下文管理和第三方项目。生态页的价值不是让你一次装满,而是帮你判断:哪个项目解决当前问题,哪个项目会扩大权限、凭据或上下文边界。
这一篇用 8 分钟换什么:你会知道官方 ecosystem 列表怎么读,哪些类别值得先看,安装社区项目之前要检查什么,以及什么时候应该回到内置能力、MCP、custom tool 或 plugin。
先给结论:生态项目先按风险分层
社区项目不是“越多越好”。先按它会影响的边界判断。
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
生态项目通常不是 OpenCode 核心团队维护。安装前要看源码、权限、维护状态、issue、release 和是否会接触密钥、文件系统、Git、网络或模型请求。
1. 官方列表怎么读
官方 ecosystem 页是社区项目合集,也欢迎通过 PR 补充项目。完整生态还可以看:
OpenCode ecosystem
官方维护的生态项目入口,适合查最新收录项目。
awesome-opencode
社区整理的 OpenCode 资源列表。
opencode.cafe
聚合 OpenCode 生态和社区资源的社区站点。
Plugin 文档
安装插件前先理解 plugin 能改变哪些运行时行为。
这类列表变化快。本页只做阅读和选择路径,不替代你安装前的安全审查。
2. 按场景看代表项目
沙箱、后台代理和工作区
- opencode-daytona:在 Daytona 沙箱里运行 OpenCode 会话,支持 git 同步和实时预览。
- opencode-devcontainers:多分支 devcontainer 隔离。
- opencode-background-agents:Claude Code 风格后台代理。
- opencode-workspace:多代理编排套件。
- opencode-worktree:Git worktree 管理。
- opencode-conductor:Context → Spec → Plan → Implement 生命周期自动化。
这组项目通常会触碰文件系统、Git 分支、后台进程或容器。安装前先确认回滚方式和权限边界。
认证、模型和额度
- opencode-openai-codex-auth:使用 ChatGPT Plus / Pro 订阅替代 API 额度。
- opencode-gemini-auth:使用 Gemini 套餐替代 API 计费。
- opencode-antigravity-auth:使用 Antigravity 免费模型。
- opencode-google-antigravity-auth:Google Antigravity OAuth 插件。
这组项目风险最高,因为会处理账号、token、OAuth 或模型请求。先确认是否符合 provider 服务条款、组织合规和你的凭据管理方式。
上下文、搜索、编辑和安全
- opencode-type-inject:把 TypeScript / Svelte 类型注入文件读取。
- opencode-dynamic-context-pruning:修剪过时工具输出,降低 token 成本。
- opencode-vibeguard:在调用 LLM 前替换 secrets / PII,并本地恢复。
- opencode-websearch-cited:为受支持 provider 添加带引用的 websearch。
- opencode-morph-fast-apply:用 Morph Fast Apply 加速编辑。
- opencode-morph-plugin:Fast Apply、WarpGrep 和上下文压缩。
- opencode-firecrawl:通过 Firecrawl CLI 做网页抓取、爬取和搜索。
这组项目会改变模型看到的上下文或编辑方式。重点看是否会把代码、日志、网页内容或敏感文本发送到第三方服务。
通知、监控和使用统计
- opencode-helicone-session:注入 Helicone session headers。
- opencode-wakatime:用 Wakatime 跟踪使用情况。
- opencode-notificator、opencode-notifier、opencode-notify:桌面通知和声音提醒。
- opencode-sentry-monitor:用 Sentry AI Monitoring 追踪和调试 agent。
这组通常风险较低,但仍要看它们会记录哪些事件、发送到哪里、是否包含提示词、文件路径或错误输出。
Shell、终端和调度
- opencode-pty:允许 agent 在 PTY(pseudo terminal,伪终端——把后台进程伪装成有真实终端的样子,让需要交互输入的命令以为有人在屏幕前按键)里运行后台进程并发送交互输入。
- opencode-shell-strategy:防止依赖 TTY 的 shell 命令挂起。
- opencode-zellij-namer:根据上下文自动命名 Zellij 会话。
- opencode-scheduler:用 launchd / systemd 调度周期性任务。
- opencode-md-table-formatter:清理 LLM 生成的 Markdown 表格。
PTY 和调度类项目尤其要谨慎。后台进程和定时任务容易绕过人工确认。
客户端、编辑器和项目
- kimaki:用 Discord 控制 OpenCode 会话,基于 SDK。
- opencode.nvim、opencode.nvim:Neovim 集成。
- portal:通过 Tailscale(基于 WireGuard 的零配置组网工具,把分散在不同地方的设备组成一个虚拟内网)/ VPN 使用的移动优先 Web UI。
- OpenChamber:OpenCode 的 Web / Desktop app 和 VS Code extension。
- OpenCode-Obsidian:把 OpenCode 嵌入 Obsidian。
- OpenWork:由 OpenCode 驱动的协作产品。
- ocx:OpenCode 扩展管理器。
- CodeNomad:桌面、Web、移动和远程客户端。
客户端类项目要特别看登录态、远程访问、文件访问和网络暴露。移动或 Web UI 不是普通前端页面,它可能成为项目读写入口。
Agent、模板和编排
- Agentic:结构化开发用的模块化 agent 和 command。
- opencode-agents:配置、提示词、agents 和 plugins。
- opencode-skillful:通过 skill discovery / injection 延迟加载提示词。
- @openspoon/subtask2:把 OpenCode
/commands扩展成更强编排系统。 - micode:Brainstorm → Plan → Implement 工作流。
- octto:用于 AI brainstorming 的交互式浏览器 UI。
- opencode plugin template:构建 OpenCode plugin 的模板。
- ai-sdk-provider-opencode-sdk:通过
@opencode-ai/sdk使用 OpenCode 的 Vercel AI SDK provider。
这组项目会改变工作流结构。先确认你的问题是不是 rules、commands、agents、skills 已经能解决,再引入更复杂的编排。
3. 安装前检查
安装任何社区项目前,先检查:
| 检查项 | 为什么 |
|---|---|
| 最近维护状态 | 长期没人维护的插件容易跟 OpenCode 版本脱节 |
| 权限和数据流 | 是否读取文件、执行命令、上传日志、发送 prompt |
| 凭据处理 | 是否接触 API key、OAuth、浏览器登录态 |
| 回滚方式 | 出问题时能否禁用、卸载或恢复配置 |
| 作用范围 | 是项目级、全局级,还是后台常驻 |
生态项目一旦进入全局配置,就会影响所有项目。先在非敏感仓库、本地隔离环境或项目级配置里验证。
接下来去哪
Plugin
生态项目大多通过 plugin 改变运行时行为,安装前先理解边界。
自定义工具
如果只是封装项目专有动作,custom tool 可能比外部生态项目更可控。
MCP
需要外部系统上下文时优先看 MCP,而不是随意安装插件。
安全与团队使用
生态扩展会改变数据边界,真实项目先看安全基线。
官方资料
- OpenCode Ecosystem:https://opencode.ai/docs/ecosystem
- awesome-opencode:https://github.com/awesome-opencode/awesome-opencode
- opencode.cafe:https://opencode.cafe