@oh-story/dsh 0.1.3 → 0.1.4

package/lib/drama/skills/short-drama-storyboard/SKILL.md

@@ -1,264 +1,73 @@
 ---
 name: short-drama-storyboard
-description: 把已接受的中文短剧剧本和资产转成原文落实表、有戏剧动机的镜头、连续性边界与冻结关键帧提示词；关键场次可先做场次视觉计划或 Coverage Audition 比较真正不同的导演方案。用户提出“拆分镜/设计镜头/做镜头表”“场次视觉计划/调度故事板”“比较导演方案/Coverage Audition”“写首帧/关键帧提示词”“检查轴线、站位、视线、持物连续性”，或需要在不生成媒体的前提下把竖屏短剧、漫剧的剧本内容转成可拍的画面时使用。
+description: 把中文短剧剧本和视觉设定写成有戏剧职责、连续性边界与冻结关键帧提示词的分镜 Markdown。用户提出“拆分镜/设计镜头/做镜头表”“场次视觉计划/调度故事板”“比较导演方案”“写首帧/关键帧提示词”或检查轴线、站位、视线、持物连续性时使用；不生成媒体。
 license: MIT
 ---
 
 # 短剧分镜与冻结关键帧
 
-先守住故事内容，再安排原文落实、空间和镜头，最后写冻结关键帧。不在这里写随时间
-变化的运动提示词，也不改写剧本或资产事实。
-
-镜头目的、边界说明与场次视觉计划是创作者读的：项目内跟随 `short-drama.json#/language`，
-独立运行时跟随用户使用的语言。关键帧的**可复制提示词正文**在项目内跟随
-`#/format/prompt_language`，独立运行时由用户指定、未指定则为 `en`。不要用
-其中一个推断另一个。ID、规则编号和字段名在两者之下都保持原样。
+把剧本和视觉事实转成有镜头职责、空间连续性和可冻结起点的 `剧集/<EP>/分镜.md`。
+每镜使用二级标题 `## SHOT-...`，同镜下用 `### 冻结关键帧提示词` 写起始帧正文。
 
 ## Quick Start
 
-离线验证时长合计和关键帧边界绑定的正反例：
-
-```bash
-python3 {技能目录}/scripts/selftest.py
-python3 {技能目录}/scripts/storyboard_check.py <coverage.json> --shots <shots.jsonl> --keyframes <keyframes.jsonl>
+```text
+用 $short-drama-storyboard 完成 EP001 的正式分镜和每镜冻结关键帧
 ```
 
-## 开始前
-
-本技能可独立安装和执行。先读取用户明确提供的剧本、资产与本任务直接输入；若当前目录是
-`short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少 core
-或任何其他技能都不是分镜工作的阻断条件。[阶段契约](references/stage-contract.md) 给出
-本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
-
-## 按需读取资料
-
-始终读取：
-
-- 状态为 `accepted` 的 `screenplay.md` 与 `screenplay-index.jsonl`；
-- 状态为 `accepted` 的资产、版本与相关连续性；
-- `short-drama.json#/creator_authority/visual_direction` 中状态为 `accepted` 的视觉方向；
-  若状态为 `unset`，就向创作者给出选择，不从对话记忆补造。
-
-设计原文落实、场面调度、摄影机和剪切时读
-[shot-craft.md](references/shot-craft.md)；只有写冻结帧时读
-[keyframe-craft.md](references/keyframe-craft.md)。需要制作端的时长依据、景别与运镜
-词表或时间片写法时读 [production-shot-grammar.md](references/production-shot-grammar.md)。
-关键场次需要先组织整场的立场、空间、摄影与声音运动时读
-[scene-visual-plan.md](references/scene-visual-plan.md)；第一种合理拍法不应直接成为唯一答案时加读
-[coverage-audition.md](references/coverage-audition.md)。
-涉及背影、裁切、遮挡、画外或延迟揭示时读
-[阶段契约](references/stage-contract.md) 的参考媒体与补拍一节。
-只有所有权或直接输入影响不清楚时，才读核心所有权契约。
+## 入口
 
-- 竖屏多人、单房对白、证据揭示、群体轴线或门内外视角：
-  [blocking-playbooks.md](references/blocking-playbooks.md)
-- 需要查看“剧本 → 原文落实 → 镜头 → 关键帧”的完整正例，或对白表演括注
-  `（情绪）` 怎样同源投影到本镜表演状态与下游 `delivery`：
-  [screenplay-to-keyframe-example.md](references/screenplay-to-keyframe-example.md)
+当前剧本加必要视觉事实即可直接进入。资产图片提示词与分镜是兄弟分支，不互相等待。只有关键场次
+真的存在多个成立导演方案时，才在上下文比较覆盖方案；普通场次直接设计。
 
-## 每轮的工作单元
-
-一轮处理一个场次或一段连续镜头范围。整集请求按这些边界拆成若干轮，每轮：
-
-1. 只读这个范围的直接输入，做它的覆盖与镜头设计，跑本地结构检查；
-2. 落盘这个范围，其余范围保持原样；
-3. 报告已覆盖范围、剩余范围、未决 coverage 和下一个值得做的范围；
-4. 交还控制权，等创作者的下一次请求。
-
-视频提示词、生产和审查各自是独立的工作单元，由创作者明确请求时开始。
+创作者可读说明跟随项目语言；冻结关键帧的可复制正文跟随
+`short-drama.json#/format/prompt_language`。没有 `short-drama.json` 时正文默认使用 `en`。
 
 ## 工作流
 
-### 1. 先确认每段原文由谁落实
-
-从 [coverage-template.json](assets/coverage-template.json) 开始，接受后发布为
-`剧集/<EP>/storyboard/coverage.json`。每个与制作有关的剧本段落都必须标明一种处理：
-
-- `covered`：由一个或多个镜头落实；
-- `intentional_repeat`：因表演或剪辑需要而有意重复，并写明理由；
-- `omitted_with_reason`：有理由地省略；
-- `nonvisual_context`：仅供理解、无需直接呈现的内容。
-
-对白、动作、画面文字、画外音或关键音效还没有着落时，不要先追求漂亮镜头。
-发布原文落实表时，先在文件的 `sources` 里为每个上游快照声明一次 `owner` 与 `artifact`，再让每条 `shot_refs` 用 `src` 指向该声明并写上 `record_id`。裸 `shot_id`
-只可表示同一镜头文件内的关系，不能证明审的是哪一版。
-
-### 2. 关键场次先比较整场导演选择（可选）
-
-只有导演选择明显改变体验时才增加本层。若存在多种真正不同的观看方法，先用
-[coverage-audition.example.jsonl](assets/coverage-audition.example.jsonl) 比较信息时机、对齐对象、
-表演空间、最强画面、落点、损失和制作相容性；创作者选择后，再用
-[scene-visual-plan.example.jsonl](assets/scene-visual-plan.example.jsonl) 把所选方法写成整场的戏剧转向、
-观众立场、空间压力、视觉推进、摄影节奏、反应落点与声音策略。只有一个明确方法时直接写计划，
-不为流程完整补 audition。
-
-这层不新增剧本/资产事实，也不拥有 shot purpose、duration 或 start/end boundary。普通场景跳过；
-不固定方案数、宫格或镜头数。
-
-### 3. 先写镜头目的
-
-使用 [shot-template.jsonl](assets/shot-template.jsonl)，接受后发布为
-`剧集/<EP>/storyboard/shots.jsonl`。每个镜头先用一句话回答：
-
-- 观众此刻必须注意什么、感到什么；
-- 信息、情绪、观众立场或权力关系发生什么变化；
-- 为什么要在这里切镜，而不是留在前一镜。
-
-同时按事实填写 `audience_visibility`：准确来源、现在展示还是暂缓展示、可见或可听的
-载体，以及各自的 `reveal_trigger`（何时揭示）和 `protection_method`（怎样防止提前泄露）。
-遮挡不是默认的画面风格：它既不能提前泄露剧本保留的信息，也不能藏掉本镜必须交代的
-证据或反应。
-
-之后才选择景别和摄影机行为。镜头不是给动作段落加几个摄影形容词。
-若本场有已接受视觉计划，每镜用准确 `scene_visual_plan_ref` 说明自己投影其中哪一段变化；
-只在这类镜头记录中新增该字段。普通场景完全省略；计划与来源冲突时退回负责人，不靠 shot 覆盖。
-
-### 4. 绑定空间和资产
-
-绑定准确的场景及视角、人物及造型、道具及状态和剧本来源段落，并建立：
-
-- 位置、朝向、视线、屏幕运动方向与轴线；
-- 进出路线和不随镜头改变的场景锚点；
-- 双手与持物、伤势与服装、文字状态、光线方向；
-- 有权威性的镜头开始边界和结束边界。
-
-可见字样必须通过 `text_treatment_refs` 指向资产负责人已接受的文字政策。预览只能
-指向带 `authority: candidate` 的候选政策。镜头和关键帧可以决定构图怎样让文字可见，
-但不得把 `exact_readable` 偷换成装饰字、凭空写新文案，或用自由文本代替政策引用。
-
-需要的资产或状态缺失、含混时，向资产或编剧环节提出修订，不要猜绑定关系。
-若创作者要求从头到尾预览，只能针对唯一且不是 `unresolved` 的提案建立临时的原文落实、
-镜头和关键帧。候选引用要明确标为待确认，不得写成已接受的绑定，
-也不得获得最终批准。
-
-### 5. 设计能够制作的镜头
-
-短镜头通常围绕一个主要动作，再保留让观众读懂后果所需的反应；这不是镜头数量公式。
-一个镜头守不住空间关系、表演、对白或信息变化时就拆开；新切镜没有增加注意重点或
-戏剧价值时就合并。
-
-上游明确的事件先后也是故事事实，不是可以为省镜头而重排的素材。把相邻镜头的开始/结束
-边界顺读一遍：冻结首帧不得提前包含本镜随后才发生的认出、松手、决定或持物变化；合并镜头
-也只能压缩停留，不能让后发生的接收跑到前一个动作之前。
-
-时长表示剪辑意图。只有明确的计时算术可以机械检查；一般的可拍性必须结合本镜内容判断。
-
-写 `duration_seconds` 之前，先按项目在 `short-drama.json` 的 `format.pacing` 里声明的速率，
-把每个镜头认领的剧本块折算成秒——台词按字数、动作段按段数，这与 `duration_estimate.py` 在
-剧本阶段用的是同一组速率。折算值是起点，为节奏调整它是创作决定；跳过折算直接凭感觉写，
-整集总时长会到覆盖检查那一步才暴露，而那时要重排的是全部镜头。项目没有声明速率时先向
-创作者要一个量级。
-
-### 6. 默认每镜一个冻结关键帧
-
-使用 [keyframe-template.jsonl](assets/keyframe-template.jsonl) 写结构化来源，发布为
-`剧集/<EP>/storyboard/keyframes.jsonl`；再用
-[keyframe-prompts.md](assets/keyframe-prompts.md) 渲染可复制的派生文本。结构化关键帧
-保存只属于单帧的选择；Markdown 不是第二份事实来源。
-
-把已接受镜头的开始边界和准确资产版本，落到一个可以同时存在的瞬间：焦点、构图、
-摄影机与镜头焦段、空间锚点、姿态、目光、双手与持物、表情、光线、排除项。
-
-`generic_prompt` 写这一瞬间要拍出来的画面本身，按 `keyframe-craft.md` 的十二项逐条写满，
-那里有一段四百余字的成稿可以照着写。它只含要被拍出来的内容——不写镜头/记录 ID、规则 ID、
-状态词与成段否定罗列（`SHT-21`）。同一集里两条关键帧的正文不应该只有编号不同：
-读起来一样，说明写的是模板不是画面。
-
-关键帧不得包含“先、再、最后”、表演变化过程、运镜过程或正在变化的环境；时间变化
-交给 `$short-drama-video-prompts`。
-
-### 7. 校验并呈现
-
-先做原文落实、参考图权限和连续性的结构检查，再按制作资料自检。
-候选预览也必须精确加总逐镜数值时长；若仍有未定时长或尚未完成这笔账，宁可省略总时长并
-列出未决项，也不要写一个与镜头表不一致的约数。
-
-时长账目与关键帧边界这两项是纯记账，交给
-[storyboard_check.py](scripts/storyboard_check.py) 核对，不要用人工目测代替：
-
-```bash
-python3 <skill-dir>/scripts/storyboard_check.py 剧集/EP001/storyboard/coverage.json \
-  --shots 剧集/EP001/storyboard/shots.jsonl \
-  --keyframes 剧集/EP001/storyboard/keyframes.jsonl \
-  --screenplay-index 剧集/EP001/screenplay-index.jsonl \
-  --project short-drama.json
-```
-
-给了 `--screenplay-index` 就多做一项覆盖对账：**剧本的每一个块都要有一种处理，而镜头认领
-必须与那种处理相符**。`covered` 要恰好一个镜头认领，`intentional_repeat` 可以多于一个，
-`omitted_with_reason` 与 `nonvisual_context` 不应有镜头认领——后两种是"决定不拍"，
-写清理由即可。认领按块 ID 走（`source_refs` 里的 `record_id`），不按正文——正文一直在改，
-块 ID 不变。
-
-处理表本身也一起校验：状态必须是上面四种之一，一个块只能有一行，指向的块要在剧本索引里，
-`intentional_repeat` 与 `omitted_with_reason` 必须写理由。此前这张表没有任何检查，
-删掉几行、填一个不存在的状态、把 `shot_refs` 指向别的镜头都能通过——覆盖表与 `shots.jsonl`
-是关于同一件事的两份独立说法，中间没有对账。
-
-它只做算术和结构比对：本集时长总和是否等于各镜头 `duration_seconds` 之和、覆盖列出的
-镜头有没有既不计入也不挂起、`shots.jsonl` 里的镜头有没有整个从总和里消失、
-同一个镜头有没有在总和里被列两次（列两次就会被加两次）、有没有边界条目整条写成「同上」「位置不变」这类回指、
-每张关键帧是否声明了 `boundary_role` 并绑定对应边界字段、
-同一镜头的同一端有没有两张关键帧、每条引用的 `src` 能否在本文件 `sources` 里解析到一个
-上游快照。有 `--project` 且项目声明了每集目标时长时，还会核对
-带符号差值。**差值不是缺陷**，脚本只检查它算得对不对。
-
-脚本报错时先修产物再继续；它不评价镜头好坏，也不决定该拆多少镜。需要逐条查诊断码
-含义、或确认某项该由脚本判还是由审查者判时，读
-[review-and-fixtures.md](references/review-and-fixtures.md)。
-
-候选选择清单必须覆盖正文中全部新增导演选择；没有必要让创作者判断的环境微动、具体手位或
-声音时机就删除，不能一面写进可执行提示词，一面在接受摘要中省略。
-摘要按选择类别总括本场全部新增的观众立场/信息时机、代表帧/最强画面/场尾落点、
-机位/景别/运动与停留、时长/节奏、手势/目光/表演信号、声音进入/撤出/留白与视觉处理，
-并声明“正文中未由来源接受的执行选择仍全部保持候选”，
-不逐镜复述已经清楚标注的细节。只点名会改变信息时机、因果顺序、观众立场或表演所有权、
-可读文字、场尾落点、制作成本或回退路径的高影响例外；正文新增项若既不在类别范围内也未被点名，
-就删除或补入摘要。总括是接受范围，不会把正文选择悄悄升级为已接受事实。
-
-若创作者尚未声明交付面遮挡区，内容构图仍可作为候选比较，但播放面避让核验保持 `blocked`，
-整体不能称为 `delivery-ready`；该缺口必须出现在本次准备度摘要中。只列真正影响当前候选判断或
-请求交付范围的缺口，不要罗列与本次候选判断无关的正式发布先决条件。
-
-按顺序呈现：
-
-1. 尚未落实的原文与 `unresolved` 项；
-2. 按场分组的镜头表；
-3. 可复制的关键帧提示词；
-4. 相对剧本原意发生的差异；
-5. 需要创作者接受的选择。
-
-本技能不在本轮自动启动终审；需要 delivery verdict 时，把当前有界范围作为单独请求交给
-`$short-drama-review`。
+1. 确认每个场景动作、对白、声音、画面文字和转折由哪些镜头承载。
+2. 确定观众何时知道什么、对齐谁、空间如何揭示、转折落在哪个可见动作。
+3. 每镜写清唯一职责、来源、时长、景别/机位、起点、终点、声音和引用的 `IMG-...` 参考。
+4. 锁定人物朝向、位置、视线、持物、出入口、屏幕方向和必要状态。
+5. 冻结关键帧只投影镜头起点；删除终点才出现的文字、动作、姿态或道具状态。
+6. 整集请求完成整集，末端一次报告覆盖、节奏和真实未决选择。
+
+## 镜头要求
+
+- 每镜有唯一职责、明确来源、可见起止状态和合理时长。
+- 切镜必须带来信息、权力、情绪、空间或节奏变化；同义重复镜头删掉。
+- 同一动作不跨镜重复发生；终点应能成为下一镜可信起点。
+- 关键信息的可读性优先于装饰性运镜，竖屏构图优先保证主体和反应可见。
+- 复杂群戏先锁空间锚点和屏幕方向，再决定景别变化。
+- 冻结关键帧只写该瞬间能看见的内容；文字、手指、反射和遮挡要可生成。
+- 检查发现遗漏就直接修正文档，不生成覆盖表来证明自己检查过。
+
+## 按需知识
+
+默认只读本 SKILL、当前剧本和必要视觉事实。遇到对应问题时只打开一份：
+
+- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 镜头职责、切镜理由和边界：[镜头手艺](references/shot-craft.md)
+- 实际制作所需的镜头语法：[生产镜头语法](references/production-shot-grammar.md)
+- 关键场次比较导演方案：[场次视觉计划](references/scene-visual-plan.md)
+- 检查原文是否都有画面承载：[Coverage Audition](references/coverage-audition.md)
+- 多人、群体和复杂空间调度：[调度手册](references/blocking-playbooks.md)
+- 冻结瞬间、注意中心和可读性：[关键帧手艺](references/keyframe-craft.md)
+- 漫剧/二维漫画形态的共享画风词汇：[漫剧关键帧词表](references/comic-keyframe-lexicon.md)
+- 剧本事实到关键帧的完整示例：[剧本到关键帧](references/screenplay-to-keyframe-example.md)
+- 拆镜、并镜和稳定镜头 ID：[镜头修订身份](references/shot-revision-identity.md)
+- 完成前的连续性检查：[审查与示例](references/review-and-fixtures.md)
 
 ## 修订
 
-若运动提示词环节要求修改镜头开始或结束边界，负责人仍是本技能。对照剧本原意审查
-提议，修改当前有界范围的镜头与关键帧，并展示哪些旧产物已经关闭或需要刷新。运动提示词与
-终审属于后续的独立工作单元，本轮只报告它们的影响范围。
-运动提示词文件不得悄悄变成第二份边界事实。
-镜头重排、插入、拆分或合并时读取
-[shot-revision-identity.md](references/shot-revision-identity.md)，保留稳定身份、retire 被替代 ID，
-并重新对账 coverage 与全部下游引用；只在确有 predecessor/retirement 时新增
-`revision_lineage`，并使用 [按需 lineage 片段](assets/revision-lineage.fragment.json)；普通新镜不保存
-空 lineage。不用数组位置或文本相似度决定 ID。
+保留未受影响的镜头 ID。拆镜、并镜或改变镜头职责时，说明哪些下游视频提示词需要刷新，但不自动
+重写用户没点名的文件。
 
-## 边界
+## 完成
 
-- 不生成图片或视频。
-- 镜头绑定资产，不把完整外观描述复制到每一镜。
-- 外部制作单位不等于创作镜头本身的编号。
-- 镜头数量、每次切镜秒数、焦段分布都不是通用定律。
-- 新增或删除故事事实，必须先由编剧环节修订。
-- 创作者要求把已接受关键帧实际生成图片时，连同绑定和参考文件交给
-  `$short-drama-produce`；由生产技能展示任务预览并取得明确确认，本技能不调用媒体服务。
+点名范围的原文都有镜头落实，每镜职责不重复、空间与状态连续、起止边界可制作、关键帧可冻结，即
+完成。视频提示词、生产和审查只有用户点名时开始。
 
-## 所有产物
+## 安装维护
 
-- `剧集/<EP>/storyboard/coverage.json`
-- `剧集/<EP>/storyboard/coverage-auditions/<SC>.jsonl`（仅关键场次需要比较方案时；每场独立接受，项目工作历史，
-  默认不进执行交付包；accepted 后打包时显式传 `--omit`，不会按文件名静默排除）
-- `剧集/<EP>/storyboard/scene-visual-plans/<SC>.jsonl`（仅关键场次需要场次计划时；每场独立接受）
-- `剧集/<EP>/storyboard/shots.jsonl`
-- `剧集/<EP>/storyboard/keyframes.jsonl`
-- `剧集/<EP>/storyboard/keyframe-prompts.md`（仅派生文本）
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/lib/drama/skills/short-drama-storyboard/references/blocking-playbooks.md

@@ -43,42 +43,17 @@
   **不因为猜测的区域改变构图**——猜出来的避让同样是一个通用安全框，只是没写在纸上。
   需要时向创作者提一次问：这次交付的播放面会在画幅哪些位置叠加什么、是否常驻。
 
-声明由**创作者拥有**，落在 `short-drama.json` 的 `/creator_authority/delivery_surface`，
-与视觉方向、制作形态同级。它要能回答三件事——**占用哪里、是否常驻、依据来自哪**：
-
-```json
-{
-  "status": "unset | declared",
-  "aspect": "<已接受画幅>",
-  "overlay_regions": [
-    {
-      "id": "<稳定 ID>",
-      "where": "<用画幅比例或可命名边带描述的占用范围>",
-      "permanence": "persistent | intermittent | conditional",
-      "carries": "<字幕 | 控件 | 角标 | 其他>"
-    }
-  ],
-  "source_ref": {
-    "src": "creator-decision",
-    "record_id": "<接受该声明的决定记录>"
-  }
-}
-```
-
-`creator-decision` 是 `short-drama.json` 的 `sources` 为那份创作者决定声明的快照键：
-
-```json
-{"creator-decision": {"owner": "creator", "artifact": "创作者决策/<artifact-id>.json"}}
-```
+声明由**创作者拥有**，写在 `视觉设定.md` 的“交付面”章节，与项目视觉方向和制作形态并列。
+它回答三件事：**占用哪里、是否常驻、依据来自哪**。每个区域使用稳定 ID，并写：
 
-镜头与关键帧记录用 `delivery_surface_ref` 绑定该声明的**精确快照与字段**（模板已有该字段，
-指向 `short-drama.json#/creator_authority/delivery_surface`）。创作者改版后引用变
-`stale`，受影响的镜头与关键帧按恢复流程重新核对，不沿用上一版的避让结论。
+- 当前画幅；
+- 用画幅比例或可命名边带描述的占用范围；
+- 常驻、间歇或条件出现；
+- 承载字幕、控件、角标还是其他内容；
+- 创作者提供的平台模板、截图或文字说明。
 
-`status` 为 `unset` 时本规则不生效：镜头照常按画面可读性构图，把它记为待创作者决定。
-声明自身不引用自己所在的文件。
-- **已声明时绑定版本**：镜头与关键帧引用该声明的具体版本；交付方案改版时，受影响的镜头
-  按 `stale` 处理并重新核对，而不是沿用上一版的避让结论。
+没有声明时本规则不生效：镜头照常按画面本身的可读性构图，把问题留为待创作者决定。已经声明时，
+受影响镜头在 `分镜.md` 指名交付面区域 ID；交付方案改版后重新核对，不沿用上一版避让结论。
 已声明遮挡区后，按下面的优先级判断哪些内容必须挪开：
 
 - **可读文字最敏感**：证据类道具上必须被读出的字，一旦落在字幕条位置，观众永远读不到。

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,11 @@ 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.
+The keyframe must name the matching text policy or `IMG-...` entry in
+`视觉设定.md` / `图片提示词.md`. 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 +123,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。