helixlife-v5-cli

全局安装 helixlife-v5-cli 后即可直接操作网页。该工具默认会把命令行参数原样透传到底层浏览器自动化引擎，同时附带 Helix 站点一键流程 helix home / helix doctor。

安装（仅 npm 全局安装）

npm install -g helixlife-v5-cli

不再支持 / 不建议项目级本地安装与 npx helixlife-v5-cli，以避免污染用户工程的 node_modules 与 lockfile。

全局安装后直接：

helixlife-v5-cli --help
helixlife-v5-cli list

首次执行前的自检（建议）

每次新会话第一次使用前，按下面 3 步确认环境就绪（与 Cursor skill 中代理执行的逻辑一致）：

# 1. 是否已安装；未安装时执行 npm install -g helixlife-v5-cli
helixlife-v5-cli --version

# 2. 取得线上最新版本
npm view helixlife-v5-cli version

# 3. 与本地不一致时升级到最新
npm install -g helixlife-v5-cli@latest

PATH 不含 npm bin -g 时（nvm / Volta / 自定义 prefix 常见），临时兜底：

node "$(npm root -g)/helixlife-v5-cli/helix-cli.js" --version

本地开发（与全局命令等价）

仓库克隆后，仅在开发本仓库时使用 node helix-cli.js：

npm install
node helix-cli.js --help
node helix-cli.js list

Helix 快捷命令

封装了「打开会话 → goto 到 HELIX_BASE_URL → eval 标题」，对应原 skill 文档里分步执行的启动流程：

helixlife-v5-cli helix home
helixlife-v5-cli helix home --headless
helixlife-v5-cli helix doctor
helixlife-v5-cli helix doctor --cdp-url http://127.0.0.1:9222

包装器自带的用法摘要（不参加透传）：

helixlife-v5-cli --helix-help

环境与兼容说明

• Windows / macOS：通过当前 Node 直接引用包内引擎脚本启动子进程，不依赖 Shell、npx 或 PATH，便于 CI 与 Agent 调用。
• stdin/stdout/stderr：子进程继承 stdio: 'inherit'，交互行为与直接调用引擎一致。
• 退出码：透传底层引擎退出码；包装器在无参数、helix 子命令错误时返回非零码。

环境变量

• HELIX_BASE_URL：目标地址，默认 https://vip.helixlife.cn/
• HELIX_CDP_URL：helix doctor 时在日志中输出的 CDP 参考地址，默认 http://127.0.0.1:9222
• HELIX_PROFILE_DIR：helix home/doctor 默认使用的 profile 目录，默认 <当前目录>/.helixlife-profile

命令说明

详见 Cursor skill helixlife-v5-cli（.cursor/skills/helixlife-v5-cli/SKILL.md，通常不随 npm 包发布）；站点流程以包内 references/vip.helixlife.cn.site-ops.md 为准。

依赖

运行时依赖：@playwright/cli ^0.1.9（要求 Node ≥ 18）。