# 待修复清单

> 攒够若干条后**一次性**修（改脚本 → 清日志 → 在批次间隔期重启），避免反复打断批次。

## ✅ 镜15 — 水囊变成了现代塑料瓶（已修复 05:32）

**问题**：分镜是「紫衣少女把水囊递给少年」，提示词也写的是「水囊」，
但模型生成了一个**透明塑料矿泉水瓶**——明显的现代元素，与古装仙侠题材冲突。
（STYLE 里虽有「不要现代元素」，但无效。）

**修法**：把「水囊」改为更具体的古代器物描述，例如
「**牛皮水囊（皮质水袋，带木塞与皮绳）**」，并去掉可能诱发瓶状物的措辞。

**状态**：✅ 已修 —— 改为「牛皮水囊（皮质水袋，袋口带木塞、系着皮绳）」，重跑后水囊正确、塑料瓶消失

---

# 已解决

## ✅ 镜03 拼贴/浮脸 → 侧面跟拍（5 轮修复）
## ✅ 镜08 乱码汉字 → 合成时从 1.2s 起截取（无文字段）
## ✅ 镜12/S13 三人镜拼贴/角色丢失 → 修 scene 注入 bug + 场景图优先 + 显式人物定位
## ✅ `build_prompt` scene 参数注入 25~60 条虚假 Picture 声明（代码级修复，影响全部镜）
## ✅ `cleanup_after_run` 误改为「不处理」导致频繁整机硬挂 → 改回「卸载模型」


## ✅ 镜19 — 狐妖女镜头里林月如喧宾夺主（已修复 06:03）

**问题**：分镜设定是「狐妖女在粉红妖火中现身」，动作设计里**只描述了狐妖女**，
但我在 `SHOTS['S19']` 的角色列表里**错误地把 `'L'`（林月如）也放了进去**。
结果：第 1 秒是林月如的正面"定妆"像，第 2 帧狐妖女被她挡住，直到第 3 帧才给到狐妖女特写。

**根因**：`chars` 列表里的角色会被当作 `<Subject>` 传图和声明，模型就会让他们出镜。
**镜头里不该出现的人，绝不能放进 chars**。

**修法**：把 `SHOTS['S19']` 的角色列表清空（`[]`），只保留场景/敌人参考图。

**状态**：✅ 已修 —— 清空 chars 并把狐妖女外形写进动作设计，重跑后狐妖女独占画面（白狐耳/九条白尾/赤红长袍/眉心红纹/粉红妖火），林月如消失

---

## 📝 镜17 — 轻微涉水感 📝

莲池畔的镜头里，模型让林月如"站在莲叶之间"，有轻微涉水感。
与之前关键帧的同类问题一致，但不严重、且用户已提醒过**不要过度加约束**，暂不改。


---

## ✅ 镜24 — 画面上方出现参考图的「背面 / BACK」标注文字（已修复 11:45）

**问题**：S24（转身走离）我在第 15 轮给它配了**背面参考图**（从三视图裁的），
但那次裁剪**把设定图上的「背面 / BACK」标签一起裁了进去**。
结果生成的第 2、3 帧**画面上方出现了「背面 / BACK」文字**——模型照抄了参考图的标注。

**根因**：角色设定图（三视图）每个视角上方都有「正面/侧面/背面」的中英文标签，
裁切时必须把标签区域一起裁掉。

**修法**：把背面图与侧面图**各裁掉顶部 8%**（标签区），替换参考图文件，S24 重跑。
（S03 用的是侧面图，虽然也带标签，但实测输出未出现文字，故不重跑。）

**状态**：✅ 已修 —— 参考图裁掉顶部 8% 后重跑，标签完全消失


---

## 📝 镜25 — 塔壁符文是乱码汉字（观察，暂不改）

S25（三人入塔）中，石壁与柱上的**发光符文是乱码汉字**（如「金制天司当奉月」等无意义组合），
与 S08 的告示乱码同源。

**为何不改**：
1. 「符文与锁链」是锁妖塔的核心视觉特征，从提示词里去掉会损失场景辨识度；
2. 按 S08 的经验，只要提示词里出现「符文/符咒」，模型必然生成文字，改措辞没用；
3. 镜头仅 3.5 秒且镜头持续上摇，符文是背景纹理而非可读标识；
4. 发光符咒中的伪文字在仙侠题材里属可接受的表现手法。

**若后续要改**：可在合成时对该区域做轻微模糊，或用 ffmpeg 叠加真实的道教符咒纹样。


---

## 🔧 待改进：`wait_and_fetch` 的 40 分钟等待上限偏小（2026-09-29 11:55 发现）

**现象**：S24 重跑耗时超过 40 分钟，超出 `mv_aicg3d.py` 里 `wait_and_fetch(pid, timeout_min=40)` 的上限，
批次把它记成 `FAIL 1files`，**只下载了 Pass1，Pass2 留在 GPU 上没拿回来**。

**影响**：若有镜头生成超过 40 分钟，会漏下载 Pass2，且日志误标 FAIL（下次重启会重复跑一遍）。

**修法**：下次改脚本时把 `timeout_min` 从 40 提到 **90**。

**临时处置**：已手动补下 S24_Pass2 并修正运行日志。

**状态**：📝 待改（不影响当前批次，因为脚本已在运行中）


---

## ✅ 镜34 — 「珠钗」被画成了金色法杖（已修复 17:31）

**问题**：分镜是「断裂剑柱与砖石之间，**一支珠钗**落在碎石上，反着一点冷光；微距特写」，
提示词也写的是「一支珠钗落在碎石上」。

但模型生成的是**一支金色华丽法杖/权杖**（蓝宝石杖头 + 金色流苏），
既不是发钗，体量也完全不对（看起来像大型法器而非小首饰）。

**为何要改**：
1. 这是全片重要的**情感道具**——她的私人信物落在废墟里，象征她本人被留在废墟中；
   画成法器后这层意义完全丢失；
2. 与 S39 的**天蛇杖**视觉上高度相似，观众容易混淆（S39 才是真正的法杖）。

**修法**：把「珠钗」写得更具体——例如
「**一支银质发钗（蝴蝶形钗头、缀有小珍珠与红色流苏，长约一指）静静躺在碎石缝里**」，
并强调**尺寸很小、贴着地面**，避免模型放大成法器。

**状态**：✅ 已修 —— 改为「银质发钗（蝴蝶形钗头、缀小珍珠与红色流苏，长约一指）」并强调尺寸很小，重跑后为银质蝴蝶发钗、贴地躺在碎石上
