Shenrui-Ma/video-regen-recipes / skills/character-showcase-editing
character-showcase-editing
Verified将角色图片、图与对应视频、或已有视频剪成角色展示合集。保留原始缩放曲线与四种时间线,支持连续音乐、原声及混音;默认只生成计划,明确执行后才渲染。
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 6.7 KB |
| SKILL.md | skill md | 4.8 KB |
| examples/a-dynamic-images.json | config | 524 B |
| examples/b-static-images.json | config | 523 B |
| examples/c-still-video.json | config | 966 B |
| examples/d-video-collection.json | config | 780 B |
| scripts/showcase.py | script | 30.9 KB |
| tests/test_showcase.py | script | 13.8 KB |
SKILL.md
View on GitHub---
name: character-showcase-editing
description: 将角色图片、图与对应视频、或已有视频剪成角色展示合集。保留原始缩放曲线与四种时间线,支持连续音乐、原声及混音;默认只生成计划,明确执行后才渲染。
---
# 角色合集剪辑
输入一个有序素材清单,输出角色合集 MP4。上游先完成 ComfyUI 生图和所需 H3 图生视频;本 Skill 负责后期,不会自行启动这些模型。
| 模式 | 画面 | 时长规则 |
| --- | --- | --- |
| A | 图片缩放、由糊变清;仅前景溶解,背景稍后硬切 | `total_frames` 固定总长 |
| B | 静态合成图,整画面交叉溶解;无缩放或动态模糊 | `total_frames` 固定总长,输入自动补重叠 |
| C | 图 1 → 视频 1 → 图 2 → 视频 2 | 各段时长之和减去边界重叠 |
| D | 视频 1 → 视频 2 | 各段时长之和减去边界重叠 |
## 执行顺序
1. 从用户选择的模板读取默认参数;用户只给一句话时,沿用这些公开默认值。明确“纯溶解”用 B;明确“原图再动起来”用 C;只要动态合集用 D。不要把某次项目特例扩成全局默认。
2. 没有图片时转到 [ComfyUI 参考图 Skill](../comfyui-reference-images/SKILL.md),完成模型/工作流解析、角色与场景图生成。C 将每张图绑定其实际 H3 输出,不凭相似文件名自动替换失败版本。
3. 新建工作目录,按模板的生成清单写 `edit.json`。路径相对该 JSON;显式列出每个文件、顺序、版本和配对。排除临时图、弃用版本及封面;勿自动按名称排序。
4. 执行 `--plan`。检查模式、片数、顺序、帧数、音乐源起点与输出起点;缺少待生成素材仍可算计划。这里不打开图片、不探测媒体、不运行 FFmpeg。
5. 素材完成后执行 `--check`,只校验文件存在性和输出路径。它不证明媒体可解码、画质良好或角色正确。
6. 用户的创作任务授权包含剪辑时执行 `--render`。只有明确请求渲染的命令才进入 Pillow/FFmpeg;若本轮只要求检查文件,停在第 5 步。
7. 成功交付输出 MP4 与同名 `.render.json`。渲染器核对实际视频帧数和音轨存在性,写 `rendered_awaiting_user_review`。没有播放/视觉检查就不写“画质验收通过”。
在仓库根目录运行,`job/edit.json` 换成当前任务文件:
```bash
python3 skills/character-showcase-editing/scripts/showcase.py job/edit.json --plan
python3 skills/character-showcase-editing/scripts/showcase.py job/edit.json --check
# 仅在实际制作视频时:
python3 skills/character-showcase-editing/scripts/showcase.py job/edit.json --render
```
完整字段、四份可复制配置与限制见 [配置说明](README.md)。没有参数开关时默认 `--plan`,不会生成任何媒体。
## 不可混淆的规则
- A 保留历史 Python 的 Hermite 曲线:312 → 222 → 222 → 104%,60 fps 相对关键帧为 0、123、186.268、310.733;归一化切线不能再乘帧间距。模糊 45 → 0 到 91.117 帧结束。别换成 smoothstep。
- A 的 25 帧前景转场位于边界前 12 帧到后 13 帧,背景在边界后 14 帧切换。它不会让总片长每次减少 25 帧。不同帧率按秒换算并取整。
- B 每张图只预合成一次,整画面溶解;不要给它加入 A 的动效。
- C 中 `scale_speed` 仅加速图片缩放,模糊时间独立。视频只播放自身运动;不附加图片缩放曲线。
- C/D 的视频先裁源区间再变速,输出帧数取 `round(source_take_seconds / speed × fps)`。硬切用零重叠;不保留溶解的减时公式。
- `layout.mode=blurred` 对应旧方形前景布局;`blurred-fill` 对应画布内完整主体加同帧模糊背景;`plain` 适合已完成构图的视频。三者均保持比例。输入不能被强制拉伸成正方形。
- `audio.mode` 必须明确:`silent`、`bgm`、`source`、`source+bgm`。原声音视频变速同步,缺音轨补静音,跨段音频使用相同重叠。只换背景音乐不代表获准丢弃要求保留的自然声。
- `source_start_seconds=1` 是从音乐第 1 秒取样;`output_start_seconds=0` 是成片立刻播放。两者独立。
- 不使用同名旧片充当新成片。输出和成功记录均拒绝覆盖;临时文件放在独占目录,失败不留下成功记录。
## 验证范围
已做配置、曲线、配对、时间线、命令构造与失败路径的纯数据测试。本实现没有重新渲染或观看历史媒体,新环境的 FFmpeg 滤镜兼容性、内存占用与成片质量待实际制作时验证。A 保留历史程序的数值曲线,不保证与 Premiere 像素一致;历史全白蒙版的羽化并无有效边缘效果,本实现不冒称恢复了真正的 PR 羽化。
整理与配方:**Shenrui Ma(四倍体果蝇)**。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |