DramaClaw 类流水线跑到一半返工，原因多半不在模型或渲染，而在开跑前没人把输入规则固定下来：素材名各写各的，分镜表各人一套列，等到程序按场次和镜头号去匹配时对不上，只能停线重排。建议在第一批素材进流水线之前，先把“哪些字段会被读取”和“分镜表写哪几列”这两件事定完；规则一旦确定，后续批次沿用同一套规则，不因个人习惯临时改动。
素材命名和分镜表格式本质上是流水线的输入约定。适用场景：多人协作、素材跨批次累积的短剧项目。操作动作：先按环节列出程序会读取的字段，再定唯一命名模板和分镜表固定列。验证方式：拿一批历史素材按新规则整理后试跑，看哪些位置仍需人工对位。边界：规则只覆盖文件名与表列层面，编码参数、帧率一致性、素材内容正确性仍要单独核对。
列出流水线各环节真正会读取的素材字段
不要凭印象列字段，从环节倒推：哪个步骤会打开文件名或读取分镜表，那一步用到的字段才必须写进规则。按常见流程可以这样梳理，具体环节以自己项目的流水线配置为准。
| 环节 | 读取字段 | 用途 | 人工可读 / 机器匹配 |
|---|---|---|---|
| 分镜准备 | 场次、镜头号 | 把分镜行和拍摄计划对齐 | 两者都需要 |
| 素材入库 | 场次、镜头号、版本 | 同镜头多版本去重、选定当前版 | 机器匹配为主 |
| 剪辑合成 | 完整文件名、帧率 | 按时间线取素材、避免混帧率拼接 | 机器匹配 |
| 审片交付 | 场次、镜头号、版本 | 定位返修点、回传修改意见 | 人工可读 |
结论是：场次、镜头号、版本这三项必须同时满足机器可解析和人工一眼可读；帧率属于机器侧参数，写进文件名是为了合成时不必再逐个探测文件。集数、拍摄日期、摄影师之类的信息，如果流水线不读取，就不要塞进文件名主干，放进分镜表或目录层级更稳妥。
定一套文件命名规则并给出正反示例
模板只保留上一步列出的必需字段，顺序一次性定死，之后不再按个人习惯调整。下面是一个可以直接用的骨架，字段位宽和分隔符可以替换，但分隔符一旦选定就全项目统一。
EP{集数2位}_SC{场次3位}_SH{镜头2位}_V{版本2位}_{帧率}fps.mp4
示例：EP01_SC012_SH03_V02_25fps.mp4允许字符建议限定为：大写字母、数字、下划线、连字符、句点。空格、中文括号、全角字符、中文顿号一律不进文件名，因为这些字符在不同系统、不同解压工具、不同同步盘之间最容易出现编码差异，机器匹配时就会变成两个不同的名字。
常见错误写法及问题：
EP01 第12场 镜头3.mp4：含空格和中文，版本信息缺失，程序无法判断取哪一版。EP01_SC012_SH03（改）.mp4：中文括号被某些工具转义或截断，匹配失败。EP01_SC012_SH03_最终版_真的最终_改2.mp4：多重版本后缀，没有可解析的版本号，排序结果不可信。EP01_SC012_SH03_V2_25fps.mp4：版本位宽不统一，V2 与 V02 会排成两条不同记录。
正确写法统一为 EP01_SC012_SH03_V02_25fps.mp4：位宽固定、字段顺序固定、版本号单调递增，重命名时只需改 V 段。
分镜表要固定哪几列
分镜表是素材和成片之间的索引，列少但每列必须有约束，否则填的人各自发挥，等于没定。
| 列名 | 填写约束 |
|---|---|
| 场次 | 纯数字，与文件名 SC 段逐位一致；不要在单元格里写“第12场” |
| 镜头号 | 纯数字，两位补零；一个场次内不重复 |
| 时长 | 单位为秒，保留一位小数，与素材实际时长取自同一处，不手抄估算值 |
| 素材文件名 | 与磁盘文件名逐字符一致，包含扩展名；未拍摄时留空而不是写“暂无” |
| 状态 | 只能从固定枚举里选，例如 待拍 / 已拍 / 已入库 / 已合成 / 待返修，不自造词 |
建议把这五列做成表头锁定、状态列改成下拉选项的表单，输入时就从源头减少自由文本。需要补充备注时另开一列“备注”，不要让备注污染素材文件名列。
用表格筛选找出不合规的旧素材
旧素材不必写脚本，先用表格本身的功能做一轮筛查，成本更低，也方便和剪辑、制片一起核对。
- 把素材目录的文件列表导出成表格，至少包含文件名一列；导出方式按所用文件管理器或表格工具的“获取文件列表”功能操作。
- 加一列“是否合规”，用条件判断字段位宽和分隔符，例如判断文件名是否以
EP开头、是否包含_SC与_SH、扩展名是否为预期格式。 - 按“是否合规”做条件筛选，把不合规的行单独留下，再按文件名排序，同一镜头的乱序版本会排在一起，容易看出是命名不一致还是真的缺版本。
- 对能确定的问题用查找替换批量修正，例如把全角括号统一成下划线、把
_V1_统一成_V01_；涉及版本号变更的不要用替换，逐条确认后再改。 - 重命名前先整目录复制一份到备份位置，或先打包成压缩文件留存；确认流水线跑通、审片无误后再删备份。
这一轮筛完通常会剩下少量难以自动判断的文件，例如同一镜头存在多个内容不同的版本。这类不要强行合并，先在分镜表里标出状态，交由人工确认保留哪一版，避免清理动作本身制造新的对不上。
拿一批旧素材试跑看是否还返工
规则定完不要直接推全量，先挑一批有代表性的历史素材：包含多版本镜头、包含跨场次素材、包含曾出现命名冲突的那几条。按新命名规则和新的分镜表列整理后，完整跑一遍流水线，重点观察三件事。
- 哪些环节仍在提示找不到素材：通常是文件名里的场次、镜头号与分镜表某一侧位数不一致。
- 哪些位置需要人工重新指认：说明该字段实际上被读取，但规则里没有强制约束。
- 哪些列填了却从未被读取：可以考虑从固定列里移出，降低填写负担。
把这三类问题逐条记录下来，回到命名模板和分镜表列定义上做小步修订，再换一批素材复跑。修订只改规则文本和表单约束，避免在流程中途临时改文件名导致已验证的批次失效。规则稳定后再推广到全量素材，返工才会集中出现在规则评审阶段，而不是跑到一半才发现。