@oh-story/dsh 0.1.6 → 0.1.7

package/lib/drama/manifest.json

@@ -2,9 +2,9 @@
   "schemaVersion": 1,
   "upstream": {
     "repository": "https://github.com/zenstory-ai/drama-skills.git",
-    "commit": "ebcb02ea488132da9211f8c76e71e03b6f1956a0"
+    "commit": "4cd584668bf6dc613a51d1ca40d00de352db9713"
   },
-  "generatedAt": "2026-09-02T02:39:35.239Z",
+  "generatedAt": "2026-09-04T14:24:07.064Z",
   "skills": [
     "short-drama",
     "short-drama-assets",
@@ -445,8 +445,8 @@
     },
     {
       "path": "skills/short-drama-produce/SKILL.md",
-      "sha256": "e9f3678b49a156ada1d777457101f6bc6703f5d1c77a737099a51bd4cc41dbde",
-      "bytes": 11989
+      "sha256": "9eb35a905f94fea67852d8437e1f5640a5d4090d71ac645e4857958f04b2c08e",
+      "bytes": 12422
     },
     {
       "path": "skills/short-drama-produce/agents/openai.yaml",
@@ -485,8 +485,8 @@
     },
     {
       "path": "skills/short-drama-produce/scripts/production_tool.py",
-      "sha256": "6b13682f4769495ee1cddb678651c48572623a1480c070d1b2565262761388df",
-      "bytes": 77848
+      "sha256": "b39253946f17ff966ce661ca365cdda5b2ea25d1b43466399d839fbb3bebe745",
+      "bytes": 79461
     },
     {
       "path": "skills/short-drama-produce/scripts/provider_adapters.py",
@@ -590,8 +590,8 @@
     },
     {
       "path": "skills/short-drama-storyboard/SKILL.md",
-      "sha256": "e3d444376dd3a6e8e51efe3b03bc1167eeadb3005d1a9dd7ed42399256359275",
-      "bytes": 14011
+      "sha256": "187b38c3f17742959403cee6d99d688361bc8d62ef720a4e4096fd1adb6e0f26",
+      "bytes": 16588
     },
     {
       "path": "skills/short-drama-storyboard/agents/openai.yaml",
@@ -660,8 +660,8 @@
     },
     {
       "path": "skills/short-drama-storyboard/references/review-and-fixtures.md",
-      "sha256": "c71f525973c895849e7b1cb8807ddac9e60c31afe16dd8e521960ca8cc178d51",
-      "bytes": 3067
+      "sha256": "230026c548e9cb8ab2bb38e37a0c10acd7be07124e447560ac015d9c383997fd",
+      "bytes": 3326
     },
     {
       "path": "skills/short-drama-storyboard/references/scene-visual-plan.md",
@@ -685,8 +685,8 @@
     },
     {
       "path": "skills/short-drama-storyboard/references/stage-contract.md",
-      "sha256": "2aabdd9043869ec87569b61f70e593517c91cdfc605c1deaa7f781241da6a86e",
-      "bytes": 8691
+      "sha256": "8624622c16dc60ca56aeba67f7d68c10c3f972ff533d6fbc484694a07ab5ae0e",
+      "bytes": 9148
     },
     {
       "path": "skills/short-drama-storyboard/scripts/selftest.py",
@@ -700,8 +700,8 @@
     },
     {
       "path": "skills/short-drama-video-prompts/SKILL.md",
-      "sha256": "de7681a06df9f7fa78d609065400ce1588fc929853614b125a231c4257dc5a34",
-      "bytes": 14289
+      "sha256": "6af04f52c90b92120648cc703dd3f85f6225afa428a76d7b5c61471baea39250",
+      "bytes": 15419
     },
     {
       "path": "skills/short-drama-video-prompts/agents/openai.yaml",
@@ -740,8 +740,8 @@
     },
     {
       "path": "skills/short-drama-video-prompts/assets/video-prompts.md",
-      "sha256": "e6aa175dc99c14d593b9bd61bf99c581f9986bf03fda4da28a4a5f3596045a39",
-      "bytes": 4634
+      "sha256": "541784158cf7eb297d023ecc471a3333a6615f1a0ebb25f5e083d6d6a7b7e9ec",
+      "bytes": 5267
     },
     {
       "path": "skills/short-drama-video-prompts/examples/minimal-music-specs.jsonl",
@@ -765,8 +765,8 @@
     },
     {
       "path": "skills/short-drama-video-prompts/references/minimax-h3.md",
-      "sha256": "1f1e619cf0e5b5a84bb7d09d65748d5df11aba79bbbeb7d614240957a9905f9c",
-      "bytes": 9840
+      "sha256": "d83692c446175da092521ec11f4fbcbb0861b9ac96ce1bb426e73e9a3dfcdb02",
+      "bytes": 11266
     },
     {
       "path": "skills/short-drama-video-prompts/references/motion-recipe.md",
@@ -800,13 +800,13 @@
     },
     {
       "path": "skills/short-drama-video-prompts/references/stage-contract.md",
-      "sha256": "adc27a15538db3db3fb8d04278653c6cedb0c5944b1103559c4926549d69a4eb",
-      "bytes": 9932
+      "sha256": "9e24f8e5459dfc50c4fdb00dd0d37b14c2586f582caaa934df72031bb263111a",
+      "bytes": 11068
     },
     {
       "path": "skills/short-drama-video-prompts/references/target-model-profile.md",
-      "sha256": "0eb11385cb1a9d8108bc42044562e3b86f316acbc3752ea06fa1aba1fde6e1c1",
-      "bytes": 8709
+      "sha256": "10a1136ca36c2e16195840cde69631bd1fab99960b31445120e5bdef506e619d",
+      "bytes": 9029
     },
     {
       "path": "skills/short-drama-video-prompts/scripts/container_check.py",
@@ -925,8 +925,8 @@
     },
     {
       "path": "skills/short-drama/SKILL.md",
-      "sha256": "8cec2c92391c017074dd3a4fc8c3ab00a85b5e9c2f52870423499e488b88fc45",
-      "bytes": 9371
+      "sha256": "0fe4e5630d93eea97108868f3806fb525661062d0636c12b8d7d2bd5d1e147ad",
+      "bytes": 9772
     },
     {
       "path": "skills/short-drama/agents/openai.yaml",
@@ -960,18 +960,18 @@
     },
     {
       "path": "skills/short-drama/references/contract-and-ownership.md",
-      "sha256": "8db8bda47e74619ad68bbd86dd0e63e3f6c9c27fb1a8a599a79950755c2507f3",
-      "bytes": 2419
+      "sha256": "4e6522648f47a51612251153767f15daaaacad8a014b0aa63a8b9666f342ce91",
+      "bytes": 2861
     },
     {
       "path": "skills/short-drama/references/creator-documents.md",
-      "sha256": "d4e0c13e41859cc78aa902561060dcb2fde39b72a01edcf5924b58b19d17989a",
-      "bytes": 14026
+      "sha256": "3176642b8395c0967c2ec829c56db00fc3393ee20afc16fddda691431c1b8293",
+      "bytes": 16416
     },
     {
       "path": "skills/short-drama/references/creator-workflow.md",
-      "sha256": "b7a6ef8d2fafce3fab1efbb91531dfa70a3d2713003f2cc1e3a14fc4d7afb626",
-      "bytes": 5660
+      "sha256": "5796f68fe3242da4010036ce3c7ff1f22edf548acb80caff9b988b69921d28cd",
+      "bytes": 5934
     },
     {
       "path": "skills/short-drama/references/form-cards/Q版表达.md",
@@ -1025,8 +1025,8 @@
     },
     {
       "path": "skills/short-drama/references/reference-roles.md",
-      "sha256": "536b50bdff1194ed3a8d3f72c3f1a4a75aa851fb30ce0a173853b469d4c26260",
-      "bytes": 2873
+      "sha256": "2f6480db79c179269fad2a492e9bef782ad9be0a1436b243d9f5627987e89012",
+      "bytes": 4326
     },
     {
       "path": "skills/short-drama/references/runtime-preflight.md",
@@ -1035,8 +1035,8 @@
     },
     {
       "path": "skills/short-drama/scripts/creator_markdown_check.py",
-      "sha256": "2ea4596b7f2de62065186fb09208baa86a345a54be1fd596630a7d5d702dd16e",
-      "bytes": 43157
+      "sha256": "f34e71b24bf725e105c4b943370064c6e7fa5d389e1835fb3c6a467ba2c05617",
+      "bytes": 55674
     },
     {
       "path": "skills/short-drama/scripts/project_tool.py",

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

@@ -46,7 +46,10 @@ license: MIT
 6. 请求横跨视觉设定、图片提示词、分镜或视频提示词时，结束前按当前五文档做一次视觉依赖对账；
    不因图片提示词和分镜可并行，就把后完成的一支留在另一支的旧引用之外。
 7. 视频提示词请求遇到「输入参考图：无」或仍带「待补参考图」时，先路由分镜 owner 检查项目已有图片并刷新绑定。有匹配图就同请求续跑；有必要图缺失就列表停下。
-   只有用户明确选择文生视频才允许无图续跑，不把“没有手工指定”当成这个选择。这一轮如果镜头还缺「视觉依据」，
+   停下时把三条路一起给出：把已有图片放进项目绑成 `REF-...`；由创作者在自己的工具里出图、本轮先用
+   `PLAN-...` 写出逐镜挂图计划并照常产出视频提示词；或者明确改走文生视频。用本套件生产参考图需要项目外的
+   adapter 与凭据，只是第一条路的一种做法，不要把它说成唯一入口，也不要只给「生成参考图 / 文生视频」两个选项。
+   不把“没有手工指定”当成明确选择文生视频。这一轮如果镜头还缺「视觉依据」，
    同时按已成稿的冻结关键帧回填；两条依据描述同一格画面，不要只补一条。
 8. 用户在会话里点名目标视频模型（“按 MiniMax H3 写”“用 Seedance 2.5”）而 `short-drama.json` 的
    `production_profile` 还是 `unset` 时，先把这个选择连同它带来的原生时长、参考方式和正文语言写进档案，

package/lib/drama/skills/short-drama/references/contract-and-ownership.md

@@ -28,6 +28,8 @@
 
 真实输入参考图不是图片提示词条目，所以每张图使用独立稳定的 `REF-...` 槽位，槽位内写显式顺序、可见项目相对路径、中文名称、用途和控制范围。它不使用 `IMG-...`；路径只用 `/` 分隔，不写绝对路径、Windows 盘符/网络路径或项目外路径。
 
+图片由创作者在项目外准备、生成时自行挂载时没有项目内路径可写，改用 `PLAN-...` 槽位：其余字段与 `REF-...` 相同，定位符写这张图对应的 `IMG-...` 板子或 `SHOT-...` 冻结关键帧。这里出现 `IMG-...` 不是把提示词条目当成图片，而是回答「这张图画的是哪一条已决定的事实」；`PLAN-...` 不声称项目里有文件，也因此不能作为生产输入。
+
 ## 规则分级
 
 - `structural_invariant`：本地可证明的引用、ID、算术或显式矛盾；

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

@@ -111,10 +111,25 @@ REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途
 `起始帧`、一张 `结束帧`，且写 `结束帧` 时必须同时有 `起始帧`。有了 `用途`，视频提示词就能直接回答
 「本镜要送哪一张分镜起始帧、哪些人物/道具/场景图」，生产端也不必再猜每张图的职责。
 
-「输入参考图」有三种准备结果，不能把后两种混在一起：
+创作者在别处出图时，图片不会进项目，`REF-...` 也就无从写起。这时用 `PLAN-...` 槽位，
+语法与 `REF-...` 完全一致，只把定位符从项目相对路径换成本项目已有的条目 ID：
 
-- 已绑定 `REF-...`：图片真实存在，可进入图生/参考生视频；
-- 待补：一张都没有时写 `无（待补参考图：……）`；只缺一部分时保留已有 `REF-...`，末尾追加 `；待补参考图：……`。视频提示词尚未就绪；
+```markdown
+PLAN-<slot>（顺序：<n>）· <IMG-... 或 SHOT-...>《<中文名称>》（用途：<用途>；控制：<范围>；不得控制：<范围>）
+```
+
+`IMG-...` 指《图片提示词.md》的板子，`SHOT-...` 指那一镜的冻结关键帧；两者都必须在当前项目里
+解析得到，`IMG-...` 的中文名称还要和它的标题一致。`PLAN-...` 说的是「这张图不在项目里，
+生成时由创作者按这个顺序挂载」，与「已有图片」和「待补」都不是同一句话：它不声称文件存在，
+也不表示还在等谁。`顺序` 就是创作者在生成界面里挂图的次序，也是可复制正文里 `<Picture N>` 的编号。
+一张已经在项目里的图仍然写 `REF-...`；两种槽位可以在同一条声明里混用，`顺序` 在两者之间统一连续编号。
+
+「输入参考图」有四种准备结果，不能把它们混在一起：
+
+- 已绑定 `REF-...`：图片真实存在于项目中，可进入图生/参考生视频，也可交给生产技能执行；
+- 已声明 `PLAN-...`：图片由创作者在项目外准备并在生成时自行挂载，视频提示词照常产出；
+  本套件没有文件可送，所以这些镜头不能进入生产技能，需要投产时先把真实文件放进项目并改写成 `REF-...`；
+- 待补：一张都没有时写 `无（待补参考图：……）`；只缺一部分时保留已有 `REF-...` 或 `PLAN-...`，末尾追加 `；待补参考图：……`。视频提示词尚未就绪；
 - `无（创作者已明确选择文生视频）`：创作者在了解一致性影响后明确不用图，可进入文生视频。
 
 `IMG-...` 只用于查找，不靠英文 slug 向创作者解释含义。每个引用都同时写简短中文名称和
@@ -142,6 +157,14 @@ REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途
 - 输入参考图：REF-JIANGCHEN-LOOK（顺序：1）· 输入/参考图/江辰定妆.jpg《江辰定妆照》（用途：身份；控制：脸型、体态、本集造型；不得控制：场景地理、构图、动作）；待补参考图：夜间走廊地理、本镜起始帧
 ```
 
+创作者在自己的工具里出图时，本镜要挂哪几张、按什么次序挂，写成 `PLAN-...`：
+
+```markdown
+- 图片提示词项：IMG-JIANGCHEN-SHEET《江辰角色板》（控制：身份、体态）
+- 输入参考图：PLAN-SHOT-START（顺序：1）· SHOT-EP001-001《本镜冻结关键帧》（用途：起始帧；控制：起始构图、站位；不得控制：尚未发生的动作、终态）；PLAN-JIANGCHEN（顺序：2）· IMG-JIANGCHEN-SHEET《江辰角色板》（用途：身份；控制：脸型、体态、本集造型；不得控制：构图、动作、表情）
+- 视觉依据：《视觉设定.md》·人物「江辰」（控制：身份、体态）；地点「旧走廊」（控制：空间地理、出入口）。
+```
+
 两者也可同时存在，但各用各的定位符：
 
 ```markdown
@@ -167,11 +190,14 @@ REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途
 
 ## `视频提示词.md`
 
-与分镜一一对应时沿用镜头号并使用 `MOTION-...` ID。若「输入参考图」中的 `REF-...` 已全部就绪，使用图生视频，正文
+与分镜一一对应时沿用镜头号并使用 `MOTION-...` ID。若「输入参考图」中的 `REF-...` 与 `PLAN-...` 已全部就绪，使用图生视频，正文
 只需重述运动所需的局部起点和防漂移事实；只有「输入参考图：无（创作者已明确选择文生视频）」才使用文生视频，正文必须自足地
 包含人物、造型、地点、构图、光线等本镜需要的静态视觉锚点，不能用 `preserve/保持已有外观`
 代替模型并未收到的图片。「待补参考图」会阻止最终视频提示词；视频文档中的「输入参考图」必须与对应分镜逐字一致。
 
+可复制正文里被引号或 `<d>` 包起来的中文，必须能在《剧本.md》或《视觉设定.md》里找到同样的字。
+提示词负责把已确认的台词送到执行端，不负责替角色补一句更好的台词。
+
 除非剧本或创作者明确要求，视频正文用项目提示词语言直接声明全镜任何时刻都不生成非画内字幕、
 caption 和对白文字叠加，不能只写抽象的“文字层为空”，让对白只通过声音与口型发生。旗帜、标牌、
 屏幕等画内文字另走已接受的文字政策：`exact_readable` 逐字携带准确

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

@@ -66,13 +66,19 @@ EP001 的角色图和场景图在 输入/参考图/ 下，本镜起始帧在 剧
 请按这些图写 MiniMax H3 的图生视频提示词，逐镜说明送哪一张起始帧、哪些人物/道具/场景图。
 ```
 
+```text
+参考图我自己在 MiniMax 的界面里出，不进项目。EP001 按 H3 写视频提示词，
+逐镜告诉我要挂哪几张图、按什么顺序挂、每张管什么。
+```
+
 ```text
 这一集没有也不打算做参考图，明确走文生视频，静态视觉锚点写足。
 ```
 
 一句请求里值得交代的是四件事：**做哪一集的哪一阶段**、**目标视频模型**、**参考图在哪里或还没有**、
-**没有图时是等图还是明确走文生视频**。前三件缺一件，技能会来问或按已接受档案推进；最后一件从不替
-创作者假设——没有说“明确走文生视频”，就当成还在等图。
+**没有图时怎么办**。前三件缺一件，技能会来问或按已接受档案推进；最后一件从不替创作者假设。
+第四件有三个答案：等图、由创作者自己在别处出图并挂载（写成 `PLAN-...`）、或者明确走文生视频；
+一个都没说时，就当成还在等图。
 
 结构检查服务于发现错误，不是创作门禁。能在当前文档直接修正的问题直接修正；审查、归档和媒体
 生产只有用户点名时开始。安装 selftest、全量 QA 和 demo 验证属于技能维护，不属于普通创作请求。

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

@@ -5,7 +5,9 @@
 ## 每张参考回答五个问题
 
 1. 它的稳定 `REF-...` 槽位和显式顺序是什么；
-2. 它的可见项目相对路径和中文名称是什么，例如 `输入/参考图/江辰定妆.jpg《江辰定妆照》`；
+2. 它的可见定位符和中文名称是什么：图片在项目里时写项目相对路径，例如
+   `输入/参考图/江辰定妆.jpg《江辰定妆照》`；图片由创作者在项目外准备并在生成时自行挂载时，
+   写它对应的 `IMG-...` 板子或 `SHOT-...` 冻结关键帧；
 3. 本次参考身份、造型状态、地理、构图、尺度、效果、起始帧、结束帧还是风格；
 4. 哪些可见内容允许照着写；
 5. 哪些身份、文字、人数、道具和空间锚点不能跟着变。
@@ -26,13 +28,25 @@
 | 结束帧 | 本镜明确终点 | 新终点或未由镜头承担的结果 |
 | 风格 | 色彩层级、材质、阴影边缘、景深、密度 | 身份、固定地理、剧情、道具文字 |
 
+`身份` 和 `造型状态` 的界线是「本集之内会不会变」，不是「算不算衣服」。一张角色板同时固定长相和
+本集从头到尾不变的造型时，写一个 `身份` 槽位，并把 `本集造型` 明确列进 `控制`——这是本套件的既定写法。
+只有在本集之内会改变的状态（换装、湿透、破损、血污）才另开 `造型状态` 槽位，让它管那一次改变。
+判断依据永远是这个槽位自己写下的 `控制` 范围，不是用途名称的字面意思。
+
+道具板落在 `身份` 还是 `造型状态`，按这张图决定的是「它是哪一件」还是「它此刻处在哪个状态」：
+固定的形制、配色、裂纹与磕角这类跨镜不变的识别标记写 `身份`；亮屏/熄屏、开合、湿污、破损程度
+这类会随剧情改变的写 `造型状态`。同一件道具的两者都需要固定时，拆成两个槽位。
+
 ## 观察边界
 
 创作者或权利人给出的可核对说明可以作为文字证据；运行环境获授权看过参考图时，可以报告实际可见
 内容。两者都没有时保持“未验证”，不得声称水印、文字、裁切或身份已经通过。负面提示词不能擦掉
 参考图已有的像素。
 
-真实参考图使用 `REF-...` 稳定槽位，不使用 `IMG-...`；后一前缀专属《图片提示词.md》的可见提示词标题。多张真实图的每个槽位绑定显式顺序、项目相对路径、中文名称、用途、可控制范围和不可控制范围；联系表只是浏览包装，不改变每张图自己的用途。首尾帧默认只使用起点；
+真实参考图使用 `REF-...` 稳定槽位，不使用 `IMG-...`；后一前缀专属《图片提示词.md》的可见提示词标题。
+创作者自己挂载的图使用 `PLAN-...` 槽位，语法与 `REF-...` 相同，只把路径换成它对应的 `IMG-...` 或
+`SHOT-...` 条目——这五个问题的答案一个不少，只是第 2 问答的是「这张图画的是哪一条已决定的事实」，
+而不是「文件在哪里」。上表九个用途对两种槽位同样适用。多张真实图的每个槽位绑定显式顺序、项目相对路径、中文名称、用途、可控制范围和不可控制范围；联系表只是浏览包装，不改变每张图自己的用途。首尾帧默认只使用起点；
 确实需要终点帧时，它只能投影 `SHOT-...` 已写明的终点，不能自行发明结果。
 
 观众知情时机见 [观众揭示](audience-reveal.md)，补拍是否能替代母版见