HelloAGENTS 给 AI 编程命令行加了一层工作流：技能、项目知识、交付检查、更安全的配置写入与可恢复的执行，支持 Claude Code、Gemini CLI、Grok Build、Cursor 和 Codex CLI。v3 基于 Node.js、Markdown 规则、技能和少量运行时脚本；npm 包为 helloagents@4.0.3，声明 engines.node >=18。
实例规格、系统盘与快照
它不跑常驻服务，主要动作是安装期写文件、给宿主 CLI 注入配置，1–2 核 2 GB 的通用型实例足够。要规划的是系统盘：npm 全局目录、~/.helloagents/helloagents 运行时副本、宿主插件缓存都落在系统盘，建议至少 40 GB。装之前先打快照——扫描把它标为 🔴 高危（见坑一），可一键回滚最省事。
安全组与 SSH 登录
它不需要向公网暴露端口。安全组入方向只留一条：你的固定 IP → 22 端口 TCP，其余拒绝，不要开 0.0.0.0/0。SSH 用密钥对而非密码，私钥只留本机，ECS 侧只放公钥。
Node 22 LTS 与 engines.node >=18
包声明 engines.node >=18，站点校验基线是 Node 22.19。生产上统一升到 Node 22 LTS，别让机器停在 18/20/22 混杂状态，否则结果不一致。
npm 11 及以上直接安装时保留 --allow-scripts=helloagents，让 npm 运行受管理的 postinstall 而不弹批准警告；npm 10 及更早可省略。
出网与 npm registry 可达性
ECS 默认走 NAT 网关出网，先确认 registry 可达再安装：
第一条返回 200 即可达，第二条确认没被换成不可用的内网源。
用 HELLOAGENTS=target[:mode] 部署宿主
postinstall 默认只做三件事：装包命令、初始化 ~/.helloagents/helloagents.json、同步运行时到 ~/.helloagents/helloagents。除非设置 HELLOAGENTS=target[:mode]，否则不部署任何宿主命令行。 target 取 all / claude / gemini / grok / cursor / codex；mode 取 standby / global，省略按 standby 处理。
standby 更轻更显式：规则部署到选定 CLI，仓库保持未初始化直到运行 ~init；global 在宿主层广泛应用完整规则，Claude / Gemini / Grok 走原生插件 / 扩展 / 市场，Cursor 和 Codex 走原生 local-plugin。想要 Codex app/plugin 可发现性用 global，否则保持 standby。
用 helloagents doctor 验证
doctor 报告载体、链接、钩子、配置项、版本与真实全局产物中的漂移，对 Codex 还会显示原生 codex doctor 输出。之后在目标 CLI 输入 ~help 应看到可用命令与当前设置，看不到就重跑 doctor 并重启 CLI。重装、刷新或切模式后必须重启 CLI，运行中的会话不会自动重载规则。
四个必须提前知道的坑
坑一 · 静态扫描判高危：安装期执行代码与运行时拼接的命令参数
现象。 安全扫描标 🔴 高危，共 21 处证据，含 src/cli/install.mjs 拼接运行时变量的 git 命令与 src/kernel/fsx.mjs 的递归删除。
原因。 安装期即执行代码，或命令参数由运行时变量拼接、来源无法静态判定，从严处理；扫描页写明「尚无人工评估」。
解决。 先看扫描说明与证据再决定安装，并把首次安装限制在可快照回滚的环境。
坑二 · Node 版本与宿主 CLI 版本的双重要求
现象。 npm install -g 成功但宿主 CLI 行为异常，或出现引擎告警。
原因。 包只声明 engines.node >=18，被接入的宿主 CLI 另有版本前提；两台机器 Node 不一致结果就不同。
解决。 统一到 Node 22 LTS 并与基线 22.19 对齐，再逐个宿主验证 ~help 与 doctor。
坑三 · 用 HELLOAGENTS_BRANCH 指定包规格
现象。 装到的不是预期来源或版本。
原因。 指定自定义 tarball 或包规格要用 HELLOAGENTS_PACKAGE，HELLOAGENTS_BRANCH 是另一用途。
解决。 改用 HELLOAGENTS_PACKAGE，并在包命令后显式 npm explore -g helloagents -- npm run sync-hosts -- ... 确认落地。
坑四 · 直接 npm uninstall -g 留下宿主集成残留
现象。 卸载后宿主 CLI 仍有托管配置、行为未恢复。
原因。 直接删包不走 HelloAGENTS 生命周期清理；项目 .helloagents/ 与 ~/.helloagents/helloagents.json 是故意保留的。
解决。 先 npm explore -g helloagents -- npm run uninstall -- --all 清理宿主集成与稳定运行时副本，再删包。
总结
在阿里云 ECS 上部署 HelloAGENTS 的关键不是机器规格，而是三件事：Node 22 LTS 与 engines.node >=18 对齐、NAT 出网能到 npm registry、用 HELLOAGENTS=target[:mode] 指定宿主与模式；想对照同类插件的中文清单与安装形态，见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合：在云上跑 Claude Code / Codex CLI 等命令行、希望统一工作流规则的团队；需要项目知识留在磁盘、可随快照回滚的开发环境；愿意先在小规格 ECS 上验证再推广的运维。不适合：不能接受「安全扫描判高危、21 处证据且尚无人工评估」的团队；只想装轻量提示词、不愿工具写入多个 CLI 宿主配置的用户；不做快照直接在生产实例试装的场景——周下载量仅 85、项目仍在 developer-preview 阶段，风险应被真实评估。
标签：HelloAGENTS、DeepSeek Harness、阿里云 ECS、Node.js、宿主部署
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
