helixlife-crf-cli

解螺旋 5.0 后台体系 · CRF 表专属 CLI。仅维护 CRF 表对应的 Skill 能力与 CLI 交互命令，不包含其他业务模块。

将疾病识别、资料匹配及基础临床问答能力标准化封装，降低运营客服对临床专业知识的依赖，提升会员咨询响应效率和答复一致性。

Skill 与 CLI 已分离：cli/skills/helixlife-crf-cli/（含 SKILL.md 与 references/）不随本 npm 包发布。后续若整合进集合体系，仅需迁移该 Skill 目录。

安装

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

Token 与接口基址配置位于 ~/.config/helixlife/：

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

环境地址

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

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

本地开发

npm install
npm run build
npm link
helixlife-crf --version

常用脚本：

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

发布

在仓库根目录执行：

npm publish

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

Skill

发布约定：本仓库 npm 包不含 Skill。CRF 表 Agent 以 cli/skills/helixlife-crf-cli/ 为入口；替换 Agent 侧 Skill 目录即可，不必为此升 CLI 版本或改命令传参。

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

cli/skills/helixlife-crf-cli/
├── SKILL.md                 # 主 Skill：全局鉴权 / 升级 / 兑换 / 匹配下载路由
├── scripts/build_crf.py     # 未命中时生成建议稿
└── references/
    ├── generate.md            # 业务部门：未命中时生成 CRF 建议稿
    ├── base-forms.md          # 基表骨架
    └── spec-format.md         # JSON 规格

目录结构

helixlife-crf-cli/
├── package.json
└── cli/
    ├── bin/helixlife-crf.js
    ├── dist/
    ├── src/
    │   ├── core/            # 共用基础设施（auth / api / config）
    │   └── modules/
    │       ├── auth/
    │       ├── upgrade/
    │       ├── ticket/
    │       └── crf/         # CRF 表命令
    ├── tests/
    └── skills/
        └── helixlife-crf-cli/  # 本地开发用，不随 npm 发布

命令命名空间

| 模块 | 命令示例 | 状态 | | ---- | ------------------------------- | -------------- | | 授权 | helixlife-crf auth login | 已实现 | | 升级 | helixlife-crf upgrade | 已实现 | | 配置 | helixlife-crf config | 已实现 | | 兑换 | helixlife-crf ticket exchange | 已实现 | | CRF | helixlife-crf crf list | 列表 | | CRF | helixlife-crf crf get | 详情与下载链接 |

CRF 命令：list 免授权；get 需授权，返回 PDF / Excel 下载链接。未命中疾病时按 cli/skills/helixlife-crf-cli/references/generate.md 生成建议稿。