ai-short-drama-studio

---
name: ai-short-drama-studio
version: 2.5.0
description: "AI 短剧与短视频工作室（双形态）：短剧做多集叙事（剧本台→角色与场景台→分镜台→出片台→后期台），短视频做单条 1 分钟内（脚本台→素材台→分镜台→出片台→发布台），一项目一目录、产物驱动进度、改稿按层回流。当用户要制作 AI 短剧、漫剧、动态漫、竖屏微短剧，或有一句话剧情/梗概要快速成片，或要做 60 秒内短视频、口播脚本、钩子与开场 3 秒、发布文案与标签，或提到即梦短剧工作室、Seedance、DreamScript、Anycook、DreamShot、宫格分镜、@素材引用、素材锚点、角色设定卡、画风三层、光影三件套、运镜三参数、多集项目、连续性台账、段缝衔接、转场、视频延长、配音/TTS、人脸审核不过、审核敏感词、否定约束失效、分镜提示词、分镜图、关键帧、三层工艺分离、多人戏调度、场景首现、视觉验收、分镜 JSON 校验、参考视频对标、时长预算、字幕封面参数、调色、完播率时使用；出现人脸漂移、角色跨集不像、画风漂移、运镜执行不出、光与场景不符、角色重复、多余字幕水印、拼接跳帧、口播超时长、上线后数据不好等故障要排障时也用。产出工位化流程、分镜蓝图与排障指引。AI short-drama and short-video studio skill (dual form): multi-episode drama and single-clip short video in one project directory; artifact-driven progress, layered rework backflow, spoken-word duration budget, hook taxonomy, publish package, Seedance storyboard prompts, grid storyboard JSON, @reference assets, camera grammar, art-style layers, character sheets, transitions, dubbing, continuity ledgers, blocking, FACS expressions, action previs, publish diagnostics, troubleshooting."
license: MIT
---

# AI 短剧/短视频工作室（五工位流水线 · Seedance 出片）

把剧本、梗概或一个选题做成可执行的 AI 视频。两种形态共用一套骨架：

- **短剧形态**（默认）：多集叙事，每集一个目录，末工位是后期台
- **短视频形态**：单条 ≤60 秒，整个项目一条，末工位是发布台

工作方式不是「挑一条路线走到底」，而是**一项目一目录，五个工位顺序推进，每工位有产物和门禁，改稿按层回流**。

> **策划层指针**：选题、市场情报、IP 定位、故事架构、节奏地图、剧本创作与多集规划（真人短剧与漫剧共用的红果/抖音投放打法）用 `onlyshot-drama` 技能；本技能负责工作室化制作——剧本落地、资产、分镜、出片与排障。串联方式：onlyshot-drama 产出剧本 / 圣经 / 分镜工程文件 → 本技能进剧本台开工。

## 五工位总览

```
① 剧本台 ──→ ② 角色与场景台 ──→ ③ 分镜台 ──→ ④ 出片台 ──→ ⑤ 后期台
剧本.md        素材/ + 场景板/      分镜JSON+定稿帧    视频段/         成片/
  │                 │                   │                │              │
  └─ 改动回流 ───────┴─── 改动回流 ──────┴── 改动回流 ────┴─ 改动回流 ───┘
     （越靠前的工位改动，下游要重做的越多）
```

| # | 工位 | 对标即梦短剧工作室 | 产物 | 门禁 |
|---|---|---|---|---|
| 1 | 剧本台 | 剧本整理 / DreamScript 生成与结构诊断 | `第X集/剧本.md` | 非模板占位；有钩子与收尾；@引用名已列出 |
| 2 | 角色与场景台 | Anycook 角色与场景资产管理 | `素材/*.png`、`场景板/` | `check_refs.py` 无断链；角色锚点法；场景有 state |
| 3 | 分镜台 | DreamShot 画布与故事板双模式 | `第X集/分镜/` 分镜 JSON + 定稿图 | `validate_storyboard.py` PASS；关键帧定稿；无空词 |
| 4 | 出片台 | 视频生成与定点重拍 | `第X集/分镜/视频段/*.mp4` | `manifest.py verify` 同源；重生率 ≤10% |
| 5 | 后期台 | 人声分离、重新配音、成片 | `第X集/成片/*.mp4` | `qa_batch.py` 接缝量化；视觉验收真看 |

工位进度只认产物不认口头：`python scripts/studio.py status <项目目录>` 扫盘得出，附「当前焦点工位」与「改稿影响提示」。
完整定义、数据契约、回流表、单集推进示例见 `references/studio-workflow.md`。

**选形态**：一次交付一条且总时长 ≤60 秒 → 短视频（`studio.py init <目录> --form short --target 60`，工位名为脚本台/素材台/分镜台/出片台/发布台）；多集、角色延续、集间衔接 → 短剧（默认）。两种目录兼容，短片起手后续扩系列不用搬家。短视频的时长预算、三档节奏、Hook 六分类、发布包见 `references/short-video-studio.md`。

## 触发示例（38 类话术，命中即可直接开工）

| 用户话术示例 | 落点 |
|---|---|
| 「帮我把这个剧本做成漫剧分镜」 | 剧本台 → 分镜台（技法 A） |
| 「只有一段剧情梗概，快速出一条动态漫片段」 | 分镜台（技法 B） |
| 「人物参考图被人脸审核拦了，怎么绕」 | 角色与场景台（技法 C） |
| 「这个项目做到哪一步了，下一步做什么」 | `scripts/studio.py` 的 status 子命令 |
| 「改了一版剧本，哪些镜头要重出」 | 改稿回流表（`references/studio-workflow.md`） |
| 「生成的视频人脸漂了还出现俩主角，怎么修」 | 排障速查 |
| 「视频里冒出了没要过的字幕和水印」 | 排障速查 |
| 「写一条带转场设计的视频提示词，每镜标转场代码」 | 铁律与词库 |
| 「这部短篇小说想做成多集动态漫，从哪开始」 | 工作室初始化 + 多集工作流 |
| 「分镜 JSON 生成好了，帮我检查合不合格」 | `scripts/validate_storyboard.py` |
| 「九张场景图帮我拼成九宫格」 | `scripts/make_grid.py` |
| 「镜头之间怎么衔接才连贯」 | 关键帧接力（铁律） |
| 「人物素材怎么出才不会每镜换脸」 | 素材锚点法（`references/asset-workflow.md`） |
| 「一条视频里想放多个镜头，提示词怎么写」 | 时间轴式写法（铁律） |
| 「每镜先出几张候选图选一张，再出视频，怎么做」 | 分镜图工艺（`references/frame-industrial.md`） |
| 「拟人化建筑/器物当主角，素材总崩怎么防」 | 非人形偏置对策（`references/frame-industrial.md`） |
| 「两个人对话的戏，机位和站位怎么排」 | 多人戏调度（铁律） |
| 「这个场景之前出现过吗，这次还要不要重新交代一遍」 | 场景展示判断（多集工作流） |
| 「场景图怎么写成可复现的提示词，换人也能重出一张」 | 场景板（`references/scene-plates.md`） |
| 「一批镜头混用了两版场景，接缝跳，怎么查」 | `scripts/manifest.py` / `scripts/qa_batch.py` |
| 「多段生成的段间衔接生硬，人物消失又出现」 | 段缝衔接（`references/continuity-log.md`） |
| 「一批分镜生成完了，帮我跑一遍接缝量化、出底账」 | `scripts/qa_batch.py` |
| 「记清楚每段成片是哪版提示词生成的，别混源」 | `scripts/manifest.py` |
| 「接缝检查没问题了，帮我把各段统一裁到 5.00 秒」 | `scripts/trim_clips.py` |
| 「各段都裁好了，帮我把它们拼成一集」 | `scripts/concat_clips.py` |
| 「脚本要改一版，批量替换并核对都改到了哪些处」 | `scripts/gen_script.py` |
| 「人物的表情/眼神戏写不好，表情总崩」 | 面部表演工艺（`references/facs-micro-expression.md`） |
| 「这段打戏/动作戏的镜头怎么设计」 | 打戏预演（`references/action-previs.md`） |
| 「这一集情绪不够燃，开场怎么留人」 | 情绪节拍与开场钩子（`references/emotion-beat-curve.md`） |
| 「提示词写了不要出现 X，结果还是出现」 | 排障速查（否定失效） |
| 「提示词里全是电影感、高级感，想改成能拍出来的描述」 | 词句层（`references/prompt-craft.md`） |
| 「走秀或行走镜头脚打滑、动作没做完、推近变成变焦」 | 词句层与 `scripts/lint_prompt.py` |
| 「照这条爆款视频/链接做一版」（给参考视频） | 对标参考流程 |
| 「写一条 60 秒以内的短视频脚本」 | 短视频形态 → 脚本台 |
| 「这个脚本念完要多少秒/超时长了吗」 | `scripts/short_plan.py` |
| 「前 3 秒钩子怎么写才留人」 | Hook 六分类（`references/short-video-studio.md`） |
| 「短视频拍完还要准备什么才能发」 | 发布台（封面/文案/标签/评论引导） |
| 「一镜多长才不会被模型糊成一团」 | 单镜 1.5s 下限（通用机制） |
| 「配音想用克隆音色/每个角色一个固定声音」 | 声音与配音 → VoiceStudio 自建音色（`references/audio-voice.md` 三、五节 + `scripts/tts_voice.py`） |
| 「运镜写了但生成出来乱动/推镜变成变焦」 | 运镜语法与参数（`references/camera-grammar.md`） |
| 「环绕/推镜转太快没到位，怎么写得准」 | 运镜三参数：起点景别、终点景别、耗时（`references/camera-grammar.md` 一二节） |
| 「想要有压迫感又不土的光，怎么写」 | 情绪化运镜十式 + 光源三件套（`references/camera-grammar.md` 三节、`references/visual-lexicon.md` 四节） |
| 「画风每次生成都不一样/韩漫风出成日漫」 | 画风三层写法：线条、上色、色板（`references/visual-lexicon.md` 一二节） |
| 「国风/赛博朋克这类词怎么翻成能出图的描述」 | 画风词转写对照（`references/visual-lexicon.md` 三节） |
| 「角色设定卡要写哪些字段」 | 设定卡七段（`references/character-design.md` 二节） |
| 「角色跨集越做越不像，怎么查是哪一环错的」 | 跨镜一致性五维审查（`references/character-design.md` 三节） |
| 「成片发出去了，数据不好该改什么」 | 发布后诊断三指标与归因顺序（`references/publish-ops.md` 五六节） |
| 「同一部剧要发抖音快手视频号，剪几个版本」 | 三平台时长与节奏差异（`references/publish-ops.md` 一节） |
| 「字幕字号描边、封面文字有没有标准」 | 平台字幕与封面参数（`references/publish-ops.md` 二节） |
| 「这一集怎么调色」 | 情绪调色起步值（`references/publish-ops.md` 三节） |

## 工位一：剧本台

输入一句话梗概、小说片段或完整剧本，产出可直接排产的分集剧本。

1. 定画幅与模型版本（竖屏 9:16 / 模型 2.0 或 2.5），**开剧一次定、全剧贯通不改**——两版契约不同，中途换版等于全批返工。
2. 切集：每集独立钩子与收尾，落 `第X集/剧本.md`。长剧本分批读时记录实际已读范围，未读部分标「待补」，不凭梗概声称读过全剧。
3. 列出本集 @引用名清单（出场角色、场景、关键道具），交给角色与场景台备资产。
4. 长叙事节奏（红果必爆 7 招、180 秒时间轴、24 集规划）用 `onlyshot-drama`；本工位只管剧本落到可排产的形态。

**门禁**：不是模板占位、有钩子与收尾、@引用名清单齐。

## 工位二：角色与场景台

把所有视觉资产做齐并锁定命名，这是全剧一致性的唯一来源。

- **角色走锚点法**：先定正面全身锚点，其余视角/表情只参考锚点衍生；ref 数量有红线（见 `references/asset-workflow.md`）。锚点出图前先填设定卡七段（基础档案/外貌/标志性元素/三套服装/语言风格/关系网络/出场弧），字段要求与跨镜审查方法见 `references/character-design.md`。
- **画风先定三层再出第一张图**：线条、上色、色板各写一句，只写「韩漫风」这类名字跨镜必漂（见 `references/visual-lexicon.md`）。
- **场景走场景板**：`S-*` + Location + state（如 `S-01@day-crowd`），分镜只引用场景 ID 与锁定句，不重描外观（见 `references/scene-plates.md`）。
- **被审核拦截走技法 C**：墨镜遮挡 / 网格遮挡 / 无五官三视图 / 服装+头部组合 / 风格转绘，五种规避法见 `references/face-workarounds.md`。
- **文件名即引用名**：`素材/顾寒.png` 对应提示词里的 `@顾寒`，大小写也必须一致。

**门禁**：`python scripts/check_refs.py <项目>` 无断链引用。

## 工位三：分镜台

按手头材料选技法，两者共用同一套分镜 JSON 契约与机检：

- **技法 A（工程级分镜）**：有完整剧本时，读 `references/agent-prompt.md`，把系统提示词贴进新对话，产出「场景总览 + SEQUENCE 分镜执行表 + 序列自检」。
- **技法 B（宫格直生）**：只有梗概时，读 `references/grid-storyboard.md` 生成宫格 JSON（9 宫格配 15s 最稳），拼图用 `scripts/make_grid.py`，一张图直出片段。
- **每镜先出关键帧**：1–4 张候选、选优作该镜首帧；构图问题在静态图上改（成本约视频段 1/20）。8 段式写法见 `references/frame-industrial.md`。
- **运镜写到可执行**：只写「缓慢推进」模型自己定速度与落点，必写起点景别、终点景别、耗时三参数；焦距毫米数、环绕半径是设计自用值，写进提示词通常变空词（见 `references/camera-grammar.md`）。

**门禁**：`python scripts/validate_storyboard.py <json>` PASS；关键帧定稿；`python scripts/lint_prompt.py` 无空词与运镜歧义。

## 工位四：出片台

1. 按素材形态自动选档：首尾帧锁定 / 图生视频 / 多帧一镜 / 全能参考（矩阵见 `references/frame-industrial.md`）。
2. 逐镜出片，落 `第X集/分镜/视频段/段NN.mp4`。
3. 每段登记提示词版本与场景 state（`python scripts/manifest.py`），供同源核对——混源是接缝跳的常见结构性来源。
4. 逐集解锁：一集出完、用户确认，再进下一集；重生段数控制在 ~10% 内，超了停下查素材与提示词的系统性问题。

**门禁**：`manifest.py verify` 同源；重生率 ≤10%；批量/付费动作前已按「估算 → 确认 → 记账」走过。

## 工位五：后期台

拼接、配音、转场、字幕、验收、发布包装。

- **转场决策**：剪辑做还是模型做，四类缝的命名与帧级切点对齐见 `references/transition-editing.md`。
- **声音四轨**：对白 / 环境音 / 音效 / BGM，音色表与 TTS 落地见 `references/audio-voice.md`。
- **拼接**：`python scripts/concat_clips.py 第X集/分镜/视频段` 干跑核对参数一致性，`--apply` 拼接成片（同源走流复制零损失；异参数默认拒绝，先统一生成参数重出该段）；`--cuts-out` 导出切点供接缝复核。拼接前先 `trim_clips.py` 裁整拍，否则切点逐段漂移。
- **接缝量化**：`python scripts/qa_batch.py <成片目录>` 出底账，量化只做粗筛，内容仍以逐镜视觉验收为准。
- **发布包装**：最佳帧作封面 + 1–3 句分享文案（说清是什么 + 一个具体看点）。
- **发布后诊断**：上线后只看三个数（完播率、前 3 秒留存、互动率），按「留存曲线掉在哪一秒 → 回看那一秒在做什么」定位，一次只改一个变量；三平台分发要剪不同长度而非同一片换文案（见 `references/publish-ops.md`）。

**门禁**：接缝量化通过；视觉验收真看过（文件有效不等于验收通过）；封面与文案齐。

## 铁律与核心公式（五个工位通用）

- **@ 引用铁律**：所有镜头提示词必须 `@素材名` 关联参考素材，禁止纯文字描述代替；`@名称` 必须与素材文件名完全一致，否则引用失效。
- **引用即锁定**：@引用素材后禁止再用文字重描该主体外貌（脸型/发型/服装）——ref 与文字是权重冲突不是叠加，重描会让 ref 失效、角色变形；外貌在角色与场景台定稿，镜头提示词只写动作/景别/运镜/光线。同框多角色时 1 主 ref + 其余文字/剪影，红线见 `references/asset-workflow.md`。
- **三层工艺分离**：素材图=身份证（平光/信息优先）、分镜图=视频首帧（戏剧光/三层景深）、视频段=动作连贯——三层参数不可互套。素材阶段的中性风格词不进分镜图（会压掉戏剧光）；分镜图只写动作、禁止重描外貌。镜头级「先图后视频」工序与自动选档见 `references/frame-industrial.md`。
- **场景资产（场景板）**：同一场景跨镜复用先建 `S-*` 场景板——Location＋state（如 `S-01@day-crowd`）＋可选 View；场景板管地理、固定锚点、光线、空场与文字政策，分镜只引用场景 ID 与锁定句，不重描外观。同批镜头混用两个 state 即混源，接缝会跳；换代先改场景单再整批换图。写法、反推与验收见 `references/scene-plates.md`。
- **提示词三种写法**：①清单式（默认，单镜头精准控制）：`@角色名 @场景名，[动作/状态]，[景别代码]，[摄像机运动]，[光线]，[色调]，[风格标签]，[质量增强词]`；②时间轴式（多镜一条/宫格直生/长镜头）：`【风格】【时长】【画幅】` + `0-X秒：[镜头]+[画面]+[动作]` 分段 + `【声音】` + `【参考】@图片1 作为首帧`；③分镜图 8 段式（出每镜关键帧时用）：CHARACTER/BACKGROUND/ACTION/SCENE/CAMERA/LIGHT/TEXT/STYLE，写法与完整示例见 `references/frame-industrial.md`。
- **景别代码**：ECU 极端特写 / CU 特写 / MCU 近景 / MS 中景 / LS 全景 / ELS 大远景。画面内运动（人物动作）与摄影机运动分开描述，不混写。
- **运镜三参数**：每个运镜必写起点景别、终点景别、耗时。只写「缓慢推进」「环绕运镜」等于把速度与落点交给模型，同一条提示词两次生成结果不同。焦距毫米数、环绕半径与角速度是设计自查值（用来验证 4 秒转 360 度这类不可能调度），写进视频提示词通常是空词——把焦距的视觉后果写成可执行描述（「背景被压近、与人物几乎贴合」）。情绪化运镜十式与视角层级见 `references/camera-grammar.md`。
- **画风三层**：线条（粗细/闭合/描边）、上色（平涂厚涂/阴影软硬/高光形态）、色板（主色/辅助色/禁用色）三层各写一句，只写「韩漫风」「国风」这类名字跨镜必漂。画风与质量词冲突会互相稀释（写实画风配赛璐璐平涂），质量词按画风二选一。转写对照与光影三件套（光源/方向/性质）见 `references/visual-lexicon.md`。
- **黄金节奏**：每 25–30 秒一个 ⚡PEAK 情绪峰值；单序列 ≤6 镜；禁止连续同景别超过 2 镜；首镜 2 秒内出现视觉钩子；每镜必标转场代码 + 一句执行说明。台词时长折算：中文语速约 4–5 字/秒，镜头时长 ≥ 台词字数 ÷ 5，超了就拆镜或精简台词。完整词库（运镜/光线/质量词/24 种转场及情绪选用表）在 `references/agent-prompt.md`。本条管单片段内的镜头节奏；整集/多集的长叙事节奏设计（红果必爆 7 招 / 180 秒时间轴 / 24 集规划）用 `onlyshot-drama` 技能。
- **双框写法**：动态视频提示词 → 平台「视频生成」框；画面提示词 → 「图像生成」框。除 @引用名称与景别代码外用中文。
- **声音符号**：官方语法（ ）音乐、< >音效、{ }台词、【 】字幕——分镜表「声音设计」栏的内容必须按符号并入动态视频提示词末尾，例：（沉重雨声）<刀风呼啸>{台词}。
- **作用域与末态（防漂移）**：提示词按「管什么」分三层写——全局（片种/风格）、锁定（身份/@分工/连续性/负向）、时间（每拍的事件与**可见末态**）；多事件提示词必须为每个阶段写可见末态（「她感到释然」不算，「肩膀松下、皱眉消失」才算），最贵的锁定位在提示词末尾重述一次。详见 `references/prompt-craft.md`。
- **多人戏调度（写分镜前预排）**：同框 2 人以上的戏先排后写——①文字化俯视站位：以固定物件为坐标（谁在门边、桌哪侧、谁挡谁、通道在哪）；②逐拍走位链：谁行动 → 谁看到/听到 → 谁反应 → 谁移动 → 新站位，配角不凭空消失、走位要有时间预算；③视线有目标：看谁、何时转向、何时移开，反应只给在场且知情的人，避免全员同步震惊；④反打检查：左右关系、视线高度、光源方向一致，无意越轴不允许（有意越轴须有中性镜或明确重建方位）。镜头级执行细节与自检项见 `references/agent-prompt.md` 多人场景预排节。
- **关键帧接力与视频延长**：接力——首镜用序列起始帧作首帧参考，此后截取上一镜尾帧作下一镜首帧参考，保证构图与角色状态连续；延长——连续内容也可上传上一段视频写「将@视频1延长Xs」续写新内容。同一序列内两种衔接方式不混用；编辑/延长/转场决策的完整写法见 `references/transition-editing.md`。
- **单镜时长下限 1.5 秒**：「单序列 ≤6 镜」是上限，1.5 秒是下限——低于此值模型来不及完成切镜，两镜会糊成一团。上限防拖沓，下限防糊片，两头都要卡。
- **否定约束配正向清单**：只写「不要 X」，模型要么把 X 相关的一切掐死（画面死板），要么照旧乱加。正确做法是双清单——禁止项 + 允许项，允许项每项带理由/质感参照/动态约束。例：「禁止不出现霓虹光效；允许暖色台灯柔光溢出，参照钨丝灯暖黄，范围限灯罩周围 30cm」。这与否定失效三改法互补：三改法管怎么写对否定，双清单管否定之外什么可以做。
- **需求收集防四种走样**：AI 收集需求时容易凭印象瞎问、和气接受敷衍（用户答「高大上/都行」就放过）、自我满足提前结束、编造用户没说的内容。防御=对照六维清单逐项确认、见模糊副词必追问、推断内容标 `[待确认]`。六维：使用场景 / 目标受众 / 平台与时长 / 核心信息 / 现有素材 / 交付形态。详见 `references/short-video-studio.md` 第五节。
- **发布包装是交付的一部分**：短剧后期台除成片外给封面（最佳帧）与分享文案；短视频发布台要求封面文案、多平台发布文案、话题标签、评论区引导四件齐。只交成片不算交付完成。

## 项目层：多集与工作室目录

整部短剧或小说改编在项目层统一管理，五个工位对每一集都适用：

1. **建项目**：`python scripts/studio.py init <项目目录> --episodes N --title "剧名"`，生成 `studio.json`、`素材/`、`场景板/` 与各集三件目录。老项目已有 `素材/第X集/` 结构时，补一个 `studio.json` 即可纳入工作室视图，不必搬迁。
2. **分集**：按剧情节点切成 N 集，每集有独立的钩子与收尾，落成 `第X集/剧本.md`。长剧本分批输入时记录实际已读范围（已读的集/场清单），未读部分标「待补」——不凭梗概或前情假设声称读过全剧；源版本冲突以用户最新明确指令为准，无法判断的冲突列出来问，不静默选边。
3. **素材全剧共用**：人物/场景/道具参考图与 @引用名全剧一套，只在造型变化时补新参考图；跨集一致性靠同一批素材 + 同名 @引用。开剧先锁定画幅（短剧投放主流 9:16 竖屏）与视觉风格词，全剧贯通不改；角色音色表同样全剧一套一次定（见 `references/audio-voice.md`），连续性靠台账记录（见 `references/continuity-log.md`）。
4. **逐集逐工位推进**：每集从剧本台一路走到后期台，集与集之间用上一集成片尾帧作下一集首镜参考，也可用视频延长续写。每集产出后记一句尾帧画面描述（存 `分镜/尾帧.md`），下集首镜衔接直接引用。
5. **场景展示判断（每集写分镜前先跑）**：按观众看到的全剧剪辑顺序统一场景 ID，维护场景出场记录（首次出现场次 / 已出场次数 / 频率档），再选展示镜头——①全剧首次出现：安排大全景（或移动氛围镜，可合为一镜）交代空间规模、出入口与人物位置，开场钩子可以先出，但首次交代不能一路拖进人物特写；②已出现且全剧低频再现：用动作特写带出辨识细节，不重复完整大全景；③高频复用场景：直接进入人物戏，必要时才补方位。判断要有来源（已读到哪些集/场），本集首次 ≠ 全剧首次，未读部分不计为零，只有片段时注明假设；回忆/插叙按「首次看见」判断。本轮用户明确指定的镜头范围与拍法优先。记录表与字段见 `references/continuity-log.md` 场景出场记录节。

## 对标参考流程（有参考视频时）

用户想「照着这条做一版」时，先对标再进分镜台——把参考拆开、明确拿什么不拿什么，避免做出来「又像又不像」或直接照抄。对标产物=一张两栏清单 + 1-2 个差异化方案。

1. **拆维度**（逐项记录，不看整体印象）：结构（开场方式 → 推进顺序 → 收尾方式）、节奏（总时长、平均镜头时长、情绪峰位置、卡点方式）、钩子（前 2 秒抓住人的是什么：悬念/冲突/视觉奇观/利益点）、字幕样式（出现方式、排版位置、关键词强调手法）、素材穿插（特写与 B-roll 的插入时机和密度）。
2. **填两栏清单**：**保留栏**=可学的形式要素（节奏结构、钩子手法、字幕方式）；**更换栏**=必须替换的内容要素（人物、台词、产品、素材、音乐）。红线：**学结构不抄内容**——不逐帧复刻、不承诺还原度、不使用无权素材与音乐、参考文案只作结构参考不直接复用。
3. **出差异化方案**：按保留栏的形式，做 1-2 个与参考有明确差异的内容方案，进分镜台执行。真人出镜一律用本技能的人物参考图 + 角色与场景台技法 C 处理，不直接提取参考视频里的人脸形象（素材授权与人脸拦截是两道独立的坎）。

拆不动参考视频时（拿不到原片、只有截图）：按可见维度（结构、字幕样式、素材穿插）能拆多少拆多少，节奏类维度注明「凭观感估计」，不虚构精确数值。

## 平台硬约束（写蓝图前先核对）

**先锁两件再动笔**：目标模型版本（2.0 / 2.5——两版契约不同：时长上限、参考图规则、首尾帧有无、声音符号，禁混写）与画幅（竖/横，开剧一次定、全剧贯通）。用户未指定时一次问全再动笔，不默认选版、不中途换版。

| 约束 | 口径（2.0 实测为主；2.5 已 CLI 实查，详见 `references/jimeng-seedance-2.5.md`） |
|---|---|
| 参考图 | 2.0：≤9 张/次（人物 + 场景合计，最重要的放前面）；同框 ref ≤2，红线和替代法见 `references/asset-workflow.md`。2.5（CLI 实查 2026-10-10）：图 ≤30 / 视频 ≤10 / 音频 ≤10、素材总量 ≤50；多视图主体参考须拆单角度单图（一图一人，可作身份参考） |
| 参考视频/音频 | ≤3 条/次，总时长各 ≤15 秒（可用于运镜/动作/音乐参考）；2.5 支持仅传音频 |
| 生成时长 | 2.0：4–15 秒档位；2.5：4–30s（步进 1s）；单镜 1–4s 均可容纳 |
| 分辨率 | 2.0：480p–720p；2.5：480p / 720p / 1080p |
| 真实人脸 | 含真实人脸的参考图会被拦截，规避见角色与场景台技法 C |
| 画幅 | 短剧投放主流 9:16 竖屏，横屏备用；开剧一次定，素材/分镜/成片贯通 |
| 提示词长度 | 精确优先不堆砌；单条提示词经验上限约 1300–1500 字符（2.0 编测，超 1600 失败率显著上升）；2.5（CLI 实查）上限 15000 字符，仍建议精确不堆砌；超长时拆分镜头分次生成；长提示词（1400 字量级）单跑防限流，短提示词可并发 |
| 2.0 实测注意 | 时序整体偏晚约 2s（拍点写早或改分段）；15s 内状态变化 ≤4 个（超载会整段跳过）；参考图会覆盖文字描述的构图 |
| 2.5 其他实测 | 支持视频延长 / 片段编辑（按时间戳改局部）/ 秒级时间戳分段 / 白模参考；积分约为 2.0 的 1.85 倍（5s 720P 约 130 分/条，发布期实测量级，以生成时界面为准） |

以上为编写时点的公开口径，随平台版本会变；与实际不符时以实测为准并回改本表。

## 成本与确认纪律

- **先图后视频（两层）**：素材层——参考图定稿后再进分镜；镜头层——每镜先出 1–4 张候选分镜图、选优作该镜首帧，再出该镜视频（图成本约视频段 1/15–1/20）。构图问题永远在图上改。
- **逐集解锁**：多集项目一集一集产出确认，不一次全量生成；先出高曝光镜头样片验证风格，再批量。
- **重生预算**：单集重生段数控制在 ~10% 以内；超了停下检查素材与提示词的系统性问题，别硬刷。
- **批量/付费动作前与用户确认（估算 → 确认 → 记账）**：①估算——批量前按「镜数 × 单条积分」算总量给用户（单条积分参考 `references/jimeng-seedance-2.5.md`，重试余量另计）；②确认——先出 1–2 镜样片给用户看，拿到明确同意再批量提交、整集生成、扩大规模；③记账——生成后按批汇总一行（镜数、成功 / 失败 / 重试条数，口径见 `references/continuity-log.md` 第三节），让实际重生率可查、可对账。
- **交付形态先定、按名交付**：「只要提示词 / 只要分镜 / 只诊断 / 按原结构改写」是输出约束——只交付被点名的成品，不代做下游、不夹带修改未点名的文件。缺失的次要参数用**标注默认**补齐（普通新片无时长按 15s、画幅无指定按 9:16，均注明「补充默认」）；只有真歧义（素材身份、编辑目标、延长方向）才提问，且一次问全。
- **视觉验收纪律（防假验收）**：未实际查看生成的图/视频，不得声称视觉验收通过——文件有效（JSON 过机检、文件存在、能打开、拼接命令 exit 0）不能替代视觉去看；段缝量化与同源核对用 `scripts/qa_batch.py`（量化只做粗筛定位，内容仍以逐镜视觉验收为准）。实际结果逐镜检查：写实形态查身份/肤质/光影/手指，动画形态查造型/头身比/线条/色板/人数；发现问题给具体的重生成提示词，不改口说没问题。剧本侧同理：只声称读过实际读到的部分。
- **交付版本管理（旧版自动归档）**：docx 成品交付（剧本/脚本/方案等一切文档）遵循「当前版在交付根目录、旧版在归档子目录」；每次新版交付后把旧版移入 `<交付路径>/_旧版归档/`（移动非删除、可回滚，不主动删除旧版），纳入交付固定流程——执行 `python scripts/archive_old_docx.py <交付路径> "<当前版文件名.docx>" [更多保留名] [--dry-run]`（`--selftest` 自检）；多版本长交付项目（逐镜脚本、多集剧本等）一律启用。
- **发布包装（成片交付最后一步）**：①封面帧——从成片挑**最佳帧**（画面完整、主体清晰、能代表内容）单独导出作封面图（抽帧命令见 `references/transition-editing.md` 第十节）；平台若只能从视频首帧取封面，剪辑时确保首帧可看（不留黑场或过渡帧入点）。②分享文案——1-3 句，说清这条视频是什么 + 一个具体看点；忌「激动地宣布」类套话，多平台可给变体。

## 排障速查（生成结果不对时先查这里）

本表与全技能提示词均为编写时点的实测经验，平台行为会漂移；与实际不符时先按表调整提示词，反复失效再回改本技能。

| 症状 | 首修 |
|---|---|
| 人脸中途漂移/换脸 | 加一张正脸特写参考图并 @引用，提示词加"角色面容全程与参考图一致"；三视图素材若被读成多人，改用单视角正脸图 + 服装图组合（见 `references/face-workarounds.md` 方法 4） |
| 同一角色出现两个 | 每次提及都带 @角色名；提示词加"无重复人物，每个角色仅出现一次" |
| 冒出没要过的字幕/文字 | 提示词加"画面中不出现任何文字与字幕"；横构图比竖构图更稳 |
| 冒出水印/标志 | 提示词加"不生成任何水印与标志"；成图上的水印用去水印工具处理 |
| 风格漂向真人实拍 | 提示词明确风格标签；更稳的做法是先把参考图转成目标风格再上传 |
| 拼接处跳帧 | 后期剪掉上一段末尾数帧和下一段开头 1 帧再接（帧精确裁剪与拼接命令见 `references/transition-editing.md`「本机落地命令」节；本机已装 ffmpeg） |
| 动作崩坏/肢体错误 | 把复杂动作拆成更简单的单动作镜头重抽；或引用参考视频的动作编排 |
| 生成失败但无明确报错 | 先分三类根因：提示词超字数 / 内容审核 / 网络限流——看完整返回信息再处置，别一律当审核改词 |
| 提示词报参数/节点类错误（如 InvalidNode） | 多为提示词超字数——压到 1400 字符以内重提；改写与压缩要点见 `references/frame-industrial.md` |
| 长提示词批量失败/大面积超时 | 长提示词与并发不可兼得——单跑或并发压到 ≤4 并带退避重试；短提示词（<400 字）可常规并发 |
| 提示词被内容审核拦（非人脸） | 反派词换氛围词（sinister→moody、menacingly→缓动作、dark X→deep X）；面部特写+红晕/暧昧词高频触发，替换样本：blush on cheeks→rose tint、extreme close-up（面部）→medium shot、warm glow→soft ambient light；中文「反派」类词删除 |
| 多角色同框脸盲/换脸 | ref 数量超载（3+ 主角一致性 <50%）：1 个主角 ref + 其余文字描述或剪影；单镜 ref ≤2 |
| 画面文字乱码/叠字 | 必要文字显式声明 `clear legible Chinese characters「XX」, no garbled text`；弹幕只写 1 处出现+滚动描述，写 N 次会画出 N 个；小字/枚举列表易错（只画一部分）——重要文字走后期 |
| 拍点整体偏晚/镜头被跳过 | 时序偏晚约 2s：把拍点写早或改用「阶段+末态」分段；15s 内状态变化超 4 个会整段跳过——缩短每段或拆成多次请求 |
| 写明的运镜被忽略 | 把该运镜改写成这一镜的**主要意图**（而不是并列描述之一），或接受结果重新构图 |
| 写了「不要 X / 不出现 X」，X 照样出现 | 否定失效：被禁词根（光效/表情/空镜这类高关联概念）留在提示词里就会被当画面词渲染——按「否定失效三改法」换词（词根零出现）/ 主体优先句式 / 移除触发器（见 `references/prompt-craft.md`） |
| 多段生成的段间衔接生硬、人物消失又出现 | 段缝连续性：模型每段零记忆，段缝不设计必跳——给每段【接续状态】写具体末帧画面，并按「段缝衔接三方案」选衔接方式（末态双保险 / 换机位硬切 / 空镜过渡，见 `references/continuity-log.md`） |
| 想改已有视频局部/加长 | 编辑与延长有专门写法（唯一母版/范围写两遍/末态衔接），见 `references/transition-editing.md`；「禁止硬切」只在延长续写场景开 |
| 成片声音不对（配音/音乐/音量） | 四轨设计与音色表见 `references/audio-voice.md`；台词清晰度要求高走后期 TTS，氛围音用模型原生 |
| 运镜执行不出来/推镜变变焦/环绕转太快 | 补齐运镜三参数（起点景别、终点景别、耗时）；推与变焦按机位是否移动区分（见 `references/camera-grammar.md`、`prompt-craft.md` 8.3） |
| 画风跨镜漂移（韩漫出成日漫、某镜突变 3D） | 画风三层（线条/上色/色板）逐字复用到每镜；质量词与画风冲突会互相稀释（见 `references/visual-lexicon.md`） |
| 室内无窗却有夕阳斜射/光不与场景物理相符 | 光源三件套缺项：补光源是什么、方向、软硬与色温（见 `references/visual-lexicon.md` 四节） |
| 角色跨集越做越不像 | 按五维（面部/发型/服饰/体型/画风）逐镜审查，停在第一个不合格处；画风维度最易漏查（见 `references/character-design.md` 三节） |

## 参考文件与脚本索引

| 文件 | 何时读 |
|---|---|
| `references/studio-workflow.md` | 开工时；需要五工位定义、数据契约、改稿回流表、通用机制、单集推进命令序列时 |
| `references/short-video-studio.md` | 做短视频形态时；时长预算反推、三档节奏、Hook 六分类、追问失效防御、发布包装四件、脚本文件结构 |
| `references/agent-prompt.md` | 分镜台技法 A；或需要完整转场/词库表、人物与场景九宫格提示词模板时 |
| `references/grid-storyboard.md` | 分镜台技法 B；或用户给了剧情梗概要快速出片时 |
| `references/face-workarounds.md` | 角色与场景台：人物参考图被人脸审核拦截、或用户主动问怎么绕人脸限制时 |
| `references/asset-workflow.md` | 做人物/场景素材时；保角色一致性时（锚点法 / ref 数量红线 / 候选图选择 / 把关清单 / 文字入图规则 / ref 库规模标准） |
| `references/scene-plates.md` | 场景跨镜复用、场景换代或接缝跳光跳色时；场景板结构（Location/state/View）、空场与文字政策、反推补存量、场景图验收 |
| `references/frame-industrial.md` | 出每镜关键帧时；三层工艺分离 / 8 段式写法 / 非人形主角偏置对策 / 4 模选档 / 长提示词并发限流 |
| `references/prompt-craft.md` | 提示词打不准/漂移时；多素材绑定、作用域与末态法则、时间粒度、否定失效三改法、模型实测档案；词句层的空词替换、抽象词五步、运镜消歧、步态物理锁、完成态、身份块与运动块、五段式、失败编码（配 `scripts/lint_prompt.py`） |
| `references/transition-editing.md` | 规划转场（剪辑做还是模型做）、缝的类型命名与帧级切点对齐、编辑已有视频、向前/向后延长、集间延长衔接、接龙 |
| `references/continuity-log.md` | 多集项目一致性管理：连续性账 / 段缝衔接 / Take 记录 / 提示词版本账 / 证据分级 |
| `references/audio-voice.md` | 配音/旁白/BGM/音效设计：四轨规划、角色音色表、台词标注公式、Edge TTS 落地、混音检查 |
| `references/jimeng-seedance-2.5.md` | 用即梦 Seedance 2.5 出片前：能力规格、素材上限、积分参考、提示词规则、审核限制、复测判定（CLI 实查档案） |
| `references/facs-micro-expression.md` | 写实形态表情写不准、角色表情反复崩时；微表情四区写法、真假笑、强度三档、常用情绪配方 |
| `references/emotion-beat-curve.md` | 分镜前给剧本做情绪体检、规划开场钩子时；12 节拍曲线、钩子模式库、2 秒结构模板 |
| `references/action-previs.md` | 写打戏/动作段时；强度三档（R1-R3）、15 秒结构、11 环动力链、镜头五要素、防守三态 |
| `references/camera-grammar.md` | 运镜写不准时；运镜三参数、模型用值与设计自用值分离、情绪化运镜十式、视角层级、九类特殊场景参数、自查四问 |
| `references/visual-lexicon.md` | 定画风或写场景光线时；画风三层（线条/上色/色板）、十种主流画风写法、画风词转写对照、光影三件套与六种情绪光、场景风格统一四条、背景六段式 |
| `references/character-design.md` | 立角色或查一致性时；设定卡七段（档案/外貌/标志元素/三套服装/语言风格/关系网/出场弧）、跨镜五维审查、三类漂移成因、复用边界 |
| `references/publish-ops.md` | 成片上线前后；三平台差异、字幕与封面参数、情绪调色起步值、发布前六查、发布后三指标与归因顺序、迭代纪律 |
| `scripts/validate_storyboard.py` | 宫格分镜 JSON 产出后机检（数量/词数/字符上限/必含排除词/禁用句式/编号重复/否定词根·并列主体·抽象形态告警）；门日志 `--stats` 汇总「哪道检查最常响」 |
| `scripts/make_grid.py` | 本地拼宫格（4/6/9/25：`--cols 2/3/5`），替代在线拼图工具 |
| `scripts/check_refs.py` | 素材与引用核对：@引用名 vs `素材/` 文件名——断链引用（Error）/ 待补标注（Warning）/ 闲置素材（Warning）；`--bindings` 多素材绑定自检 |
| `scripts/init_project.py` | 多集项目脚手架：一键生成「根 `素材/` + 各集三件目录」结构（`studio.py init` 已覆盖，保留兼容老项目） |
| `scripts/short_plan.py` | 短视频脚本机检：口播字数是否落在目标时长可听区间、单镜 ≥1.5s、时间轴断档、钩子小节存在且非敷衍、发布包三件是否齐；`--target` 反推口播字数与镜头数 |
| `scripts/studio.py` | 工作室总控：`init` 建项目配置与五工位目录、`status` 扫盘出五工位进度＋当前焦点工位＋改稿影响提示、`check` 串起分镜/引用/清单/场景板机检、`board` 出单文件 HTML 看板 |
| `scripts/tts_voice.py` | 配音合成：按 `【角色｜profile_id｜style】` 标注稿调本地 VoiceStudio（`/v1/audio/speech`）逐段出 mp3，读 `studio.json` 的 `voices` 音色表；`--dry-run` 先看解析、`--list-voices` 核对 profile_id |
| `scripts/archive_old_docx.py` | docx 交付版本管理：旧版自动移入 `_旧版归档/`（保留清单 / `--dry-run` 预览 / 占用容错） |
| `scripts/sync_entity.py` | 技能实体同步：备份 → 差异扫描 → 同步 → md5 复核一条链（`--dry-run` 预演 / `--prune` 清多余） |
| `scripts/check_double_root.py` | 技能双根核对与补链（`.zcode`+`.agents` 双根部署）：内容 md5 + 硬链 samefile 逐件核对；只修「内容相同非硬链」（`--fix`），不一致只报告 |
| `scripts/check_seams.py` | 成片接缝质量量化检测：对相邻分镜「上一段尾帧 vs 下一段首帧」计算 SSIM／亮度差／色相差／饱和差／运动持续性五维指标＋综合偏差排序（模式 A：分镜目录两两成缝；模式 B：拼接成片＋切点列表）；阈值经人工判定样本校准，用于定位与复核视觉上「不顺」的缝 |
| `scripts/qa_batch.py` | 一键验收管道：分镜目录 → 接缝量化（复用 check_seams）＋清单同源核对 → 底账 Markdown；混源与超阈一次列清（`--json` 供机读） |
| `scripts/manifest.py` | 分镜生成清单：记录每段视频的提示词版本/参考图/场景 state/定稿状态；`verify` 核对「相邻两段是否同源」（混源是接缝跳跃的常见结构性来源） |
| `scripts/check_scene_plates.py` | 场景板机检：字段完整、ID/state/View 合法、空场与文字政策冲突、光线三件套、字数、敏感词、分镜脚本 S-* 引用跨文件核对 |
| `scripts/gen_scene_sheet.py` | 场景单生成：数据文件（唯一来源）→ 渲染 md → 可选调 article-format 生成 docx；`--verify` 逐字节回放、`--apply` 写盘、`--docx` 直出 |
| `scripts/trim_clips.py` | 分镜统一裁切：按帧级规则裁至整拍时长（默认 5.000 秒）；帧精确（默认）/流复制（`--fast`）双模式，默认干跑、`--apply` 执行 |
| `scripts/concat_clips.py` | 分镜段拼接成片（后期台）：先核对参数一致性（编码/分辨率/帧率/像素格式，异参数 `-c copy` 拼接会失败或花屏）→ 顺序拼接（同源走流复制零损失）→ 导出累积切点列表供 `check_seams.py`／`qa_batch.py` 复核；异参数默认拒绝，`--reencode-mismatch` 显式重编码到基准；默认干跑、`--apply` 执行、音轨默认丢弃 |
| `scripts/gen_script.py` | 脚本/文档版本生成引擎（单引擎＋数据文件）：按数据里的替换清单逐项校验命中数再写新版；`--verify` 回放验收、`--all` 全量回归（替代逐版复制的快照脚本） |
| `scripts/fix_table_pagination.py` | docx 分页修复（排版后处理）：表格行不跨页＋跨页表头重复、加粗标题与标签行防孤行、表头行与首数据行同页、操作顺序类短段防页界切半 |
| `scripts/style_code_blocks.py` | docx 代码块视觉后处理：给等宽字体（Consolas）段落补浅底纹＋左侧竖线、左缩进对齐、`keepLines` 防跨页拆断；pPr 按 schema 顺序插入，`--dry-run` 只统计不写盘 |

## 更新记录

- 2026-11-01 v2.5.0 工艺词典层与运镜机检（资源包深读吸收）：深读第三方「AI漫剧创作提示词资源包」31 份资料（53 页教程 PDF / 55 页提示词库 doc / 分镜运镜合集 / 人物场景风格手册 / 通用创作指令），按「取其结构与参数、弃其空词」原则补四篇 references——①**新增 `references/camera-grammar.md`**：运镜三参数（起点景别/终点景别/耗时，缺一项模型就在猜速度与落点）、模型用值与设计自用值分离（焦距毫米数、环绕半径用于自查调度是否成立，写进提示词通常是空词，把焦距的视觉后果写成可执行描述）、情绪化运镜十式（每式带可执行写法与常见误用）、视角层级八种（机位高度与距离决定强弱，与景别独立）、九类特殊场景参数（雨景/舞蹈/美食/夜景/跑步/婚礼/风光/微距/宠物）、自查四问；②**新增 `references/visual-lexicon.md`**：画风三层（线条/上色/色板，只写「韩漫风」这类名字跨镜必漂）、十种主流画风的三层写法与使用边界、画风词转写对照表（把「国风唯美」翻成可见特征）、光影三件套（光源/方向/性质，缺一项模型自编光与场景物理不符）与六种情绪光组合、场景风格统一四条、背景提示词六段式；③**新增 `references/character-design.md`**：设定卡七段（基础档案/外貌/标志性元素/三套服装/语言风格/关系网络/出场弧，判定线=交给没看过剧本的人能画出同一个人）、跨镜一致性五维审查（面部/发型/服饰/体型/画风，停在第一个不合格处）、三类高频漂移成因与对策、复用到设定卡为止素材不跨项目；④**新增 `references/publish-ops.md`**：三平台差异（抖音 60-90s 快手 90-120s 视频号 120-180s，三平台分发要剪不同版本而非同一片换文案）、字幕与封面可执行参数、情绪调色起步值（含「同场景内必须一致否则接缝跳色被 check_seams 命中」）、发布前六查、发布后三指标（完播率/前 3 秒留存/互动率，播放量是结果不是诊断项）、归因顺序（先看留存曲线掉在哪一秒再回看那一秒在做什么）、迭代纪律（一次只改一个变量）；⑤**`scripts/lint_prompt.py` 新增运镜三参数缺失检查**（有运镜但缺起点景别/终点景别/速度耗时即告警，selftest 加 camera_no_params 一项）；⑥`references/agent-prompt.md` 词库速查补运镜三参数铁律、序列自检补运镜参数两项；⑦SKILL.md 触发示例 39→50 类、铁律区补「运镜三参数」与「画风三层」两条、排障表补 4 行、description 改写补新触发词（978 字符，1024 限内）；⑧顺手修 `concat_clips.py` / `trim_clips.py` 的 subprocess 编码缺陷——`text=True` 用系统本地编码（中文 Windows 为 GBK）解码 ffprobe/ffmpeg 的 UTF-8 输出，遇非 GBK 字节即 UnicodeDecodeError 且 stdout 变 None，导致 `concat_clips.py --selftest` 在中文 Windows 上必挂；统一补 `encoding="utf-8", errors="replace"`（check_seams/studio 原本已写对）；⑨二十篇 references、二十一脚本口径同步（README/AGENTS/project-info）。
  吸收取舍：资源包通篇以「8K 超高清 / 电影级光影 / 超精细 / 完美细节」堆量，与本项目「空词即 FAIL」判定正面冲突，一律不入；其分镜组、镜头连续性、否定三改法、三层工艺分离的做法弱于本项目现行规定，只补强不替换；真正吸收的是它更细的**参数颗粒度**（运镜速度与落点、画风三层拆分、光影物理来源）与**投放运营层**（三平台差异、字幕封面参数、调色数值、数据诊断），后者是本项目此前止于「交付成片」的空白。
- 2026-10-02 初版：三路线落地（A 智能体分镜 / B 宫格直生 / C 人脸规避五法），SKILL.md + 3 个 references。
- 2026-10-02 通用化一轮：正文品牌词与出处字样清零，Seedance 去版本号。
- 2026-10-02 排障与工程层：新增排障速查、平台硬约束、声音符号、首尾帧接力、首镜钩子、validate_storyboard.py、make_grid.py，description 加故障触发词。
- 2026-10-02 结构层：新增多集工作流、行为时效标注与本更新记录。
- 2026-10-02 触发面：新增触发示例 10 条，description 补长剧多集/JSON 校验/拼图/衔接触发词。
- 2026-10-09 v1.1 行业实践更新：素材锚点法与 ref 数量红线（新增 `references/asset-workflow.md`）、台词语速折算、时间轴式提示词、视频延长衔接、内容审核排障与敏感词替换、成本与确认纪律、画幅锁定；机检扩至 4/6/9/25 宫格；修复 `scripts/validate_storyboard.py` CLI 调用路径缺陷（缺 pathlib 导入，selftest 已覆盖该路径）。
- 2026-10-09 v1.2 工程化补齐：`validate_storyboard.py` 中英双语适配（排除词中英任一命中即过、中文提示词跳过英文词数检查）＋字符数上限检查（--max-chars）＋编号重复检测＋GBK 编码回退；新增 `scripts/check_refs.py`（@引用与素材文件名双向核对，把「@名称须与素材名一致」铁律变成机检）与 `scripts/init_project.py`（多集项目脚手架）；多集项目结构澄清（根 `素材/` 全剧共用 + 每集三件）；front-matter 补 version；新增 CHANGELOG.md。
- 2026-10-09 v1.3 三块升级：①提示词工程层（新增 `references/prompt-craft.md`：三作用域法则 / 末态法则 / 时间粒度 / 多素材绑定 / 复查顺序 / 2.0 实测档案与 2.5 探测清单）；②衔接与后期（新增 `references/transition-editing.md`：转场「剪辑做还是模型做」决策 / 禁止硬切的正确作用域 / 受限菜单法 / 编辑四件套 / 向前向后延长 / 接龙）；③连续性台账（新增 `references/continuity-log.md`：连续性账 / Take 记录 / 提示词版本账 / 证据分级，多集项目轻量落地）；④声音模块（新增 `references/audio-voice.md`：声音四轨设计 / 原生音频与后期 TTS 决策 / 角色音色表 / 台词标注公式 / Edge TTS 与 ffmpeg 落地 / 混音检查）；平台表补 2.0 实测注意与 2.5 口径；排障表扩至 16 类。
- 2026-10-09 v1.4 分镜图工艺更新：新增 `references/frame-industrial.md`——三层工艺分离铁律（素材=身份证/分镜图=首帧/视频段=动作，参数互不套用，双污染方向防护）、镜头级先图后视频（每镜 1–4 候选→选优作首帧，候选数分配与成本判据）、分镜图 8 段式写法（第三种提示词格式 + 完整示例）、非人形主角拟物化偏置对策（选材/否定子句/重做判据）、视频 4 模选择矩阵（图生视频/首尾帧/多帧一镜/全能参考）、长提示词并发限流规律、失败三分辨与出图复查顺序；路线 A 流程升级（新增第 4 步逐镜关键帧）；铁律区补「三层工艺分离」、写法扩为三种；排障表增 2 类（超字数报错/长词并发）；asset-workflow 补 ref 库规模标准与非人形指针。
- 2026-10-09 v1.5 落地闭环与画风适配（全量审查后 P1-P3 优化落地）：①`references/transition-editing.md` 新增「本机落地命令」节——抽尾帧/首帧、掐头去尾（快档 -c copy / 准档 trim 帧精确两方案）、无损拼接，全部经 30fps 测试片实测（含中文空格路径）；②`references/agent-prompt.md` 质量词按画风二选一（写实向/动画向分列 + 写实词整组替换说明）；③agent-prompt 补 frame-industrial 与抽帧命令互引；④排障表暧昧词替换具体化（blush on cheeks→rose tint 等样本）；⑤路线 B 补候选图环节（1–2 张选优再放大）；⑥黄金节奏补 onlyshot-drama 长叙事节奏互引；⑦`scripts/make_grid.py` 目录扫描支持递归子目录（selftest 增嵌套用例）；⑧README 增「快速上手」最小示例节。
- 2026-10-09 v1.5.1 定位说明修正（技能名不变）：技能说明从「漫剧制作技能」修正为「AI 短剧创作工作流」——本技能覆盖动态漫/漫剧、写实风等全部短剧形态，并非仅漫剧；路线 A 更名「分镜智能体」（原「漫剧智能体」）；画幅表述「漫剧投放主流」→「短剧投放主流」；description 中英双语同步改写。技能名/目录名/GitHub 仓库名当时保持 ai-short-play-video-creation 不变（v2.2.0 已统一改名为 AI-Short-Drama-Studio / ai-short-drama-studio）。
- 2026-10-10 v1.6.0 即梦 Seedance 2.5 实查收录：新增 `references/jimeng-seedance-2.5.md`（CLI 实查：能力规格 / 素材上限 / 积分参考 / 提示词规则 / 审核限制，含三层来源分级与时效注明）；平台硬约束表 2.5 口径由「发布材料未实测」升级为「CLI 实查」（参考图 ≤30、时长 4–30s、分辨率至 1080p、提示词上限 15000）；`references/prompt-craft.md` 的 2.5 段规格回填、行为四探测标注为待跑；`references/asset-workflow.md` 新增「真人素材作首帧：重构图规范」（首帧四要素 / 重构图工序 / 验收三查）。
- 2026-10-12 v1.7.0 同业技能实践吸收（三块）：①多人戏调度——铁律区新增预排四步（俯视站位/走位链/视线目标/反打检查），`references/agent-prompt.md` 系统提示词新增「多人场景预排」节与自检补项；②场景展示判断——多集工作流新增三分法（首现交代/低频带出/高频直入），`references/continuity-log.md` 新增「场景出场记录」节与记录表；③验收与接收纪律——成本纪律新增「视觉验收纪律」（文件有效不替代视觉验收、按形态逐镜检查、只声称读过实际读到的部分），多集工作流分集补「已读范围」纪律；触发示例扩至 16 类，description 补触发词。
- 2026-10-14 v1.8.0 更新（参考同业技能，第一、二批）：①机检扩充——`scripts/validate_storyboard.py` 新增 C8 否定式高关联约束 / C9 并列主体句式 / C10 抽象过程形态词三条告警检查 + 门日志与 `--stats` 汇总（哪道检查最常响=最该改措辞）；②引用核对升级——`scripts/check_refs.py` 断链区分「显式待补」（行内标注待补→降级为警告）+ `--bindings` 多素材绑定自检；③段缝衔接——`references/continuity-log.md` 新增第五节（三方案：末态双保险/换机位硬切/空镜过渡；接续状态末帧画面纪律），`transition-editing.md` 补集间延长衔接用法；④否定失效三改法——`references/prompt-craft.md` 新增第七节（词根敏感性/换词/主体优先句式/触发器移除/栏目纪律）；⑤前置锁定与交付纪律——平台硬约束补「先锁两件再动笔」、成本纪律补「交付形态先定、按名交付」；⑥复测判定——`references/jimeng-seedance-2.5.md` 行为复测判定节（reproduced/degraded/failed + 样本数）；排障表 2 行（否定失效/段缝衔接）；description 补触发词；README 同步。
- 2026-10-14 v1.9.0 更新（参考同业技能，第三批·新做法模块）：①面部表演工艺——新增 `references/facs-micro-expression.md`（FACS 四区写法、真假笑、强度三档与起-hold-落、常用情绪配方、结果词禁令与投喂翻译纪律）；②情绪节拍与开场钩子——新增 `references/emotion-beat-curve.md`（12 节拍情绪曲线体检表 + 三条判定 + 钩子模式库 + 2 秒结构模板）；③打戏预演——新增 `references/action-previs.md`（R1-R3 强度档 / 15 秒完播结构 / 11 环动力链 / 镜头五要素 / 防守三态 / 物理反馈分级）；④后期工具路线对照（`transition-editing.md`）：ffmpeg 与剪映草稿路线的适用边界与去重提示；description 补触发词（微表情/打戏/情绪节拍/开场钩子）；README 与索引表同步。
- 2026-10-14 v1.9.1 收尾同步与工程优化：①触发示例补 5 类新能力话术（段缝衔接/微表情/打戏/情绪钩子/否定失效，16→21 类）；②description 精简至 1024 字符规范内、front-matter 补 `license: MIT` 字段；③`references/agent-prompt.md` 轻度同步——序列自检补四项（段缝衔接/表演真实/约束有效性/打戏段）、写法说明区补三条新工艺指针；④新增 GitHub Actions CI（五脚本 selftest + 样例项目端到端回归）；⑤新增 `examples/demo-multi-ep/` 样例项目（质量基准与回归夹具，不入实体）；⑥`validate_storyboard.py` 门日志加行数轮转（默认 2000 行上限，防无限增长）。
- 2026-10-14 v1.9.2 收尾补件：①新增 `scripts/sync_entity.py`——技能实体同步一键化（安全检查 → 差异扫描 → 备份 → 同步 → md5 复核；`--dry-run` 预演 / `--prune` 清多余；排除承载与仓库级资产，列表维护在脚本顶部常量），selftest 覆盖全路径（含排除根级文件与备份防重名两处修复）；②脚本索引表补录 `archive_old_docx.py`（v1.7.1 加入时遗漏）与 `sync_entity.py`；③README 补「样例与自动检查」指引（examples 与 CI）；④AGENTS/project-info/CI/CHANGELOG 六脚本口径同步。
- 2026-10-15 v1.9.3 双根维护配套：新增 `scripts/check_double_root.py`（双根核对与补链——内容 + 硬链逐件核对，只修「内容相同非硬链」，默认双根由脚本位置推导；`sync_entity` 双根场景的固定收尾步）；七脚本口径同步（AGENTS/README/CI/project-info/CHANGELOG）。
- 2026-10-15 v1.10.0 更新（参考四个开源项目）：①对标参考流程（OpenMontage 参考驱动 + Hypit 复刻纪律）——五维拆解 →「保留 / 更换」两栏清单 → 差异化方案，红线=学结构不抄内容、不逐帧复刻；②成片机检三查（OpenMontage 渲染后自审轻量化）——ffprobe 参数对账 / blackdetect 黑帧检测 / volumedetect 音频电平，落 `transition-editing.md`，三条命令经本机实测（含黑帧与无音轨对照组）；③发布包装（Brag 海报帧工艺）——最佳帧作封面 + 分享文案忌套话，落成本与确认纪律区；④词锚定迭代原则（Hypit）——改词/多语言保持词序骨架、时间轴按语速折算重新流动，落 `prompt-craft.md` 时间粒度节；⑤预算三步账（OpenMontage 预算治理轻量化）——估算 → 确认 → 记账，强化成本纪律「批量确认」既有条目；⑥代码渲染路线指针（HyperFrames）——落 `transition-editing.md` 第十节；触发示例 21→22 类、description 补触发词（参考视频对标 / reference-video benchmarking）。
- 2026-10-15 v1.11.0 接缝量化检测与排版修复工具：新增 `scripts/check_seams.py`（相邻分镜尾帧/首帧的四维量化分与综合偏差排序，阈值经人工判定样本校准）与 `scripts/fix_table_pagination.py`（docx 分页修复四项，带 selftest）；九脚本口径同步（AGENTS/README/CHANGELOG/CI/project-info）。
- 2026-10-15 v1.12.0 缝的类型与帧级切点对齐：`references/transition-editing.md` 新增同名节——转场命名四类（序幕缝/机位缝/动作缝/落点缝，各带意图与验收点）＋帧级切点对齐三步（拍长网格换算、裁齐整拍时长、切点 N＝N×整拍时长）；节号顺延（九/十/十一→十/十一/十二）与 `SKILL.md` 内引用同步。
- 2026-10-17 v1.13.0 接缝检测运动持续性指标：`scripts/check_seams.py` 新增第五指标「运动持续性」——切点两侧各取「接缝帧与其前 tail 秒帧」的帧间运动量（灰度平均绝对差），比值的 log10 偏差归一化（0＝两侧运动量相近；一侧骤停或骤起时升高）；阈值 0.55 经真实样本校准（正常缝 0.013-0.45 自然分布、极端缝 0.64）；JSON 输出含两侧运动量原始值（me_tail/me_head），`--no-flow` 可关闭退回四维；selftest 扩至 8 项。
- 2026-10-17 v1.14.0 批量生成与验收配套工具（项目实践回流）：新增四件——`scripts/qa_batch.py`（一键验收管道：接缝量化＋清单同源核对＋底账）、`scripts/manifest.py`（生成清单与同源核对）、`scripts/trim_clips.py`（统一裁到整拍时长，帧精确/流复制双模式）、`scripts/gen_script.py`（版本生成引擎：单引擎＋数据文件＋逐字节回放，替代逐版复制快照脚本）；四件均带 selftest（trim_clips/qa_batch 无 ffmpeg 时自动跳过）；十三脚本口径同步（AGENTS/README/CI/project-info）。做法来源：商业短片项目承载层优化（生成器 21 份快照收敛为 16 版数据、回放 16/16；一键 QA 底账与既有手工底账数值逐项一致）。
- 2026-10-20 v1.15.0 场景资产与场景板（项目实践回流）：①新增 `references/scene-plates.md`——四层资产与引用链、Location/state/View 模型、条目六段正文、十条写法（地理优先、光线可解释、空场三档、文字政策双层、参考声明、禁写运镜）、反推补存量与八项验收；②新增 `scripts/check_scene_plates.py`——场景板机检 12 项（字段、ID/state、政策冲突、光线三件套、字数、敏感词、跨文件 S-* 引用），`--max-chars` 可配；③新增 `scripts/gen_scene_sheet.py`——数据单源渲染场景单 md，可调 article-format 生成 docx，`--verify` 逐字节回放；④`manifest.py` 与 `qa_batch.py` 增 `scene_state` 字段与一致性核对（混用两版场景即混源）；⑤触发示例 26→28 类（场景板、场景 state 混源核查），铁律区补场景资产条；⑥十五脚本口径同步（AGENTS/README/CI/project-info）。做法来源：面料走秀项目场景单交付（反推补存量、数据单源、锁定句唯一定义源、逐镜原样引用、场景机检与视觉验收分工）。
- 2026-10-21 v1.15.1 实体同步缓存排除修复：`sync_entity.py` 的 EXCLUDE 检查原先只作用于顶层目录，`scripts/__pycache__` 等子目录缓存仍会被同步进技能实体；改为每层目录都剪枝 EXCLUDE，selftest 保持通过。
- 2026-10-21 v1.16.0 docx 代码块视觉后处理：新增 `scripts/style_code_blocks.py`——md2docx 的围栏代码块只有等宽字体、没有底纹边框，提示词这类需整段复制的内容与正文分不清；脚本对 Consolas 段落补浅底纹（`--shd` 可改）＋左侧竖线（`--border` 可改）、左缩进 0.3cm 且首行缩进清零（复制不带行首空格）、`keepLines` 防页界拆断；pPr 子元素按 OOXML schema 顺序插入（`insert_element_before`），默认写回原文件、`--dry-run` 只统计不写盘，带 5 项 selftest。十六脚本口径同步（AGENTS/README/CI/project-info）。做法来源：面料走秀项目 docx 排版回归（长提示词代码块被分页切断）。
- 2026-10-22 v1.17.0 词句层写法与词层机检：①新增 `scripts/lint_prompt.py`——检查空词（cinematic/8K/电影感/高级感等）、推近未说明推镜还是变焦、摇镜头未写轴向、一镜多运镜、走秀行进缺步态物理锁、有转身缺完成态、负面约束过量；`--script` 查分镜脚本、`--text` 查单条提示词、`--latest` 按 `--glob` 取版本号最大者、`--line general` 关闭走秀口径；selftest 四项（空词、缺步态锁、多运镜、干净样例）；②`references/prompt-craft.md` 增第八节「词句层」——空词表与 perfect anatomy 处理、抽象词五步转写与替换表、运镜消歧八式、步态物理锁、完成态、动作倒放与截断、多运镜过载、身份块与运动块分离、五段式骨架、F01 到 F19 常用失败编码与成本阶梯；③触发示例 28→30 类；④十七脚本口径同步（AGENTS/README/CI/project-info）。做法来源：面料走秀项目提示词写法手册与失败编码表，经三份外部写法库逐条核对后按技能口径改写。
- 2026-10-27 v2.2.0 改名：技能标识 `ai-short-play-video-creation` → `ai-short-drama-studio`（GitHub 仓库与本地工作区目录 → `AI-Short-Drama-Studio`）。三处命名按各自规则处理：技能 `name` 字段受加载器规范约束（官方要求 lowercase kebab-case 且必须与技能实体目录同名），故用 `ai-short-drama-studio`；本地工作区目录与仓库名不受该约束，用 `AI-Short-Drama-Studio`。同步更新的引用面：SKILL.md name、README badge 与 clone 地址、AGENTS.md 标题与实体路径、docs/project-info.md 标题、五个脚本文档字符串；本机技能实体目录与触发登记表另随实体迁移。历史更新记录里对旧名的陈述保持原样不改（那是当时的事实）。
- 2026-10-27 v2.1.0 双形态（短剧 + 短视频）与通用机制补强（用户选 A+B）：①**新增短视频形态**——`studio.py init --form short --target N` 建单条项目（脚本.md / 分镜/ / 成片/ / 发布/），工位名随形态切换（脚本台/素材台/分镜台/出片台/**发布台**），`status/check/board` 全部支持两种形态；②**新增 `scripts/short_plan.py`**——口播字数按目标时长反推（中文 4.0-4.6 字/秒）、三档节奏镜头数、单镜 ≥1.5s、时间轴断档、钩子小节存在且非敷衍、发布包三件齐，selftest 八项；③**新增 `references/short-video-studio.md`**——时长预算表与「不要抄英文旁白 1.5-2 字/秒」的跨语言警告、三档节奏、Hook 六分类与四不要、追问四种失效防御、发布包装四件、脚本文件固定小节、与短剧形态对照；④**通用机制四条进铁律**（两种形态共用）——单镜 1.5s 下限、否定约束配正向清单（与三改法互补）、需求收集防四种走样、发布包装是交付的一部分；⑤短视频发布台门禁=成片+发布包双齐（只有成片不算完成）；⑥触发示例 32→37 类；⑦调研来源 `docs/ecosystem-survey-2026-10-short-video.md`（本地留档）。做法来源：video-spec-builder 追问失效防御与节奏表、hook-lab Hook 六分类、whiteboard-book-video 口播字数实测、short-video-script-skill 发布契约、seedance2.0-prompt-skill 单镜下限与特效双清单（均按本技能口径重写，未搬运原文）。
- 2026-10-27 v2.0.0 工作室化重构（对标即梦 AI 短剧工作室 2026-10-26 上线形态）：①**骨架从「三路线并列」改为「五工位流水线」**——剧本台 / 角色与场景台 / 分镜台 / 出片台 / 后期台，工位按目录产物判进度、按层回流改稿；原路线 A/B 降为分镜台两种技法，路线 C 降为角色与场景台的审核规避技法。②新增 `references/studio-workflow.md`——五工位定义与门禁、数据契约（`studio.json` + 项目目录）、改稿回流表（改哪层、必须重做哪层、可保留什么）、单集推进命令序列。③新增 `scripts/studio.py`——`init` 建配置与五工位目录（对齐 `init_project.py` 结构，老项目补 `studio.json` 即纳入）、`status` 扫盘出进度／当前焦点工位／「资产晚于成片」「分镜晚于视频段」两类改稿提示（`--json` 机读）、`check` 串起 `validate_storyboard` / `check_refs` / `manifest verify` / `check_scene_plates` 四个门禁；selftest 覆盖空项目→有剧本→有素材分镜→门禁全绿→时间戳回流提示五段。④`SKILL.md` 触发示例 30→32 类（补「项目做到哪一步」「改了剧本哪些镜头要重出」），description 中英双语改写为工作室口径并补 DreamScript / Anycook / DreamShot 等触发词。作者决策：不引入 Web 前端或平台 API 依赖，工作室形态以「项目目录 + 总控脚本 + 工位纪律」在技能层同构实现，避免把可移植技能绑死在某平台页面结构上。
- 2026-10-29 v2.4.0 配音升级为自建音色（接入 VoiceStudio）：此前配音只有 Edge TTS 一条路，音色从 9 个固定中文音色里挑，跨集一致性靠「别挑错」，音色表现力受限于固定池。本次把音色表从「从固定池挑」改为「每角色自建」——①**新增 `scripts/tts_voice.py`**：吃第四节现有的 `【角色｜profile_id｜style】` 标注稿，逐段调本地 VoiceStudio 的 `/v1/audio/speech`（OpenAI 兼容）出 mp3，序号即时间轴顺序；纯 stdlib（urllib）无新依赖；`--dry-run` 先看解析不出音频、`--list-voices` 核对服务上的 profile_id、`--project` 读 `studio.json` 的 `voices` 音色表；缺 profile_id 时明确报错而非静默用默认音色；selftest 覆盖标签解析、音色表回落、显式标签优先、缺配置报错、文件名净化、空行不切段六项。②**`studio.json` 新增 `voices` 字段**（`{角色: {profile_id, style}}`），音色表随项目走、跨集复用。③**`references/audio-voice.md` 三节改写**：音色表分「自建音色（克隆/设计）」与「固定音色池（Edge TTS 降级）」两张，前者记 profile_id 与素材来源；五节拆成 5.1 VoiceStudio 首选路径（含一次性准备三步、合成命令、四条注意事项：profile_id 须人工获取/素材干净度决定质量/别走 MCP base64/声音授权）与 5.2 Edge TTS 降级路径（原命令保留，明确 tts_voice.py 不吃 Edge 音色名）；四节标注格式补第二位的两种合法填法。④二十→二十一脚本口径同步（AGENTS/README/CI/project-info）；触发示例 38→39 类。设计取舍：**不做脚本内克隆**——克隆要看像不像，机器判断不了，只把「给定 profile_id 的批量合成」这件机械且可判定对错的事收进脚本；**不删 Edge TTS**——它是没装 VoiceStudio 和龙套角色时的降级路径，且免费无 GPU 依赖。接入依据：VoiceStudio 暴露 OpenAI 兼容 `POST /v1/audio/speech`（`voice` 填 profile_id），格式 `mp3/wav/flac/opus/aac` 可选，本地回环免鉴权，`response_format` 直接落盘规避 MCP base64 撑爆上下文的问题。
- 2026-10-28 v2.3.0 分镜拼接脚本（后期台缺口补齐）：此前 `trim_clips.py` 裁整拍之后，「段→集」只剩文档里的手敲 ffmpeg concat 命令，是后期台唯一的命令级断点。新增 `scripts/concat_clips.py` 接管三件事——①参数一致性核对（编码/分辨率/帧率/像素格式，可选音轨）：混参数直接 `-c copy` 拼接会失败或花屏，是手工拼接最常见的翻车点，不一致默认拒绝并提示「先统一生成参数重出该段」；②顺序拼接（同源走流复制，零损失秒出）；③导出累积切点列表，直接喂 `check_seams.py --video --cuts` 与 `qa_batch.py` 模式 B，把「拼完再猜切点在哪」变成可复算数据。配套细节：段名自然排序（段2 在段10 前）、时长不等时提示切点会逐段漂移、异参数可 `--reencode-mismatch` 显式重编码到基准（有损，需明示同意）、音轨默认丢弃（成片声音走后期配音轨）、输出路径按工位结构自动推断（`第X集/分镜/视频段` → `第X集/成片/第X集_成片.mp4`）、默认干跑 `--apply` 执行、带三项 selftest（自然排序+切点导出、异参数拒绝、重编码统一到基准）。二十脚本口径同步（AGENTS/README/CI/project-info）；触发示例 37→38 类；工位五补拼接实操命令。设计取舍：不做「一键全自动后期」——配音/混音/字幕各有独立参数与人工判断（loudnorm 单遍可偏 3.7dB 需跑两遍、BGM ducking 要看台词段），串联成黑盒会掩盖这些需要人看的点；只把「机械且可判定对错」的拼接收进脚本。