helixlife-trick-cli

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

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

安装

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

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

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

环境地址

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

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

本地开发

npm install
npm run build
npm link
helixlife-trick --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。套路模板 Agent 以 cli/skills/helixlife-trick-cli/ 为入口；替换 Agent 侧 Skill 目录即可，不必为此升 CLI 版本或改命令传参。

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

cli/skills/helixlife-trick-cli/
├── SKILL.md                 # 主 Skill 入口
└── references/
    ├── trick.md                 # 套路模板业务 reference
    └── non-trick-routing.md     # 非套路类路由（直答不推模板）

目录结构

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

命令命名空间

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

套路命令细节见 cli/skills/helixlife-trick-cli/references/trick.md。