技能介绍

要解决的问题

素材组把当天的原始视频往 00_Inbox/ 一丢，后面的事情就没下文了：哪些是新片子、画面里到底拍了什么、能剪出什么尺寸的版本、配什么文案，全靠人工一条条过。等真正打开播放器逐帧看的时候，一天已经过去大半。更麻烦的是平台规则不统一——Facebook 横竖都能发，TikTok 只吃竖屏，同一条素材要产出 16:9、9:16、1:1 多套版本，手动裁切既慢又容易切错构图。

这个技能做了什么

它把「收件箱 → 待审片」之间的流程拆成固定的几步，跑一条无状态的流水线：

Scan：扫描 00_Inbox/ 下的新视频，自动跳过 _done/ 里已处理完的。
Analyze：调用 video.analyzer.v1 抽取关键帧，交给多模态大模型做画面分析。
Copywriting：调用 copywriting.llm.v1 生成 A/B/C 三版文案，留作后续人工挑选。
Crop：按画面方向走 FFmpeg 智能裁切，方向判定逻辑很明确——

- 竖屏（h > w）→ 9:16 居中裁切
- 横屏（w > h）→ 16:9 居中裁切，额外产出 vp（9:16 上下加黑边）
- 方形（比例 0.9～1.1）→ 1:1 居中裁切，同样额外产出 vp

Produce / Output：生成 v1/v2/v3 三个基础片段，加上可选的 vp 竖屏版，连同文案一起写入 02_PendingReview/。
Archive：源片归档到 00_Inbox/_done/，避免下次重复处理。

适用边界与注意点

它不判断平台合规。FB 支持所有方向、TikTok 只收竖屏这类规则，是由调用它的上层专家决定的；技能本身只处理「给到它手上的任何方向」，不要指望它自动帮你筛掉横屏。
强依赖项目级基础设施：core/model_providers.py、core/logger.py、core/state_machine.py、core/sop_pipeline.py 这几个核心模块，以及 .env 里的 API Key（OpenRouter、DashScope 等），换环境部署前先确认路径和依赖都到位。
系统层需要装好 FFmpeg，Python 侧依赖 opencv-python、requests、python-dotenv，所有命令必须在项目根目录执行。
文案是模型生成的 A/B/C 备选，不是最终定稿，发布前仍需人工过一遍。
输出片段统一落到 02_PendingReview/，说明这条流水线的定位是预处理，终审和排期在它之外。