@oh-story/dsh 0.1.9 → 0.1.11

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

@@ -37,8 +37,8 @@ license: MIT
 现成剧本可直接拆资产；已有视觉事实可直接写图片提示词或分镜；已有分镜可直接写视频提示词。
 不要为补齐名义流水线伪造上游。
 
-五文档是创作真相，剪辑单不是第六份。它写在素材生产之后，只记录「已有的这些素材，哪些帧进成片」，
-不改变任何一集的剧本、镜头职责或时长声明；需要改这些就回到拥有它们的文档。
+五份创作文档记录剧本、视觉与提示词；剪辑单在素材生产后记录取舍和后期处理。
+修改故事、镜头职责或上游时长声明时，回到负责该内容的文档。
 
 ## 执行请求
 
@@ -91,7 +91,7 @@ python3 {技能目录}/scripts/project_tool.py set-authority <project> \
   --decision-ref "创作者决策/production-profile.jsonl#CD-H3"
 ```
 
-各字段取值由命中的模型方言给出：`$short-drama-video-prompts` 的 MiniMax H3 / Seedance 方言文件都写了
+各字段取值由命中的模型方言给出：`$short-drama-video-prompts` 的 MiniMax H3 / Seedance / Wan 3.0 方言文件都写了
 推荐档案。写完用 `status` 复核 `video_model_profile` 是否已经出现。
 
 项目定位与安全写入见 [运行预检](references/runtime-preflight.md)。用户明确要求 Dashboard 时运行：
@@ -112,13 +112,25 @@ python3 {技能目录}/scripts/dashboard_server.py --workspace <workspace> --sto
 同一 workspace 已有在跑的 Dashboard 时，再次启动只会打印同一个链接，不再开第二个端口；确实要换
 端口或换令牌时加 `--restart`。不加 `--detach` 时行为不变：前台运行，Ctrl-C 结束。
 
-Dashboard 展示和编辑创作文件，不负责工作流编排或媒体生产。
+Dashboard 按阶段展示项目：全剧页给出下一步和分集进度，每集分剧本、设定、分镜、提示词、成片、审查
+六个视图，⌘K 搜索全剧。结构视图只读，改动在「编辑原文」里保存 Markdown。画面只认文档里的绑定：
+缩略图是分镜里 `用途：起始帧` 的 `REF-...`，每镜素材是剪辑单的「来源」，成片是剪辑输出；没有绑定
+就显示空位，不按文件名配图。它不负责工作流编排或媒体生产，需要写作或生成的地方只复制一句请求交回对话。
+每集目标时长取自 `status` 的 `format`，节奏对照只用已接受的 `rhythm_profile`。
 
 ## 项目级创作决定
 
 制作形态、视觉方向、播放面和集长目标确实约束多个阶段时，展示选择及影响后由用户决定。
 Look Development 是可选分支，不是进入图片提示词或分镜的固定门槛。
 
+节奏数值（首钩秒数、情绪触点间隔、反转次数、VO 占比、平均镜长等）住在
+`creator_authority.rhythm_profile`。字段与默认值由 `$short-drama-develop` 按制作形态提出，
+创作者接受或改写后，按上文三步写入：决策的 `accepted_value` 是完整档案对象，`--field`
+写 `/creator_authority/rhythm_profile`；档案已接受后，单改一个值时 `--field` 指向该字段。
+`set-authority` 只校验类型与范围，缺字段、越界或多出未知字段都拒绝写入。下游只按 `status` 为 `accepted` 的档案做算术核对，缺失、`unset` 或
+`proposed` 都表示「未声明，不核对」。写完用 `status` 复核 `rhythm_profile`；手改后档案不合法时
+它返回空档案，问题列在 `rhythm_profile_problems`。
+
 按问题只读取一份相关知识：
 
 - 规则分级与 owner 路由：[规则与路由索引](references/knowhow-index.md)

package/lib/drama/skills/short-drama/assets/project-template/short-drama.json

@@ -31,6 +31,9 @@
       "aspect": null,
       "overlay_regions": [],
       "source_ref": null
+    },
+    "rhythm_profile": {
+      "status": "unset"
     }
   }
 }

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

@@ -56,6 +56,7 @@
 - 时长：4s
 - 目的：先让观众看见他不敢进门，再揭示门内争吵。
 - 景别/机位：中近景，门框外侧，轻微低机位。
+- 运镜：固定；他收手的那一下要自己被看见，机位不抢。
 - 起点：江辰右手悬在门把上方。
 - 唯一动作：门内玻璃落地声触发江辰收回右手，视线从门把转向门缝。
 - 终点：江辰右手垂回身侧，视线落在门缝。
@@ -67,6 +68,8 @@
 > 按项目提示词语言编写的冻结瞬间正文……
 ```
 
+「运镜」写行为和理由，固定也要写理由，如「运镜：固定；这句话没有落到谁身上」。
+
 只写有镜头职责的镜头。关键帧提示词必须与该镜“起点”一致；终点才出现的文字、动作或状态不得
 提前进入静帧，也不要把整段动作塞进静帧。
 

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

@@ -22,27 +22,38 @@
 | 故事承诺与冲突引擎 | `$short-drama-develop` | 从点子建立可持续压力与回报 | 不用题材词直接生成剧情 |
 | 单集契约与集尾交接 | `$short-drama-develop` | 规划进入状态、局部结果与出去压力 | 不代替剧本场景执行 |
 | 单元里被反复运行的机制与耗尽 | `$short-drama-develop` | 单元故事靠同一套机制反复兑现，或中段开始重复、越写越薄 | 不规定运行次数与换代位置；不替单集决定怎么写 |
+| 爽点排名与开篇替换点 | `$short-drama-novel-analyze` | 选段与切候选集之前，按观众收益给全书情节点排名 | 排名是候选；从哪里开篇、提前哪段由创作者与 develop 定 |
+| 项目节奏档案 | `$short-drama-develop` | 按制作形态提出首钩、触点间隔、反转、VO 占比、镜长等项目数值 | 只提起点值；创作者接受后下游只做算术核对，未声明不核对 |
 | 单集容量可行性 | `$short-drama-develop` | 进入场景化前估算各集镜头与时长量级 | 用项目自身比例，不设跨项目门槛，不阻断交付 |
 | 连载人物与恢复记忆 | `$short-drama-develop` | 跨集人物策略、信息权限与铺垫债务较重 | 单场任务不必建立全量记忆 |
 | 长材料改编 | `$short-drama-develop` | 压缩、合并或把说明转成屏幕载体 | 不复制原句或文风到新剧本 |
+| 改编守住人物与新增登记 | `$short-drama-develop` | 改编时想新增人物、场景或对手，或想改一个原著人物的立场与关系 | 核心人物立场、核心关系与主线不改；新增登记为 `add` 交创作者确认 |
 | 题材条件与钩子 | `$short-drama-develop` | 需要按压力机制比较题材写法 | 不把案例节拍、数字或标签当公式 |
 | 单题材执行细节 | `$short-drama-develop` | 已确定题材、要落到场面颗粒与打法 | 一次只读一张卡；卡片不产生可阻断约束 |
 | 前提装置（先知或外部授权） | `$short-drama-develop` | 主角带着已知结果开局，或获得一套外部规则给的能力 | 装置叠加在题材之上，不替代题材卡，也不新建题材 |
 | 单形态执行细节 | `$short-drama` | 已确定制作形态、要按表定位一张形态卡 | 一次只读一张卡；形态不改写身份与地理 |
 | Look Development 与风格帧 | `$short-drama` | 把视觉方向变成人物、地点和高压力代表帧的可观察规则 | `$short-drama-image-prompts` 只投影提示词；风格不接管身份、地理或剧情 |
 | 场景与可表演行动 | `$short-drama-write` | 把单集节拍落实成场景 | 不决定分镜景别和运镜 |
+| 开场第一拍 | `$short-drama-write` | 写每集第一段动作描写，也就是观众开场第一帧的画面 | 静止画面自己能提出问题也算；不规定第一拍必须动 |
 | 对白行动与人物声音 | `$short-drama-write` | 写、改或诊断对白 | 不按句长、口癖数量判权力 |
 | 多人场次的可辨识度与主角缺席场 | `$short-drama-write` | 一场里人多到分不清谁在与谁交手，或某场/某集不给主角 | 不决定站位、景别与镜头切换；那属于分镜 |
 | 场次声音戏剧 | `$short-drama-write` | 声源、留白或 sound bridge 承担故事信息与压力 | 不替逐镜实现或混音，不让配乐替代表演 |
 | 剧本生产标签 | `$short-drama-write` | 规范化对白、动作、VO/OS、文字与连续性 | 不借格式补造剧情 |
+| 节奏档案落地 | `$short-drama-write` | 项目已接受节奏档案，要让首钩、触点间隔、有对手的反转与集尾落在档案数值内 | 只读档案、不改档案；数值是上下限不是节拍模板；未接受不核对 |
+| 旁白占比与能演的不说 | `$short-drama-write` | 旁白复述已演出的信息、内心独白过多，或痛点只被说出没被演出 | 占比只按已接受档案核对 |
+| 对白初稿回读删句 | `$short-drama-write` | 对白初稿写完回读，删掉不承担动作或冲突、演不出来的句子 | 不修剪创作者提供的原文 |
 | 有限行动单位与精确时限 | `$short-drama-write` | 题面明确给出可核对的次数、轮次、节拍或字面死线 | 按完成状态与题面约定检查，不把定性压力升级为数字或主动增加计数结构 |
 | 资产出现证据 | `$short-drama-assets` | 从剧本拆角色、地点、道具与状态 | 不用名词/人名匹配直接建资产 |
 | 身份、变体与复用 | `$short-drama-assets` | 决定复用、新变体、新身份或未决 | 相机角度通常不是资产变体 |
 | 原著自带的真实品牌与现实实体 | `$short-drama-assets` | 剧本沿用了原著专名，且该专名指向现实存在的品牌、商标、机构或人物 | 不判断合规、不给禁令、不内置清单；只把选择交给创作者并留痕 |
+| 时代锚点 | `$short-drama-assets` | 定项目时代，或场所、设备、制服要落到某个年代的形制 | 时代从原著事实定；旧、老式、复古要有原著依据或创作者选择 |
 | 资产图片提示词 | `$short-drama-image-prompts` | 把已接受资产投影为单帧可见规格 | 不承载有先后顺序的剧情动作 |
 | 场景板光线与跨 View 一致 | `$short-drama-image-prompts` | 同一地点要拆多个观察方向、且这些板会被互相剪接 | 朝向造成的逆光/落影差异不需拉平 |
 | 图片提示词定点修改 | `$short-drama-image-prompts` | 修改局部并冻结 preserve set | 不把重写整图伪装成局部编辑 |
 | 镜头目的与覆盖 | `$short-drama-storyboard` | 从剧本建立有动机的镜头 | 不为景别多样性硬拆镜 |
+| 逐镜运镜 | `$short-drama-storyboard` | 每镜决定摄影机动不动、怎么动、为什么 | 按本镜目的选，固定也写出来；执行端术语归视频提示词方言 |
+| 镜长推导与对白覆盖 | `$short-drama-storyboard` | 定镜长，决定一句台词给说话人还是听者、要不要反应镜与正反打 | 镜长不按剧本字数折算；平均镜长是场级目标，不是逐镜配额 |
+| 峰值强调与冲击重复 | `$short-drama-storyboard` | 情绪爆发或重大反转要推近、定格、闪白，或把同一关键动作从两三个角度重复 | 只用在峰值；冲击重复要声明主镜，状态只变一次 |
 | 场次视觉计划与 Coverage Audition | `$short-drama-storyboard` | 关键场次需先比较观众立场、信息时机、空间、摄影与声音运动 | 可选中间层，不拥有剧本事实或 shot 边界，不规定宫格/镜头数 |
 | 冻结关键帧 | `$short-drama-storyboard` | 写镜头起点的可冻结瞬间 | 不写动作链或镜头终态 |
 | 漫剧关键帧视觉词表 | `$short-drama-storyboard` | 视觉方向已接受为漫剧/二维漫画形态，要为关键帧稳定投影共享画风与当前可读性约束 | 全部是 `taste_option` 选项，不设质量门槛，不替代身份、地理与边界事实 |
@@ -51,12 +62,16 @@
 | 交付容器与分段算术 | `$short-drama-video-prompts` | 项目声明了分段或多镜打包的交付方式 | 打包方式不改写镜头边界与可审查性 |
 | 交付路由与执行触发词 | `$short-drama-video-prompts` | 项目声明了逐镜以外的路由，或某路由要求固定字样 | 触发词与路由都由创作者档案声明，本套件不自造字样，续接不产生第二个起点权威 |
 | 表演动作与时长 | `$short-drama-video-prompts` | 动作、台词与落点可能超载 | 不用每秒动作数设通用阈值 |
+| 表演强度按形态与题材 | `$short-drama-video-prompts` | 导演没定表演强度，漫剧或爽文峰值需要外放、AI 真人需要可读的表演 | 仍写成常见的全身动作，不让剧情压在微表情上 |
 | 摄影机、声音与相连边界 | `$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` | 项目已接受节奏档案，要按档案数值核对单集 | 只做已接受值上的算术，偏差不阻断；不拿别的项目或套件数字比较 |
+| 三道局部检查 | `$short-drama-review` | 整集通读之外，分别只读开场、结尾与中段，看钩子、悬念与反转密度 | 每道只读自己那一段，不替代整集判断 |
+| 只打补丁与被删强钩子回收 | `$short-drama-review` | 提修改要求，或润色删掉了强钩子、兑现台词或喜剧反应 | 修改是带保留集的定点补丁，不整集重写 |
 | 项目生产观察与校准 | `$short-drama-review` | 有授权文字观察且需定位到准确 prompt/spec/reference/config | 只在当前项目和版本有效；未观察结果保持未知 |
 | 结果处置判断 | `$short-drama-review` | 已有诊断，要决定保留、后期、局部编辑、重新提交还是改写 | 处置先于修订；重复提交同一文本与追加形容词都不算修复 |
 | 模板感诊断 | `$short-drama-review` | 至少两个位置出现同构机制或表达损失 | 不用禁词或单次类型惯例定罪 |

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/scripts/project_tool.py

@@ -120,6 +120,23 @@ PACING_POINTER = "/format/pacing"
 # 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)
+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
+# are checked here; which values suit a project is the creator's call.
+RHYTHM_PROFILE_FORMS = ("ai_live_action", "motion_comic")
+RHYTHM_PROFILE_FIELDS = {
+    "form": "form",
+    "first_hook_seconds": "seconds",
+    "beat_interval_seconds_max": "seconds",
+    "opposed_reversals_per_episode_min": "count",
+    "end_on_peak": "boolean",
+    "reprise_previous_last_beat": "boolean",
+    "vo_share_max": "share",
+    "target_avg_shot_seconds": "seconds",
+    "close_shot_share_min": "share",
+    "first_major_payoff_by_episode": "episode",
+}
 
 class ProjectConflictError(RuntimeError):
     """A file changed while a guarded operation was in progress."""
@@ -258,6 +275,96 @@ def project_video_model_profile(project: Mapping[str, Any]) -> dict[str, Any]:
     return {field: choices[field] for field in fields if field in choices}
 
 
+def project_format(project: Mapping[str, Any]) -> dict[str, Any]:
+    """The episode shape the creator set: count, length and frame.
+
+    Only well-formed values are reported, so a reader can do arithmetic on
+    them without re-validating; anything else in the format block (pacing
+    rates, prompt language) is working detail the status does not repeat.
+    """
+    block = project.get("format")
+    if not isinstance(block, Mapping):
+        return {}
+    result: dict[str, Any] = {}
+    count = block.get("episode_count")
+    if isinstance(count, int) and not isinstance(count, bool) and count > 0:
+        result["episode_count"] = count
+    seconds = block.get("target_seconds_per_episode")
+    if (
+        isinstance(seconds, (int, float))
+        and not isinstance(seconds, bool)
+        and math.isfinite(seconds)
+        and seconds > 0
+    ):
+        result["target_seconds_per_episode"] = seconds
+    ratio = block.get("aspect_ratio")
+    if isinstance(ratio, str) and ratio.strip():
+        result["aspect_ratio"] = ratio.strip()
+    return result
+
+
+def rhythm_profile_problems(profile: Any) -> list[str]:
+    """Type and range problems in a rhythm profile block; empty when usable.
+
+    A profile is complete or it is not a profile: a downstream stage doing
+    arithmetic on it cannot tell a field left out from a field meant as zero.
+    """
+    if not isinstance(profile, Mapping):
+        return ["rhythm_profile must be an object"]
+    problems: list[str] = []
+    for name in sorted(set(profile) - set(RHYTHM_PROFILE_FIELDS) - {"status"}):
+        problems.append(
+            f"rhythm_profile has no field {name}; fields are "
+            f"{', '.join(RHYTHM_PROFILE_FIELDS)}"
+        )
+    for name, kind in RHYTHM_PROFILE_FIELDS.items():
+        if name not in profile:
+            problems.append(f"rhythm_profile.{name} is missing")
+            continue
+        value = profile[name]
+        number = isinstance(value, (int, float)) and not isinstance(value, bool)
+        whole = isinstance(value, int) and not isinstance(value, bool)
+        if kind == "form":
+            ok = value in RHYTHM_PROFILE_FORMS
+            expected = " or ".join(RHYTHM_PROFILE_FORMS)
+        elif kind == "boolean":
+            ok = isinstance(value, bool)
+            expected = "true or false"
+        elif kind == "seconds":
+            ok = number and math.isfinite(value) and value > 0
+            expected = "a positive number of seconds"
+        elif kind == "share":
+            ok = number and 0 <= value <= 1
+            expected = "a share between 0 and 1"
+        elif kind == "count":
+            ok = whole and value >= 0
+            expected = "a whole number of 0 or more"
+        else:
+            ok = whole and value >= 1
+            expected = "an episode number of 1 or more"
+        if not ok:
+            problems.append(f"rhythm_profile.{name} must be {expected}, not {value!r}")
+    return problems
+
+
+def project_rhythm_profile(project: Mapping[str, Any]) -> tuple[dict[str, Any], list[str]]:
+    """The accepted rhythm profile values and the problems that void them.
+
+    A missing, unset or merely proposed profile is undeclared: nothing
+    downstream checks against it. An accepted profile that no longer passes
+    validation (a hand edit) is reported with its problems and declares
+    nothing either, since arithmetic on a bad value is a wrong number.
+    """
+    authority = project.get("creator_authority")
+    profile = authority.get("rhythm_profile") if isinstance(authority, Mapping) else None
+    if not isinstance(profile, Mapping) or profile.get("status") != "accepted":
+        return {}, []
+    problems = rhythm_profile_problems(profile)
+    if problems:
+        return {}, problems
+    return {name: profile[name] for name in RHYTHM_PROFILE_FIELDS}, []
+
+
 def initialize_project(
     path: Path,
     *,
@@ -911,6 +1018,7 @@ def _build_status(
                     ownership[output] = owner
     languages = project_languages(project)
     video_model_profile = project_video_model_profile(project)
+    rhythm_profile, rhythm_problems = project_rhythm_profile(project)
     return {
         "project_id": project.get("project_id"),
         "title": project.get("title"),
@@ -918,6 +1026,9 @@ def _build_status(
         "prompt_language": languages["prompt_language"],
         "video_prompt_language": languages["video_prompt_language"],
         "video_model_profile": video_model_profile,
+        "format": project_format(project),
+        "rhythm_profile": rhythm_profile,
+        "rhythm_profile_problems": rhythm_problems,
         "project_root": project_root,
         "last_action": state.get("last_action"),
         "layout": dict(layout),
@@ -1548,7 +1659,27 @@ def set_creator_authority(
         project = json.loads(project_path.read_text(encoding="utf-8"))
         if not isinstance(project, dict):
             raise ValueError("project manifest must be an object")
+        rhythm = tokens[:2] == RHYTHM_PROFILE_TOKENS
+        authority = project.get(AUTHORITY_ROOT_TOKEN)
+        if rhythm and len(tokens) > 2:
+            # Writing one field accepts the block it sits in, so a leaf write
+            # into a proposed or unset profile would promote numbers nobody
+            # accepted. A single value can only change an accepted profile.
+            current = authority.get("rhythm_profile") if isinstance(authority, dict) else None
+            if not isinstance(current, Mapping) or current.get("status") != "accepted":
+                raise ValueError(
+                    "rhythm_profile is not accepted; accept the whole profile "
+                    "before changing one of its fields"
+                )
+        if rhythm and isinstance(authority, dict) and "rhythm_profile" not in authority:
+            # The project template declares this slot as unset; a manifest made
+            # from an older template lacks it, so a whole-profile write adds it.
+            authority["rhythm_profile"] = {"status": "unset"}
         written = _write_authority_value(project, tokens, value)
+        if rhythm:
+            problems = rhythm_profile_problems(project[AUTHORITY_ROOT_TOKEN]["rhythm_profile"])
+            if problems:
+                raise ValueError("; ".join(problems))
         if field == PACING_POINTER:
             # Check what the manifest will hold, not what the decision said: an
             # object slot is merged, so a half decision leaves the other rate at

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

@@ -26,7 +26,7 @@ license: MIT
 
 ## 工作流
 
-1. 只读当前范围的剧本和已决定的视觉方向。
+1. 只读当前范围的剧本和已决定的视觉方向；视觉方向还没有时代锚点时，先按原著事实定时代。
 2. 逐场找实体、可见描述、状态变化和含混指代，先不创建资产。
 3. 对每项决定新建、复用、增加变体或标记未决；含混指代不猜。
 4. 写最小可识别设定：统一使用 `识别锚点`、本集状态和变化原因；会持续限制后续动作的身体—物件—空间关系写进有生效范围的状态，不当成一次姿势略过。
@@ -55,6 +55,7 @@ license: MIT
 默认只读本 SKILL、当前剧本和视觉方向。遇到对应问题时只打开一份：
 
 - 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 定时代、写时代锚点，或想把场所、设备、服装写旧：[时代锚点](references/era-anchors.md)
 - 从剧本找真正的资产出现证据：[出现提取](references/occurrence-extraction.md)
 - 新身份、复用、变体或未决：[身份与变体](references/identity-vs-variant.md)
 - 人物识别与造型层次：[人物与造型](references/character-and-look.md)

package/lib/drama/skills/short-drama-assets/references/asset-review-checklist.md

@@ -34,6 +34,7 @@
 - [ ] Prop 形制/功能身份没有因 owner、开合、破损、内容或文字状态被复制。
 - [ ] 每个新 asset 有不能复用的持久证据；每个 variant 说明 base 什么保持不变。
 - [ ] 提取没有凭空补脸、品牌、门窗、内容物、伤势、灯光或可读文字。
+- [ ] 时代不与原著事实矛盾；旧、老式、复古一类词有原著依据或创作者选择（`AST-14`）。
 - [ ] transfer、伤势、换装、停电、天气/光态和知识变化都有足以支持的剧情原因。
 - [ ] occurrence 的 production disposition 合理：提及不被误当出镜，关键操作物不被
   降成普通布景。
@@ -48,6 +49,7 @@ Reviewer finding 应含文件与标题 ID、证据、影响、修订结果、own
 - [ ] 设定集 只保留识别、复用、prompt、镜头和连续性所需事实。
 - [ ] Location 先有地理/入口/固定锚点，再有氛围；Prop 有尺度/形制/材料/功能；
   Character 有可观察的区分锚点。
+- [ ] 项目视觉方向写了时代锚点，地点、造型、道具条目写出时代形制（`AST-15`）。
 - [ ] outgoing 精简但足以让下一场/集无脑内补全地继续。
 
 Creator 可用制作原因覆盖，例如需要逐件审批背景陈设；记录 override，而非改成硬规则。

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/era-anchors.md

@@ -0,0 +1,37 @@
+# 时代锚点
+
+## 时代从原著事实来
+
+拆资产之前先定时代。能定时代的是原著与剧本里的事实：设备（智能手机、U 盘、液晶屏）、平台与传播方式
+（热搜、短视频账号、直播带货）、流行语、写明的年份，或能从年龄与事件推出的年代。按这些事实在
+`视觉设定.md` 顶部的项目视觉方向写一行时代锚点：先写年份或年代，再写设备、制服、家具和灯光在这个
+年代长什么样。
+
+```markdown
+- 时代锚点：当下（2020 年代）；设备：全面屏智能手机、笔记本电脑、液晶显示器；制服：现行常服；陈设：白色工位桌、网面办公椅；光：嵌入式 LED 面板灯，冷白。
+```
+
+原著没有能定时代的事实时，把时代标为「需创作者决定」，不默认成过去。
+
+## 旧要有来源
+
+部队办公室、机关、学校、医院这类机构场所，模型和写作者都会顺手写成旧的：老式显示器、积灰的主机、
+褪色的墙、旧款手机。原著写的是智能手机和短视频账号，画面却回到二三十年前，观众第一眼就出戏。
+
+**`reviewed_invariant` AST-14**：`视觉设定.md` 与从它投影出的提示词所呈现的时代，不与原著事实矛盾。
+「旧」「老式」「复古」「褪色」「斑驳」，以及 old、worn、dusty、period、CRT 这类让画面变旧的词，要有原著依据
+或创作者明确的选择；两样都没有就删掉，改用时代锚点里的写法。原著写某件东西旧，旧是这件物的状态，
+写在它自己的条目里，不把整个地点带回过去。
+
+## 条目带上时代形制
+
+**`craft_default` AST-15**：项目视觉方向写出时代锚点；地点、造型和道具条目在年代会改变外观的地方写具体
+形制——写液晶显示器，不写显示器；写现行常服，不写军装。图片和视频提示词照条目写，时代线索就随地点、
+服装和道具进入下游。
+
+## 合成例
+
+原著：主角刷热搜、开短视频账号、用 U 盘拷资料，故事发生在部队宣传部门的办公室。
+
+- 错：「老旧的机关办公室，老式显示器，旧款智能手机」——原著里没有一处支撑。
+- 对：时代锚点写当下；办公室条目写液晶显示器、嵌入式 LED 面板灯、网面办公椅；手机写全面屏智能手机。

package/lib/drama/skills/short-drama-assets/references/stage-contract.md

@@ -25,6 +25,8 @@
 | AST-11 | reviewed_invariant | Characters designed together are not bound to confusable references; each names the audible trait telling it apart from its nearest neighbour, and names that character. |
 | AST-12 | craft_default | Selection criteria are few, audible and counter-exampled; they judge a candidate reference or a clone result, they do not stand in for one. |
 | AST-13 | structural_invariant | When the project's prompt language is not the language of the entry headings, every 人物 entry a shot's 视觉依据 references reaches a stated conclusion: `画面代称` carrying the exact spelling prompt bodies use, or `画面代称：无` when no body names it. One accepted name uses one spelling, case included. 地点/道具 declare one only when a body names them. |
+| AST-14 | reviewed_invariant | The era shown in `视觉设定.md` and in the prompts projected from it does not contradict source facts—devices, platforms, slang, stated years. A retro or aged descriptor (旧/老式/复古/褪色/斑驳, old, worn, dusty, period, CRT) cites a source basis or an explicit creator choice. |
+| AST-15 | craft_default | The project visual direction states explicit era anchors: the year or decade, and how devices, uniforms, furniture and lighting look in it. Location, costume and prop entries carry the era-specific form that image and video prompts copy. |
 
 ### `CON`
 

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-develop/SKILL.md

@@ -86,7 +86,11 @@ python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <epi
 读取 [episode-design.md](references/episode-design.md)，再复制 [episode-map.jsonl](assets/episode-map.jsonl)。每一集记录进入状态、开场、当集追求、阻力、方向性转折、当集结果、信息释放、出去的压力以及下一集必须继承的事实。
 
 先保证每集产生局部戏剧结果、相邻集能精确交接，再讨论外部压力/情感负荷的双轨
-节奏。集数、钩子类型、是否反转和高潮位置由创作者与项目决定。
+节奏。第 1 集入口先比较收益入口与冷开；改编项目先读原著分析的爽点表，把高光排到观众
+最早能拿到的位置。集数、钩子类型、是否反转和高潮位置由创作者与项目决定。
+
+制作形态一定下，就按分集设计里的默认值提出项目节奏档案，写进创作简报交创作者接受；
+接受后由 `$short-drama` 写入 `creator_authority.rhythm_profile`。
 
 ### 5. 做所有者检查并交接
 
@@ -96,6 +100,7 @@ python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <epi
 - 候选确实改变机制，选定方向贯穿简报、引擎与分集地图；
 - 每次升级能指出权力、信息、关系、暴露、资源、时间或代价的变化；
 - 每集先兑现一部分当集承诺，再留下具体的决定、危险或问题；
+- 改编项目里核心人物的立场、核心关系和主线没有被改写；原著没有的新增内容都登记为 `add`，并列在简报里；
 - 没有把格式偏好冒充普遍规律。
 
 这些是所有者自检，不是终审。展示创作者可读的新增/修改摘要，请创作者接受后再作为下游来源；
@@ -112,7 +117,8 @@ python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <epi
 - **`craft_default`**：通常有帮助的做法；创作者说明理由后可覆盖。
 - **`taste_option`**：钩子、弧线、视角、结局气质等选择；不得单独阻断。
 
-不要用固定的情节点、转折时刻、篇幅比例或数量配方替代因果判断。
+不要用固定的情节点、转折时刻、篇幅比例或数量配方替代因果判断；节奏数值只以创作者接受的
+项目节奏档案出现。
 
 ## 产物与边界
 
@@ -133,12 +139,12 @@ python3 {技能目录}/scripts/episode_intake.py index <多集整稿> --out <epi
 ## 按需加载
 
 - **承诺、引擎、人物压力、升级与铺垫兑现**：[story-craft.md](references/story-craft.md)
-- **分集契约、因果节拍、集间交接与地图修订**：[episode-design.md](references/episode-design.md)
+- **分集契约、因果节拍、集间交接、首集入口、门槛集与项目节奏档案**：[episode-design.md](references/episode-design.md)
 - **已有多集完整剧本/散稿，要避免整稿进入上下文并可中断续跑**：
   [multi-episode-intake.md](references/multi-episode-intake.md)
 - **人物驱动力、前史与切入、跨集变化、信息权限、双轨节奏与恢复记忆**：
   [serial-character-and-memory.md](references/serial-character-and-memory.md)
-- **有原材料、需要压缩/合并人物场景/把信息视觉化**：
+- **有原材料、需要按爽点压缩、提前或冷开后文、合并人物场景、把信息视觉化**：
   [adaptation-craft.md](references/adaptation-craft.md)
 - **创作者提供对标作品、样例剧本或提示词，希望学习机制而非仿写表达**：
   [creative-reference-intake.md](references/creative-reference-intake.md)

package/lib/drama/skills/short-drama-develop/assets/adaptation-map.example.jsonl

@@ -1 +1 @@
-{"example_only":true,"destination":"项目开发/adaptation-map.jsonl","schema_version":"1.0.0-draft","record_type":"adaptation_mapping","mapping_id":"ADAPT-EXAMPLE","status":"candidate","source_ref":{"owner":"creator","artifact":"输入/original-source.txt"},"source_span":{"byte_start":120,"byte_end":268,"line_start":8,"line_end":14},"function_summary":"一次旧选择使两名角色对当前证据承担不同风险；摘要不复制来源原句","mentioned_entities":[{"source_label":"称谓甲","proposed_identity":"CHAR-CANDIDATE-A","resolution":"unresolved"}],"adaptation_decision":{"disposition":"preserve | merge | change_carrier | compress | omit | unresolved","candidate_episode":"EP-CANDIDATE","new_carrier":"可见行动/证据/空间/对白策略或 unresolved","preserved_functions":["关系压力"],"lost_or_changed":[]},"creator_acceptance":{"status":"pending","decision_ref":null}}
+{"example_only":true,"destination":"项目开发/adaptation-map.jsonl","schema_version":"1.0.0-draft","record_type":"adaptation_mapping","mapping_id":"ADAPT-EXAMPLE","status":"candidate","source_ref":{"owner":"creator","artifact":"输入/original-source.txt"},"source_span":{"byte_start":120,"byte_end":268,"line_start":8,"line_end":14},"function_summary":"一次旧选择使两名角色对当前证据承担不同风险；摘要不复制来源原句","mentioned_entities":[{"source_label":"称谓甲","proposed_identity":"CHAR-CANDIDATE-A","resolution":"unresolved"}],"adaptation_decision":{"disposition":"preserve | merge | change_carrier | compress | omit | move_earlier | cold_open | add | unresolved","candidate_episode":"EP-CANDIDATE","new_carrier":"可见行动/证据/空间/对白策略或 unresolved","preserved_functions":["关系压力"],"lost_or_changed":[],"causal_compensation":"null；move_earlier / cold_open 时写：依赖的铺垫在哪一集以什么载体先出现，或观众靠什么定位时间，以及原位置怎样处理","addition_rationale":"null；add 时写：为什么原著已有的人和事承担不了这个功能，核对过哪些原著事实、逐条说明不矛盾"},"creator_acceptance":{"status":"pending","decision_ref":null}}

package/lib/drama/skills/short-drama-develop/assets/creative-brief.md

@@ -12,6 +12,8 @@
   - 【事实 → 落在 EPxxx，观众看到的是：〈可见载体〉；或：延后到 EPxxx；没有则写“暂无”】
 - **允许改编/探索的范围**：
   - 【填写】
+- **原著没有、本轮新增的内容**：新增的人物、场景、对手，或提议改变的人物立场与关系，逐条交创作者确认。
+  - 【新增什么 → 承担什么功能；为什么原著已有的人和事承担不了；核对过的原著事实；没有则写“暂无”】
 
 ## 2. 创作者契约
 
@@ -30,6 +32,11 @@
 - **可用角色与场景规模**：【填写】
 - **难以承受的制作元素**：【填写】
 - **必须保留的视觉/声音特征**：【填写】
+- **项目节奏档案（候选）**：【按制作形态从分集设计的默认值起步；改了哪项写一句理由。创作者接受后写入项目配置】
+
+```json
+{"status": "proposed", "form": "ai_live_action", "first_hook_seconds": 5, "beat_interval_seconds_max": 30, "opposed_reversals_per_episode_min": 1, "end_on_peak": true, "reprise_previous_last_beat": true, "vo_share_max": 0.3, "target_avg_shot_seconds": 2.5, "close_shot_share_min": 0.45, "first_major_payoff_by_episode": 1}
+```
 
 ## 4. 戏剧承诺（工作版）
 
@@ -92,6 +99,7 @@
 
 - **故事切入前已经运行的压力**：【填写】
 - **叙事切入窗口**：【从哪个必须行动的时刻开始】
+- **第 1 集入口候选**：【至少三个：时序入口、收益入口、后文高潮提前的冷开；每个写开场第一帧观众看见的那一格画面和它提出的问题，再写整集收益；写选了哪个、为什么】
 - **为什么不更早/更晚开始**：【更早会变成什么准备；更晚会丢掉哪个选择】
 - **开场可见证据**：【让观众从行为、物件、关系或异常结果反推前因】
 - **观众现在必须知道**：【只列当前行动所需】