huayoungtk-cli

花漾TK 官方命令行工具，供 AI Agent 调用花漾TK平台 API。

覆盖达人建联、达人 CRM、买家管理、索样管理、商品/订单查询等核心功能，让你的 AI 工具（Claude Code、Hermes 等）直接操作花漾TK。

安装与升级

安装和升级都执行这两句：

# 安装 CLI
npm install -g @huayoung/huayoungtk-cli
# 安装 Skills（让自身学会使用花漾TK）
huayoungtk-cli skills install

也可以手动指定 AI Agent：

huayoungtk-cli skills install --agent claude-code   # 只安装给 Claude Code
huayoungtk-cli skills install --agent hermes        # 只安装给 Hermes

登录

获取 API Token：打开花漾TK门户网站 → 设置 → 我的个人设置 → 开放龙虾（OpenClaw）配置 → 生成并复制授权 Key。

huayoungtk-cli auth login --token <API-Token>

验证

huayoungtk-cli auth check
huayoungtk-cli team info

Skills

Skills 是 Markdown 文件，告诉 AI Agent 如何使用花漾TK命令。安装后 AI Agent 会自动加载。

| Skill | 说明 | |-------|------| | huayoungtk | 完整技能：认证、达人管理、店铺管理、设备管理、团队信息、任务查询 |

huayoungtk-cli skills install                  # 安装全部
huayoungtk-cli skills install --agent hermes   # 安装给指定 Agent
huayoungtk-cli skills list                     # 查看可用 Skills
huayoungtk-cli skills uninstall                # 卸载

认证

Token 获取方式：打开花漾TK门户网站 → 设置 → 我的个人设置 → 开放龙虾（OpenClaw）配置 → 生成并复制授权 Key。

| 命令 | 说明 | |------|------| | auth login --token <token> | 保存 API Token（同时验证有效性） | | auth logout | 清除已保存的 Token | | auth status | 查看当前登录状态 | | auth check | 验证 Token 是否有效 |

输出格式

所有命令默认输出 JSON，方便 AI Agent 解析。

-o json    # JSON 输出（默认）
-o table   # 表格输出（人类友好）
-o ndjson  # 单行 JSON 输出

使用 -o 切换输出格式：

huayoungtk-cli team info -o table

命令列表

huayoungtk-cli auth <login|logout|status|check>   # 认证管理
huayoungtk-cli job get --job-id <id>               # 查看任务详情与状态
huayoungtk-cli job cancel --job-id <id>            # 取消任务
huayoungtk-cli team info                           # 查看团队信息、套餐、配额
huayoungtk-cli shop list                           # 查看店铺列表
huayoungtk-cli shop get --shop-id <id>             # 查询单个店铺
huayoungtk-cli shop get --shop-name <name>         # 按名称查询店铺
huayoungtk-cli device list                         # 查看可用设备
huayoungtk-cli config show                         # 查看配置
huayoungtk-cli skills install                      # 安装 AI Agent Skills
huayoungtk-cli skills uninstall                    # 卸载 AI Agent Skills
huayoungtk-cli skills list                         # 查看可用 Skills
huayoungtk-cli doctor                              # 诊断环境问题

配置

配置存储在 ~/.huayoungtk-cli/config.json：

{
  "mcpToken": "your-api-token",
  "endpoint": "https://api.szdamai.com",
  "teamId": "123456",
  "userId": "789012"
}

可通过环境变量覆盖：

| 变量 | 说明 | |------|------| | HUAYOUNGTK_CLI_TOKEN | API Token（优先级低于 config.json） | | HUAYOUNGTK_CLI_CONFIG_DIR | 自定义配置目录（默认 ~/.huayoungtk-cli） |