helixlife 网站后台 CLI

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

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

安装

npm install -g helixlife-service-cli
helixlife auth login          # 获取授权链接 + 打开浏览器完成授权
helixlife auth status         # 确认授权是否成功
helixlife upgrade             # 检查并按需升级到 npm 最新版

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

环境地址

默认使用生产基址（config.ts）。可通过本地配置覆盖 api / agent_api（完整 URL，原样使用）：

helixlife config                              # 查看当前生效地址
helixlife config set api https://api.example.com
helixlife config set agent_api https://agent.example.com

本地配置文件：~/.config/helixlife/config.json。newidea 基址固定，不可覆盖。

配置路径

本地保存：

• 配置：~/.config/helixlife/config.json
• Token：~/.config/helixlife/user-access-token.txt

本地开发

npm install
npm run build
npm link
helixlife --version

常用脚本：

npm run dev         # 直接跑 TypeScript 入口
npm run typecheck   # 类型检查
npm test            # 单元测试

发布

在仓库根目录执行：

npm publish

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

Skill

Agent 侧使用需安装 Skill 包（目录名与 name 一致）：

cli/skills/helixlife-service-cli/
├── SKILL.md                     # 唯一 Skill 入口
└── references/                  # 各业务模块命令参考
    ├── workbench/
    │   ├── jova.md              # 综述
    │   ├── sci.md               # SCI 论著
    │   ├── meta.md              # Meta 分析
    │   ├── nsfc.md              # 基金 / 国自然
    │   └── clinical.md          # 临床申请书
    ├── application.md           # AI 应用
    ├── application-catalog.md   # AI 应用目录（意图路由快照）
    ├── analysis.md              # 仙桃 / 数据分析 / 绘图（独立 CLI xt）
    ├── course.md                # 课程模块（独立 CLI helixlife-edu）
    └── learning-plan-rules.md   # 学习计划规则（由 course 流程引用）

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

仙桃例外：数据分析 / 绘图使用独立 CLI xt（npm：@helixlife-ai/xiantao），本仓库只嵌其 Skill reference。授权凭证与 agent_api 配置与 helixlife 共用（~/.config/helixlife/）。

课程例外：课程模块使用独立 CLI helixlife-edu（npm：helixlife-edu-cli），本仓库只嵌其 Skill reference。授权凭证与 agent_api 配置与 helixlife 共用（~/.config/helixlife/）。

目录结构（CLI 仓库）

helixlife-service-cli/
├── package.json          # npm 包定义（仅 CLI）
└── cli/
    ├── bin/helixlife.js
    ├── dist/             # 编译产物（随 npm 发布）
    ├── src/
    │   └── modules/
    │       ├── auth/
    │       ├── upgrade/
    │       ├── ticket/
    │       ├── application/
    │       └── workbench/   # jova / sci / meta / nsfc / clinical
    ├── tests/
    └── skills/
        └── helixlife-service-cli/  # 本地开发用，不随 npm 发布
            ├── SKILL.md
            └── references/

命令命名空间

| 模块 | 命令示例 | 状态 | | ----------------- | ---------------------------------------- | ------ | | 综述 | helixlife workbench jova | 已实现 | | SCI 论著 | helixlife workbench sci | 已实现 | | Meta 分析 | helixlife workbench meta | 已实现 | | 基金 / 国自然 | helixlife workbench nsfc | 已实现 | | 临床 / 临床申请书 | helixlife workbench clinical | 已实现 | | AI 应用 | helixlife application | 已实现 | | 会员兑换 | helixlife ticket exchange | 已实现 | | 升级 | helixlife upgrade | 已实现 | | 仙桃 / 数据分析 | 独立 CLI xt（@helixlife-ai/xiantao） | 外部包 | | 课程 / 学习计划 | 独立 CLI helixlife-edu（helixlife-edu-cli） | 外部包 |

各模块命令细节见对应 cli/skills/helixlife-service-cli/references/ 文档。