@oh-story/dsh 0.1.4 → 0.1.6

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

@@ -11,16 +11,41 @@
 
 ## `视觉设定.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。
@@ -32,8 +57,11 @@
 - 目的：先让观众看见他不敢进门，再揭示门内争吵。
 - 景别/机位：中近景，门框外侧，轻微低机位。
 - 起点：江辰右手悬在门把上方。
-- 终点：手收回，门内传来玻璃落地声。
-- 参考：IMG-JIANGCHEN-SHEET；IMG-OLD-DOOR；IMG-CORRIDOR-NIGHT。
+- 唯一动作：门内玻璃落地声触发江辰收回右手，视线从门把转向门缝。
+- 终点：江辰右手垂回身侧，视线落在门缝。
+- 图片提示词项：IMG-JIANGCHEN-SHEET《江辰角色板》（控制：身份、体态、本集造型）；IMG-CORRIDOR-NIGHT《夜间走廊场景板》（控制：空间地理、门位、光向）。
+- 输入参考图：无（待补参考图：江辰本集造型、夜间走廊地理、本镜起始帧）。
+- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态、本集造型）；地点「旧走廊」（控制：空间地理、出入口、光向）。
 
 ### 冻结关键帧提示词
 > 按项目提示词语言编写的冻结瞬间正文……
@@ -42,15 +70,96 @@
 只写有镜头职责的镜头。关键帧提示词必须与该镜“起点”一致；终点才出现的文字、动作或状态不得
 提前进入静帧，也不要把整段动作塞进静帧。
 
+三类依据不得混用：
+
+- **图片提示词项**：《图片提示词.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-...` 格式，说明顺序、项目相对路径、中文名称、用途、控制与不得控制范围。
 
 ### 可复制提示词
 > 按项目提示词语言编写的正文……
@@ -58,22 +167,38 @@
 
 ## `视频提示词.md`
 
-与分镜一一对应时沿用镜头号并使用 `MOTION-...` ID。正文只描述从已确认起点到终点的变化，
-不重复静帧已经锁定的外观。
+与分镜一一对应时沿用镜头号并使用 `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

@@ -23,8 +23,17 @@
 工作区，不是单集创作真相。其存在不会改变 `剧集/<EP>/` 的五文档布局，也不能要求单集 owner
 补造并行结构化产物。
 
-创作者说明跟随项目语言。图片、关键帧和视频的可复制正文跟随 `prompt_language`；没有
-`short-drama.json` 时默认使用 `en`，同一任务保持一致。两种语言互相独立，不能用一个推断另一个。
+创作者说明跟随项目语言。图片和关键帧正文跟随 `prompt_language`；视频正文优先跟随目标视频模型
+档案的 `video_prompt_language` 和 `video_prompt_dialect`，未声明时回退 `prompt_language` 与通用自然语言。
+`native_duration_seconds` 在分镜规划时生效，不能等生产提交才发现镜头不合法。没有 `short-drama.json` 时，图片与
+关键帧正文默认使用 `en`；视频正文根据目标模型确认，目标也未声明时沿用用户当前语言。描述语言、
+对白口语语言和画内文字互相独立，不能用一个推断另一个。
+
+用户在 Brief 或当前请求中已经给出的项目级事实要在初始化时同步到 `short-drama.json`：至少包括已确认的
+集数、单集目标时长、画幅和目标生产档案。生产档案只有 `unset` 与 `accepted` 两种项目级状态；下游只读取
+已接受档案，不用临时状态代替创作者决定。
+同一场次连续生产且目标模型支持续接时，生产档案把连续性路由声明为“上一段实际视频 + 实际尾帧接力”；
+`one-shot-per-generation`、单镜容器或多镜容器只描述打包粒度，不能用来取消这条连续性路由。
 
 ## 请求范围
 
@@ -38,6 +47,33 @@
 2. 缺失事实形成会显著改变剧情或视觉方向的真实创作分叉；
 3. 下一步会调用外部生产，必须先展示精确 job 并取得显式确认。
 
+### 一句话把范围说清楚
+
+请求不需要固定话术，技能也不靠关键词匹配。下面几句只是把「一句话里到底要交代哪几件事」写明白，
+照抄或改写都可以：
+
+```text
+写 EP001 的分镜和每镜冻结关键帧。目标视频模型是 MiniMax H3，先把它写进项目档案。
+```
+
+```text
+EP001 分镜确认采用，按 MiniMax H3 写视频提示词。人物、场景、道具要跨镜一致，
+所以先在项目里找已有的角色图、场景图、道具图和本镜起始帧并绑成参考；缺哪张就列出来，别改成文生视频。
+```
+
+```text
+EP001 的角色图和场景图在 输入/参考图/ 下，本镜起始帧在 剧集/EP001/制作成果/images/ 下，
+请按这些图写 MiniMax H3 的图生视频提示词，逐镜说明送哪一张起始帧、哪些人物/道具/场景图。
+```
+
+```text
+这一集没有也不打算做参考图，明确走文生视频，静态视觉锚点写足。
+```
+
+一句请求里值得交代的是四件事：**做哪一集的哪一阶段**、**目标视频模型**、**参考图在哪里或还没有**、
+**没有图时是等图还是明确走文生视频**。前三件缺一件，技能会来问或按已接受档案推进；最后一件从不替
+创作者假设——没有说“明确走文生视频”，就当成还在等图。
+
 结构检查服务于发现错误，不是创作门禁。能在当前文档直接修正的问题直接修正；审查、归档和媒体
 生产只有用户点名时开始。安装 selftest、全量 QA 和 demo 验证属于技能维护，不属于普通创作请求。
 

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

@@ -38,6 +38,7 @@
 | 有限行动单位与精确时限 | `$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 | 不把重写整图伪装成局部编辑 |
@@ -51,7 +52,9 @@
 | 交付路由与执行触发词 | `$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/reference-roles.md

@@ -2,14 +2,17 @@
 
 绑定参考图等于告诉下游“哪些地方照着它”。不说明边界，身份参考会越权决定服装、构图、背景或文字。
 
-## 每张参考回答四个问题
+## 每张参考回答五个问题
 
-1. 它的稳定可见 ID 是什么，例如 `IMG-JIANGCHEN-SHEET`；
-2. 本次参考身份、造型状态、地点地理、构图、尺度、效果、起点、终点还是风格；
-3. 哪些可见内容允许照着写；
-4. 哪些身份、文字、人数、道具和空间锚点不能跟着变。
+1. 它的稳定 `REF-...` 槽位和显式顺序是什么；
+2. 它的可见项目相对路径和中文名称是什么，例如 `输入/参考图/江辰定妆.jpg《江辰定妆照》`；
+3. 本次参考身份、造型状态、地理、构图、尺度、效果、起始帧、结束帧还是风格；
+4. 哪些可见内容允许照着写；
+5. 哪些身份、文字、人数、道具和空间锚点不能跟着变。
 
-同一张图承担两个作用时分开说明，不写“全参考”。
+第 3 问在创作文档里有固定落点：`REF-...` 槽位的 `用途` 字段，取值只能是下表左列的九个词之一。
+它同时回答创作者的「这一镜要送哪一张分镜起始帧、哪些人物/道具/场景图」，和执行端的「这张图翻成哪个
+供应商 role」。同一张图承担两个作用时分开成两个槽位，不写“全参考”。
 
 | 用途 | 可以控制 | 默认不能控制 |
 |---|---|---|
@@ -29,7 +32,7 @@
 内容。两者都没有时保持“未验证”，不得声称水印、文字、裁切或身份已经通过。负面提示词不能擦掉
 参考图已有的像素。
 
-多张图需要稳定 ID 和明确顺序；联系表只是浏览包装，不改变每张图自己的用途。首尾帧默认只使用起点；
+真实参考图使用 `REF-...` 稳定槽位，不使用 `IMG-...`；后一前缀专属《图片提示词.md》的可见提示词标题。多张真实图的每个槽位绑定显式顺序、项目相对路径、中文名称、用途、可控制范围和不可控制范围；联系表只是浏览包装，不改变每张图自己的用途。首尾帧默认只使用起点；
 确实需要终点帧时，它只能投影 `SHOT-...` 已写明的终点，不能自行发明结果。
 
 观众知情时机见 [观众揭示](audience-reveal.md)，补拍是否能替代母版见

package/lib/drama/skills/short-drama/references/runtime-preflight.md

@@ -8,6 +8,9 @@
 python3 <core>/scripts/project_tool.py init <project> --title "项目名"
 ```
 
+本文各处写作 `python3`；Windows 原生环境没有这个名字，改用 `py -3` 或 `python`。
+套件脚本（含 Dashboard）在 macOS、Linux、WSL 与 Windows 原生都可运行。
+
 创作文档固定写入 `剧集/<EP>/`。只读取当前任务需要的直接输入；不要扫描整个项目寻找可补造的上游。
 
 ## 写入纪律