批量定时发布排期

管理一张排期表（内容×平台×时间），到点把任务派发给各平台发布 SKILL。走 scripts/publish_queue.py（纯标准库）。本 SKILL 负责调度与状态，实际发布委派各平台 publisher （skill-xhs-publisher / skill-douyin-upload / skill-wechat-publisher / skill-bilibili-upload / cross-platform-publish）。

输入

排期表 CSV（表头需含 publish_at, platform, content，可选 title, note）：

publish_at,platform,content,title
2026-08-01 09:00,xiaohongshu,outputs/note1,早间笔记
2026-08-01 20:00,douyin,outputs/主题名/final.mp4,晚间视频

或等价 JSON。

执行

脚本路径（相对项目根）：skills/builtin/skill-publish-scheduler/scripts/publish_queue.py（各子命令 -h）。

Q=outputs/publish-queue/q.json
python <skill>/scripts/publish_queue.py import --file plan.csv --queue $Q   # 导入排期
python <skill>/scripts/publish_queue.py list  --queue $Q                    # 查看队列
python <skill>/scripts/publish_queue.py due   --queue $Q                    # 此刻到期项
python <skill>/scripts/publish_queue.py run   --queue $Q                    # 打印到期派发计划
# 按计划逐条委派对应平台 publisher 发布，完成后回填：
python <skill>/scripts/publish_queue.py mark  --queue $Q --id 1 --status done

到期派发流程（编排）

1. due/run 得到此刻到期项。
2. 对每条到期项：按 platform 委派对应发布 SKILL 执行真实发布 （单平台或用 cross-platform-publish）。发布前按平台适配内容格式。
3. 发布成功/失败后 mark 回填状态（可配合 skill-publish-notify 推送结果、skill-publish-log 记录）。
4. 需要"守护式到点触发"时，由当前执行引擎可用的定时功能或系统调度器周期性跑 run（本脚本只做单次到期计算，不常驻）；没有调度能力时说明限制。

规则

1. 本 SKILL 不直接驱动浏览器/API 发布——只做排期与状态管理，发布交给各平台 publisher。
2. --now 可覆盖当前时间用于预演（查看某时刻会发哪些），不影响真实时间。
3. 发布时间用 YYYY-MM-DD HH:MM；同一时刻多平台会一并到期。
4. 每条发布后务必 mark，避免重复发布。
5. 定时触发依赖上层（执行引擎定时功能 / 系统调度器 / 手动周期跑），本脚本是无状态到期计算 + 持久化队列。

参考来源

排期→到期计算→派发→状态回填是内容日历落地发布的标准闭环。调度与真实发布分层： 调度纯脚本（可测），发布委派各平台 publisher（环境相关）。