opencode 生态探索 -- 定制化插件

文章大纲

• 架构解析
• • 插件文档原文
  • title: 插件 description: 编写自己的插件来扩展 OpenCode。
  • 使用插件
  • • 从本地文件加载
    • 从 npm 加载
    • 插件的安装方式
    • 加载顺序
  • 创建插件
  • • 依赖项
    • 基本结构
    • TypeScript 支持
    • 事件
    • • 命令事件
      • 文件事件
      • 安装事件
      • LSP 事件
      • 消息事件
      • 权限事件
      • 服务器事件
      • 会话事件
      • 待办事项事件
      • Shell 事件
      • 工具事件
      • TUI 事件
  • 示例
  • • 发送通知
    • .env 保护
    • 注入环境变量
    • 自定义工具
    • 日志记录
    • 压缩钩子
• 参考文献

架构解析

插件文档原文

title: 插件 description: 编写自己的插件来扩展 OpenCode。

插件允许你通过挂钩各种事件和自定义行为来扩展 OpenCode。你可以创建插件来添加新功能、集成外部服务，或修改 OpenCode 的默认行为。

如需了解示例，请查看社区创建的插件。

使用插件

有两种方式加载插件。

从本地文件加载

将 JavaScript 或 TypeScript 文件放置在插件目录中。

• .opencode/plugins/ – 项目级插件
• ~/.config/opencode/plugins/ – 全局插件

这些目录中的文件会在启动时自动加载。

从 npm 加载

在配置文件中