@lemoncat7/dsh-partner 2.5.0 → 2.7.1

package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/keyframe-prompts.md

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

package/resources/skills/drama-production/upstream/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/resources/skills/drama-production/upstream/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/resources/skills/drama-production/upstream/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/resources/skills/drama-production/upstream/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":[]},"primary_transition":{"trigger":"<什么可见或可听事件让动作开始>","action":"<从起点到终点的唯一主要动作；交接时写清接触者、接触方式与落点>","result":"<逐项落到 end_boundary，不在镜外补转换>"},"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/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/blocking-playbooks.md

@@ -0,0 +1,216 @@
+# 常见场面的分镜方法：竖屏、单房、证据与群体轴线
+
+## 目录
+
+- [竖屏多人](#1-竖屏多人调度)
+- [单房对白](#2-单房对白)
+- [证据揭示](#3-证据揭示)
+- [群体与轴线](#4-群体与轴线)
+- [动态对象与竞赛](#5-动态对象与竞赛)
+- [观察视角与边界](#6-观察视角与边界)
+- [规则分级](#7-规则分级)
+
+先使用镜头设计资料中的原文落实、镜头目的和场景地理方法。只有遇到下列场面时才读
+本文；这些是思考步骤，不是镜头数量模板。
+
+## 1. 竖屏多人调度
+
+竖屏不是把所有人排成上下两层。先画出人物能怎样通行，再决定纵向画幅怎样表现关系与权力：
+
+- 用前景、中景、后景、门框、台阶和桌沿建立深度。
+- 明确谁能接近证据、出口或权力座位。
+- 头像高低只在空间真实且有意义时表达地位。
+- 两人对话时，仍要保留第三人的监听、反应或阻挡位置。
+- 先保证进出方向和视线连续，再用近景强化选择。
+
+可以按以下顺序设计：空间锚点与入口 → 每人的行动目标和筹码 → 群体注意中心 →
+关键动作前后的站位 → 哪些同时反应必须留在全景中 → 只有丢失信息时才切插入镜头或近景。
+
+常见问题：每句台词都切一个头像近景；站位只为填满画面；背景人物在切镜后无原因换边；
+重要人物一直被前景遮住，但剧情并未利用这种遮挡。
+
+### 交付面遮挡 (`SHT-15`)
+
+竖屏画面在播放时通常不是完整可见的：播放界面会在画幅上叠一层东西——字幕条、播放控件、
+进度条、侧边的互动控件、片头片尾的角标。**画幅是满的，可读区不是**。 这与拍摄无关，
+是交付面的事实，所以它约束的是构图决定，而不是画面内容。
+
+**`reviewed_invariant`**：当创作者已声明交付面的遮挡区时，本镜必须被读到的内容（脸与
+眼神、证据上的可读文字、决定性的手部动作）不能只落在这些区域里。遮挡区、是否常驻及其
+来源引用都取自已接受的交付方案；**没有声明就没有这条约束**。
+
+- **未声明时保持未解决，不要猜**。 记为待创作者决定，照常按画面本身的可读性构图，
+  **不因为猜测的区域改变构图**——猜出来的避让同样是一个通用安全框，只是没写在纸上。
+  需要时向创作者提一次问：这次交付的播放面会在画幅哪些位置叠加什么、是否常驻。
+
+声明由**创作者拥有**，写在 `视觉设定.md` 的“交付面”章节，与项目视觉方向和制作形态并列。
+它回答三件事：**占用哪里、是否常驻、依据来自哪**。每个区域使用稳定 ID，并写：
+
+- 当前画幅；
+- 用画幅比例或可命名边带描述的占用范围；
+- 常驻、间歇或条件出现；
+- 承载字幕、控件、角标还是其他内容；
+- 创作者提供的平台模板、截图或文字说明。
+
+没有声明时本规则不生效：镜头照常按画面本身的可读性构图，把问题留为待创作者决定。已经声明时，
+受影响镜头在 `分镜.md` 指名交付面区域 ID；交付方案改版后重新核对，不沿用上一版避让结论。
+已声明遮挡区后，按下面的优先级判断哪些内容必须挪开：
+
+- **可读文字最敏感**：证据类道具上必须被读出的字，一旦落在字幕条位置，观众永远读不到。
+  这类镜头要么把文字挪到中部可读区，要么改用更近的景别单独给一次。
+- **脸与眼神次之**：竖屏习惯把人物放得很高，容易压到顶部角标区；也不宜为了避让而把人
+  一律推到正中，那会让全片构图变平。判断依据是"这一镜要被读到的是什么"，不是固定安全框。
+- **一侧的互动控件**是竖屏特有的：如果本镜的关键动作发生在被占用的那一侧，把动作调到
+  另一侧，或用镜像的机位关系解决——不要靠缩小主体来避让，那会同时削弱表演。
+- **不要把避让写成通用禁区**。它是本项目交付方案下的构图约束；换交付面就要重新确认，
+  也不能反过来要求剧本改动作发生的位置。
+
+失效方式是安静的：单帧看构图很好，只有放到实际播放面上才发现关键信息被压住，而这时
+关键帧与视频提示词都已经做完了。所以这个判断属于分镜阶段，不属于交付前检查。
+
+## 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/resources/skills/drama-production/upstream/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/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/coverage-audition.md

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