AI 程式設計教程中文版
官方教程中文版整合

瞭解生態系統

基於 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 補充專案。完整生態還可以看:

這類列表變化快。本頁只做閱讀和選擇路徑,不替代你安裝前的安全審查。

2. 按場景看代表專案

沙箱、後臺代理和工作區

這組專案通常會觸碰檔案系統、Git 分支、後臺程序或容器。安裝前先確認回復方式和許可權邊界。

認證、模型和額度

這組專案風險最高,因為會處理賬號、token、OAuth 或模型請求。先確認是否符合 provider 服務條款、組織合規和你的憑據管理方式。

上下文、搜尋、編輯和安全

這組專案會改變模型看到的上下文或編輯方式。重點看是否會把程式碼、日誌、網頁內容或敏感文本傳送到第三方服務。

通知、監控和使用統計

這組通常風險較低,但仍要看它們會記錄哪些事件、傳送到哪裡、是否包含提示詞、檔案路徑或錯誤輸出。

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.nvimopencode.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、模板和編排

這組專案會改變工作流結構。先確認你的問題是不是 rules、commands、agents、skills 已經能解決,再引入更復雜的編排。

3. 安裝前檢查

安裝任何社群專案前,先檢查:

檢查項為什麼
最近維護狀態長期沒人維護的外掛容易跟 OpenCode 版本脫節
許可權和資料流是否讀取檔案、執行命令、上傳日誌、傳送 prompt
憑據處理是否接觸 API key、OAuth、瀏覽器登入態
回復方式出問題時能否停用、解除安裝或恢復配置
作用範圍是專案級、全域性級,還是後臺常駐

生態專案一旦進入全域性配置,就會影響所有專案。先在非敏感儲存庫、本地隔離環境或專案級配置裡驗證。

接下來去哪

官方資料

本頁目錄