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

@@ -0,0 +1,36 @@
+#!/usr/bin/env python3
+"""确定性提取视频首帧与实际尾帧。"""
+
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+
+def extract_edge_frame(video: str | Path, output: str | Path, edge: str) -> None:
+    source = Path(video).expanduser().resolve()
+    target = Path(output).expanduser().resolve()
+    if not source.is_file():
+        raise FileNotFoundError(f"视频不存在：{source}")
+    if edge not in {"head", "tail"}:
+        raise ValueError("edge 必须是 head 或 tail")
+    target.parent.mkdir(parents=True, exist_ok=True)
+    command = ["ffmpeg", "-hide_banner", "-loglevel", "error", "-y"]
+    if edge == "tail":
+        command.extend(["-sseof", "-3", "-i", str(source), "-update", "1"])
+    else:
+        command.extend(["-i", str(source), "-frames:v", "1"])
+    command.append(str(target))
+    completed = subprocess.run(command, capture_output=True, text=True)
+    if completed.returncode != 0 or not target.is_file() or target.stat().st_size == 0:
+        raise RuntimeError(
+            f"无法提取视频{edge}帧：{completed.stderr.strip() or source}"
+        )
+
+
+def extract_first_frame(video: str | Path, output: str | Path) -> None:
+    extract_edge_frame(video, output, "head")
+
+
+def extract_last_frame(video: str | Path, output: str | Path) -> None:
+    extract_edge_frame(video, output, "tail")