修：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` 挪回原处即可。

oil-motion/references/alpha-atlas.md

@@ -0,0 +1,118 @@
+# 透明图集路线
+
+仅当 Concept Contract 锁定 `background_owner: page`（主体确有透明复用需求），且
+`motion_budget.py` 返回 `delivery.selected=alpha-atlas` 时执行本流程。结果不是
+`alpha-atlas` 时停止阅读，改走 [chroma-video.md](chroma-video.md) 或
+[baked-video.md](baked-video.md)。
+
+本文档只覆盖图集路线专属的帧提取、清理、检测与打包。公共步骤各有唯一事实源：
+
+- 预算与路线选择：[delivery-selection.md](delivery-selection.md)
+- 关键帧、提示词与提交命令：[prompting.md](prompting.md)
+- 帧策略与图集压缩：[optimization.md](optimization.md)
+- 母版验收、抠图验收、Pilot 与帧链硬门：[qa.md](qa.md)
+- 运行时映射：[runtime.md](runtime.md)
+
+## 交付物
+
+```text
+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](qa.md) 的母版验收后再提取帧。色键在这一步离线去除，网页只加载已经透明的图集。
+
+`frame_policy=native` 时按源帧提取，`--key auto` 从画面边缘采样实际背景色：
+
+```bash
+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](optimization.md) 的插帧命令，它同时输出原始与插帧的接触表和对比报告。
+
+在白、黑和真实页面背景上查看接触表：残留色键、主体内部被误删或边缘溢色时，回到母版或关键帧返工，不靠调阈值掩盖。
+
+## 2. 闭环清理与可选稳定
+
+闭环动画：
+
+```bash
+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`，裁掉模型在尾帧上的多余停顿。
+
+固定主体存在轻微漂移时才稳定：
+
+```bash
+python3 "$OIL_MOTION/scripts/motion_pipeline.py" normalize \
+  frames/clean frames/final \
+  --anchor bottom \
+  --max-scale-change 0.08
+```
+
+不需要清理或稳定的步骤直接跳过，把上一步合格的帧作为 `frames/final`。自由运动、镜头运动和真实透视变化禁止稳定。
+
+## 3. 最终门槛与图集打包
+
+```bash
+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](delivery-selection.md)
+的预算。只有仍返回 `alpha-atlas` 且通过时才打包；结果变成 `chroma-video` 时停止打包，
+改走视频路线。需要压到目标体积时按 [optimization.md](optimization.md) 执行，不要手动
+反复猜 WebP 质量。
+
+## 4. 网页实现
+
+从 [assets/interactive-motion.ts](../assets/interactive-motion.ts) 的对应控制器开始，
+映射、阻尼、预加载和降级按 [runtime.md](runtime.md) 执行，验收和故障定位按
+[qa.md](qa.md) 执行。出现闪帧时按“母版 → 帧 → 图集 → 映射 → 解码”的顺序定位。