明日方舟小人进度条生成器

选一个 prts.wiki 导出的小人动画（WebM），一键生成一个带透明的进度条 .mov， 拖进视频剪辑软件里就能用。视频从头放到尾时，小人从画面左下角走到右下角， 配合循环行走动画直观表示进度。

---

三步使用

1. 在 prts.wiki 打开角色页 → 基建/战斗动画 → 导出 WebM （普通版或带透明通道均可，见下方「透明与黑边」说明）。
2. 打开本工具，按四步走：
   • ① 选 WebM：浏览选择你导出的动画文件。
   • ② 目标视频参数：填你要叠加的视频的 宽×高、帧率、时长（如 1920×1080、30fps、10 秒）。
   • ③ 角色大小/位置：调「角色高度」「底边距」；默认勾选 「自动裁剪留白」 （让小人从最左走到最右）。
   • ④ 生成进度条 mov：点按钮，等 ffmpeg 合成完成。
3. 在视频编辑软件里把生成的 *_progressbar.mov 拖到上层视频轨道（如 V2）， 底部对齐即可。

---

透明与黑边（已自动处理）

有些提供的 WebM 其实是不透明的（黑底）。工具会自动处理：

• 抠除黑色背景：把小人身后的黑底变成真正透明，不会再有「黑色正方形底」。
• 自动裁剪留白：去掉小人四周的空白边，让小人能稳稳地从画面最左走到最右。

如果你导出的是带透明通道的 WebM，工具会直接保留其透明、不再抠黑底 （避免误伤小人身上的暗部细节）。个别情况下透明源仍带黑边，可在 ③ 里勾选 「强制抠除黑色背景」。

---

环境准备

• ffmpeg（必需，但无需你操心）：软件启动时会自动检测系统里的 ffmpeg （PATH 或常见安装目录）；若没装，在 GUI 里点一下「下载并安装 ffmpeg」即可从 gyan.dev 自动下载到本机缓存目录（约几十 MB，无需管理员权限），之后自动使用。 也可以手动「浏览」指定已有的 ffmpeg.exe。

• PySide6（运行 GUI）：

  python -m venv .venv
  .venv\Scripts\python.exe -m pip install -r src/gui/requirements.txt
  .venv\Scripts\python.exe src/gui/main.py
  

PowerShell 5.1 不支持 &&，请像上面一样分行执行。

---

项目链接

• 源码仓库： https://code.rikki.ltd/Booker786/ArknightsProgressBarPlugin
• 作者主页： https://space.bilibili.com/113589678

欢迎在仓库提交 Issue 或 PR；软件内「帮助 → 关于」也包含这些链接与 GPLv3 许可声明。

---

版权

• 本仓库代码以 GPLv3 开源。
• 模型 / 动画版权归上海鹰角网络（Hypergryph）所有，属非商用同人素材。 本仓库不打包、不分发任何模型或动画文件，仅使用你从 prts.wiki 自行导出的文件。