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、浏览器登录态
回滚方式出问题时能否禁用、卸载或恢复配置
作用范围是项目级、全局级,还是后台常驻

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

接下来去哪

官方资料

本页目录