helixlife-cli

面向 Helix Life（及同域业务页）的命令行工具：通过 Playwright 连接本机 Chrome CDP，或 @js-eyes 客户端 等 driver，在目标标签页中注入 helix-bridge.js，以页内 window.__helix_cli__ API 做导航、点击与搜索。默认在标准输出打印人类可读中文摘要；脚本或自动化解析需显式加 --json 才输出结构化 JSON。架构与 outline-cli / outline-bridge 类工具一致：桥接版本与 CLI 内嵌脚本一致则跳过，否则整段重注入。

环境要求

• Node.js >= 18（建议 LTS）
• npm
• 使用 playwright driver 时：已安装 Playwright 浏览器（例如 npx playwright install）

安装

全局使用（推荐，发布至 npm 后）

npm install -g helixlife-cli
# 使用默认 playwright 驱动时（如尚未安装浏览器）
npx playwright install

安装完成后在任意目录使用：helixlife-cli <子命令>（例如 helixlife-cli doctor）。

从本仓库本地开发

git clone <本仓库> && cd helixlife-cli
npm install
# 使用默认 playwright 驱动时（如需）
npx playwright install

开发时也可 npm link 将本仓库链到全局，或直接使用 node helix-cli.js <子命令>。

连接浏览器（推荐：先开 CDP，再跑命令）

本工具不会在「不连上浏览器」的情况下操控 helix 页面。默认用 Playwright 通过 Chrome DevTools 协议（CDP） 附着到你本机已开的 Chrome/Edge 上。CLI 会连到 http://127.0.0.1:9222（可用环境变量 HELIX_CDP_ENDPOINT 改）。

推荐工作流（可长期使用，关 CLI 后浏览器仍可保留）：

1. 用远程调试端口启动浏览器，例如端口 9222。
2. 在里面对 https://www.helixlife.cn 打开目标页（与 config 里 TARGET_URL_FRAGMENT 一致即可匹配标签页）。
3. 在终端执行 helixlife-cli <子命令>（不要加 --launch），例如 helixlife-cli doctor，再执行 search / clickNav 等（若仅本地未全局安装，可在本仓库根目录用 node helix-cli.js 代替 helixlife-cli）。

Windows 上启动 Chrome 示例（新配置目录，避免与正在运行的 Chrome 冲突；路径按本机安装位置调整）：

& "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\temp\chrome-helix-debug" "https://www.helixlife.cn"

Edge 示例：

& "C:\Program Files\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222 --user-data-dir="C:\temp\edge-helix-debug" "https://www.helixlife.cn"

若连接失败，终端会报 E_DRIVER_CONNECT。请先确认调试浏览器已开、且端口与 HELIX_CDP_ENDPOINT 一致，再重试；可用 helixlife-cli doctor 自测。也可临时使用 --launch 由本工具拉起一个仅用于当次任务的浏览器，但当前实现在命令结束时常会关闭该临时窗口，适合「偶发救急」而非日常主力。

常用子命令（详见 lib/cli.js / listNav、search、listSearch、clickSearch、clickNav、clickVip、learnCourse、takeNote 等）可配合项目里 .cursor/skills/helix-cli-ops/SKILL.md 的自然语言约定使用。
只关心「跳会员页 / 会员中心」时，也可用更窄的 .cursor/skills/helixlife-vip-page/SKILL.md。
例如：helixlife-cli listSearch（打印当前页抓到的可见搜索结果）；helixlife-cli clickSearch --index 3（点第 3 条搜索结果）或 helixlife-cli clickSearch 2022年考研规划（按标题关键词匹配点击）；helixlife-cli takeNote 今天的学习很有收获（自动切换到“笔记”后写入富文本内容）。