修：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/scripts/composite_alpha_keyframe.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""Composite a native-transparent keyframe onto a uniform video chroma backdrop."""
+
+from __future__ import annotations
+
+import argparse
+import re
+from pathlib import Path
+
+from PIL import Image
+
+
+def parse_color(value: str) -> tuple[int, int, int, int]:
+    if not re.fullmatch(r"#[0-9a-fA-F]{6}", value):
+        raise SystemExit(f"invalid key color: {value}; expected #RRGGBB")
+    return tuple(int(value[index : index + 2], 16) for index in (1, 3, 5)) + (255,)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("source", help="Accepted native-transparent keyframe PNG")
+    parser.add_argument("output", help="RGB PNG for the video model")
+    parser.add_argument("--key-color", default="#00FF00")
+    args = parser.parse_args()
+
+    source = Path(args.source).expanduser().resolve()
+    output = Path(args.output).expanduser().resolve()
+    if source == output:
+        raise SystemExit("source and output must differ; preserve the native-transparent keyframe")
+
+    with Image.open(source) as opened:
+        if "A" not in opened.getbands():
+            raise SystemExit("source has no alpha channel; regenerate it with native transparency")
+        foreground = opened.convert("RGBA")
+    alpha_min, alpha_max = foreground.getchannel("A").getextrema()
+    if alpha_min > 16 or alpha_max <= 16:
+        raise SystemExit("source must contain both transparent background and visible subject pixels")
+
+    background = Image.new("RGBA", foreground.size, parse_color(args.key_color))
+    background.alpha_composite(foreground)
+    output.parent.mkdir(parents=True, exist_ok=True)
+    background.convert("RGB").save(output)
+    print(output)
+
+
+if __name__ == "__main__":
+    main()