SuperAPI AI 工具集

homerail-install-ops

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:HomeRail Install Ops 是面向 AI 智能体的技能,用于从本地源码检出或本地 Git 克隆部署 HomeRail,覆盖首次安装、更新、服务启动、Provider 配置与冒烟验证。动作前需应用 homerail-shared 规则,本流程为发布前流程,不使用 npm 发布包。

主要能力:将仓库内 skills/homerail-* 目录链接到目标智能体技能目录,优先用符号链接而非复制,以便 git pull 后技能更新生效;支持 macOS/Linux 与 Windows(PowerShell 目录符号链接,受限时用 junction 回退)。安装或更新后,如智能体宿主机仅在启动时加载技能,需让用户重启会话。

使用方式:已有源码树时以 skills/README.md 为准;若用户给本地 Git 地址,先 git clone <local-homerail-git-url> HomeRail 再从检出目录安装链接。从源码根运行 npm run install:all、npm run build、npm run typecheck、npm test、npm run ci。准备数据根 export HOMERAIL_HOME="${HOMERAIL_HOME:-$HOME/.homerail}",用 node homerail_cli/dist/cli.js config 配置运行时与凭据,再 node homerail_cli/dist/cli.js start 启动 Manager 与 Node,可加 --rebuild-worker-image 或 --ui。配置 Provider 时依次运行 config、config apply、doctor,密钥不得写入仓库文件。

验证:先 hr doctor 作为首个环境探测;再跑 node homerail_cli/dist/cli.js smoke dag --template assets/orchestrations/public-dev-5node.yaml.template 和 node homerail_cli/dist/cli.js smoke manager-agent,完成后用 dag quick、dag chats、dag handoffs、scorecard、eval-run 检查终态证据。

限制与维护:hr doctor 输出不足时才补充其他排查;connected_workers: 0 在空闲 Manager 属正常,DAG Worker 由 Node 按需创建。代码改动后重跑 npm run build,Worker 运行时变更后加 --rebuild-worker-image,Manager 与 Node 须共用同一 HOMERAIL_HOME。安装技能保持符号链接;更多价格、平台支持等资料暂未提供。