@oh-story/dsh 0.1.3 → 0.1.5

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

@@ -1,187 +1,76 @@
 ---
 name: short-drama-assets
-description: "从短剧剧本拆解并统筹角色/造型、场景/视图、道具/状态、可选的角色声音方向和跨场连续性。用户说‘拆角色/场景/道具’、‘做资产表/角色表/场景表/道具表’、‘判断复用还是新变体’、‘更新造型/道具状态’、‘给角色定声音/音色/绑定参考音频/做配音选角表’，或拿现成剧本直接做视觉资产准备时使用；本 skill 不写资产图提示词，不生成图片或视频，也不合成音频、不调用任何语音服务。"
+description: 从短剧剧本拆出人物/造型、地点/视图、道具/状态和跨场连续性，写成创作者可读的视觉设定。用户说“拆角色/场景/道具”“做资产设定”“判断复用还是新变体”“更新造型/道具状态”，或拿现成剧本直接做视觉资产准备时使用；不写图片提示词，不生成媒体。
 license: MIT
 ---
 
 # 短剧资产拆解
 
-把剧本文字变成**可追溯、可复用、能接续状态**的生产资产。重点不是数出
-多少人名和名词，而是回答：屏幕上具体需要什么、它与已有资产是不是同一个、
-此刻是哪种造型/视图/状态，以及变化怎样传到下一场和下一集。
-
-## 开始前
-
-本技能可独立安装和执行。先读取用户明确提供的剧本、既有资产与本任务直接输入；若当前目录
-是 `short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少 core
-或任何其他技能都不是资产拆解的阻断条件。[阶段契约](references/stage-contract.md) 给出
-本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
+把剧本文字变成可复用、可持续的视觉事实，统一写入 `剧集/<EP>/视觉设定.md`。不要把每次出场都
+变成新资产，也不要抢写剧本语义、镜头走位或生成提示词。
 
 ## Quick Start
 
-先复制 `examples/minimal/` 的原生 Character/Look JSONL，再修改为当前资产。发布前运行：
-
 ```text
-python3 {技能目录}/scripts/asset_check.py \
-  --characters examples/minimal/characters.jsonl \
-  --looks examples/minimal/looks.jsonl
-python3 {技能目录}/scripts/selftest.py
+用 $short-drama-assets 从 EP001 剧本拆完人物、造型、地点、道具和本集状态
 ```
 
-校验器只检查稳定 ID、引用能否解析到本文件首行 `sources` 声明的快照、创作者接受状态与
-Look → Character 绑定；身份是否可信、差异是否有戏剧依据仍由创作者和 reviewer 判断。
-输入路径不存在于当前目录时，会相对本技能目录解析。
-
-## 边界
-
-- 资产事实只来自已接受剧本、已有 设定集、连续性和创作者补充；不擅改剧情。
-- 项目存在时读取 `short-drama.json#/creator_authority/{visual_direction,production_profile}`
-  中状态为 `accepted` 的视觉方向与制作形态；独立运行时使用创作者直接提供的等价约束，未提供
-  就保持 `unset`。形态决定哪些身份锚点在本项目里根本可被表达——以剪影为
-  识别通道的形态与以面部结构为识别通道的形态需要不同的锚点集合；若状态为 `unset`，就向
-  创作者给出选择，不从对话记忆补造。形态可以改变锚点的表达通道与颗粒度，不得反过来改写
-  已接受的身份、地理、持物归属、可读文字政策或故事状态。
-- 只拥有 Character/Look、Location/View、Prop/State、occurrence reconciliation
-  和资产状态 delta。知识/信念/目标/关系/情绪等 story-state 可以在连续性
-  ledger 中被追踪，但只是带 write/develop source pointer 的投影，不是 assets
-  的第二份真相。剧本语义归 `short-drama-write`，镜头手位/走位归
-  `short-drama-storyboard`，图片提示词归 `short-drama-image-prompts`。
-- 可直接接收现成剧本，不强迫补创意开发、故事引擎或集纲。
-- 只产出文本/JSONL；不调用图片、视频、音频模型或 provider API。
-- 创作者可读的产物在项目内跟随 `short-drama.json#/language`，独立运行时跟随用户使用的
-  语言。本阶段不产生送给生成器的
-  提示词正文，与 `#/format/prompt_language` 无关；角色实际说什么语言来自
-  `voice_direction.language`，与两者都无关。
-
-所有权边界见 [阶段契约](references/stage-contract.md)；只在需要时加载
-下列专项参考，不要一次读完所有文件。
-
-## 入口判断
-
-1. **已有已接受的 `screenplay.md` 与 index**：直接拆解。
-2. **已有资产 设定集，只需补集内出现与状态**：读取旧 ID，先判复用，再提新项。
-3. **只有非 canonical 的中文剧本**：保留原字节到 `输入/`；调用 write owner
-   产生最小规范化预览、语义 diff 和未映射片段。创作者接受前不发布
-   `screenplay.md`，拒绝也不改变原稿。接受后直接回来拆资产，不虚构 development。
-4. **用户只要局部结果**（如“拆本场道具”）：仍执行 occurrence → decision，
-   但只呈现所问范围及它依赖的连续性，不用强迫走完整项目流程。
-
-缺少 index 时，不凭行号冒充稳定来源；先请 write owner 对剧本建立 block ID。
-
-## 每轮的工作单元
-
-一轮处理一个明确的来源场次/块范围。整集请求按来源边界拆成若干轮，每轮：
-
-1. 只读这个范围的直接输入，拆出它的资产事实，跑本地结构检查；
-2. 落盘这个范围，其余范围保持原样；
-3. 报告已覆盖范围、剩余范围、未决 occurrence 和下一个值得做的范围；
-4. 交还控制权，等创作者的下一次请求。
-
-图片提示词、分镜和审查各自是独立的工作单元，由创作者明确请求时开始。
-
-## 工作流
-
-### 1. 先读事实边界
-
-读取本集剧本/index、已有 设定集、上集 outgoing、创作者参考与文本政策，以及已接受的
-视觉方向与制作形态。标记哪个版本已被接受。不要把旧 prompt、旧分镜或文件名当成资产真相。
-
-### 2. 逐块提 occurrence，暂不创建资产
-
-按 source block 收集出镜或生产必需的角色、地点、道具及其显式状态：造型、伤污、
-所有者、持物手、位置、损坏、内容物、开闭、可读文字、时段、天气、光态和剧情作用。
-每条 occurrence 先保持“剧本怎样写”的颗粒度，再与资产表对齐。
-
-- 不猜“她”“那个人”“另一把钥匙”指谁；保留原称谓和证据，状态设为 unresolved。
-- 区分出镜、画外声、屏幕/照片呈现、仅被提及；被提及不等于要做视觉资产。
-- 不把每个名词都建档。只保留影响识别、复用、提示词、镜头或连续性的事实。
-- 未来的 decisions 先用 locator 指位；decision 建立后由它单向引用 occurrence 的
-  exact snapshot。
-
-方法与反例见 `references/occurrence-extraction.md`，记录形状见
-`assets/occurrences.example.jsonl`。
-
-### 3. 再做身份判断
-
-把 occurrence 与已有 设定集 逐项比对，只给四种提案：
-
-- `reuse`：持续身份和本次所需变体均已存在；
-- `new_variant`：同一身份，新增 Look/View/State；
-- `new_asset`：持续身份、空间地理或物体功能/形制确实不同；
-- `unresolved`：证据不足或多个候选都成立，等待创作者选择。
-
-先问“同一个东西什么没变”，再问“这次什么变了、为何变、何时有效”。服装、伤势、
-湿污、灯光、道具开合通常不是新身份；相机角度和瞬时姿势通常连新变体都不是。
-不要为了少建记录而合并真正不同的资产。详见
-`references/identity-vs-variant.md` 与 `assets/decisions.example.jsonl`。
+## 入口与边界
 
-### 4. 写最小可识别 设定集
+现成剧本可以直接拆资产。先区分：
 
-按类别沉淀，身份锚点与临时状态绝不混写：
+- **身份**：换一个就不再是同一个人、地或物；
+- **变体**：身份不变，但服装、伤势、时段、天气、开合或持有状态改变；
+- **镜头瞬态**：姿势、视线、左右手、站位和相机角度，由分镜拥有；
+- **故事语义**：知识、目标、关系和情绪由写作/开发拥有，只引用可见后果。
 
-- Character / Look：`references/character-and-look.md`；例见
-  `assets/character-look.example.jsonl`
-- 声音方向（可选，项目需要跨集保持声音时）：`references/voice-direction.md`；
-  音色载体是参考音频；该文件同时说明 `设定集/voice-casting.md` 怎么渲染。只在处理声音时加载
-- Location / View：`references/location-and-view.md`；例见
-  `assets/location-view.example.jsonl`
-- Prop / State：`references/prop-and-state.md`；例见
-  `assets/prop-state.example.jsonl`
-
-每个新变体记录 base、变化、原因与有效范围。只写能帮助再次认出、复用、提示词
-编写或连续性检查的事实；不堆砌“高级、精致、电影感”等泛化修饰。
-
-### 5. 写变化，不复制整本 设定集
-
-为交接所需的资产状态变化记录 before、after、剧本原因、开始/结束边界和受影响 binding。
-重点检查造型/伤势、持物/所有权、道具状态、地点时段/天气/光态以及跨集 outgoing。
-若为审查需要把知识或关系状态放进 ledger，只保存指向权威字段的引用（`src` 加
-`record_id`、`field`）及必要投影；修订仍路由到 develop/write owner。
-镜头内部姿势、视线、左右手和站位由 storyboard 边界拥有；资产记录只引用，不抢写。
-
-详见 `references/continuity-delta.md` 与 `assets/continuity.example.jsonl`。
-
-### 6. 给创作者看“决定”，而非只给清单
-
-提交接受预览，按以下顺序呈现：
-
-1. 建议复用（为什么是同一个）；
-2. 建议新增变体（没变什么、变了什么、原因与有效期）；
-3. 建议新增身份（区分它的持久证据）；
-4. 未决项（原文证据、候选、每个选择的下游影响）；
-5. 连续性变化与需带入下一集的 outgoing。
-
-创作者可逐项接受、改名、合并、拆分或暂缓。**creator acceptance 是独立事实**：
-抽取完成、结构校验通过、review 通过都不能替代创作者接受。只发布被接受的身份和
-变体；任何 unresolved 都不得编译到图片提示词或分镜 binding。
-若用户要求一次查看全链而中间没有接受回合，可生成待确认的候选预览；不得伪造创作者决定，且不得交付。
-
-### 7. 发布与修订
-
-发布至 `设定集/*.jsonl` 及 `剧集/<EP>/assets/{occurrences,decisions,continuity}.jsonl`。
-项目记录了 `voice_direction` 时，`设定集/voice-casting.md` 由已接受记录重新渲染——
-它是派生文本，手改不会改变任何身份，下一次渲染就会被覆盖。参考音频本身留在 `输入/`。
-每个文件在首行 `sources` 里声明一次它引用到的上游快照，引用本身写 `src` 加稳定 ID/field，
-形状见[阶段契约](references/stage-contract.md#跨产物引用)。资产修改后只列出直接读取该
-ID/variant 的提示词、镜头和 review，由相应 owner 按需刷新；不要重写无关资产或 screenplay。
-
-## 规则分类与阻断
-
-- `structural_invariant`：occurrence 必有已声明的来源快照与 block ID；decision 必属四类；
-  variant 有 base/cause/validity；binding 必须解析到已接受 ID。可机械阻断。
-- `reviewed_invariant`：不可猜含混指代；不可把临时状态混入身份；delta 的剧情原因
-  必须由证据支持。reviewer 引用证据判定，owner 负责修改。
-- `craft_default`：身份不变时优先复用/变体；只跟踪下游有用事实。创作者可说明覆盖。
-- `taste_option`：群演建为个体还是群组、同址空间拆分颗粒度、蒙太奇式跳变方式，
-  由制作策略选择，不单独阻断。
-
-## 完成条件
-
-完成当前有界范围前使用 `references/asset-review-checklist.md`：来源和引用可解析；每个
-occurrence 有明确 decision；未决项保持未决；身份/变体边界可信；连续性能够从
-incoming 走到 outgoing；创作者已经接受本次变更。本 skill 只修订自己拥有的资产事实；
-需要 delivery verdict 时另行请求 `short-drama-review`，不得从这里自动启动。
+## 工作流
 
-创作者要求实际合成声音时，把已接受的声音身份、参考音频和录音表交给
-`$short-drama-produce`。该技能会先展示精确任务预览并等待创作者明确确认；本技能不调用
-语音服务，也不把资产接受状态当作生产授权。
+1. 只读当前范围的剧本和已决定的视觉方向。
+2. 逐场找实体、可见描述、状态变化和含混指代，先不创建资产。
+3. 对每项决定新建、复用、增加变体或标记未决；含混指代不猜。
+4. 写最小可识别设定：统一使用 `识别锚点`、本集状态和变化原因；会持续限制后续动作的身体—物件—空间关系写进有生效范围的状态，不当成一次姿势略过。
+5. 检查造型/伤势、持物/所有权、道具状态、地点时段/天气/光态与跨集 outgoing。
+6. 给跨镜出现且观众看得出不一致的可见事实写一条连续性锁，其余保持识别锚点即可。
+7. 项目提示词语言不是中文时，给每个人物条目写一行 `画面代称：<正文里的拼写>`；正文从不点名它就写 `画面代称：无`。地点和道具按需。
+8. 整集请求自动处理完整集，末端一次回报关键身份决定和未决指代。
+
+## 内容要求
+
+- 每项先写什么不变使它仍是同一资产，再写本集变化。
+- 识别锚点必须可见、可生成、可比较，不用空泛质量词替代事实。
+- 服装、伤势、湿污、道具开合和光态通常是变体，不是新身份。
+- 不复制剧情摘要，只保留下游生成、分镜或连续性真正需要的事实。
+- 文字、标识和敏感信息遵守项目政策，不擅自补造品牌或私密信息。
+- 多集状态写清生效与持续范围；镜头内瞬态留给分镜。
+- 已确认且持续限制动作空间的关系（身体依托、固定、负重、占位或与功能物件的接触）不是普通镜头姿势：可独立识别的物件仍建资产，关系写进状态并交给分镜逐镜投影；只有剧本明确改变时才结束。
+- 连续性锁只锁不随剧情改变的可见事实；锁面用提示词语言写成最小名词短语，会变的部分留给状态。
+- 「画面代称」把提示词正文里的名字对回本条目：分镜的机械核对靠它判断关键帧里点名的人是谁。条目自身的中文名称
+  始终算一个代称，所以中文正文通常不必写这一行；提示词正文语言不是中文时，人物条目必须给出结论——写出正文使用的
+  拼写，或在正文从不点名它时写 `画面代称：无`。同一个名字全集只用一个拼写，大小写也一致（`AST-10` 的同一条要求跨语言同样成立）；
+  多个写法用 `、` 分隔。名字与常用词同形（`道具「手机」` 撞上「手机店」）时也写 `画面代称：无`，让核对不按名字找它。
+
+## 按需知识
+
+默认只读本 SKILL、当前剧本和视觉方向。遇到对应问题时只打开一份：
+
+- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 从剧本找真正的资产出现证据：[出现提取](references/occurrence-extraction.md)
+- 新身份、复用、变体或未决：[身份与变体](references/identity-vs-variant.md)
+- 人物识别与造型层次：[人物与造型](references/character-and-look.md)
+- 地点地理、视图和固定锚点：[地点与视图](references/location-and-view.md)
+- 功能道具、所有权、状态变化，或画面上的可读文字与标识：[道具与状态](references/prop-and-state.md)
+- 声音参考的身份与授权边界：[声音方向](references/voice-direction.md)
+- 跨场、跨镜、跨集状态：[连续性变化](references/continuity-delta.md)
+- 跨镜服装/道具颜色、材质漂移：[跨镜一致性锁](references/continuity-lock.md)
+- 完成前做一次资产漏项检查：[资产审查清单](references/asset-review-checklist.md)
+
+## 完成
+
+所有明确出场都已复用、新建、变体化或标为真实未决；需要保持的视觉事实与状态变化已写入唯一
+视觉设定文档，即完成。图片提示词、分镜、审查和生产不自动开始。
+五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
+
+## 安装维护
+
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

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

@@ -2,34 +2,27 @@
 
 ## Binding gate (`AST-05`)
 
-资产接受前，每个下游 binding 都要解析到已接受的 identity，且 variant
-必须在引用的剧情范围内有效。未解决的 occurrence 继续保持 unresolved；不得
-为了让提示词或分镜继续工作，猜一个看似合理的 ID。
+资产设定完成前，每个下游引用都要解析到明确的身份条目，且变体必须在引用的剧情范围内有效。
+未解决的出现项继续保持未决；不得为了让提示词或分镜继续工作，猜一个看似合理的 ID。
 
 按“机械事实 → 语义判断 → 创作者接受”顺序检查。Owner 可按 finding 修订；修订动作本身
 不等于审查 verdict。需要 verdict 时另起一次审查动作，自检也可以如实记录有证据支持的结论。
 
 ## A. 机械检查（`structural_invariant`）
 
-- [ ] 每个 production-relevant screenplay block 有 occurrence 或明确
-  `no_asset_change` disposition。
-- [ ] 每个文件首行的 `sources` 声明了它用到的全部上游快照，记录里的 `src` 都能解析到
-  其中一条。
-- [ ] occurrence 的 `source_ref` 指向 accepted screenplay/index 快照，并给出 field、
-  block、scene。
-- [ ] source pointer、derived visible facts、asset reconciliation、continuity pointer 的
-  数据角色没有混写。
-- [ ] 每个 occurrence 的 decision 恰为 `reuse` / `new_variant` / `new_asset` /
-  `unresolved`。
-- [ ] `new_variant` 有 base、differences、cause、valid_from、valid_until/open-ended。
+- [ ] 每个制作相关的剧本段都有资产处理结果，或明确说明本段没有资产变化。
+- [ ] 每个结果都指向可见场景 ID，并能从当前 `剧本.md` 找到依据。
+- [ ] 来源位置、剧本明示事实、资产判断与连续性变化没有混写。
+- [ ] 每个出现项恰为复用、新变体、新身份或未决之一。
+- [ ] 新变体写清基底、变化、原因、生效位置与结束位置；没有明确终点时标为持续。
 - [ ] ID 唯一；所有已接受 binding 精确解析到 Character+Look、Location+View 或
   Prop+State。
-- [ ] unresolved 没有伪造 accepted binding，不能流入 prompt/storyboard 编译。
-- [ ] 每条 delta 有 before、after、cause/source、effective range、affected bindings。
+- [ ] 未决项没有伪造成已确认身份，不能流入图片提示词或分镜。
+- [ ] 每条变化有前态、后态、原因/来源、生效范围和受影响的可见 ID。
 - [ ] linked outgoing/incoming 状态一致，或有明确待处理 reconciliation。
 - [ ] 可读文字政策完整；`exact_readable` 不与 `no_readable_text` 冲突。
 
-机械失败指出具体 record/field、owner 和修复方向，不回显整段创作文本。
+机械失败指出具体文件、标题 ID、owner 和修复方向，不回显整段创作文本。
 
 ## B. 语义审查（`reviewed_invariant`）
 
@@ -45,8 +38,8 @@
 - [ ] occurrence 的 production disposition 合理：提及不被误当出镜，关键操作物不被
   降成普通布景。
 
-Reviewer finding 应含被引用记录（`src` 与 `record_id`）、evidence、impact、required fix、
-owner、severity、status；不能只说“资产不够细”或“看起来 AI”。
+Reviewer finding 应含文件与标题 ID、证据、影响、修订结果、owner、严重程度和状态；不能只说
+“资产不够细”或“看起来 AI”。
 
 ## C. Craft 默认（可覆盖，不单独阻断）
 
@@ -68,7 +61,7 @@ Creator 可用制作原因覆盖，例如需要逐件审批背景陈设；记录
 
 不得仅因 reviewer 偏好另一个选项而判失败。
 
-## E. Creator acceptance（独立 checkpoint）
+## E. 创作者确认
 
 给创作者看的摘要必须列出：
 
@@ -77,13 +70,13 @@ Creator 可用制作原因覆盖，例如需要逐件审批背景陈设；记录
 3. 新 asset 及持久区分证据；
 4. unresolved 的原文证据、候选和不同选择的下游影响；
 5. continuity deltas 与跨集 outgoing；
-6. 接受后会 stale 的下游文件。
+6. 确认后需要同步更新的下游文件。
 
-逐项保存 `proposed/accepted/rejected/superseded` 与 creator decision ref。Creator acceptance
-不自动代表结构检查、审查 verdict 或 delivery-ready；只在对应动作真实发生时分别记录。
+把创作者确认的结果直接写进 `视觉设定.md`，未确认选择保留为“未决”并说明影响。创作者确认不等于
+结构检查通过、审查通过或可以投产；这些动作各自独立发生。
 
 ## 当前范围完成判据
 
-本次范围内结构检查通过、每个 occurrence 已决定、无 unresolved binding、continuity 可交接，
-且 creator 接受了新增/复用/变体/delta，即完成当前资产批次。审查与交付是后续独立动作，
+本次范围内结构检查通过、每个出现项已决定、没有未决引用、连续性可交接，且创作者已确认需要选择的
+新增/复用/变体/变化，即完成当前资产批次。审查与交付是后续独立动作，
 不作为图片提示词或 storyboard 这两个并列分支的隐式前置门槛。

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

@@ -74,13 +74,12 @@ Character 拥有，换鞋、加厚外套、盘发都不改写它（那些属于
 音色的载体是参考音频，不是一段文字描述。没有参考时保持 `reference: null` 并标「待选型」，
 不要用形容词冒充音色身份。参考绑定要写清这次借用它的什么、哪些内容不能跟着来
 （那条参考里的情绪、录音空间、背景内容永远不进身份），以及证据到了哪一步——
-详见 [声音方向](voice-direction.md)。它同时给出 `设定集/voice-casting.md` 的渲染规则：
-那份文本是已接受声音方向的派生投影，不是第二份权威。
+详见 [声音方向](voice-direction.md)。声音方向直接写在对应人物的 `视觉设定.md` 条目中，不另建
+配音表或第二份权威。
 
-文本绑定只能保证角色、台词、声音方向与引用关系没有被改写，不能保证任何真实合成结果、
-口型或音色复现。引用通过文件首行的 `sources` 绑定本地产物快照，不把网址、外部任务字段或
-服务参数写进 设定集；
-参考音频本身留在 `输入/`，不进 设定集，也不进交付包。
+文本引用只能保证角色、台词、声音方向与引用关系没有被改写，不能保证任何真实合成结果、
+口型或音色复现。引用使用 `视觉设定.md` 内的可见 ID，不把网址、外部任务字段或服务参数写进设定；
+参考音频本身留在 `输入/`，不复制进 `视觉设定.md`，也不进公开交付。
 
 **资产阶段不生成音频，也不调用任何语音、合成或克隆服务**。 记录先落进文件、由创作者
 确认；实际 TTS 交给 `$short-drama-produce`，并须对它展示的本次任务预览明确确认。
@@ -100,9 +99,8 @@ Character 拥有，换鞋、加厚外套、盘发都不改写它（那些属于
 
 ## 制作形态与身份锚点的可表达性
 
-写最小稳定识别集之前，先读 `short-drama.json#/creator_authority/{visual_direction,production_profile}`
-中状态为 `accepted` 的视觉方向与制作形态；`unset` 时向创作者给出选择，不从对话记忆补造。
-本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
+写最小稳定识别集之前，先读 `视觉设定.md` 的“项目视觉方向”和已明确的制作形态；尚未决定且会
+实质影响识别通道时，向创作者给出选择，不从对话记忆补造。
 
 原因很直接：**形态决定观众靠什么通道认人**，因而决定哪些锚点在这个项目里根本可被表达。
 
@@ -117,7 +115,7 @@ Character 拥有，换鞋、加厚外套、盘发都不改写它（那些属于
 - **`reviewed_invariant`**：形态可以改变锚点的**表达通道与颗粒度**，不得改写身份事实本身。
   不能因为“不好画”把五十岁写成二十五岁、把厚重体格写成修长，也不能为了轮廓好看新增
   疤痕、异色瞳或不存在的配饰。
-- 已接受身份在当前形态下找不到可靠表达通道时，记 `creator_decision_needed`：由创作者决定
+- 已确认身份在当前形态下找不到可靠表达通道时，标为“需创作者决定”：由创作者决定
   换形态还是改身份，资产环节不静默调整。
 - Look 层同理：形态决定服装层次、材质响应能表达到多细，不决定 Look 由哪些单品组成，也不
   决定 cause、valid_from、valid_until。
@@ -126,20 +124,20 @@ Character 拥有，换鞋、加厚外套、盘发都不改写它（那些属于
 
 ### 模板槽位不得覆盖身份锚点
 
-**`reviewed_invariant`**：模板槽位不得覆盖已接受的身份锚点；当模板默认值与已接受身份冲突时，
+**`reviewed_invariant`**：模板槽位不得覆盖已确认的身份锚点；当模板默认值与当前身份冲突时，
 **身份优先，模板让位**。
 
-合成例：角色甲的已接受锚点是五十岁上下、体格厚重、肩背略沉。若角色表模板对每一条记录
+合成例：角色甲的锚点是五十岁上下、体格厚重、肩背略沉。若角色表模板对每一条记录
 机械填入“九头身黄金比例、极度修长的双腿”，角色甲的身份就在没有任何创作者决定的情况下被
 改写；而且因为每个角色都带同一句，下游会把它读成风格统一，不会当成冲突。角色乙即使确实
-修长，也应由自己的接受快照写出，不由模板默认值代写。
+修长，也应由自己的当前视觉设定写出，不由模板默认值代写。
 
 排查方式：把同一批角色记录并排看，找出**逐字重复且与该角色无关**的描述句；不能追溯到某条
-接受快照的，删除或改写成该角色的真实锚点，并在决定预览里说明改动。
+当前视觉设定的，删除或改写成该角色的真实锚点，并在预览里说明改动。
 
 ## 合成例：顾禾
 
-Character `CHAR-GUHE` 的已接受锚点：窄长脸、左眉尾短缺口、自然卷黑发、肩背略前倾。
+Character `CHAR-GUHE` 的当前锚点：窄长脸、左眉尾短缺口、自然卷黑发、肩背略前倾。
 这些锚点不会因本集换装改变。
 
 - `LOOK-GUHE-WORK`：灰绿工作夹克、深色长裤、头发低束；渡站值班期有效。

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

@@ -36,13 +36,11 @@
 分镜技能负责每个镜头的开始和结束边界，包括姿态、位置、目光、双手、持物和可见状态。
 资产可以引用这些边界，但不能另写一套相冲突的手位和走位。
 
-**`structural_invariant` CON-04**： 每条变化记录都要有 `before`、`after`、原因或来源、
-有效范围，以及指向现有使用方的 `affected_binding_refs` 或指向未来使用方的
-`affected_binding_locators`。没有变化时不能只写“更新了”。
+**`structural_invariant` CON-04**： 每条变化都要有前态、后态、原因或来源、有效范围，以及受影响的
+现有 `IMG-...`、`SHOT-...` 或 `MOTION-...`。没有变化时不能只写“更新了”。
 
-**`structural_invariant` CON-06**： `affected_binding_refs` 要覆盖所有已经存在的使用方，
-每条写 `src` 加 `record_id`；尚未建立的使用方在真正发布前写
-`affected_binding_locators`：`owner`、项目相对路径、`selector` 和 `status`。
+**`structural_invariant` CON-06**：受影响列表要覆盖所有已经存在的使用方；尚未建立的工作只说明
+负责 owner 和需要同步的事实，不预建占位记录。
 
 ## 需要追踪的五组状态
 
@@ -60,13 +58,12 @@
 ## 写变化记录的步骤
 
 1. 在资产出现记录中发现明确变化或边界不一致。
-2. 读取上一个状态为 `accepted` 的记录，绝不从下游提示词反推。
+2. 读取 `视觉设定.md` 中上一处明确状态，绝不从下游提示词反推。
 3. 写清单一的 `before` 和 `after`；一个复合事件可以拆成多条同因变化。
-4. 在首行 `sources` 声明导致变化的剧本快照，`cause_ref` 写 `src` 加 `record_id` 与需要的
-   `field`。
+4. 写明导致变化的场景 ID、动作/对白或视觉设定条目，让原因能在当前五文档中直接核对。
 5. 声明从哪个剧本段、场次或集开始生效，到何时结束；没有明确终点时写 `open_ended`。
-6. 已经存在的使用方写入 `affected_binding_refs`；尚未生成的镜头或提示词写
-   `affected_binding_locators`，等它发布后再改成 `src` 引用。
+6. 已经存在的使用方列出受影响的 `IMG-...`、`SHOT-...` 或 `MOTION-...`；未来工作只说明需要
+   同步，不预建占位引用。
 7. 与下一处相连的开始状态比较：一致就通过，不一致就明确提出修订。
 
 ### “未知”不等于“恢复默认”
@@ -106,10 +103,10 @@ SC004 开始：顾禾穿 `LOOK-GUHE-RAIN`；铁皮匣闭合，号牌在里面；
 
 ## 修订影响
 
-- 修改伤势开始的剧本段：列出直接读取该段的造型、提示词、镜头或运动规格；需要刷新时由各 owner 重新发布。
+- 修改伤势开始的剧本段：列出直接读取该段的造型、提示词、镜头或运动提示词；需要刷新时由各 owner 更新。
 - 只修改道具显示名，ID 和事实不变：通常只更新显示文本，不重做无关分镜。
 - 修改镜头构图：不自动修改资产文件。
-- 修改截图说明或提示词文案：不得反向改写已接受状态。
+- 修改截图说明或提示词文案：不得反向改写当前视觉状态。
 
 ## 交接检查
 
@@ -118,6 +115,6 @@ SC004 开始：顾禾穿 `LOOK-GUHE-RAIN`；铁皮匣闭合，号牌在里面；
 - 伤势、造型、天气和光线不会无原因复位。
 - 道具内容状态与人物知情情况分开记录。
 - 变化的有效范围覆盖所有依赖镜头，而且不会提前生效。
-- `affected_binding_refs` 覆盖所有已经存在的提示词、镜头和运动规格使用方；修订时重新
+- 受影响列表覆盖所有已经存在的提示词、镜头和运动提示词使用方；修订时重新
   计算实际使用方，不只沿用旧清单。
 - 结束状态足以让下一集继续，不依赖创作者脑内记忆。

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

@@ -0,0 +1,116 @@
+# 跨镜一致性锁
+
+## 目录
+
+- [为什么识别锚点还不够](#为什么识别锚点还不够)
+- [什么值得上锁](#什么值得上一把锁)
+- [锁面怎么写](#锁面怎么写)
+- [语法](#语法)
+- [谁负责把锁面带走](#谁负责把锁面带走)
+- [反例](#反例)
+- [校验](#校验)
+
+## 为什么识别锚点还不够
+
+识别锚点是写给创作者读的事实；执行端读不到它，只读得到每条提示词自己的正文。同一件毛衣第一镜
+织的是蓝色、第二镜变成红色，通常不是资产写错了，而是**没有任何一条提示词把颜色带进去**：视觉
+设定写了，关键帧写了一半，运动提示词以为参考帧已经交代过就把重复描述删掉了。
+
+参考图也补不上这一层。一张角色板只能约束它自己画到的部分；正在编织、只成形一半的毛衣，被手挡住
+的道具，每镜重新构图的服装细节，都落在身份参考“默认不能控制”的一侧。
+
+一致性锁补的就是这一段：把跨镜不变的那几个字固定下来，并要求它原样出现在每条受影响的提示词里。
+
+## 什么值得上一把锁
+
+三条同时成立才值得上锁：
+
+1. 这个可见事实在本集出现于两个以上镜头，或一个镜头加一张资产板；
+2. 观众能直接看出前后不一致；
+3. 它不随剧情改变——会变的是状态，**状态不上锁**。
+
+典型：服装主色与形制、道具主色与材质、发型长度、伤口位置与形状、招牌或界面的形制配色。
+不典型：情绪、姿势、左右手、镜头角度、时段光线、破损进度、持有人——这些是状态或镜头瞬态，
+分别归 `本集状态` 与分镜。
+
+**`craft_default`**： 一集里的锁通常是个位数。把每条识别锚点都升级成锁，每条提示词都会被同一串
+名词短语撑满，反而挤掉本镜真正要执行的动作。
+
+## 锁面怎么写
+
+`锁面` 是**要被逐字带进提示词正文的那一小段字**，不是描述，也不是给人读的说明：
+
+- 用项目的提示词语言写（`short-drama.json#/format/prompt_language`，没有配置时是 `en`），
+  因为它要落进可复制正文，不是落进创作者说明；
+- 只保留最小可辨识名词短语，通常是「颜色 + 材质/形制 + 物体」，例如
+  `pale blue chunky knit wool sweater`；
+- 不含句号、动作、状态、数量、镜头信息和剧情；
+- 不写会随镜头变化的词（`in her hands`、`half-finished`、`on the sofa`）；
+- 一个实体一把锁；同一实体的两种造型是两把锁，各写各的生效镜头。
+
+比较时忽略大小写，换行按空格处理（可复制正文本来就渲染成一段，硬折行不影响匹配），其余字符
+逐字比较。提示词可以在锁面前后接语法（`she keeps knitting the pale blue chunky knit wool
+sweater`），但不能改写锁面内部——少一个 `stand-collar`、多一个逗号都算漂移。
+
+还有两处刻意不算数，因为它们看起来命中、实际并没有把事实写进画面：
+
+- **粘在词上的匹配不算**。锁面首尾是字母数字时，紧挨着的字母数字或连字符会让它落空：
+  `chipped white enamel mug` 不被 `unchipped white enamel mug` 满足，
+  `pale blue knit` 不被 `pale blue knitwear-print fleece` 满足。锁面要能作为一个完整的词组读出来。
+- **负面提示词里的匹配不算**。写在 `no`/`not`/`without`/`avoid` 或 `不要`/`不能`/`没有`/`避免`
+  之后的锁面说的是「不要出现它」，正好与锁的目的相反；`..., no pale blue chunky knit wool
+  sweater` 不能作为锁面在场的证据。锁面必须出现在描述画面内容的正文里。
+  「粘在词上」只对 ASCII 词生效——中文本来不分词，`织着浅蓝色粗棒针毛线` 正常命中。
+
+## 语法
+
+写在 `视觉设定.md` 对应资产条目下，与识别锚点并列：
+
+```markdown
+## 道具 · 织了一半的毛衣
+
+- 识别锚点：浅蓝色粗棒针手织毛线，竹制棒针两根，衣身只织到胸口。
+- 本集状态：SC002 起衣身加长约一掌；颜色与针法不变。
+- 连续性锁：LOCK-KNIT《织了一半的毛衣》（镜头：全集；图片提示词项：IMG-PROP-KNIT）· 锁面：pale blue chunky knit wool sweater
+```
+
+- 列表记号写 `-`、`*` 还是 `+`，缩进几格，都不影响识别；一条看起来像锁却写不完整的行会被
+  报成语法错误，不会被悄悄跳过——锁不能变成空转；
+- `LOCK-...`：本集唯一稳定 ID，与 `IMG-...`、`REF-...`、`SHOT-...` 互不混用；
+- `《中文名》`：给创作者读的名称，必须含中文；
+- `镜头：`：`全集`，或 `、` 分隔的 `SHOT-...` 列表；两者不能混写；
+- `图片提示词项：`：可选，`、` 分隔的 `IMG-...` 列表，整段省略即表示不约束图片提示词；
+- `锁面：`：被逐字带走的那段字，写在行尾。
+
+## 谁负责把锁面带走
+
+| 文档 | 义务 |
+|---|---|
+| `图片提示词.md` | 被点名的 `IMG-...` 可复制正文含锁面，让参考图本身就是对的 |
+| `分镜.md` | 生效镜头的冻结关键帧提示词含锁面 |
+| `视频提示词.md` | 对应 `MOTION-...` 可复制正文含锁面 |
+
+**`structural_invariant` CON-07**： 锁面在生效范围内不得以“参考帧已经交代过”为由删除。图生视频
+删掉重复的静态描述是常规做法，但锁面是这条常规做法写明的例外——它正是为了挡住跨镜漂移才存在。
+
+状态变化不进锁面：毛衣越织越长写在 `本集状态`，颜色和针法写在锁面。两者同时存在时，提示词自己
+写长度，锁面负责颜色和针法。
+
+## 反例
+
+- `锁面：蓝色毛衣`——提示词正文是英文时永远匹配不上，且“蓝色”分不出浅蓝和藏青；
+- `锁面：a pale blue sweater that she has been knitting since the first scene`——含剧情和时态，
+  下一镜必须改写它，锁当场失效；
+- `锁面：high quality, detailed`——不是可辨识事实，锁住了也证明不了一致；
+- 只把锁的 `镜头` 范围写到「文字已经对的那几镜」——范围要按这个事实**实际出现在哪几镜**来写，
+  按已经写对的地方来写，等于把校验器指向没有风险的位置；
+- 把 `镜头：全集` 用在只出现两镜的道具上——其余镜头会被迫写入与本镜无关的名词。
+
+## 校验
+
+```bash
+python3 <core 技能目录>/scripts/creator_markdown_check.py 剧集/<EP> --project-root .
+```
+
+它只机械核对语法、范围可解析，以及锁面是否真的出现在被点名的正文里。该不该上这把锁、锁面写得
+准不准，仍由创作者和审查判断。

package/lib/drama/skills/short-drama-assets/references/identity-vs-variant.md

@@ -56,9 +56,9 @@
   一条变化记录可能就够了。
 - 它能否只写差异，而不篡改基础身份？新版本只写变化，不重写成另一个身份。
 
-同一 `looks.jsonl` 或 `location-views.jsonl` 内的基础关系，分别写 `base_look_id` 或
-`base_view_id`。只有基础记录在另一个文件时才用 `base_ref`，它的 `src` 指向那个文件在
-`sources` 中的声明。
+在 `视觉设定.md` 中把基础身份与当前变体放在同一项目下。变体只写相对基础身份发生的变化；
+跨文档需要引用视觉事实时直接使用该项目标题；只有引用《图片提示词.md》的可见提示词条目时才使用
+稳定 `IMG-...` ID。`IMG-...` 不表示真实图片，不建立隐藏的来源声明。
 
 ### D. 只有持续身份不同才建新资产
 
@@ -109,20 +109,14 @@
 
 ## 决定记录要说明理由
 
-每条决定至少展示：来源出现记录、候选、选择、稳定证据、差异、原因、有效范围、
-下游影响和创作者接受记录。
+每条决定至少展示：来源场景、选择、稳定证据、差异、原因、有效范围和下游影响。
 
 - `new_asset` 要说明为什么不能复用现有资产。
 - `new_variant` 要说明基础身份中哪些内容不变。
 - `reuse` 要说明现有版本怎样覆盖本次事实。
 
-接受前的字段只能叫 `proposed_binding`。只有 `creator_acceptance.status=accepted`，而且
-对应的设定身份或版本已经发布后，发布事务才能生成 `accepted_binding`。下游只读取
-后者；不能因为一个 ID 看起来正式，就把提案当成已接受记录。
-
-`creator_acceptance.decision_ref` 必须指向一条创作者决策记录，其 `record_id` 以 `CD-`
-开头——检查器据此判定，不合规会直接拦下发布。指向剧本块或资产记录本身的 `decision_ref`
-把「已接受」绑到了一条从未记录过创作者决策的东西上。决策记录本身由创作者决策环节发布在 `创作者决策/` 下，本阶段只引用它。
+能从剧本与既有视觉事实直接判断的内容直接写入 `视觉设定.md`；真正存在多个成立选择时，把它标为
+“未决”并列出会改变的下游影响，等创作者选择后再改正文。不要伪造决定 ID、接受状态或额外决策文件。
 
 **`reviewed_invariant` AST-04**： 审查者检查身份识别点与临时状态是否混写，不以
 “资产越少越好”作为评价标准。