用途：研究 TikTok 公开直播电商市场。适用于用户点名出海匠或 Chuhaijiang，且意图为直播搜索、直播详情或从直播反查带货商品时；未指定数据源时，仅在需要从直播反查带货商品时触发。通用 TikTok 带货直播榜单或详情不使用本技能。
主要能力：
- 搜索公开直播：POST /chuhaijiang/lives/search，脚本 chuhaijiang_live_search.py。返回 data.items[] 与 data.total_count。
- 查看单场直播详情：POST /chuhaijiang/lives/detail，脚本 chuhaijiang_live_detail.py。传 include=core 可返回归一化表现指标 data.core.items[]。
- 查找直播带货商品：POST /chuhaijiang/lives/related-products，脚本 chuhaijiang_live_related_products.py。返回 tiktok_live_detail_product_* 字段。
使用方式： Python 脚本调用格式：python scripts/chuhaijiang_live_<entry>.py '<JSON 参数>' [--inline]，entry 为 search、detail 或 related_products。示例： python scripts/chuhaijiang_live_search.py '{"country":"us","isCommercial":true,"sort":"gmv:desc","page":1,"pageSize":3}' python scripts/chuhaijiang_live_detail.py '{"country":"us","id":"7643101948819835678","include":"core"}' python scripts/chuhaijiang_live_related_products.py '{"country":"us","id":"7643101948819835678","page":1,"pageSize":3}'
关键参数：country 必填小写市场代码（br、de、es、fr、gb、id、it、jp、mx、my、ph、sg、th、us、vn）；page 从 1 开始，搜索与关联商品 pageSize 最大 10；detail 与 related-products 必填 id，19 位 ID 需以 JSON 字符串传入以保精度；搜索支持 keyword、category、productCategory、isLiving、isCommercial、销量/GMV/观众范围及 field:asc|desc 排序，默认 gmv:desc。请求字段用 camelCase，按 references/api.md 为准。
输出与缓存：完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下 JSON 文件；响应 ≤8KB 全量打印 stdout，>8KB 只输出摘要，--inline 强制全量打印。成功响应默认缓存 24 小时，命中输出 Cache hit 且不发起付费请求；--no-cache 会强制真实请求并可能再消耗算力，仅在用户同意或调试时使用。
计费与限制：按端点分别计费，直播详情 9 算力/次，直播搜索与关联商品 18 算力/次；高频或多端点钻取前应说明预计次数与消耗。数据为供应商索引的公开快照，可能落后于 TikTok；isLiving 仅为搜索筛选条件，不证明展示时仍在线；关联商品仅在已索引直播存在商品关系时可用；搜索筛选不表示因果关系。不得展示内部工具标识、凭证、缓存文件或无关字段。