@oh-story/dsh 0.1.18 → 0.1.19

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

@@ -48,7 +48,7 @@ license: MIT
 4. 范围完成后一次回报完成内容、关键决定、真实未决项和可选下一步。
 5. 不自动开始用户没点名的审查、归档或生产。
 6. 请求横跨视觉设定、图片提示词、分镜或视频提示词时，结束前核对当前已有文档的视觉依赖；
-   图片提示词和分镜并行完成时，也要同步两支的引用。五份文档齐备后再运行完整跨文档检查，不为检查补造文件。
+   图片提示词和分镜并行完成时，也要同步两支的引用。每写完一份文档就带 `--partial` 运行跨文档检查，只核对已有文档；五份齐备后再运行完整检查。不为检查补造文件。
 7. 视频提示词请求遇到「输入参考图：无」或仍带「待补参考图」时，先路由分镜 owner 检查项目已有图片并刷新绑定。有匹配图就同请求续跑；有必要图缺失就列表停下。
    停下时把三条路一起给出：把已有图片放进项目绑成 `REF-...`；由创作者在自己的工具里出图、本轮先用
    `PLAN-...` 写出逐镜挂图计划并照常产出视频提示词；或者明确改走文生视频。用本套件生产参考图需要项目外的
@@ -94,6 +94,14 @@ python3 {技能目录}/scripts/project_tool.py set-authority <project> \
 各字段取值由命中的模型方言给出：`$short-drama-video-prompts` 的 MiniMax H3 / Seedance / Wan 3.0 方言文件都写了
 推荐档案。写完用 `status` 复核 `video_model_profile` 是否已经出现。
 
+语速 `format.pacing` 和集数 `format.episode_count` 走同样的决策写入：`--field /format/pacing`，
+`accepted_value` 写 `{"spoken_characters_per_second": <每秒可发声字数>, "seconds_per_action_paragraph": <每段动作秒数>}`，
+两项都要给；画面文字多、要按读字时间计时的项目，可再加 `"on_screen_text_characters_per_second"`。
+`--field /format/episode_count`，`accepted_value` 写正整数。没有语速时写作阶段算不出秒数。
+`status` 的 `profile_notes` 会列出各自有效、合在一起却做不到的设定，例如平均镜长低于目标模型原生最短时长，
+或设了单集目标时长却没有语速；看到就交创作者决定，不要等到分镜才发现。创作者选择用多镜容器解决镜长冲突时，
+在生产档案 `choices` 里加 `"multi_shot_containers": true`（同一条决策写入），这条提示随之消失。
+
 项目定位与安全写入见 [运行预检](references/runtime-preflight.md)。用户明确要求 Dashboard 时运行：
 
 ```bash

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

@@ -16,12 +16,12 @@
 当前状态与变化原因，不要抄剧情摘要，也不要把瞬时姿势或镜头角度升级成新资产。
 
 ```markdown
-## 人物 · 江辰
+## 人物 · 许棠
 - 识别锚点：窄长眼、左眉尾旧疤、肩背略绷。
 - 本集造型：深灰旧西装，右袖口有雨水深痕。
 - 状态变化：EP001-SC003 后右手掌沾血。
 - 画面代称：Jiangchen
-- 连续性锁：LOCK-JIANGCHEN-SUIT《江辰深灰旧西装》（镜头：全集；图片提示词项：IMG-JIANGCHEN-SHEET）· 锁面：dark-grey worn wool suit
+- 连续性锁：LOCK-XUTANG-SUIT《许棠深灰旧西装》（镜头：入画；图片提示词项：IMG-XUTANG-SHEET）· 锁面：dark-grey worn wool suit
 ```
 
 二级标题固定写成 `## <人物|造型|地点|道具> · <名称>`；分镜的「视觉依据」按这个标题定位条目。
@@ -41,7 +41,9 @@
 `状态变化`。一行一把锁：
 
 - `LOCK-...` 在本集唯一，与 `IMG-...`、`REF-...`、`SHOT-...` 互不混用；
-- `镜头：` 写 `全集` 或 `、` 分隔的 `SHOT-...` 列表，两者不能混写；
+- `镜头：` 写 `入画`、`全集` 或 `、` 分隔的 `SHOT-...` 列表，三者不能混写。`入画` 指「视觉依据」列出本条目的所有镜头，
+  资产阶段还没有分镜时就能写；锁的是服装、发型这类只在部分景别里看得见的事实时，把锁写在对应的 `造型` 条目下，
+  只拍脸的镜头不列这个造型，就不会被迫带上锁面；
 - `；图片提示词项：` 可选，写 `、` 分隔的 `IMG-...` 列表；
 - `· 锁面：` 之后是被逐字带走的最小名词短语，用项目提示词语言写，不含标点、动作和剧情。
 
@@ -59,12 +61,12 @@
 - 目的：先让观众看见他不敢进门，再揭示门内争吵。
 - 景别/机位：中近景，门框外侧，轻微低机位。
 - 运镜：固定；他收手的那一下要自己被看见，机位不抢。
-- 起点：江辰右手悬在门把上方。
-- 唯一动作：门内玻璃落地声触发江辰收回右手，视线从门把转向门缝。
-- 终点：江辰右手垂回身侧，视线落在门缝。
-- 图片提示词项：IMG-JIANGCHEN-SHEET《江辰角色板》（控制：身份、体态、本集造型）；IMG-CORRIDOR-NIGHT《夜间走廊场景板》（控制：空间地理、门位、光向）。
-- 输入参考图：无（待补参考图：江辰本集造型、夜间走廊地理、本镜起始帧）。
-- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态、本集造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
+- 起点：许棠右手悬在门把上方。
+- 唯一动作：门内玻璃落地声触发许棠收回右手，视线从门把转向门缝。
+- 终点：许棠右手垂回身侧，视线落在门缝。
+- 图片提示词项：IMG-XUTANG-SHEET《许棠角色板》（控制：身份、体态、本集造型）；IMG-CORRIDOR-NIGHT《夜间走廊场景板》（控制：空间地理、门位、光向）。
+- 输入参考图：无（创作者已明确选择文生视频）。
+- 视觉依据：《视觉设定.md》·人物「许棠」（控制：身份、体态、本集造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
 
 ### 冻结关键帧提示词
 > 按项目提示词语言编写的冻结瞬间正文……
@@ -75,6 +77,17 @@
 只写有镜头职责的镜头。关键帧提示词必须与该镜“起点”一致；终点才出现的文字、动作或状态不得
 提前进入静帧，也不要把整段动作塞进静帧。
 
+一场戏拍成多镜时，在第一个 `SHOT-...` 之前为它写一段「场景站位」，镜头只写相对它的变化。
+位置写场景锚点和人物关系，视线写看向谁或什么；冻结关键帧和视频提示词再按本镜机位写前后景、朝向和画面左右：
+
+```markdown
+## 场景站位 · EP001-SC001 · 旧走廊
+- 固定锚点：走廊一端是江家的门，另一端是楼梯口；顶灯在门前
+- 人物：许棠站在门外，面对门，背对楼梯口
+- 轴线：许棠 ↔ 门；working side：楼梯口一侧
+- 变化：无
+```
+
 三类依据不得混用：
 
 - **图片提示词项**：《图片提示词.md》中可见二级标题的 `IMG-...` 条目，只证明提示词存在；
@@ -85,7 +98,7 @@
 按成稿画面逐项回填，语法固定：
 
 ```markdown
-- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
+- 视觉依据：《视觉设定.md》·人物「许棠」（控制：身份、造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
 ```
 
 - `《视觉设定.md》·` 只写一次，条目之间用 `；` 连接，条目名称必须能在《视觉设定.md》里找到同名标题；
@@ -143,8 +156,8 @@ PLAN-<slot>（顺序：<n>）· <IMG-... 或 SHOT-...>《<中文名称>》（用
 
 ```markdown
 - 图片提示词项：无
-- 输入参考图：无（待补参考图：江辰身份、旧走廊地理、本镜起始帧）
-- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
+- 输入参考图：无（待补参考图：许棠身份、旧走廊地理、本镜起始帧）
+- 视觉依据：《视觉设定.md》·人物「许棠」（控制：身份、造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
 ```
 
 提示词条目和真实图片是独立的：有 `IMG-...` 条目时，「输入参考图」可以仍为「无」；创作者给了
@@ -152,30 +165,30 @@ PLAN-<slot>（顺序：<n>）· <IMG-... 或 SHOT-...>《<中文名称>》（用
 
 ```markdown
 - 图片提示词项：无
-- 输入参考图：REF-JIANGCHEN-LOOK（顺序：1）· 输入/参考图/江辰定妆.jpg《江辰定妆照》（用途：造型状态；控制：本集造型、面料质感；不得控制：镜头构图、动作、表情）
-- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态）。
+- 输入参考图：REF-XUTANG-LOOK（顺序：1）· 输入/参考图/许棠定妆.jpg《许棠定妆照》（用途：造型状态；控制：本集造型、面料质感；不得控制：镜头构图、动作、表情）
+- 视觉依据：《视觉设定.md》·人物「许棠」（控制：身份、体态）。
 ```
 
 只准备了一部分时，已核对的图不丢弃，但必须把缺口留在同一字段中：
 
 ```markdown
-- 输入参考图：REF-JIANGCHEN-LOOK（顺序：1）· 输入/参考图/江辰定妆.jpg《江辰定妆照》（用途：身份；控制：脸型、体态、本集造型；不得控制：场景地理、构图、动作）；待补参考图：夜间走廊地理、本镜起始帧
+- 输入参考图：REF-XUTANG-LOOK（顺序：1）· 输入/参考图/许棠定妆.jpg《许棠定妆照》（用途：身份；控制：脸型、体态、本集造型；不得控制：场景地理、构图、动作）；待补参考图：夜间走廊地理、本镜起始帧
 ```
 
 创作者在自己的工具里出图时，本镜要挂哪几张、按什么次序挂，写成 `PLAN-...`：
 
 ```markdown
-- 图片提示词项：IMG-JIANGCHEN-SHEET《江辰角色板》（控制：身份、体态）
-- 输入参考图：PLAN-SHOT-START（顺序：1）· SHOT-EP001-001《本镜冻结关键帧》（用途：起始帧；控制：起始构图、站位；不得控制：尚未发生的动作、终态）；PLAN-JIANGCHEN（顺序：2）· IMG-JIANGCHEN-SHEET《江辰角色板》（用途：身份；控制：脸型、体态、本集造型；不得控制：构图、动作、表情）
-- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态）；地点「旧走廊」（控制：空间地理、出入口）。
+- 图片提示词项：IMG-XUTANG-SHEET《许棠角色板》（控制：身份、体态）
+- 输入参考图：PLAN-SHOT-START（顺序：1）· SHOT-EP001-001《本镜冻结关键帧》（用途：起始帧；控制：起始构图、站位；不得控制：尚未发生的动作、终态）；PLAN-XUTANG（顺序：2）· IMG-XUTANG-SHEET《许棠角色板》（用途：身份；控制：脸型、体态、本集造型；不得控制：构图、动作、表情）
+- 视觉依据：《视觉设定.md》·人物「许棠」（控制：身份、体态）；地点「旧走廊」（控制：空间地理、出入口）。
 ```
 
 两者也可同时存在，但各用各的定位符：
 
 ```markdown
-- 图片提示词项：IMG-JIANGCHEN-SHEET《江辰角色板》（控制：身份、体态）
+- 图片提示词项：IMG-XUTANG-SHEET《许棠角色板》（控制：身份、体态）
 - 输入参考图：REF-CORRIDOR-COMPOSITION（顺序：1）· 输入/参考图/走廊构图.jpg《走廊构图参考》（用途：构图；控制：占画比例、留白；不得控制：人物身份、动作、剧情事件）
-- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态）；地点「旧走廊」（控制：空间地理、出入口）。
+- 视觉依据：《视觉设定.md》·人物「许棠」（控制：身份、体态）；地点「旧走廊」（控制：空间地理、出入口）。
 ```
 
 ## `图片提示词.md`
@@ -185,7 +198,7 @@ PLAN-<slot>（顺序：<n>）· <IMG-... 或 SHOT-...>《<中文名称>》（用
 这里的 `IMG-...` 是提示词条目 ID，不是已生成图片的记录。
 
 ```markdown
-## IMG-JIANGCHEN-SHEET · 江辰角色板
+## IMG-XUTANG-SHEET · 许棠角色板
 - 用途：锁定身份、体态和本集造型。
 - 参考：无；若有真实参考图，使用与分镜相同的完整 `REF-...` 格式，说明顺序、项目相对路径、中文名称、用途、控制与不得控制范围。
 
@@ -215,7 +228,7 @@ caption 和对白文字叠加，不能只写抽象的“文字层为空”，让
 - 生成方式：文生视频
 - 输入参考图：无（创作者已明确选择文生视频）。
 - 静态视觉锚点：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 的冻结关键帧
+- 起始帧：许棠右手悬在门把上方，视线落在门把上。
 - 状态链：右手悬在门把上方 → 门内玻璃落地触发他收回右手并转移视线 → 右手收回，视线落到门缝
 - 终点：右手收回；门内玻璃落地；人物视线转向门缝。
 
@@ -226,10 +239,25 @@ caption 和对白文字叠加，不能只写抽象的“文字层为空”，让
 有真实输入图时改用「生成方式：图生视频」，并原样携带分镜的完整 REF 声明；静态视觉锚点只写
 执行动作所需、且不能仅靠参考图用途推断的可见起点，不把路径或 REF ID 放进可复制正文。
 
+几个相邻镜头装进一次生成（多镜容器）时，另写一个 `GROUP-...` 条目，它的可复制提示词就是真正提交的
+那一条；逐镜 `MOTION-...` 照写，作为成员依据。`GROUP-...` 可以写在文档任何位置：
+
+```markdown
+## GROUP-EP001-01 · 门外到门内
+- 成员：MOTION-EP001-001、MOTION-EP001-002
+- 时长：8s
+- 理由：同场连续，同一走廊地理与人物造型
+
+### 可复制提示词
+> 镜头1：…… 镜头2：……
+```
+
+检查器核对成员相邻、同场、时长等于成员之和、一个镜头只进一个分组，以及分组正文的引文与锁面。
+
 ## 共通规则
 
 - 提示词正文必须可直接复制，不放占位符、流程备注或 QA 结论。
 - `### 可复制提示词` 下的引用块是**一条**提示词：从第一行到最后一行整段复制进那一次生成。方言把它分成 `subject_definitions` / `overall_soundscape` 这类段落时，段落仍属于同一条正文，不是分几次提交，也不是只交第一段。
 - 引用使用文档里看得见的场景/镜头/提示词 ID；不写文件哈希和内部路径。
 - 用户没要求的字段不为“完整”而补造。
-- 五份文档齐备后，完成或修订时运行 `python3 {技能目录}/scripts/creator_markdown_check.py 剧集/<EP> --project-root .`，核对跨文档结构。检查器缺任一文件即返回缺文件；局部任务只核对当前已有文档，不为运行检查补造其余文件。内容质量仍由创作者审查。
+- 每完成或修订一份文档就运行 `python3 {技能目录}/scripts/creator_markdown_check.py 剧集/<EP> --project-root . --partial`，只核对已有的文档；缺的文档相关的规则跳过，不算通过也不算失败，不为运行检查补造文件。五份齐备后去掉 `--partial` 做完整核对，缺任一文件即报缺。内容质量仍由创作者审查。

package/lib/drama/skills/short-drama/references/reference-roles.md

@@ -6,7 +6,7 @@
 
 1. 它的稳定槽位和显式顺序是什么：项目内图片用 `REF-...`，项目外由创作者自行挂载的图用 `PLAN-...`；
 2. 它的可见定位符和中文名称是什么：图片在项目里时写项目相对路径，例如
-   `输入/参考图/江辰定妆.jpg《江辰定妆照》`；图片由创作者在项目外准备并在生成时自行挂载时，
+   `输入/参考图/许棠定妆.jpg《许棠定妆照》`；图片由创作者在项目外准备并在生成时自行挂载时，
    写它对应的 `IMG-...` 板子或 `SHOT-...` 冻结关键帧；
 3. 本次参考身份、造型状态、地理、构图、尺度、效果、起始帧、结束帧还是风格；
 4. 哪些可见内容允许照着写；