国内网络环境安装适配

更新日期：2026-11-05。

三个最常见的失败原因

1. 中文用户名与空格路径

Windows 用户目录含中文或空格时，npm 与部分 Python 包的安装脚本会失败。

处理方式：不要在用户目录下安装，改用固定纯英文短路径（例如 C:\AgentHub），并保持路径长度低于 200 字符。

2. 缺 Node / Python / Git

处理方式：用便携版运行时，不修改系统环境：

• npm 全局安装使用 --prefix 指定隔离目录；
• 需要注意，可执行文件的 shim 生成在 --prefix 指定的目录根部，不是 node_modules/.bin，注入 PATH 时必须指向 prefix 根目录。

3. PowerShell 执行策略

下载的 .ps1 安装脚本在 Restricted 策略下会被拦截。

处理方式：由程序直接调用可执行文件完成安装，不经过 PowerShell 脚本；确需调用时使用进程级 -ExecutionPolicy Bypass，不修改系统级策略。