@oh-story/dsh 0.1.10 → 0.1.12

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

@@ -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/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/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-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 集入口候选**：【至少三个：时序入口、收益入口、后文高潮提前的冷开；每个写开场第一帧观众看见的那一格画面和它提出的问题，再写整集收益；写选了哪个、为什么】
 - **为什么不更早/更晚开始**：【更早会变成什么准备；更晚会丢掉哪个选择】
 - **开场可见证据**：【让观众从行为、物件、关系或异常结果反推前因】
 - **观众现在必须知道**：【只列当前行动所需】

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

@@ -5,20 +5,24 @@
 - [改编契约](#1-先建立改编契约)
 - [长材料导入](#长材料导入先建立可追溯语义层)
 - [功能账本](#2-用功能账本压缩)
+- [按爽点压缩](#先按爽点取舍)
 - [信息视觉化](#3-信息视觉化阶梯)
 - [因果桥](#4-保住因果桥)
+- [重排登记](#重排也要登记)
+- [新增登记](#新增也要登记)
 - [单集化](#5-单集化而不肢解)
 - [登记不等于兑现](#5b-登记不等于兑现)
 - [分级审查](#6-规则分级与审查)
 
-改编不是把原文缩短，也不是为短剧补一套流行结构。目标是保留原材料真正承担的戏剧功能，
-再为屏幕、单集边界和制作条件寻找新的载体。
+改编不是把原文按顺序缩短，也不是为短剧补一套原著没有的流行结构。先找出原著里观众为之
+而来的爽点，把它们排到观众最早能拿到的位置；再保住让这些爽点成立的戏剧功能，为屏幕、
+单集边界和制作条件寻找新的载体。
 
 ## 1. 先建立改编契约
 
 | 类别 | 含义 | 处理 |
 |---|---|---|
-| 不可改承诺 | 核心关系、关键选择、结局含义、必要世界规则 | 保持事实与功能 |
+| 不可改承诺 | 核心人物的立场与性情、核心关系、主线、关键选择、结局含义、必要世界规则 | 保持事实与功能 |
 | 可换载体 | 叙述顺序、场景、配角、信息出现方式 | 可压缩/合并，但记录替代关系 |
 | 可删冗余 | 重复说明、只连接路程的段落、无新状态的复述 | 删除并说明没有损失什么 |
 | 未决歧义 | 原材料本身矛盾或授权不清 | 保留问题，不替作者定案 |
@@ -72,18 +76,25 @@ development，避免交付包把输入材料带出边界。
 谁已经与谁结盟、主角手里已经有什么。任何一项超前，这段就只能作为风格或信息参考，
 不能作为当前集的依据。
 
-**召回只补细节，不新增剧情**。 已接受的分集契约决定这一集发生什么；回原文是把已经
-决定的事写具体。原文里另有更好看的段落时，它要走修订已接受契约的路径，由 develop
-owner 改分集地图，而不是在写正文时顺手塞进来。
+**召回补细节；把后文提前是改地图**。 已接受的分集契约决定这一集发生什么；回原文是把
+已经决定的事写具体。原文后段另有该提前的高光时，把它提前是正当的改编，不是虚构——但它
+要作为 `move_earlier` 或 `cold_open` 登记进改编映射、由 develop owner 改分集地图，而不是
+在写正文时顺手塞进来。
 
 **`craft_default · STY-22`**：回原文取细节时，用"人物 + 地点/物件 + 当前动作或冲突"
 的事件锚点检索，回读命中段落而不是凭摘要写，并在使用前把片段的知情状态与当前集进入
-状态对照；超前的片段只作参考。召回用于补足已接受契约的细节，不用于新增剧情。
+状态对照；超前的片段只作参考。召回只补足已接受契约的细节；要提前后文的情节，先改分集地图。
 
 ## 2. 用功能账本压缩
 
-**`STY-07 · reviewed_invariant`**：人物或场景合并必须保留戏剧作用、知情范围、
-关系位置和因果桥；“人更少”不能单独证明合并成功。
+**`STY-07 · reviewed_invariant`**：任何改编处理——合并、换载体、压缩、重排、新增——都保住
+原著核心人物的立场与性情、核心关系和主线，不与原著事实相矛盾，创作者已接受的改动除外；人物或
+场景合并还要保留戏剧作用、知情范围、关系位置和因果桥。“人更少”不能单独证明合并成功。
+
+立场与性情指这个人对主角是帮、是压还是观望，为什么，以及他做事的方式。压力可以放大、外化：
+原著里温和护短、只是不看好主角的上级，可以把怀疑当面说出来，成为第一个被打脸的人；改成冷脸拒绝、
+深夜来关灯的压制者，就换了一个人。改人物立场或关系不是换载体：映射按实际处理登记，在
+`lost_or_changed` 写明改了什么，`creator_acceptance.status` 保持 `pending`，把提议写进简报交创作者决定。
 
 为候选人物、场景和信息记录它承担的功能：
 
@@ -93,6 +104,19 @@ owner 改分集地图，而不是在写正文时顺手塞进来。
 - 哪段建立后续兑现所需的误信/承诺；
 - 哪个空间限制让冲突必须现在发生。
 
+### 先按爽点取舍
+
+压缩分两步：先只留热度最高的情节点——爽点、糖点、虐点，排名来自原著分析的爽点表；
+再删掉不服务这些点的支线，合并功能重复的人物。一个改编实例只保留了原著约六成情节。
+核心人物通常 3–5 人，全剧不超过 20 人，高潮集新增的人物不超过 2 个。
+
+集数与章数的关系由爽点分布决定，不按章 1:1 切：没有爽点的长段并进相邻集或删掉，
+一章里有两个大爽点时可以拆成两集，后文的高光可以提前。按原著顺序一章一集往下切，
+结果通常是拉长而不是压缩，第一个爽点被推到好几集之后。
+
+**`craft_default · STY-28`**：压缩先按爽点表留下热度最高的情节点，再删支线、合并功能重复的
+人物；集数跟着爽点分布走，不按章节 1:1 切分。
+
 ### 先删线，再合并
 
 删掉整条支线和合并人物是两种操作，判据不同，顺序也不能反。**先删线**：合并是把功能
@@ -112,8 +136,9 @@ owner 改分集地图，而不是在写正文时顺手塞进来。
 5. **删掉后会留下多少孤儿铺垫**？前面为它埋的每一处都要跟着删或改指向。孤儿铺垫比
    支线本身更伤：它们看起来像伏笔，观众会一直等。
 
-**最常见的错误删法**：把节奏慢的线删掉、把好看的线留下。慢线经常正是让快线成立的
-条件——铺垫、代价、信息落差都住在慢线里。删掉之后快线还在，但它不再打中人。
+**要防的误删**：慢线里常住着让快线成立的条件——铺垫、代价、信息落差。整条删掉之后
+快线还在，但它不再打中人。先留好看的线本身没有错；把这些条件压缩或换载体转移到保留的线上，
+不必连同慢线整条保留。
 
 删线时把这条线承担的功能逐项列出来（用本节开头的功能账本），标明每一项是**一起删掉**
 还是**转移到哪条保留的线**。转移的每一项都要写清接收方多承担了什么；只写"合并到主线"
@@ -177,13 +202,51 @@ owner 改分集地图，而不是在写正文时顺手塞进来。
 }
 ~~~
 
+### 重排也要登记
+
+改编映射的 `disposition` 取值：`preserve`（保留）、`merge`（合并）、`change_carrier`（换载体）、
+`compress`（压缩）、`omit`（删去）、`move_earlier`（提前到更早的集）、`cold_open`（提前做某集
+开场，再回到原时序）、`add`（新增原著没有的人物、场景或对手，见[新增也要登记](#新增也要登记)）、
+`unresolved`（未决）。
+
+`move_earlier` 和 `cold_open` 带一项因果补偿义务，写进 `causal_compensation`：
+
+- **铺垫要跟着提前**：被提前的一拍依赖哪些事实，每条写清在哪一集、用什么可见载体先埋下；
+  来不及埋的，改由开场后的补充交代承担，并写明补在哪里。
+- **观众要能定位**：冷开之后回到起点时，观众靠什么知道时间回拨了——字幕卡、同一物件或场所
+  的前后对照、一句点明时间的台词；提前到正常时序里的，写清它和前后集的因果怎样接上。
+- **原位置要处理**：原来那一拍所在的集现在少了什么，是删去、改成余波，还是由别的爽点顶上。
+
+**`reviewed_invariant · STY-29`**：登记为 `move_earlier` 或 `cold_open` 的映射写明它依赖的
+铺垫在哪一集、以什么载体先出现，或观众靠什么定位时间，以及原位置怎样处理；审查者按映射
+对照分集记录与剧本，提前的一拍在观众缺少必要事实时出现即为缺陷。
+
+### 新增也要登记
+
+原著没有的东西——一个新人物、一场新编的戏、一个新对手或换掉的对手——单独登记一条 `add`，
+不藏在 `change_carrier` 或 `move_earlier` 的备注里：
+
+- `source_span` 指向它插进去的位置，或它服务的那段原著；
+- `preserved_functions` 写它承担的功能；
+- `addition_rationale` 写两件事：为什么原著已有的人和事承担不了这个功能；核对过哪些原著事实，
+  逐条说明不矛盾；
+- 在简报「原著没有、本轮新增的内容」里列出，交创作者确认。
+
+节奏档案要的有对手反转、题材卡要的当众压迫，先从原著已有的人和他们真做过的事里找：原著里的
+质疑者、起哄的群体、竞争者、规章与期限。某一集原著确实没有对手时，报出档案偏差，或把反转交给
+已有的人；不把支持者改成压迫者，也不为凑数新增对手。
+
+**`craft_default · STY-30`**：原著没有的人物、场景或对手登记为 `add`，写明承担的功能、为什么
+原著已有的人和事承担不了、核对过哪些原著事实，并列进简报交创作者确认；对手先从原著已有的人和
+他们做过的事里找。
+
 ## 5. 单集化而不肢解
 
 短剧单集应完成一个局部状态变化，同时保持长线：
 
 - 当集兑现原材料的一部分吸引力；
 - 结尾压力由本集选择/后果产生；
-- 不靠把一个完整反应切掉来制造“卡点”；
+- 卡点停在下一次揭晓之前，不靠把本集的局部结果切掉来制造；
 - 下一集的进入状态是精确事实，不是“局势更紧张”。
 
 可把一段长叙事拆成多集，但每集都要回答“本集观众具体得到了什么”。
@@ -200,6 +263,9 @@ owner 改分集地图，而不是在写正文时顺手塞进来。
 
 两种都答不出来的，它就不是“不可更改的事实”，是一句备注，按备注处理。
 
+世界设定尤其适合延后。第 1 集只需要观众看懂眼前这场冲突用到的那一条规则，其余设定登记到
+它第一次改变人物选择的那一集。把整套设定塞进首集，只会换来大段说明和旁白。
+
 同一个失败也发生在单集内部：分集记录写了“可见载体”“载体直接支持的判断”，剧本却从没演过
 那个载体。最常见的一种是需要对照才成立的证据——“装置生效前后哼的同一句，音准完全不同”——
 剧本只写了“之后”，“之前”从没上过屏幕，于是这条信息释放在纸面上成立、在画面上不成立。
@@ -212,7 +278,8 @@ owner 改分集地图，而不是在写正文时顺手塞进来。
 ## 6. 规则分级与审查
 
 - `structural_invariant`：来源与功能对应表、授权边界、铺垫、兑现和交接引用都能解析。
-- `reviewed_invariant`：合并没有造成知情穿帮，压缩没有删断因果，新的表现方式保留核心含义。
+- `reviewed_invariant`：合并没有造成知情穿帮，压缩没有删断因果，新的表现方式保留核心含义，
+  人物立场、核心关系和主线没有被改写（STY-07）。
 - `craft_default`：优先用选择、证据和空间后果承载说明；有明确风格理由时可以调整。
 - `taste_option`：保留旁白、倒叙、多声部人物、慢场或开放结尾均是创作者选择。