小红书商品评价采集
一次只处理一个商品、一个飞书视图和明确页数。新任务会新增全部评价，不跨任务去重；同一任务失败后使用 checkpoint 恢复，避免重复创建已经成功的记录。
执行流程
- 确认当前使用者的电脑已安装
lark-cli，并已用本人飞书用户身份登录且能访问目标 Base。 - 从用户第一次消息中一次性读取四项可见输入；缺少任意一项就只补问缺少项，不执行：
text
TikHub API Key：<当前用户的 Key>
小红书商品链接：<分享口令、短链接或商品链接>
飞书多维表格链接：<包含 table 和 view 的完整视图链接>
采集页数：<明确正整数>
- 采集页数必须是单独、明确的正整数，不能接受“全部”“尽可能多”等模糊值。
- 阅读 references/base-schema.md，调用脚本时同时传入四项并增加
--execute。不要要求用户转到终端再次输入 Key：
bash
python3 scripts/collect_xhs_reviews.py \
--api-key '<TikHub Key>' \
--product '<商品分享内容或链接>' \
--base-url '<完整飞书视图链接>' \
--pages <正整数> \
--execute
- 脚本必须先预检商品、Base、表、视图和16个字段。预检失败就停止，不能调用 TikHub 或写飞书。
- 用户同时提交完整四项即代表授权本次付费调用和飞书写入；预检通过后直接执行，不再二次询问“执行采集”。
- Key 可以作为本次普通输入和脚本参数使用，但不得主动回显，不得写入代码、checkpoint 或测试数据，也不得从钥匙串或环境变量读取。
- 若结果为部分完成，保留 checkpoint。继续时由用户再次提供四项和 checkpoint 路径，直接恢复同一任务。
- 只依据最终飞书回读结果报告成功。分别报告源图片数、下载成功数、上传成功数和失败数。
边界
- 仅支持字段兼容的已有飞书 Base 视图；缺字段或类型不兼容就停止，不建表、不补字段。
- 从 TikHub 第 0 页开始，最多请求指定页数；遇到
hasMore=false提前停止。 - 只有识别到 Skill 不代表授权；用户必须在同一任务中提交完整四项。完整四项一经提交，即代表本次执行授权。
- 每个新任务允许写入与历史任务相同的评价；只有
--resume会跳过同一 checkpoint 中已经成功创建的记录。 - 评价标签和用户标签的真实新选项只在执行阶段合并，回读生效后再写记录。
- Key 会存在于用户主动发送的聊天内容及相关任务执行记录中；Skill 不承诺隐藏聊天中已经显示的 Key。
