0 Fork 0

Files

T

admin 237a09a5b0 修：draw-ui / oil-motion 原被当子模块指针收录 ⇒ 改为正常文件入库（两份内容原先对别人是空的）

一、问题（本轮实测）
`draw-ui` 与 `oil-motion` 目录里**各自带一个内嵌 `.git`** ⇒ 上一次提交把它们记成了 **gitlink（子模块指针）**
⇒ 仓库里只存了一个不属于任何远端的 commit id，**别人克隆下来这两份是空的** ✗（`git status` 显示 ` m draw-ui` / ` m oil-motion` ＝ 子模块内容有改动）。

二、处置（可回退）
· 把两处的 `.git` **挪走**（⛔ 不是删除）⇒ `归档/内嵌git-20261008/{draw-ui,oil-motion}.git`；
· `git rm --cached` 掉那两个 gitlink，再 `git add` 两个目录 ⇒ **按正常文件入库**（内容才真的进仓库）。

三、副作用（如实记）
挪走 `.git` 后，这两个技能**不能再原地 `git pull` 取上游更新**（要更新得重新拉一份覆盖）；
如需恢复其本地仓库，把 `归档/内嵌git-20261008/` 里的 `.git` 挪回原处即可。

2026-10-08 22:29:52 +08:00

4.3 KiB

Raw Blame History

透明图集路线

仅当 Concept Contract 锁定 background_owner: page（主体确有透明复用需求），且 motion_budget.py 返回 delivery.selected=alpha-atlas 时执行本流程。结果不是 alpha-atlas 时停止阅读，改走 chroma-video.md 或 baked-video.md。

本文档只覆盖图集路线专属的帧提取、清理、检测与打包。公共步骤各有唯一事实源：

预算与路线选择：delivery-selection.md
关键帧、提示词与提交命令：prompting.md
帧策略与图集压缩：optimization.md
母版验收、抠图验收、Pilot 与帧链硬门：qa.md
运行时映射：runtime.md

交付物

motion-name/
├── source/
│   ├── first-frame.png
│   ├── last-frame.png            # 单向转场需要
│   ├── prompt.txt
│   ├── master.mp4
│   └── master.job.json
├── frames/
│   ├── raw/
│   ├── clean/                    # 闭环或尾部清理后
│   └── final/
├── qa/
│   ├── raw-analysis.json
│   ├── raw-contact.jpg
│   ├── final-analysis.json
│   └── final-contact.jpg
└── final/
    ├── motion.webp
    ├── motion.json
    └── implementation.*

1. 帧准备与离线抠色

母版通过 qa.md 的母版验收后再提取帧。色键在这一步离线去除，网页只加载已经透明的图集。

frame_policy=native 时按源帧提取，--key auto 从画面边缘采样实际背景色：

python3 "$OIL_MOTION/scripts/motion_pipeline.py" extract \
  source/master.mp4 frames/raw \
  --key auto

python3 "$OIL_MOTION/scripts/motion_pipeline.py" analyze frames/raw \
  --output qa/raw-analysis.json

python3 "$OIL_MOTION/scripts/motion_pipeline.py" contact frames/raw \
  --output qa/raw-contact.jpg \
  --columns 8

frame_policy=interpolate 时改用 optimization.md 的插帧命令，它同时输出原始与插帧的接触表和对比报告。

在白、黑和真实页面背景上查看接触表：残留色键、主体内部被误删或边缘溢色时，回到母版或关键帧返工，不靠调阈值掩盖。

2. 闭环清理与可选稳定

闭环动画：

python3 "$OIL_MOTION/scripts/loop_cleanup.py" \
  frames/raw frames/clean \
  --seam-window "$SEAM_WINDOW" \
  --duplicate-threshold "$DUPLICATE_THRESHOLD" \
  --report qa/loop-cleanup.json

该工具只做确定性选帧，不生成动作，也不对相邻帧做透明叠加。接缝选错时调整 --seam-window，不要为了减少帧数盲目提高重复阈值。首尾不同的单向转场传入 --end-reference last-frame.png，裁掉模型在尾帧上的多余停顿。

固定主体存在轻微漂移时才稳定：

python3 "$OIL_MOTION/scripts/motion_pipeline.py" normalize \
  frames/clean frames/final \
  --anchor bottom \
  --max-scale-change 0.08

不需要清理或稳定的步骤直接跳过，把上一步合格的帧作为 frames/final。自由运动、镜头运动和真实透视变化禁止稳定。

3. 最终门槛与图集打包

python3 "$OIL_MOTION/scripts/motion_pipeline.py" analyze frames/final \
  --output qa/final-analysis.json

python3 "$OIL_MOTION/scripts/motion_pipeline.py" contact frames/final \
  --output qa/final-contact.jpg \
  --columns 8

python3 "$OIL_MOTION/scripts/motion_pipeline.py" atlas frames/final \
  --output final/motion.webp \
  --manifest final/motion.json \
  --cell-width 360 \
  --cell-height 360 \
  --quality 88

打包前用最终帧数和单元格尺寸重新运行 delivery-selection.md 的预算。只有仍返回 alpha-atlas 且通过时才打包；结果变成 chroma-video 时停止打包，改走视频路线。需要压到目标体积时按 optimization.md 执行，不要手动反复猜 WebP 质量。

4. 网页实现

从 assets/interactive-motion.ts 的对应控制器开始，映射、阻尼、预加载和降级按 runtime.md 执行，验收和故障定位按 qa.md 执行。出现闪帧时按“母版 → 帧 → 图集 → 映射 → 解码”的顺序定位。

4.3 KiB Raw Blame History