helixlife-v5-cli

Helix（vip.helixlife.cn）精细化浏览器自动化 CLI — npm 包运行时。

业务规则与 Agent Skill 文档在独立 Skill 仓库；本仓库仅包含可全局安装的 CLI。

安装

前置条件：Node.js ≥ 18、npm。

npm install -g helixlife-v5-cli
helixlife-v5-cli --version

从源码目录安装（开发/本地验证）：

cd helixlife-v5-cli
npm install -g .
helixlife-v5-cli --version

首次执行任意浏览器命令时，CLI 会自动校验并安装 @playwright/cli 运行时依赖（需联网）。设 HELIX_AUTO_INSTALL=0 可关闭自动安装。

快速开始

helixlife-v5-cli list
helixlife-v5-cli open https://vip.helixlife.cn/ --profile=.helixlife-profile --headed
helixlife-v5-cli snapshot
helixlife-v5-cli click "getByRole('button', { name: '登录' })"

完整命令参考见 Skill 仓库 references/cli-reference.md；Helix 站点强约束见 Skill 仓库 SKILL.md。

目录结构

helixlife-v5-cli/
├── helix-cli.js          # CLI 入口（npm bin）
├── package.json
├── lib/                  # 运行时逻辑
├── node_modules/         # 依赖（安装后生成，git 忽略）
└── scripts/
    └── README.md         # run-code 脚本总索引

维护者说明

更新 @playwright/cli 依赖时，修改 package.json 中的版本，在 helixlife-v5-cli 目录执行 npm i，再运行 scripts/maintainer/strip-extra-skills.ps1 剔除 node_modules 内多余的 SKILL.md，确认 helixlife-v5-cli --version 正常。

发布前确认 package.json 的 bin 字段指向 helix-cli.js，且 files 包含 helix-cli.js、lib/、scripts/。

与 Skill 仓库的关系

| 组件 | 位置 | | --- | --- | | CLI 运行时 | 本仓库 → npm install -g helixlife-v5-cli | | Skill + 业务文档 | 独立 Skill 仓库 → SKILL.md + references/ |

Agent 通过 Skill 读文档、通过本 CLI 跑命令，二者以全局 npm 安装衔接。