@oh-story/dsh 0.1.3 → 0.1.5

package/lib/drama/skills/short-drama-assets/references/occurrence-extraction.md

@@ -16,10 +16,8 @@
 它对应哪个资产，可以避免把同一人物的几套衣服拆成几个人，也能避免把两个同称谓的人
 误并成一人。
 
-**`structural_invariant` AST-01**： 每条出现记录都要指向准确的剧本快照、字段、剧本段 ID
-和场次：文件首行的 `sources` 声明剧本产物，`source_ref` 写
-`{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A01"}`。行号只能帮助阅读，
-不能代替稳定来源。
+**`structural_invariant` AST-01**： 每个出现判断都要指向 `剧本.md` 中准确的场景 ID，并用动作、
+对白或必要短引文说明依据。行号只能帮助阅读，不能代替稳定场景来源。
 
 ## 逐段检查，而不是只找名词
 
@@ -48,17 +46,16 @@
 
 | 内容 | 字段用途 | 写法 |
 |---|---|---|
-| 剧本段和场次位置 | `source_ref` | `src` 指向首行声明的剧本快照，加 `record_id` 与需要的 `field`；不复制整段权威文本 |
-| 剧本明示的可见事实 | `derived_projection` | 简短摘义，并指回准确字段 |
-| 拟绑定的资产 | `derived_annotation` | 只保留提案；资产决定记录反向引用本条出现记录，并拥有最终决定 |
-| 连续性变化 | `source_ref` | `src` 指向资产技能负责的变化记录产物，加 `record_id` 与需要的 `field` |
+| 剧本段和场次位置 | 来源 | 场景 ID 加动作/对白标签或必要短引文；不复制整段正文 |
+| 剧本明示的可见事实 | 可见事实 | 简短摘义，并指回同一场景 |
+| 拟绑定的资产 | 资产判断 | 只保留复用、新变体、新身份或未决结论 |
+| 连续性变化 | 状态变化 | 指向 `视觉设定.md` 中对应身份与前后状态 |
 
 不要把推测伪装成可见事实。可以直接推出的结果也要说明依据，例如“匣盖被推开”可以
 记为 `open`；“顾禾很内疚”不能只因她低头就升级成资产事实。
 
-决定尚未创建时写 `decision_locator`：`owner`、项目相对路径、`selector` 和 `status`；
-决定创建后，由决定记录指向出现记录。未来的连续性变化同样先写定位信息。这样不会让两个
-文件互相等待对方先落盘。
+决定尚未形成时就在对应条目标“未决”，列候选、缺失证据和影响。未来才会发生的连续性变化只写
+“需要同步”的说明，不为尚不存在的文件建立占位记录。
 
 ## 称谓、代词和匿名对象
 

package/lib/drama/skills/short-drama-assets/references/prop-and-state.md

@@ -39,6 +39,10 @@ State 记录可变而需跟踪的事实：
 - 组装、封条、消耗量或功能状态；
 - 变化原因与有效范围。
 
+物件若持续承担人物的支撑、固定、负重或行动条件，状态同时记录**人物—物件关系**与有效范围，
+再由分镜投影到起终边界；不能只写物件存在或只在角色板中画出。短暂坐下、靠墙或伸手接触仍是
+镜头瞬态，不为此制造长期状态。
+
 **`craft_default` AST-03**： 同一物体的转手、开合、破损、内容与文字变化优先做
 记录状态变化，不重复创建道具。
 
@@ -64,8 +68,23 @@ State 记录可变而需跟踪的事实：
 文字是剧本事实时，资产环节只保存政策与来源位置，不自行润色。后续提示词不能
 同时要求 `exact_readable` 和全局 `no_text`。
 
-若剧情出现网址、号码、合同内容等敏感屏显，必须记录来源、屏显文字声明和创作者的
-交付接受记录；不能把本地引用路径或内部地址带入交付。
+若剧情出现网址、号码、合同内容等敏感屏显，必须写明来源、准确屏显文字和创作者确认的处理方式；
+不能把本地引用路径或内部地址带入交付。
+
+**`craft_default`**： 可读文字或标识指向**现实中存在的品牌、商标、机构或人物**时，四个选项里
+选哪一个不是资产环节的默认动作，而是创作者的决定。改编常把这类专名从原著原样带下来，此时
+保留原名、只留形制而不留标识、换一个虚构名都可能是对的，取决于创作者对权利、题材真实感和
+交付渠道的判断。
+
+这里未定的是**政策本身**，不是文字内容，所以不要挪用 `pending_creator_text`（那一条针对
+"剧本要求文字但内容未定"）。按已有的未决决定写：`decisions.jsonl` 里一条
+`decision_kind: unresolved`，把三种处理列进 `candidate_bindings` 并各写 support/conflict，
+`creator_question` 问创作者选哪一种，`downstream_impact` 列出会被挡住的下游，
+`creator_acceptance.status` 保持 `pending_choice`。`text_policy.mode` 在创作者选定前不改写，
+原文来源位置照常保留；不替创作者定案，也不擅自改名——擅自改名同样是改写上游事实。
+
+本套件不判断合规、不给禁令、不内置品牌清单；它只保证这个选择有人做、被记下来，而不是在
+生成被拒之后由执行端顺手改掉。
 
 ## 内容物与知识是两条连续性
 

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

@@ -1,105 +1,10 @@
-# 资产阶段契约
+# 视觉设定阶段契约
 
-## 目录
+本阶段只拥有 `剧集/<EP>/视觉设定.md` 中的人物/造型、地点/视图、道具/状态、声音身份与跨场连续性。
+它继承剧本事实，不决定镜头瞬态、构图、动作终点或生成提示词。
 
-- [独立运行与项目集成](#独立运行与项目集成)
-- [所有权边界](#所有权边界)
-- [跨产物引用](#跨产物引用)
-- [制作形态需要什么](#制作形态需要什么)
-- [本阶段规则](#本阶段规则)
-
-本文件是本技能的自包含契约：预检、所有权、形态输入与规则表都在这里，
-不需要读取其他技能的文件。
-
-## 独立运行与项目集成
-
-本技能可以单独安装并运行；下面几条说明项目工具存在时怎样集成。
-
-1. **读取直接输入**：只读取用户明确提供或当前任务实际需要的文件，不批量加载整个项目。
-2. **可选项目集成**：若存在 `short-drama.json` 且 core 项目工具可用，可以运行
-   `python3 <core>/scripts/project_tool.py status <project>`，使用返回的目录布局和语言设置；
-   core 不可用时，直接基于已提供输入产出本阶段文件。
-3. **可选发布生命周期**：项目工具可用时，用 `publish` 原子发布并用 `--input <path>`
-   声明直接输入；`accept`、`review` 与 `package` 继续承担确认、复核与交付。
-4. **保持职责分离**：创作者确认、内容修订和复核是不同动作；reviewer 提修改要求，负责人改文件。
-
-## 所有权边界
-
-- **本阶段拥有**：人物/地点/道具的身份与变体；资产状态变化记录与场景/单集资产台账；
-  出现证据的提取。
-- **本阶段继承**：剧本给出的身份、地理与文字政策；故事状态条目是开发/剧本的只读投影。
-- **本阶段不越权**：不决定镜头构图与动作终态，不改写剧情事实。台账里的故事状态只带来源
-  指针，不构成第二个取值权威。
-
-## 跨产物引用
-
-引用回答一个问题：**这份产物是从哪些产物做出来的**。
-
-`sources` 只记录**派生来源**——本文件的内容依赖它、它变了本文件就可能要重做的那些产物。
-同层产物互相指名不是派生：occurrence 可以指向它喂给的 decision，那个 decision 也指回它
-消费的 occurrence，两者都成立，但只有后者是派生。**只有派生关系必须无环**，互相指名不受
-此限。把非派生的指名写进 `sources`，会让派生图出现假环，也会让「上游变了要重做什么」这个
-问题答不准。
-
-同一个上游被一个文件反复引用时，在开头声明一次，之后每条引用只写快照键和记录 ID。
-声明本身也占篇幅，所以只被引用一两次的上游直接把 `owner`、`artifact` 写在那条引用里。
-
-`.jsonl` 的第一行是声明记录：
-
-```json
-{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP003/screenplay-index.jsonl"},"characters":{"owner":"short-drama-assets","artifact":"设定集/characters.jsonl"}}}
-```
-
-`.json` 用顶层 `"sources"` 对象，条目形状相同。
-
-条目只有 `owner` 与 `artifact`：**引用指名产物，不携带产物的字节**。产物里不写任何哈希——
-写在引用里的哈希要手工维护，而从来没有任何校验器比对过它。真正在比对字节的只剩生命周期
-状态与交付包校验和，那两处由工具自己维护、会真的重算。
-
-`sources` 的键短、小写，由产物文件名派生（`characters`、`looks`、`locations`、
-`location-views`、`props`、`prop-states`、`occurrences`、`screenplay-index`），在本文件内
-唯一且稳定。
-
-引用写成：
-
-```json
-{"src":"characters","record_id":"CHAR-GUHE"}
-```
-
-指向记录中某个字段时加 `field`（JSON pointer）；引用方需要区分权威等级时加 `authority`
-（`accepted` / `candidate`），它属于这一条引用，不属于来源声明。指向整份产物或产物级字段时
-省略 `record_id`。
-
-产物存在不等于它里面有你指的那个东西，所以这两件事分两处判：
-
-- **同时拿到引用方与被引用文件时，`record_id` 由检查器当场解析**。资产检查器同时读
-  `characters.jsonl` 与 `looks.jsonl`，所以外观指向不存在的角色会被它直接报出来。
-- **跨文件的 `field` pointer 由仓库层的 `tests/test_reference_integrity.py` 判定**，
-  它把随发布的模板与一个完整项目里的每条指针都走到底。检查器只拿到命令行给它的那几个
-  文件，指向没拿到的文件时它无从解析——这一点此前写成了「都会被检查」。
-
-## 制作形态需要什么
-
-视觉风格不是贴在提示词前面的标签。创作者已接受的视觉方向与制作形态由项目层决定并传入，
-**本技能不加载形态卡，也不自行选择形态**；本节只说明本阶段需要形态回答什么、以及拿到
-答案后投影成哪些字段。
-
-形态决定属于 `craft_default`：创作者说明理由即可覆盖。形态不能创造新的
-`structural_invariant`，也不能改写身份、地理、持物归属与可读文字政策。审查者不得单凭
-形态偏好阻断交付。
-
-不要用“加一句风格前缀”处理形态差异。前缀只改变检索标签；形态改变的是**必须出现和
-可以省略的字段**，只有后者会被执行，也只有后者能被审查。
-
-本阶段要向形态决定问四件事：
-
-- **身份锚点载体**：靠什么让人物跨镜可辨认——轮廓、线条、比例、结构差异还是材质。
-- **层级拆分**：身份层、环境层、可动层、效果层各包含什么，同一事实由谁负责。
-- **材质与光色**：材料怎样响应光，色彩关系承担什么信息；不罗列质量词。
-- **连续性必带项**：本形态下哪些字段必须逐镜传递、哪些可以省。不同形态答案差别很大，
-  不要照抄别的形态的必带串。
-
-本阶段新增：轮廓、材料、层拆、稳定比例与版本差异。
+每个判断在同一文档中写成复用、新身份、新变体或真实未决；来源用场景 ID，跨文档消费用可见标题和
+稳定 ID。不要为身份决定建立 occurrence、decision、ledger 或接受记录。
 
 ## 本阶段规则
 
@@ -107,18 +12,19 @@
 
 | ID | Class | Knowledge |
 |---|---|---|
-| AST-01 | structural_invariant | Extract occurrences with a declared source snapshot and block ID before creating or binding an asset. |
+| AST-01 | structural_invariant | Before creating or reusing an asset, point to the scene ID and visible evidence that establishes it. |
 | AST-02 | reviewed_invariant | Reconcile each occurrence as reuse, new identity, new variant, or unresolved—never guess an ambiguous name/pronoun. |
 | AST-03 | craft_default | Separate Character/Look, Location/View, and Prop/State. |
 | AST-04 | reviewed_invariant | Persistent identifying anchors and mutable state are not mixed. |
-| AST-05 | structural_invariant | Every downstream binding resolves to an accepted identity and valid variant. |
+| AST-05 | structural_invariant | Every downstream reference resolves to a visible identity item and the stated current variant in `视觉设定.md`. |
 | AST-06 | craft_default | Track only asset facts needed for recognition, reuse, prompt writing, or continuity. |
 | AST-07 | reviewed_invariant | Persistent voice identity and pronunciation refs stay separate from scene-level breath, emotion, volume, and delivery state. |
 | AST-08 | reviewed_invariant | A voice reference binding states what it controls and what it must not; the take's emotion, its recording space, and its background never enter identity. |
 | AST-09 | reviewed_invariant | A claim about what is audible in a reference requires a creator or rights-holder description, or an authorized listening observation bound to the inspected bytes; otherwise admission stays unverified. |
-| AST-10 | structural_invariant | An accepted pronunciation of a proper noun appears in exactly one spelling across the 设定集. |
+| AST-10 | structural_invariant | One accepted pronunciation of a proper noun uses one spelling throughout `视觉设定.md`. |
 | 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. |
 
 ### `CON`
 
@@ -127,9 +33,10 @@
 | CON-01 | structural_invariant | Linked end and next start states match or have an explicit owner revision. |
 | CON-02 | reviewed_invariant | Knowledge, injury, ownership, weather, light, or physical state does not teleport/regress without story cause. |
 | CON-03 | craft_default | Track downstream-relevant deltas, not the whole 设定集 in every shot. |
-| CON-04 | structural_invariant | A delta records before, after, cause/source, effective range, and affected bindings. |
+| CON-04 | structural_invariant | A continuity change states before, after, cause/source scene, effective range, and affected visible IDs. |
 | CON-05 | taste_option | Declared montage, ellipsis, dream, or subjective imagery may intentionally break ordinary continuity. |
-| CON-06 | structural_invariant | A delta's affected refs cover all existing consumers; future consumers remain locators until materialized. |
+| CON-06 | structural_invariant | A continuity change names every existing downstream document it affects; future work is described, not pre-created. |
+| CON-07 | structural_invariant | A continuity lock declared in `视觉设定.md` fixes one verbatim surface plus its shot and image scope; every in-scope frozen keyframe, motion prompt, and named image prompt carries that surface unchanged. |
 
 规则分级由高到低：`structural_invariant`（结构缺陷，阻断）、
 `reviewed_invariant`（需证据判断）、`craft_default`（常用做法，可覆盖）、

package/lib/drama/skills/short-drama-assets/references/voice-direction.md

@@ -69,7 +69,7 @@
 
 ## 绑定不等于听过
 
-`artifact_ref` 只说明绑定了哪条记录，**不能证明有人真的听过这段音频**（`AST-09`）。
+文件名或可见引用只说明绑定了哪段素材，**不能证明有人真的听过这段音频**（`AST-09`）。
 每条绑定写清证据到了哪一步：
 
 | `admission_status` | 什么情况 | 可以下什么结论 |
@@ -82,9 +82,8 @@
 参考里有底噪就是有底噪，写「不要底噪」不会让它消失；要么重录、清理、换一条，
 要么退回参考权利人决策。
 
-参考音频与授权说明属于创作者输入，放在 `输入/` 下：在文件首行的 `sources` 里按整文件
-声明一次，`artifact_ref` 写 `{"src":"guhe-audition-02"}`——指向整份媒体，不带
-`record_id`。**媒体本身不进 设定集，也不进交付包**，只进声明与引用。
+参考音频与授权说明属于创作者输入，放在 `输入/` 下；`视觉设定.md` 只写项目相对路径、用途、
+允许控制/不得控制的内容与观察状态。**媒体本身不复制进视觉设定，也不进公开交付**。
 
 ## 选型判据
 
@@ -138,34 +137,15 @@ CHAR-A 与 CHAR-B 最易混：两条参考同为中低音区、语速偏慢。
 短暂的一场变化不建变体，交给表演。判据和 Look 一样：跨多个场次持续、会重复使用、
 需要独立参考、或下游必须精确绑定时才升为变体。
 
-## voice-casting.md 的渲染规则
+## 写入 `视觉设定.md`
 
-`设定集/voice-casting.md` 是已接受 `voice_direction` 的**派生文本**，交给配音导演、
-选角或克隆操作者使用。它由已接受记录重新生成，是缓存，不是第二份权威——手改它不会改变
-任何身份，下一次渲染就会被覆盖。
+需要跨集保持声音身份时，在对应人物条目下增加“声音方向”，只保留：
 
-每个角色一段，固定四块：
+1. **参考**：项目相对路径、用途、允许借用与不得借用；没有参考时写“待选型”；
+2. **选型判据**：三到五条可听判据，每条带反例；
+3. **对比角色**：最容易混淆的是谁，以及靠什么可听差异区分；
+4. **专名发音**：唯一确认读法；
+5. **变体**：跨多场持续的伪装、年龄跨度或音色变化，写原因与有效范围。
 
-1. **参考绑定**：哪条参考、`role`、可借用什么、不可借用什么、`admission_status`；
-   没有参考时写「待选型」并列出选型判据；
-2. **选型判据**：三到五条，每条带反例；
-3. **区分说明**：和谁最容易混、用哪条区分；
-4. **专名发音**：已接受的那一份拼法。
-
-不写入任何服务商参数、模型名、接口字段、任务 ID 或网址——记录要比任何一次调用活得久。
-
-**资产阶段不生成音频，也不调用任何语音、合成或克隆服务**。 文本绑定只能保证角色、
-声音方向与引用关系没有被改写；它不能承诺任何真实的合成结果、音色复现或口型同步。
-记录先落进文件、由创作者确认；需要实际 TTS 时再交给 `$short-drama-produce`，由它展示
-精确任务预览并取得本次生产的明确确认。
-
-常见失败：
-
-| 失败 | 症状 | 怎么改 |
-|---|---|---|
-| 用文字冒充音色 | 没有参考，却写了一整段音色描述当身份 | 保持 `reference: null` 并标「待选型」，判据归判据 |
-| 参考的情绪进了身份 | 借用范围里出现「这条里的哽咽」 | 移进 `must_not_control` |
-| 录音空间被当成音色 | 身份里写了混响、房间感、话筒距离 | 那属于那次录音，删掉 |
-| 声称听过却没听过 | `admission_status` 写着已检查，却没有观察记录 | 退回 `unverified` 并列风险 |
-| 两个角色撞声 | 两条参考互换名字也说得通 | 补区分判据；补不出就换参考 |
-| 发音两套拼法 | 同一专名在两处不同 | 回到已接受的那一份 |
+临时情绪、呼吸、重音、音量和空间混响仍由剧本/镜头/视频提示词拥有。声音方向是生产输入，不是
+合成结果保证；实际 TTS 仍由 `$short-drama-produce` 在精确预览并显式确认后执行。

package/lib/drama/skills/short-drama-assets/scripts/asset_check.py

@@ -259,7 +259,7 @@ def main() -> int:
     except (OSError, ValidationError) as exc:
         print(f"asset 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/SKILL.md

@@ -1,181 +1,71 @@
 ---
 name: short-drama-image-prompts
-description: 为已确认的短剧角色、造型、场景、视角、道具和状态编写或修改可复制的通用资产图片提示词，并把已接受视觉方向投影成 Look Development 人物、地点或高压力风格帧。用户提到角色设定图、三视图、人物参考图、场景设定图、场景空镜、场景板、道具图、风格帧、Look Development、造型或状态变体、局部编辑提示词，或要求用自然语言修改现有图片提示词时直接使用；只产出结构化规格与 Markdown 文本，不生成图片，也不调用模型或供应商接口。
+description: 为短剧人物、造型、地点、道具和状态编写或修改可直接复制的图片提示词 Markdown。用户提到角色设定图、三视图、参考图、场景板、道具图、风格帧、Look Development、状态变体或局部编辑提示词时使用；不生成图片，也不调用供应商。
 license: MIT
 ---
 
 # 短剧资产图片提示词
 
-把已接受的资产事实写成“能认出、能复用、能区分状态”的参考图提示词。这里的产物是提示词，不是图片。
-
-预览、警告与修订说明是创作者读的：项目内跟随 `short-drama.json#/language`，独立运行时
-跟随用户使用的语言。送给图片生成器的**通用提示词正文**在项目内跟随
-`#/format/prompt_language`，独立运行时由用户指定、未指定则为 `en`。
-改了描述语言不等于
-改了画面里的可读文字——那由已接受的文字政策决定。
-
-## 开始前
-
-本技能可独立安装和执行。先读取用户明确提供的资产事实、视觉方向与本任务直接输入；若当前
-目录是 `short-drama` 项目且项目工具可用，可以读取 `status` 并使用其发布生命周期，但缺少
-core 或任何其他技能都不是提示词工作的阻断条件。[阶段契约](references/stage-contract.md)
-给出本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
+把视觉事实写成可复用、可修改、可直接复制的角色板、场景板、道具板或状态图提示词，统一保存到
+`剧集/<EP>/图片提示词.md`。每项用 `IMG-...` 标题，正文放在 `### 可复制提示词` 引用块。
+`IMG-...` 只是该提示词条目的稳定 ID，不声明图片已生成或可用；实际图片只能来自创作者已提供的输入，或经确认后的生产结果。
 
 ## Quick Start
 
-从本技能的最小原生 JSONL 样例开始，写完当前有界资产集合后运行：
-
 ```text
-python3 {技能目录}/scripts/image_prompt_check.py examples/minimal-image-prompt-specs.jsonl
-python3 {技能目录}/scripts/selftest.py
+用 $short-drama-image-prompts 为 EP001 已确定的人物、地点和道具写可直接复制的图片提示词
 ```
 
-校验器检查准确绑定、稳定 reference slot/order、局部编辑必填项、文字政策冲突和 provider 字段
-泄漏；构图、身份表现和画面质量仍属于内容审查。输入路径不存在于当前目录时，会相对本技能目录解析。
-
-## 进入条件与边界
-
-- 可从现成项目或创作者直接提供的资产记录进入，不要求先做故事开发或安装主技能。
-- 所有权或直接输入影响不清楚时，读
-  [阶段契约](references/stage-contract.md) 的所有权边界；需要定位规则 ID
-  或解释审查问题时，读同一文件的本阶段规则表。
-- 输入必须是已接受的 `CHAR/LOOK`、`LOC/VIEW` 或 `PROP/PSTATE` 精确 ID 与快照引用。未决指代、冲突变体或未知状态退回 `$short-drama-assets`，不代猜。
-- 项目存在时读取 `short-drama.json#/creator_authority/{visual_direction,production_profile}`
-  中状态为 `accepted` 的视觉方向与制作形态；独立运行时使用创作者直接提供的等价约束，未提供
-  就保持 `unset`。它决定本阶段可执行的形状语言、线条/表面处理、材质对光的
-  响应与层拆；若状态为 `unset`，就向创作者给出选择，不从对话记忆补造，也不用默认审美冒充
-  已接受形态。形态只决定可执行词汇，不决定身份、地理、持物、可读文字政策与故事状态。
-- 若创作者明确要求全链预览，可对唯一且没有 `unresolved` 问题的资产提案写候选提示词；
-  文档标明待确认，不得声称创作者已经接受。
-- 本技能只负责构图、提示词专用约束，以及局部修改中的修改项 `changes` 和保留项 `preserve`；身份、地理和资产状态仍由资产技能负责。
-- 始终保留不绑定供应商的通用提示词。不得创建图片、媒体任务、接口请求、模型参数、轮询记录或画质结论。
-
-## 按任务加载资料
-
-| 任务 | 必读资料 |
-|---|---|
-| 新建任意资产提示词 | [通用配方与视觉锚点](references/common-recipe.md) |
-| Look Development / 人物、地点、高压力风格帧 | [Lookdev 风格帧](references/lookdev-frame.md) |
-| 人物设定图 | 加读 [人物与造型](references/character-and-look.md) |
-| 造型、视角或道具状态的版本 | 加读 [造型与状态变体](references/look-and-state-variant.md) |
-| 场景空镜或不同观察方向 | 加读 [场景与地理](references/location-plate.md) |
-| 道具或 道具状态 | 加读 [道具、尺度与文字](references/prop-plate.md) |
-| 局部修改或自然语言改提示词 | 加读 [编辑与修订](references/edit-and-revision.md) |
-| 自检、复核、失败诊断 | [审查量表与合成案例](references/review-and-fixtures.md) |
-| 生产端三视图/场景方位/物品版式配方 | [生产资产图配方](references/production-sheet-recipes.md) |
-| 参考图只决定身份、构图或尺度等指定内容 | [阶段契约](references/stage-contract.md) 的参考媒体与补拍 |
-
-普通资产规格使用 [结构化规格模板](assets/image-prompt-spec.jsonl.md)；Look Development 改用
-[独立风格帧模板](assets/lookdev-frame-spec.jsonl.md) 与
-[风格帧 Markdown 模板](assets/lookdev-prompts.md)，不先加载普通资产超集再删字段。普通资产交付文本
-使用 [Markdown 模板](assets/image-prompts.md)。只加载当前类型所需资料。
-
-## 每轮的工作单元
-
-一轮处理一组明确的资产 ID。“给所有资产写提示词”拆成若干个具名集合，每轮：
-
-1. 只读这组资产的直接输入，写它们的提示词规格，跑本地结构检查；
-2. 落盘这一组，其余资产保持原样；
-3. 报告已覆盖范围、剩余范围、未决绑定和下一组值得做的资产；
-4. 交还控制权，等创作者的下一次请求。
-
-实际生成、下游阶段和审查各自是独立的工作单元，由创作者明确请求时开始。
-
-## 工作流
-
-### 1. 确认目的而非先堆风格词
-
-先回答：这张参考图以后要帮助谁保持什么一致？选择一种主类型：
-
-- `character_sheet`：识别同一人物的一套已接受造型；
-- `location_plate`：固定一个地点的观察方向和地理；
-- `prop_plate`：固定道具的尺度、形制、功能和当前状态；
-- `look_state_variant`：在同一身份上突出有因果与有效范围的差异；
-- `edit_delta`：对精确目标做有边界的修改，同时声明保留集。
-- `lookdev_frame`：把已接受视觉方向投影成人物表现、核心地点或高压力场景的代表性文本规格。
-
-一个规格只承担一个主要复用目的。需要不同造型、观察方向、状态或 lookdev 测试轴时分开写，
-不把互相冲突的状态揉成“大全图”。风格帧不获得角色身份、场景地理或剧情状态的权威。
-
-### 2. 整理输入
-
-从接受快照记录：
+## 入口
 
-1. 准确的资产 ID 与版本 ID；
-2. 稳定识别点与本版本的变化；
-3. 来源引用：文件头 `sources` 里的快照键 `src`、`record_id` 与 `field`；
-4. 用途、构图、背景、光线与文字政策；
-5. 每张参考图的准确引用、单一作用、可参考内容、不可照搬内容与检查状态；只有
-   创作者/参考图权利人的说明，或经过授权的输入参考图检查，才能给出像素/文字结论；
-   前者写 `creator_described`，后者写 `visually_inspected`，都没有时保持 `unverified` 并列出风险；
-   多参考还要保留稳定 `slot_id` 与显式 `order`，不能让数组重排改变用途；
-6. 必须出现、必须保持和明确排除的内容；
-7. 未决定项以及创作者的明确选择。
+有当前视觉设定即可直接开始；剧本只在提示词需要确认剧情状态时读取。Look Development 是可选分支。
+先确认用途：身份板、造型/状态变体、地点板、道具板、组合 production sheet 或比较风格帧。
 
-只带入当前操作必需的信息。私有引用在文本中仅写 `REF-*`，不泄露本地路径、网址或原始内容。
+创作者可读说明跟随项目语言；可复制正文跟随 `short-drama.json#/format/prompt_language`。没有
+`short-drama.json` 时正文默认
+使用 `en`，并在同一任务中保持一致；不能从创作者说明语言推断提示词语言。
 
-### 3. 按重要性写规格与通用提示词
-
-按“用途/主体 → 识别点 → 状态差异 → 构图/方向/尺度/空间关系 → 材质/色彩/光线 → 背景 → 文字政策 → 排除/保留”组织。身份、地理、尺度和可读文字等重要事实先于“精致、电影感”等空泛审美词。
-
-- `structural_invariant`：绑定准确的已接受 ID/版本；局部修改写清 `target_ref` 与 `entity_or_region`、`changes`、`preserve` 和连续性影响；`readable` 不得与全局 `no-text` 并存。
-- `reviewed_invariant`：人物在一个规格中保持同一身份和一套连贯造型；场景保持清楚的地理；道具保持可辨尺度、形制与功能。
-- `reviewed_invariant`：参考图只决定已经声明的内容；构图、尺度或效果参考不得顺带改写身份、文字、人数或故事状态。
-- `craft_default`：用少量可观察、彼此不重复的识别点；负面约束只防止当前风险，不写长篇万能禁词。
-- `taste_option`：写实/绘制、镜头审美、色彩浓度、文风密度由创作者决定；一旦被写入
-  `creator_authority` 并接受，它就不再是本阶段可自选的口味，而是必须投影的形态约束。
-
-### 4. 做矛盾与可复用性审查
-
-逐项检查：锚点是否互相打架；临时状态是否污染身份；空间关系是否能画在同一画面；构图是否服务参考用途；文字政策是否可执行；排除项是否误杀必需事实。语义质量用证据复核，不用词数、形容词数或固定提示词长度硬判。
-
-### 5. 让创作者接受，再写正式产物
-
-先展示人能读懂的预览：绑定对象、关键选择、警告与可复制提示词。接受后写：
-
-- `项目开发/lookdev-image-prompt-specs.jsonl` 与 `项目开发/lookdev-prompts.md`：仅项目级
-  Look Development 使用，后者为派生文本；
-- `剧集/<EP>/assets/image-prompt-specs.jsonl`：权威规格，写入时 `status` 如实跟随对象当前
-  生命周期状态（预览为 `candidate`，已接受的落盘规格为 `accepted`）；
-- `剧集/<EP>/assets/image-prompts.md`：由已接受规格重新生成的文本版本，元信息写明用的是哪个渲染器。
-
-项目工具可用时用 `publish` 发布规格和派生文本并声明直接输入；独立运行时直接写出本阶段文件。
-两种方式都不得以半成品覆盖当前版本。
+## 工作流
 
-`--input` 要把本文件 `sources` 里声明的每一个上游都列全——**少列一个，那个上游改了本产物也不会
-变 `update_needed`，它会带着过期的绑定停在 `accepted`**。本阶段的完整清单是身份与变体两侧成对：
+1. 锁定这一张图要固定的身份、状态、空间或比较变量。
+2. 只读所需资产事实、视觉方向、负面约束和已提供参考图。
+3. 按“主体与身份锚点 → 当前变体 → 构图/视角 → 光色/材质 → 背景边界 → 禁止项”写正文。
+4. 每张参考只控制身份、造型、地理、构图或风格中的明确部分，并在 `REF-...` 槽位里写出封闭词表中的 `用途`。
+5. 检查身份与变体、文字政策、视角和光线是否冲突。
+6. 用户要全部资产就完成全部，资产组只是内部批次。
 
-```text
-... publish <project> --owner short-drama-image-prompts --artifact-id EP001:image-prompts \
-  --output 剧集/EP001/assets/image-prompt-specs.jsonl=_work/image-prompt-specs.jsonl \
-  --input 设定集/characters.jsonl --input 设定集/looks.jsonl \
-  --input 设定集/locations.jsonl --input 设定集/location-views.jsonl \
-  --input 设定集/props.jsonl --input 设定集/prop-states.jsonl
-```
+## 提示词要求
 
-## 自然语言修订
+- 开头先写对象和用途，不用风格词淹没身份。
+- 只包含当前图能同时满足的要求；多视图/状态对照写清版面关系。
+- 保留稳定识别锚点，变体只改允许变化的部分。
+- 被《视觉设定.md》连续性锁点名的条目，锁面原样出现在可复制正文里，让这张参考图本身就把跨镜事实定住。
+- 避免无验证作用的质量词堆砌。
+- 可见文字、logo、水印、界面和字幕明确允许或禁止。
+- 正文可直接复制，不含占位符、流程说明、文件路径或 QA 结论。
 
-用户可直接说“外套保持不变，只把袖口变湿”“场景里不要出现演员”。不要让用户编辑 JSONL。
+## 按需知识
 
-1. 把请求整理成按字段列出的修改方案，并标记哪些事实由上游负责；
-2. 展示 `before → after`、受影响的绑定和连续性，以及无法对应或会丢失的内容；
-3. 等待接受或拒绝；拒绝时原规格与 Markdown 文本不变；
-4. 接受后先提交规格，再从规格重新导出 Markdown 文本。
+默认只读本 SKILL 和当前视觉设定。遇到对应问题时只打开一份：
 
-若 Markdown 文本被手改：`restore` 先预览恢复；`adopt` 只把能完整对应字段的改动变成
-规格提案。无法对应的文句会阻断 `adopt`，绝不让派生文本反向成为事实来源。详见
-[编辑与修订](references/edit-and-revision.md)。
+- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 普通单图的最小配方：[通用配方](references/common-recipe.md)
+- 人物身份板与造型一致性：[人物与造型](references/character-and-look.md)
+- 地点地理、视角和光线：[地点板](references/location-plate.md)
+- 功能道具、尺度、材质与文字：[道具板](references/prop-plate.md)
+- 造型和状态变体：[造型与状态变体](references/look-and-state-variant.md)
+- 多对象组合板：[Production Sheet 配方](references/production-sheet-recipes.md)
+- 比较视觉方向的代表帧：[Lookdev 风格帧](references/lookdev-frame.md)
+- 局部修改和 preserve set：[定点修改](references/edit-and-revision.md)
+- 完成前的可生成性检查：[审查与示例](references/review-and-fixtures.md)
 
-## 完成标准
+## 完成与投产
 
-- 每个规格能追溯到准确的已接受资产与版本，且通用提示词可独立复制；
-- 类型配方完整，重要事实在泛化审美词之前，无未决占位或内部工作指令；
-- 局部修改同时说明改什么、保留什么、会影响哪些连续性；
-- 已运行当前批次的本地结构检查；需要内容 verdict 时作为单独请求交给 `$short-drama-review`；
-- 交付中没有媒体、远程执行任务或接口信息、远端 ID、私有对应表或“生成成功”声明。
+每个点名对象都有明确用途、可复制正文、参考边界和禁止项，且相互不矛盾，即完成。本次请求同时
+修改图片提示词与分镜时，当轮刷新受影响镜头的「图片提示词项」，不另建对账产物。实际生成必须
+转 `$short-drama-produce`，展示精确任务并取得显式确认；本技能不调用外部服务。
+五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
 
-## 投产交接
+## 安装维护
 
-用户要求把已接受规格真正生成图片时，交给 `$short-drama-produce`。传递准确的 prompt/spec、
-参考文件、数量、尺寸和目标路径；生产技能必须展示完整预览并取得本次任务的明确确认后才可
-调用外部 adapter。本技能本身仍只负责规格和提示词。
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

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

@@ -96,20 +96,19 @@ Variant prompt 不是完整身份重写。先复用 Character anchors，再突
 
 | 问题 | 分类 | 证据 |
 |---|---|---|
-| exact Character/Look 是否解析 | `structural_invariant` | 规格引用与接受快照 |
+| exact Character/Look 是否解析 | `structural_invariant` | `视觉设定.md` 的可见 ID 与当前变体 |
 | 是否只有一个连贯 Look | `reviewed_invariant` | Look 字段与 prompt 对应句 |
 | 是否保持区别性身份 | `reviewed_invariant` | Character anchors 与画面描述 |
 | 泛化美词是否挤压锚点 | `craft_default` | 指出可删词与缺失的可见事实 |
 | 中性姿态/背景是否适合 | `craft_default` | 用途与构图的关系 |
 | 表情强度、板式数量 | `taste_option` | 创作者/视觉方向 |
 
-最终必须产生一个结构化 spec 和一段无需资产库暗知识也能复制理解的通用 prompt；不产生图片。
+最终在 `图片提示词.md` 产生一个 `IMG-...` 人物板条目和一段无需资产库暗知识也能复制理解的正文；
+不产生图片。
 
 ## 6. 制作形态投影与模板槽位
 
-已接受的 `short-drama.json#/creator_authority/{visual_direction,production_profile}` 决定这张
-人物板用什么词汇画，不决定画的是谁。形态词表见
-本阶段需要从制作形态取得哪些输入，见 [阶段契约](stage-contract.md) 的“制作形态需要什么”。
+`视觉设定.md` 的项目视觉方向与已明确制作形态决定这张人物板用什么词汇画，不决定画的是谁。
 
 ### 从形态取什么
 
@@ -129,26 +128,26 @@ Variant prompt 不是完整身份重写。先复用 Character anchors，再突
 - 故事状态：伤势、湿污、包扎的因果与生效时间。
 
 形态改变的是**同一锚点走哪条表达通道**，不是锚点集合。若形态以剪影为主要识别通道，就要
-为已接受锚点找到剪影能承载的写法（发际形状→发型剪影缺口、旧伤→轮廓上的缺口、体态→肩背
-重心），而不是新增、替换或悄悄删掉锚点。找不到可靠通道时记 `creator_decision_needed`，退回
+为已确认锚点找到剪影能承载的写法（发际形状→发型剪影缺口、旧伤→轮廓上的缺口、体态→肩背
+重心），而不是新增、替换或悄悄删掉锚点。找不到可靠通道时标为“需创作者决定”，退回
 资产或创作者，不擅自换一个更好画的身份。
 
 ### 模板槽位不得覆盖身份锚点
 
-**`reviewed_invariant`**：模板槽位不得覆盖已接受的身份锚点；当模板默认值与已接受身份冲突时，
+**`reviewed_invariant`**：模板槽位不得覆盖已确认的身份锚点；当模板默认值与当前身份冲突时，
 **身份优先，模板让位**。
 
-合成例：角色甲的已接受身份是五十岁上下、体格厚重、肩背略沉。若人物板模板对每个角色机械
+合成例：角色甲的身份是五十岁上下、体格厚重、肩背略沉。若人物板模板对每个角色机械
 追加“九头身黄金比例、极度修长的双腿”，这条默认槽位就把角色甲改写成了另一个人，而且因为它
-出现在每张板上，下游会把它当成风格统一而不是错误。角色乙即使确实修长，也应由已接受的
+出现在每张板上，下游会把它当成风格统一而不是错误。角色乙即使确实修长，也应由当前
 Character 锚点写出，而不是由模板默认值代写。
 
 排查方式：把同一批人物板的提示词并排看，找出**逐字重复且与身份无关**的句子。重复出现的
-审美句若不能追溯到某个角色的接受快照，就是模板残留，删除或改写成该角色的真实锚点。
+审美句若不能追溯到某个角色的当前视觉设定，就是模板残留，删除或改写成该角色的真实锚点。
 
 | 检查 | 分类 | 证据 |
 |---|---|---|
 | 形态投影是否只落在词汇层 | `reviewed_invariant` | 形态卡字段与提示词对应句 |
 | 锚点是否在该形态下真的可见 | `reviewed_invariant` | 识别通道与所选锚点 |
-| 模板默认值是否覆盖身份 | `reviewed_invariant` | 跨角色重复句与接受快照 |
-| 形态未定时是否停在提问 | `structural_invariant` | `visual_direction` 状态为 `unset` |
+| 模板默认值是否覆盖身份 | `reviewed_invariant` | 跨角色重复句与当前视觉设定 |
+| 形态未定时是否停在提问 | `structural_invariant` | `视觉设定.md` 明确标为未决 |