@oh-story/dsh 0.1.3 → 0.1.5

package/lib/drama/skills/short-drama/references/creator-documents.md

@@ -0,0 +1,204 @@
+# 五份创作文档
+
+这是一份建议格式，不是 schema。优先让人一眼读懂；只有跨文档引用和投产定位需要稳定 ID。
+
+## `剧本.md`
+
+- 一级标题必须以集号开头，例如 `# EP001 集名`。
+- 每场用 `## EP001-SC001 内 · 地点 · 时间/天气`（空间性质也可写 `外` 或 `内外`）。
+- 对白使用 `角色（可选表演提示）：台词`；画外音、画外对白、声音、可见文字、连续性和转场分别使用 `[VO]`、`[OS]`、`[SFX]`、`[画面文字]`、`[连续性]`、`[转场]`，不要把含冒号的动作叙述误写成对白。
+- 不为每段台词生成 block ID，不另写节拍表、索引或录音表；用户明确需要时再做。
+
+## `视觉设定.md`
+
+按人物、造型、地点和道具分节，每一项自己是一个二级标题。每项只写后续生成真正需要保持的识别锚点、
+当前状态与变化原因，不要抄剧情摘要，也不要把瞬时姿势或镜头角度升级成新资产。
+
+```markdown
+## 人物 · 江辰
+- 识别锚点：窄长眼、左眉尾旧疤、肩背略绷。
+- 本集造型：深灰旧西装，右袖口有雨水深痕。
+- 状态变化：EP001-SC003 后右手掌沾血。
+- 画面代称：Jiangchen
+- 连续性锁：LOCK-JIANGCHEN-SUIT《江辰深灰旧西装》（镜头：全集；图片提示词项：IMG-JIANGCHEN-SHEET）· 锁面：dark-grey worn wool suit
+```
+
+二级标题固定写成 `## <人物|造型|地点|道具> · <名称>`；分镜的「视觉依据」按这个标题定位条目。
+
+**画面代称**是提示词正文里直接叫到这一条的名字，按项目提示词语言写；多个写法用 `、` 分隔，
+大小写必须与正文一致。条目自身的中文名称始终算一个代称，所以中文项目通常不必写这一行。
+`creator_markdown_check.py` 用它机械核对「冻结关键帧里出现的名字，视觉依据必须覆盖」。
+
+提示词正文语言不是中文时，被某镜「视觉依据」引用过的**人物**条目必须给出结论：写
+`画面代称：<正文里的拼写>`，或在正文从不点名它时写 `画面代称：无`。少了这一行，中文条目名在英文正文里
+永远匹配不上，这条核对就静默失效——那正是 #94 报告的形状。地点和道具通常在正文里只被描述、不被点名，
+不作强制。
+
+识别锚点写给创作者读；**连续性锁**写给执行端逐字带走。跨镜出现、观众看得出不一致、又不随剧情
+改变的可见事实（服装主色与形制、道具颜色材质、发型长度、伤口位置）才上锁，会变的部分留在
+`状态变化`。一行一把锁：
+
+- `LOCK-...` 在本集唯一，与 `IMG-...`、`REF-...`、`SHOT-...` 互不混用；
+- `镜头：` 写 `全集` 或 `、` 分隔的 `SHOT-...` 列表，两者不能混写；
+- `；图片提示词项：` 可选，写 `、` 分隔的 `IMG-...` 列表；
+- `· 锁面：` 之后是被逐字带走的最小名词短语，用项目提示词语言写，不含标点、动作和剧情。
+
+生效范围内的冻结关键帧、`MOTION-...` 正文和被点名的 `IMG-...` 正文都必须含有这段锁面（忽略
+大小写）；`creator_markdown_check.py` 会机械核对。没有锁的项目不受影响。
+
+## `分镜.md`
+
+每镜一个二级标题。镜头 ID 在本集内唯一并保持稳定；修订镜头内容时不要无故换 ID。
+
+```markdown
+## SHOT-EP001-001 · 门外停步
+- 来源：EP001-SC001
+- 时长：4s
+- 目的：先让观众看见他不敢进门，再揭示门内争吵。
+- 景别/机位：中近景，门框外侧，轻微低机位。
+- 起点：江辰右手悬在门把上方。
+- 唯一动作：门内玻璃落地声触发江辰收回右手，视线从门把转向门缝。
+- 终点：江辰右手垂回身侧，视线落在门缝。
+- 图片提示词项：IMG-JIANGCHEN-SHEET《江辰角色板》（控制：身份、体态、本集造型）；IMG-CORRIDOR-NIGHT《夜间走廊场景板》（控制：空间地理、门位、光向）。
+- 输入参考图：无（待补参考图：江辰本集造型、夜间走廊地理、本镜起始帧）。
+- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态、本集造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
+
+### 冻结关键帧提示词
+> 按项目提示词语言编写的冻结瞬间正文……
+```
+
+只写有镜头职责的镜头。关键帧提示词必须与该镜“起点”一致；终点才出现的文字、动作或状态不得
+提前进入静帧，也不要把整段动作塞进静帧。
+
+三类依据不得混用：
+
+- **图片提示词项**：《图片提示词.md》中可见二级标题的 `IMG-...` 条目，只证明提示词存在；
+- **输入参考图**：创作者已提供，或经确认生产且当前可读的真实图片；每张图用稳定 `REF-...` 槽位绑定显式顺序、可见项目相对路径、中文名称、用途、控制与不得控制范围；
+- **视觉依据**：《视觉设定.md》中的文字事实，不冒充图片。
+
+**「视觉依据」是每镜必写字段，也是这一格画面的人物、地点与道具清单。** 冻结关键帧写完之后，
+按成稿画面逐项回填，语法固定：
+
+```markdown
+- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
+```
+
+- `《视觉设定.md》·` 只写一次，条目之间用 `；` 连接，条目名称必须能在《视觉设定.md》里找到同名标题；
+- 画面里需要认出身份、造型或地理的人物、地点和道具都要在列，小比例或背景人物只要需要认出身份仍在范围内；
+- 画外的人声、不可识别的局部和不需要保持一致的临时物件不在列，也不要为凑齐而写进来；
+- 「控制」写这一条在本镜真正决定什么，只写这一格画面承担得起的范围——手部特写不写「本集造型」；
+- 本镜确实没有需要保持一致的可见条目时写 `无`，这不是省略的借口：关键帧里点名的条目仍会被机械核对。
+
+关键帧正文提到某个条目的名字、但它本镜确实不在画面里时（物主已离场、名字只出现在屏幕文字上），
+在同一字段末尾追加画外清单，如实说明它被提到而不在场：
+
+```markdown
+- 视觉依据：《视觉设定.md》·地点「教室」（控制：课桌排列、窗位）；道具「旧书包」（控制：磨损、颜色）；画外：人物「小明」。
+```
+
+某个条目的名字在正文里根本不可靠时——`道具「手机」` 会撞上「手机店」，`人物「小雨」` 会撞上「下着小雨」——
+在《视觉设定.md》该条目写 `画面代称：无`，机械核对不再按名字找它；这一镜是否画到它，仍由「视觉依据」如实回答。
+
+每个 `REF-...` 槽位的语法是：
+
+```markdown
+REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途：<用途>；控制：<范围>；不得控制：<范围>）
+```
+
+`用途` 回答「这一张在本镜决定什么」，取值只能是
+`身份`、`造型状态`、`地理`、`构图`、`尺度`、`效果`、`起始帧`、`结束帧`、`风格` 之一，逐条含义见
+[参考角色](reference-roles.md)。一张图承担两件事时拆成两个槽位，不写「全参考」。一镜最多一张
+`起始帧`、一张 `结束帧`，且写 `结束帧` 时必须同时有 `起始帧`。有了 `用途`，视频提示词就能直接回答
+「本镜要送哪一张分镜起始帧、哪些人物/道具/场景图」，生产端也不必再猜每张图的职责。
+
+「输入参考图」有三种准备结果，不能把后两种混在一起：
+
+- 已绑定 `REF-...`：图片真实存在，可进入图生/参考生视频；
+- 待补：一张都没有时写 `无（待补参考图：……）`；只缺一部分时保留已有 `REF-...`，末尾追加 `；待补参考图：……`。视频提示词尚未就绪；
+- `无（创作者已明确选择文生视频）`：创作者在了解一致性影响后明确不用图，可进入文生视频。
+
+`IMG-...` 只用于查找，不靠英文 slug 向创作者解释含义。每个引用都同时写简短中文名称和
+控制范围，且 ID 必须在当前《图片提示词.md》标题中存在。中文名称帮助阅读，不取代 ID 定义条目身份。没有该文档或没有合适条目时，分镜仍可
+直接从剧本和视觉设定进入，使用下列回退格式，不编造 ID 也不补造提示词阶段：
+
+```markdown
+- 图片提示词项：无
+- 输入参考图：无（待补参考图：江辰身份、旧走廊地理、本镜起始帧）
+- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
+```
+
+提示词条目和真实图片是独立的：有 `IMG-...` 条目时，「输入参考图」可以仍为「无」；创作者给了
+真实图片时，也不需要为它编造提示词条目：
+
+```markdown
+- 图片提示词项：无
+- 输入参考图：REF-JIANGCHEN-LOOK（顺序：1）· 输入/参考图/江辰定妆.jpg《江辰定妆照》（用途：造型状态；控制：本集造型、面料质感；不得控制：镜头构图、动作、表情）
+- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态）。
+```
+
+只准备了一部分时，已核对的图不丢弃，但必须把缺口留在同一字段中：
+
+```markdown
+- 输入参考图：REF-JIANGCHEN-LOOK（顺序：1）· 输入/参考图/江辰定妆.jpg《江辰定妆照》（用途：身份；控制：脸型、体态、本集造型；不得控制：场景地理、构图、动作）；待补参考图：夜间走廊地理、本镜起始帧
+```
+
+两者也可同时存在，但各用各的定位符：
+
+```markdown
+- 图片提示词项：IMG-JIANGCHEN-SHEET《江辰角色板》（控制：身份、体态）
+- 输入参考图：REF-CORRIDOR-COMPOSITION（顺序：1）· 输入/参考图/走廊构图.jpg《走廊构图参考》（用途：构图；控制：占画比例、留白；不得控制：人物身份、动作、剧情事件）
+- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态）；地点「旧走廊」（控制：空间地理、出入口）。
+```
+
+## `图片提示词.md`
+
+每项一个可投产的角色板、场景板、道具板或状态图。标题使用 `IMG-...` ID；正文放在
+`### 可复制提示词` 的引用块里，前面只保留用途和参考约束。
+这里的 `IMG-...` 是提示词条目 ID，不是已生成图片的记录。
+
+```markdown
+## IMG-JIANGCHEN-SHEET · 江辰角色板
+- 用途：锁定身份、体态和本集造型。
+- 参考：无；若有真实参考图，使用与分镜相同的完整 `REF-...` 格式，说明顺序、项目相对路径、中文名称、用途、控制与不得控制范围。
+
+### 可复制提示词
+> 按项目提示词语言编写的正文……
+```
+
+## `视频提示词.md`
+
+与分镜一一对应时沿用镜头号并使用 `MOTION-...` ID。若「输入参考图」中的 `REF-...` 已全部就绪，使用图生视频，正文
+只需重述运动所需的局部起点和防漂移事实；只有「输入参考图：无（创作者已明确选择文生视频）」才使用文生视频，正文必须自足地
+包含人物、造型、地点、构图、光线等本镜需要的静态视觉锚点，不能用 `preserve/保持已有外观`
+代替模型并未收到的图片。「待补参考图」会阻止最终视频提示词；视频文档中的「输入参考图」必须与对应分镜逐字一致。
+
+除非剧本或创作者明确要求，视频正文用项目提示词语言直接声明全镜任何时刻都不生成非画内字幕、
+caption 和对白文字叠加，不能只写抽象的“文字层为空”，让对白只通过声音与口型发生。旗帜、标牌、
+屏幕等画内文字另走已接受的文字政策：`exact_readable` 逐字携带准确
+字符、语言、承载面和位置；关闭字幕不能写成会同时抹掉这些画内文字的全局 `no-text`。
+
+```markdown
+## MOTION-EP001-001 · 门外停步
+- 分镜：SHOT-EP001-001
+- 时长：4s
+- 生成方式：文生视频
+- 输入参考图：无（创作者已明确选择文生视频）。
+- 静态视觉锚点：A lean young East Asian man in a dark-grey worn suit stands outside an old corridor door under cold overhead light.
+- 起始帧：SHOT-EP001-001 的冻结关键帧
+- 状态链：右手悬在门把上方 → 门内玻璃落地触发他收回右手并转移视线 → 右手收回，视线落到门缝
+- 终点：右手收回；门内玻璃落地；人物视线转向门缝。
+
+### 可复制提示词
+> A lean young East Asian man in a dark-grey worn suit stands outside an old corridor door under cold overhead light. His right hand starts suspended above the handle, then withdraws……
+```
+
+有真实输入图时改用「生成方式：图生视频」，并原样携带分镜的完整 REF 声明；静态视觉锚点只写
+执行动作所需、且不能仅靠参考图用途推断的可见起点，不把路径或 REF ID 放进可复制正文。
+
+## 共通规则
+
+- 提示词正文必须可直接复制，不放占位符、流程备注或 QA 结论。
+- `### 可复制提示词` 下的引用块是**一条**提示词：从第一行到最后一行整段复制进那一次生成。方言把它分成 `subject_definitions` / `overall_soundscape` 这类段落时，段落仍属于同一条正文，不是分几次提交，也不是只交第一段。
+- 引用使用文档里看得见的场景/镜头/提示词 ID；不写文件哈希和内部路径。
+- 用户没要求的字段不为“完整”而补造。
+- 完成或修订五份文档后运行 `python3 {技能目录}/scripts/creator_markdown_check.py 剧集/<EP> --project-root .`，校验可执行的跨文档结构；内容质量仍由创作者审查。

package/lib/drama/skills/short-drama/references/creator-workflow.md

@@ -1,82 +1,92 @@
-# Creator Workflow
+# Creator-first 工作流
 
-## Creator authority
+## 唯一落盘
 
-`short-drama.json#/creator_authority` stores accepted creator constraints, visual direction and production
-profile choices. A skill may draft choices, but only the creator or an explicitly authorized delegate can accept
-them. If nobody has decided, keep the artifact pending; do not infer acceptance from silence or from a request to
-preview the whole pipeline.
+每集按需维护五份创作者可读 Markdown：
 
-Use project-relative paths and stable record IDs when one artifact points to another. Human-facing records do not
-need lifecycle digests. Deterministic source indexes may still carry byte spans because their job
-is exact source extraction, not workflow state.
+| 阶段 | owner | 文件 |
+|---|---|---|
+| 剧本 | `short-drama-write` | `剧集/<EP>/剧本.md` |
+| 视觉资产 | `short-drama-assets` | `剧集/<EP>/视觉设定.md` |
+| 分镜与冻结关键帧 | `short-drama-storyboard` | `剧集/<EP>/分镜.md` |
+| 图片提示词 | `short-drama-image-prompts` | `剧集/<EP>/图片提示词.md` |
+| 视频提示词 | `short-drama-video-prompts` | `剧集/<EP>/视频提示词.md` |
 
-## Entry points
+没有内容时不预建空文件。一个请求只创建它实际需要的文档；从剧本、视觉设定、分镜或提示词任一
+阶段直接进入都合法，不为补齐名义流水线伪造上游。
 
-| Creator asks for | Owner | Minimum input |
-|---|---|---|
-| Develop an idea or episode map | `short-drama-develop` | brief or conversation |
-| Analyze a long source | `short-drama-novel-analyze` | preserved source file |
-| Write or revise an episode | `short-drama-write` | idea, episode card, outline or script |
-| Extract assets | `short-drama-assets` | current script |
-| Create image prompt specs | `short-drama-image-prompts` | current asset facts |
-| Design shots/keyframes | `short-drama-storyboard` | current script and asset facts |
-| Create video prompt specs | `short-drama-video-prompts` | current shots/keyframes |
-| Produce images, video or TTS | `short-drama-produce` | current bounded job plus explicit confirmation after preview |
-| Review | `short-drama-review` | bounded artifact set |
-| Initialize, continue, show or deliver | `short-drama` | project path or target path |
+单集创作主链不落盘 JSON/JSONL、索引、指纹、覆盖表、QA 报告、审核表、交接胶囊或恢复状态。
+需要 ID 时写进 Markdown 标题；结构检查和批次状态留在本轮上下文，不成为第六份创作文档。建议
+写法见 [五份创作文档](creator-documents.md)。
 
-Direct entry is valid. Do not fabricate upstream files merely to make a nominal pipeline complete.
+长篇原著拆解或多集材料识别可以在 `项目开发/` 使用机器索引；它们是用户点名时才建立的可选分析
+工作区，不是单集创作真相。其存在不会改变 `剧集/<EP>/` 的五文档布局，也不能要求单集 owner
+补造并行结构化产物。
 
-## Branches
+创作者说明跟随项目语言。图片和关键帧正文跟随 `prompt_language`；视频正文优先跟随目标视频模型
+档案的 `video_prompt_language` 和 `video_prompt_dialect`，未声明时回退 `prompt_language` 与通用自然语言。
+`native_duration_seconds` 在分镜规划时生效，不能等生产提交才发现镜头不合法。没有 `short-drama.json` 时，图片与
+关键帧正文默认使用 `en`；视频正文根据目标模型确认，目标也未声明时沿用用户当前语言。描述语言、
+对白口语语言和画内文字互相独立，不能用一个推断另一个。
 
-```text
-direction / story development (when needed)
-              |
-           screenplay
-              |
-            assets
-          /        \
- image prompts   storyboard -> video prompts
-          \        /
-       confirmed production
-                |
-             review -> delivery
-```
+用户在 Brief 或当前请求中已经给出的项目级事实要在初始化时同步到 `short-drama.json`：至少包括已确认的
+集数、单集目标时长、画幅和目标生产档案。生产档案只有 `unset` 与 `accepted` 两种项目级状态；下游只读取
+已接受档案，不用临时状态代替创作者决定。
+同一场次连续生产且目标模型支持续接时，生产档案把连续性路由声明为“上一段实际视频 + 实际尾帧接力”；
+`one-shot-per-generation`、单镜容器或多镜容器只描述打包粒度，不能用来取消这条连续性路由。
+
+## 请求范围
 
-Look Development is optional. Image prompts and storyboard are sibling branches after asset facts exist.
+用户点名的范围就是本轮范围。“写完这一集”完成整集；“从剧本做到视频提示词”依次完成所点名
+阶段。场次、资产组和镜头组只是内部上下文批次，通过后自动继续，不逐批交还控制权，也不为每个
+中间文件另开接受、审查或 QA 回合。
 
-## Preview, confirmation and revision
+只在三处停下：
 
-A request for an end-to-end preview authorizes drafting, not acceptance. Its runtime contract is **one bounded work unit per turn**:
+1. 点名范围已经完成；
+2. 缺失事实形成会显著改变剧情或视觉方向的真实创作分叉；
+3. 下一步会调用外部生产，必须先展示精确 job 并取得显式确认。
 
-1. choose one owner stage; for a high-fanout stage, choose one explicit contiguous batch;
-2. read only that unit's direct inputs, draft or revise it, and run its local structural checks;
-3. persist a candidate without inventing creator acceptance;
-4. report the included scope, remaining scope and next useful action, then **return control to the creator**.
+### 一句话把范围说清楚
+
+请求不需要固定话术，技能也不靠关键词匹配。下面几句只是把「一句话里到底要交代哪几件事」写明白，
+照抄或改写都可以：
+
+```text
+写 EP001 的分镜和每镜冻结关键帧。目标视频模型是 MiniMax H3，先把它写进项目档案。
+```
 
-The turn ends at step 4. A creator message such as “continue” authorizes the next bounded unit. The next owner
-stage, review and production each begin on their own explicit request; review also runs when an explicitly
-requested delivery needs a verdict. Undecided work stays in `needs_confirmation`, and delivery waits until the
-creator accepts the relevant outputs.
+```text
+EP001 分镜确认采用，按 MiniMax H3 写视频提示词。人物、场景、道具要跨镜一致，
+所以先在项目里找已有的角色图、场景图、道具图和本镜起始帧并绑成参考；缺哪张就列出来，别改成文生视频。
+```
+
+```text
+EP001 的角色图和场景图在 输入/参考图/ 下，本镜起始帧在 剧集/EP001/制作成果/images/ 下，
+请按这些图写 MiniMax H3 的图生视频提示词，逐镜说明送哪一张起始帧、哪些人物/道具/场景图。
+```
+
+```text
+这一集没有也不打算做参考图，明确走文生视频，静态视觉锚点写足。
+```
 
-For a revision:
+一句请求里值得交代的是四件事：**做哪一集的哪一阶段**、**目标视频模型**、**参考图在哪里或还没有**、
+**没有图时是等图还是明确走文生视频**。前三件缺一件，技能会来问或按已接受档案推进；最后一件从不替
+创作者假设——没有说“明确走文生视频”，就当成还在等图。
 
-1. identify the artifact and owner;
-2. read only its direct current inputs;
-3. show the semantic change and what should remain unchanged;
-4. let the owner publish the revision;
-5. request creator acceptance when canonical meaning changed;
-6. report whether a separate bounded review is still needed; do not start it automatically.
+结构检查服务于发现错误，不是创作门禁。能在当前文档直接修正的问题直接修正；审查、归档和媒体
+生产只有用户点名时开始。安装 selftest、全量 QA 和 demo 验证属于技能维护，不属于普通创作请求。
 
-Changing an upstream file does not recursively rewrite project state. A consumer that directly recorded that file
-shows `update_needed`; republish the consumer when the creator actually wants it refreshed.
+## 创作质量
 
-Rendered prompt Markdown is a view of its structured spec. If someone edits the rendered view, either regenerate
-it, adopt the change into the spec, or reconcile both explicitly.
+简化文件数量不等于降低内容标准。各 owner 按具体问题读取自己的 craft references，检查剧情因果、
+人物声音、资产身份、空间连续性、镜头职责、可生成性和提示词边界。规则与路由总表见
+[knowhow-index.md](knowhow-index.md)。最终回报只说明已完成范围、关键创作决定、真实未决问题和可选
+下一步，不汇报内部流水线噪音。
 
-## Delivery boundary
+## 生产边界
 
-Deliver only explicitly selected, current, approved text and JSON in the text package. Produced media remains in
-its project production directory and may be exported by a separate creator-approved media handoff. Exclude private
-sources, credentials, absolute paths and machine state. `verify` checks checksums; it does not judge creative quality.
+图片、视频、TTS 和音乐生产仍遵守 `preview -> explicit confirm -> run`。生产工具可以在隐藏运行目录
+保存 job、确认和审计记录；这些是付费/外部副作用的必要边界，不要求模型把创作内容再抄成长期
+JSON/JSONL。job 必须把拥有当前提示词的 Markdown 写入 `source`，输出写到
+`剧集/<EP>/制作成果/`；任何提示词、参数、输入或输出路径变化都需要重新预览和确认。

package/lib/drama/skills/short-drama/references/knowhow-index.md

@@ -35,21 +35,26 @@
 | 多人场次的可辨识度与主角缺席场 | `$short-drama-write` | 一场里人多到分不清谁在与谁交手，或某场/某集不给主角 | 不决定站位、景别与镜头切换；那属于分镜 |
 | 场次声音戏剧 | `$short-drama-write` | 声源、留白或 sound bridge 承担故事信息与压力 | 不替逐镜实现或混音，不让配乐替代表演 |
 | 剧本生产标签 | `$short-drama-write` | 规范化对白、动作、VO/OS、文字与连续性 | 不借格式补造剧情 |
+| 有限行动单位与精确时限 | `$short-drama-write` | 题面明确给出可核对的次数、轮次、节拍或字面死线 | 按完成状态与题面约定检查，不把定性压力升级为数字或主动增加计数结构 |
 | 资产出现证据 | `$short-drama-assets` | 从剧本拆角色、地点、道具与状态 | 不用名词/人名匹配直接建资产 |
 | 身份、变体与复用 | `$short-drama-assets` | 决定复用、新变体、新身份或未决 | 相机角度通常不是资产变体 |
+| 原著自带的真实品牌与现实实体 | `$short-drama-assets` | 剧本沿用了原著专名，且该专名指向现实存在的品牌、商标、机构或人物 | 不判断合规、不给禁令、不内置清单；只把选择交给创作者并留痕 |
 | 资产图片提示词 | `$short-drama-image-prompts` | 把已接受资产投影为单帧可见规格 | 不承载有先后顺序的剧情动作 |
 | 场景板光线与跨 View 一致 | `$short-drama-image-prompts` | 同一地点要拆多个观察方向、且这些板会被互相剪接 | 朝向造成的逆光/落影差异不需拉平 |
 | 图片提示词定点修改 | `$short-drama-image-prompts` | 修改局部并冻结 preserve set | 不把重写整图伪装成局部编辑 |
 | 镜头目的与覆盖 | `$short-drama-storyboard` | 从剧本建立有动机的镜头 | 不为景别多样性硬拆镜 |
 | 场次视觉计划与 Coverage Audition | `$short-drama-storyboard` | 关键场次需先比较观众立场、信息时机、空间、摄影与声音运动 | 可选中间层，不拥有剧本事实或 shot 边界，不规定宫格/镜头数 |
 | 冻结关键帧 | `$short-drama-storyboard` | 写镜头起点的可冻结瞬间 | 不写动作链或镜头终态 |
+| 漫剧关键帧视觉词表 | `$short-drama-storyboard` | 视觉方向已接受为漫剧/二维漫画形态，要为关键帧稳定投影共享画风与当前可读性约束 | 全部是 `taste_option` 选项，不设质量门槛，不替代身份、地理与边界事实 |
 | 多人场面调度与交付面遮挡 | `$short-drama-storyboard` | 多人、群体、证据揭示、动态物体场面，或竖屏播放面会叠加遮挡 | 不把一个布局复用于所有题材；遮挡区来自已声明交付方案，不设通用安全框 |
 | 视频运动规格 | `$short-drama-video-prompts` | 把已接受镜头边界写成时间变化 | 不改镜头、资产或剧本权威 |
 | 交付容器与分段算术 | `$short-drama-video-prompts` | 项目声明了分段或多镜打包的交付方式 | 打包方式不改写镜头边界与可审查性 |
 | 交付路由与执行触发词 | `$short-drama-video-prompts` | 项目声明了逐镜以外的路由，或某路由要求固定字样 | 触发词与路由都由创作者档案声明，本套件不自造字样，续接不产生第二个起点权威 |
 | 表演动作与时长 | `$short-drama-video-prompts` | 动作、台词与落点可能超载 | 不用每秒动作数设通用阈值 |
 | 摄影机、声音与相连边界 | `$short-drama-video-prompts` | 写运镜、环境运动、口型或声音方向 | 不添加无来源的音乐/事件 |
+| 目标执行端能力档案 | `$short-drama-video-prompts` | 执行端的时长、参考方式、声音同轨或长度上限会改变正文写法 | 能力由创作者声明不由推断；不内置模型清单，不因收敛改写已接受边界 |
 | 跨场与跨镜连续性 | `$short-drama-assets` | 状态变化会传给下一场/镜/集 | 不复制整本 设定集 到每镜 |
+| 跨镜可见事实上锁 | `$short-drama-assets` | 服装、道具的颜色/材质在镜与镜之间漂移，参考图管不到 | 锁不变事实，不锁状态、姿势与镜头瞬态；锁面不替创作者选颜色 |
 | 制作形态翻译 | `$short-drama` | 把实拍、二维、三维、水墨等方向投影到各阶段 | 风格名或模型代码不是生产决策 |
 | 独立证据审查 | `$short-drama-review` | 冻结目标后写 finding 与 verdict | reviewer 不编辑 owner 来源 |
 | 项目生产观察与校准 | `$short-drama-review` | 有授权文字观察且需定位到准确 prompt/spec/reference/config | 只在当前项目和版本有效；未观察结果保持未知 |

package/lib/drama/skills/short-drama/references/look-development.md

@@ -28,9 +28,8 @@ Look development 不是给全剧粘一个风格标签，也不是让参考图接
 - **失效信号**：身份锚点被吞、群像层级打平、冲突场景只剩氛围等可观察风险。
 
 删除风格名称后，如果材质、光、色、边缘和空间写法没有任何变化，这个方向仍只是标签。
-创作者接受后，把选择写入
-`short-drama.json#/creator_authority/visual_direction/choices/look_development`；候选提示词本身
-不具有 creator authority。
+创作者选定后，把可观察的稳定项、允许变化和失效信号写入 `视觉设定.md` 的“项目视觉方向”；
+候选提示词本身不能反向改写人物身份、地点地理或剧情事实。
 
 ## 权限边界
 

package/lib/drama/skills/short-drama/references/pickup-and-alternate.md

@@ -1,58 +1,24 @@
 # 母版、补拍与替代版
 
-一个已接受的镜头在制作过程中经常要重做一部分。重做出来的那一版，和原来那一版是什么关系，
-必须写清楚——因为它决定了**原文要求还有没有人负责**。
-
-三种关系：
-
 | 版本 | 承担什么 | 默认关系 |
 |---|---|---|
-| `master`（母版） | 已确认镜头的**全部**原文要求 | — |
-| `pickup`（补拍） | 只补一个动作、反应、构图或效果片段 | 与母版**并存**，不替代 |
-| `alternate`（替代版） | 同一项要求的另一种实现 | 是否替代**必须另行决定** |
-
-## 危险不在"变短"，在悄悄变成母版
-
-缩小提示词范围往往是**正确**的修复：三人同框、复合动作或大范围变化做不出来时，
-收成一个可控的瞬间是专业做法。
-
-出问题的是另一件事——把这个缩小版当成完整母版归档。此后没有人再去看原文里那些
-它没有承担的要求，而它们已经不在任何一版的责任范围内了。**没有报错，只是那部分内容
-从此不会被拍出来。**
-
-举个例子：母版是"甲当着乙和丙的面把账页拍在桌上，乙别开视线，丙起身"。做不出来，
-于是改成一个特写："一只手把账页拍在桌上"。这个特写本身没问题——问题是原文里的
-"乙别开视线"和"丙起身"现在无人认领。
-
-## 所以补拍要逐项交代去向
-
-普通母版**不写** `coverage_scope`。只有补拍或替代版需要，写清四件事：
-
-1. `master_motion_id`：它补的是哪一版；`supplements_motion_ids`：它实际补上了哪几段。
-2. `source_obligations`：把原文要求**逐项列出**——动作、反应、对白、揭示、项目要求、
-   结束边界，每项带准确的 `source_ref`。
-3. 每项要求的 `disposition`，以及它当前落在哪个 `motion_field`：由本版本承担 /
-   留在母版 / 交给另一个补拍版本 / 必须退回分镜修改。**不允许留空**。
-4. `replacement_intent`：只能**提出**替代请求。
-
-接着上面的例子，那个特写版的 `source_obligations` 大致是这样：
+| 母版 | 当前镜头的全部原文要求 | 当前主要版本 |
+| 补拍 | 补一个动作、反应、构图或效果 | 与母版并存，不替代 |
+| 替代版 | 同一要求的另一种实现 | 必须明确比较后才能替代 |
 
-| 原文要求 | `disposition` |
-|---|---|
-| 甲把账页拍在桌上 | 本版本承担 |
-| 乙别开视线 | 留在母版 |
-| 丙起身 | **退回分镜修改**——本版本和母版都没有拍到 |
+缩小提示词范围经常是正确修复。危险不是“变短”，而是把只拍了一部分的版本悄悄当成母版，使未被
+它承担的对白、反应、揭示或终点从此无人负责。
 
-第三行就是这套记账存在的理由：它把"丢了一条"变成一件写在纸面上、必须有人处理的事，
-而不是一个没人发现的空缺。若缩小范围丢掉的信息确实没有其他镜头承担，就退回分镜改边界——
-不能靠改名叫"特写版"让它消失。
+## 补拍必须逐项交代去向
 
-## 谁能决定替代
+在 `视频提示词.md` 中为补拍或替代版使用稳定 `MOTION-...` ID，并写清：
 
-补拍默认 `does_not_replace_master`。
+1. 它对应哪个母版；
+2. 原文要求逐项由本版本、母版、另一补拍承担，还是必须退回分镜；
+3. 本版本的准确起点、终点和保持项；
+4. 它是补充还是请求替代。
 
-替代版想取代母版时，由**reviewer**核对全部要求后，在下游审查结论的
-`supersession_decisions` 里指名替代版与母版的记录再作决定。运动规格文件
-**不回写**这个结论——否则两个文件互相引用，依赖方向就成了环。
+例如母版要求“甲拍下账页，乙别开视线，丙起身”，补拍只拍手部特写，那么甲的动作由补拍承担，
+乙的反应留在母版，丙的动作若两边都没有，就必须退回分镜。不能靠改名让遗漏消失。
 
-一句话：运动规格可以申请，不能自己批准。
+补拍默认不替代母版；是否替代由后续审查结合全部故事义务判断，不能由运动提示词自己批准。

package/lib/drama/skills/short-drama/references/production-form-profiles.md

@@ -21,7 +21,7 @@
 不产生 ID，也不能创造新的 `structural_invariant`。卡片里写作“硬规则/硬约束”的条目，
 指的是它在投影一条**已经登记**的身份或连续性不变式（见 [knowhow-index.md](knowhow-index.md)），
 按那条原规则的等级执行；比例、rig 能力、头身比一类是**本项目的制作约束**，由创作者
-在 `creator_authority` 中确认后生效，不是套件层规则。审查者不得单凭形态卡阻断交付。
+写入 `视觉设定.md` 的“项目视觉方向”后才对本项目生效，不是套件层规则。审查者不得单凭形态卡阻断交付。
 
 ## 先写一张 production-form card