helixlife-edu-cli

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

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

安装

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

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

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

环境地址

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

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

本地开发

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

常用脚本：

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

发布

在仓库根目录执行：

npm publish

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

Skill

发布约定：本仓库 npm 包版本（当前 0.1.4）不含 Skill。课程模块 Agent 以 cli/skills/helixlife-edu-cli/（Skill v0.4.9）为最新入口；替换 Agent 侧 Skill 目录即可，不必为此升 CLI 版本或改命令传参。测试验收见该目录 README.md「测试验收清单」。

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

cli/skills/helixlife-edu-cli/
├── SKILL.md                 # 主 Skill 入口
└── references/
    ├── course.md                # 课程业务 reference
    ├── learning-plan-rules.md   # 学习计划规则
    └── non-course-routing.md    # 非课程类路由（直答不推课）

目录结构

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

命令命名空间

| 模块 | 命令示例 | 状态 | | ---- | -------------------------------------- | ---------------- | | 授权 | helixlife-edu auth login | 已实现 | | 升级 | helixlife-edu upgrade | 已实现 | | 配置 | helixlife-edu config | 已实现 | | 课程 | helixlife-edu course search | 向量搜索 | | 课程 | helixlife-edu course outline | 章节课时列表（课程地图） |

课程命令细节见 cli/skills/helixlife-edu-cli/references/course.md。