跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

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。