环境
- Reasonix 版本：v1.21.5（Windows）
- 插件版本：0.9.0-preview（main 分支）
问题现象
按 README 从 GitHub 仓库安装插件失败，Reasonix 拒绝该 manifest：
install_source: no installable manifest: reasonix-plugin.json: missing apiVersion; native manifests must declare reasonix.io/plugin/v2
本地补上 apiVersion: "reasonix.io/plugin/v2" 后再次校验，继续报错：
reasonix-plugin.json: json: unknown field "agents"
根因分析
Reasonix 插件 manifest 自 Extension Runtime v2 起只接受精确的 apiVersion: "reasonix.io/plugin/v2"，无 apiVersion 的 native manifest 一律拒绝，无 v1 双读/迁移路径。且 v2 严格校验未知字段（含顶层与 contributes/runtime 内部），本仓库将 skills/agents/commands/hooks/mcpServers 全放顶层，其中 agents 不是 v2 允许的顶层字段，必须位于 contributes 下。
复现步骤
git clone https://github.com/Plocr/Reasonix-computer-use- 在 Reasonix 中安装该插件
- 报错
missing apiVersion；补 apiVersion 后报 unknown field "agents"
建议修复
将 manifest 重组为 v2 标准结构，资源字段移入 contributes：
{
"apiVersion": "reasonix.io/plugin/v2",
"name": "computer-use",
"version": "0.9.0-preview",
"description": "Reasonix Computer Use — cross-platform desktop automation...",
"contributes": {
"skills": "skills",
"agents": ["agents"],
"commands": ["commands"],
"hooks": { /* 原 hooks 内容 */ },
"mcpServers": { "computer-use": { "command": "reasonix-computer-use.bat" } }
}
}
本地临时规避
我已在本机对仓库做最小本地适配（补 apiVersion + 字段移入 contributes）后安装成功，功能正常。但上游修复前每次重新拉取都需重复适配。
期望
将 reasonix-plugin.json 升级到 v2 规范
如可能，补充 CI 校验（如 reasonix plugin doctor）避免回归
环境
问题现象
按 README 从 GitHub 仓库安装插件失败，Reasonix 拒绝该 manifest：
install_source: no installable manifest: reasonix-plugin.json: missing apiVersion; native manifests must declare reasonix.io/plugin/v2
本地补上
apiVersion: "reasonix.io/plugin/v2"后再次校验，继续报错：reasonix-plugin.json: json: unknown field "agents"
根因分析
Reasonix 插件 manifest 自 Extension Runtime v2 起只接受精确的
apiVersion: "reasonix.io/plugin/v2"，无 apiVersion 的 native manifest 一律拒绝，无 v1 双读/迁移路径。且 v2 严格校验未知字段（含顶层与 contributes/runtime 内部），本仓库将skills/agents/commands/hooks/mcpServers全放顶层，其中agents不是 v2 允许的顶层字段，必须位于contributes下。复现步骤
git clone https://github.com/Plocr/Reasonix-computer-usemissing apiVersion；补 apiVersion 后报unknown field "agents"建议修复
将 manifest 重组为 v2 标准结构，资源字段移入
contributes：{ "apiVersion": "reasonix.io/plugin/v2", "name": "computer-use", "version": "0.9.0-preview", "description": "Reasonix Computer Use — cross-platform desktop automation...", "contributes": { "skills": "skills", "agents": ["agents"], "commands": ["commands"], "hooks": { /* 原 hooks 内容 */ }, "mcpServers": { "computer-use": { "command": "reasonix-computer-use.bat" } } } } 本地临时规避 我已在本机对仓库做最小本地适配（补 apiVersion + 字段移入 contributes）后安装成功，功能正常。但上游修复前每次重新拉取都需重复适配。 期望 将 reasonix-plugin.json 升级到 v2 规范 如可能，补充 CI 校验（如 reasonix plugin doctor）避免回归