ai-mcp:修正 README 中证据不足的断言
「v2 不再自动扫描全局 plugins/ 一级文件」这条没有实测支撑—— 注册与未注册两种情况都被 401 + 「session 才加载」挡住,从未触发 session, 无法区分。改为如实标注「已确认 / 待确认」: - 已确认:session 初始化才加载;v2 对 default 有 schema 校验 - 待确认:一级文件是否自动扫描(按 v2 文档显式注册,属官方支持路径) 另补:plugins 数组只放 server 插件,TUI 插件放 tui.json。
This commit is contained in:
@@ -7,11 +7,22 @@
|
||||
|
||||
---
|
||||
|
||||
## 一、安装(v2 必须显式注册,这是踩过的坑)
|
||||
## 一、安装
|
||||
|
||||
> **实测结论**:OpenCode **v2 不再自动扫描全局 `~/.config/opencode/plugins/` 下的一级文件**。
|
||||
> v2 只自动发现**项目级** `.opencode/plugins/<name>/index.ts`。
|
||||
> 全局插件必须写进 `opencode.json(c)` 的 **`plugins` 数组**,否则文件放进去**根本不会被 import**。
|
||||
> **加载机制(已确认 / 待确认)**
|
||||
>
|
||||
> - ✅ **已确认**:插件在 **session 初始化时**才加载,不是进程启动时。
|
||||
> 只启动 `opencode serve` 而不建 session,**看不到任何插件日志**
|
||||
> (`opencode-btw` 的报错都带 `http.span=` 即为证据)。
|
||||
> - ✅ **已确认**:OpenCode v2 对 default 导出有 schema 校验,缺则报
|
||||
> `Plugin must export a default definition with an id and an effect or setup function.`,
|
||||
> 所以 default 导出**必须**给。
|
||||
> - ⚠️ **本轮未能验证**:全局 `~/.config/opencode/plugins/` 下的一级 `.ts` 文件
|
||||
> 是否会被自动扫描。验证被 401(服务密码)+「session 才加载」双重挡住,
|
||||
> 注册与未注册两种情况都没触发 session,无法区分。
|
||||
> v2 官方文档的说法是:只自动发现**项目级** `.opencode/plugins/<name>/index.ts`,
|
||||
> 全局插件走 `opencode.json` 的 `plugins` 数组显式加载。
|
||||
> **本仓库按文档显式注册(见下),这是官方支持的可靠路径。**
|
||||
|
||||
把插件复制到全局插件目录:
|
||||
|
||||
@@ -32,6 +43,9 @@ C:\Users\<你>\.config\opencode\plugins\ai-mcp.ts # Windows
|
||||
}
|
||||
```
|
||||
|
||||
> `plugins` 数组只放 **server 插件**;TUI-only 插件(`{ id, tui }`)放进去会被
|
||||
> server loader 拒绝,它们的注册位置是 `tui.json` 的 `plugin` 数组。
|
||||
|
||||
依赖:插件目录下需有 `package.json` 声明 `@opencode-ai/plugin` 并装好
|
||||
(OpenCode 启动时会跑 `bun install`;WSL 没有 bun 时手动 `npm install --omit=dev`)。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user