video-post

video-post

把动画 HTML 和视频母版，稳定变成可重复交付的成片版本。

这是什么

video-post 是一个面向短视频和动画后期的 agent skill。它接收动画 HTML、干净母版 MP4、单首音乐或音乐目录，然后稳定产出可交付结果，包括母版视频、60fps 版本、GIF 预览、单曲混音版、批量音乐版，以及最终校验汇总。

它的定位是 huashu-design 的后处理层：前者负责做动画，后者负责把动画变成可靠的交付物。

输入：动画 HTML / 母版 MP4 / 单个音乐文件 / 音乐目录
输出：母版 MP4 / 60fps MP4 / GIF / 音乐版本 / 校验汇总

核心特性

这个 skill 故意保持边界清楚。它不是全能剪辑台，而是把短片后期里最稳定、最重复、最适合沉淀成流程的部分做扎实。

工作流程

推荐顺序是：

1. 先导出干净母版。
2. 所有其他版本都从母版派生。
3. 音乐只加在派生版本上，不在已经混过音乐的文件上继续叠加。
4. 每次导出后都做结果校验，不把“命令跑完”当成完成。

安装

环境要求

• Node.js 18+
• Bun
• FFmpeg
• FFprobe
• Chrome 或 Chromium 浏览器（用于把 HTML 导出成视频）

安装方式

npx skills add https://github.com/geekjourneyx/video-post

安装完成后，video-post 就可以作为已安装 skill 直接接入你的 agent 工作流。

本地开发

如果你要修改这个 skill 本身，可以直接克隆仓库，在独立仓库里开发：

git clone git@github.com:geekjourneyx/video-post.git
cd video-post

这个 skill 是脚本型仓库，不需要额外 build。

快速开始

从 HTML 导出母版

bun scripts/render-master.ts Libai-Theatre-60s.html --duration=60 --width=1080 --height=1920

从母版派生 60fps 和 GIF

bun scripts/convert-variants.ts Libai-Theatre-60s-master.mp4 --gif-width=360 --gif-fps=8

给母版换一首背景音乐

bun scripts/mix-audio.ts \
  Libai-Theatre-60s-master.mp4 \
  musics/Bronze_Bell_at_Dawn.mp3 \
  Libai-Theatre-60s-music-Bronze_Bell_at_Dawn.mp4 \
  --strategy=middle \
  --volume=0.85 \
  --fade-in=0.5 \
  --fade-out=1.5

批量生成音乐版本

bun scripts/batch-mix.ts \
  Libai-Theatre-60s-master.mp4 \
  musics2 \
  --output-dir=video-post-workspace/batch

校验输出结果

bun scripts/probe-output.ts \
  video-post-workspace/batch/*.mp4 \
  > video-post-workspace/probe-results.json

bun scripts/summarize-outputs.ts \
  video-post-workspace/probe-results.json

项目结构

video-post/
├── README.md
├── SKILL.md
├── skill.yaml
├── assets/
├── evals/
├── references/
└── scripts/

许可证

MIT — 允许自由使用、修改和分发。

关于作者