Skip to content
FunCoding

Search

Search docs, Skills and MCP

Agent Plugins v1 支持范围

原生加载便携插件,核对标准 manifest、Skills、MCP 与未激活能力。

This page has not been translated into English yet. The original Chinese version is shown below.

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。