素材越生成越乱，通常不是 LibTV Agent 生成质量的问题，而是提示词和成片之间缺一个共同主键。建议把镜头编号当作这个主键：先定编号规则，再让提示词文件、视频片段文件名、剪辑时间线里的片段名都带上同一个编号。检验做没做成只有一个标准——在时间线上随手点一个片段，半分钟内能翻到它的提示词原文和全部历史版本；做不到，说明归档链路在某一环断了。

适用场景：用 LibTV Agent 批量生成分镜片段、后期要反复重生成或补拍的短片项目。操作动作是先固定镜头编号格式，再建 prompts 与素材两个平行目录，最后用一张版本表记录采用状态。验证方式是任取一个时间线片段反查提示词文件。风险边界：编号一旦进了剪辑时间线就不要再改，改编号等于断引用；模型、时长、比例这些易变信息写进提示词文件，不要塞进编号里，否则编号会随参数变化而膨胀。

在 LibTV Agent 项目里给每个镜头分配唯一编号

编号的最小任务是让一句话能被唯一指向。建议用「集-场-镜」三段结构，段数与位数都固定下来：

S01-C03-SH02
│   │   └── 镜头序号，两位补零
│   └────── 场次序号，两位补零
└────────── 集或期号

配套约束有四条，容易踩坑的是第二条和第三条：

• 只用大写字母、数字和短横线，不放中文、空格、括号，避免跨系统同步时被自动改名。
• 序号固定两位补零，写 SH02 而不是 SH2。否则按文件名排序时 SH10 会排到 SH2 前面，素材库顺序就乱了。
• 一个镜头需要拆条时追加 -CUT01，不要用 _1、(2)、副本 这类后缀，它们在不同系统里的排序行为不一致。
• 重生成不改编号。编号只回答「这是哪个镜头」，不回答「这是第几版」，版本交给后面的后缀和版本表。

编号和场次镜头的映射关系建议维护在分镜表里：分镜表新增一列「镜头编号」，每一行对应一个镜头，这一行的描述写进对应的提示词文件，这一行产出的视频存进对应素材文件夹。场次调整时只改中间的场次段，前后两段的语义保持不变，已经剪进时间线的旧片段就不会失联。

把提示词存进镜头编号对应的文本文件

LibTV Agent 对话里的提示词会被后续对话冲掉，翻聊天记录找第三版描述是很耗时的动作。建议每确定一个镜头，就落一个同名文件，目录和编号层级保持一致：

prompts/
  S01/
    C03/
      SH02.md

文件命名规则就是镜头编号本身加扩展名，不加日期、不加中文标题、不加作者名——这些都属于文件内容，不属于文件名，混进文件名会让检索变得不可预测。文件内的字段建议固定成下面这一组，字段名写死，值可以留空：

编号: S01-C03-SH02
场次: 第X集 第X场 场景名 日/夜
时长: 5s
比例: 16:9
提示词: 主体 + 动作 + 环境 + 镜头运动 + 光线
负面: 文字、水印、多余手指
参数: 模型、采样、随机种子，具体值以本机 LibTV Agent 配置为准
修改日期: YYYY-MM-DD

修改日期只写到天，每次改动提示词就更新这一行，同时把旧描述整段挪到文件末尾一个「历史描述」小节里，不要直接删除。模型名称、采样参数这些字段在不同环境里差异较大，写法以你实际使用的配置面板为准，不要照抄别人的值。

生成后按编号把视频片段拖入素材库

素材目录建议和提示词目录同构，这样从编号到路径的换算不需要查表：

media/
  S01/
    C03/
      SH02/
        S01-C03-SH02_v01.mp4
        S01-C03-SH02_v02.mp4

片段命名保持「编号 + 版本后缀」两段，版本用 _v01、_v02 两位递增，不覆盖旧文件。不要用 final、最终版、new、改好 这类词，它们靠人的记忆维持含义，多人协作时基本会失效；哪个版本被采用，交给下一节的版本表来回答，文件名只负责可排序、可检索。

验证方式很直接：在文件管理器里按名称排序，同一个镜头的所有版本应当相邻出现；用系统搜索搜 S01-C03-SH02，应当一次列出全部版本和对应的提示词文件。如果搜不全，多半是某个文件被手动改名或存到了别的场次目录下。

用表格记录每个片段的版本和采用状态

版本表建议每个项目一份，放在项目根目录，列固定为五项，不多不少：

「采用」列建议只允许三种值：Y、N、待定，且同一编号下最多一个 Y。如果某个编号冒出两个 Y，说明时间线里存在两份不同版本的同一镜头，需要回到剪辑里确认删掉哪一份。「备注」列写的是不采用的具体理由，比如手部变形、口型对不上、运镜方向反了，这些理由下次重写提示词时直接可用，比只记一句不满意有价值得多。

剪辑时按编号回查提示词

回查路径取决于时间线片段有没有保留源文件名。如果剪辑软件里片段名跟着素材走，直接看片段名就能读到编号；如果被改成了片段 12 这类默认名，先去素材箱定位源文件，再从源文件名取回编号。

拿到编号后两条路径：一是按目录层级打开 prompts/S01/C03/SH02.md，二是在项目根目录用命令行批量反查：

# 按编号找提示词文件
grep -rl "S01-C03-SH02" ./prompts

# 只记得画面内容、忘了编号时反查
grep -ril "雨夜 天台" ./prompts

补拍或重生成时，先从提示词文件里复制原描述，只改需要调整的那一句，存成新版本 v03，同步在版本表加一行并把旧的采用状态改为 N，再把新片段拖进素材库。不建议直接覆盖 v02，因为时间线里已经引用了 v02，覆盖会让旧剪辑点指向一份内容已经不同的文件，排查起来很费劲。