Skip to content

Shenrui-Ma/video-regen-recipes / templates/character-short/bit-by-bit-heartache

bit-by-bit-heartache

Verified

用角色参考图在本机制作 Heartache 连续动作配乐短片.

FileKindSize
.gitignoreother430 B
LICENSEother1.1 KB
LICENSES.mdmarkdown1.4 KB
README.mdmarkdown9.3 KB
SKILL.mdskill md7.3 KB
assets/README.mdmarkdown4.9 KB
assets/default/manifest.jsonconfig3.8 KB
assets/runtime-assets.jsonconfig5.5 KB
profile.jsonconfig3.8 KB
prompts/ref2va.template.txtmarkdown1.6 KB
prompts/yaoguang.historical.txtmarkdown5.0 KB
references/background-removal.mdmarkdown5.5 KB
references/changelog.mdmarkdown916 B
references/character-input.mdmarkdown4.7 KB
references/deployment.mdmarkdown4.9 KB
references/editing.mdmarkdown3.7 KB
references/environment.lock.jsonconfig1.5 KB
references/first-segment-validation.jsonconfig1.8 KB
references/generation.mdmarkdown3.8 KB
references/media-preflight.mdmarkdown4.2 KB
references/native-continuation.mdmarkdown17.8 KB
references/node-sources.jsonconfig6.7 KB
references/node-sources.mdmarkdown3.8 KB
references/package-verification.jsonconfig1.7 KB
references/reference-check.jsonconfig968 B
references/reproduction.mdmarkdown10.1 KB
references/validation.mdmarkdown2.6 KB
references/workflow-recovery.mdmarkdown2.2 KB
references/workflow.lock.jsonconfig1.2 KB
references/yaoguang-run.jsonconfig7.4 KB
scripts/character/prepare_character.pyscript6.5 KB
scripts/distribution/fetch_assets.pyscript5.8 KB
scripts/distribution/package_skill.pyscript5.6 KB
scripts/plan_segments.pyscript3.4 KB
scripts/prepare_driver.pyscript5.2 KB
scripts/render_default.pyscript5.5 KB
scripts/runtime/graphs.pyscript11.3 KB
scripts/runtime/heartache.pyscript14.6 KB
scripts/runtime/local_io.pyscript3.3 KB
scripts/runtime/media.pyscript13.2 KB
scripts/runtime/run_segment.pyscript13.3 KB
sources.mdmarkdown2.4 KB
tests/test_background_removal.pyscript2.6 KB
tests/test_character_input.pyscript12.2 KB
tests/test_default.pyscript879 B
tests/test_distribution.pyscript12.3 KB
tests/test_media_preflight.pyscript2.1 KB
tests/test_prepare_driver.pyscript1.9 KB
tests/test_release_review.pyscript1.7 KB
tests/test_reproduction.pyscript1.9 KB
tests/test_runtime_cli.pyscript11.3 KB
tests/test_runtime_graph.pyscript4.8 KB
tests/test_runtime_io.pyscript2.1 KB
tests/test_runtime_media.pyscript10.2 KB
tests/test_runtime_runner.pyscript1.6 KB
tests/test_segment_plan.pyscript3.4 KB
tests/test_skill_contract.pyscript1.6 KB
workflows/continue.editor.jsonconfig23.8 KB
workflows/first.editor.jsonconfig19.8 KB
workflows/node-schema.jsonconfig22.2 KB
workflows/provenance.jsonconfig911 B

assets/README.md

View on GitHub
# 按需获取素材:默认分发包不含媒体

默认 ZIP 只保留母技能文档、脚本、工作流、补丁、许可证与 JSON 清单。**PNG/其他图片、音乐、视频、latent、模型权重及未知二进制格式均不随默认包分发**,不限于 `assets/` 目录。打包使用文本文件类型白名单;不会删除、改写现有本地素材。

从技能根目录执行:

```bash
# 默认只获取 runtime 的 577 帧动作参考与音乐;不下载历史爻光图片或剪辑
python scripts/distribution/fetch_assets.py

# 只校验默认两项:无网络、无写入;缺失或哈希不符时退出码为 2
python scripts/distribution/fetch_assets.py --check

# --assets 替代默认选择;填写相对 assets/ 的清单路径,可一次指定多个
python scripts/distribution/fetch_assets.py --assets default/music.m4a
python scripts/distribution/fetch_assets.py --assets default/yaoguang.png
python scripts/distribution/fetch_assets.py --check --assets default/yaoguang.png

# 可选:明确复用历史剪辑时,单独获取所需片段
python scripts/distribution/fetch_assets.py --assets default/clips/part-01.mp4 default/clips/part-02.mp4
```

`--without-default-character` 继续兼容旧命令,但默认已不选历史角色图;此参数会进一步排除显式选择中的历史角色图。新角色应通过角色输入流程提供,不能用历史爻光图冒充用户指定角色。

## 可验证的公开来源

[`runtime-assets.json`](runtime-assets.json) 为每项素材记录公开 HTTPS URL、精确字节数、SHA-256、用途及 `download_by_default`。下载源是 [Video ReGen 媒体库](https://huggingface.co/datasets/Shenrui-Ma/video-regen-assets) 的固定 revision,URL 采用 `resolve/<revision>/<path>`,因此以后改动媒体库不会改变已发布内容的字节。下载器验证字节数和 SHA-256;同名文件已匹配则跳过,不匹配则拒绝覆盖。

| 清单路径 | 默认获取 | 用途 |
| --- | --- | --- |
| `reference/heartache-driver-577f.mp4` | 是 | runtime 冻结动作参考:1344×768、24 fps、577 帧;160208343 字节 |
| `default/music.m4a` | 是 | 音乐输入;按成片时长截取并淡出 |
| `default/yaoguang.png` | 否 | 可选历史爻光身份参考;2352×2352,仅用于明确要求的示例 |
| `default/driver.mp4` | 否 | 历史原始动作视频,约 45 fps;**不能替代 runtime 的 577 帧参考** |
| `default/clips/part-01.mp4`、`default/clips/part-02.mp4` | 否 | 历史已发布剪辑,各 158 帧 |
| `default/clips/part-03.mp4`、`default/clips/part-04.mp4` | 否 | 历史 canonical 完整解码,各 175 帧 |

runtime 动作参考 SHA-256:`e63386ab88bf4a11dc2fd859b0075099229cad44d77366a220c6e0bb0ba0ca0d`。

[`default/manifest.json`](default/manifest.json) 保留历史素材的媒体规格与处理记录。PNG 已去除内嵌工作流、文字和 EXIF;压缩图像数据保持不变。历史视频采用流拷贝移除容器元数据,剪辑去除音频并使用独立音乐轨。这些历史片段不是新角色生成结果,也不能代替 `latent.safetensors` 做原生续接。

离线缓存可通过 `--cache-dir` 指定:将原始文件按清单文件名放入缓存目录,下载器复制前后均校验;未命中缓存仍会尝试公开 URL。`--asset-root` 可指定目标素材目录。下载中断只留下 `.part`;若校验失败,检查并仅移除对应 `.part` 后重试,不会覆盖已有目标文件。`--check` 是严格只读模式。

## 打包与权重边界

```bash
# 输出必须在技能源目录之外,且不能覆盖现有 ZIP
python scripts/distribution/package_skill.py --output ../heartache-lightweight.zip
python scripts/distribution/package_skill.py --verify ../heartache-lightweight.zip

# 兼容旧行为的显式全量包:包括已有本地二进制文件,不下载素材;不是轻量包
python scripts/distribution/package_skill.py --full --output ../heartache-with-local-assets.zip
```

`BUNDLE-MANIFEST.json` 记录包含文件及被省略文件的字节数与 SHA-256;省略清单的兼容字段名为 `omitted_downloadable_assets`,**不代表其中每个任意本地二进制都有公开下载源**。素材获取以 `runtime-assets.json` 为准;模型来源、固定版本及位置另见 [环境依赖锁](https://github.com/Shenrui-Ma/shenrui-comfyui-toolkit/tree/667eafddb9f42bb6c72ad27b665def9ada36df45/environments/h3/dependencies.lock.json),模型下载/安装是单独步骤,不由 `fetch_assets.py` 执行。默认包不含任何模型权重;`--full` 会带入已存在的本地二进制(包括权重),分享前须自行检查体积及授权。

## 授权

素材由贡献者提供作为本案例输入和演示;仓库 MIT 许可不自动覆盖角色 IP、原视频和歌曲,不附加第三方素材的商业使用或自由再分发授权。来源见[说明](../sources.md)。公开 URL 不等于授权,获取或再分发前须检查对应权利。
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall