@oh-story/dsh 0.1.0

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

@@ -0,0 +1,96 @@
+# Look、View 与道具状态变体提示词
+
+## 目录
+
+1. 什么时候需要变体
+2. Base—delta—validity
+3. 三类变体的写法
+4. 变体 plate 与 edit 的区别
+5. 输出、失败与审查
+
+## 1. 什么时候需要变体
+
+变体的目标是在不改变持久身份的前提下，把有因果、可复用、在一定范围内持续的视觉状态明确出来。它不是为了给每个表情、角度或手势建一张新资产图。
+
+先用 assets 的接受决定区分：
+
+- **reuse**：身份/地理/功能和需要保持的 state 都没变，直接复用；
+- **variant**：同一身份上出现可逆或时间有界的 Look/View/道具状态差异；
+- **new asset**：持久身份、固定地理或基本功能已改变；
+- **unresolved**：无法确定，停止编译并让创作者选择。
+
+图片提示词不能自行做这项身份决定，只把 accepted variant 编译为可见参考。
+
+## 2. Base—delta—validity
+
+一条变体规格必须能回答：
+
+1. **Base**：它从哪个 exact accepted asset/variant 派生？
+2. **Preserved anchors**：哪些 Character/Location/Prop 身份事实不变？
+3. **Delta**：哪里发生了什么可观察变化，范围和强度如何？
+4. **Cause/source**：变化来自哪个 screenplay/continuity 事实或 creator 决定？
+5. **Validity**：从哪里开始、持续到哪里、何时恢复/再变化？
+6. **Affected bindings**：哪些 prompts/shots/keyframes 需要此 variant？
+
+- **`structural_invariant`**：绑定 exact base + variant ID，source refs 与 validity 可解析；不得同时绑定不相容 variants。
+- **`reviewed_invariant`**：delta 与持久锚点没有混层，也没有超过 source 支持的范围。
+- **`craft_default`**：正文先短述保持的身份，再把注意力放在 delta；不要重写全部 base。
+- **`taste_option`**：单独 variant plate、同版对照或局部细节板由复用目的决定；默认单独 plate 更少歧义。
+
+## 3. 三类变体的写法
+
+### Character / Look
+
+常见 delta：衣服/穿法、发型整理、妆面、临时配饰、污湿、血迹、新伤、包扎、年龄化阶段。写清身体/衣物位置、覆盖范围、材料反应和未变区域。
+
+示例机制（合成）：同一维修员夜班 Look 经雨后，只有外套右肩至肘部明显湿深，头发末端微湿；脸型、断眉、服装剪裁、左胸布贴和右袖旧焊痕保持。不要把“雨后”扩成新伤、换装或全身滴水。
+
+瞬时目光、一次抬手、单镜头表情通常属于 shot/keyframe，不建 Look。
+
+### Location / View-state
+
+常见 delta：特定观察方向、临时 dressing、营业/停业状态、时间、天气和光线。固定入口、主要分区、建筑结构及关键锚点保持；写清从 base View 哪些可见条件改变。
+
+夜景不是把门窗重新布局。临时堆放物不要升级为固定地理。若洪水、坍塌等永久改变动线，应由 assets 判断是否仍是 variant。
+
+### 道具状态（Prop/State）
+
+常见 delta：开/关、内容物、损坏、污渍、文字、持有者与功能状态。写清铰链/缺口/裂纹位置、内容可见程度、承载面文字政策和未变轮廓材料。
+
+换手不一定需要新的 plate；只有下游识别/连续性确需一个持续状态时才做。道具完全断成两件且功能改变，可能需要 owner 决定新 State 或新 asset，prompt 不代判。
+
+## 4. 变体 plate 与 edit 的区别
+
+- **Variant plate** 描述一个已接受、可被多个镜头复用的完整当前状态；它可以从零编写 generic prompt，不依赖某张待编辑图片。
+- **Edit-delta** 针对 `target_ref` 指名的精确快照、记录与 region，说明 change/preserve/continuity impact；用于“从现有参考改成 accepted variant”的提示词。
+
+若创作者说“把袖子改湿”：
+
+1. 已有 accepted wet Look，且目标是复用状态 → 可以写 variant plate 或 scoped edit；
+2. wet Look 尚未接受 → 先向 assets 提 variant proposal；
+3. 只发生在单镜头动作末端、没有持续复用 → 可能应由 storyboard continuity 拥有，不自动创建资产 prompt。
+
+不要把 before/after 两个互斥人物叠在一张身份板，除非用途明确是比较板，且两个区域/标签不会造成身份融合；这属于可覆盖的 craft choice，不是默认。
+
+## 5. 输出、失败与审查
+
+### 失败征兆
+
+- 只有“更脏、更老、更阴森”，没有位置、范围和可观察 delta；
+- delta 覆盖整个人/地点/物件，实际已改变持久身份却仍叫 variant；
+- prompt 复制 base 全文后，把真正变化藏在末尾；
+- 有状态但无 cause/validity，导致后续镜头不知道何时复用；
+- 把 pose、机位或一次 reaction 当成资产变体；
+- 同一 plate 同时画完好/损坏、白天/夜晚或两套 Look，未声明比较用途。
+
+### 检查
+
+| 检查 | 分类 |
+|---|---|
+| exact base/variant、source、validity 解析 | `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。不得生成图片，也不得声称变体画面已经验证成功。

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

@@ -0,0 +1,38 @@
+# Lookdev 风格帧提示词
+
+`lookdev_frame` 使用 [独立结构模板](../assets/lookdev-frame-spec.jsonl.md)，把项目层已经接受的
+视觉方向投影成可比较的通用图片提示词。它不选择画风，
+不生成图片，也不从一张参考图推断整部作品的规则。
+
+## 三类测试轴
+
+- `character_expression`：绑定准确 CHAR/LOOK，检查身份锚点、材质/线条和表演可读性；
+- `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-…` 场次/动作/信息权限记录，不能从提示词发明剧情状态。再写：稳定项、
+允许变化项、要保护的身份/地理/剧情事实，以及删除风格标签后真正改变的材质、光、色、边缘、
+景深或空间表达。
+
+风格参考使用 `role: style`：
+
+- `may_control` 只列色彩层级、材质处理、阴影边缘、景深倾向、画面密度等本次准许内容；
+- `must_not_control` 保护角色身份、固定场景地理、剧情状态、人数、持物与道具文字；
+- 每张参考有稳定 `slot_id` 和显式 `order`，换版或数组重排不改变槽位语义。
+
+角色、地点或压力场景的事实仍来自它们各自 owner。高压力测试帧不得为了“更有冲击力”提前
+泄露身份、发明动作结果或改变文字政策。
+
+## 比较与修订
+
+比较人物、地点和压力场景是否共享可辨认语言，同时记录哪一部分允许逐场变化。没有授权生成结果
+观察时，只能指出文字层风险。若收到绑定准确 prompt/spec/reference/config 的项目观察，局部修订写
+`changes` 与 `preserve`，一次只改诊断所需变量；不把一次结果推广为其他项目或制作配置的规律。

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

@@ -0,0 +1,177 @@
+# 生产参考板决策：角色、场景与道具
+
+## 目录
+
+- [角色参考板](#一角色参考板)
+- [场景方位板](#二场景方位板)
+- [道具参考板](#三道具参考板)
+- [合成与修改](#四首帧合成与定点修改指令)
+- [资产范围](#五资产范围决策craft_default)
+- [质量判据](#六质量判据与反模式)
+
+来自对角色、场景、物品资产如何进入后续镜头的定性案例阅读，示例均为合成改写。
+通用方法见 [common-recipe.md](common-recipe.md)；本文档提供可按项目调整的生产版式。
+核心原则：**先明确资产负责的稳定身份与当前版本，再让分镜负责本镜呈现**。纯白底、
+无情绪、三视图只是便于识别的一种项目选择；带环境的背景、单视图或带状态的参考板
+只要更符合复用目的且不混淆身份与临时状态，也可以由创作者选择（IMG-03/IMG-04）。
+
+## 一、角色参考板
+
+先写 `reuse_job`：下游需要保持身份识别、当前造型、某种状态，还是某个可操作部位？然后
+选择最少但足够比较的视图、背景和光线。头肩、全身、侧背、单视图、上下文参考或中性
+板式都可以；背景和视图数量不是角色身份的一部分。
+
+以下是可选记录方式；与 `reuse_job` 无关的行可以省略：
+
+```text
+用途：<这张板要让下游保持什么>。
+身份识别特征：<少量稳定、可见、彼此不重复的脸型/发型/体态/识别标记>。
+当前造型或状态：<只写已接受版本的可见变化和有效范围>。
+版式：<为复用职责选择的视图、占画关系、背景与比较方式；多视图并排时写明画面内不出现视图标签、引线箭头、尺寸标注与图注>。
+光线与文字：<帮助识别材质/结构的光线；已接受的文字方案与显示位置>。
+排除：<当前最可能越权导入或漂移的事实>。
+```
+
+若项目已验证特殊分隔、权重或引子，可在最后交付时采用；通用资产说明不保存这些
+供应商写法，也不把分辨率、质量词或固定收尾当成资产质量。
+
+### 决策规则
+
+- **布光服务识别职责**：先问哪些脸部结构、材质、轮廓或状态必须可比较，再选择光源
+  方向、面积和反差。光型不自动编码性别、阶级、善恶或权力；同一造型的识别锚点与
+  参考图用途必须保持稳定。
+- **社会处境要有已接受依据**：磨损、整洁、改制、借用、制服纪律或刻意伪装都可能
+  承载人物处境，但不能从贫富、性别、年龄或题材标签自动推出服装和布光。先引用角色
+  行动、职业条件、当前选择或已接受设定，再决定哪些可见细节值得复用。
+- **视觉细节要有职责**（IMG-02 的强化）：它应服务身份识别、当前状态、结构功能或
+  下游复用。写不出职责或与其他锚点竞争的装饰优先删除。
+- **状态何时建立新版本由复用决定**：被俘或重伤等状态若跨镜复用、影响识别或连续性，
+  固化为新的造型或状态版本；只在一镜发生且已完整写入镜头边界时不必扩张资产表。
+- **风格标签按项目添加**：按项目风格前置 `【真人风格，写实风格】` /
+  `【国漫风，二次元画风】` 等，设计稿本体不带标签。
+
+### 布光词汇：按“要比较什么”选，不按身份标签映射
+
+先确定这张板必须让下游比较什么——骨骼体积、表面材质、外轮廓与体量、服装层次，还是状态
+痕迹——再从下列词汇里选。每种光型的条目只说明它让什么结构变得可比较、又压掉什么。
+
+| 光型 | 让什么可比较 | 压掉什么 |
+|---|---|---|
+| 均匀正面光（平光） | 五官相对位置、妆面、服色与图案 | 颧骨、鼻梁、下颌等体积起伏 |
+| 侧光 / 高位斜侧光 | 明暗交界线两侧的骨骼体积与轮廓起伏 | 暗侧细节；同时放大不对称 |
+| 顶光 | 眼窝、鼻下、颌下的纵向结构关系 | 暗区中的识别细节与服装层次 |
+| 底光 | （反转日常明暗方向）非常规体积读法 | 常规结构读法，做识别板时不可用 |
+| 大面积柔光 | 材质纹理、肤质、布料表面状态 | 形状边界与轮廓锐度 |
+| 小面积硬光 | 反射差异、磨损、镜面高光与工艺痕迹 | 过渡信息；放大瑕疵与形变 |
+| 轮廓光 / 逆光边缘光 | 外轮廓、发型剪影、服装廓形与前后分离 | 面部识别信息，不单独承担身份板 |
+| 场景内实际光源 | 状态板与环境内参考板的光向可核对性 | 中性比较条件，需与场景已接受光向一致 |
+
+**解耦声明**：以上词汇只按“本板必须让人比较什么”选择，**不按性别、年龄、贫富或题材标签
+映射**。同一光型可用于任何角色；项目里若出现“女性一律柔光、男性一律侧光”这类默认，那是
+未经证据的模板化，先删除再按 `reuse_job` 重选。社会处境仍按上一条规则从已接受依据取证。
+
+绘制形态里“光”由上色关系与阴影形状承担，这张表的选择依据不变——变的只是它落到哪一层的
+阴影形状与边缘处理，由已接受的制作形态决定。
+
+### 合成判断例：同一角色的伪装期
+
+- `identity`：窄长脸、左眉旧缺口、略前倾但稳定的走路重心；这些跨造型保持。
+- `look_state`：本段穿借来的制服，袖长不合身，胸牌按上游要求设为 `graphic-only`；
+  这些只在伪装有效范围内保持。
+- `reuse_job`：近景靠眉缺口识别，全身调度靠重心和制服轮廓识别。
+- `layout`：选择一个能看清面部锚点的视图和一个能比较制服轮廓的视图；背景只需不
+  干扰识别，不要求白底或固定占比。两视图并排等高，写「画面内无视图标签、无引线箭头、
+  无尺寸标注、无图注」。
+- `exclusion`：不从“伪装者”标签追加阴影脸、可疑眼神或无来源武器。
+
+## 二、场景方位板
+
+只有摄影方向会改变入口、可见地理、光源、遮挡或叙事功能时才建立观察视角。方向可以用
+罗盘、门内/外、主桌侧/证人侧等项目语汇；不为“完整”做齐所有方向。
+
+以下是可选记录方式；只写当前观察面需要核对的内容：
+
+```text
+观察视角：<摄影机在哪一侧、朝向哪里、为何需要这个观察面>。
+固定地理：<入口、路径、区域、遮挡、可操作部位及其相对关系>。
+本版本：<有依据的时间、光线、损坏、占用或天气状态>。
+可见边界：<此观察视角能看到和看不到什么；哪些事实暂缓揭示>。
+文字/人物政策：<空场、允许的人物类别、标牌与已接受的文字方案>。
+```
+
+- 清点顺序以当前空间最容易混淆的关系为起点，不要求中心、地面、四向和头顶全部出现。
+- 光源只写其固定来源和当前版本；反打能否咬合靠相同地理与光向核对，不靠“背后
+  来光”公式。
+- 观察视角不自动携带情绪。时间、光线和戏剧状态若变化，明确它属于场景的固定事实、
+  观察面的可见差异还是本场版本，避免为每个方向发明一套气氛真相。
+
+## 三、道具参考板
+
+道具板优先让轮廓、可操作部位、尺度关系、当前状态和文字政策可比较。白底产品照只是一种
+适合孤立结构的版式；道具依赖佩戴、安装或环境尺度时，可选择有控制的上下文背景。
+
+以下是可选记录方式；字段由道具功能和复用风险决定：
+
+```text
+用途与归属：<谁如何识别、握持、佩戴、安装、转交或损坏它>。
+稳定形制：<轮廓、材质、结构、可操作部位及可比较尺度>。
+当前状态：<有依据的磨损、开启、缺失、污染或修复>。
+版式与光线：<让上述职责可读的视图、背景和材质照明>。
+文字：<`exact-readable` / `graphic-only` / `no-readable-text` 及受控显示位置>。
+```
+
+颜色、材质和工艺只是常见识别重点；对钥匙可能是齿形，对药瓶可能是封口与文字政策，
+对可穿戴物则可能是佩戴关系。字段由功能和复用风险决定（IMG-05）。
+
+## 四、首帧合成与定点修改指令
+
+资产参考进入关键帧提示词时，先声明每张参考的用途 `role` 和可以参考的内容，不能让整张图
+同时决定身份、构图、状态和文字（仍只产出提示词文本，不涉及调用）：
+
+```text
+参考 A：`role=identity`；`may_control=<脸型/识别标记>`；`must_not_control=<姿势/背景/文字>`。
+参考 B：`role=geography`；`may_control=<入口/路径/固定锚点>`；`must_not_control=<临时人物/故事状态>`。
+本镜：从已接受起点写出人物相对站位、朝向、遮挡与可见状态；构图和景别服从本镜目的
+与观众应看到的信息；文字服从上游的逐字保留要求。
+```
+
+只写当前执行需要的站位、朝向、尺度和文字风险。若创作者提供的项目观察证明某类
+漂移反复发生，针对该风险补局部约束；不把“人物过大/字幕”预设为所有镜头缺陷。
+
+局部修改要同时写清**修改项与保持项**（IMG-06 的实际写法）。可以分句解释复杂区域，
+但每项变化都要能指向精确 `target_ref`，未受影响的事实明确保持：
+
+```text
+画面中右侧的甲去掉，画面中不要出现甲，其他角色站位动作保持不变，其他内容保持不变。
+```
+
+多张参考图即使使用位置编号，也要逐条写清用途 `role`、`may_control`、`must_not_control` 与检查
+结论；“五官参考若干图、其他全照图一”这类让整图顺带决定多类内容的指令，应先拆成
+可审查的参考绑定。
+
+## 五、资产范围决策（`craft_default`）
+
+| 决策 | 判断方式 |
+|---|---|
+| 是否建角色资产 | 后续需要重复识别、绑定造型、配音或保持连续时才建立。 |
+| 是否拆地点与观察视角 | 摄影方向会改变可见地理、入口、光源或叙事功能时拆分。 |
+| 是否建物品资产 | 物品会被识别、持有、转手、损坏、读字或承担回扣时建立。 |
+| 描述写多长 | 写到能稳定识别与执行即可；删除不能归因身份、结构、状态或用途的装饰。 |
+| 一次覆盖多少集 | 先抽取完整已接受范围，再按创作者停靠点接受；不从固定资产数量倒推剧情。 |
+
+## 六、质量判据与反模式
+
+判据：每个细节是否服务身份、当前版本、功能、地理或下游复用；背景、光线和视图是否
+适合 `reuse_job`；角色、道具和场景的参考权限有没有互相越界；场景 `View` 是否能核对
+入口、路径与光向；文字政策、角色名和资产绑定是否一致。带环境的背景或状态光线不是
+天然失败，但必须明确属于哪一层，并避免污染稳定身份。
+
+反模式（定性案例中的返工机制）：
+
+1. 声称做中性身份板，却让一次性场景光、动作或背景成为身份识别特征；反之，项目选择
+   上下文状态板却被机械清空，丢失其复用职责。
+2. 表单字段直贴描述（"身份:女配\n年龄身高:20岁"）。
+3. 描述没有提供足以识别、操作或核对状态的事实，不论文字长短。
+4. 无语义命名（资产名叫 '1'、'站位'、'参考'——下游无法按名索引）。
+5. 收到生产反馈后不诊断身份、构图、文字或状态风险，只重复同一描述。
+6. 描述内角色名与资产登记名不一致（写 A 名生成 B 人）。

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

@@ -0,0 +1,140 @@
+# 道具 Plate：尺度、功能、状态与文字
+
+## 识别测试 (`IMG-05`)
+
+道具 Plate 保持尺度、形状、材质、磨损、功能/活动部件与 accepted text policy。
+它应展示当前 State，但不能悄悄重新设计底层 prop identity。
+
+## 目录
+
+1. 目的与输入
+2. 身份与 State
+3. 可复用 plate 配方
+4. 文字政策
+5. 输出与审查
+6. 制作形态投影
+
+## 1. 目的与输入
+
+道具 plate 要让后续画面保持同一件物体的轮廓、尺度、材料、功能和当前状态。输入是精确 道具身份与状态、来源指针、用途、尺度参照、视角、功能件、磨损/损坏、主人关联、文字政策、背景与光线。
+
+道具身份不等于“谁在拿”。换手、打开、装入内容、沾水、裂损或贴上标签通常是 State；永久形制改变才可能需要重新做资产决策。
+
+## 2. 身份与 State
+
+### 持久身份
+
+- 整体轮廓与主要比例；
+- 尺寸或与中性参照的比例；
+- 主材质、表面工艺和固有色；
+- 接缝、扣件、开口、把手、铰链等功能结构；
+- 有识别价值的长期磨损或制造特征。
+
+### 当前 State
+
+- 开/关、折叠/展开、完整/损坏；
+- 当前内容物和是否可见；
+- 污渍、水、烧灼、血、灰尘等有因果的表面变化；
+- 所有权/持有关系以及状态有效范围；
+- 文字内容与承载面状态。
+
+**`reviewed_invariant`**：提示词必须能让形状、材料、功能彼此成立。例如“透明玻璃密封瓶”不能同时写成“无开口的实心石块”。
+
+## 3. 可复用 plate 配方
+
+顺序建议：
+
+1. **类型、用途、主体**：道具全貌参考、结构细节或状态 plate。
+2. **尺度与轮廓**：真实尺寸范围或中性参照，长宽厚关系，主轮廓。
+3. **材料与色彩**：主材、次材、反射/粗糙/透明关系。
+4. **功能结构**：活动件、开启方向、握持区域、接口；展示到足以理解功能，不自动演示剧情动作。
+5. **道具状态**：损伤、内容、表面状态、owner relevance 的可见部分。
+6. **视图与背景**：主体占比、正/侧/必要局部，干净背景与易读光线。
+7. **文字政策**：精确选择并说明承载面。
+8. **保持/排除**：防止变形、错材、错状态或多出复制品。
+
+- **`craft_default`**：若尺度容易误判，加入不带身份的参照或给出功能性尺寸关系；不要用剧情角色的手当默认参照。
+- **`craft_default`**：对可动部件，选择一个接受状态；如确需开/关两态，分为两个 道具状态/spec。
+- **`taste_option`**：产品式悬浮、台面陈列、正交视图或环境内静物由复用目的决定。
+
+## 4. 文字政策
+
+文字是一项资产状态和制作决策，不是随手加的装饰。
+
+不要改写 assets owner 的 `exact_readable | graphic_only | no_readable_text |
+pending_creator_text`。本 skill 只为当前 plate 选择下列 render treatment，并在
+spec 中保留 source pointer 和映射理由。完整映射表见
+[common-recipe.md](common-recipe.md)。
+
+### `readable`
+
+逐字使用已接受文本，说明位置、方向、行数/层级和承载面。正文不要改写或自动纠错关键文书。若需要保密/后期合成，可改为 `postproduction`，不能一边要求可读一边写“画面中不要任何文字”。
+
+### `symbolic`
+
+保留标签/刻痕的视觉存在和布局，但明确为不可辨识符号，不得偶然形成新名字、号码或 URL。
+
+### `blank`
+
+指定承载面保持干净空白，同时保留其材料、透视和光照。不等于抹掉道具其他结构。
+
+### `postproduction`
+
+预留清楚、无遮挡、透视可跟踪的区域；描述面积、位置、方向、材质和光线，实际字后期添加。可在 creator note 记录精确文字，但 generic image prompt 不要求生成它。
+
+**`structural_invariant`**：单个文字承载面不能同时选择互斥政策；`readable` 与全局 no-text 冲突时必须先解决。
+
+## 5. 输出与审查
+
+### 失败征兆
+
+- 只说“古老钥匙、精致盒子”，没有比例、形制和材料；
+- 打开/关闭、完好/断裂、空/装满同时存在；
+- 可动件不知如何连接，功能靠抽象标签；
+- 文字内容由 prompt 作者临时编造，或 `readable` 被 no-text 否定；
+- 道具主人被画成 plate 主体，或不同视图中尺寸/损伤位置漂移。
+
+### 检查
+
+| 问题 | 分类 |
+|---|---|
+| 道具身份与状态、source refs、text policy 可解析且不冲突 | `structural_invariant` |
+| 尺度/形状/材料/功能/current State 足以识别 | `reviewed_invariant` |
+| 磨损与状态是否有因果、没有污染永久身份 | `reviewed_invariant` |
+| 中性参照、视图数量、背景方式 | `craft_default` |
+| 产品感、写实度、陈列审美 | `taste_option` |
+
+输出精确绑定的 spec 和 generic prompt；不承诺文字最终生成准确，也不生成任何媒体。
+
+## 6. 制作形态投影
+
+已接受的 `short-drama.json#/creator_authority/{visual_direction,production_profile}` 决定这件
+道具用什么词汇被画出来，不决定它是什么东西。形态词表见
+本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
+
+### 从形态取什么
+
+- **轮廓简化程度**：该形态允许省略到哪一级仍能与同类物区分；
+- **功能件的表达通道**：铰链、开口、握持面、接缝是靠线条、靠材质明暗，还是靠真实结构；
+- **材质对光的响应**：金属、玻璃、木、布在该形态里怎样出现反射、透明与粗糙差异；
+- **尺度参照的成立方式**：绘制形态常靠对比物与透视线索，实拍形态可用真实景深与已知尺寸；
+- **磨损与损坏的通道**：笔触、色块边界、表面纹理还是实拍痕迹。
+
+### 形态不得改写什么
+
+- 形制、主要比例与功能结构的连接关系；
+- 当前 State（开合、内容物、损伤、污染）及其有效范围；
+- 文字政策与承载面；
+- 所有权/持有关系与 owner relevance。
+
+**`craft_default`**：形态越简化，越要先保住“能区别这一件与同类物”的一两处结构。Q 版、
+水墨或强笔触形态可以省略次要装饰，但钥匙的齿形、药瓶的封口、箱扣的咬合方式属于识别通道，
+省掉之后 plate 就不再是这件道具的参考。
+
+**`structural_invariant`**：形态不能修改文字政策。若 `readable` 在高度笔触化或极简形态下
+无法逐字承载，改为 `postproduction` 并写明理由与预留区域；不得降级为 `symbolic` 而把已接受
+文本悄悄丢掉，也不得为了画面整洁抹去承载面本身。
+
+合成例：角色甲交给角色乙的旧钥匙，形态选择为强笔触绘制。齿形与柄部缺口仍逐项写出，
+柄上刻字按上游政策保持 `graphic_only` → `symbolic`；笔触只影响边缘与表面质感的写法，
+不影响“同一把钥匙、当前带有那道缺口”的判定。

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

@@ -0,0 +1,92 @@
+# 图片提示词审查量表与合成案例
+
+## 目录
+
+1. 审查方式
+2. 证据量表
+3. 诊断目录
+4. 合成正例
+5. 合成反例
+
+## 1. 审查方式
+
+先做可确定检查，再由与作者分离的 reviewer 判断语义和 craft。Reviewer 不改 spec；它写 finding，包含产物与记录 ID、精确证据、影响、所需修复、owner、severity 与状态。不要以固定长度、词数、形容词比例或“像 AI”判质量。
+
+## 2. 证据量表
+
+对每条 prompt，逐项给出 `PASS | REVISE | NOTE` 和引用：
+
+| 维度 | 要问的问题 | 合格证据 |
+|---|---|---|
+| 绑定 | 是哪个 identity + exact variant？ | spec source ref 与 accepted snapshot |
+| 区分度 | 不看 display name，能否认出/区分？ | prompt 中对应 stable anchors 与 delta |
+| 单一目的 | 是否把多种互斥参考需求混在一起？ | purpose、构图与状态一致 |
+| 空间/尺度 | 关系能否同时成立并复用？ | geography/scale 原字段与 prompt 句子 |
+| 文字 | 政策、内容、承载面、排除是否相容？ | text policy 与 constraints |
+| 经济性 | 参考已承载的内容是否被无意义重复？ | 可删句与未受影响事实 |
+| 越权 | 是否新造资产、故事或连续性事实？ | source fact 与冲突句 |
+| 可复制 | 去掉内部元数据后正文是否自足？ | generic prompt 本身 |
+
+Finding 的“修复”必须可执行，例如“补回 View 中安全门相对检修台的位置”，不能只写“加强细节”。审美替代方案属于 NOTE，除非违反已接受约束。
+
+## 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 | 可选审美方案，不单独阻断 |
+
+只有 validator 可证明的 `structural_invariant` 直接阻断。语义问题由 reviewer 引用源字段和 prompt 文句后给 `REVISE`；默认与选项可覆盖。
+
+## 4. 合成正例
+
+以下人物、地点、物件与文字均为虚构合成材料。
+
+### 输入摘要
+
+- `CHAR-LUOJING`：三十岁上下，窄长脸，右眉尾有自然断点，黑色短卷发，瘦高；
+- `LOOK-RADIO-NIGHT`：墨绿工装衬衣、米白旧 T 恤、左胸圆形台标布贴，右袖口有一处旧焊痕；
+- 用途：后续镜头识别同一人物和夜班 Look。
+
+### 合格 generic prompt
+
+> 人物全身设定参考图：瘦高的三十岁上下女性，窄长脸，右眉尾有一处自然断点，黑色短卷发，保持克制而警觉的低强度表情。只呈现夜班造型：墨绿工装衬衣敞开一颗领扣，内搭米白旧 T 恤，左胸缝圆形无文字台标布贴，右袖口保留拇指宽的浅褐旧焊痕，深色直筒长裤与耐磨短靴。自然站立的全身正面为主，附同一造型的头肩侧面小视图；比例真实，无夸张透视。中性浅灰背景，均匀柔光，清楚呈现面部轮廓、服装层次和布料磨损。保持同一张脸、同一发长、同一套衣服；不增加首饰、伤口、手持工具或第二套造型，不出现可读文字。
+
+为何有效：身份锚点与 Look 分层；构图服务识别；“无文字”不否定无文字台标；没有借设定图演一场戏。
+
+### 合格 Location 摘要
+
+> 社区广播站维修间空场参考：从朝南的窄门向内看，长形房间右墙是一列齐腰高木质检修台，台尽头连接后墙唯一的灰色金属安全门；左墙两扇高窗与检修台相对，窗下固定一排浅柜，房间中央保留一条从入口直通安全门的走道……空场，不出现演员或剧情动作。
+
+关键不是装饰多，而是入口、检修台、安全门、窗和走道的关系可复用。
+
+## 5. 合成反例
+
+### 反例 A：泛化且混 Look
+
+> 顶级电影质感的绝美女主，时而穿墨绿工装，时而穿红色礼服，头发既短又飘逸及腰，浑身湿透但衣服保持完全干燥，8K，大师杰作，无任何瑕疵。
+
+Finding：
+
+- evidence：同一规格同时出现两套服装、两种发长和互斥干湿状态；
+- impact：无法成为一个 accepted Look 的复用参考，并抹去断眉/脸型等锚点；
+- required fix：绑定一个 Look，仅保留该状态的可观察 delta，把其他 Look 拆为独立规格；
+- classification：`reviewed_invariant`，owner `image-prompts`，severity `error`。
+
+### 反例 B：文字矛盾
+
+> 桌面上的值班登记簿，封面必须清楚写“设备复核记录”，画面中不要任何文字、字母或符号。
+
+`readable` 与全局 no-text 可由本地检查证明冲突。修复不是祈求“正确生成”，而是在 `readable` 与 `postproduction` 中选择一种并调整正文。
+
+### 反例 C：越权 edit
+
+> 保持所有东西不变，把维修间改造成豪华酒店大堂，再把后门移到左侧。
+
+目标、View 和 preserve 边界不清；同时改写 Location 身份与固定地理。先路由 assets 形成新 Location/View 决定，不能在 edit prompt 内偷改。

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

@@ -0,0 +1,89 @@
+# 图片提示词阶段契约
+
+## 目录
+
+- [独立运行与项目集成](#独立运行与项目集成)
+- [所有权边界](#所有权边界)
+- [制作形态需要什么](#制作形态需要什么)
+- [参考媒体与补拍](#参考媒体与补拍)
+- [本阶段规则](#本阶段规则)
+
+本文件是本技能的自包含契约：预检、所有权、形态输入与规则表都在这里，
+不需要读取其他技能的文件。
+
+## 独立运行与项目集成
+
+本技能可以单独安装并运行；下面几条说明项目工具存在时怎样集成。
+
+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 说明母版与补充关系，并把每项原文要求对应到当前字段或说明
+  去向。只有下游审查结论才能批准替代，不得回写形成循环引用。
+
+## 本阶段规则
+
+### `IMG`
+
+| ID | Class | Knowledge |
+|---|---|---|
+| IMG-01 | structural_invariant | Prompt specs bind exact accepted asset and variant IDs. |
+| 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. |
+| IMG-05 | reviewed_invariant | Prop plates preserve scale, shape, material, wear, function, and text policy. |
+| IMG-06 | structural_invariant | Edit prompts declare exact target, changes, preserve set, and expected continuity impact. |
+| IMG-07 | structural_invariant | Readable text cannot coexist with a global no-text constraint. |
+| IMG-08 | reviewed_invariant | A claim about reference pixels requires a creator/reference-owner description or authorized input-reference observation bound to the inspected bytes; otherwise admission stays unresolved, and a negative prompt cannot stand in for evidence. |
+| 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. |
+
+规则分级由高到低：`structural_invariant`（结构缺陷，阻断）、
+`reviewed_invariant`（需证据判断）、`craft_default`（常用做法，可覆盖）、
+`taste_option`（创作者选择，不作缺陷）。创作者已接受的事实优先于本表。