Skill

花漾TK CLI 技能

重要提示：每个命令都可以执行 --help 查看详细用法、所有可用参数和示例。 例如 huayoungtk-cli creator list --help、huayoungtk-cli shop sync --help。 当你不确定某个命令支持哪些参数时，优先使用 --help 查询。

本技能涵盖花漾TK CLI 的所有业务命令，供 AI Agent 操作花漾TK平台。

认证

首次使用前通过 API token 登录。Token 获取方式：打开花漾TK门户网站 → 设置 → 我的个人设置 → 开放龙虾（OpenClaw）配置 → 生成并复制授权 Key。

huayoungtk-cli auth login --token <api-token>

可选指定 endpoint（默认 https://api.szdamai.com）：

huayoungtk-cli auth login --token <api-token> --endpoint https://api.szdamai.com

登录后检查连通性：

huayoungtk-cli auth check    # 验证 token 是否有效
huayoungtk-cli auth status   # 查看当前配置状态

配置存储在 ~/.huayoungtk-cli/config.json，单一 token，无多 Profile。

安全规则

1. 禁止明文输出密钥 — 永远不要在对话中显示 API token 等敏感信息
2. 写入操作需确认 — 在执行写入/删除操作前，先展示 --dry-run 预览，获得用户确认
3. 高风险操作审批 — 当 CLI 返回 exit code 10（confirmation_required）时：
   • 向用户展示风险信息
   • 获得明确同意后，追加 --yes 标志重新执行
   • 禁止自动跳过审批

输出格式

所有 CLI 输出遵循 JSON envelope 格式：

• 成功：{"ok": true, "data": ...}

• 失败：{"ok": false, "error": {"type": "...", "message": "...", "hint": "..."}}

• stdout 是数据，stderr 是进度/提示信息

• 使用 --output 或 -o 控制输出格式：json、ndjson

• 使用 --jq 通过 jq 表达式过滤输出

命令速览

huayoungtk-cli auth <login|logout|status|check>          # 认证管理
huayoungtk-cli creator list [flags]                       # 列出团队达人
huayoungtk-cli creator get <--id|--handle|--cid> <value>   # 获取达人详情
huayoungtk-cli creator note <--id|--handle|--cid> --remark # 修改达人备注
huayoungtk-cli creator tag <--id|--handle|--cid> --tag     # 给达人打标签或取消标签
huayoungtk-cli creator status <--id|--handle|--cid> --shop-id <id> --status <value> # 修改达人合作状态
huayoungtk-cli creator shops <--id|--handle|--cid>          # 查看达人合作的店铺列表
huayoungtk-cli creator capability <--id|--handle|--cid>     # 评估达人带货能力（索样参考）
huayoungtk-cli creator videos <--id|--handle|--cid>         # 查看达人带货视频列表
huayoungtk-cli creator lives <--id|--handle|--cid>          # 查看达人带货直播列表
huayoungtk-cli shop list [flags]                           # 列出店铺
huayoungtk-cli shop get <--shop-id|--shop-name> <value>    # 获取店铺详情
huayoungtk-cli shop sync --shop-id <id> --device-id <id>   # 同步店铺信息（异步RPA）
huayoungtk-cli video list [flags]                           # 列出带货视频
huayoungtk-cli video get <--id|--media-id> <value>           # 查看视频详情
huayoungtk-cli video note <--id|--media-id> --remark <text>  # 修改视频备注
huayoungtk-cli video tag <--id|--media-id> --tag <name>      # 给视频打标签或取消标签
huayoungtk-cli live list [flags]                             # 列出带货直播
huayoungtk-cli live get <--id|--media-id> <value>             # 查看直播详情
huayoungtk-cli live note <--id|--media-id> --remark <text>    # 修改直播备注
huayoungtk-cli buyer list [flags]                            # 列出买家
huayoungtk-cli buyer get <--id|--handle> <value>             # 查看买家详情
huayoungtk-cli buyer note <--id|--handle> --remark <text>    # 修改买家备注
huayoungtk-cli buyer tag <--id|--handle> --tag <name>        # 给买家打标签或取消标签
huayoungtk-cli order list [flags]                            # 查询订单列表
huayoungtk-cli order get --order-no <orderNo>                # 查看订单详情
huayoungtk-cli sample-request list [flags]                   # 查询达人索样列表
huayoungtk-cli sample-request get <--id|--apply-id> <value>  # 获取索样详情
huayoungtk-cli sample-request videos <--id|--apply-id> <value>  # 获取索样关联视频
huayoungtk-cli sample-request lives <--id|--apply-id> <value>   # 获取索样关联直播
huayoungtk-cli sample-request archive <--id|--apply-id> <value> # 搁置/取消搁置索样
huayoungtk-cli sample-request approve <--id|--apply-id> <value> --device-id <id> # 同意索样（不可撤销）
huayoungtk-cli sample-request reject <--id|--apply-id> <value> --device-id <id>  # 拒绝索样（不可撤销）
huayoungtk-cli device list [flags]                         # 列出可用设备
huayoungtk-cli job get --job-id <id>                       # 查看任务详情与状态
huayoungtk-cli job cancel --job-id <id>                    # 取消任务
huayoungtk-cli team info                                   # 查看团队信息、套餐、配额
huayoungtk-cli config show                                 # 查看配置
huayoungtk-cli doctor                                      # 诊断环境问题

达人（Creator）

达人是 TikTok Shop 的 KOL/网红，可以带货商家的商品。

核心标识符

合作状态

状态为全局最高状态：如果达人针对店铺 A 已出单，针对店铺 B 未接触，则全局状态为"已出单"。

MCN 类型

creator list — 列出团队达人

huayoungtk-cli creator list [flags]

默认返回 15 条记录。使用 --page-size 调整，--page 翻页。

输出字段

示例

huayoungtk-cli creator list
huayoungtk-cli creator list -q "fashion"
huayoungtk-cli creator list --status HasOrder
huayoungtk-cli creator list --region TH --sort totalGmv:desc
huayoungtk-cli creator list --status Collaborating --jq '.creators[] | {handle, followers, totalGmv}'

creator get — 获取达人详情

huayoungtk-cli creator get <--id|--handle|--cid> <value>

三种查找方式（任选其一）：

关键字段

huayoungtk-cli creator get --id 363364238753849
huayoungtk-cli creator get --handle ashfarienaz
huayoungtk-cli creator get --cid 7493991083946247855

creator note — 修改达人备注

huayoungtk-cli creator note <--id|--handle|--cid> <value> --remark <text>

huayoungtk-cli creator note --handle ashfarienaz --remark "转化率不错"
huayoungtk-cli creator note --handle ashfarienaz --remark ""           # 清除备注
huayoungtk-cli creator note --handle ashfarienaz --remark "test" --dry-run  # 预览

creator tag — 给达人打标签或取消标签

huayoungtk-cli creator tag <--id|--handle|--cid> <value> --tag <name> [--tag <name> ...]

标签不存在时会自动创建。

huayoungtk-cli creator tag --handle ashfarienaz --tag vip
huayoungtk-cli creator tag --handle ashfarienaz --tag vip --tag active  # 多标签
huayoungtk-cli creator tag --handle ashfarienaz --tag vip --remove      # 取消标签

creator status — 修改达人与店铺的合作状态

huayoungtk-cli creator status <--id|--handle|--cid> <value> --shop-id <id> --status <status>

修改达人与指定店铺的合作状态，全局状态会自动重算（取所有店铺中最高状态）。

huayoungtk-cli creator status --handle ashfarienaz --shop-id 123456 --status Sent
huayoungtk-cli creator status --id 363364238753849 --shop-id 123456 --status 9

creator shops — 查看达人合作的店铺列表

huayoungtk-cli creator shops <--id|--handle|--cid> <value>

查看指定达人关联的所有店铺及其对应合作状态。达人的合作状态是店铺级别的，每个店铺有独立的合作状态。

输出字段

huayoungtk-cli creator shops --handle ashfarienaz
huayoungtk-cli creator shops --id 363364238753849 --jq '.shops[] | select(.cooperationStatus == "已出单")'

creator capability — 评估达人带货能力

查看指定达人的公开市场带货能力数据，用于评估达人是否适合接收样品或建联。数据来源于 TikTok 公开市场统计（过去 30 天）。

huayoungtk-cli creator capability <--id|--handle|--cid> <value>

返回字段说明

使用建议

• 索样决策：结合 estimatedPostRate（发文率）和 gpm（千播收入）评估达人收到样品后的产出潜力
• 视频达人：关注 videoGpm、averageVideoViews、averageVideoEngagement
• 直播达人：关注 liveGpm、averageLiveViews、averageLiveEngagement
• 价格匹配：对比 productPriceMin/Max 与自家商品价格区间，判断达人受众是否匹配

huayoungtk-cli creator capability --handle sahabatpadienterprise
huayoungtk-cli creator capability --id 364060149284921 --jq '.capability | {gmv, estimatedPostRate, videoGpm}'
huayoungtk-cli creator capability --handle sahabatpadienterprise --jq '.capability.gmvByContentChannel'

creator videos — 查看达人带货视频

查看指定达人的带货视频列表，返回视频播放量、订单数、GMV、关联商品、跟进人等信息。

huayoungtk-cli creator videos <--id|--handle|--cid> <value> [flags]

输出字段同 video list 的单个视频项（id、mediaId、title、views、orders、soldAmount、shopNames、shopCodes、tags、owners 等）。

huayoungtk-cli creator videos --handle ashfarienaz
huayoungtk-cli creator videos --id 363364238753849 --page-size 10
huayoungtk-cli creator videos --handle ashfarienaz --authorization-status authorized

creator lives — 查看达人带货直播

查看指定达人的带货直播列表，返回每场直播的观看数、订单数、GMV、售出商品、跟进人等信息。

huayoungtk-cli creator lives <--id|--handle|--cid> <value> [flags]

输出字段同 live list 的单条直播（id、mediaId、startTime、endTime、views、orders、soldAmount、shopNames、shopCodes、owners 等）。

huayoungtk-cli creator lives --handle suphap2539
huayoungtk-cli creator lives --id 343719599407108 --last-days 30
huayoungtk-cli creator lives --handle suphap2539 --sort startTime:desc --page-size 5

店铺是花漾TK平台中的基本管理单元，代表一个 TikTok Shop。

核心字段

浏览器类型（browserType）

常见国家站点

Malaysia、Thailand、Vietnam、Philippines、Indonesia、United_States、United_Kingdom、Japan

shop list — 列出店铺

huayoungtk-cli shop list [flags]

默认行为：不加任何参数时，一次性返回所有店铺（内部使用 page-size=999）。

huayoungtk-cli shop list
huayoungtk-cli shop list --query "店铺名"
huayoungtk-cli shop list --type Local
huayoungtk-cli shop list --jq '.shops[] | select(.status == "Online") | {shopName, score, site}'

shop get — 获取店铺详情

huayoungtk-cli shop get <--shop-id|--shop-name> <value>

两个参数互斥，必须提供一个。

huayoungtk-cli shop get --shop-id <shop-id>
huayoungtk-cli shop get --shop-name "马来可用店铺"

shop sync — 同步店铺信息（异步 RPA）

店铺信息同步是异步 RPA 任务，CLI 只创建任务并返回 jobId。

huayoungtk-cli shop sync --shop-id <shopId> --device-id <deviceId>
huayoungtk-cli shop sync --shop-id <shopId> --device-id <deviceId> --sync product,order

通过 --sync 控制同步哪些数据（逗号分隔），不传则同步全部：

同步操作完整流程

第 1 步 — 确认目标店铺

huayoungtk-cli shop list

第 2 步 — 查找可用设备

huayoungtk-cli device list --shop-id <shopId> --online

根据店铺的 browserType 自动返回对应类型的在线设备。如果返回空列表，告知用户"该店铺当前没有在线的可用设备"。

第 3 步 — 发起同步

huayoungtk-cli shop sync --shop-id <shopId> --device-id <deviceId>

第 4 步 — 告知用户任务已创建

返回：{"jobId": 363685658755072, "message": "店铺信息同步任务已创建"}

常见错误

带货视频（Video）

带货视频是达人在 TikTok 上发布的含有商品链接的视频。每个视频可以关联多个商品和多个店铺。

videoBasicInfo 字段

授权类型（authorizationType）

商品授权状态（products.authorizationStatus）

video list — 列出带货视频

huayoungtk-cli video list [flags]

默认返回 20 条记录。使用 --page-size 调整，--page 翻页。

店铺名称和跟进人昵称会自动从 API 获取并填充，无需额外操作。

Tab 类型说明

示例

huayoungtk-cli video list
huayoungtk-cli video list --tab-type latest3day --page-size 5
huayoungtk-cli video list --query "test" --page-size 3
huayoungtk-cli video list --authorization-status authorized --page-size 3
huayoungtk-cli video list --tag "高转化" --page-size 3
huayoungtk-cli video list --shop-id 123456 --from 2026-01-01 --to 2026-01-31
huayoungtk-cli video list --sort postTime:desc --page-size 10
huayoungtk-cli video list --page-size 3 --jq '.videos[] | {title, views, orders, soldAmount}'

video get — 查看视频详情

huayoungtk-cli video get --id <id>
huayoungtk-cli video get --media-id <mediaId>

Flags：

输出字段： 与 video list 的 videoBasicInfo 结构相同，返回单个对象（非数组）。

示例：

huayoungtk-cli video get --id 123456
huayoungtk-cli video get --media-id 7493991083946247855
huayoungtk-cli video get --id 123456 --jq .title

video note — 修改视频备注

修改指定视频的备注信息。通过 --id 或 --media-id 定位视频。

huayoungtk-cli video note <--id|--media-id> <value> --remark <text> [--dry-run]

huayoungtk-cli video note --id 350995894763551 --remark "转化率不错"
huayoungtk-cli video note --media-id 7598119178112945416 --remark "需要跟进"
huayoungtk-cli video note --media-id 7598119178112945416 --remark ""

video tag — 给视频打标签或取消标签

给指定视频添加或移除标签。通过 --id 或 --media-id 定位视频。

huayoungtk-cli video tag <--id|--media-id> <value> --tag <name> [--tag <name2>] [--remove] [--dry-run]

标签不存在时会自动创建。

huayoungtk-cli video tag --media-id 7598119178112945416 --tag "爆款视频"
huayoungtk-cli video tag --id 350995894763551 --tag "爆款视频" --tag "高转化"
huayoungtk-cli video tag --media-id 7598119178112945416 --tag "爆款视频" --remove
huayoungtk-cli video tag --id 350995894763551 --tag "爆款视频" --dry-run

带货直播（Live）

带货直播是达人在 TikTok Shop 进行的实时销售活动。每场直播可以关联多个商品和多个店铺。

liveBasicInfo 字段

productItem

live list — 列出带货直播

huayoungtk-cli live list [flags]

默认返回 20 条记录。使用 --page-size 调整，--page 翻页。

店铺名称和跟进人昵称会自动从 API 获取并填充，无需额外操作。

示例

huayoungtk-cli live list
huayoungtk-cli live list --last-days 7 --page-size 5
huayoungtk-cli live list --handle creator_handle --page-size 3
huayoungtk-cli live list --shop-id 123 --gmv-from 100
huayoungtk-cli live list --product-no "SKU001"
huayoungtk-cli live list --sort gmv:desc --page-size 10
huayoungtk-cli live list --page-size 3 --jq '.lives[] | {mediaId, views, orders, soldAmount}'

live get — 查看直播详情

huayoungtk-cli live get <--id|--media-id> <value>

两种查找方式（任选其一）：

输出字段： 与 live list 的 liveBasicInfo 结构相同，返回单个对象（非数组）。

huayoungtk-cli live get --id 123456
huayoungtk-cli live get --media-id 7630462341809998613
huayoungtk-cli live get --id 123456 --jq .views

live note — 修改直播备注

修改指定直播的备注信息。通过 --id 或 --media-id 定位直播。

huayoungtk-cli live note <--id|--media-id> <value> --remark <text> [--dry-run]

huayoungtk-cli live note --id 362773137588229 --remark "转化率不错"
huayoungtk-cli live note --media-id 7630462341809998613 --remark "需要跟进"
huayoungtk-cli live note --media-id 7630462341809998613 --remark ""

买家（Buyer）

买家是在 TikTok Shop 下单购买商品的用户。每个买家可以关联多个店铺和多种联系方式。

buyerBasicInfo 字段

contacts 字段

联系方式数组，每项包含：

friendships 字段

各渠道好友状态数组，用于触达决策：

买家状态（status）

好友状态（friendships.status）

联系方式类型（contacts.type）

buyer list — 列出买家

huayoungtk-cli buyer list [flags]

默认返回 20 条记录。使用 --page-size 调整，--page 翻页。

店铺名称和负责人昵称会自动从 API 获取并填充，无需额外操作。

示例

huayoungtk-cli buyer list
huayoungtk-cli buyer list --shop-id <shop-id> --page-size 5
huayoungtk-cli buyer list --has-contact --page-size 3
huayoungtk-cli buyer list --tag "VIP" --region TH --page-size 3
huayoungtk-cli buyer list --amount-from 100 --sort orderAmount:desc --page-size 10
huayoungtk-cli buyer list --page-size 3 --jq '.buyers[] | {buyerId, orderCount, totalSpent}'

buyer get — 查看买家详情

huayoungtk-cli buyer get --id <id>
huayoungtk-cli buyer get --handle <handle>

Flags：

输出字段： 与 buyer list 的 buyerBasicInfo 结构相同，返回单个对象（非数组）。

示例：

huayoungtk-cli buyer get --id 123456
huayoungtk-cli buyer get --handle some_buyer_handle
huayoungtk-cli buyer get --id 123456 --jq .contacts

buyer note — 修改买家备注

修改指定买家的备注信息。通过 --id 或 --handle 定位买家。

huayoungtk-cli buyer note <--id|--handle> <value> --remark <text> [--dry-run]

huayoungtk-cli buyer note --id 123456 --remark "VIP 买家"
huayoungtk-cli buyer note --handle some_buyer --remark "下周跟进"
huayoungtk-cli buyer note --id 123456 --remark ""

buyer tag — 给买家打标签或取消标签

给指定买家添加或移除标签。通过 --id 或 --handle 定位买家。

huayoungtk-cli buyer tag <--id|--handle> <value> --tag <name> [--tag <name2>] [--remove] [--dry-run]

标签不存在时会自动创建。

huayoungtk-cli buyer tag --id 123456 --tag "VIP"
huayoungtk-cli buyer tag --handle some_buyer --tag "VIP" --tag "复购"
huayoungtk-cli buyer tag --id 123456 --tag "VIP" --remove

订单（Order）

订单是 TikTok Shop 买家购买商品产生的交易记录。每笔订单可关联一个店铺、一个买家和多个商品明细。

订单状态

推广类型（trafficSource）

order list — 查询订单列表

huayoungtk-cli order get --order-no # 查看订单详情

huayoungtk-cli order list [flags]

不指定 --shop-id 时查询所有可访问店铺的订单。默认返回 50 条记录，使用 --page-size 调整，--page 翻页。

输出字段

排序字段

id, shopId, amount, createTime, freeSample, status, quantity, cosFee

示例

huayoungtk-cli order list --shop-id <shop-id>
huayoungtk-cli order list --shop-id <shop-id> --status to_ship
huayoungtk-cli order list --last-days 7 --sort amount:desc
huayoungtk-cli order list --shop-id <shop-id> --has-creator
huayoungtk-cli order list --shop-id <shop-id> --promotion-type Video --sort cosFee:desc
huayoungtk-cli order list --shop-id <shop-id> --time-from 2026-05-01 --time-to 2026-05-13
huayoungtk-cli order list --shop-id <shop-id> --commission-min 1 --has-creator
huayoungtk-cli order list --shop-id <shop-id> --jq '.orders[] | {orderId, paidAmount, status}'

order get — 查看订单详情

huayoungtk-cli order get --order-no <orderNo>

通过订单号查看单笔订单的详细信息。返回比 order list 更多的字段（收货地址、联系方式、时间线等）。

输出字段

除 order list 的所有字段外，额外包含：

示例

huayoungtk-cli order get --order-no 583348573376382754
huayoungtk-cli order get --order-no 583348573376382754 --jq '.status'
huayoungtk-cli order get --order-no 583348573376382754 --jq '{orderId, status, buyerHandle, shipAddress}'

索样（Sample Request）

索样（Sample Request）是 TikTok Shop 达人向商家申请免费样品的流程。达人收到样品后通过视频或直播为商家带货。

索样状态

预定义视图（table-type）

sample-request list — 查询索样列表

huayoungtk-cli sample-request list [flags]

默认返回 50 条记录。不指定 --shop-id 时查询所有可访问店铺的索样。

参数

输出字段

排序字段

applyTime, status, commissionRate, expiredTime, lastSyncTime, orderCreateTime, orderSignedTime, gmv, orderCount, videoCount, liveCount, videoGmv, liveGmv

示例

huayoungtk-cli sample-request list --shop-id <shop-id>
huayoungtk-cli sample-request list --shop-id <shop-id> --status ToReview
huayoungtk-cli sample-request list --shop-id <shop-id> --table-type NeedOutput
huayoungtk-cli sample-request list --shop-id <shop-id> -q "handle_or_id"
huayoungtk-cli sample-request list --last-days 7 --sort gmv:desc
huayoungtk-cli sample-request list --shop-id <shop-id> --product-id "PRODUCT123"
huayoungtk-cli sample-request list --shop-id <shop-id> --assignee 12345
huayoungtk-cli sample-request list --shop-id <shop-id> --jq '.sampleRequests[] | {requestId, status, gmv}'

sample-request get — 获取索样详情

huayoungtk-cli sample-request get <--id|--apply-id> <value>

获取指定索样请求的详细信息，包含关联的视频和直播。

huayoungtk-cli sample-request get --id 362773137588229
huayoungtk-cli sample-request get --apply-id "xxx-xxx-xxx"
huayoungtk-cli sample-request get --id 362773137588229 --jq '{status, videoCount, videos: [.videos[].mediaId]}'

sample-request videos — 获取索样关联视频

huayoungtk-cli sample-request videos <--id|--apply-id> <value>

获取指定索样请求关联的视频和直播信息，用于检查达人索样后是否发布了带货视频/直播。

huayoungtk-cli sample-request videos --id 362773137588229
huayoungtk-cli sample-request videos --apply-id "xxx-xxx-xxx"
huayoungtk-cli sample-request videos --id 362773137588229 --jq '.videos[] | {title, views, soldAmount}'

sample-request lives — 获取索样关联直播

huayoungtk-cli sample-request lives <--id|--apply-id> <value>

获取指定索样请求关联的直播信息。

huayoungtk-cli sample-request lives --id 362773137588229
huayoungtk-cli sample-request lives --apply-id "xxx-xxx-xxx"

sample-request archive — 搁置或取消搁置索样

huayoungtk-cli sample-request archive <--id|--apply-id> <value> [--unarchive] [--dry-run]

将指定索样请求标记为搁置（归档）或取消搁置。仅对 ToReview（待审核）状态的索样生效，其他状态会被跳过。使用 sample-request list --archived 查看已搁置的索样。

huayoungtk-cli sample-request archive --id 362773137588229
huayoungtk-cli sample-request archive --apply-id "xxx-xxx-xxx"
huayoungtk-cli sample-request archive --id 362773137588229 --unarchive
huayoungtk-cli sample-request archive --id 362773137588229 --dry-run

sample-request approve — 同意索样

huayoungtk-cli sample-request approve <--id|--apply-id> <value> --device-id <id> [--dry-run]

同意指定的索样请求，触发 RPA 浏览器自动化在 TikTok Shop 平台执行同意操作。同意后平台将向达人发送样品，此操作不可撤销。

测试时务必使用 --dry-run。

输出字段：

huayoungtk-cli sample-request approve --id 362773137588229 --device-id abc123 --dry-run
huayoungtk-cli sample-request approve --apply-id "xxx-xxx-xxx" --device-id abc123

sample-request reject — 拒绝索样

huayoungtk-cli sample-request reject <--id|--apply-id> <value> --device-id <id> [--dry-run]

拒绝指定的索样请求，此操作不可撤销。测试时务必使用 --dry-run。

参数与输出字段同 approve，action 为 "拒绝"。

huayoungtk-cli sample-request reject --id 362773137588229 --device-id abc123 --dry-run
huayoungtk-cli sample-request reject --apply-id "xxx-xxx-xxx" --device-id abc123

设备是执行店铺任务（如同步店铺信息）的载体。花漾TK 通过 RPA 在设备上执行操作。

设备类型

设备与店铺对应规则

device list — 列出可用设备

huayoungtk-cli device list [flags]

huayoungtk-cli device list
huayoungtk-cli device list --shop-id <shop-id> --online
huayoungtk-cli device list --jq '.devices[] | {deviceId, deviceType, online}'

团队信息（Team）

team info — 查看团队信息、套餐、配额

huayoungtk-cli team info

返回当前登录团队的基本信息、订阅状态和配额明细。

返回字段

每项配额包含 name、quota（上限）、used、remaining、summary。配额为"不限制"表示无上限。

使用建议

• "团队还有多少配额" → 查看 quotas 中对应项
• "套餐什么时候过期" → 查看 subscription.expireTime
• "还能加多少成员/店铺" → 查看对应配额的 remaining

任务查询（Job）

job get — 查看任务详情与状态

huayoungtk-cli job get --job-id <id>

任务状态

状态值 >= 8 为终态，不再变化。

job cancel — 取消任务

huayoungtk-cli job cancel --job-id <id> --dry-run
huayoungtk-cli job cancel --job-id <id>

取消正在执行或等待中的 RPA 任务。取消后任务状态变为 Cancelled，关联的 RPA 执行也会被终止。

使用场景

1. 轮询任务状态：创建任务后，定期调用直到 status >= 8
2. 查看失败原因：任务失败时查看 description 字段
3. 查历史任务：活跃表查不到时尝试 --alive=false
4. 取消任务：任务卡住或不再需要时，用 job cancel 终止

使用建议

• 用户询问"我有多少店铺" → shop list 查看 total
• 用户询问"哪些店铺在线" → shop list --jq '.shops[] | select(.status == "Online")'
• 用户询问"某国家有哪些店铺" → shop list --jq '.shops[] | select(.site == "Malaysia")'
• 用户要同步店铺 → 按完整流程操作（shop list → device list → shop sync），不要跳过 device list
• shop sync 是异步操作，只告知用户任务已创建
• 用户要取消任务 → job cancel --job-id <id>
• 用户询问"团队配额" → team info 查看 quotas
• 用户询问"最近有哪些视频" → video list --tab-type latest3day
• 用户询问"哪些视频效果好" → video list --sort conversionRate:desc
• 用户询问"某达人的视频" → video list --creator-id <id> 或 video list --handle <handle>
• 用户询问"某店铺的视频" → video list --shop-id <id>
• 用户询问"某店铺有多少订单" → order list --shop-id <id> --jq '.total'
• 用户询问"待发货订单" → order list --shop-id <id> --status to_ship
• 用户询问"达人带来的订单" → order list --shop-id <id> --has-creator
• 用户询问"最近7天高金额订单" → order list --last-days 7 --sort amount:desc
• 用户询问"视频带来的订单" → order list --shop-id <id> --promotion-type Video
• 用户询问"最近的直播" → live list --last-days 7
• 用户询问"哪场直播效果最好" → live list --sort gmv:desc
• 用户询问"某达人的直播" → live list --creator-id <id> 或 live list --handle <handle>
• 用户询问"某店铺的直播" → live list --shop-id <id>
• 用户询问"有多少索样待审核" → sample-request list --shop-id <id> --status ToReview --jq '.total'
• 用户询问"待发货的索样" → sample-request list --shop-id <id> --table-type ReadyToShip
• 用户询问"已签收但没产出内容的索样" → sample-request list --shop-id <id> --table-type NeedOutput
• 用户询问"索样效果如何" → sample-request list --shop-id <id> --sort gmv:desc
• 用户询问"未履约的索样" → sample-request list --shop-id <id> --table-type Unfulfilled
• 用户询问"某达人的索样记录" → sample-request list --shop-id <id> -q <creator_handle>
• 用户询问"索样后达人有没发视频" → sample-request videos --id <id>
• 用户询问"搁置某个索样" → sample-request archive --id <id>
• 用户询问"取消搁置索样" → sample-request archive --id <id> --unarchive
• 用户询问"同意索样"/"批准索样" → sample-request approve --id <id> --device-id <deviceId> --dry-run（确认后去掉 --dry-run）
• 用户询问"拒绝索样" → sample-request reject --id <id> --device-id <deviceId> --dry-run（确认后去掉 --dry-run）
• 用户询问"查看已搁置的索样" → sample-request list --archived
• 修改达人合作状态后，全局状态会自动重算
• --cid 通过模糊搜索匹配，建议优先使用 --id 或 --handle