pnpm failed in profile directory 解决方法

Harness Desktop 已内置运行环境。看到下面这类报错时，不建议自行全局安装 Node.js 或 pnpm，因为额外环境可能让问题更复杂。

为什么会出现这条错误？

dsh 正在为当前用户的 Web 配置准备依赖，但命令没有正常完成。常见诱因包括网络中断、包源访问失败、安全软件拦截、磁盘空间不足、文件被占用，以及上一次安装未完整结束。

方法一：重启电脑后再次启动

这是风险最低的处理方式。它可以释放残留进程、锁定文件和本地端口。重启后保持网络稳定，首次准备期间不要退出应用。

方法二：换一个网络验证

临时关闭代理或加速器，换用手机热点启动一次。如果热点下可以正常完成，说明原网络可能限制了依赖源访问。之后可再切回常用网络。

方法三：检查安全软件记录

查看 Windows 安全中心或第三方安全软件是否隔离了 node.exe、临时安装文件或用户配置目录中的文件。仅在确认文件来自 Harness Desktop 官方安装包后恢复。

方法四：确认空间和路径权限

系统盘需要留出足够空间，因为用户配置通常位于 AppData。安装软件的磁盘有空间，不代表系统盘也有空间。企业电脑还可能通过策略禁止程序在用户目录执行。

方法五：使用新版安装包覆盖安装

先退出应用，再使用官方最新版本覆盖安装。覆盖安装通常能修复内置运行环境，同时保留用户配置。不要从第三方来源下载所谓“精简运行库”。

什么时候再考虑清理配置？

只有在上述方法全部无效、并且能够接受重新配置 API Key 和插件时，才考虑清理损坏的 profile。操作前先提交反馈，获取与当前版本匹配的路径和备份建议。