瞭解生態系統
基於 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