Agent Plugins v1 支持范围
原生加载便携插件,核对标准 manifest、Skills、MCP 与未激活能力。
Agent Plugins v1 是便携包格式,不是另一个 marketplace。Qwen 使用现有扩展来源安装,但保留原 plugin.json、mcp.json、SKILL.md,不生成 qwen-extension.json 或改写标准文件。
根清单与安装
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "my-agent-plugin",
"version": "1.0.0"
}必须使用该 canonical v1 schema。可以从本地目录、link、归档、Git、归档 URL 或 scoped npm 安装,例如:
qwen extensions install ./my-agent-plugin
qwen extensions link ./my-agent-plugin
qwen extensions install owner/my-agent-plugin这些命令是替代选择,不需要对同一插件依次执行。
支持矩阵
| 能力 | 当前行为 |
|---|---|
直接子目录 skills/*/SKILL.md | 支持 |
| stdio MCP | 支持 |
| Streamable HTTP MCP | 支持 |
| 旧 HTTP+SSE MCP | 跳过该条目 |
| commands、agents、hooks | 忽略目录 |
| workflows | 忽略目录 |
| Qwen context、settings、channels、apps | 不支持 |
| extensions.* 客户端命名空间 | 未实现项忽略 |
需要原生 Qwen 全部扩展能力时应使用对应原生格式,不能只在便携包内增添同名目录就期待启用。
Skills 与权限
Skills 遵循 Agent Skills 规范,单个无效 Skill 会跳过,不连带禁用有效兄弟项。实验字段 allowed-tools 可以识别为字符串,但不会授予 Qwen 工具预批准权限。
MCP 变量与地址
stdio 的 args、环境变量值、cwd 可展开 ${PLUGIN_ROOT}、${PLUGIN_DATA},只展开一次。PLUGIN_DATA 是每次安装对应的可写目录,内容跨更新与重装保留,不是可随升级丢弃的临时目录。
远程 MCP 必须 HTTPS,只有回环端点允许 HTTP。便携包支持的 MCP 传输比原生扩展少,遇到 SSE 条目未加载时应检查格式支持,不能只增加 timeout。