@oh-story/dsh 0.1.3 → 0.1.5

package/lib/drama/skills/short-drama-image-prompts/references/common-recipe.md

@@ -25,7 +25,7 @@
 
 资产提示词不是剧情镜头，也不是形容词收藏。它要把已接受资产中最值得稳定的事实，变成一张便于识别、比较和后续复用的参考图意图。
 
-开始前取得：准确的资产 ID 和版本 ID、接受快照与字段位置、用途、目标构图、视觉风格、
+开始前取得：`视觉设定.md` 中准确的资产 ID 和当前变体、来源场景、用途、目标构图、视觉风格、
 背景与光线、文字政策、创作者引用 `REF-*`、约束与排除项。身份尚未确定时停在提案，
 不要用提示词文案掩盖缺口。
 
@@ -90,8 +90,8 @@
 - `look_state_variant`：绑定基础来源、可见变化和有效范围；姿势本身不自动成为新版本。
 - `edit_delta`：只保留精确目标、变化、保持项和连续性影响；上游负责的变化先取得其接受。
 
-`reference_bindings` 不是普通参考图清单。每条只声明一个主要用途，分别写清可借用和不可带入的事实；
-没有参考媒体时用空数组，没有观察证据时保持 `unverified` 并列出风险。
+参考说明不是普通图片清单。每张只声明一个主要用途，分别写清可借用和不可带入的事实；没有参考
+媒体就不写参考段，没有观察证据时保持“未验证”并列出风险。
 
 ## 4. 锚点、约束与取舍
 
@@ -126,7 +126,7 @@
 2. **本次提示词的呈现方法（由图片提示词环节管理）**：`readable | symbolic |
    blank | postproduction`，回答这次参考图怎样处理该真相。
 
-规格必须保存来源政策的产物引用（`src` 与 `record_id`）、字段位置、两层选择和对应理由。
+条目必须指向 `视觉设定.md` 的资产 ID 与文字事实，并写清两层选择和对应理由。
 默认映射：
 
 | 资产来源政策 | 允许的呈现方法 | 要求 |
@@ -147,11 +147,11 @@
 明确接受时，不要编造。
 
 “语义上必须出现签名”不等于已经拥有可复制的正式签名字形。只有签名归属或剧情职责、没有
-创作者接受的字形资产时，保留准确来源引用并阻断 `readable`；仅在已接受文字政策允许
+创作者确认的字形资产时，保留准确来源说明并阻断 `readable`；仅在当前文字政策允许
 `postproduction` 时可预留承载区，不得用姓名、伪签名或自行设计的笔画冒充正式字形。
 若人物的接收或反转依赖这项文字，不得一面保留空白承载区、一面让人物认出签名；候选文本
-保留 `<正式签名字形-ref>` 未决引用，并把涉及可读识别的帧/提示词范围标为 `blocked`，直到
-字形或已接受的合成处理真正到位。
+明确写“正式签名字形未提供”，并点名受影响的 `IMG-...` / `SHOT-...`；在字形或已确认的后期处理
+真正到位前，不写可读签名正文。
 
 ### 检查输入参考图（`IMG-08`）
 
@@ -175,18 +175,17 @@
 
 ### 参考图可以决定哪些内容（`IMG-09`）
 
-`reference_bindings` 为每张参考记录稳定 `slot_id`、显式唯一 `order`、准确的 `artifact_ref`
-（文件头 `sources` 中的快照键 `src` 加该参考的 `record_id`）、一个主要 `role`、`may_control`、`must_not_control`、`admission_status`、可选的准确
-`reference_observation_ref` 与 `unresolved_risks`。数组重排或插入新参考不能改变已有槽位语义。
-常见用途包括身份、造型/状态、
-地理、构图、尺度和效果；项目也可以增加更具体的用途。
+每张真实参考图使用稳定 `REF-...` 槽位；槽位在创作文档里逐字写成 `REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途：<用途>；控制：<范围>；不得控制：<范围>）`，并另行说明观察状态与未决风险。
+调整顺序或插入新参考不能改变已有槽位的语义；换图时在同一槽位明确修订 locator，不把旧图的控制边界静默转给新槽位。`IMG-...` 只定位当前《图片提示词.md》的提示词条目。`用途` 是封闭词表，只能取 `身份`、`造型状态`、
+`地理`、`构图`、`尺度`、`效果`、`起始帧`、`结束帧`、`风格` 之一；一张图承担两件事就拆成两个槽位，
+不写「全参考」，也不自造新用途。资产板通常只用到前六个——`起始帧` 和 `结束帧` 属于镜头，不属于资产板。
 
 - 身份参考不自动决定姿势、构图或临时造型；
 - 构图/尺度参考只借用占比、机位所在一侧、留白或相对尺度，不带入图中人物与事件；
 - 效果参考只控制已接受目标的形态/范围，不让非目标对象一起消失、复制或变形；
 - 任一参考都继续服从文字政策与已确认来源，冲突时退回负责方，不用“全参考”。
 
-这项质量要结合当前项目资料判断，不能按参考图数量、`role` 关键词或固定裁切方式机械判定。
+这项质量要结合当前项目资料判断，不能按参考图数量、用途关键词或固定裁切方式机械判定。
 
 ### 负面约束
 

package/lib/drama/skills/short-drama-image-prompts/references/edit-and-revision.md

@@ -2,16 +2,15 @@
 
 ## 有界编辑合同 (`IMG-06`)
 
-每次 edit 都声明精确 target/region、要改什么、必须保留什么、以及预期的
-continuity impact。如果期望变更会改写 identity 或 accepted 上游事实，路由给
-该 owner，不要伪装成局部 prompt revision。
+每次 edit 都声明精确目标/区域、要改什么、必须保留什么，以及预期的连续性影响。如果期望变更会
+改写身份或已确认上游事实，路由给该 owner，不要伪装成局部提示词修订。
 
 ## 目录
 
 1. 两类修改
 2. Edit-delta 配方
-3. 自然语言 spec → diff → accept → rerender
-4. 缓存漂移的 restore/adopt
+3. 自然语言要求 → 差异预览 → 确认 → 重写
+4. 当前文件与旧预览不一致时的处理
 5. 失败与检查
 
 ## 1. 两类修改
@@ -26,15 +25,15 @@ continuity impact。如果期望变更会改写 identity 或 accepted 上游事
 四个问题缺一不可：
 
 ```text
-Target：哪个精确来源快照（`sources` 键）、记录、entity 和 region？
+Target：哪个可见 `IMG-...`、对象和区域？
 Change：哪些有边界、可观察的变化？
 Preserve：身份、构图、光线、空间以及哪些未影响 entity/region 必须不变？
-Continuity impact：预期对应哪个 accepted State/binding，有效到哪里？
+Continuity impact：预期对应哪个已确认状态或引用，有效到哪里？
 ```
 
 ### Target
 
-- 用元信息绑定目标快照；copyable 正文用自然语言明确主体和区域。
+- 用可见 `IMG-...` 和对象名绑定目标；可复制正文用自然语言明确主体和区域。
 - “改背景”“让她更狼狈”过宽；需要具体新 View/区域与可观察变化。
 - 多个不相干 target 默认拆为多个 edit，防止 preserve 集失焦。
 
@@ -50,73 +49,62 @@ Continuity impact：预期对应哪个 accepted State/binding，有效到哪里
 
 引用 道具状态/Look/View 或提出 owner revision；记录受影响的 prompt/shot/keyframe，而非在 edit 中成为新的连续性权威。若没有影响，也明确 `none` 及理由。
 
-- **`structural_invariant`**：`target_ref`、region、changes、preserve 和 impact 必须存在且没有显式冲突。
+- **`structural_invariant`**：目标、区域、变化、保持项和影响必须存在且没有显式冲突。
 - **`reviewed_invariant`**：修改范围是否足够清楚、preserve 是否保护真正身份/地理，需要 reviewer 引用证据判断。
 - **`craft_default`**：一次 edit 聚焦少量相互关联的 delta；复杂重构改用新 variant/plate。
 - **`taste_option`**：变化的视觉强度由创作者决定，只要状态事实未变。
 
-## 3. 自然语言 spec → diff → accept → rerender
+## 3. 自然语言修订
 
-用户不需要知道 JSONL 字段。对“把工作服换成深蓝，但保留脸和袖口油渍”执行：
+用户不需要知道内部字段。对“把工作服换成深蓝，但保留脸和袖口油渍”执行：
 
-1. **读取权威源**：当前 accepted spec、asset refs 与 recipe version。
-2. **解释请求**：区分 prompt-owned 改动、source-owned 事实、含糊项与可能影响。
-3. **生成候选 spec**：不覆盖 accepted spec；不确定值保持 unresolved。
-4. **展示语义 diff**：字段路径、before、after、理由、影响、是否需上游 owner。
-5. **展示新 prompt 预览**：让创作者看实际文案效果，而非只看字段。
-6. **接受/拒绝**：接受才提交；拒绝使原 spec 与 Markdown byte-identical。
-7. **重渲染**：从 accepted spec 与 recipe version 导出 Markdown，更新下游 stale 状态。
+1. 读取当前 `视觉设定.md` 条目和 `图片提示词.md` 的 `IMG-...`；
+2. 区分提示词可改措辞、资产 owner 才能改的事实、含糊项和连续性影响；
+3. 展示简短语义差异：改前、改后、理由、保持项、影响和是否需要上游修改；
+4. 展示新的可复制正文，让创作者看到实际效果；
+5. 确认后直接更新同一个 `IMG-...`；拒绝时当前文件保持不变；
+6. 列出需要同步检查的 `SHOT-...` 或其他 `IMG-...`，不自动改用户未点名的文档。
 
 建议预览：
 
 ```markdown
 ### 提议修改 `IMG-...`
-- `variant_delta.uniform.color`: `灰蓝` → `深蓝`
-- `preserve`: 新增 `右袖口原有油渍的形状与位置`
-- 未改：Character identity、服装剪裁、背景、构图、光向
-- 影响：仅当前 Look prompt；若资产 Look 尚未接受深蓝色，先请求 assets 修改
-- 未映射：无
+- 深灰蓝工作服 → 深蓝工作服
+- 保持：脸、服装剪裁、右袖口旧油渍的形状与位置、背景、构图、光向
+- 影响：仅当前造型提示词；若 `视觉设定.md` 还没有深蓝变体，先交给 assets 修改
 
-**重渲染预览**
+**新正文预览**
 > ...
 ```
 
-对“更有电影感”不能擅自选择一串风格字段。给两三个互斥但可解释的候选（如更明确光比/构图/色彩关系），标为 `taste_option` 让创作者选。
+对“更有电影感”不能擅自堆一串风格词。给两三个互斥且可观察的候选，例如光比、构图或色彩关系，
+作为 `taste_option` 让创作者选择。
 
-## 4. 缓存漂移的 restore/adopt
+## 4. 当前文件冲突
 
-`image-prompts.md` 是缓存视图。发现它与 spec 不一致时暂停覆盖：
+如果另一个编辑或人工修改已经改变当前 `IMG-...`，不要用旧预览覆盖：
 
-### Restore
+- 重新读取当前条目；
+- 展示人工改动与本次修改的语义差异；
+- 能安全合并时生成新的完整预览；
+- 无法无损对应、触及上游事实或存在冲突时保留当前文件，并交给创作者选择。
 
-- 展示当前手改文本与将恢复的 canonical preview；
-- 创作者接受后从 accepted spec 重渲染；
-- 不把手改内容静默写回 spec。
-
-### Adopt
-
-- 将可表示的手改语义解析为候选 spec diff；
-- 逐条列出 `mapped`、`unmapped`、`lossy`；
-- 有 unmapped/lossy 或改动 source-owned 事实时阻断 adopt，保留原文件与冲突副本；
-- 安全且被接受后，先提交 spec，再重渲染成规范 Markdown。最终文本可能排版变化，但语义 diff 必须无损。
-
-选择 `merge` 时也先生成候选 diff；不能以“最后写入者获胜”处理创作权威。
+不得把“最后写入者获胜”当创作规则，也不得为了恢复格式丢掉人工增加的有效语义。
 
 ## 5. 失败与检查
 
 ### 失败征兆
 
-- 直接改 accepted JSONL 或只改 Markdown；
-- diff 只写“优化措辞”，没有字段和语义影响；
-- 把身份、Location 地理、道具状态 在 prompt 层擅自改掉；
-- edit 只有 Change 没有 Preserve；
-- unmapped 手改被自动丢弃；拒绝后文件仍改变。
+- 只改可复制正文，却不核对 `视觉设定.md`；
+- 差异只写“优化措辞”，没有语义影响和保持项；
+- 把身份、地点地理或道具状态在提示词层擅自改掉；
+- edit 只有 Change，没有 Preserve；
+- 发现冲突后自动覆盖人工修改。
 
 ### 完成检查
 
-- source-owned 请求已路由给正确 owner；
-- 候选与 accepted 分离，diff 可读、可拒绝，预览可复制；
-- accept 顺序是 spec commit 后 rerender；reject 不变；
-- restore/adopt 都有预览，无法对应字段的改动保留为冲突；
-- 本提示词修订流程不调用媒体生成或 provider API；实际生产交 `$short-drama-produce`
-  并对精确任务预览单独确认。
+- 上游事实请求已路由给正确 owner；
+- 目标、区域、变化、保持项和连续性影响都清楚；
+- 差异预览可读、可拒绝，新正文可直接复制；
+- 拒绝不改变当前文件，冲突不静默吞掉；
+- 本流程不调用媒体生成或 provider API；实际生产交 `$short-drama-produce`，并对精确任务预览单独确认。

package/lib/drama/skills/short-drama-image-prompts/references/location-plate.md

@@ -117,13 +117,12 @@ Location plate 的价值是让后续镜头共享同一可导航空间。输入
 | 同一 Location 同一 state 各 View 的主光、色温与光比是否对齐 | `reviewed_invariant` | 并排比同组 View，差异需成因与 delta |
 | 镜头审美与构图 | `taste_option` | 保留创作者选择 |
 
-输出一条 location-plate spec 和 copyable prompt；ID 留在元信息，正文用清楚自然语言。不得生成 plate 图片。
+输出一个 `IMG-...` 地点板条目和可复制正文；ID 留在标题，正文用清楚自然语言。不得生成地点板图片。
 
 ## 6. 制作形态投影
 
-已接受的 `short-drama.json#/creator_authority/{visual_direction,production_profile}` 决定这张
-场景板用什么词汇表达空间，不决定空间长什么样。形态词表见
-本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
+`视觉设定.md` 的项目视觉方向与已明确制作形态决定这张场景板用什么词汇表达空间，不决定空间
+长什么样。
 
 ### 从形态取什么
 

package/lib/drama/skills/short-drama-image-prompts/references/look-and-state-variant.md

@@ -12,27 +12,27 @@
 
 变体的目标是在不改变持久身份的前提下，把有因果、可复用、在一定范围内持续的视觉状态明确出来。它不是为了给每个表情、角度或手势建一张新资产图。
 
-先用 assets 的接受决定区分：
+先用 `视觉设定.md` 的当前判断区分：
 
 - **reuse**：身份/地理/功能和需要保持的 state 都没变，直接复用；
 - **variant**：同一身份上出现可逆或时间有界的 Look/View/道具状态差异；
 - **new asset**：持久身份、固定地理或基本功能已改变；
-- **unresolved**：无法确定，停止编译并让创作者选择。
+- **unresolved**：无法确定，停止写提示词并让创作者选择。
 
-图片提示词不能自行做这项身份决定，只把 accepted variant 编译为可见参考。
+图片提示词不能自行做这项身份决定，只把已确认变体写成可见参考。
 
 ## 2. Base—delta—validity
 
-一条变体规格必须能回答：
+一个 `IMG-...` 变体条目必须能回答：
 
-1. **Base**：它从哪个 exact accepted asset/variant 派生？
+1. **Base**：它从哪个准确身份/变体 ID 派生？
 2. **Preserved anchors**：哪些 Character/Location/Prop 身份事实不变？
 3. **Delta**：哪里发生了什么可观察变化，范围和强度如何？
-4. **Cause/source**：变化来自哪个 screenplay/continuity 事实或 creator 决定？
+4. **Cause/source**：变化来自哪个场景、连续性事实或创作者决定？
 5. **Validity**：从哪里开始、持续到哪里、何时恢复/再变化？
-6. **Affected bindings**：哪些 prompts/shots/keyframes 需要此 variant？
+6. **Affected work**：哪些 `IMG-...`、`SHOT-...` 或关键帧需要此变体？
 
-- **`structural_invariant`**：绑定 exact base + variant ID，source refs 与 validity 可解析；不得同时绑定不相容 variants。
+- **`structural_invariant`**：基底、变体 ID、来源与有效范围可解析；不得同时使用不相容变体。
 - **`reviewed_invariant`**：delta 与持久锚点没有混层，也没有超过 source 支持的范围。
 - **`craft_default`**：正文先短述保持的身份，再把注意力放在 delta；不要重写全部 base。
 - **`taste_option`**：单独 variant plate、同版对照或局部细节板由复用目的决定；默认单独 plate 更少歧义。
@@ -61,13 +61,13 @@
 
 ## 4. 变体 plate 与 edit 的区别
 
-- **Variant plate** 描述一个已接受、可被多个镜头复用的完整当前状态；它可以从零编写 generic prompt，不依赖某张待编辑图片。
-- **Edit-delta** 针对 `target_ref` 指名的精确快照、记录与 region，说明 change/preserve/continuity impact；用于“从现有参考改成 accepted variant”的提示词。
+- **Variant plate** 描述一个已确认、可被多个镜头复用的完整当前状态；它可以从零编写提示词，不依赖某张待编辑图片。
+- **Edit-delta** 针对可见 `IMG-...`、对象和区域，说明变化、保持项与连续性影响；用于“从现有参考改成当前变体”的提示词。
 
 若创作者说“把袖子改湿”：
 
-1. 已有 accepted wet Look，且目标是复用状态 → 可以写 variant plate 或 scoped edit；
-2. wet Look 尚未接受 → 先向 assets 提 variant proposal；
+1. 已有明确的湿衣 Look，且目标是复用状态 → 可以写变体板或局部编辑；
+2. 湿衣 Look 尚未确认 → 先向 assets 提变体选择；
 3. 只发生在单镜头动作末端、没有持续复用 → 可能应由 storyboard continuity 拥有，不自动创建资产 prompt。
 
 不要把 before/after 两个互斥人物叠在一张身份板，除非用途明确是比较板，且两个区域/标签不会造成身份融合；这属于可覆盖的 craft choice，不是默认。
@@ -87,10 +87,11 @@
 
 | 检查 | 分类 |
 |---|---|
-| exact base/variant、source、validity 解析 | `structural_invariant` |
+| 准确基底/变体、来源、有效范围解析 | `structural_invariant` |
 | delta 是否保持 identity/geography/function | `reviewed_invariant` |
 | 是否误把瞬时 shot 状态升级为 asset variant | `reviewed_invariant` |
 | delta 是否比 base boilerplate 更醒目 | `craft_default` |
 | 单图或对照板、变化强度与呈现媒介 | `taste_option` |
 
-输出包含 base、delta、preserve、validity 与 affected bindings 的 spec，以及一段聚焦当前状态的 generic prompt。不得生成图片，也不得声称变体画面已经验证成功。
+输出一个写清基底、变化、保持项、有效范围和受影响工作的 `IMG-...` 条目，以及一段聚焦当前状态的
+可复制正文。不得生成图片，也不得声称变体画面已经验证成功。

package/lib/drama/skills/short-drama-image-prompts/references/lookdev-frame.md

@@ -1,7 +1,6 @@
 # Lookdev 风格帧提示词
 
-`lookdev_frame` 使用 [独立结构模板](../assets/lookdev-frame-spec.jsonl.md)，把项目层已经接受的
-视觉方向投影成可比较的通用图片提示词。它不选择画风，
+Lookdev 风格帧把 `视觉设定.md` 中项目级视觉方向投影成可比较的通用图片提示词。它不选择画风，
 不生成图片，也不从一张参考图推断整部作品的规则。
 
 ## 三类测试轴
@@ -10,23 +9,20 @@
 - `core_location`：绑定准确 LOC/VIEW，检查地理、材质、色彩层级与光源逻辑；
 - `high_pressure_scene`：绑定准确场景、人物状态与来源块，检查冲突中的注意中心、遮挡和密度。
 
-不要求三类都固定生成若干张。选择本项目最能暴露方向失效的代表帧，并在规格中写清测试问题。
+不要求三类都固定生成若干张。选择本项目最能暴露方向失效的代表帧，并在条目中写清测试问题。
 
-## 写规格
+## 写条目
 
-`purpose` 写 `lookdev_frame`，`lookdev_axis` 选择本次测试轴，`direction_ref` 用文件头 `sources` 中
-`short-drama.json` 的快照键，`field` 写
-`/creator_authority/visual_direction/choices/look_development`，并用同一个快照键的
-`production_profile_ref` 绑定本项目已接受制作配置。高压力场景还要用 `story_context_refs` 绑定
-真实 screenplay-index `BLK-…` 场次/动作/信息权限记录，不能从提示词发明剧情状态。再写：稳定项、
+在 `图片提示词.md` 使用 `IMG-...` 标题，写明用途为 Lookdev、测试轴和对应的“项目视觉方向”章节。
+高压力场景还要绑定真实场景 ID、动作和信息权限，不能从提示词发明剧情状态。再写：稳定项、
 允许变化项、要保护的身份/地理/剧情事实，以及删除风格标签后真正改变的材质、光、色、边缘、
 景深或空间表达。
 
-风格参考使用 `role: style`：
+风格参考标明用途为“风格”：
 
-- `may_control` 只列色彩层级、材质处理、阴影边缘、景深倾向、画面密度等本次准许内容；
-- `must_not_control` 保护角色身份、固定场景地理、剧情状态、人数、持物与道具文字；
-- 每张参考有稳定 `slot_id` 和显式 `order`，换版或数组重排不改变槽位语义。
+- “允许控制”只列色彩层级、材质处理、阴影边缘、景深倾向、画面密度等本次准许内容；
+- “不得控制”保护角色身份、固定场景地理、剧情状态、人数、持物与道具文字；
+- 每张真实参考图使用稳定 `REF-...` 槽位，绑定可见项目相对路径或其他明确 artifact locator、中文名称、显式顺序和封闭词表里的用途（风格帧通常是 `风格`）；换图时显式修订槽位的 locator，不把旧图的控制语义静默转给新槽位。`IMG-...` 仅用于当前《图片提示词.md》的提示词条目。
 
 角色、地点或压力场景的事实仍来自它们各自 owner。高压力测试帧不得为了“更有冲击力”提前
 泄露身份、发明动作结果或改变文字政策。
@@ -34,5 +30,5 @@
 ## 比较与修订
 
 比较人物、地点和压力场景是否共享可辨认语言，同时记录哪一部分允许逐场变化。没有授权生成结果
-观察时，只能指出文字层风险。若收到绑定准确 prompt/spec/reference/config 的项目观察，局部修订写
-`changes` 与 `preserve`，一次只改诊断所需变量；不把一次结果推广为其他项目或制作配置的规律。
+观察时，只能指出文字层风险。若收到绑定准确提示词、参考、配置和结果的项目观察，局部修订写清
+变化与保持项，一次只改诊断所需变量；不把一次结果推广为其他项目或制作配置的规律。

package/lib/drama/skills/short-drama-image-prompts/references/production-sheet-recipes.md

@@ -139,7 +139,7 @@
 漂移反复发生，针对该风险补局部约束；不把“人物过大/字幕”预设为所有镜头缺陷。
 
 局部修改要同时写清**修改项与保持项**（IMG-06 的实际写法）。可以分句解释复杂区域，
-但每项变化都要能指向精确 `target_ref`，未受影响的事实明确保持：
+但每项变化都要能指向精确 `IMG-...`、对象和区域，未受影响的事实明确保持：
 
 ```text
 画面中右侧的甲去掉，画面中不要出现甲，其他角色站位动作保持不变，其他内容保持不变。

package/lib/drama/skills/short-drama-image-prompts/references/prop-plate.md

@@ -54,7 +54,7 @@
 8. **保持/排除**：防止变形、错材、错状态或多出复制品。
 
 - **`craft_default`**：若尺度容易误判，加入不带身份的参照或给出功能性尺寸关系；不要用剧情角色的手当默认参照。
-- **`craft_default`**：对可动部件，选择一个接受状态；如确需开/关两态，分为两个 道具状态/spec。
+- **`craft_default`**：对可动部件，选择一个明确状态；如确需开/关两态，分为两个道具状态条目。
 - **`taste_option`**：产品式悬浮、台面陈列、正交视图或环境内静物由复用目的决定。
 
 ## 4. 文字政策
@@ -62,8 +62,7 @@
 文字是一项资产状态和制作决策，不是随手加的装饰。
 
 不要改写 assets owner 的 `exact_readable | graphic_only | no_readable_text |
-pending_creator_text`。本 skill 只为当前 plate 选择下列 render treatment，并在
-spec 中保留 source pointer 和映射理由。完整映射表见
+pending_creator_text`。本 skill 只为当前道具板选择下列呈现方式，并在条目中保留资产 ID 与映射理由。完整映射表见
 [common-recipe.md](common-recipe.md)。
 
 ### `readable`
@@ -104,13 +103,11 @@ spec 中保留 source pointer 和映射理由。完整映射表见
 | 中性参照、视图数量、背景方式 | `craft_default` |
 | 产品感、写实度、陈列审美 | `taste_option` |
 
-输出精确绑定的 spec 和 generic prompt；不承诺文字最终生成准确，也不生成任何媒体。
+输出一个精确绑定的 `IMG-...` 道具板条目和可复制正文；不承诺文字最终生成准确，也不生成媒体。
 
 ## 6. 制作形态投影
 
-已接受的 `short-drama.json#/creator_authority/{visual_direction,production_profile}` 决定这件
-道具用什么词汇被画出来，不决定它是什么东西。形态词表见
-本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
+`视觉设定.md` 的项目视觉方向与已明确制作形态决定这件道具用什么词汇被画出来，不决定它是什么。
 
 ### 从形态取什么
 

package/lib/drama/skills/short-drama-image-prompts/references/review-and-fixtures.md

@@ -4,45 +4,45 @@
 
 1. 审查方式
 2. 证据量表
-3. 诊断目录
+3. 完成前结构检查
 4. 合成正例
 5. 合成反例
 
 ## 1. 审查方式
 
-先做可确定检查，再由与作者分离的 reviewer 判断语义和 craft。Reviewer 不改 spec；它写 finding，包含产物与记录 ID、精确证据、影响、所需修复、owner、severity 与状态。不要以固定长度、词数、形容词比例或“像 AI”判质量。
+先做可确定检查，再由与作者分离的 reviewer 判断语义和 craft。Reviewer 不替 owner 修改；finding
+包含文件与 `IMG-...`、精确证据、影响、所需修订、owner、严重程度和状态。不要以固定长度、词数、
+形容词比例或“像 AI”判质量。
 
 ## 2. 证据量表
 
-对每条 prompt，逐项给出 `PASS | REVISE | NOTE` 和引用：
+对每条提示词逐项给出 `PASS | REVISE | NOTE` 和引用：
 
 | 维度 | 要问的问题 | 合格证据 |
 |---|---|---|
-| 绑定 | 是哪个 identity + exact variant？ | spec source ref 与 accepted snapshot |
-| 区分度 | 不看 display name，能否认出/区分？ | prompt 中对应 stable anchors 与 delta |
-| 单一目的 | 是否把多种互斥参考需求混在一起？ | purpose、构图与状态一致 |
-| 空间/尺度 | 关系能否同时成立并复用？ | geography/scale 原字段与 prompt 句子 |
-| 文字 | 政策、内容、承载面、排除是否相容？ | text policy 与 constraints |
+| 绑定 | 是哪个身份与当前变体？ | `视觉设定.md` 的可见 ID 与提示词引用 |
+| 区分度 | 不看显示名，能否认出或区分？ | 稳定锚点与当前变化 |
+| 单一目的 | 是否把互斥参考需求混在一起？ | 用途、构图与状态一致 |
+| 空间/尺度 | 关系能否同时成立并复用？ | 地理/尺度事实与正文句子 |
+| 文字 | 政策、内容、承载面与排除是否相容？ | 文字事实与呈现方法 |
 | 经济性 | 参考已承载的内容是否被无意义重复？ | 可删句与未受影响事实 |
-| 越权 | 是否新造资产、故事或连续性事实？ | source fact 与冲突句 |
-| 可复制 | 去掉内部元数据后正文是否自足？ | generic prompt 本身 |
+| 越权 | 是否新造资产、故事或连续性事实？ | 来源事实与冲突句 |
+| 可复制 | 去掉标题元信息后正文是否自足？ | 可复制正文 |
 
-Finding 的“修复”必须可执行，例如“补回 View 中安全门相对检修台的位置”，不能只写“加强细节”。审美替代方案属于 NOTE，除非违反已接受约束。
+Finding 的修复必须可执行，例如“补回安全门相对检修台的位置”，不能只写“加强细节”。审美替代
+方案属于 NOTE，除非违反已确认约束。
 
-## 3. 诊断目录
+## 3. 完成前结构检查
 
-| code | classification | enforcer | 默认 severity | owner | 含义 |
-|---|---|---|---|---|---|
-| IMG_BINDING_UNRESOLVED | structural_invariant | validator | error | image-prompts | asset/variant 或 source ref 未解析 |
-| IMG_TEXT_POLICY_CONFLICT | structural_invariant | validator | error | image-prompts | readable 与 no-text 等显式冲突 |
-| IMG_EDIT_SCOPE_MISSING | structural_invariant | validator | error | image-prompts | edit 缺 target/change/preserve/impact |
-| IMG_VARIANT_INCOHERENT | reviewed_invariant | reviewer | error | image-prompts | 一个规格混入不相容 Look/State |
-| IMG_GEOGRAPHY_LOSS | reviewed_invariant | reviewer | error | image-prompts | 场景固定地理/方向被丢失或改写 |
-| IMG_PROP_UNRECOGNIZABLE | reviewed_invariant | reviewer | error | image-prompts | 尺度、形制、材料、功能不足以辨认 |
-| IMG_BOILERPLATE_DOMINANT | craft_default | reviewer | warning | image-prompts | 已有锚点但泛化词压过它们 |
-| IMG_STYLE_ALTERNATIVE | taste_option | reviewer | note | image-prompts | 可选审美方案，不单独阻断 |
+- 每个 `IMG-...` 标题唯一，并引用真实视觉设定条目；
+- 人物、地点或道具的当前变体与有效范围没有冲突；
+- 可读文字与全局禁字没有同时出现；
+- 局部编辑包含目标、变化、保持项和连续性影响；
+- 每张真实参考图用独立稳定的 `REF-...` 槽位绑定顺序、项目相对路径/明确 artifact locator 和中文名称，并写明封闭词表里的用途、允许控制、不得控制与未验证风险；
+- 可复制正文不含 ID、文件路径、占位符、流程说明或 QA 结论。
 
-只有 validator 可证明的 `structural_invariant` 直接阻断。语义问题由 reviewer 引用源字段和 prompt 文句后给 `REVISE`；默认与选项可覆盖。
+只有本地可证明的结构冲突直接阻断。语义问题由 reviewer 引用来源与正文后给 `REVISE`；默认做法与
+审美选项可由创作者覆盖。
 
 ## 4. 合成正例
 

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

@@ -1,69 +1,10 @@
 # 图片提示词阶段契约
 
-## 目录
+本阶段只拥有 `剧集/<EP>/图片提示词.md` 中的 `IMG-...` 项：用途、参考边界和可复制正文。它继承
+视觉设定与项目视觉方向，不改写资产身份、地理、剧情状态或镜头边界。
 
-- [独立运行与项目集成](#独立运行与项目集成)
-- [所有权边界](#所有权边界)
-- [制作形态需要什么](#制作形态需要什么)
-- [参考媒体与补拍](#参考媒体与补拍)
-- [本阶段规则](#本阶段规则)
-
-本文件是本技能的自包含契约：预检、所有权、形态输入与规则表都在这里，
-不需要读取其他技能的文件。
-
-## 独立运行与项目集成
-
-本技能可以单独安装并运行；下面几条说明项目工具存在时怎样集成。
-
-1. **读取直接输入**：只读取用户明确提供或当前任务实际需要的文件，不批量加载整个项目。
-2. **可选项目集成**：若存在 `short-drama.json` 且 core 项目工具可用，可以运行
-   `python3 <core>/scripts/project_tool.py status <project>`，使用返回的目录布局和语言设置；
-   core 不可用时，直接基于已提供输入产出本阶段文件。
-3. **可选发布生命周期**：项目工具可用时，用 `publish` 原子发布并用 `--input <path>`
-   声明直接输入；`accept`、`review` 与 `package` 继续承担确认、复核与交付。
-4. **保持职责分离**：创作者确认、内容修订和复核是不同动作；reviewer 提修改要求，负责人改文件。
-
-## 所有权边界
-
-- **本阶段拥有**：项目级 lookdev 风格帧、资产图片的构图与定点修改选择；渲染出的提示词文本是缓存。
-- **本阶段继承**：已接受的视觉方向与制作配置、资产身份与变体、当前用途、文字政策；高压力
-  lookdev frame 还继承准确剧本 block 的场次事实与信息权限。
-- **本阶段不越权**：不承载有先后顺序的剧情动作，不改写资产身份、地理或故事状态，不决定
-  镜头边界。
-
-## 制作形态需要什么
-
-视觉风格不是贴在提示词前面的标签。创作者已接受的视觉方向与制作形态由项目层决定并传入，
-**本技能不加载形态卡，也不自行选择形态**；本节只说明本阶段需要形态回答什么、以及拿到
-答案后投影成哪些字段。
-
-形态决定属于 `craft_default`：创作者说明理由即可覆盖。形态不能创造新的
-`structural_invariant`，也不能改写身份、地理、持物归属与可读文字政策。审查者不得单凭
-形态偏好阻断交付。
-
-不要用“加一句风格前缀”处理形态差异。前缀只改变检索标签；形态改变的是**必须出现和
-可以省略的字段**，只有后者会被执行，也只有后者能被审查。
-
-本阶段要向形态决定问：单帧上**形、材质、层次、光色**各自怎么表达身份与状态。
-
-身份段的载体随形态改变写法：实拍写造型状态而不是长相；二维写剪影与色块；三维写比例与
-姿态边界；水墨写不可散的边缘；Q 版写头身比与放大记号；强精修画风必须**对比着写**同剧
-其他角色的结构差异，否则角色会被拉平。
-
-本阶段新增：单帧可见的形/材质/层次/光色投影。
-
-## 参考媒体与补拍
-
-- **参考图能决定什么要逐张写明**：每张参考的用途、可以照搬什么、不可以照搬什么。身份参考
-  不自动决定构图；构图、尺度或效果参考不自动带入图中人物、服装、文字、道具与故事状态。
-- **像素主张需要证据**：关于参考图上可见内容（尤其文字、水印、标牌、界面）的断言，必须
-  来自创作者/参考图权利人的可核对说明，或运行环境获授权后形成的输入参考观察记录，并绑定
-  被检查的字节。两者都没有时保持 `unverified`，负面提示词不能代替证据。
-- **观众揭示时机**：某一事实何时可被观众看到，由已接受的可见性决定绑定其来源、载体、
-  权限、触发与保护方式。构图既不能提前泄露该事实，也不能遮掉本环节必须传达的载体。
-- **母版、补拍与替代**：补拍默认只补充、不替代母版。普通母版不增加版本范围字段；只有
-  补拍/替代版才声明 `pickup | alternate`，用同一文件内稳定的记录 ID 说明母版与补充关系，并把每项原文要求对应到当前字段或说明
-  去向。只有下游审查结论才能批准替代，不得回写形成循环引用。
+每项参考都写清可以控制什么、不能控制什么；没有获授权的像素观察时保持未知。局部修改直接写目标、
+变化、保持项和连续性影响，不建立 prompt spec、QA 或接受记录。
 
 ## 本阶段规则
 
@@ -71,7 +12,7 @@
 
 | ID | Class | Knowledge |
 |---|---|---|
-| IMG-01 | structural_invariant | Prompt specs bind exact accepted asset and variant IDs. |
+| IMG-01 | structural_invariant | Each `IMG-...` item names the exact visual-setting item and current variant it depicts. |
 | IMG-02 | craft_default | Put distinguishing identity, geometry, scale, or state before generic quality language. |
 | IMG-03 | reviewed_invariant | Character sheets preserve identity while depicting one coherent Look. |
 | IMG-04 | reviewed_invariant | Location plates preserve geography, orientation, anchors, material, and light, normally without cast. |
@@ -82,7 +23,9 @@
 | IMG-09 | reviewed_invariant | Each reference states its purpose, what may be copied, and what must not be copied; a composition-, scale-, or effect-only reference cannot redefine identity, content, text, or story state. |
 | IMG-10 | reviewed_invariant | Views of one Location in the same time/weather state share key-light source, colour-temperature relation, and contrast direction; any difference cites a recorded cause and its delta. |
 | IMG-11 | reviewed_invariant | A lookdev frame binds accepted visual direction and production profile across a declared character-expression, core-location, or high-pressure test axis; a high-pressure frame also binds exact screenplay blocks for story state and information permission, while style references may control only declared surface treatment and never identity, fixed geography, story state, cast count, or prop text. |
-| IMG-12 | reviewed_invariant | Every multi-reference binding carries a stable `slot_id` and explicit unique `order`, so array reordering or insertion cannot silently change a reference's role; until a project validator owns this check, the reviewer cites conflicting slots/orders rather than claiming mechanical enforcement. |
+| IMG-12 | reviewed_invariant | Each real input reference has a stable `REF-...` slot binding explicit order, a visible project-relative path or other unambiguous artifact locator, a Chinese label, and may-control/must-not-control scope. Reordering preserves slot identity; replacing media explicitly revises that slot's locator. `IMG-...` remains reserved for image-prompt headings. |
+| IMG-13 | structural_invariant | An `IMG-...` item named by a continuity lock in `视觉设定.md` carries that lock's surface verbatim in its copyable prompt. |
+| IMG-14 | structural_invariant | Every `REF-...` slot an image-prompt item declares carries one 用途 from the closed set 身份/造型状态/地理/构图/尺度/效果/起始帧/结束帧/风格, the same vocabulary the storyboard uses, so one picture answers one question. An asset board normally uses the first six; 起始帧 and 结束帧 belong to a shot. |
 
 规则分级由高到低：`structural_invariant`（结构缺陷，阻断）、
 `reviewed_invariant`（需证据判断）、`craft_default`（常用做法，可覆盖）、

package/lib/drama/skills/short-drama-image-prompts/scripts/image_prompt_check.py

@@ -106,17 +106,17 @@ def resolve_ref(
 
 SKILL_ROOT = Path(__file__).resolve().parents[1]
 HASH_RE = re.compile(r"[0-9a-f]{64}")
-# `common-recipe.md` forbids weight syntax and any one engine's control words, and
-# `keyframe-craft.md` rejects "cinematic, 8K, masterpiece" as a substitute for
-# subject identity. A generic prompt that carries them has stopped being generic.
+# `common-recipe.md` forbids weight syntax and any one engine's control words: a
+# generic prompt that carries provider control syntax has stopped being generic.
+# This checks syntax only. Whether the prose leans on generic quality language is
+# `IMG-02`, a `craft_default` a creator may override with a reason, so it is a
+# reviewer's call citing what the description actually lacks — see
+# `common-recipe.md`, which forbids blocking delivery on a fixed word list.
 ENGINE_SYNTAX_RE = re.compile(
     r"(?:^|[\s,，(（])--(?:ar|v|q|niji|style|no|seed|cref|sref)\b"
     r"|::-?\d"
     # Weight syntax is written (x:1.2); prose writes "(aperture: 1.8)" with a space.
-    r"|:[01]\.\d\s*[)）]"
-    # Quality words only count in a tag slot. A 4K monitor in shot is content.
-    r"|(?:^|,\s*)(?:8k|4k|uhd)\s*(?=,|$)"
-    r"|(?:^|,\s*)(?:masterpiece|best quality|ultra[- ]detailed|trending on artstation)\s*(?=,|$)",
+    r"|:[01]\.\d\s*[)）]",
     re.IGNORECASE,
 )
 PURPOSES = {
@@ -435,7 +435,7 @@ def main() -> int:
     except (OSError, ValidationError) as exc:
         print(f"image prompt check failed: {exc}", file=sys.stderr)
         return 2
-    print(json.dumps(result, ensure_ascii=False, indent=2))
+    print(json.dumps(result, ensure_ascii=True, indent=2))
     return 0
 
 

package/lib/drama/skills/short-drama-image-prompts/scripts/selftest.py

@@ -51,9 +51,11 @@ def main() -> int:
     leaked[0]["provider"] = "example"
     fail(leaked, sources, "provider execution fields")
 
-    # A/B Round 2: the suite forbids weight syntax and one engine's quality words,
+    # A/B Round 2: the suite forbids provider control syntax in a generic prompt,
     # but nothing enforced it — the only prompt check was for leaked hashes.
-    for syntax in ("--ar 9:16", "masterpiece, 8k", "(red coat:1.2)", "cat::2"):
+    # Generic quality language is `IMG-02`, a `craft_default`; it is not checked
+    # here, because a validator cannot block delivery on a fixed word list.
+    for syntax in ("--ar 9:16", "(red coat:1.2)", "cat::2"):
         engine_syntax = copy.deepcopy(records)
         engine_syntax[0]["generic_prompt"] += f" {syntax}"
         fail(engine_syntax, sources, "engine-specific syntax")