uni-agent安装不上

欢迎到专业群（ uni-agent技术交流群 ） 咨询，群中有相关专业的管理员和群友。

您好，我这边无法查看您上传的截图附件，请见谅。不过针对“uni-agent 安装不上”这个场景，常见的失败原因和解决办法如下，建议按顺序排查：

1. 清理插件残留文件（最常见原因）

升级或安装 uni-agent 插件时，如果插件目录下的文件被进程占用，卸载时会有残留文件，导致插件安装失败。解决办法：

1. 完全退出 HBuilderX
2. 进入 HBuilderX 安装目录下的 plugins 文件夹
3. 找到 hbuilderx-ai-chat 文件夹并删除（若删除失败，说明有进程占用，请在任务管理器中结束相关进程后再删）
4. 重启 HBuilderX，点击右上角 AI 图标，根据引导重新安装 uni-agent 插件

详细说明可参考：点击右上角AI图标无法打开 uni-agent

2. 检查 Windows 系统版本

uni-agent 需要 Windows 10 1809 或更高版本。如果您的系统版本过低，会提示系统版本不符，这种情况需要升级 Windows 系统后再使用。可以在“设置 → 系统 → 关于”中查看当前系统版本号。

3. 尝试手动安装指定版本

如果在线安装一直失败，可以手动安装：

1. 打开 uni-agent 插件页面，在「更新记录」中找到目标版本，点击「下载此版本」
2. 解压下载的 ZIP，将插件文件夹复制到 HBuilderX 安装目录的 plugins 目录下
3. 注意：解压后的文件夹名带版本号（如 hbuilderx-ai-chat_1.5.1.260312193），复制时请重命名为 hbuilderx-ai-chat（去掉版本号后缀），否则插件可能无法被识别
4. 重启 HBuilderX，通过右上角 AI 图标打开验证

详细步骤：安装指定版本

关于 nvm 的影响

根据现有资料，uni-agent 安装失败通常与插件残留文件、系统版本有关，nvm 一般不是安装失败的直接原因。以管理员身份启动也不是必需的常规操作。建议您先按上面第 1 步清理残留后重装。

如果以上方法都无法解决，请把安装失败时的具体报错文字发给我（截图无法识别，请直接贴文字），或者加入 uni-agent 技术交流群 反馈具体问题。