Skip to content

geekjourneyx/video-post

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

video-post

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

video-post banner showing the short-form animation finishing pipeline from master export to validation

License: MIT TypeScript Bun FFmpeg


这是什么

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

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

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

核心特性

Feature overview for video-post including master render, variants, music mixing, batch processing, validation, and clean workflow separation

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


工作流程

Workflow diagram for video-post covering input sorting, master rendering, variant derivation, and delivery validation

推荐顺序是:

  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 [email protected]: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 — 允许自由使用、修改和分发。


关于作者

个人主页 jieni
GitHub geekjourneyx
Twitter @seekjourney
公众号 微信搜 极客杰尼

About

Short-form video finishing skill for turning animation HTML and master MP4 files into delivery-ready variants with Bun and FFmpeg

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors