用途:为一批视频交付物命名,使每个文件名说明文件究竟是什么——主体、变体轴与处理方式,目标是接收方无需逐个打开即可挑对文件。
命名规则:文件名携带批次内所有变化轴,并含稳定排序键。批次内恒定的信息放进文件夹名,不重复到每个文件名。模板:<index>-<subject>-<descriptor>-<treatment>.<ext>。index 补零且置于最前,使磁盘顺序与评审顺序(画布卡、镜头表、剪辑顺序)一致;subject 是主题或产品;descriptor 区分近似文件的轴(风格、格式、角度、take);treatment 表示做过什么处理,如 body-edited/body-unedited、captioned/clean、9x16/1x1、draft/approved。歧义词应写全,例如用 -body-unedited 而非 -unedited,避免误读。
核验事实:上游标签只是证据而非事实,剪辑表、客户表格、上轮会话的 JSON 都可能误标。核验顺序:查源头(生成广告的提示词面板含提示词与参考图缩略图)、查产物本身(抽帧;注意特写会裁掉商标、画中画会遮挡)、交叉核对转录文本。改了继承来的错误标签,要在交接中明确说明。
Slug 规则:小写、连字符分隔、ASCII,不含空格、撇号、&、括号;索引补零使字典序与数值序一致;优先用人类会说的名称而非内部代号;同一产品在不同批次保持同一 slug 以便后续检索;不要过度堆砌,需要四个 descriptor 时可能应拆成两批。
映射存为数据:将逐项事实放在批次旁的小 JSON 中,而不是写进改名脚本;批次常被重贴标签,数据映射便于一行修改并重跑,同时注明事实来源。
安全改名:脚本 scripts/rename_batch.py 默认试运行,幂等,拒绝覆盖或冲突,若源文件缺失、目标与其他文件冲突、模板无法生成唯一名则整体拒绝执行。命令:python3 scripts/rename_batch.py --dir variants/ --map subjects.json --pattern "hook-{index:02d}-{subject}-{style}-body-{treatment}" --set treatment=unedited --manifest variants.json;确认后加 --apply 提交。改名前后需注意四点:始终先试运行并阅读输出;更新构建清单,否则后续工具找不到文件;若已发布评审画布需重新发布并在卡片上打印文件名;不要重命名已交付给他人并已下载的文件,应作为新副本提供或明确告知改名。
常用模式:hook 变体 hook-NN-<product>-<style>-body-<edited|unedited>;同一剪辑的多种比例 <project>-<ratio>(如 acme-9x16);修订轮次保留名称并递增版本段,绝不覆盖已交付文件;静帧/抽帧评审 <project>-<timecode>(如 arcads-0m17s2)。新批次不适用时,先确定轴并写入交接再改名。
相关技能:hook-variations(产出该批次)、video-review-canvas(名称需与卡片匹配)。平台、收费与授权信息暂未提供。