全角色动态立绘remake+战斗小人

全角色动态立绘remake+战斗小人

## 一、立绘（自动识别）

直接把视频或图片扔到对应文件夹里，不需要配置文件。Mod 自动识别：视频优先于图片。

主角：放到 Profiles/Player/ 下
固定NPC：在 Profiles/Fixed/ 下建文件夹（如 003_魏.胥华），把视频放进去
随机立绘：放到 Random/Male/ 或 Female/ 的子文件夹

如需微调，可创建 profile.json 设置 renderMode（skeleton/static/sheet/video）、循环、播放速度等。

---

## 二、视频制作

推荐格式：WebM（VP9 编码 + alpha 透明通道）
也支持 MP4，但 MP4 不支持透明
分辨率建议 512 到 1024，帧率 24-30

三种制作方式：

1. 从 PNG 序列帧生成 webm：用 ffmpeg 把透明 PNG 序列编码为 VP9 + yuva420p
2. 从视频加 alpha 遮罩合成：用 ffmpeg 的 alphamerge 滤镜合并 RGB 视频和灰度遮罩
3. 用 BiRefNet AI 抠背景后合成：先用 BiRefNet 生成遮罩序列帧，再用 ffmpeg 合成

具体命令见项目内的脚本文件或咨询 Claude。

---

## 三、BiRefNet 背景去除

BiRefNet 是 AI 背景去除模型，可以从视频或图片中自动抠出人物。

安装：通过 pip 安装 transformers、torch、torchvision、pillow

使用步骤：
1. 加载模型 ZhengPeng7/BiRefNet（首次下载约 1GB）
2. 对输入图片做 1024x1024 预处理
3. 模型推理得到前景 mask
4. 用 mask 作为 alpha 通道合成 RGBA 图片

批量视频帧处理：先用 ffmpeg 拆帧，逐帧跑 BiRefNet 生成 alpha 遮罩，再用 ffmpeg 合成 webm。

提示：显存不够可用 CPU 模式，边缘毛刺可对 mask 加高斯模糊。

---

## 四、战斗小人（需要 sheet tool）

战斗小人不是自动识别的，需要手动编辑 atlas。

流程：
1. 打开 parts_export/parts_sheet.png
2. 在每个格子里画对应部位，保持格子位置大小不变
3. 双击 apply.bat 写回
4. 重新进入战斗查看

部件表说明：
- face/hair/hair_back — 脸/头发/后发（后发需 mod 激活）
- upper/lower — 上衣/下装（lower 透明区域决定开叉）
- L/R_arm_up/lo — 手臂
- L/R_hand — 手
- L/R_thigh/calf/foot — 腿
- cape/ribbon/shoulder — 披风/飘带/肩甲（需 mod 激活 slot）

重新导出原版部件表：在 parts_export 目录运行 _sheet_tool.py export 命令