Helixlife 网站后台 CLI

单一 npm 包 helix-service-cli，源码在 cli/ 目录。

Skill 与 CLI 已分离：cli/skills/（含 SKILL.md 与 references/）不随本 npm 包发布，后续将迁至独立 skill 仓库。Agent 自然语言交互请安装 Skill。

安装

npm install -g helix-service-cli
helix auth login          # 获取授权链接 + 打开浏览器完成授权
helix auth status         # 确认授权是否成功

Token 写入本地文件 ~/.config/helix/token-key.txt（由 helix auth login / helix login 浏览器授权流程获取）。

环境地址（单一来源）

后台环境地址 只由编译期 config.ts 决定（构建时选择 开发/测试/生产）。

• helix login -s <url> 的 -s 已废弃并被忽略，避免历史地址长期劫持环境切换。
• 切换环境：修改 cli/src/core/types/config.ts 后重新 npm run build 并全局安装。
• 用 helix config 查看当前 baseUrl。

配置路径

# 已移除 --config / HELIX_CONFIG_FILE / configstore：CLI 不再读取本地配置文件

本地仅保存 token 文件：~/.config/helix/token-key.txt。

本地开发

npm install
npm run build
npm link
helix --version

发布

在仓库根目录执行：

npm publish

prepublishOnly 会自动执行 npm run build。发布内容仅含 cli/bin 与 cli/dist，不含 cli/skills/。

Skill（独立仓库）

Agent 侧使用需安装 Skill 包（SKILL.md + references/），与 CLI 分开维护：

helix-service-cli/          # skill 仓库（规划中，当前暂存于本仓库 cli/skills/）
├── SKILL.md                     # 唯一 Skill 入口
└── references/                  # 各业务模块命令参考
    ├── workbench/
    │   ├── jova.md
    │   └── sci.md
    └── application.md

安装到 Agent 后，references 位于 <Skill 安装目录>/references/，例如 Cursor：~/.cursor/skills/helix-service-cli/references/。

目录结构（CLI 仓库）

helix-service-cli/
├── package.json          # npm 包定义（仅 CLI）
└── cli/
    ├── bin/helix.js
    ├── dist/             # 编译产物（随 npm 发布）
    ├── src/
    └── skills/           # 本地开发用，不随 npm 发布
        ├── SKILL.md
        └── references/

命令命名空间

| 模块 | 命令示例 | 状态 | | --------- | ---------------------- | ------ | | 综述 | helix workbench jova | 已实现 | | SCI 论著 | helix workbench sci | 占位 | | AI 应用 | helix application | 已实现 |