@oh-story/dsh 0.1.3 → 0.1.5

package/lib/drama/skills/short-drama-storyboard/references/comic-keyframe-lexicon.md

@@ -0,0 +1,156 @@
+# 漫剧关键帧视觉词表
+
+## 目录
+
+- [这份词表解决什么问题](#这份词表解决什么问题)
+- [规则分级与语言政策](#规则分级与语言政策)
+- [三层组织方式](#三层组织方式)
+- [项目级共享画风基底](#项目级共享画风基底)
+- [镜头类型一：叙事关键帧](#镜头类型一叙事关键帧)
+- [镜头类型二：对话镜头（中近景）](#镜头类型二对话镜头中近景)
+- [镜头类型三：动作 / 特效帧](#镜头类型三动作--特效帧)
+- [组合方法：选镜头类型，填主体](#组合方法选镜头类型填主体)
+- [完整示例（合成改写）](#完整示例合成改写)
+- [反模式](#反模式)
+
+## 这份词表解决什么问题
+
+项目视觉方向接受为漫剧 / 二维漫画形态后，写关键帧 `generic_prompt` 的人会撞上同一个
+问题：身份、地理、边界事实都绑好了，但“这一帧怎样投影已接受的画风、当前镜头要防什么
+可读性风险”每次都要重新发明措辞，同一个项目里不同集的提示词各说各话。这份词表把
+项目级画风基底与镜头级可选词分开，让同一项目复用一份视觉语言，又不把镜头差异抹平。
+
+它是 [关键帧手艺](keyframe-craft.md) 的补充，不是替代：主体、边界瞬间、构图、机位、光线、
+连续性与排除项仍先写清，本词表只负责画风投影、光色倾向和当前帧的可读性约束。
+事实先于审美词的优先级不变——词表里的任何词都不能顶替身份、地理、构图与连续性事实。
+
+## 规则分级与语言政策
+
+- 本词表中的画风与镜头级选词都是 `taste_option`：它们供比较，不是质量门槛。创作者选定方向后，
+  把可观察的稳定项写进 `视觉设定.md` 的“项目视觉方向”；在那之前，审查不得只因没用某个词判问题。
+- 不用量、词数或“必须包含某词”设门槛。项目级基底读取一套已接受的方向（可以是创作者明确
+  接受的兼容组合）；镜头级词只取能解释当前叙事职责或可见风险的部分。
+- 提示词正文语言跟随 `prompt_language`（没有项目配置时默认 `en`）。本词表给中文词根，写入
+  prompt 时译为当前任务声明的语言；改了描述语言不等于
+  改了画面里的可读文字，可读文字仍由已接受的文字政策决定。
+- 正文里不写镜头 / 记录 ID、规则编号与状态词；这延续 `SHT-21`。下表的“镜头类型”只是
+  选词入口，不进提示词正文。
+
+## 三层组织方式
+
+建议按三层组织；重点是事实先于审美词，不把段落顺序本身当成机械门槛：
+
+1. **场景 / 主体事实**：这一帧拍谁、在哪、处于哪个边界瞬间——来自已接受的资产、镜头边界与
+   [keyframe-craft.md](keyframe-craft.md) 的十二项。本词表不提供这一层，也不允许用风格词冒充它。
+2. **视觉语言投影**：项目级共享画风基底 + 当前镜头需要的光色或表现手段。先从已接受的
+   “项目视觉方向”读取稳定项，再按镜头目的补局部变化；不能每集回表重新选一套。
+3. **可读性 / 风险约束**：只写当前帧确实可能失去的可见信息，例如目光、持物、特效起点或
+   前中后景层级。分辨率、供应商质量标签和固定负面词尾不是这一层。
+
+## 项目级共享画风基底
+
+画风基底属于项目，不属于某一种镜头。分镜阶段从 `视觉设定.md` 的“项目视觉方向”读取
+“选择 + 可观察写法”；尚未决定时回到 Look Development 比较，不在单镜里代选。叙事、对话和
+动作帧都读取同一组稳定项。
+
+| 选择入口 | 写进可观察视觉方向的投影 |
+|---|---|
+| 赛璐璐动画帧 | 清晰轮廓线、平整色块、层数克制的硬边阴影 |
+| 厚涂漫画 | 可见笔触、以明暗塑造体积、软硬边随材质变化 |
+| 平涂漫画 | 形体概括、有限色阶、弱化表面纹理 |
+| 国风条漫 | 墨线粗细变化、分层设色、留白参与空间组织 |
+| 日系二次元漫剧 | 简化面部体块、干净线稿、赛璐璐式表面分区 |
+| 复古港漫 | 密集轮廓与排线、高反差色块、印刷颗粒 |
+| 水彩叙事 | 纸面纹理、透明色层、轮廓局部晕开 |
+| 极简叙事漫画 | 克制线条、大面积留白、低数量色层 |
+
+表里的名称只是选择入口。若删掉名称后，线条、色层、阴影边缘、材质和空间写法都没有变化，
+这个方向仍只是标签，应先回到 Look Development 把它写成可观察选择。
+
+## 镜头类型一：叙事关键帧
+
+用于承担剧情转向、揭示或场尾落点的关键画面，是漫剧分镜的默认帧型。
+
+| 分组 | 可选词根 | 何时使用 |
+|---|---|---|
+| 构图表现 | 强透视、前景遮挡、特写叙事、画面重心偏置 | 透视、遮挡或不平衡构图确实承担压力 / 揭示时 |
+| 光影与色调 | 暗调叙事、冷暖分区、轮廓逆光、局部高反差、低饱和色层 | 已接受方向允许该变量，且它帮助观众找到叙事重点时 |
+| 可读性约束 | 视觉重点不被氛围层遮住、身份锚点可辨、前中后景层级分明 | 当前帧有雨雾、群像、暗部或复杂景深等具体风险时 |
+
+“动态张力”不能代替冻结姿态；要写清身体朝向、重心、持物和画面边界。“电影运镜感”不进
+关键帧，摄影机随时间的变化仍由 `$short-drama-video-prompts` 负责。
+
+## 镜头类型二：对话镜头（中近景）
+
+用于以台词和神态为主的镜头，风险集中在面部、目光、持物与背景竞争。
+
+| 分组 | 可选词根 | 何时使用 |
+|---|---|---|
+| 构图表现 | 人物半身构图、肩后前景、反应特写、对话框留白 | 构图需要交代关系，或交付方案确实要叠加对话框时 |
+| 光影与情绪 | 柔和侧光、单侧硬光、低饱和色层、冷暖肤色分离、背景降对比 | 光线 / 色层能让表情或双方权力差变得可见时 |
+| 可读性约束 | 面部识别点与目光可辨、关键手势 / 持物不被裁掉、背景不争夺注意中心 | 当前镜头的台词落点依赖对应信息时 |
+
+“对话框留白”是交付面上的构图决定，不是每个对话镜头的默认词。角色没有关键手势或持物时，
+也不添加相应排除项。
+
+## 镜头类型三：动作 / 特效帧
+
+用于打斗、施法、爆发瞬间。下表描述的是**冻结帧里可见的处理**（方向性拖影、粒子、光刃
+凝固在一个边界瞬间），不是动作过程——“先、再、最后”与运镜过程仍属于
+`$short-drama-video-prompts`。
+
+| 分组 | 可选词根 | 何时使用 |
+|---|---|---|
+| 冻结动态表现 | 方向性拖影、张力透视、流光残迹、碎片定格、冲击点形变 | 这些可见痕迹能说明当前边界瞬间，而不是暗示一段过程时 |
+| 特效体系（按题材选一系） | 仙侠剑气 / 水墨飞白；赛博能量束 / 霓虹光刃；魔法辉光 / 冰晶；火焰 / 金属火花 / 电弧 / 沙尘 | 已接受题材与视觉方向允许该体系时；不同体系不为热闹而混用 |
+| 层次与可读性 | 特效起点和受力点可辨、武器与肢体轮廓分离、粒子不遮住身份锚点、前后层特效有明确遮挡关系 | 当前帧确实存在特效遮挡或轮廓粘连风险时 |
+
+不要按“动作帧”类别固定追加“无肢体畸变、运动轨迹清晰”。前者只有在当前构图造成具体
+轮廓风险时才需要改写成可见约束；后者涉及时间变化，应交给视频运动规格。
+
+## 组合方法：选镜头类型，填主体
+
+1. 先按 [关键帧手艺](keyframe-craft.md) 写清谁、在哪、边界瞬间的姿态/目光/持物、构图、机位、
+   光线、连续性和排除项。这一步不碰本词表。
+2. 读取 `视觉设定.md` 的“项目视觉方向”。若基底仍只有名称或尚未决定，就在当前任务完成最小
+   Look Development 比较；选定结果直接写回该章节。
+3. 判断这一帧的类型：叙事关键帧 / 对话镜头 / 动作特效帧。类型由镜头目的决定，不由
+   “想要好看的特效”决定。
+4. 投影项目级画风的稳定项，再从对应镜头表挑当前需要的局部变化。可读性约束必须能指向
+   当前帧的具体风险；写不出风险就不加。
+5. 按“事实 → 视觉语言投影 → 可读性约束”的顺序写入 prompt，并译为项目声明的提示词语言。
+
+## 完整示例（合成改写）
+
+竖屏 9:16 漫剧，已接受视觉方向为“国风条漫：墨线粗细变化、分层设色、留白参与空间组织；
+暗调场景允许局部冷暖分区”。场：雨夜天台对峙，叙事关键帧。十二项事实按
+`keyframe-craft.md` 写满后，视觉投影与可读性约束这样接在事实之后：
+
+```text
+竖屏 9:16 中近景。机位在轴线左侧、平视略低约五度，标准焦段。前景是湿透的栏杆扶手
+（占下缘约六分之一）；中景两人对峙；背景是虚焦的城市灯斑与雨幕。三分构图，她落右三分线。
+她在栏杆内侧，双手握栏杆，身体朝向正前，视线落在对方胸口，无持物。人物乙站在她正前方
+约两步、略偏画面左，一手插袋，身体朝向她。光自画面右上高杆灯斜下为硬主光，左侧留暗。
+视觉重点在她握栏杆的双手。位置与持物与上一镜相同。
+视觉语言：国风条漫，墨线粗细分明，前中后景分层设色；暗调叙事，右上硬光形成局部冷暖分区。
+可读性约束：雨幕不遮住两人的面部识别点与她握栏杆的双手；栏杆、人物和城市背景层级分明。
+排除：不出现动作过程；不新增道具或可读文字。
+```
+
+事实段独立承担身份、地理和边界；视觉段改变这些事实如何被看见，可读性段保护雨夜构图里
+最容易丢失的信息。三者职责不同，因此不会用审美标签掩盖一条缺失的事实。
+
+## 反模式
+
+1. **项目级画风漂移**：同一项目临时从“赛璐璐动画帧”换到“厚涂漫画”，或只记名称、不记
+   可观察投影。项目基底应由创作者接受并写入 `视觉设定.md` 的“项目视觉方向”；单镜只使用
+   已允许的局部变化。
+2. **特效体系混用**：仙侠剑气与赛博能量束为热闹而同框。题材外的词再好看也不进本项目。
+3. **质量标签冒充事实**：用泛化分辨率、“电影级”或“大师杰作”顶替“谁在谁正前方约两步”。
+   分辨率属于制作配置，泛化质量标签不进入通用关键帧提示词。
+4. **万能排除清单**：每帧都带一长串防畸变禁词。约束只防当前帧的真实风险，否则正文被
+   补丁稀释（与 [production-shot-grammar.md](production-shot-grammar.md) 的反模式同源）。
+5. **把镜头类型写进正文**：“叙事关键帧、对话镜头”是选词入口，不是画面内容；正文不写
+   分类名、编号与状态词（`SHT-21`）。
+6. **词表当质量门槛**：审查时只因“没用词表词汇”打回。词汇被创作者接受进视觉方向之前，
+   它只是 `taste_option`。

package/lib/drama/skills/short-drama-storyboard/references/coverage-audition.md

@@ -22,18 +22,13 @@ Coverage audition 在正式 shots 前比较真正不同的导演方案，避免
 这些是比较方向，不是每场必须生成的套餐。若两项方案的观众知情时机、对齐对象、表演空间、
 最强画面和结尾落点都相同，它们仍是同一个方案。
 
-## 比较记录
+## 比较方式
 
-使用 `assets/coverage-audition.example.jsonl`，用真实的 screenplay-index `BLK-…` 记录绑定场次，
-并绑定已接受视觉方向、制作形态、Location/View 与参与资产；逐方案回答：观众何时知道什么、
+在上下文中用真实场景 ID 绑定当前剧本、项目视觉方向、制作形态、地点视图与参与资产；逐方案回答：
+观众何时知道什么、
 站在哪一边、谁拥有表演空间、最强画面与最终落点、可能丢失的空间/反应/信息、与制作形态是否
 相容。保留反对理由，不替创作者选择。
 
 不得固定四宫格、九宫格、二十五宫格或景别比例。宫格只是人工比较界面，不是镜头数量公式。
-audition 本体只保存方案与比较，**不把事后选择写回自身**。创作者选择与接受使用独立的
-`创作者决策/<artifact-id>.json`：它以 `decision_kind: artifact_acceptance` 指向当前 audition，并额外记录 `selected_audition_record_id` 与 `selected_approach_id`。
-这样选择不需要写回 audition 本体。
-
-正式 `scene_visual_plan` 同时绑定已接受的 `source_audition_ref` 与这份决定的
-`creator_selection_ref`，且只能投影 `selected_approach_id` 指向的方案。未选择时 audition 保持候选，
-不能据此发布正式 plan 或 shots。
+展示各方案的取舍后，由创作者选择；只把选中的观看位置、信息时机、空间与声音策略投影进正式
+`分镜.md`。未选择时所有方案都只是上下文候选，不能据此写正式镜头。

package/lib/drama/skills/short-drama-storyboard/references/keyframe-craft.md

@@ -81,10 +81,15 @@ composition, camera/lens, frame-only staging, and exclusions.
 排除：无动作过程，无雨丝拖影。
 ```
 
-`text_treatment_refs` must resolve to the asset owner's accepted text-policy
-field (or explicitly candidate policy in a provisional chain). A frozen frame
-may determine whether the surface is legible in this composition; it may not
-replace the source wording or policy with an untraceable prose instruction.
+Every visible entry the finished frame carries is listed in the shot's required
+`视觉依据` field, resolving to a real `视觉设定.md` entry; an `IMG-...` prompt item
+in `图片提示词.md` is a separate axis and does not stand in for it, and
+`视觉设定.md` itself does not define `IMG-...` IDs. Write that list from the
+finished frame, not from the shot's intent — the subject that gets missed is the
+one that entered the composition while the frame was being written. A frozen frame may determine whether the surface
+is legible in this composition; it may not replace the exact wording or policy
+with an untraceable prose instruction. If the policy is still undecided, say so
+instead of inventing a hidden candidate state.
 
 ## 尾帧：什么时候可以有，以及它换来什么代价（`SHT-17`）
 
@@ -122,11 +127,11 @@ from the boundary that frame declares. 首帧写进任何由运动或终点首
 
 Keyframe 默认是 shot start，不是“本镜最有戏的时刻”。为避免把 end 提前：
 
-1. 先冻结 `boundary_ref`（`boundary_role: start`），草拟 prompt 时暂不读 end/motion prose；
+1. 先明确本帧冻结 `SHOT-...` 的起点，草拟正文时暂不读终点与运动描述；
 2. 只填 start 已成立的 position/pose/gaze/hands/held props/visible state；
 3. 再与 end 做“新出现事实”差集；差集中的事实不得出现在 keyframe prompt；
-4. 渲染 Markdown 后从自然语言反向提取手位/持物/目光/可见状态，与
-   structured boundary 再比一次；不能只验 JSON 投影而忽略真正交付的 prompt。
+4. 写完 Markdown 后从自然语言反向提取手位、持物、目光和可见状态，与镜头起点再比一次；
+   不能只看条目说明而忽略真正交付的正文。
 
 反例：start 是“右手空置、看对方”，end 是“右手握铃绳、看门”。冻结帧写
 “手已握铃绳”即使很好看，也属于 boundary drift。

package/lib/drama/skills/short-drama-storyboard/references/production-shot-grammar.md

@@ -57,9 +57,21 @@
 | 一拍是爆发动作 | 若单镜过载，可按起势/接触/结果等力学阶段拆，切点绑定精确状态 |
 | 一拍是纯反应/沉默 | 只有承担反应或选择后果时独立成镜；停留由后果与节奏决定 |
 
-**建立镜头**是常见选择：新地点若观众尚不能定位人物、入口或冲突区域，
-用合适景别交代；若前镜已经建立地理，或上游有意让观众先迷失/延迟识别，就不为
-凑“第一镜全景”自增。任何新增镜头仍须解释它覆盖的内容与信息职责。
+**建立镜头要自己挣到位置**。新地点确实可能需要让观众定位人物、入口或冲突区域，但
+“先给一个空景全景说明这是哪儿”是长片的开场习惯：它把最前面的时间花在观众还没有理由
+在意的信息上。竖屏快节奏交付里默认反过来——**地理在动作内部到达**：人物已经在做的事、
+已经在说的话带出空间，观众边看边拼。这与剧本环节“在压力活跃处进入、用具体行动证明进入
+状态”的默认是同一条，不要在分镜层把它撤销。
+
+交代空间的镜头在这两种情况下成立：空间事实本身承担本镜因果（距离决定来不来得及、出口
+决定能不能走、谁站在门口决定谁看见了），或后续镜头的方位判断依赖它而动作本身给不出。
+成立时它也不必是空景全景——带着人物和动作的取景通常能一并完成，还省一个镜头。
+
+若前镜已经建立地理，或上游有意让观众先迷失/延迟识别，同样不为凑“第一镜全景”自增。
+任何新增镜头仍须解释它覆盖的内容与信息职责。
+
+**`craft_default`**：以上是快节奏竖屏短剧的默认取向。项目声明了不同的观看契约（长篇、
+剧场感、慢节奏、以空间为主角）时，创作者说明理由即可覆盖，审查者不得单据此阻断交付。
 
 ## 四、动作顺序交接（给视频提示词环节的输入）
 
@@ -67,12 +79,15 @@
 
 ```text
 起点：<已接受镜头边界，可静止也可在运动中>
-顺序：<上游动作> → <必要反应或注意力转移> → <已接受终点>
+唯一动作：<触发> → <主体完成一条可见状态转换；交接时写清接触与落点> → <必要反应>
+终点：<已接受镜头边界；逐项接住位置、双手、持物与可见状态>
 摄影意图：<固定/移动及其叙事职责>
 ```
 
 - 起点逐字段写入已接受的 `start_boundary`，不把静态关键帧的媒介性质改成“人物必须静止”；
 - 结束状态由分镜文件记录，下一镜通过引用比较，不靠复制长篇说明获得权威；
+- 「唯一动作」是本镜的主状态链，不是限制镜内只能发生一个原子动作；它把必要步骤放在同一条
+  因果线上，确保上一个可见状态确实走到下一个可见状态。
 - 并行槽只放有来源的变化：他人反应、环境压力或持续运动锚点可以
   帮助画面成立，但没有叙事/物理依据时宁可保持静止，不为满足配额发明微动态；
 - 只有已接受的时长或制作方案要求时才写秒数、角度或位移；它们是当前镜头选择，

package/lib/drama/skills/short-drama-storyboard/references/review-and-fixtures.md

@@ -1,70 +1,35 @@
-# 分镜诊断目录：可机器判定的那一部分
+# 分镜完成前检查
 
-## 目录
+这份清单只检查 `分镜.md` 能直接证明的结构事实，把审查注意力留给真正需要读懂戏的判断。
+检查发现问题就修正文档，不另建 coverage、QA 或校验结果文件。
 
-- [这份目录只收什么](#这份目录只收什么)
-- [诊断目录](#诊断目录)
-- [不进这份目录的东西](#不进这份目录的东西)
+## 可直接核对
 
-## 这份目录只收什么
+- 每个 `SHOT-...` ID 唯一，来源场景 ID 能在 `剧本.md` 找到；
+- 每个制作相关的动作、对白、VO/OS、SFX、画面文字与连续性要求都由镜头承载，或有明确创作理由；
+- 同一来源动作只有一个主要落实镜头，其他镜头只增加反应、细节或重新解释；
+- 每镜时长是正数，全剧时长等于可见镜头时长之和；目标时长只用于报告差值，不是质量门槛；
+- 起点和终点都写绝对事实，不使用“同上”“保持不变”代替；
+- 相邻镜头的站位、朝向、视线、持物、伤势、光态与可读文字连续；
+- 每镜都有「视觉依据」字段，条目名称能在《视觉设定.md》找到同名标题；关键帧正文点名的人物、地点、道具全部在列，「控制」不超过这一格画面承担得起的范围；
+- 已用的 `IMG-...` 必须是《图片提示词.md》的可见标题，并带中文名称和控制范围；没有合适条目时明写「无」，不伪造 ID；
+- 提示词条目与真实输入图片分开记录；只有创作者已提供或经确认生产、且当前可读的实际图片才能声称为「输入参考图」，并用独立稳定的 `REF-...` 槽位、显式顺序、仅用 `/` 分隔的项目相对路径、中文名称、用途、控制与不得控制范围定位；每个槽位的 `用途` 取自封闭词表，一镜最多一张起始帧与一张结束帧；一张都没有、只准备了一部分、全部就绪和创作者明确选择文生视频必须如实区分；
+- 冻结关键帧只投影所声明的边界：默认起点；外部工作流确实需要时才增加终点帧；
+- 可复制关键帧正文不含 ID、文件路径、工作流状态或工艺说明。
 
-本文只登记**不需要读懂戏就能判定**的分镜缺陷：时长账目的算术、关键帧声明的边界是否
-与它绑定的字段一致、边界条目有没有写成常见的回指说法、每条引用是否解析得到一个上游快照。它们由
-[storyboard_check.py](../scripts/storyboard_check.py) 执行，`enforcer` 一律是 `validator`。
-脚本读引用时先取文件的 `sources` 声明，再按每条引用的 `src` 取回 `owner` 与 `artifact`。
+结构检查失败时点名文件、场景或镜头 ID、冲突事实和负责 owner，不回显整段私有文本。
 
-分成脚本与审查两条路的理由很实际：账目类错误由人来核对既慢又不可靠——覆盖里少写一个
-镜头 ID，肉眼看过去和写全了完全一样。把这类工作交给脚本，审查者的注意力才能留给
-真正需要判断的东西。
+## 需要语义审查
 
-## 诊断目录
+下列问题不能靠字段数量或脚本替代：
 
-| code | classification | enforcer | 默认 severity | owner | 含义 |
-|---|---|---|---|---|---|
-| REF_SRC_IS_NOT_DECLARED | structural_invariant | validator | error | storyboard | 引用的 `src` 在本文件 `sources` 里没有声明 |
-| REF_HAS_NO_UPSTREAM_BINDING | structural_invariant | validator | error | storyboard | 引用既没有 `src`，也没有完整的 `owner`/`artifact` |
-| REF_IS_NOT_AN_OBJECT | structural_invariant | validator | error | storyboard | 引用位置上不是一个对象 |
-| SOURCE_ENTRY_IS_INCOMPLETE | structural_invariant | validator | error | storyboard | `sources` 条目缺少 `owner` 或 `artifact` |
-| SHT05_BOUNDARY_ENTRY_IS_A_BACK_REFERENCE | structural_invariant | validator | error | storyboard | 边界条目整条是「同上」「位置不变」这类回指，没有写出绝对事实 |
-| SHT16_RECORD_MISSING | structural_invariant | validator | error | storyboard | 覆盖记录没有 `episode_duration` |
-| SHT16_RECORD_INCOMPLETE | structural_invariant | validator | error | storyboard | `episode_duration` 缺少 `counted_shot_ids` 或 `unresolved_durations` |
-| SHT16_SHOT_LEFT_THE_TOTAL | structural_invariant | validator | error | storyboard | 覆盖列出的镜头既不计入总和也没被挂起 |
-| SHT16_SHOT_COUNTED_AND_UNRESOLVED | structural_invariant | validator | error | storyboard | 同一镜头既算进总和又列为未定 |
-| SHT16_SHOT_UNRESOLVABLE | structural_invariant | validator | error | storyboard | 时长记录点名的镜头不在镜头文件里 |
-| SHT16_COUNTED_SHOT_HAS_NO_DURATION | structural_invariant | validator | error | storyboard | 计入总和的镜头没有数值 `duration_seconds` |
-| SHT16_SUSPENDED_SHOT_HAS_A_DURATION | structural_invariant | validator | error | storyboard | 挂起为未定的镜头其实已有时长 |
-| SHT16_TOTAL_MISSING | structural_invariant | validator | error | storyboard | `shot_seconds_total` 不是数值 |
-| SHT16_TOTAL_IS_NOT_THE_SUM | structural_invariant | validator | error | storyboard | 总和不等于各计入镜头时长之和 |
-| SHT16_DELTA_MISSING | structural_invariant | validator | error | storyboard | 声明了目标却没有带符号差值 |
-| SHT16_DELTA_IS_WRONG | structural_invariant | validator | error | storyboard | 差值不等于总和减目标 |
-| SHT16_SHOT_LISTED_TWICE | structural_invariant | validator | error | storyboard | 同一镜头在时长记录里出现多次，会被加两次 |
-| SHT16_EPISODE_SHOT_LEFT_THE_TOTAL | structural_invariant | validator | error | storyboard | `shots.jsonl` 里的镜头既不计入总和也没被挂起 |
-| SHT16_DISPOSITION_MISSING | structural_invariant | validator | error | storyboard | 声明了目标却没有对差值的处置 |
-| SHT16_DISPOSITION_CLAIMS_A_TARGET | structural_invariant | validator | error | storyboard | 没有目标却给出了判断目标的处置 |
-| SHT17_KEYFRAME_HAS_NO_ID | structural_invariant | validator | error | storyboard | 关键帧记录没有 `keyframe_id` |
-| SHT17_BOUNDARY_ROLE_MISSING | structural_invariant | validator | error | storyboard | 关键帧没声明它冻结的是哪一端 |
-| SHT17_BOUNDARY_REF_MISSING | structural_invariant | validator | error | storyboard | 关键帧没有绑定它投影的边界 |
-| SHT17_BOUNDARY_REF_DISAGREES_WITH_ROLE | structural_invariant | validator | error | storyboard | 声明的角色与绑定的边界字段不一致 |
-| SHT17_BOUNDARY_REF_UNRESOLVABLE | structural_invariant | validator | error | storyboard | 关键帧绑定的镜头不在镜头文件里 |
-| SHT17_DUPLICATE_BOUNDARY_KEYFRAME | structural_invariant | validator | error | storyboard | 同一镜头的同一端有两张关键帧 |
-| SHT01_BLOCK_UNCLAIMED | structural_invariant | validator | error | storyboard | 处理为 `covered`/`intentional_repeat` 的块没有镜头认领 |
-| SHT01_BLOCK_CLAIMED_TWICE | structural_invariant | validator | error | storyboard | 非 `intentional_repeat` 的块被多个镜头认领 |
-| SHT01_BLOCK_IS_ON_SCREEN_ANYWAY | structural_invariant | validator | error | storyboard | 记为不拍的块却有镜头认领 |
-| SHT01_BLOCK_NOT_IN_SCREENPLAY | structural_invariant | validator | error | storyboard | 镜头认领的块不在剧本索引里 |
-| SHT01_BLOCK_HAS_NO_DISPOSITION | structural_invariant | validator | error | storyboard | 有制作相关的块没有写处理 |
-| SHT01_DISPOSITIONS_MISSING | structural_invariant | validator | error | storyboard | 覆盖表没有 `dispositions` |
-| SHT01_DISPOSITION_MALFORMED | structural_invariant | validator | error | storyboard | 处理行不是对象或没点名块 |
-| SHT01_DISPOSITION_UNKNOWN | structural_invariant | validator | error | storyboard | 处理不是工作流定义的四种之一 |
-| SHT01_DISPOSITION_REPEATED | structural_invariant | validator | error | storyboard | 同一个块写了多行处理 |
-| SHT01_DISPOSITION_NOT_IN_SCREENPLAY | structural_invariant | validator | error | storyboard | 处理点名的块不在剧本索引里 |
-| SHT01_DISPOSITION_HAS_NO_REASON | structural_invariant | validator | error | storyboard | 重复或省略是决定，必须写理由 |
-| SHT01_SCREENPLAY_IS_NOT_FULLY_INDEXED | structural_invariant | validator | error | storyboard | 剧本索引里还有没归类的行，覆盖检查看不到剧本的全部 |
+- 镜头是否守住来源原意和观众知情时机；
+- 重复覆盖是否真的增加新的反应、证据或理解；
+- 景别、机位、运动和切点是否由注意、压力、关系、空间或节奏变化驱动；
+- 多人调度是否让主要关系和注意交接可读；
+- 证据文字、决定性手部动作、脸与眼神是否会被遮挡；
+- 关键帧是否既可冻结，又保留镜头下一步需要发生的动作空间；
+- 画面里没有被名字点到、但仍需要认出身份的小比例或背景人物，是否也进了「视觉依据」——机械核对只抓被点名的那一类。
 
-## 不进这份目录的东西
-
-- **目标时长的差值本身**：`SHT-16` 只让脚本核对差值算得对不对。差值多大是创作者的判断，
-  目标时长是计划而不是质量门槛，脚本不因为差值大小报错。
-- **关键帧数量**：默认一张首帧，只在交付工作流真的消费尾帧时才有第二张。缺尾帧不是缺陷，
-  脚本也不检查"是否该有尾帧"。
-- **镜头拆得对不对、景别选得对不对、构图好不好**：这些需要读懂本场在做什么，属于审查者，
-  判据在本技能的工艺参考里，不在这份目录。
+关键帧数量、镜头数量、景别比例和目标时长差值都不是通用质量门槛。审查 finding 必须给出位置、
+证据、影响和必须达到的修订结果，不能只说“镜头不够电影感”或“看起来像 AI”。

package/lib/drama/skills/short-drama-storyboard/references/scene-visual-plan.md

@@ -1,39 +1,30 @@
 # 场次视觉戏剧计划
 
-`scene_visual_plan` 是项目级视觉方向与逐镜规格之间的可选中间层。它回答整场怎样改变观众的
-位置、空间压力、观看节奏和声音注意；它**不是第二份剧本**，也**不拥有镜头边界**。
+场次视觉计划是正式分镜前的可选思考层，回答整场怎样改变观众位置、空间压力、观看节奏和声音注意。
+它不是第二份剧本，也不拥有镜头边界。
 
-## 启用条件
+## 什么时候使用
 
-只在导演选择明显影响体验时使用：主要人物亮相、身份/证据揭示、关系反转、高潮/结尾、
-复杂多人调度、延迟信息的悬念场或承担视觉母题的场景。普通场景直接从原文落实进入 shots，
-不要把可选方法变成表单负担。
+只在导演选择明显影响体验时使用：主要人物亮相、身份/证据揭示、关系反转、高潮或结尾、复杂多人
+调度、延迟信息的悬念场、承担视觉母题的场景。普通场景直接写镜头，不增加表单。
 
-## 写法
+## 在上下文比较什么
 
-从 `assets/scene-visual-plan.example.jsonl` 建立一条候选。场次使用 screenplay-index 中真实的
-`BLK-…` heading/action 记录；再分别绑定已接受视觉方向、制作配置、Location/View 与涉及的
-CHAR/LOOK、PROP/PSTATE。只有创作者选过 audition 时才加 `source_audition_ref` 与独立的
-`creator_selection_ref`；没有 audition 时删除这两项，不能保留占位引用。先写：
+使用场景标题 ID，例如 `EP001-SC003`，并结合当前视觉设定比较：
 
-1. **戏剧转向**：本场哪一种公开关系、信息或选择不可逆地改变；
-2. **观众立场**：开场站在哪一方、结束被移到哪里；
+1. **戏剧转向**：哪一种公开关系、信息或选择不可逆地改变；
+2. **观众立场**：开场站在哪一方，结束被移到哪里；
 3. **空间压力**：入口、距离、占位、遮挡、让路或退路怎样承载人物策略；
 4. **视觉推进**：什么时候让信息、反应或空间先于特写落地；
 5. **摄影节奏**：固定、移动、切近和停留分别由什么变化触发；
 6. **反应落点**：结尾画面由谁的选择或空间后果承担；
-7. **声音策略**：主导声源、主动留白、距离变化、撤出/恢复和相邻场 sound bridge。
+7. **声音策略**：主导声源、主动留白、距离变化、撤出/恢复和 sound bridge。
 
-每次景别、机位或运动变化都应对应注意、关系、信息、压力或节奏变化。高潮不默认“主角特写
-+ 推镜”；场尾也不只是把最后一句对白拍完。
+只有真正不同的方案才比较；不固定方案数、宫格、景别或镜头数。选定后直接把结果投影进
+`分镜.md` 的镜头职责、景别/机位、起止边界与声音，不另存 audition、plan 或接受记录。
 
-## 接受与投影
+## 检查
 
-先向创作者展示转向、立场、空间、摄影、关键揭示、最终落点和声音运动。创作者接受后，正式
-shots 用准确 `scene_visual_plan_ref` 投影这条策略，并继续由每个 shot 自己拥有 purpose、
-duration、blocking 与 start/end boundary。计划与剧本或资产冲突时退回 owner，不让计划覆盖事实。
-
-审查时不按字段完整度打分，而看 audience alignment、knowledge、spatial access/pressure、rhythm
-中是否至少一项产生有意变化；有意保持同一观看位置也可以成立，但要说明它怎样制造观察、困住感
-或重新解释同构画面。再看空间和声音是否共同承担同一转向，以及逐镜变化是否只是重复
-中近景—反打—推镜。
+不按字段完整度打分。检查观众立场、知情时机、空间压力或节奏是否发生有意变化；有意保持同一观看
+位置也可以成立，但必须说明它怎样制造观察、困住感或重新解释同构画面。再检查空间、摄影和声音是否
+共同承担同一转向，而不是重复“中近景—反打—推镜”。

package/lib/drama/skills/short-drama-storyboard/references/screenplay-to-keyframe-example.md

@@ -53,17 +53,8 @@ A02（摊手与蓝线头）。
 - 构图：纵向双人中景，柜台横线分隔双方。
 - 摄影机：固定机位，让“不递”这个选择持续存在。
 
-来源：`shots.jsonl` 首行先声明本文件用到的上游快照——
-
-~~~json
-{"record_type": "sources", "schema_version": "1.0.0", "sources": {"screenplay-index": {"owner": "short-drama-write", "artifact": "剧集/EP004/screenplay-index.jsonl"}}}
-~~~
-
-镜头记录里的每条来源引用只写这个快照键和记录 ID：
-
-~~~json
-{"src": "screenplay-index", "record_id": "BLK-EP004-SC002-A01"}
-~~~
+来源：`剧本.md / EP004-SC002` 中“沈禾把拳压在台沿但不递牌”的动作和对应对白。正式镜头在
+`分镜.md` 直接写这个场景 ID 与必要短引文。
 
 若为了增加动作而让沈禾把取衣牌交出去，就改写了故事，必须拒绝这种改动。
 
@@ -104,6 +95,22 @@ A02（摊手与蓝线头）。
 冻结检查：所有事实能在同一时刻存在。摊开右手是 SHOT-02 的动作过程；KEY-03 只写
 “已经摊开”。
 
+## KEY-03 之后：从成稿画面回填三条依据
+
+关键帧写完才知道这一格里到底有谁、有什么。按成稿正文逐项读出来，再写进 SHOT-03 的字段：
+
+```markdown
+- 图片提示词项：IMG-SHENHE-SHEET《沈禾角色板》（控制：身份、手部特征）；IMG-CLAIM-TAG《取衣牌道具板》（控制：牌形、编号面、边缘磨损）
+- 输入参考图：无（待补参考图：沈禾手部、取衣牌背面、本镜起始帧）
+- 视觉依据：《视觉设定.md》·人物「沈禾」（控制：身份、右手特征）；人物「蒋姨」（控制：身份、视线方向）；道具「取衣牌」（控制：牌形、背面材质、蓝线头位置）；地点「社区洗衣房」（控制：柜台横线、冷白顶光）。
+```
+
+三处值得注意：
+
+- 蒋姨只在后景留一双模糊的眼睛，但观众要认出是她，所以她在列；
+- 牌正面的“17”本镜看不到，所以「控制」写的是「背面材质」而不是「编号面」；
+- 沈禾整身造型不在这一格里，所以不写「本集造型」——上一镜绑过不等于这一镜也该绑。
+
 ## 连续性交接
 
 | 字段 | SHOT-01 结束 | SHOT-02 开始与结束 | SHOT-03 开始 |
@@ -136,22 +143,13 @@ A02（摊手与蓝线头）。
 | 本镜表演状态 | 本技能 | 边界里可见的收敛：下颌收紧、身体不前倾、音量压在楼道回声之下 | 不把“压着嗓子”升级成“低吼”或“怒斥” |
 | 下游 `delivery` | 视频提示词 | 由同一条来源取到的语气，再落成呼吸、停顿和音量走向 | 不新起情绪词，也不与本镜表演状态相反 |
 
-两处引用同一条来源。各自文件先在 `sources` 里声明这份剧本索引的快照：
-
-~~~json
-{"screenplay-index": {"owner": "short-drama-write", "artifact": "剧集/EP002/screenplay-index.jsonl"}}
-~~~
-
-镜头记录与运动规格里的引用都写成：
-
-~~~json
-{"src": "screenplay-index", "record_id": "BLK-EP002-SC004-D01"}
-~~~
+两处引用同一条来源：`剧本.md / EP002-SC004 / 角色甲对白“你现在放回去……”`。分镜与视频提示词
+都保留这个场景 ID 与准确台词，不另造情绪来源。
 
 - 角色乙的 `（笑）` 同样同源投影：本镜写“嘴角上扬、眼睛不动、重心后靠”，下游写
   “句尾带气声的短笑”，两处解释的是同一条括注，不是两次独立发明。
 - 若下游认为该情绪不成立——例如楼梯间的回声让“压着嗓子”传不出信息——修订回到剧本：
-  编剧改括注并重新发布，本技能与视频提示词再各自重新投影一次。**不能**在镜头写
+  编剧改括注后，本技能与视频提示词再各自重新投影一次。**不能**在镜头写
   “克制”、在运动规格写“爆发”，让同一句台词挂着两个互相冲突的情绪来源。
 - 情绪来源只决定表演状态，不自动决定景别或运镜。`（压着嗓子）` 不等于必须切特写；
   本镜给什么景别，仍由观众此刻必须读到的信息决定。

package/lib/drama/skills/short-drama-storyboard/references/shot-craft.md

@@ -26,10 +26,8 @@
 连续表演和空间关系能守住原意时，几段原文可以合在一镜；揭示、反应、证据细节或空间
 变化很重要时，一段原文也可以由几镜承担。
 
-已接受的原文落实表要保存完整的 `shot_refs`，不能只写裸镜头 ID。文件的 `sources` 为每个
-上游快照声明一次负责人与准确文件，每条引用再用 `src` 指向这条声明并
-写上 `record_id`，这样才能知道审查的是哪一版。同一文件内部的关系可以用 `*_ids`；
-跨文件关系必须用 `*_refs`，以便来源改变后发现过期引用。
+原文落实直接写在 `分镜.md`：每个制作相关的动作、对白、声音和画面文字都指向承担它的
+`SHOT-...`；镜头条目反向写场景 ID 与必要短引文。来源改变后逐场复核对应镜头，不依赖隐藏引用。
 
 重复拍同一段内容，只有在第二次带来新的观众体验时才成立，例如新增反应、矛盾、
 此前保留的证据或对前镜的新理解；不能因为第一次对应关系被忘了就重复。
@@ -69,8 +67,8 @@
 
 ### 观众可见性 (`SHT-12`)
 
-构图同时决定观众此刻能知道什么。每个事实单独建立一条 `audience_visibility`：绑定准确
-的 `source_ref`，选择 `show_now` 或 `withhold_now`，写明可见或可听的载体，并分别写出
+构图同时决定观众此刻能知道什么。每个事实单独写一条观众可见性判断：绑定准确场景 ID，说明
+现在展示还是暂时扣住，写明可见或可听的载体，并分别写出
 揭示条件、保护方法和理由。同一镜中的不同事实可以在不同时间放出。
 
 背影、只露腿部的入场、门缝、前景遮挡、延迟对焦，以及**逆光成剪影或压暗到只剩轮廓**，
@@ -98,10 +96,10 @@
 跨轴本身不是错误；没有动机又让空间难以理解才是问题。跨轴时可以使用中性过渡镜头、
 人物在同一镜内穿轴、有意制造主观错乱，或重新建立空间。
 
-画面文字必须服从资产负责人确定的文字政策。镜头和关键帧通过 `text_treatment_refs`
-指向准确政策字段，可以决定文字是否可见、大小、角度和对焦，但不能静默编造文案，
-也不能改写 `exact_readable`、`graphic_only`、`no_readable_text` 或待定状态。候选预览只能
-引用候选政策，并且不能直接交付。
+画面文字必须服从 `视觉设定.md` 中已经写明的文字政策。镜头和关键帧直接引用对应标题或
+`IMG-...`，可以决定文字是否可见、大小、角度和对焦，但不能静默编造文案，也不能改写
+“逐字可读”“只保留图形”或“无可读文字”等当前决定。政策仍未决定时要明确标为未决，不能
+假装已经可以交付。
 
 ## 景别与摄影机动机
 

package/lib/drama/skills/short-drama-storyboard/references/shot-revision-identity.md

@@ -7,23 +7,19 @@
 
 - **重排**：只改变顺序，镜头目的与边界职责不变时保留原 ID；刷新依赖顺序与相邻边界。
 - **插入**：新增一个独立注意或戏剧职责时创建新 ID；不要给后续所有镜头重新编号。
-- **内容修订**：同一镜头目的下调整构图、blocking 或边界，保留 ID 并重新发布。
-- **拆分**：原镜头被两个或更多独立职责取代时，retire 旧 ID，为每个新镜头创建新 ID；记录
-  `revision_lineage`，不把旧 ID 偷给其中一个子镜头。
-- **合并**：多个旧镜头被一个新决定取代时，retire 全部旧 ID，创建新 ID，并记录来源集合。
-- **恢复**：retire 的 ID 不复用于无关镜头；需要恢复同一职责时用 lineage 显式说明。
+- **内容修订**：同一镜头目的下调整构图、blocking 或边界，保留 ID 并更新当前文档。
+- **拆分**：原镜头被两个或更多独立职责取代时，停用旧 ID，为每个新镜头创建新 ID；在修订说明中
+  写清前身，不把旧 ID 偷给其中一个子镜头。
+- **合并**：多个旧镜头被一个新决定取代时，停用全部旧 ID，创建新 ID，并列出来源集合。
+- **恢复**：停用的 ID 不复用于无关镜头；需要恢复同一职责时显式说明关系。
 
-普通新镜只需要稳定 `shot_id`；没有 predecessor 或 retired IDs 时省略 `revision_lineage`，
-不保存 `mode: new` 和空数组来重复本段规则。
-拆分、合并或恢复旧职责时，从
-[`revision-lineage.fragment.json`](../assets/revision-lineage.fragment.json) 插入统一结构；同一 shot 文件
-内的前身与 retired 关系使用稳定 ID，不伪造指向本文件自身的引用。
+普通新镜只需要稳定 `SHOT-...`。拆分、合并或恢复旧职责时，在 `分镜.md` 的修订说明中列出前身、
+后继与停用 ID；没有关系时不写空模板。
 
 ## 每次拆分、合并或重排后的对账
 
-重新核对 coverage 的每条 `shot_refs`、场次视觉计划投影、关键帧、motion、容器成员、相邻
-start/end boundary、总时长与审查记录。旧 ID 保留在 lineage / retire 记录中用于解释历史，
-不能继续被 active coverage 或交付容器引用。
+重新核对原文落实、场次视觉计划、关键帧、`MOTION-...`、多镜分组、相邻起止边界、总时长与审查
+结论。旧 ID 只在修订说明中解释历史，不能继续被当前镜头或交付分组引用。
 
 脚本可以检查引用、集合和算术；“是否仍是同一个导演决定”由 agent 根据镜头目的、信息变化、
 表演所有权和边界职责判断，不能用文本相似度或数组位置硬判。