Mixtiles 月度流水线

每月自动从 WhatsApp 群组中收集最优质的家庭照片，完成筛选与整理，并生成一个可直接下单的 Mixtiles 购物车链接。

配置

以下环境变量用于控制该流水线。请在运行前设置：

流水线步骤

步骤 1：采集照片

计算上个月的日期范围，并从群组中下载全部照片：

# 计算上个月的第一天
YEAR_MONTH=$(date -v-1m +%Y-%m)  # macOS
AFTER_DATE="${YEAR_MONTH}-01"
OUTPUT_DIR=~/mixtiles-queue/${YEAR_MONTH}

# 运行采集脚本
bash /scripts/collect-photos.sh "$MIXTILES_GROUP_JID" "$AFTER_DATE" "$OUTPUT_DIR"

该脚本将向标准输出打印一份 JSON 清单，其中包含每张已下载照片的 {id, sender, timestamp, filepath} 字段。

步骤 2：使用视觉能力进行筛选

利用你的视觉能力逐张读取已下载的照片。对每张照片评估如下：

应保留若满足以下任一条件：

• 真实家庭/生活瞬间（含人物、聚会、重要里程碑、儿童、旅行、宠物等）
• 图像质量良好（清晰、光线充足、对焦准确）
• 场景独特（非其他照片的近似重复）

应排除若满足以下任一条件：

• 截图、梗图（meme）、转发图片或链接预览图
• 模糊、过暗或质量极差
• 与已入选的更优版本高度重复
• 文字密集型图像（如 WhatsApp 转发内容、新闻文章截图）
• 推广内容或广告

步骤 3：精选优质照片

从已筛选出的照片集中，选出评分最高的 $MIXTILES_PHOTO_COUNT 张（默认为 4 张）。优先级如下：

1. 人物与面部（尤其是儿童、家庭聚会场景）
2. 重要里程碑时刻（生日、学步、毕业等）
3. 旅行与体验类照片
4. 多样性 — 若存在多个不同事件，则避免全部选取自同一事件

若符合要求的照片少于 $MIXTILES_PHOTO_COUNT 张，则使用所有通过筛选的照片。

步骤 4：构建多图购物车

使用 mixtiles-it 技能中的脚本，并传入 --batch 参数：

MIXTILES_CART_SCRIPT="$(find ~/.openclaw/workspace/skills/mixtiles-it/scripts -name 'mixtiles-cart.py')"

python3 "$MIXTILES_CART_SCRIPT" 
  --batch     
  --size "${MIXTILES_TILE_SIZE:-RECTANGLE_12X16}"

该命令会将每张照片上传至 Cloudinary，并输出一个包含全部照片的 Mixtiles 购物车 URL。

步骤 5：发送链接

将购物车链接发送至目标聊天会话：

SEND_TO="${MIXTILES_SEND_TO:-$MIXTILES_GROUP_JID}"

wacli send text 
  --to "$SEND_TO" 
  --message "您的月度磁贴已准备就绪！这是上个月最优质的 ${MIXTILES_PHOTO_COUNT:-4} 张照片。点击即可自定义并下单：$CART_URL"

错误处理

• 若 collect-photos.sh 找到 0 张照片：报告该时间段内未发现图像，并跳过后续流水线步骤。
• 若通过筛选的照片数量少于 MIXTILES_PHOTO_COUNT：仍使用所有通过筛选的照片 — 即使仅 1 张也值得发送。
• 若某张照片上传 Cloudinary 失败：跳过该照片，继续处理其余照片。
• 若 wacli send 发送失败：打印购物车 URL，供用户手动发送。

手动触发

如需在月度计划之外手动执行该流水线：

运行 mixtiles-monthly 技能：从家庭群组中采集过去一个月的照片，筛选出最优照片，构建多图购物车链接，并将其发送出去。