@oh-story/dsh 0.1.9 → 0.1.10

package/lib/drama/manifest.json

@@ -2,9 +2,9 @@
   "schemaVersion": 1,
   "upstream": {
     "repository": "https://github.com/zenstory-ai/drama-skills.git",
-    "commit": "bc96c5eb9c91cccd1c613c2b34645c35f1989a28"
+    "commit": "795cb805c88a71ebc32d1cdcf624cd84944d8710"
   },
-  "generatedAt": "2026-09-10T13:26:14.809Z",
+  "generatedAt": "2026-09-26T03:08:35.107Z",
   "skills": [
     "short-drama",
     "short-drama-assets",
@@ -81,8 +81,8 @@
     },
     {
       "path": "skills/short-drama-assets/references/character-and-look.md",
-      "sha256": "4c542e4df9e69fe21f7932dcf874ab65693e18b05e8f2f1249878a8f5da3e7c0",
-      "bytes": 11172
+      "sha256": "bb7535e28dfc616a8f101f69b457f57439792515c65b1eb78d020ac786d81b43",
+      "bytes": 11757
     },
     {
       "path": "skills/short-drama-assets/references/continuity-delta.md",
@@ -91,8 +91,8 @@
     },
     {
       "path": "skills/short-drama-assets/references/continuity-lock.md",
-      "sha256": "603e94313f052bff039a5c8c5115dd77be55b50f681ff3a7acf5798747240452",
-      "bytes": 7668
+      "sha256": "8099cee42ee3de35a0c7ce22908f6cb79bdaf61c0cdbecb39907a15e249d39d8",
+      "bytes": 7315
     },
     {
       "path": "skills/short-drama-assets/references/identity-vs-variant.md",
@@ -121,8 +121,8 @@
     },
     {
       "path": "skills/short-drama-assets/references/voice-direction.md",
-      "sha256": "61f4db4876084e181f6b3d36c53a551d733e3d131656dc9a271be9e90913a40f",
-      "bytes": 7741
+      "sha256": "231eb47a9c84917777250a4e4f7f35ecf2d8fef39c12e846ec4b932f3e89a5f1",
+      "bytes": 9819
     },
     {
       "path": "skills/short-drama-assets/scripts/asset_check.py",
@@ -301,8 +301,8 @@
     },
     {
       "path": "skills/short-drama-edit/SKILL.md",
-      "sha256": "ff27a30ed5fddb26a2824a4975bf78d18a506cb1db8d87cf4059716514a2e24e",
-      "bytes": 11031
+      "sha256": "2e53700bceae46e735d0d018324cec936ed6745a234763119735105947b1517e",
+      "bytes": 10416
     },
     {
       "path": "skills/short-drama-edit/agents/openai.yaml",
@@ -356,48 +356,48 @@
     },
     {
       "path": "skills/short-drama-edit/assets/剪辑单.md",
-      "sha256": "fe495fe94d65e04a99918567abdd901c025f6d216bdbff6e9fc93ea8146c53f6",
-      "bytes": 2054
+      "sha256": "3a99c2d7c587702e3bd06588e550faa6b62b905b8432df3bf6263e91524f3e37",
+      "bytes": 1930
     },
     {
       "path": "skills/short-drama-edit/references/cut-craft.md",
-      "sha256": "456b4aa70b0039739751b8fbba54f9a00a103ccb91d0116a09707021f902ca6e",
-      "bytes": 4297
+      "sha256": "25d970ca8100232cb7d4b823aacec4bce9cda9f8cc6e5e26c396251d2b596ac6",
+      "bytes": 2261
     },
     {
       "path": "skills/short-drama-edit/references/delivery-verify.md",
-      "sha256": "f417d537cb87d65562e5838ebf2556b5f5f9412f5b0a522a64f733fe59fef8c5",
-      "bytes": 3242
+      "sha256": "ee097b3166c2b044fdc0db34aa84ef02d9a86c3862d146f12b52dc441e3a7dcb",
+      "bytes": 1821
     },
     {
       "path": "skills/short-drama-edit/references/generated-footage.md",
-      "sha256": "8493ca0a1e45b798c402b8f659b6f61845eed42ac2bd33e0c29e06100665da02",
-      "bytes": 6550
+      "sha256": "d8d45c18d993721079d828a743f79680a54e61e53ed7c664f15e188d42cbaffc",
+      "bytes": 2862
     },
     {
       "path": "skills/short-drama-edit/references/sound-and-subtitles.md",
-      "sha256": "68fa771e8d3c1a18eba0d03e865c350fa7b7d05d8bf22d3c1c6b33189e26447a",
-      "bytes": 7368
+      "sha256": "99d8d38f678c048765a41a33b512e0db6aea53dfdb0d81d7f60cb7b57b25227d",
+      "bytes": 3280
     },
     {
       "path": "skills/short-drama-edit/references/stage-contract.md",
-      "sha256": "fc5ec18b416b992268eece21b6350299a49c8796992f1e6086849149d9bdc1a6",
-      "bytes": 6307
+      "sha256": "21e7fc92c708b8aeed3611b3f11fa14620595328be383302c3be7ede56ed1773",
+      "bytes": 5287
     },
     {
       "path": "skills/short-drama-edit/scripts/edit_tool.py",
-      "sha256": "3b93f7c77c62a61978694dc679606c61366b4ddc131ce9ed3e1f4916aeb17db8",
-      "bytes": 42565
+      "sha256": "5863aed017019a4d8a7de9e4b81946212f503ff05d0059c2d2c28fcb3364f727",
+      "bytes": 47616
     },
     {
       "path": "skills/short-drama-edit/scripts/selftest.py",
-      "sha256": "b28f420d35941ab3a2e6439c91cc5bdf06d572d97865b8d9abcfef0113eb18bb",
-      "bytes": 19403
+      "sha256": "490504c562c54c9acf8385f3eed23dd35bd6164eb5bbbff7b870b41a48bff836",
+      "bytes": 22100
     },
     {
       "path": "skills/short-drama-image-prompts/SKILL.md",
-      "sha256": "a3341fc0c5562ab2808c3e61ed5b9c57e720ea339bea58cf3a65268660d9032f",
-      "bytes": 4255
+      "sha256": "95f0bd1da8a53d887b2d9a98ea085518f1d746390cba275fee0766172f04110b",
+      "bytes": 4510
     },
     {
       "path": "skills/short-drama-image-prompts/agents/openai.yaml",
@@ -436,8 +436,8 @@
     },
     {
       "path": "skills/short-drama-image-prompts/references/common-recipe.md",
-      "sha256": "a185edab74e7cf2c68e9c21057c13808a366b319787ecd0307ac4f6c475a32bb",
-      "bytes": 15099
+      "sha256": "4558ebe60a64cbfe0a2a58a0137e46c12899d36e116a240d883233f4cab92d72",
+      "bytes": 15748
     },
     {
       "path": "skills/short-drama-image-prompts/references/edit-and-revision.md",
@@ -541,8 +541,8 @@
     },
     {
       "path": "skills/short-drama-produce/SKILL.md",
-      "sha256": "8e664f0a3a59c9f89426577c376880b15890b50dd09aa9905373e9b112426876",
-      "bytes": 14032
+      "sha256": "90716253be3e28eacd98071465faa8313de2b6598b6d1bc8b64b4fc8616a350e",
+      "bytes": 14398
     },
     {
       "path": "skills/short-drama-produce/agents/openai.yaml",
@@ -551,8 +551,8 @@
     },
     {
       "path": "skills/short-drama-produce/references/adapter-contract.md",
-      "sha256": "e64402f789bdc4046b9bd67226ee78da44a25930b04c42f17023f0961eafb968",
-      "bytes": 11507
+      "sha256": "34f4e51c8b76aebed3b49e35c15cab0372d55084f89423deee646f4be13fee5e",
+      "bytes": 11062
     },
     {
       "path": "skills/short-drama-produce/references/providers/gpt-image-2.md",
@@ -561,14 +561,19 @@
     },
     {
       "path": "skills/short-drama-produce/references/providers/minimax-h3-video.md",
-      "sha256": "39a827aaab23fe853d4b8bdc69dfa69f4cb5265a2782329408485b433477597e",
-      "bytes": 7300
+      "sha256": "b9e81b0be63f48e661ee6afa6ca6cbc3a8bd7ce48afce2b5258c5c05f6555c30",
+      "bytes": 5538
     },
     {
       "path": "skills/short-drama-produce/references/providers/minimax-music.md",
       "sha256": "ef1d00a430edf31a451b3ed588b5e5775a7f61376a4f74d6fe75139f8f1c49cc",
       "bytes": 1361
     },
+    {
+      "path": "skills/short-drama-produce/references/providers/minimax-speech.md",
+      "sha256": "5eee1a47e4916f4048bddd5e4714fc66b0c877def3cf5af80d4d97971d6d2d23",
+      "bytes": 2139
+    },
     {
       "path": "skills/short-drama-produce/references/providers/seedance.md",
       "sha256": "76bfd27a1b1181c0e0079c49ba4ae926012e638794c9bec3c046aaa1846e1c8d",
@@ -586,8 +591,8 @@
     },
     {
       "path": "skills/short-drama-produce/scripts/provider_adapters.py",
-      "sha256": "a4a0174592de2a13918807bbcb9bb793e881f659784c906db4255f0fd044b336",
-      "bytes": 64104
+      "sha256": "b311b155947f22ecce3f39d783f214aad84291db7966090a64f466259f9f76bf",
+      "bytes": 70329
     },
     {
       "path": "skills/short-drama-produce/scripts/selftest.py",
@@ -596,8 +601,8 @@
     },
     {
       "path": "skills/short-drama-review/SKILL.md",
-      "sha256": "174bd5b6957640d4d5f4cf881e03f3af5a2b1a9b94556a18d7d9ff320b2e335b",
-      "bytes": 5273
+      "sha256": "251364f35886455bded0310ac980927a93dd7563dcad53bd5271f83ea211a7c9",
+      "bytes": 5194
     },
     {
       "path": "skills/short-drama-review/agents/openai.yaml",
@@ -636,8 +641,8 @@
     },
     {
       "path": "skills/short-drama-review/references/production-quality-gates.md",
-      "sha256": "06edf05c2a43a6cd8d6b774bdd8530a1044de32fc428c3c35e9ff24c560aa697",
-      "bytes": 20332
+      "sha256": "918f7a2ffc65051b71041e920040181e75908342dc8d5ea0aa411197ee782f44",
+      "bytes": 19154
     },
     {
       "path": "skills/short-drama-review/references/project-calibration.md",
@@ -666,8 +671,8 @@
     },
     {
       "path": "skills/short-drama-review/references/rubric-visual-motion.md",
-      "sha256": "876247530e6cd8eca1d5a72921764f85fad1b0c35f95e94817513b51282e94e2",
-      "bytes": 12731
+      "sha256": "3f594c34c003f7d81aee6cf80adedc6c04c7605703cbf156224b2d4e4cc38e37",
+      "bytes": 10517
     },
     {
       "path": "skills/short-drama-review/references/stage-contract.md",
@@ -686,8 +691,8 @@
     },
     {
       "path": "skills/short-drama-storyboard/SKILL.md",
-      "sha256": "7a7ff4c83981e59de181946a0a814ef5c950e024036eed5cca4ff6fbb6118d48",
-      "bytes": 17488
+      "sha256": "f893fb81cb45f02affd985fcb225cfa7a261f3020c33c4de4ce48c5669299944",
+      "bytes": 17622
     },
     {
       "path": "skills/short-drama-storyboard/agents/openai.yaml",
@@ -749,6 +754,11 @@
       "sha256": "02c095439f73211817a3f75ae2af264459356060755eecaf51ce11c1512ce2ca",
       "bytes": 10255
     },
+    {
+      "path": "skills/short-drama-storyboard/references/lighting-craft.md",
+      "sha256": "62b7fe6bfb3a87fc94732d4723d3b6c9fe1b5432c08cdbd4edca72e590216719",
+      "bytes": 2118
+    },
     {
       "path": "skills/short-drama-storyboard/references/production-shot-grammar.md",
       "sha256": "c8723d9f628ea7b546a2e4a558f9d5463da8296286c15a1eeb146e492b6fe04f",
@@ -771,8 +781,8 @@
     },
     {
       "path": "skills/short-drama-storyboard/references/shot-craft.md",
-      "sha256": "7726bcbe0e364b03de7db5a7a12e46de321b4cac9bcb05bca800f675dad402d7",
-      "bytes": 14293
+      "sha256": "19f33418eb236fc9a2c0c650fcce1d46b2682ce49b03e7e4891a3f1c740bfe55",
+      "bytes": 16549
     },
     {
       "path": "skills/short-drama-storyboard/references/shot-revision-identity.md",
@@ -781,8 +791,8 @@
     },
     {
       "path": "skills/short-drama-storyboard/references/stage-contract.md",
-      "sha256": "456ab66836a6375a4366e66cb791e263cf032a6f651257e26ab1c78f06573a8b",
-      "bytes": 10521
+      "sha256": "afc5fc4dc60c49e37cb71955f345a2049720f5f94ecf58eae1cc9cd92eaea745",
+      "bytes": 10181
     },
     {
       "path": "skills/short-drama-storyboard/scripts/selftest.py",
@@ -796,8 +806,8 @@
     },
     {
       "path": "skills/short-drama-video-prompts/SKILL.md",
-      "sha256": "fe4e682d358a586dd14923e5b71a6fe8d6c6514ce576cf898b12372d56ba1c09",
-      "bytes": 16452
+      "sha256": "e9ab120687deabf1fa34404bf8d09b46f30f7c3b209e0ab5e583dab3482bacc4",
+      "bytes": 15825
     },
     {
       "path": "skills/short-drama-video-prompts/agents/openai.yaml",
@@ -846,8 +856,8 @@
     },
     {
       "path": "skills/short-drama-video-prompts/references/camera-audio-continuity.md",
-      "sha256": "5ba794bd0844a42775098d96054e1f19719ce905fcdb79a6de27c245d9f66ab5",
-      "bytes": 13386
+      "sha256": "f712304e82f1848f74b11312ad94d723a63d82f8d39da1b02b776524c30e7b55",
+      "bytes": 14317
     },
     {
       "path": "skills/short-drama-video-prompts/references/delivery-profile.md",
@@ -861,23 +871,23 @@
     },
     {
       "path": "skills/short-drama-video-prompts/references/minimax-h3.md",
-      "sha256": "9a1de7c5ea347714c0bdadfec2af51571925bbcce8135fcbe7cd9231245575cf",
-      "bytes": 19140
+      "sha256": "74fe472646f9eb09ae14eb2a5e3563e5c6334aacd0520e03733b3f171298898f",
+      "bytes": 16957
     },
     {
       "path": "skills/short-drama-video-prompts/references/motion-recipe.md",
-      "sha256": "23e6b0ce936f0b050380799b9a340b5d2b7733502eee67e99ee0b61bcb666da7",
-      "bytes": 20896
+      "sha256": "7a792afb82186ebd6b64f0758655a6d275766a8619b4714e0597d80c8b471af1",
+      "bytes": 20452
     },
     {
       "path": "skills/short-drama-video-prompts/references/performance-action-timing.md",
-      "sha256": "41ad9c0dd7139449cfb8f8e170a035c03e616faddefb61646e410916c3a45b4a",
-      "bytes": 13665
+      "sha256": "7e9504ceeff949d13179d3137d5d010982ca8c23e8977598a58c24e5730fe4d6",
+      "bytes": 12802
     },
     {
       "path": "skills/short-drama-video-prompts/references/production-prompt-grammar.md",
-      "sha256": "fc915057f5d9088ab8fa3295ea8d4c8443d4771cb23ada560e72822f4fe96d94",
-      "bytes": 23428
+      "sha256": "558c011dbbad162d7e6b76906f3c35e44225911d87f10124580d44b053ba127e",
+      "bytes": 21937
     },
     {
       "path": "skills/short-drama-video-prompts/references/review-and-fixtures.md",
@@ -886,18 +896,18 @@
     },
     {
       "path": "skills/short-drama-video-prompts/references/seedance-2.0.md",
-      "sha256": "5f4d50c90366e3be35050aee9315052c7d1d0fcfeed44a1f2ca76166cb48283d",
-      "bytes": 3617
+      "sha256": "00a81382de7137ce33ca602935087948cde9df499dd1d666f2602ef649b78f4b",
+      "bytes": 3460
     },
     {
       "path": "skills/short-drama-video-prompts/references/seedance-2.5.md",
-      "sha256": "212f724dc05cd3ebc8cfc8c66b05108bbce7bb696d89e5091000405c5bae7656",
-      "bytes": 7235
+      "sha256": "cb7276819941ab6dcc3159c605402d04ad97c3d1d6ff30ae8092c695ba400e52",
+      "bytes": 8652
     },
     {
       "path": "skills/short-drama-video-prompts/references/stage-contract.md",
-      "sha256": "c8b0d09d002c1763296e17bd72e7d765c5c5f46d9028d49de15b9e7a319db94d",
-      "bytes": 11360
+      "sha256": "3680ba91f61eb63af1a3f2e9a63f91544f181716fdfe9371d3bf7767e0a5ed4c",
+      "bytes": 11089
     },
     {
       "path": "skills/short-drama-video-prompts/references/target-model-profile.md",
@@ -926,8 +936,8 @@
     },
     {
       "path": "skills/short-drama-write/SKILL.md",
-      "sha256": "8b76368dc799987f125db455942b4f175e004e5018d3718683ca8ec45527ae49",
-      "bytes": 9679
+      "sha256": "f0a74465dbdd12c06ee7a37b2eda84423d1c8d03d364f0ef42c1e04b586f81cc",
+      "bytes": 9427
     },
     {
       "path": "skills/short-drama-write/agents/openai.yaml",
@@ -1021,8 +1031,8 @@
     },
     {
       "path": "skills/short-drama/SKILL.md",
-      "sha256": "1245b5277dc4fb53ab81f7e5c92a6304e2d4a83985f6522ed05c2c291b5ec7b3",
-      "bytes": 10145
+      "sha256": "a8efa0cc1f73a4cbc55ee1f1aa05491b2f43fba89a43fb87a21aef5f2b612784",
+      "bytes": 10088
     },
     {
       "path": "skills/short-drama/agents/openai.yaml",
@@ -1131,8 +1141,8 @@
     },
     {
       "path": "skills/short-drama/scripts/creator_markdown_check.py",
-      "sha256": "208afedeb1ef87feff3c5632ae93f17bc1b7396224abfe83091ac204f593e1e6",
-      "bytes": 61093
+      "sha256": "21f0af79598d6161cec8c7bf720fe9acbe4d4de4319c9eb1499c8e5a77277e97",
+      "bytes": 61927
     },
     {
       "path": "skills/short-drama/scripts/project_tool.py",

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

@@ -37,8 +37,8 @@ license: MIT
 现成剧本可直接拆资产；已有视觉事实可直接写图片提示词或分镜；已有分镜可直接写视频提示词。
 不要为补齐名义流水线伪造上游。
 
-五文档是创作真相，剪辑单不是第六份。它写在素材生产之后，只记录「已有的这些素材，哪些帧进成片」，
-不改变任何一集的剧本、镜头职责或时长声明；需要改这些就回到拥有它们的文档。
+五份创作文档记录剧本、视觉与提示词；剪辑单在素材生产后记录取舍和后期处理。
+修改故事、镜头职责或上游时长声明时，回到负责该内容的文档。
 
 ## 执行请求
 

package/lib/drama/skills/short-drama/scripts/creator_markdown_check.py

@@ -1284,6 +1284,20 @@ def validate_episode(episode: Path, project_root: Optional[Path] = None) -> list
             _check_named_coverage(
                 keyframe, shot_id, "冻结关键帧提示词", basis, visual_entries, errors
             )
+        # The closing keyframe is optional — many shots end where they began —
+        # but a heading that is present and malformed is a defect, not a shot
+        # that quietly has no closing frame.
+        if re.search(r"^### 收尾关键帧提示词\s*$", shot_body, re.MULTILINE):
+            closing = _copyable_prompt(shot_body, heading=r"收尾关键帧提示词")
+            if closing is None:
+                errors.append(
+                    f"{shot_id}: 收尾关键帧提示词不是唯一且非空的可复制正文"
+                    + _copyable_prompt_cause(shot_body, heading=r"收尾关键帧提示词")
+                )
+            elif basis.parsed:
+                _check_named_coverage(
+                    closing, shot_id, "收尾关键帧提示词", basis, visual_entries, errors
+                )
         if basis.parsed and source_value:
             # A shot's 来源 is its claim on the screenplay: whatever it quotes,
             # this shot is the one that films it. Quoting an action performed by

package/lib/drama/skills/short-drama-assets/references/character-and-look.md

@@ -128,6 +128,16 @@ Character 拥有，换鞋、加厚外套、盘发都不改写它（那些属于
 | 剪影与线条 | 轮廓与肩背重心、发型剪影与发际形状、固定配饰外形、服装廓形、步态负重 | 细微的五官不对称、浅色小痣、依赖真实皮肤纹理的痕迹 |
 | 材质与表面 | 皮肤/毛发/布料的可比较表面状态、长期使用痕迹 | 需要柔和过渡才能读出的体积差 |
 
+### 写实细节与身份连续性
+
+**`craft_default`**：写实项目可以在稳定识别特征之外，补充皮肤纹理、自然不对称或使用痕迹。
+远景中不易读出的细节，不宜单独承担跨镜识别。
+
+痣、疤和牙齿形态等如果是人物既定特征，仍须保持；不能因它们难生成就允许随镜变化。
+毛孔、细纹等微观纹理不必逐像素一致。是否需要这些细节由画面尺度与已接受风格决定。
+
+**`taste_option`**：偶像化、漫画或其他风格可采用更平滑的表面，不以写实程度判错。
+
 ### 边界：形态选通道，身份定事实
 
 - **`reviewed_invariant`**：形态可以改变锚点的**表达通道与颗粒度**，不得改写身份事实本身。

package/lib/drama/skills/short-drama-assets/references/continuity-lock.md

@@ -42,15 +42,12 @@
 
 - 锁面必须**逐字出现在它管到的每一份可复制正文里**。校验器会在三处查同一个字符串：
   图片提示词正文、冻结关键帧提示词、视频提示词正文。
-- 这三处的语言不一定相同：图片提示词与冻结关键帧跟 `short-drama.json#/format/prompt_language`，
-  视频提示词优先跟已接受的 `production_profile.choices.video_prompt_language`。
-  **两者不同时（例如创作者说明 zh、H3 方言要求正文 en），一个字符串无法同时出现在三处**——
-  这是已知冲突，不是可以靠选对语言绕开的。两条出路：
-  - 优先把锁面写成**跨语言同形**的事实：色值（`#2F3A2C`）、编号、型号、专名、数字状态。
-    这类锁面在中英正文里都是同一串字符，三处都能原样命中；
-  - 确实需要自然语言描述时，把锁的 `镜头：` / `图片：` 范围收窄到语言一致的那些正文，
-    另一侧的同一事实另立一条锁，不要用一条锁去跨语言。
-  因为它要落进可复制正文，不是落进创作者说明；
+- 图片与冻结关键帧使用 `format/prompt_language`，视频可能使用另选的 `video_prompt_language`。
+  语言不同时，优先使用确实适合各份正文的共同色值、型号或专名。
+  当前 `镜头：` 同时约束本镜首帧与视频正文，不能靠拆成两把锁分别约束两种语言。
+  没有合适共同词组时，在视觉设定中保留事实并报告此限制，暂不声明这把逐字锁；
+  不缩小事实实际出现的镜头范围来绕过检查，也不自行改变用户选择的正文语言。
+
 - 只保留最小可辨识名词短语，通常是「颜色 + 材质/形制 + 物体」，例如
   `pale blue chunky knit wool sweater`；
 - 不含句号、动作、状态、数量、镜头信息和剧情；

package/lib/drama/skills/short-drama-assets/references/voice-direction.md

@@ -3,6 +3,7 @@
 ## 目录
 
 - [参考音频是载体](#参考音频是载体)
+- [参考可以是合成出来的](#参考可以是合成出来的)
 - [身份与表演的界线](#身份与表演的界线)
 - [一段参考音频可以决定什么](#一段参考音频可以决定什么)
 - [绑定不等于听过](#绑定不等于听过)
@@ -27,6 +28,20 @@
 `reference: null` 并写明「待选型」——**不要用一段文字描述冒充音色身份**。
 下游拿着一段形容词去找声音，找回来的每次都不一样，而记录看起来是完整的。
 
+### 参考可以是合成出来的
+
+使用声音库时，确认所选音色及其使用范围符合供应商提供的许可。
+项目没有配音演员、也不打算克隆谁的时候，这条路是让 `reference` 从 `待选型` 变成实际路径的
+办法——**挑一个预置音色，合成一条，绑上去**。合成由 `$short-drama-produce` 的 `tts` 模态执行。
+
+合成出来的参考和录音来的参考在本文档里受同样的约束：它一样要写用途边界，一样要有
+`admission_status`，一样不能用形容词代替。差别只有一处——**它的选型判据是拿来挑预置音色的，
+不是拿来判克隆像不像的**，所以「与谁最易混」这条要在同一批预置音色里回答，而不是在角色之间
+凭空回答。预置库里两个音色听起来就是同一个人时，换一个，不要靠判据文字假装区分。
+
+音色 ID 本身写进 `reference` 那一行，和路径、用途边界一起。它是创作决定：同一个角色在两集之间
+换 ID 就是换人说话，这件事必须在文档里看得见、diff 里查得出。
+
 ## 身份与表演的界线
 
 一句话判定：**这个特征在角色安静地坐着说一句无关紧要的话时还在吗**？
@@ -115,6 +130,15 @@ CHAR-A 与 CHAR-B 最易混：两条参考同为中低音区、语速偏慢。
 
 角色多时按易混组分批选型，而不是按出场顺序。
 
+### 对比选择预置音色
+
+用同一组有代表性的台词试听候选，比较角色间是否易混，以及同一角色在不同情绪下是否稳定。
+音色名称仅供检索，选择依据是实际声音。
+
+需要测量时，F0 和谱特征可辅助定位近似音色；同一候选应有多句样本，才能估计自身变化。
+不把音高间距或「组间距离大于组内极差」设为通用门槛。最终按角色需求与回听结果选择，
+不为追求数字分离而改变已接受的声音方向。
+
 ## 专名发音
 
 已接受的专名发音只能有一种拼法（`AST-10`）。
@@ -149,3 +173,7 @@ CHAR-A 与 CHAR-B 最易混：两条参考同为中低音区、语速偏慢。
 
 临时情绪、呼吸、重音、音量和空间混响仍由剧本/镜头/视频提示词拥有。声音方向是生产输入，不是
 合成结果保证；实际 TTS 仍由 `$short-drama-produce` 在精确预览并显式确认后执行。
+
+参考音频落地之后，它在下游有两个去处：作为视频模型的音色参考绑定（见目标模型的方言文档），
+以及作为配音本的实际人声。配音使用同一已选音色逐句合成；参考音频用于选型或模型绑定，不能直接充当不同台词的成品音轨。
+是否保持角色声音，仍需在生成后回听确认。

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

@@ -1,6 +1,6 @@
 ---
 name: short-drama-edit
-description: 把已经生产出来的逐镜素材按分镜装配成短剧成片：定每镜入出点、镜序、台词完整性、字幕、响度与交付规格，写成 `剧集/<EP>/剪辑单.md` 并渲染出成片。用户说“把这些镜头剪成片”“做成片/装配/套剪”“定入出点”“加字幕”“统一响度”“成片太长/太碎”“导出可继续精修的工程”时使用；不生成新素材，不改剧本、分镜或视频提示词的语义。
+description: 将已生成的短剧镜头剪成成片，记录入出点、镜序、声音、字幕与交付规格。用于套剪、加字幕、统一响度、调整节奏或导出精修素材；需要补素材或修改故事时转回对应创作阶段。
 license: MIT
 ---
 
@@ -9,9 +9,7 @@ license: MIT
 把 `剧集/<EP>/制作成果/` 里的逐镜素材装配成一条成片，取舍写进 `剧集/<EP>/剪辑单.md`。
 每段使用二级标题 `## CUT-...`，各自绑定一个 `MOTION-...` 和一个真实媒体文件。
 
-本阶段是套件里唯一同时看得见**成片**和**创作意图**的位置。上游每一份文档描述的都是「这一镜
-应该是什么」；只有到这里，才第一次能回答「生成出来的这一段，哪一部分真的能用」。这两件事经常
-不一致，而处理这个不一致正是剪辑的工作，不是缺陷。
+根据实际素材选择可用片段，按剧本与分镜核对叙事。素材与意图不一致时，记录取舍和缺口。
 
 ## Quick Start
 
@@ -24,12 +22,15 @@ license: MIT
 进入条件是**素材已经存在且可读**：`剧集/<EP>/制作成果/` 里有本次要用的视频文件。
 提示词写完、job 确认过、adapter 返回成功，都不等于素材可用；本阶段只认当前能打开的文件字节。
 
-素材不全时不要等齐。已有素材能构成一段连续可看的内容就可以先剪，把缺口写进「未采用镜头」并
-说明它缺的是文件还是质量。剪一版看得见的东西，比拿着完整清单空等更能暴露上游问题。
+素材不全时可以先剪已有连续段落；用户要求完整成片时，将这一版标为片段并列出缺口。
+在「未采用镜头」说明缺文件、质量不可用或叙事取舍。
 
 `剧集/<EP>/分镜.md` 与 `视频提示词.md` 是镜序和职责的来源。剪辑可以**取舍**它们，不能**改写**
 它们：删一镜、缩一镜、换顺序都属于本阶段；改台词、改镜头职责、改起终状态要回上游发修订请求。
 
+内置渲染直接拼接编码后的分段，输入素材的画幅与帧率须一致。`check` 在可探测媒体时核对；
+不同规格先通过外部工具按交付要求统一，保留构图并记录裁切或留边，再更新剪辑单的路径与时间。
+
 渲染与测量需要 `ffmpeg` / `ffprobe` 在 PATH 上。没有时 `edit_tool.py` 直接失败并说明，
 不用别的手段近似，也不把「没测」写成「通过」。
 
@@ -38,17 +39,15 @@ license: MIT
 1. **逐段看完整素材，先标可用带，再谈剪辑。** 每个文件从头到尾看一遍，写下它实际能用的时间
    区间，以及区间之外发生了什么（起势静止、结尾漂移、发白、动作回弹、多余的重复表演）。
    这一步的产出是事实，不是决定。做法见 [生成素材的可用带](references/generated-footage.md)。
-2. **有台词的镜先按发声定边界。** 台词完整性优先于画面取舍：先确定这句话从哪一帧开始出声、
-   哪一帧收尾，再在这个约束内选画面入出点。切在字中间是结构缺陷，不是节奏选择。
-3. **在可用带内选叙事入出点。** 入点取动作已经在进行中的那一帧，出点取信息完成之后、缺陷
+2. **有台词的镜先定位发声区间。** 保留完整字音和所需停顿。内置工具同步切画面与声音；
+   需要在连续对白上换画面时，使用外部剪辑工具分开处理。
+3. **在可用区间内选叙事入出点。** 按动作、反应或停顿的需要选择入点，出点取信息完成之后、缺陷
    开始之前。逐段写清入点理由和出点理由。做法见 [入出点与镜序](references/cut-craft.md)。
-4. **排镜序并检查相邻关系。** 相邻两段不同时具备同景别、同机位、同运动方向；重复承担同一
-   信息的段落删掉一段，而不是两段各留一半。
-5. **对一遍相邻段的画面。** 逐镜生成的素材会漂移：同一个人、同一张桌子的两条，
-   回来可能差一档曝光、半步白平衡。差得看得出来时，在那一段写一行 `画面`。
+4. **排镜序并检查相邻关系。** 检查动作、空间、揭示与声音是否连贯；重复信息没有新增作用时再删。
+5. **比较相邻段的画面。** 按同场景、同光态比较可比区域；有可见偏差时在对应段写 `画面`。
    做法见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
-6. **处理声音接缝与响度。** 逐镜生成的素材各自带着自己的环境声或音乐，直接拼接会在每个剪辑
-   点留下音床硬切。做法见 [声音、字幕与音乐](references/sound-and-subtitles.md)。
+6. **处理声音接缝与响度。** 拼接后回听；需要混音时通过外部工具执行并记录。
+   做法见 [声音、字幕与音乐](references/sound-and-subtitles.md)。
 7. **写字幕。** 字幕的每一个字都取自 `剧本.md` 的台词原文，不取自转写结果；标点可按字幕惯例调整，
    字不能改。转写只用来定位时间。
 8. **写出 `剪辑单.md`，再渲染。** 先有文档后有成片：文档是可审查、可修订、可复现的那一份，
@@ -58,7 +57,7 @@ license: MIT
 ## 剪辑单要求
 
 - 正文开头写交付规格：`成片目标时长`、`画幅与帧率`、`交付响度`、`字幕`。目标时长是意图，
-  实际时长可以不等于它；差多少、为什么，写在末尾报告里，不靠删内容硬凑。
+  实际时长与目标的差写在报告里。用户明确要求固定时长时，应满足要求或报告缺少的素材。
 - 每段一个 `## CUT-<EP>-<序号> · <中文名称>`，块内逐行写：
 
   - `- 来源：<MOTION-...> · <项目相对路径>`——`MOTION-...` 必须是 `视频提示词.md` 里真实存在
@@ -66,18 +65,17 @@ license: MIT
   - `- 入点：<秒>` / `- 出点：<秒>` / `- 时长：<秒>`——三者必须自洽，`出点 - 入点 == 时长`。
     全部用秒，保留两位小数，不写时间码，不写帧号。
   - `- 取舍：入点=<理由>；出点=<理由>`——理由写画面上发生了什么，不写「节奏需要」。
-    这一行是本阶段唯一的创作记录；它解释的是为什么丢掉了没被选中的那些帧。
-  - `- 声音：<本段声音怎么处理>`——保留原声、压低、静音、交叉淡入、接住音乐落点，逐段说清。
+    理由应能对应实际素材与本镜叙事需要。
+  - `- 声音：<本段声音怎么处理>`——记录保留原声或外部处理。此行不驱动内置 render 的混音。
   - `- 画面：<接镜校正>` 或 `- 画面：无`——只在这一段与相邻段明显对不上时写，
     格式是「亮度 <数>」「饱和 <数>」「色温 <数>」三项的任意组合，用 `；` 分隔。
     详见 [接镜与色彩一致性](references/generated-footage.md#接镜与色彩一致性)。
   - `- 字幕：<逐字台词原文>` 或 `- 字幕：无`。本段有多句台词时改用编号写法，
-    每句自带时间：`- 字幕 1：0.20-1.50 就是什么`、`- 字幕 2：2.30-4.30 就是少了点东西`……
-    编号从 1 连续，时间不得重叠。**一镜不等于一句**——一次三个来回的对话是一个过肩镜头，
-    只写一条字幕会让另外两句在成片上无声地消失。
+    每句自带时间：`- 字幕 1：0.20-1.50 请进`、`- 字幕 2：2.30-4.30 门没有锁`。
+    编号从 1 连续，时间相对本 CUT 入点，且不得重叠。
 - 素材里没有被采用的镜头，在正文开头写一行 `- 未采用镜头：<MOTION-...>（理由：……）`，
   多项用 `；` 连接。理由区分两类：**文件缺失**（还没生产 / 生产失败）和**质量不可用**
-  （生成结果不能用）。两者在文档里长得一样，但一个要回生产、一个要回上游改提示词。
+  （生成结果不能用），也可说明叙事取舍。补素材前先判断需要重出还是修订上游。
 - 同一个 `MOTION-...` 可以拆成多个 `CUT-...`（同一段素材的两处分别使用），也可以整段不用。
   不能凭空出现没有素材来源的 `CUT-...`。
 - 一段素材被用两次时，两个 `CUT-...` 的区间不得重叠：同一批帧在成片里出现两次是重复镜头，
@@ -89,11 +87,10 @@ license: MIT
   回 `$short-drama-video-prompts` 或 `$short-drama-image-prompts`。
 - **不改上游语义。** 剪辑单可以让某句台词不出现在成片里（整镜未采用），不能改这句台词是什么。
   发现剧本层面的问题就点名报告，交回 `$short-drama-write`。
-- **不做解说旁白。** 短剧成片靠人物对白和画面推进，不加第三人称叙述音轨。需要解说式成片是
-  另一种产品形态，不在本套件的目标里。
+- **沿用剧本的声音设计。** 保留已有对白、VO 和 OS，不自行增加解说；需要新增叙述时回写作阶段。
 - **不把技术成功写成质量结论。** 渲染完成、时长对上、文件存在，都不是「这条片子能看」。
   成片质量的判断交给 `$short-drama-review`，或交给创作者本人。
-- **不替创作者决定要不要再剪一版。** 报告当前成片的可测事实和仍然存在的取舍选项，让创作者选。
+- **按已授权目标完成。** 继续修复影响交付的问题；新增创作方向或补素材需求交给创作者决定。
 
 ## 命令
 
@@ -111,18 +108,19 @@ python3 <本技能目录>/scripts/edit_tool.py verify <剧集/EP001> --project-r
 输出 `剧集/<EP>/制作成果/成片/`。`verify` 只测量已经渲染出来的成片并回报数字，不改文件、
 不给质量结论。
 
-字幕默认由 ffmpeg 烧录，零依赖，长片也是秒级。`--subtitles remotion` 换成一条排版可调的
+字幕默认由带 libass 的 ffmpeg 烧录。`--subtitles remotion` 换成一条排版可调的
 路线，代价是装一次 Node 依赖，而且叠层要**逐帧过无头浏览器**渲整部成片——慢且吃内存，
 并发默认压在 2（`--remotion-concurrency` 可调，调高前先量本机）。取舍见
 [声音、字幕与音乐](references/sound-and-subtitles.md)，装法见
 [Remotion 字幕叠层](assets/remotion/README.md)。
 
-`render` 会保留每段切好的中间文件。它们是下一轮微调的输入，也是「这一刀到底切在哪」的证据；
-不要在报告里用「重新渲染一次就好」代替给出这些文件。
+`render` 保留切好的中间文件。它只切段、硬拼接、统一字幕样式、接镜校正和整片响度，
+不执行 `声音` 行中的混音方案，也不按交付规格自动缩放或改帧率。需要混音、逐镜字幕避让、
+转场或画幅转换时用外部工具完成并记录，验收实际交付文件。
 
 ## 按需知识
 
-默认只读本 SKILL、当前分镜和要用的素材。遇到对应问题时只打开一份：
+先读本 SKILL、当前分镜、视频提示词和素材；有字幕时读取剧本原文。按需要打开参考资料：
 
 - 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
 - 可用带、生成缺陷与逐镜取舍：[生成素材的可用带](references/generated-footage.md)