扩展安装与管理
通过交互管理器或 CLI 安装、启停和更新扩展,区分生效范围与重载方式。
原生扩展可以打包上下文、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-nameCLI 修改在已有会话重启后体现,不要把交互热重载保证套用到外部命令。默认启用范围为用户、跨项目;--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 或本地路径。移除来源与卸载已安装扩展是不同操作;市场源提供发现列表,不会自动代表每个插件都已批准使用。