huayoungtk-cli

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

覆盖达人建联、达人 CRM、买家管理、团队管理等核心功能，让你的 AI 工具（Claude Code、Hermes 等）直接操作花漾TK。

为什么用 huayoungtk-cli？

• 为 AI Agent 原生设计 — Skills 开箱即用，AI Agent 无需额外适配即可操作花漾TK
• 三步上手 — 安装 → 登录 → 使用，从安装到第一次 API 调用只需三条命令
• 结构化输出 — 所有命令输出 JSON，AI Agent 可直接解析
• 安全可控 — API Token 认证，本地存储凭证

安装与快速开始

环境要求

• Node.js 16+（通过 npm 安装时）

快速开始（人类用户）

AI Agent 注意： 如果你是 AI Agent 且正在协助用户安装，请跳转到 快速开始（AI Agent）。

第 1 步 — 安装 CLI

npm install -g @huayoung/huayoungtk-cli

第 2 步 — 安装 Skills（让 AI 学会使用花漾TK）

huayoungtk-cli skills install

该命令自动检测你已安装的 AI 工具（Claude Code、Hermes 等），并将 Skills 安装到对应目录。也可以手动指定：

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

第 3 步 — 登录

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

第 4 步 — 使用

# 查看团队信息、套餐和配额
huayoungtk-cli team info

# 查看配置
huayoungtk-cli config show

# 检查 Token 是否有效
huayoungtk-cli auth check

快速开始（AI Agent）

以下步骤面向 AI Agent，协助用户完成安装和配置。

第 1 步 — 安装

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

第 2 步 — 登录

请向用户索取 API Token，然后执行：

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

第 3 步 — 验证

huayoungtk-cli auth check
huayoungtk-cli team info

Skills

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

| Skill | 说明 | |-------|------| | huayoung-shared | 认证登录、安全规则、输出格式、CLI 命令列表（所有其他 skill 的基础） | | huayoung-team | 团队信息、套餐版本、配额使用情况 |

安装更多 Skill：

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

认证

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

# 登录
huayoungtk-cli auth login --token abc123

# 指定 endpoint（可选）
huayoungtk-cli auth login --token abc123 --endpoint https://dev.thinkoncloud.cn

# 检查状态
huayoungtk-cli auth status

# 验证 Token
huayoungtk-cli auth check

输出格式

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

--format json    # JSON 输出（默认）
--format table   # 表格输出（人类友好）
--format csv     # CSV 输出

使用 --jq 过滤 JSON 输出：

huayoungtk-cli team info --jq '.teamName'

命令列表

huayoungtk-cli auth <login|logout|status|check>   # 认证管理
huayoungtk-cli team info                           # 查看团队信息、套餐、配额
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 update [--check]                    # 更新二进制
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） |

更新

# 检查是否有新版本
huayoungtk-cli update --check

# 更新到最新版
huayoungtk-cli update

开发

从源码构建

cd huayoungtk-cli
make build    # 构建当前平台
make all      # 构建所有平台（linux/mac-x64/mac-arm64/win）
make test     # 运行测试
make oss      # 上传到阿里云 OSS