插件 SDK。src/index.ts:20-80 定义 Plugin/PluginInput/Config/Hooks 等公共类型,基于 @opencode-ai/sdk 客户端访问服务;src/tool.ts:3-20 定义 ToolContext/ToolResult。提供 v2 双运行时:effect 版(src/v2/effect/:plugin/context/agent/command/skill/catalog/integration/filesystem/event 等 14 模块)与 promise 版(src/v2/promise/),并含 TUI 插件类型(src/tui.ts:1-40 基于 @opentui)。
· 插件公共类型与 Hooks 契约(packages/plugin/src/index.ts:20-80)
· 工具 API:ToolContext/ToolDefinition/ToolResult(packages/plugin/src/tool.ts:3-20)
· Effect 原生 v2 插件 API:agent/command/skill/catalog/integration 注册(packages/plugin/src/v2/effect/plugin.ts)
· Promise 风格 v2 插件 API(packages/plugin/src/v2/promise/index.ts)
· TUI 插件接口(基于 @opentui,packages/plugin/src/tui.ts:19-33)
· shell 工具封装(packages/plugin/src/shell.ts)
| 节点 | 机制 | 证据 |
|---|---|---|
| sdk | workspace-dep | @opencode-ai/plugin/package.json dependencies.@opencode-ai/sdk |
| plan | agent-core | 装配层→官方包 |
| build | agent-core | 装配层→官方包 |
| 节点 | 机制 | 证据 |
|---|---|---|
| core | workspace-dep | @opencode-ai/core/package.json dependencies.@opencode-ai/plugin |
| tui | workspace-dep | @opencode-ai/tui/package.json dependencies.@opencode-ai/plugin |
| opencode | semantic-dep | stage-01 opencode |
作为第三方扩展的稳定 SDK 面(发布到 npm,files 只含 dist),把 opencode 对插件的实现细节隔离在 core 内部,对外只暴露类型化、版本化的注册 API。
官方底座,未被本机装配层直接引用