Skip to content
FunCoding

Search

Search docs, Skills and MCP

扩展安装与管理

通过交互管理器或 CLI 安装、启停和更新扩展,区分生效范围与重载方式。

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

原生扩展可以打包上下文、MCP、命令、Skills、subagents 和 workflows。安装前检查提供的能力和设置需求,安装后再确认哪些已经启用。

交互管理器

运行 /extensions 或 /extensions manage,使用 Tab 或左右方向键切换三个标签:

标签操作
Discover搜索市场来源,Enter 查看和选择安装范围,Ctrl+R 重新拉取列表
Installed按范围查看,Space 启停,f 收藏,Enter 查看详情
Sources选择市场源,d 移除来源

扩展的 MCP 服务在其下方嵌套展示连接状态,可独立启停。在该交互管理器进行的更改立即热重载,不需要重启。

/extensions install <source> 也可在会话中安装。/extensions explore Gemini、/extensions explore ClaudeCode 会打开对应发现页面,不等于已经安装其中内容。

CLI 管理

qwen extensions install <source>
qwen extensions install <source> --scope project
qwen extensions enable extension-name
qwen extensions disable extension-name --scope=workspace
qwen extensions update extension-name
qwen extensions update --all
qwen extensions uninstall extension-name

CLI 修改在已有会话重启后体现,不要把交互热重载保证套用到外部命令。默认启用范围为用户、跨项目;--scope project 只对当前工作区启用,workspace 是它的别名。

用户范围禁用可在某个工作区单独启用。Installed 的范围分组说明启用范围;原生扩展通常保存在 ~/.qwen/extensions/<name>/,不表示项目范围一定在项目内复制一份。

安装副本与开发链接

从本地目录 install 会复制扩展,后续源目录变化需 update;qwen extensions link 面向本地开发,连接到开发目录,见开发流程。

不同来源的更新规则不同:npm 无版本跟随 latest、dist-tag 跟随对应标签、精确版本不再提示更新;Git 和 Release 规则见发布。

管理市场来源

qwen extensions sources add <source>
qwen extensions sources list
qwen extensions sources update <name>
qwen extensions sources remove <name>

来源可为 owner/repo、Git URL、marketplace.json 的 HTTPS URL 或本地路径。移除来源与卸载已安装扩展是不同操作;市场源提供发现列表,不会自动代表每个插件都已批准使用。

安装格式和 Git 版本边界见扩展来源,原生清单见manifest。