插件开发 (Plugins)

这是什么？

插件系统允许你扩展 OpenCode 的 UI 和功能。通过编写插件，你可以添加新的侧边栏面板、状态栏项目、自定义渲染器（如渲染 Mermaid 图表）或者拦截和修改 AI 的消息流。

什么时候你会用到它？

• 当你觉得默认的 Markdown 渲染器不够好用，想开发一个支持 LaTeX 公式的增强版时。
• 当你需要为公司内部的专有 DSL 语言提供特定的语法高亮和补全支持时。
• 当你希望在 AI 生成代码后，自动弹出一个“一键部署”的按钮时。

核心概念

• Extension Manifest：描述插件元数据的 package.json 文件。
• Activation Events：触发插件加载的事件（如“打开了 .java 文件”）。
• Webview API：在侧边栏中渲染自定义 HTML/React 界面的能力。

基本用法 / 配置说明

TODO：后续补充 opencode-plugin-template 脚手架的使用方法

常见误解 / 注意事项

• OpenCode 插件与 VS Code 插件并不完全通用，虽然 API 风格相似。
• 插件运行在独立的沙箱进程中，无法直接访问主进程的内存。

延伸阅读

TODO：后续补充