video-reframe · 视频画幅智能转换
把视频转换到 9:16、16:9、1:1 等目标宽高比的 skill，提供模糊背景填充、焦点裁切、人脸居中裁切三种策略。
横转竖默认模糊背景填充（画面不丢失）；口播/人物视频可用人脸感知裁切；smart 模式未检出人脸时自动退化为居中裁切并在报告中说明。
调用示例：在聊天框中说"把这段横版视频转成 9:16 竖版"。
产品详解
定位
video-reframe 是专做画幅转换的原子工具：把视频转到目标宽高比，三种策略可选，全部走确定性脚本，不手拼滤镜。
核心能力
- blur（默认）：原画完整居中 + 放大模糊的自身作背景，无黑边，横转竖最稳，画面不丢内容。
- crop：按焦点位置裁到目标比例，无黑边但裁边缘；主体偏离中间时可用
--focus-x指定焦点（0 左 1 右）。 - smart：cv2 检测人脸，以人脸中位位置为焦点裁切；未检出人脸时自动退化为居中裁切，并在报告里说明。
- 目标比例：9:16 / 16:9 / 1:1 / 4:5 / 3:4 / 4:3 / 21:9，可用
--size强制最终分辨率。 - 音轨自动保留（copy，不重编码音频）；输出分辨率强制偶数对齐（H.264 要求），无需手动处理。
工作流程
- 确认视频文件、目标比例、转换模式（拿不准默认 blur）
- 运行
reframe.py reframe，脚本计算裁切尺寸、焦点边界与偶数对齐 - 输出转换后视频与报告（源→目标尺寸、所用策略、smart 时的人脸焦点）
输入与输出
| 输入 | 说明 |
|---|---|
| 视频文件 | 必填（没给就问） |
| 目标比例 | 必填，9:16 / 16:9 / 1:1 / 4:5 / 3:4 / 4:3 / 21:9 |
| 模式 | 选填，blur（默认）/ crop / smart |
| 焦点 | 选填，crop 模式下主体不在中间时用 --focus-x |
输出：outputs/主题名/ 下的转换后视频（*-<比例>.mp4）与转换报告。
与相邻 skill 的区别
- video-editing aspect：简单的补边/裁切、加黑边/居中裁，轻量通用；需要策略化转制时用本 skill。
- clipify：逐镜头动态人脸追踪 pan，用于切片流程内部；本 skill 做整段画幅转制。
- video-reframe（本）：三策略智能转制，横转竖场景最稳的选择。
适用场景
- 横版视频适配抖音/视频号竖屏发布
- 口播/人物视频的人脸居中转竖版
- 方形、4:5 等多平台尺寸适配
使用前准备
- 无需 API key，SKILL.md 未提及额外配置需求。
- 选模式原则：横转竖优先 blur（不丢画面）；主体明确且想铺满屏幕用 crop；人物口播用 smart。
- 有 Profile 时按主平台给默认目标比例（抖音/小红书 9:16，B站 16:9，朋友圈/ins 1:1）；无 Profile 时默认 blur + 询问目标平台。
video-reframe 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。