@oh-story/dsh 0.1.18 → 0.1.19

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

@@ -119,7 +119,10 @@ PACING_POINTER = "/format/pacing"
 # Everything outside /creator_authority/* that a decision may still bind. Both
 # are read by the write stage to turn a screenplay into seconds, so leaving them
 # out of set-authority left hand-editing short-drama.json as the only way in.
-FORMAT_POINTERS = (EPISODE_LENGTH_POINTER, PACING_POINTER)
+EPISODE_COUNT_POINTER = "/format/episode_count"
+# The episode count is often settled only once the episode map exists, after
+# init; without a pointer it could only be hand-edited into the manifest.
+FORMAT_POINTERS = (EPISODE_LENGTH_POINTER, PACING_POINTER, EPISODE_COUNT_POINTER)
 RHYTHM_PROFILE_TOKENS = [AUTHORITY_ROOT_TOKEN, "rhythm_profile"]
 # The project rhythm profile: what develop proposes and the creator accepts, so
 # that later stages can do arithmetic on accepted numbers. Only types and ranges
@@ -271,6 +274,9 @@ def project_video_model_profile(project: Mapping[str, Any]) -> dict[str, Any]:
         "native_duration_seconds",
         "supported_generation_modes",
         "audio_generation",
+        # The creator's choice to pack adjacent short shots into one
+        # generation; it answers the shot-length note below once made.
+        "multi_shot_containers",
     )
     return {field: choices[field] for field in fields if field in choices}
 
@@ -365,6 +371,48 @@ def project_rhythm_profile(project: Mapping[str, Any]) -> tuple[dict[str, Any],
     return {name: profile[name] for name in RHYTHM_PROFILE_FIELDS}, []
 
 
+def profile_notes(project: Mapping[str, Any]) -> list[str]:
+    """Arithmetic conflicts between accepted settings that no single one shows.
+
+    Each value passes on its own; together they promise something a later
+    stage cannot deliver, and that stage is the first to find out.
+    """
+    notes: list[str] = []
+    rhythm, _ = project_rhythm_profile(project)
+    model = project_video_model_profile(project)
+    native = model.get("native_duration_seconds")
+    shortest = native.get("min") if isinstance(native, Mapping) else None
+    average = rhythm.get("target_avg_shot_seconds")
+    if (
+        isinstance(shortest, (int, float))
+        and isinstance(average, (int, float))
+        and average < shortest
+        and model.get("multi_shot_containers") is not True
+    ):
+        notes.append(
+            f"rhythm_profile.target_avg_shot_seconds {average:g} is below the target "
+            f"model's native minimum of {shortest:g} seconds: most shots will need "
+            "multi-shot containers, or the average must rise"
+        )
+    block = project.get("format")
+    pacing = block.get("pacing") if isinstance(block, Mapping) else None
+    target = block.get("target_seconds_per_episode") if isinstance(block, Mapping) else None
+    speech = pacing.get("spoken_characters_per_second") if isinstance(pacing, Mapping) else None
+    action = pacing.get("seconds_per_action_paragraph") if isinstance(pacing, Mapping) else None
+    # The same rule the write stage's estimator applies: a positive speech rate
+    # and a non-negative action-paragraph duration.
+    usable = (
+        isinstance(speech, (int, float)) and not isinstance(speech, bool) and speech > 0
+        and isinstance(action, (int, float)) and not isinstance(action, bool) and action >= 0
+    )
+    if isinstance(target, (int, float)) and not usable:
+        notes.append(
+            "format.target_seconds_per_episode is set but format.pacing has no usable rates: "
+            "the write stage cannot turn a screenplay into seconds"
+        )
+    return notes
+
+
 def initialize_project(
     path: Path,
     *,
@@ -1029,6 +1077,7 @@ def _build_status(
         "format": project_format(project),
         "rhythm_profile": rhythm_profile,
         "rhythm_profile_problems": rhythm_problems,
+        "profile_notes": profile_notes(project),
         "project_root": project_root,
         "last_action": state.get("last_action"),
         "layout": dict(layout),
@@ -1655,6 +1704,10 @@ def set_creator_authority(
             isinstance(value, (int, float)) and not isinstance(value, bool) and value > 0
         ):
             raise ValueError("target_seconds_per_episode must be a positive number of seconds")
+        if field == EPISODE_COUNT_POINTER and not (
+            isinstance(value, int) and not isinstance(value, bool) and value > 0
+        ):
+            raise ValueError("episode_count must be a positive integer")
         project_path = root / PROJECT_FILE
         project = json.loads(project_path.read_text(encoding="utf-8"))
         if not isinstance(project, dict):

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

@@ -31,7 +31,7 @@ license: MIT
 3. 对每项决定新建、复用、增加变体或标记未决；含混指代不猜。
 4. 写最小可识别设定：统一使用 `识别锚点`、本集状态和变化原因；会持续限制后续动作的身体—物件—空间关系写进有生效范围的状态，不当成一次姿势略过。
 5. 检查造型/伤势、持物/所有权、道具状态、地点时段/天气/光态与跨集结束状态。
-6. 给跨镜出现且观众看得出不一致的可见事实写一条连续性锁，其余保持识别锚点即可。
+6. 给跨镜出现且观众看得出不一致的可见事实写一条连续性锁，其余保持识别锚点即可。此时还没有分镜，镜头范围写 `入画`，锁写在它所属的条目下（服装写在 `造型` 条目下），分镜写完后自动按「视觉依据」生效，见 [连续性锁](references/continuity-lock.md)。
 7. 项目提示词语言不是中文时，给每个人物条目写一行 `画面代称：<正文里的拼写>`；正文从不点名它就写 `画面代称：无`。地点和道具按需。
 8. 整集请求自动处理完整集，末端一次回报关键身份决定和未决指代。
 
@@ -70,8 +70,4 @@ license: MIT
 
 所有明确出场都已复用、新建、变体化或标为真实未决；需要保持的视觉事实与状态变化已写入唯一
 视觉设定文档，即完成。图片提示词、分镜、审查和生产不自动开始。
-五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
-
-## 安装维护
-
-只有安装、升级或排障时运行 `python3 scripts/selftest.py`。
+写完本阶段文档后，可转 `$short-drama` 做局部机械核对（只核对已有文档）；五份齐备后再做完整核对。内容质量仍由创作者审查。

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

@@ -84,7 +84,8 @@ sweater`），但不能改写锁面内部——少一个 `stand-collar`、多一
   报成语法错误，不会被悄悄跳过——锁不能变成空转；
 - `LOCK-...`：本集唯一稳定 ID，与 `IMG-...`、`REF-...`、`SHOT-...` 互不混用；
 - `《中文名》`：给创作者读的名称，必须含中文；
-- `镜头：`：`全集`，或 `、` 分隔的 `SHOT-...` 列表；两者不能混写；
+- `镜头：`：`入画`、`全集`，或 `、` 分隔的 `SHOT-...` 列表；三者不能混写。`入画` 由检查器展开成「视觉依据」
+  列出本条目的所有镜头，所以锁要写在它所属的人物、造型、地点或道具条目下面；
 - `图片提示词项：`：可选，`、` 分隔的 `IMG-...` 列表，整段省略即表示不约束图片提示词；
 - `锁面：`：被逐字带走的那段字，写在行尾。
 
@@ -110,13 +111,18 @@ sweater`），但不能改写锁面内部——少一个 `stand-collar`、多一
 - `锁面：high quality, detailed`——不是可辨识事实，锁住了也证明不了一致；
 - 只把锁的 `镜头` 范围写到「文字已经对的那几镜」——范围要按这个事实**实际出现在哪几镜**来写，
   按已经写对的地方来写，等于把校验器指向没有风险的位置；
-- 把 `镜头：全集` 用在只出现两镜的道具上——其余镜头会被迫写入与本镜无关的名词。
+- 把 `镜头：全集` 用在只出现两镜的道具上——其余镜头会被迫写入与本镜无关的名词。用 `入画`。
+- 把服装锁写在人物条目下并用 `入画`——手部特写、眼部大特写也列这个人物，会被迫写进看不见的衣服。
+  服装锁写在 `造型` 条目下，分镜只在衣服入画时列这个造型。
 
 ## 校验
 
 ```bash
-python3 <core 技能目录>/scripts/creator_markdown_check.py 剧集/<EP> --project-root .
+python3 <core 技能目录>/scripts/creator_markdown_check.py 剧集/<EP> --project-root . --partial
 ```
 
+资产阶段只有剧本、视觉设定和图片提示词时，`--partial` 照样核对锁的语法和被点名的 `IMG-...` 正文；
+镜头范围在分镜写完后自动生效，不需要回来改锁。
+
 它只机械核对语法、范围可解析，以及锁面是否真的出现在被点名的正文里。该不该上这把锁、锁面写得
 准不准，仍由创作者和审查判断。

package/lib/drama/skills/short-drama-assets/references/era-anchors.md

@@ -31,7 +31,7 @@
 
 ## 合成例
 
-原著：主角刷热搜、开短视频账号、用 U 盘拷资料，故事发生在部队宣传部门的办公室。
+原著：主角在城郊外卖站点跑单，用手机抢单、看直播带货，下班后在出租屋里刷热搜。
 
-- 错：「老旧的机关办公室，老式显示器，旧款智能手机」——原著里没有一处支撑。
-- 对：时代锚点写当下；办公室条目写液晶显示器、嵌入式 LED 面板灯、网面办公椅；手机写全面屏智能手机。
+- 错：「九十年代的小饭馆门口，骑二八自行车，腰上别着 BP 机」——原著里没有一处支撑。
+- 对：时代锚点写当下；站点条目写电动车充电桩、智能取餐柜、头盔架；手机写全面屏智能手机，装着骑手接单 App。

package/lib/drama/skills/short-drama-assets/references/location-and-view.md

@@ -23,6 +23,10 @@ Location/View 分别记录空间身份和可复用视图，让参考图、分镜
 “潮湿、压迫、怀旧”可以辅助气氛，却不能替代“北门通走廊、窗口面向河面、配电箱
 在柜台后”这样的地理事实。也不能为了画面好看新增一扇后来影响追逐路线的门。
 
+地点里的方位用锚点互相定位（“窗在书柜墙靠门的一端”“门正对办公桌”），或用场景自己的
+方向（北门、东窗），不写裸的“左侧大窗”“门在左后角”：不说站在哪里看，左右就会在反打
+镜头里对调，下游只能猜。只有 View 已经写明从哪里朝哪里看时，才在 View 里用画面左右。
+
 ## Location 边界
 
 ### 新 Location

package/lib/drama/skills/short-drama-develop/references/adaptation-craft.md

@@ -91,8 +91,8 @@ development，避免交付包把输入材料带出边界。
 场景合并还要保留戏剧作用、知情范围、关系位置和因果桥。“人更少”不能单独证明合并成功。
 
 立场与性情指这个人对主角是帮、是压还是观望，为什么，以及他做事的方式。压力可以放大、外化：
-原著里温和护短、只是不看好主角的上级，可以把怀疑当面说出来，成为第一个被打脸的人；改成冷脸拒绝、
-深夜来关灯的压制者，就换了一个人。改人物立场或关系不是换载体：映射按实际处理登记，在
+原著里嘴硬心软、只是不信徒弟能成的老师傅，可以把不信当众说出来，成为第一个看走眼的人；改成处处
+使绊子、暗中拆台的对手，就换了一个人。改人物立场或关系不是换载体：映射按实际处理登记，在
 `lost_or_changed` 写明改了什么，`creator_acceptance.status` 保持 `pending`，把提议写进简报交创作者决定。
 
 为候选人物、场景和信息记录它承担的功能：

package/lib/drama/skills/short-drama-develop/references/episode-design.md

@@ -258,7 +258,7 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 冷开常见的三条否决理由，多半是把冷开做成了兑现本身：
 
 - 「观众还不认识这些人，看不懂」：冷开取的是冲突最尖的那一下，要的是一眼读得懂的处境——一群人
-  喊着要封号、一张被火光照亮的脸，不需要知道谁是谁；
+  堵在门口拍门、一张被火光照亮的脸，不需要知道谁是谁；
 - 「会把后面的兑现提前花掉」：取揭晓前一秒时答案留在原位；取最后一拍时只放结果的一个画面，
   不放来龙去脉，观众追的是「怎么走到这一步」；
 - 「同一拍会在集中段再演一遍」：开场给片段，回到原位时给完整的一场，观众得到的是认出来的快感，
@@ -344,9 +344,9 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 
 | 写成功能（不够） | 写成动作（够） |
 | --- | --- |
-| 他不再讲道理，用自己的信用担保 | 群里问他是不是急了的内部人士，有人跟着起哄；他把打了一半的辩解删掉，只发出一条链接 |
-| 裁决权从立场转移到作品本身 | 刚才喊举报的那个人点开了视频 |
-| 上级选择维持现状 | 上级把申请表推回来，说等有了成绩再谈 |
+| 他不再讲道理，用自己的信用担保 | 债主当着全村人催他还钱，有人跟着起哄；他不再求情，把自家祖屋的房契拍在桌上 |
+| 裁决权从立场转移到证据本身 | 刚才嚷着要报警的村长俯下身，看清了房契上的名字 |
+| 上级选择维持现状 | 车间主任把调岗申请推回来，说等这批货交了再谈 |
 
 左栏的功能描述本身可以成立，结构校验也无法据此判断动作是否具体；这一缺口仍须由
 `STY-24` 的语义审查指出。只交左栏会让剧本层重新发明行动，右栏则提供了可继续场景化的依据。
@@ -528,6 +528,21 @@ C 让状态 D 改变，迫使人物放弃旧策略或付出更大代价；
 这些是起点，不是质量线。靠旁白推进的解说漫可以把 `vo_share_max` 调高；生活流、留白多的
 作品可以放宽触点间隔和镜长。改哪一项、为什么，写进创作简报交创作者决定。
 
+提出档案时还要对照两件已经定下或马上要定的事，否则冲突要到分镜阶段才第一次暴露：
+
+- **目标视频模型的原生最短时长**。`target_avg_shot_seconds` 低于它（例如平均 2.5 秒对 Seedance 2.0
+  的最短 4 秒）时，多数镜头只能装进多镜容器一起生成，或者把平均镜长调高。两条路对剧本和分镜的
+  影响不同，在简报里写明选哪条，交创作者决定。
+- **语速**。档案里的秒数（首钩、触点间隔、单集目标时长）要在写作阶段换算成秒，需要项目声明
+  `format.pacing`：每秒可发声字数和每段动作的秒数。和档案一起提出一组起点（按目标模型的实测语速，
+  例如 H3 约 4.1 字/秒），由创作者接受。没有声明时写作阶段只能报可数事实，算不出秒数。
+
+`end_on_peak` 为 `true` 时，集尾停在峰值那一拍，峰值后不再缓一段。连载的下一集压力要落在
+这一拍上：选峰值时，优先选能同时启动 `outgoing_pressure` 的一刻——新危机落下、对手出手、
+没人知道的后果已经开始——而不是情绪已经收束的完成态。情绪高点与下一集的压力分属两拍时，
+让它们同时发生（同一刻切到另一处正在发生的后果），不要删掉压力那一拍。`handoff_state`
+写峰值那一刻的状态，不写峰值之后的余波。
+
 **`craft_default · STY-26`**：按制作形态从上表起步提出项目节奏档案，交创作者接受或改写；
 默认值只是起点，不是套件级门槛，未接受的档案不作为任何核对依据。
 

package/lib/drama/skills/short-drama-develop/references/genre-cards//347/263/273/347/273/237/346/265/201.md

@@ -14,7 +14,7 @@ basis: 套件既有工艺文件与短剧写作经验归纳
 
 ## 压力来源与冲突发动机
 
-压力主要来自对手，不来自系统的代价。对手的压迫要落成一件当众做过的事：在群里带头举报、当面把申请表推回来、公开断言「不好看就别回来」。压迫越具体，打脸落下时的高度差越大。改编时对手优先取原著人物；原著此处没有时按 STY-30 登记新增并交创作者。系统任务的时限与失败后果是第二层压力，按契约披露，不要写成一条替代爽感的焦虑条款。发动机：对手按表面判断下注，主角手里有对手看不见的底牌，结果当众揭晓。
+压力主要来自对手，不来自系统的代价。对手的压迫要落成一件当众做过的事：在饭局上当众把菜单扔回去、在参赛名单上划掉主角的名字、放话「拿不到名次就别回来」。压迫越具体，打脸落下时的高度差越大。改编时对手优先取原著人物；原著此处没有时按 STY-30 登记新增并交创作者。系统任务的时限与失败后果是第二层压力，按契约披露，不要写成一条替代爽感的焦虑条款。发动机：对手按表面判断下注，主角手里有对手看不见的底牌，结果当众揭晓。
 
 ## 人物策略与信息权限
 

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

@@ -86,7 +86,7 @@ license: MIT
 
     | 样式 | 各项的位置 |
     |---|---|
-    | `卡片` | 每项一行：第一个词是名称，最后一个词是数值，中间的词是单位（`主号 粉丝 2｜小号 1`） |
+    | `卡片` | 每项一行：第一个词是名称，最后一个词是数值，中间的词是单位（`本月 订单 128｜退货 3`） |
     | `系统面板` | 第一项是状态行，逐字打出；其余是奖励行 |
     | `任务面板` | 标题、目标（逐字打出）；其后写成 `<数> / <数>` 的一项是进度，其余是奖励标签 |
     | `角标` | 各项连成一行标签 |

package/lib/drama/skills/short-drama-edit/scripts/edit_tool.py

@@ -214,7 +214,8 @@ SHOT_MATCH_SAMPLE = "fps=4,scale=64:-2"
 STORYBOARD_DOCUMENT = "分镜.md"
 SHOT_HEADING = re.compile(r"^##\s+(SHOT-[^\s·]+)")
 SHOT_REFERENCE = re.compile(r"SHOT-[A-Za-z0-9-]+")
-SCENE_ID = re.compile(r"[A-Za-z]+[0-9]+-SC[0-9]+")
+# The same scene-id shape the cross-document checker accepts, season prefix included.
+SCENE_ID = re.compile(r"(?:[A-Za-z0-9]+-)+SC[0-9]+")
 # verify reads the delivered film at this size in grey, one value per pixel.
 FRAME_PROBE_SIZE = (90, 160)
 # A frame is suspect when it differs from both neighbours by more than this
@@ -1533,11 +1534,32 @@ def render(
             "".join(f"file '{segment.as_posix()}'\n" for segment in segments), encoding="utf-8"
         )
         joined = output_root / "成片-未混音.mp4"
-        # AAC encoder priming starts before zero. Keep that timestamp rather
-        # than shifting the video by one audio packet (and duplicating a frame
-        # when downstream tools decode at the delivery frame rate).
-        _run([ffmpeg, "-hide_banner", "-loglevel", "error", "-y", "-copyts",
-              "-f", "concat", "-safe", "0", "-i", str(listing), "-c", "copy", str(joined)])
+        # Pictures are stream-copied, but sound is not: every AAC segment opens
+        # with an encoder-priming frame, and copying the segments end to end
+        # left that frame as a ~32 ms dropout at each cut. The segments are
+        # decoded to PCM, joined sample-exact, and encoded once.
+        picture_track = Path(scratch) / "pictures.mp4"
+        _run([ffmpeg, "-hide_banner", "-loglevel", "error", "-y",
+              "-f", "concat", "-safe", "0", "-i", str(listing), "-map", "0:v",
+              "-c", "copy", str(picture_track)])
+        sound_listing = Path(scratch) / "sound.txt"
+        pieces = []
+        for index, (segment, length) in enumerate(zip(segments, spans)):
+            piece = Path(scratch) / f"{index:04d}.wav"
+            # A decoded AAC segment also runs into its last frame's padding;
+            # cut (or pad) every piece to the length its picture holds.
+            _run([ffmpeg, "-hide_banner", "-loglevel", "error", "-y", "-i", str(segment),
+                  "-map", "0:a", "-af", "apad", "-t", f"{length:.6f}",
+                  "-c:a", "pcm_s16le", str(piece)])
+            pieces.append(piece)
+        sound_listing.write_text(
+            "".join(f"file '{piece.as_posix()}'\n" for piece in pieces), encoding="utf-8"
+        )
+        _run([ffmpeg, "-hide_banner", "-loglevel", "error", "-y",
+              "-i", str(picture_track),
+              "-f", "concat", "-safe", "0", "-i", str(sound_listing),
+              "-map", "0:v", "-map", "1:a", "-c:v", "copy",
+              "-c:a", "aac", "-b:a", "192k", str(joined)])
 
         effects: list[Placed] = []
         placed = (

package/lib/drama/skills/short-drama-edit/scripts/selftest.py

@@ -224,7 +224,7 @@ def check_multi_subtitle() -> None:
         root = Path(scratch)
         episode = build(root, CUT_LIST)
         (episode / "剧本.md").write_text(
-            SCREENPLAY + "\n江晨：就是什么。\n江晨：就是少了点东西。\n江晨：少了什么。\n",
+            SCREENPLAY + "\n许棠：就是什么。\n许棠：就是少了点东西。\n许棠：少了什么。\n",
             encoding="utf-8",
         )
         multi = CUT_LIST.replace(

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

@@ -71,8 +71,4 @@ license: MIT
 每个点名对象都有明确用途、可复制正文、参考边界和禁止项，且相互不矛盾，即完成。本次请求同时
 修改图片提示词与分镜时，当轮刷新受影响镜头的「图片提示词项」，不另建对账产物。实际生成必须
 转 `$short-drama-produce`，展示精确任务并取得显式确认；本技能不调用外部服务。
-五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
-
-## 安装维护
-
-只有安装、升级或排障时运行 `python3 scripts/selftest.py`。
+写完本阶段文档后，可转 `$short-drama` 做局部机械核对（只核对已有文档）；五份齐备后再做完整核对。内容质量仍由创作者审查。

package/lib/drama/skills/short-drama-novel-analyze/references/aggregation-and-entities.md

@@ -145,12 +145,12 @@
 | 绰号 | 外号，须有同指证据 | 是（证据充分时） | 「城东那位」经文中点明即为某人 |
 | 描述性称谓 | 按外形或角色描述 | **否** | 「红衣女子」「随从」 |
 | 头衔职务 | 泛指某个职位的称呼 | **否** | 「护卫队长」「家主」 |
-| 姓氏＋头衔 | 带姓氏或名的称呼 | 是（证据充分时） | 「周团」「钟记者」「齐军长」 |
+| 姓氏＋头衔 | 带姓氏或名的称呼 | 是（证据充分时） | 「李队」「陈记者」「王厂长」 |
 
 绰号与姓氏＋头衔的合并都需要可指出的同指证据：同位说明、括号别名、上下文明确指代、
 文中改名。「读起来像同一个人」不是证据。
 
-**姓氏＋头衔单列一类，因为中文叙事里它常常是最主要的称呼方式**。「周团」「钟记者」
+**姓氏＋头衔单列一类，因为中文叙事里它常常是最主要的称呼方式**。「李队」「陈记者」
 出现频次可能远高于全名，而它们带着姓氏，指向性与绰号相当——按「头衔职务」一律禁止合并，
 一部书会留下十几条重复实体。真正不可合并的是**不带姓名的泛指**：「护卫队长」「家主」
 可以先后由不同人担任，同一部书里换了人也看不出来。

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

@@ -102,6 +102,8 @@ python3 <本技能目录>/scripts/production_tool.py audit <project>
   `reference_video + reference_image`。当前 creator-first 来源选择器只解析图片与角色参考音频，
   尚不能声明续接视频，因此这条内置生产路径不能提交续接段。报告接口缺口并保留已选路线，
   不省略来源选择器、不拿计划尾帧冒充真实输入，也不擅自改为独立文生视频。
+  `视频提示词.md` 里的 `GROUP-*` 多镜分组正文同样还不能作为来源：选择器只认 `MOTION-*`。创作者要提交分组时，
+  把分组正文复制到自己的生成工具；不要拿某个成员的 `MOTION-*` 代替整组提交。
 - **tts**：从 `剧本.md` 读取原句与表演要求，声音参考由用户或现有媒体明确提供。不得在生产 job
   中改词，也不为 TTS 新建第六份创作文档。表演要求来自这句台词的括注和上下文。外部执行端若把
   prompt 解释为含表演指令的输入，可在台词前写一句语气说明（「憋屈地压低声音，咬着牙应一声：是。」）；

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

@@ -112,7 +112,3 @@ license: MIT
 - 无法读取媒体时明确限制，不从文字或 adapter 状态推断脸部一致、表演、口型、混音或市场表现。
 - 生产观察必须绑定准确输入、提示词、参考、配置和结果版本；不能泛化成通用规则。
 - 审查文件只保留修订所需的最小证据，不复制完整私有输入。
-
-## 安装维护
-
-只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/lib/drama/skills/short-drama-review/references/production-quality-gates.md

@@ -178,7 +178,7 @@ H3 无非画内配乐时，`non_diegetic_music: N/A` 是有效的空形式。
 - 每个镜头为什么独立存在，改变了什么注意、压力、信息或观看位置？
 - 建立镜头、反应镜、插入镜头或重新解释前镜的镜头是否有职责，而不是凑数量？
 - 关键帧是否只有一个可冻结时刻？每张关键帧是否声明了它冻结的是哪一端，并绑定该镜头
-  对应的边界字段（`SHT-17`）？**尾帧是 `end_boundary` 的投影，不是第二个终点权威**——
+  对应的边界字段（`SHT-17`）？**尾帧是「终点」的投影，不是第二个终点权威**——
   尾帧与镜头终点不一致时，缺陷记在尾帧上。首帧是否只写 start 事实、尾帧是否只写 end
   事实，两张有没有互相借用？**关键帧数量不是检查项**：默认一张首帧，只在交付工作流真的
   消费尾帧时才有第二张，缺尾帧本身不是缺陷。

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

@@ -52,11 +52,12 @@ license: MIT
    先用已接受集长换成明确时间边界再分镜；例如 60 秒作品的“后半段首次出现”不得早于 30 秒。
 3. 每镜写清唯一职责、来源、时长、景别/机位、运镜、起点、唯一主要动作、终点和声音；用
    `起点 → 唯一动作 → 终点` 直接说明人物、双手与持物怎样完成本镜状态转换。三条依据留到第 6 步。
+   数一下这一镜要观众看清的事，按镜长判断每件有没有足够的时间被看清；放不下时先删、合并或拆镜，见 [短镜头的动作量](references/shot-craft.md#短镜头的动作量-sht-03)：视频模型不会删掉多出来的动作，而是把它们压到看不清。
    「运镜」按本镜目的逐镜选，写行为和理由，固定也写理由，见 [运镜逐镜选](references/shot-craft.md#运镜逐镜选-sht-04)。
    有对白、VO 或 OS 时，先按原文和人物说话方式估算完整发声时间，再安排不能重叠的动作、停顿与
    末尾反应；把估时依据简写在本镜「声音」里。具体做法见 [对白估时](references/shot-craft.md#对白估时)。
    对白场先按 [对白覆盖默认](references/shot-craft.md#对白场怎么切-sht-29) 放切点；镜长不按剧本字数折算。
-4. 锁定人物朝向、位置、视线、持物、出入口、屏幕方向和必要状态；上游已有会限制动作空间的持续关系时，把关系投影进本镜起点与终点。
+4. 一场戏拍成多镜时，先在《分镜.md》开头写这场的「场景站位」：固定锚点、各人相对锚点与彼此的位置、轴线与 working side、哪一镜改变站位。再逐镜锁定朝向、位置、视线、持物、出入口和必要状态，与「场景站位」一致；起点、终点里的位置写锚点和人物关系，视线写看向谁或什么；冻结关键帧再把它翻成本镜机位下的前后景、朝向、中间隔着什么和画面左右，见 [站位先写锚点和关系](references/blocking-playbooks.md#站位先写锚点和关系)。上游已有会限制动作空间的持续关系时，把关系投影进本镜起点与终点。
 5. 冻结关键帧只投影镜头起点；删除终点才出现的文字、动作、姿态或道具状态。
    镜头的职责落在收尾那一下时，另写 `### 收尾关键帧提示词` 投影**终点**——同一格画面的
    另一端，规则完全对称：删除起点才有、终点已经不在的东西。它是可选的，写法与取舍见
@@ -73,6 +74,7 @@ license: MIT
      只有创作者明确表示不用图时，才写「无（创作者已明确选择文生视频）」。
 
    三条依据读的是同一格画面，所以不能互相矛盾：关键帧里点名的人物或道具，一定出现在视觉依据里。
+   目标模型的参考槽位有上限（Seedance 2.0 全模态参考最多 9 张图）时，输入参考图按失去它的代价从高到低保留：起始帧、正在说话或做主要动作的人物、必须认得出的道具、地点、其余入画人物、定调图；放弃的那些写明，必要事实进关键帧正文。
 7. 整集请求完成整集，末端一次报告覆盖、节奏和真实未决选择。
 
 ## 镜头要求
@@ -86,10 +88,12 @@ license: MIT
 - 剧本里的每个场景都要有镜头承载。确实决定不拍某一场时，在《分镜.md》正文开头写一行
   `- 未拍场次：<场景 ID>（理由：……）`，多项用 `；` 连接。省略理由必须留在成稿文档中，供下游区分有意省略与遗漏（SHT-01）。
 - 已声明原生时长时，每镜照常有自己的唯一职责、起止边界和冻结关键帧，镜长先按叙事需要定。短于最短秒数
-  的镜头，向创作者提议把同场相邻的几镜装进一个多镜容器，在交付档案里声明；目标方言要求时，容器的每一切
+  的镜头，向创作者提议把同场相邻的几镜装进一个多镜容器；创作者同意后由 `$short-drama` 在生产档案里写入 `multi_shot_containers: true`；目标方言要求时，容器的每一切
   都要有已接受的关键帧图片，能否装、怎么装由 `$short-drama-video-prompts` 的方言决定。创作者没有声明
   多镜容器、或方言不支持时，镜头落在最短秒数内，动作完成后保持终点。长于上限的动作按可见状态闭合点拆镜，
-  拆出的每镜仍各有唯一职责与可信交界。
+  拆出的每镜仍各有唯一职责与可信交界。目标模型只收整数秒（如 Seedance 2.0 手动时长）时，单独生成的镜头写
+  整数秒；准备装进同一个多镜容器的短镜可以写半秒，但同一容器的成员加起来必须是整数秒，在分镜阶段就排好，
+  不留到视频提示词阶段分组时才发现凑不齐。
 - 「唯一动作」写从本镜起点到终点的那条可见状态链；涉及交接、换手、放置或取回时，把接触者、
   接触方式和物件落点写在同一链里，不能让合法终点之间靠镜外瞬移衔接。
 - 切镜必须带来信息、权力、情绪、空间或节奏变化；同义重复镜头删掉。
@@ -97,7 +101,7 @@ license: MIT
   写出该边界，不把“稍后”“交接后”等叙事顺序当成数值时间的替代。
 - 同一动作不跨镜重复发生，峰值处声明过的[冲击重复](references/shot-craft.md#动作落实表)除外；终点应能成为下一镜可信起点。
 - 关键信息的可读性优先于装饰性运镜，竖屏构图优先保证主体和反应可见。
-- 复杂群戏先锁空间锚点和屏幕方向，再决定景别变化。
+- 复杂群戏先在「场景站位」里锁空间锚点、人物位置和轴线，再决定景别变化。
 - 起终边界除了逐人姿态，还要写清本镜依赖的身体—物件—空间关系。关系在镜内不变时两端都保留；确需改变时，过程与终点必须有剧本依据。
 - 冻结关键帧只写该瞬间能看见的内容；文字、手指、反射和遮挡要可生成。
 - 近景类关键帧挂着地点板生成时，图片常被拉宽成中远景；正文写具体取景（画面切在哪、脸在画面哪里、机位距离），出图仍偏宽就这一镜不挂地点板，把背景写进正文。
@@ -176,8 +180,4 @@ license: MIT
 还没有条目的可见物件，在末尾报告里逐项点名。本次请求同时修改
 《图片提示词.md》与《分镜.md》时，当轮刷新受影响镜头的引用；不另建覆盖表。
 视频提示词、生产和审查只有用户点名时开始。
-五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
-
-## 安装维护
-
-只有安装、升级或排障时运行 `python3 scripts/selftest.py`。
+写完本阶段文档后，可转 `$short-drama` 做局部机械核对（只核对已有文档）；五份齐备后再做完整核对。内容质量仍由创作者审查。

package/lib/drama/skills/short-drama-storyboard/references/blocking-playbooks.md

@@ -65,31 +65,61 @@
 
 分镜阶段先核对已声明遮挡区，交付前再放到实际播放面复核，避免关键帧和视频完成后才发现关键信息被压住。
 
-## 1b. 轴线、屏幕方向与正反打
+## 1b. 站位、轴线与正反打
+
+### 站位先写锚点和关系
+
+**`SHT-30 · craft_default`**：站位分两层写。
+
+- **分镜的「场景站位」与每镜起点、终点**，用场景里不动的东西和人物之间的关系来写——坐在办公桌后、
+  背对窗、在门与桌之间、隔着桌子与赵经理相对、在她身后半步。“画面左侧”只在一个机位下成立，
+  反打、换景别就要重算；“在桌后、面对门”整场戏都成立，下一镜可以原样继承。
+- **冻结关键帧和视频提示词**，把这些关系翻成本镜机位下看得见的样子：机位在哪、谁在前景谁在后景、
+  谁面对镜头谁背对镜头、两人之间隔着什么、各自在画面哪一侧。只写“隔着桌子相对”这类抽象关系，
+  模型不一定照做：同一个“走到桌前、隔桌与他相对”的意图，只写关系时 Seedance 2.0 九次都把人放到了
+  桌子同侧；写成“机位在桌前，她走进前景、背对镜头停在桌子这一边，桌子在她和他之间”后，三次都对。
+  简单的画面左右（“男人在画面左侧，她从右侧进门”）在同一组测试里全部被遵循，可以作为构图写进提示词。
+  图生视频时站位由起始帧决定，正文不必再重申。
+
+视线写看向谁或什么（“看着赵经理”“盯着桌上的工牌”），不只写看向画面哪一侧：只写方向时，
+下一镜和下游都不知道那边是谁。单人镜头里目标在画外时，写明看的是谁，同时保留画面方向
+（“看向画外左侧门口的赵经理”）：正反打靠两镜视线方向互补才接得上。
+
+- ✅ 场景站位：`沈一舟坐在办公桌后，面对门；赵经理站在门口，与他隔着桌子相对`
+- ✅ 关键帧：`机位在门口，赵经理背对镜头站在前景，办公桌在她和沈一舟之间，沈一舟坐在桌后看着她`
+- ✅ `沈一舟看向画外左侧门口的赵经理`（单人镜头，目标在画外：写明是谁，并保留方向）
+- ❌ 场景站位：`沈一舟站在画面左三分之一处，赵经理占画面右侧`（只说了一格的构图，换机位就失效）
+- ❌ 关键帧：`赵经理与沈一舟隔桌相对`（没说机位和前后景，模型常把两人放到桌子同侧）
+- ❌ `沈一舟看向画右`（看向谁？）
 
 ### 左右的唯一读法
 
 **`structural_invariant`**：本套件所有产物里，**裸写的"左/右"一律指画面左右**（观众看到的
 左右）。指人物自身的左右时必须带主体——"他的左手""她的右肩"。两种读法混用是正反打
-最常见的失效来源，因为单看每一句都成立。
+最常见的失效来源，因为单看每一句都成立。场景里的固定方位不用裸写的左右，而用锚点互相定位
+（“窗在书柜墙靠门的一端”），因为从不同机位看，同一扇窗会落在画面不同侧。
 
-- ✅ `沈一舟站在画面左三分之一处，赵经理占画面右侧`
+- ✅ `构图：沈一舟在画面左，赵经理在画面右`（明说是画面方位，用于构图与轴线核对）
 - ✅ `秘书把工牌递到他的右手边`（带主体，指人物右手）
 - ❌ `秘书从右侧接近`（谁的右？下游只能猜）
 
-### 轴线怎么记
+### 场景站位
 
-轴线不是一个形容词，是**两个可命名锚点的连线**。记法要落成可比较的断言，让下一镜能
-逐字核对：
+一场戏开拍前，在《分镜.md》开头为它写一段「场景站位」，后面每一镜从这里继承站位，
+只在镜头里写本镜相对它的变化：
 
-```text
-轴线：沈一舟 ↔ 赵经理（两人连线）
-working side：摄影机常驻红毯一侧
-屏幕方向：沈一舟固定占画面左，赵经理固定占画面右
+```markdown
+## 场景站位 · EP003-SC002 · 财务室
+- 固定锚点：办公桌在房间中央；保险柜靠背墙；百叶窗在一侧墙上，门在对面的侧墙
+- 人物：赵经理坐在办公桌后，背靠保险柜；沈一舟站在桌前，与赵经理隔桌相对
+- 轴线：赵经理 ↔ 沈一舟（隔桌连线）；working side：百叶窗一侧
+- 屏幕方向：机位在窗一侧时，赵经理在画面右，沈一舟在画面左
+- 变化：SHOT-EP003-017 沈一舟走到窗边，背对赵经理
 ```
 
-写成 `<working side>` 这类占位等于没写。判据是：换一个人来拍下一镜，他能不能只读这
-三行就把机位放对。
+判据是：换一个人来拍这场戏的任何一镜，他只读这一段和本镜的起点，能不能把人和机位放对。
+写成 `<working side>` 这类占位等于没写。逐镜核对时比较的是这一段，而不只是上一镜：只和
+上一镜比，每次一点小偏差会一路累积下去。只有一镜的场次、或镜头里已经把站位写全时可以不写。
 
 ### 正反打的配对规则
 
@@ -191,7 +221,7 @@ working side：摄影机常驻红毯一侧
 不能只因为“仍是同一城门”，就绑定门内朝外的视角。选择前逐项比较摄影机所在一侧、
 可见锚点、朝向、时段、天气和光线；缺少合适视角时，向资产技能请求新版本。
 
-每次切镜前后比较：
+每次切镜前后比较（站位先对照本场的「场景站位」，再对照上一镜）：
 
 - 位置、面向和目光。
 - 左右手与持有道具。

package/lib/drama/skills/short-drama-storyboard/references/keyframe-craft.md

@@ -90,12 +90,12 @@ instead of inventing a hidden candidate state.
 
 ## 尾帧：什么时候可以有，以及它换来什么代价（`SHT-17`）
 
-默认每镜一张首帧，冻结 `start_boundary`。交付工作流需要首尾帧时，再补一张投影
-`end_boundary` 的尾帧；两帧之间的运动仍按分镜边界和运动提示词实现。
+默认每镜一张首帧，冻结「起点」。交付工作流需要首尾帧时，再补一张投影
+「终点」的尾帧；两帧之间的运动仍按分镜边界和运动提示词实现。
 
 **`structural_invariant`**：《分镜.md》的首帧与收尾关键帧分别指向同一镜头已接受的起点与终点。
-**尾帧是 `end_boundary` 的投影，
-不是新的终点事实**——它与首帧对 `start_boundary` 的关系完全一样：可以决定这一帧怎么构图、
+**尾帧是「终点」的投影，
+不是新的终点事实**——它与首帧对「起点」的关系完全一样：可以决定这一帧怎么构图、
 用什么景别镜头、光怎么落，不能决定人在哪、手里有什么、看着谁。尾帧与镜头终点不一致时，
 错的是尾帧。
 
@@ -112,7 +112,7 @@ instead of inventing a hidden candidate state.
   任何东西保证它会发生，就该拆镜，或者让该动作落在其中一端。
 - 两端差异越大，插值越自由，中间越不可控。首尾帧接续适合"状态改变清楚、路径无所谓"的
   镜头（转身、递交完成、坐下），不适合"路径本身是戏"的镜头。
-- 终点报告仍然对照镜头 `end_boundary`，不对照尾帧。尾帧只是它的投影，不能自证到达。
+- 终点报告仍然对照镜头「终点」，不对照尾帧。尾帧只是它的投影，不能自证到达。
 
 ## Start-only drafting discipline
 

package/lib/drama/skills/short-drama-storyboard/references/production-shot-grammar.md

@@ -22,7 +22,7 @@
 
 **分镜负责剪辑覆盖范围和可审查的起止边界**。
 它说明本镜为何存在、观众能知道什么、从哪一状态到哪一状态；只有已接受的制作方案
-需要时才补充时间段意图，完整动作措辞由视频提示词环节编写。`start_boundary` 可以是
+需要时才补充时间段意图，完整动作措辞由视频提示词环节编写。「起点」可以是
 静止关键帧，也可以是上游明确的运动中瞬间，不能把“静帧输入”误写成故事必须静止。
 
 ## 一、贯穿原则
@@ -35,8 +35,8 @@
    已接受的项目方案，不是每镜必填。
 4. **摄影行为有职责**（SHT-04）：运镜或有意固定机位都应能说明它如何服务注意力、
    压力、观众立场、揭示或节奏，而不是给每镜强加运镜。
-5. **连续性靠已确认边界比较**：精确绑定 `Location/View`、`start_boundary` 与
-   `end_boundary`；下游只重复执行必需的局部状态，不逐镜复制整份状态表。
+5. **连续性靠已确认边界比较**：精确绑定 `Location/View`、「起点」与
+   「终点」；下游只重复执行必需的局部状态，不逐镜复制整份状态表。
 
 ## 二、编号与文本分工
 
@@ -83,7 +83,7 @@
 摄影意图：<固定/移动及其叙事职责>
 ```
 
-- 起点逐字段写入已接受的 `start_boundary`，不把静态关键帧的媒介性质改成“人物必须静止”；
+- 起点逐字段写入已接受的「起点」，不把静态关键帧的媒介性质改成“人物必须静止”；
 - 结束状态由分镜文件记录，下一镜通过引用比较，不靠复制长篇说明获得权威；
 - 「唯一动作」是本镜的主状态链，不是限制镜内只能发生一个原子动作；它把必要步骤放在同一条
   因果线上，确保上一个可见状态确实走到下一个可见状态。
@@ -228,7 +228,7 @@
 
 1. 台词、行动、证据或沉默由什么可见/可听载体承担？有没有把以对白为主的合法镜头
    误判成必须添加动作？
-2. `start_boundary` 与 `end_boundary` 是否逐字段可比较？运动中边界、停顿和静止都与上游内容相容吗？
+2. 「起点」与「终点」是否逐字段可比较？运动中边界、停顿和静止都与上游内容相容吗？
 3. 摄影选择或有意固定机位能回答它怎样服务注意力、观众立场、信息揭示、
    空间或节奏吗？
 4. 并行微动态有上游或环境依据吗？没有时是否避免为“画面活”而硬加？