@oh-story/dsh 0.1.0

package/lib/drama/skills/short-drama-storyboard/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "短剧分镜"
+  short_description: "把剧本与资产拆成完整coverage、有动机镜头和冻结关键帧"
+  default_prompt: "使用 $short-drama-storyboard 把已接受剧本和资产拆成有动机的镜头与冻结关键帧提示词。"

package/lib/drama/skills/short-drama-storyboard/assets/coverage-audition.example.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"<characters-or-props>":{"owner":"short-drama-assets","artifact":"设定集/<characters-or-props>.jsonl"},"<looks-or-prop-states>":{"owner":"short-drama-assets","artifact":"设定集/<looks-or-prop-states>.jsonl"},"location-views":{"owner":"short-drama-assets","artifact":"设定集/location-views.jsonl"},"locations":{"owner":"short-drama-assets","artifact":"设定集/locations.jsonl"},"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay-index.jsonl"},"short-drama":{"owner":"creator","artifact":"short-drama.json"}}}
+{"example_only":true,"audition_id":"AUD-EP001-SC001","status":"candidate","scene_ref":{"src":"screenplay-index","record_id":"BLK-EP001-SC001-H01","field":"/scene_id"},"visual_direction_ref":{"src":"short-drama","field":"/creator_authority/visual_direction"},"production_profile_ref":{"src":"short-drama","field":"/creator_authority/production_profile"},"location_binding":{"identity_ref":{"src":"locations","record_id":"LOC-<id>"},"variant_ref":{"src":"location-views","record_id":"VIEW-<id>"}},"asset_bindings":[{"identity_ref":{"src":"<characters-or-props>","record_id":"CHAR/PROP-<id>"},"variant_ref":{"src":"<looks-or-prop-states>","record_id":"LOOK/PSTATE-<id>"},"role":"<performance_owner/evidence/observer>"}],"reason_for_audition":"<为什么导演选择会显著改变体验>","approaches":[{"approach_id":"APPROACH-A","directing_hypothesis":"<表演/证据/主观/空间/声音等真正不同的命题>","audience_knowledge":"<何时知道什么>","audience_alignment":"<站在哪个人物一边>","performance_space":"<谁拥有主要表演通道，谁只承担差异化反应>","strongest_image":"<最强画面>","landing":"<最终落点>","tradeoffs":{"preserves":["<保住什么>"],"risks_losing":["<可能丢什么>"],"production_fit":"<与已接受制作形态怎样相容或冲突>"}}],"comparison_summary":"<真正分歧与不可同时获得的收益>"}

package/lib/drama/skills/short-drama-storyboard/assets/coverage-template.json

@@ -0,0 +1,49 @@
+{
+  "sources": {
+    "shots": {
+      "owner": "short-drama-storyboard",
+      "artifact": "剧集/EP001/storyboard/shots.jsonl"
+    },
+    "screenplay-index": {
+      "owner": "short-drama-write",
+      "artifact": "剧集/EP001/screenplay-index.jsonl"
+    },
+    "short-drama": {
+      "owner": "short-drama",
+      "artifact": "short-drama.json"
+    }
+  },
+  "episode_id": "EP001",
+  "dispositions": [
+    {
+      "block_id": "BLK-EXAMPLE",
+      "status": "covered",
+      "reason": "Primary action and reaction remain continuous.",
+      "shot_refs": [
+        {
+          "src": "shots",
+          "record_id": "SHOT-EXAMPLE",
+          "authority": "candidate"
+        }
+      ]
+    }
+  ],
+  "episode_duration": {
+    "shot_seconds_total": null,
+    "counted_shot_ids": [
+      "SHOT-EXAMPLE"
+    ],
+    "unresolved_durations": [],
+    "target_ref": {
+      "src": "short-drama",
+      "field": "/format/target_seconds_per_episode"
+    },
+    "target_seconds": null,
+    "delta_seconds": null,
+    "disposition": "no_target_declared | within_creator_tolerance | creator_accepted_overrun | to_revise"
+  },
+  "screenplay_ref": {
+    "src": "screenplay-index"
+  },
+  "status": "candidate"
+}

package/lib/drama/skills/short-drama-storyboard/assets/keyframe-prompts.md

@@ -0,0 +1,32 @@
+# `keyframe-prompts.md` 可复制输出模板
+
+这是由已接受的 `keyframes.jsonl` 生成的文本，不是镜头边界或资产事实来源。
+每次导出都记下配方版本；文本被手改时，先预览恢复、
+采用或合并的结果。
+
+```markdown
+# EP<编号> · 冻结关键帧提示词
+
+> 来源：`keyframes.jsonl` 的已接受记录
+> 配方：`keyframe-generic@<version>`
+> 范围：单一静止瞬间；不生成图片，不写时间动作
+
+## `SHOT-<id>` · `KEY-<id>`
+
+- **镜头目的**：<观众此刻必须看见什么>
+- **观众可见性**：逐项列出 `<来源 · 展示或暂缓 · 声画载体 · 揭示条件 · 保护方法>`
+- **边界来源**：`SHOT-<id>/start_boundary`
+- **资产绑定**：`<准确人物与造型 · 地点与观察视角 · 道具与状态>`
+- **文字处理**：`<已接受的来源文字政策 -> 本帧呈现方法>`
+
+### 可复制通用提示词
+
+> <焦点主体与识别锚点>。<构图层级、人物/道具/空间锚点关系>。摄影机<景别、角度、镜头意图>。
+> <一个可冻结的身体朝向、姿态、目光、双手、持物与可见表演状态>。<继承的光向、时段、天气与必要气氛>。
+> <文字处理>。保持<边界与身份事实>；排除<本帧高风险漂移>。
+
+---
+```
+
+若一句话必须靠“先、再、随后、最终”才能成立，就交给运动提示词环节；若要改变镜头
+开始边界，先向分镜负责人提出修订请求，不要在派生文本中偷偷改。

package/lib/drama/skills/short-drama-storyboard/assets/keyframe-template.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"<identity-owner-file>":{"owner":"short-drama-assets","artifact":"设定集/<identity-owner-file>.jsonl"},"<variant-owner-file>":{"owner":"short-drama-assets","artifact":"设定集/<variant-owner-file>.jsonl"},"location-views":{"owner":"short-drama-assets","artifact":"设定集/location-views.jsonl"},"props":{"owner":"short-drama-assets","artifact":"设定集/props.jsonl"},"short-drama":{"owner":"short-drama","artifact":"short-drama.json"},"shots":{"owner":"short-drama-storyboard","artifact":"剧集/<EP>/storyboard/shots.jsonl"}}}
+{"keyframe_id":"KEY-EXAMPLE","status":"candidate","shot_ref":{"src":"shots","record_id":"SHOT-EXAMPLE","authority":"candidate"},"boundary_role":"start | end","boundary_ref":{"src":"shots","record_id":"SHOT-EXAMPLE","field":"/start_boundary | /end_boundary","authority":"candidate"},"purpose":"<frozen viewing purpose>","asset_bindings":[{"identity_ref":{"src":"<identity-owner-file>","record_id":"CHAR/LOC/PROP-<id>"},"variant_ref":{"src":"<variant-owner-file>","record_id":"LOOK/VIEW/PSTATE-<id>"}}],"focal_subjects":[],"composition":{"hierarchy":[],"spatial_relations":[],"foreground":[],"background":[]},"delivery_surface_ref":{"src":"short-drama","field":"/creator_authority/delivery_surface"},"camera":{"framing":"<shot-owned projection>","angle":"<shot-owned projection>","camera_height":"<shot-owned projection>","lens_intent":"<广/标准/长 — frame-only choice; the compression wanted, not a focal length>"},"boundary_projection":{"positions":[],"facing":[],"pose_balance":[],"gaze":[],"hands":[],"held_props":[],"visible_state":[]},"light_projection":{"source_ref":{"src":"location-views","record_id":"VIEW-<id>","field":"/state_differences/light"},"direction":"<direction>","frame_relevant_detail":"<minimal>"},"text_treatment_refs":[{"src":"props","record_id":"PROP-<id>","field":"/text_policy"}],"exclusions":[],"generic_prompt":"<这一瞬间要拍出来的画面：谁在哪、彼此距离、前中后景、视线落点、构图与景别、机位side/俯仰/焦段意图、光从哪来什么质感、每个在场者的姿态朝向手部持物、与上一镜相同的部分写一句「与上一镜相同」、排除项；不写镜头/记录 ID、规则 ID、状态词与成段否定罗列；写满的样子见 references/keyframe-craft.md>","derivation":{"recipe_version":"<version>"}}

package/lib/drama/skills/short-drama-storyboard/assets/revision-lineage.fragment.json

@@ -0,0 +1,12 @@
+{
+  "revision_lineage": {
+    "change": "split | merge | restore",
+    "predecessor_shot_ids": [
+      "SHOT-<same-file-prior-id>"
+    ],
+    "retired_shot_ids": [
+      "SHOT-<same-file-retired-id>"
+    ],
+    "reason": "<导演职责怎样被拆开、合并或恢复>"
+  }
+}

package/lib/drama/skills/short-drama-storyboard/assets/scene-visual-plan.example.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"<characters-or-props>":{"owner":"short-drama-assets","artifact":"设定集/<characters-or-props>.jsonl"},"<looks-or-prop-states>":{"owner":"short-drama-assets","artifact":"设定集/<looks-or-prop-states>.jsonl"},"coverage-audition":{"owner":"short-drama-storyboard","artifact":"剧集/EP001/storyboard/coverage-auditions/SC001.jsonl"},"creator-decision":{"owner":"creator","artifact":"创作者决策/EP001-coverage-audition-SC001.json"},"location-views":{"owner":"short-drama-assets","artifact":"设定集/location-views.jsonl"},"locations":{"owner":"short-drama-assets","artifact":"设定集/locations.jsonl"},"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay-index.jsonl"},"short-drama":{"owner":"creator","artifact":"short-drama.json"}}}
+{"example_only":true,"plan_id":"SVP-EP001-SC001","status":"candidate","scene_ref":{"src":"screenplay-index","record_id":"BLK-EP001-SC001-H01","field":"/scene_id"},"source_block_refs":[{"src":"screenplay-index","record_id":"BLK-EP001-SC001-A01"}],"visual_direction_ref":{"src":"short-drama","field":"/creator_authority/visual_direction"},"production_profile_ref":{"src":"short-drama","field":"/creator_authority/production_profile"},"location_binding":{"identity_ref":{"src":"locations","record_id":"LOC-<id>"},"variant_ref":{"src":"location-views","record_id":"VIEW-<id>"}},"asset_bindings":[{"identity_ref":{"src":"<characters-or-props>","record_id":"CHAR/PROP-<id>"},"variant_ref":{"src":"<looks-or-prop-states>","record_id":"LOOK/PSTATE-<id>"},"role":"<performance_owner/evidence/observer>"}],"source_audition_ref":{"src":"coverage-audition","record_id":"AUD-EP001-SC001"},"creator_selection_ref":{"src":"creator-decision","record_id":"CD-EP001-COVERAGE-AUDITION-SC001","field":"/selected_approach_id"},"dramatic_turn":"<本场不可逆的关系/信息/选择变化>","audience_alignment":{"start":"<开场站在哪一方或保持什么距离>","end":"<结束被移到哪里>"},"spatial_pressure":"<入口、距离、占位、遮挡、让路或退路怎样承载人物策略>","visual_progression":["<按注意、关系、信息、压力或节奏写推进，不预写 shot 数量>"],"camera_strategy":"<何时固定、移动、切近或停留，以及触发原因>","reveal_image":"<关键揭示怎样进入画面且服从信息权限>","reaction_landing":"<谁的选择、反应或空间后果承担结尾>","sound_strategy":{"opening_attention":"<先听见什么>","power_or_space_sound":"<代表当前空间/权力的声源>","withdrawal_or_silence":"<何时撤出/留白及对象>","return_or_distance_change":"<何时恢复或改变距离>","sound_bridge":"<与相邻场怎样连接或 none>"},"constraints":["<必须保持的剧本、资产与视觉方向事实>"],"creator_overrides":[]}

package/lib/drama/skills/short-drama-storyboard/assets/shot-template.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"<characters-or-props>":{"owner":"short-drama-assets","artifact":"设定集/<characters-or-props>.jsonl"},"<looks-or-prop-states>":{"owner":"short-drama-assets","artifact":"设定集/<looks-or-prop-states>.jsonl"},"location-views":{"owner":"short-drama-assets","artifact":"设定集/location-views.jsonl"},"locations":{"owner":"short-drama-assets","artifact":"设定集/locations.jsonl"},"props":{"owner":"short-drama-assets","artifact":"设定集/props.jsonl"},"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/<EP>/screenplay-index.jsonl"},"short-drama":{"owner":"short-drama","artifact":"short-drama.json"}}}
+{"shot_id":"SHOT-EXAMPLE","status":"candidate","source_refs":[{"src":"screenplay-index","record_id":"BLK-EXAMPLE"}],"coverage_role":"primary | intentional_repeat","purpose":"<what the audience must notice and why this is a new shot>","information_change":"<before -> after for audience/character>","audience_visibility":[{"source_ref":{"src":"screenplay-index","record_id":"BLK-<id>"},"fact":"<本镜必须展示或暂缓的一个事实>","permission":"show_now | withhold_now","carrier":"<可见/可听载体；暂未出现则写 none>","reveal_trigger":"<允许释放的动作/台词/cut；不在本镜则写 future>","protection_method":"<framing/crop/occlusion/offscreen/focus/timing/none，可组合说明>","rationale":"<与 source 信息权限和本镜职责的关系>"}],"location_binding":{"identity_ref":{"src":"locations","record_id":"LOC-<id>"},"variant_ref":{"src":"location-views","record_id":"VIEW-<id>"}},"asset_bindings":[{"identity_ref":{"src":"<characters-or-props>","record_id":"CHAR/PROP-<id>"},"variant_ref":{"src":"<looks-or-prop-states>","record_id":"LOOK/PSTATE-<id>"},"role":"<subject/evidence/background>"}],"duration_seconds":null,"start_boundary":{"positions":["<每条都写成不读上一镜也能理解的绝对事实：谁在哪个锚点的哪一侧；『同上』『位置不变』『同前』要往回翻才解释得通，不算已写>"],"facing":[],"gaze":[],"hands":[],"held_props":[],"visible_state":[]},"end_boundary":{"positions":["<同样是绝对事实：本镜结束时人在哪、朝哪，不写成与开始状态的差异>"],"facing":[],"gaze":[],"hands":[],"held_props":[],"visible_state":[]},"framing":{"size":"<extreme_wide 远景/wide 全景/medium 中景/medium_close 中近景/close 近景/close_up 特写/extreme_close_up 大特写/detail 细节镜头 or creator vocabulary>","angle":"<horizontal: 正面/斜侧/正侧/后斜侧/背面 or creator vocabulary; say which side of the axis>","camera_height":"<地平/低(仰)/平视/高(俯)/顶视; 平视 is a choice, not an unset field>","aspect_notes":"<composition constraint>"},"delivery_surface_ref":{"src":"short-drama","field":"/creator_authority/delivery_surface"},"blocking":{"axis":"<working side/bridge/deliberate break>","screen_direction":"<direction>","paths":[],"fixed_anchors":[]},"camera_plan":{"behavior":"locked | pan | tilt | push | pull | track | follow | orbit | crane | handheld | transition","motivation":"<attention/pressure/alignment/reveal/rhythm>","intervals":[]},"dialogue_audio_refs":[],"text_treatment_refs":[{"src":"props","record_id":"PROP-<id>","field":"/text_policy"}],"transition_intent":null,"creator_overrides":[]}

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

@@ -0,0 +1,241 @@
+# 常见场面的分镜方法：竖屏、单房、证据与群体轴线
+
+## 目录
+
+- [竖屏多人](#1-竖屏多人调度)
+- [单房对白](#2-单房对白)
+- [证据揭示](#3-证据揭示)
+- [群体与轴线](#4-群体与轴线)
+- [动态对象与竞赛](#5-动态对象与竞赛)
+- [观察视角与边界](#6-观察视角与边界)
+- [规则分级](#7-规则分级)
+
+先使用镜头设计资料中的原文落实、镜头目的和场景地理方法。只有遇到下列场面时才读
+本文；这些是思考步骤，不是镜头数量模板。
+
+## 1. 竖屏多人调度
+
+竖屏不是把所有人排成上下两层。先画出人物能怎样通行，再决定纵向画幅怎样表现关系与权力：
+
+- 用前景、中景、后景、门框、台阶和桌沿建立深度。
+- 明确谁能接近证据、出口或权力座位。
+- 头像高低只在空间真实且有意义时表达地位。
+- 两人对话时，仍要保留第三人的监听、反应或阻挡位置。
+- 先保证进出方向和视线连续，再用近景强化选择。
+
+可以按以下顺序设计：空间锚点与入口 → 每人的行动目标和筹码 → 群体注意中心 →
+关键动作前后的站位 → 哪些同时反应必须留在全景中 → 只有丢失信息时才切插入镜头或近景。
+
+常见问题：每句台词都切一个头像近景；站位只为填满画面；背景人物在切镜后无原因换边；
+重要人物一直被前景遮住，但剧情并未利用这种遮挡。
+
+### 交付面遮挡 (`SHT-15`)
+
+竖屏画面在播放时通常不是完整可见的：播放界面会在画幅上叠一层东西——字幕条、播放控件、
+进度条、侧边的互动控件、片头片尾的角标。**画幅是满的，可读区不是**。 这与拍摄无关，
+是交付面的事实，所以它约束的是构图决定，而不是画面内容。
+
+**`reviewed_invariant`**：当创作者已声明交付面的遮挡区时，本镜必须被读到的内容（脸与
+眼神、证据上的可读文字、决定性的手部动作）不能只落在这些区域里。遮挡区、是否常驻及其
+来源引用都取自已接受的交付方案；**没有声明就没有这条约束**。
+
+- **未声明时保持未解决，不要猜**。 记为待创作者决定，照常按画面本身的可读性构图，
+  **不因为猜测的区域改变构图**——猜出来的避让同样是一个通用安全框，只是没写在纸上。
+  需要时向创作者提一次问：这次交付的播放面会在画幅哪些位置叠加什么、是否常驻。
+
+声明由**创作者拥有**，落在 `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"}}
+```
+
+镜头与关键帧记录用 `delivery_surface_ref` 绑定该声明的**精确快照与字段**（模板已有该字段，
+指向 `short-drama.json#/creator_authority/delivery_surface`）。创作者改版后引用变
+`stale`，受影响的镜头与关键帧按恢复流程重新核对，不沿用上一版的避让结论。
+
+`status` 为 `unset` 时本规则不生效：镜头照常按画面可读性构图，把它记为待创作者决定。
+声明自身不引用自己所在的文件。
+- **已声明时绑定版本**：镜头与关键帧引用该声明的具体版本；交付方案改版时，受影响的镜头
+  按 `stale` 处理并重新核对，而不是沿用上一版的避让结论。
+已声明遮挡区后，按下面的优先级判断哪些内容必须挪开：
+
+- **可读文字最敏感**：证据类道具上必须被读出的字，一旦落在字幕条位置，观众永远读不到。
+  这类镜头要么把文字挪到中部可读区，要么改用更近的景别单独给一次。
+- **脸与眼神次之**：竖屏习惯把人物放得很高，容易压到顶部角标区；也不宜为了避让而把人
+  一律推到正中，那会让全片构图变平。判断依据是"这一镜要被读到的是什么"，不是固定安全框。
+- **一侧的互动控件**是竖屏特有的：如果本镜的关键动作发生在被占用的那一侧，把动作调到
+  另一侧，或用镜像的机位关系解决——不要靠缩小主体来避让，那会同时削弱表演。
+- **不要把避让写成通用禁区**。它是本项目交付方案下的构图约束；换交付面就要重新确认，
+  也不能反过来要求剧本改动作发生的位置。
+
+失效方式是安静的：单帧看构图很好，只有放到实际播放面上才发现关键信息被压住，而这时
+关键帧与视频提示词都已经做完了。所以这个判断属于分镜阶段，不属于交付前检查。
+
+## 1b. 轴线、屏幕方向与正反打
+
+### 左右的唯一读法
+
+**`structural_invariant`**：本套件所有产物里，**裸写的"左/右"一律指画面左右**（观众看到的
+左右）。指人物自身的左右时必须带主体——"他的左手""她的右肩"。两种读法混用是正反打
+最常见的失效来源，因为单看每一句都成立。
+
+- ✅ `沈一舟站在画面左三分之一处，赵经理占画面右侧`
+- ✅ `秘书把工牌递到他的右手边`（带主体，指人物右手）
+- ❌ `秘书从右侧接近`（谁的右？下游只能猜）
+
+### 轴线怎么记
+
+轴线不是一个形容词，是**两个可命名锚点的连线**。记法要落成可比较的断言，让下一镜能
+逐字核对：
+
+```text
+轴线：沈一舟 ↔ 赵经理（两人连线）
+working side：摄影机常驻红毯一侧
+屏幕方向：沈一舟固定占画面左，赵经理固定占画面右
+```
+
+写成 `<working side>` 这类占位等于没写。判据是：换一个人来拍下一镜，他能不能只读这
+三行就把机位放对。
+
+### 正反打的配对规则
+
+- **屏幕方向必须互补**：A 镜里甲在画面左看向右，B 镜里乙就必须在画面右看向左。两镜
+  人物都望向同一侧时，观众读到的不是对话，是两人在看同一个画外的第三者。
+- **视线高度按实际身高差匹配**：一方明显高时，A 镜的俯角与 B 镜的仰角要对应；两镜都
+  平视会把身高差抹平，也会让"逼近"失去压迫感。
+- **过肩镜写明前景是谁的肩、占画多少**：只写"过肩"不够，前景肩的归属决定了这一镜属于
+  谁的视角。
+- **A/B 两镜是否对称是主动选择**：机位高度与景别对称表示势均力敌，不对称表示权力倾斜。
+  选了不对称就写清理由，别让它变成随手的结果。
+
+### 越轴之后要重新记账
+
+越轴的合法手段见本文上一节。但越完之后，**新的 working side 必须重新声明并被后续镜头
+继承**——否则后面每一镜都在各自猜轴线在哪。越轴那一镜本身也要标明它是越轴，而不是让
+下游从方向矛盾里反推。
+
+## 2. 单房对白
+
+单房戏的运动来自人物策略、物件和注意变化，不来自无理由走动。先画出会造成压力的
+空间关系：
+
+- 出口、座位、桌面或证物、电话或电梯的声源。
+- 谁先占据或控制哪个位置。
+- 谁能触碰、打开、藏起或拒绝某件物。
+- 哪个声音会增加时间压力，但不引入新人物。
+
+每轮可以按以下关系检查：
+
+~~~text
+说话或沉默的策略 -> 对方怎样接住或拒绝 -> 物件、目光或空间发生什么 -> 谁暂时掌权
+~~~
+
+同一个双人镜头可以承载多轮对话。只有注意、解释或权力真的改变时才需要切镜。
+反应不必总拍脸，也可以是不碰纸袋、把钥匙推过边界、手从门把移开，或让沉默继续。
+
+不要为了“画面丰富”让人物轮流起身、倒水、看窗。动作若不改变议程或证据条件，反而会削弱表演。
+
+## 3. 证据揭示
+
+先写清观众知道了什么，再选镜头：
+
+1. 证据在哪里，由谁控制。
+2. 揭示前观众能读到什么。
+3. 构成证据的是形状、状态、精确文字，还是人物与物件的关系。
+4. 谁先看见，谁又看见对方已经看见。
+5. 得知后，哪个行动发生变化。
+
+镜头可以负责建立方位、获得证据、展示证据、表现接收者反应或交代后果，不要求固定
+顺序。若精确文字就是证据，镜头必须绑定来源文字政策和本帧呈现方法；不要用一闪而过的
+插入镜头假装观众能读完。若证据只是纹样或断角，提示词不得临时造字。
+
+## 4. 群体与轴线
+
+把群体按作用分区，不要给每个人单建一条轴线：
+
+- 主行动者与对手的主要轴线。
+- 见证者或队列所在区域。
+- 入口、出口与权力位置。
+- 群体注意方向的变化。
+
+公开揭示或家庭冲突中，再按行动能力区分知情者、能作决定的人、利益相关者和普通
+旁观者。只有新事实改变某组人能做什么时，才给这组人新的动作：作证、拦住、让路、
+退出或保持沉默。不要让所有人轮流说同一种惊叹，也不要把每个背景人物都建成独立资产。
+
+**`SHT-13 · reviewed_invariant`**：多人对峙先画一张**有方向的关系投影**：谁此刻保护/协作/施压/观察谁，这条关系由哪个
+剧本动作或信息状态支持，再把它翻成站位、身体朝向、视线、距离和行动线。关系投影只对
+本镜有效；同一人物可在剧情转向后换边，但一帧内不能既与甲背靠背结盟、又从对立行动线
+朝甲施压，除非镜头明确表现转向发生的边界。逐句核对人物、手持物和阵营，避免自然语言
+提示词因重复段落把同一角色写进两个互斥位置。
+
+跨越轴线时，可以让人物在同一镜内穿过轴线，用中性过渡镜头，或用新的全景重新建立
+场景方位；也可以由创作者明确选择主观错乱。群体反应不需齐刷刷给特写；选择一个会
+改变风险的代表反应，或用全景展示沉默、退让、围拢和让路。
+
+## 5. 动态对象与竞赛
+
+**`SHT-14 · reviewed_invariant`**：球、车辆、武器、证物、接力物或争夺中的工具会把控制权和空间关系带过切镜。设计前先写
+当前时间/回合、区域、控制者、运动方向、目标路线与可用反制；若某项不适用就省略，不为
+填表虚构数据。
+
+一次关键行动至少要让观众理解：动作从什么可见状态开始、控制权怎样被争夺或转移、方向
+或战术为何改变、结束时对象与人物分别在哪里。镜头数量由力学和注意变化决定；慢动作、
+特写、群众反应或解说不能替代丢失的空间阶段。
+
+- 切镜后动态对象应从上一镜结束位置和方向继续，除非明确发生跳时或省略；
+- 比分、计时和阵形只有在改变选择时进入画面；若精确文字不可可靠呈现，标记为后期图形
+  或声音信息，不让提示词临时造字；
+- 对手的战术调整应能追溯到此前看见的信息，避免每轮都重置成同一站位；
+- 反应镜只在接收者的新判断会改变下一动作时承担职责，不能用欢呼遮住控制权转移。
+
+## 6. 观察视角与边界
+
+**`SHT-09 · reviewed_invariant`**： 准确的地点和观察视角，其方向和可见锚点必须与
+摄影机实际所在一侧一致。
+
+地点记录整体地理；观察视角记录一个可复用的方向、时段和光线状态。镜头在门外朝内时，
+不能只因为“仍是同一城门”，就绑定门内朝外的视角。选择前逐项比较摄影机所在一侧、
+可见锚点、朝向、时段、天气和光线；缺少合适视角时，向资产技能请求新版本。
+
+每次切镜前后比较：
+
+- 位置、面向和目光。
+- 左右手与持有道具。
+- 伤势、造型和可见状态。
+- 轴线与屏幕运动方向。
+- 门、灯、天气和文字状态。
+- 谁知道什么；这一项只引用剧本来源。
+
+镜头结束边界是事实来源；关键帧只投影镜头开始边界；运动规格只实现这段过程。
+不能把本镜动作结果提前写进起始关键帧，也不能在相邻两镜重复完整动作。若 SHOT-02
+的结束状态是“右手刚开始伸出”，SHOT-03 才能完成取物；若 SHOT-02 已完成取物，
+SHOT-03 就必须从“已经持有”继续。
+
+## 7. 规则分级
+
+- `structural_invariant`：原文落实、产物引用、已接受绑定、起止边界和相邻关系都能解析。
+- `reviewed_invariant`：切镜保留剧本原意，观察视角匹配摄影机一侧，证据有足够可读时间和接收反应。
+- `craft_default`：先建立地理、按注意变化切镜、在单房中用策略和物件制造运动；有理由时可以调整。
+- `taste_option`：镜头数量、景别、手持或固定、留白和反应方式由已接受的视觉方向决定。

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

@@ -0,0 +1,39 @@
+# 关键场景 Coverage Audition
+
+Coverage audition 在正式 shots 前比较真正不同的导演方案，避免第一种合理做法直接成为唯一答案。
+它不是固定镜头数、固定宫格或自动变体器；创作者选择之后才投影为正式场次视觉计划和 shots。
+
+## 什么时候比较
+
+只用于人物首次亮相、身份/证据揭示、关系反转、高潮与结尾、复杂多人调度、悬念延迟或视觉母题。
+普通场景不做。判断标准不是“场次重要”四个字，而是不同观看位置、信息时机或表演所有权会不会
+显著改变观众体验。
+
+## 什么叫真正不同
+
+方案必须至少改变一个导演命题，而不是只换景别名称：
+
+- **表演中心**：延迟证据特写，让停顿、撤步和旁观者让路完成权力变化；
+- **证据中心**：先给局部，再给听者反应，最后允许观众确认；
+- **主观错位**：揭示前后更换观众所站的一侧，让原观察者变成被观察者；
+- **空间中心**：用入口、距离、阻挡和通道归属完成转向；
+- **声音中心**：让画外声、环境撤出或留白先改变权力，再决定何时给画面确认。
+
+这些是比较方向，不是每场必须生成的套餐。若两项方案的观众知情时机、对齐对象、表演空间、
+最强画面和结尾落点都相同，它们仍是同一个方案。
+
+## 比较记录
+
+使用 `assets/coverage-audition.example.jsonl`，用真实的 screenplay-index `BLK-…` 记录绑定场次，
+并绑定已接受视觉方向、制作形态、Location/View 与参与资产；逐方案回答：观众何时知道什么、
+站在哪一边、谁拥有表演空间、最强画面与最终落点、可能丢失的空间/反应/信息、与制作形态是否
+相容。保留反对理由，不替创作者选择。
+
+不得固定四宫格、九宫格、二十五宫格或景别比例。宫格只是人工比较界面，不是镜头数量公式。
+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。

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

@@ -0,0 +1,169 @@
+# Frozen Keyframe Craft
+
+## 目录
+
+- [Boundary and instant tests](#boundary-and-instant-tests)
+- [Purpose](#purpose)
+- [Ordered recipe](#ordered-recipe)
+- [尾帧：什么时候可以有，以及它换来什么代价](#尾帧什么时候可以有以及它换来什么代价sht-17)
+- [Start-only drafting discipline](#start-only-drafting-discipline)
+- [Static test](#static-test)
+
+## Boundary and instant tests
+
+- `SHT-05` — Project exactly one accepted shot boundary and bind the exact
+  Character/Look, Location/View, and Prop/State variants visible there.
+- `SHT-06` — Describe one freezeable instant. Ordered action, expression arcs,
+  camera movement, and transforming weather belong to motion, not the keyframe.
+
+## Purpose
+
+Describe one frame that can exist at a single instant and accurately anchors the
+accepted shot. A keyframe is not a compressed video prompt.
+
+## Ordered recipe
+
+1. **Purpose:** what the audience must notice now.
+2. **Focal subject:** exact asset and variant IDs.
+3. **Frame:** shot size, angle, lens intent, aspect-aware composition.
+4. **Geography:** Location/View, fixed anchors, foreground/background zones.
+5. **Boundary projection:** exact start position, body facing, pose, gaze, hands,
+   held props. Give body facing for every person — it fixes which screen side they
+   hold and which side the next reverse cuts from; `gaze` does not cover it. Add
+   head facing only when it differs from body facing.
+6. **Performance instant:** one visible expression/tension state, not an arc.
+   Pick a channel the current shot size can actually read — gaze, breath, body
+   set, object handling, or a held decision. A wide shot cannot carry an eyelid;
+   a close-up cannot carry a full-body retreat. Naming only the emotion ("愤怒")
+   leaves the translation to a downstream stage, and the keyframe is the first
+   frame — a mistranslation there is wrong from frame one.
+7. **Light and atmosphere:** inherit accepted direction/time/weather; add only
+   frame-relevant detail.
+8. **Text policy:** readable/symbolic/blank/postproduction for visible surfaces.
+9. **Exclusions:** contradictions or drift likely for this frame.
+
+Identity and boundary facts remain source references. The keyframe owns focal,
+composition, camera/lens, frame-only staging, and exclusions.
+
+### 写完之后过一遍可渲染检查
+
+判据是一句话：**接手的人能不能照着画出来，而不用自己发明任何事实**。逐条对照，
+缺哪条补哪条——这些不是可选修辞，缺一条执行端就得替你决定一次：
+
+| 必须写出来 | 缺了会发生什么 |
+|---|---|
+| 每个人在哪、彼此距离多少（"站在他正前方约两步"） | 人物间距逐镜漂移，观众读成换了场地 |
+| 前景、中景、背景各有什么 | 纵深塌成一层，主体贴在背景上 |
+| 视线该落在哪（本镜的视觉重点） | 画面平均用力，观众不知道该看谁 |
+| 构图方式与景别 | 同一场每镜构图随机，剪不到一起 |
+| 机位在轴线哪一侧、俯仰角度、焦段意图 | 越轴；正反打方向对不上 |
+| 光从哪来、什么质感 | 同场光位逐镜跳变 |
+| 每个在场者的姿态、朝向、手部、持物 | 下一镜接不住，道具凭空易手 |
+| 哪些与上一镜相同 | 执行端把"没写"读成"可以变" |
+
+最后一条最容易漏，也最便宜：与上一镜一致的部分**写一句"与上一镜相同"即可**，
+不必重述细节；真正变了的才展开写。这一句是连续性的承载点。
+
+**写紧**：一件事只说一次，能并进一句就不另起一句。上表十二项写满大约五百字就够；
+写到八百字往上，多出来的通常是连接词、铺垫句和把同一件事换个说法再说一遍——它们不增加
+可渲染的事实，却按字数付费。检查办法：删掉任意一句，如果画面没有变得更不确定，那句就是
+多的。
+
+写出来是这样（合成材料，四百余字覆盖上表全部十二项）：
+
+```text
+竖屏 9:16 中近景。机位在轴线左侧、高约一米二，平视略低约五度，中焦 50mm。前景是长凳
+扶手与半张湿报纸（占下缘约六分之一）；中景是两人对峙；背景是虚焦的候车牌。三分构图，
+她落在右三分线上。她：坐长凳右端，双手交叠压膝，身体朝向正前，视线落在对方鞋尖，
+无持物。人物乙：站她正前方约两步、略偏画面左，双手插袋，身体朝向她，头略偏向出口。
+光自画面右上顶棚缝隙斜下为主光（硬），左侧留暗，无补光。视觉重点在她压膝的双手——
+本镜唯一不动的东西。位置与持物与上一镜相同，只有她的视线从水洼移到对方鞋尖。
+排除：无动作过程，无雨丝拖影。
+```
+
+`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.
+
+## 尾帧：什么时候可以有，以及它换来什么代价（`SHT-17`）
+
+默认每镜一张关键帧，冻结的是 start。但首尾帧接续是 AI 视频里最常用的工作流之一：把首帧
+和尾帧一起交给执行端，中间由它补。套件此前没有尾帧的位置，于是这条路要么走不通，要么被
+私自绕过——后者更糟，因为绕过时尾帧往往是**独立画出来的**，它就成了第二个终点权威，与
+镜头 `end_boundary` 各说各话。
+
+**`structural_invariant`**：关键帧记录必须声明 `boundary_role`（`start` 或 `end`），
+`boundary_ref` 指向同一镜头对应的那个边界字段。**尾帧是 `end_boundary` 的投影，
+不是新的终点事实**——它与首帧对 `start_boundary` 的关系完全一样：可以决定这一帧怎么构图、
+用什么景别镜头、光怎么落，不能决定人在哪、手里有什么、看着谁。尾帧与镜头终点不一致时，
+错的是尾帧。
+
+每镜的关键帧数量**不是固定的**。默认一张首帧；只有当交付工作流真的要消费尾帧时才加一张，
+不为凑齐而画。补尾帧不改变 `SHT-10`：首帧仍然只能写 start 事实，尾帧只能写 end 事实，
+两张各自守自己的边界，不互相借用。
+
+**代价要说清楚：交出一对首尾帧，等于把两帧之间的运动交给了执行端插值**。 而运动路径本来
+是运动规格拥有的东西。所以选了首尾帧接续的镜头，其运动规格不是"照旧再写一遍"，而是被
+两端夹住了：它仍然要写清中间必须发生什么（动作顺序、对白落点、摄影机行为），但要意识到
+执行端会优先满足两端的画面一致性。因此——
+
+- 中间必须被看到的动作**不要只靠插值兑现**。如果一个动作是本镜存在的理由，两端之间没有
+  任何东西保证它会发生，就该拆镜，或者让该动作落在其中一端。
+- 两端差异越大，插值越自由，中间越不可控。首尾帧接续适合"状态改变清楚、路径无所谓"的
+  镜头（转身、递交完成、坐下），不适合"路径本身是戏"的镜头。
+- 终点报告仍然对照镜头 `end_boundary`，不对照尾帧。尾帧只是它的投影，不能自证到达。
+
+## Start-only drafting discipline
+
+**`SHT-10 · reviewed_invariant`**: rendered keyframe prose may contain only facts
+from the boundary that frame declares. 首帧写进任何由运动或终点首次产生的事实是漂移；
+尾帧写进在它之前就已经消耗掉的事实同样是漂移。两帧各守各的边界，不互相借用。
+
+Keyframe 默认是 shot start，不是“本镜最有戏的时刻”。为避免把 end 提前：
+
+1. 先冻结 `boundary_ref`（`boundary_role: start`），草拟 prompt 时暂不读 end/motion prose；
+2. 只填 start 已成立的 position/pose/gaze/hands/held props/visible state；
+3. 再与 end 做“新出现事实”差集；差集中的事实不得出现在 keyframe prompt；
+4. 渲染 Markdown 后从自然语言反向提取手位/持物/目光/可见状态，与
+   structured boundary 再比一次；不能只验 JSON 投影而忽略真正交付的 prompt。
+
+反例：start 是“右手空置、看对方”，end 是“右手握铃绳、看门”。冻结帧写
+“手已握铃绳”即使很好看，也属于 boundary drift。
+
+## Static test
+
+Ask: could a still photographer capture every described fact at once?
+
+Move these to motion:
+
+- ordered verbs (先、再、随后、最终);
+- expression changing from A to B;
+- camera push/pan/track over time;
+- entering/leaving/turning/reaching sequences;
+- dialogue delivery arc or sound progression;
+- light/weather transforming during the shot.
+
+A single held pose may imply tension, but it must not require several moments.
+
+## Prompt economy
+
+Do not restate full character or location 设定集s. Bind accepted variants and
+repeat only facts the frame needs to prevent ambiguity: distinguishing anchor,
+current Look, crucial spatial anchor, held prop, light direction, text state.
+
+Generic “cinematic, 8K, masterpiece” language cannot replace subject identity,
+geography, composition, or continuity.
+
+## Failure examples
+
+- incompatible Looks appear in the same frame;
+- “turns, runs, then looks back” appears in a still;
+- the start hand/prop differs from the shot boundary;
+- background changes location identity or orientation;
+- light direction resets without source change;
+- readable evidence is paired with no-text;
+- prompt lists subjects but not their spatial relationship;
+- framing has no focal hierarchy.
+- structured projection matches start but rendered prompt describes a fact that
+  first appears in the shot end or motion.