@lemoncat7/dsh-partner 2.5.0 → 2.7.0

package/resources/skills/drama-production/upstream/skills/short-drama/scripts/selftest.py

@@ -0,0 +1,287 @@
+#!/usr/bin/env python3
+"""Offline self-test for the standalone project lifecycle."""
+
+from __future__ import annotations
+
+import json
+import tempfile
+import sys
+from collections.abc import Iterator
+from pathlib import Path
+from typing import Any, NamedTuple
+
+from project_tool import initialize_project, project_status, publish_candidate
+
+MINIMUM_PYTHON = (3, 9)
+if sys.version_info < MINIMUM_PYTHON:
+    raise SystemExit("selftest.py requires Python 3.9 or newer")
+
+SKILL_ROOT = Path(__file__).resolve().parent.parent
+EXAMPLE_RECORDS = (
+    "assets/creator-decision.example.jsonl",
+    "assets/production-observation.example.jsonl",
+    "assets/reference-observation.example.jsonl",
+)
+
+# ---------------------------------------------------------------------------
+# REFERENCE RESOLVER -- reference implementation.
+#
+# Each skill carries its own copy of this block. The suite has no shared
+# library on purpose: a skill must stay runnable after copying only its own
+# directory, so duplicating these few lines across skills is the correct shape.
+# Copy the block verbatim; do not import it.
+# ---------------------------------------------------------------------------
+
+SOURCES_RECORD_TYPE = "sources"
+SOURCES_SCHEMA_VERSION = "1.0.0"
+
+
+class ResolvedRef(NamedTuple):
+    """An upstream reference with its snapshot resolved, whichever form it used."""
+
+    owner: str
+    artifact: str
+    record_id: str | None
+    field: str | None
+    authority: str | None
+
+
+class RefFinding(NamedTuple):
+    """A structural defect in a reference object."""
+
+    code: str
+    location: str
+    detail: str
+
+
+def load_sources(document: Any) -> dict[str, dict[str, Any]]:
+    """Return the ``sources`` declaration of a parsed file, or ``{}`` if absent.
+
+    Accepts a parsed ``.json`` document (a dict) or the parsed record list of a
+    ``.jsonl`` file, whose declaration lives on the first record.
+    """
+    if isinstance(document, list):
+        document = document[0] if document else None
+    if not isinstance(document, dict):
+        return {}
+    declared = document.get("sources")
+    if not isinstance(declared, dict):
+        return {}
+    return {key: value for key, value in declared.items() if isinstance(value, dict)}
+
+
+def resolve_ref(
+    ref: Any, sources: dict[str, dict[str, Any]], location: str
+) -> tuple[ResolvedRef | None, RefFinding | None]:
+    """Resolve a reference object written in either the compact or expanded form."""
+    if not isinstance(ref, dict):
+        return None, RefFinding("REF_IS_NOT_AN_OBJECT", location, f"got {type(ref).__name__}")
+    src = ref.get("src")
+    if isinstance(src, str):
+        entry = sources.get(src)
+        if entry is None:
+            return None, RefFinding(
+                "REF_SRC_IS_NOT_DECLARED", location, f"src {src!r} has no sources entry"
+            )
+        owner, artifact = entry.get("owner"), entry.get("artifact")
+        if not (isinstance(owner, str) and isinstance(artifact, str)):
+            return None, RefFinding(
+                "SOURCE_ENTRY_IS_INCOMPLETE",
+                location,
+                f"sources[{src!r}] needs owner/artifact",
+            )
+    elif all(isinstance(ref.get(key), str) for key in ("owner", "artifact")):
+        owner, artifact = ref["owner"], ref["artifact"]
+    else:
+        return None, RefFinding(
+            "REF_HAS_NO_UPSTREAM_BINDING", location, "needs src, or owner+artifact"
+        )
+    optional = {
+        key: ref[key] for key in ("record_id", "field", "authority") if isinstance(ref.get(key), str)
+    }
+    return (
+        ResolvedRef(
+        owner,
+        artifact,
+            optional.get("record_id"),
+            optional.get("field"),
+            optional.get("authority"),
+        ),
+        None,
+    )
+
+
+# ---------------------------------------------------------------------------
+# END REFERENCE RESOLVER
+# ---------------------------------------------------------------------------
+
+# A reference lives under a slot named by convention. `target_locators` is the
+# creator-decision carrier that predates the suffix rule.
+REF_CARRIER_SUFFIXES = ("_ref", "_refs")
+EXTRA_REF_CARRIERS = ("target_locators",)
+
+
+def is_ref_carrier(key: str) -> bool:
+    return key.endswith(REF_CARRIER_SUFFIXES) or key in EXTRA_REF_CARRIERS
+
+
+def iter_refs(node: Any, location: str) -> Iterator[tuple[Any, str]]:
+    """Yield every reference object carried anywhere inside a record."""
+    if isinstance(node, list):
+        for index, item in enumerate(node):
+            yield from iter_refs(item, f"{location}[{index}]")
+        return
+    if not isinstance(node, dict):
+        return
+    for key, value in node.items():
+        where = f"{location}/{key}"
+        if is_ref_carrier(key) and value is not None:
+            if isinstance(value, list):
+                for index, ref in enumerate(value):
+                    yield ref, f"{where}[{index}]"
+            else:
+                yield value, where
+            continue
+        yield from iter_refs(value, where)
+
+
+def read_records(path: Path) -> list[Any]:
+    return [
+        json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()
+    ]
+
+
+def check_records(records: list[Any], name: str) -> tuple[int, list[RefFinding]]:
+    """Resolve every reference in a .jsonl file through its own declaration."""
+    sources = load_sources(records)
+    resolved = 0
+    findings: list[RefFinding] = []
+    for number, record in enumerate(records, 1):
+        if isinstance(record, dict) and record.get("record_type") == SOURCES_RECORD_TYPE:
+            continue
+        for ref, where in iter_refs(record, f"{name}:{number}"):
+            found, finding = resolve_ref(ref, sources, where)
+            if finding is not None:
+                findings.append(finding)
+            if found is not None:
+                resolved += 1
+    return resolved, findings
+
+
+CHECKS = 0
+
+
+def require(condition: bool, message: str) -> None:
+    global CHECKS
+    if not condition:
+        raise AssertionError(message)
+    CHECKS += 1
+
+
+def main() -> int:
+    for relative in EXAMPLE_RECORDS:
+        path = SKILL_ROOT / relative
+        records = read_records(path)
+        declared = load_sources(records)
+        require(bool(declared), f"{relative} declares its upstream snapshots")
+        resolved, findings = check_records(records, path.name)
+        require(not findings, f"{relative} reference findings: {findings}")
+        require(resolved > 0, f"{relative} carries at least one resolvable reference")
+
+    sources = {"screenplay": {"owner": "short-drama-write", "artifact": "a.md", "hash": "0" * 64}}
+    _, undeclared = resolve_ref({"src": "missing", "record_id": "BLK-1"}, sources, "synthetic")
+    require(
+        undeclared is not None and undeclared.code == "REF_SRC_IS_NOT_DECLARED",
+        "a src without a sources entry is a structural finding",
+    )
+    _, unbound = resolve_ref({"record_id": "BLK-1"}, sources, "synthetic")
+    require(
+        unbound is not None and unbound.code == "REF_HAS_NO_UPSTREAM_BINDING",
+        "a reference binding neither way is a structural finding",
+    )
+    expanded, finding = resolve_ref(
+        {
+            "owner": "short-drama-write",
+            "artifact": "剧集/EP001/screenplay-index.jsonl",
+            "hash": "a" * 64,
+            "record_id": "BLK-EP001-SC001-A01",
+        },
+        {},
+        "synthetic",
+    )
+    require(
+        finding is None and expanded is not None and expanded.record_id == "BLK-EP001-SC001-A01",
+        "a project written before the declaration still resolves",
+    )
+
+    with tempfile.TemporaryDirectory() as directory:
+        root = Path(directory) / "project"
+        created = initialize_project(
+            root,
+            title="Self-test",
+            language="zh-CN",
+            prompt_language="en",
+            aspect_ratio="9:16",
+        )
+        require(created["project"]["title"] == "Self-test", "project title")
+        require(
+            project_status(root)["project_id"] == created["project"]["project_id"],
+            "project discovery",
+        )
+
+        published = publish_candidate(
+            root,
+            owner="selftest",
+            artifact_id="SELFTEST-001",
+            outputs={"剧集/EP001/screenplay.md": "# EP001\n"},
+        )
+        require(published["state"] == "needs_confirmation", "publication state")
+
+        header = json.dumps(
+            {
+                "record_type": SOURCES_RECORD_TYPE,
+                "schema_version": SOURCES_SCHEMA_VERSION,
+                "sources": {
+                    "screenplay": {
+                        "owner": "short-drama-write",
+                        "artifact": "剧集/EP001/screenplay.md",
+                        "hash": "a" * 64,
+                    }
+                },
+            },
+            ensure_ascii=False,
+        )
+        record = json.dumps(
+            {"shot_id": "SHOT-001", "source_ref": {"src": "screenplay", "record_id": "BLK-1"}},
+            ensure_ascii=False,
+        )
+        declared_publication = publish_candidate(
+            root,
+            owner="selftest",
+            artifact_id="SELFTEST-002",
+            outputs={"剧集/EP001/storyboard/shots.jsonl": f"{header}\n{record}\n"},
+        )
+        require(
+            declared_publication["state"] == "needs_confirmation",
+            "a file declaring its upstream snapshots publishes",
+        )
+
+        try:
+            publish_candidate(
+                root,
+                owner="selftest",
+                artifact_id="SELFTEST-UNSAFE",
+                outputs={"../escape.md": "unsafe"},
+            )
+        except ValueError:
+            rejected = True
+        else:
+            rejected = False
+        require(rejected, "unsafe publication path was accepted")
+
+    print(f"{CHECKS} self-tests passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/resources/skills/drama-production/upstream/skills/short-drama-assets/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: short-drama-assets
+description: 从短剧剧本拆出人物/造型、地点/视图、道具/状态和跨场连续性，写成创作者可读的视觉设定。用户说“拆角色/场景/道具”“做资产设定”“判断复用还是新变体”“更新造型/道具状态”，或拿现成剧本直接做视觉资产准备时使用；不写图片提示词，不生成媒体。
+license: MIT
+---
+
+# 短剧资产拆解
+
+把剧本文字变成可复用、可持续的视觉事实，统一写入 `剧集/<EP>/视觉设定.md`。不要把每次出场都
+变成新资产，也不要抢写剧本语义、镜头走位或生成提示词。
+
+## Quick Start
+
+```text
+用 $short-drama-assets 从 EP001 剧本拆完人物、造型、地点、道具和本集状态
+```
+
+## 入口与边界
+
+现成剧本可以直接拆资产。先区分：
+
+- **身份**：换一个就不再是同一个人、地或物；
+- **变体**：身份不变，但服装、伤势、时段、天气、开合或持有状态改变；
+- **镜头瞬态**：姿势、视线、左右手、站位和相机角度，由分镜拥有；
+- **故事语义**：知识、目标、关系和情绪由写作/开发拥有，只引用可见后果。
+
+## 工作流
+
+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/resources/skills/drama-production/upstream/skills/short-drama-assets/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "短剧资产拆解"
+  short_description: "从剧本拆解角色场景道具、身份变体、状态变化与跨场连续性"
+  default_prompt: "使用 $short-drama-assets 从已接受剧本拆解并核对角色、场景、道具、变体和连续性。"

package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/character-look.example.jsonl

@@ -0,0 +1,3 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"guhe-audition-02":{"owner":"creator","artifact":"输入/voice-refs/guhe-audition-02.wav"},"reference-observations":{"owner":"creator","artifact":"创作者决策/reference-observations.jsonl"},"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP003/screenplay-index.jsonl"},"cd-char-001":{"owner":"creator","artifact":"创作者决策/cd-char-001.json"},"characters":{"owner":"short-drama-assets","artifact":"设定集/characters.jsonl"},"cd-look-001":{"owner":"creator","artifact":"创作者决策/cd-look-001.json"}}}
+{"example_only":true,"destination":"设定集/characters.jsonl","schema_version":"1.0.0-draft","record_type":"character","character_id":"CHAR-GUHE","display_name":"顾禾","aliases":["小顾"],"identity_anchors":["窄长脸","左眉尾短缺口","自然卷黑发","肩背略前倾"],"persistent_performance_facts":["说话前常先观察对方手里的物件"],"voice_direction":{"language":"zh-CN","reference":{"slot_id":"VREF-GUHE-01","artifact_ref":{"src":"guhe-audition-02"},"role":"timbre","may_control":["音色质感","年龄与体量印象"],"must_not_control":["这条试音稿里的克制情绪","录音棚的混响与话筒距离","背景底噪"],"admission_status":"creator_described","reference_observation_ref":{"src":"reference-observations","record_id":"OBS-VREF-GUHE-01"},"unresolved_risks":[]},"selection_criteria":[{"kind":"register","text":"中低音区，比同剧其他成年男性低半档","counter_example":"低到需要压喉才发得出，就过头了"},{"kind":"rhythm","text":"句尾常收住而不拖长","counter_example":"每句都硬切断，听起来像念稿"}],"distinction":{"nearest_character_id":"CHAR-LINSHU","distinguishing_trait":"顾禾句尾收住；林舒句尾常带一段下滑的余音"},"pronunciation_notes":[{"term":"顾禾","accepted_reading":"Gù Hé"}],"not_voice_identity":["本场因淋雨造成的短暂气息不稳","某句台词的临时音量"]},"not_identity":["本集橙色雨衣","右肩湿痕","瞬时低头"],"source_refs":[{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A01"}],"creator_acceptance":{"status":"accepted","decision_ref":{"src":"cd-char-001","record_id":"CD-CHAR-001"}}}
+{"example_only":true,"destination":"设定集/looks.jsonl","schema_version":"1.0.0-draft","record_type":"look","look_id":"LOOK-GUHE-RAIN","character_ref":{"src":"characters","record_id":"CHAR-GUHE"},"base_look_id":"LOOK-GUHE-WORK","differences":{"wardrobe_layers":["工作装外加橙色旧雨衣"],"hair_styling":["低束，兜帽放下"],"makeup":[],"injury":[],"weathering":[]},"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A01"},"validity":{"from":"EP003/SC004/BLK-EP003-SC004-A01","until":"EP003/SC006/BLK-EP003-SC006-A03"},"creator_acceptance":{"status":"accepted","decision_ref":{"src":"cd-look-001","record_id":"CD-LOOK-001"}}}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/continuity.example.jsonl

@@ -0,0 +1,4 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"props":{"owner":"short-drama-assets","artifact":"设定集/props.jsonl"},"prop-states":{"owner":"short-drama-assets","artifact":"设定集/prop-states.jsonl"},"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP003/screenplay-index.jsonl"},"locations":{"owner":"short-drama-assets","artifact":"设定集/locations.jsonl"}}}
+{"example_only":true,"schema_version":"1.0.0-draft","delta_id":"DELTA-TIN-OPEN","episode_id":"EP003","scene_id":"SC004","subject_ref":{"src":"props","record_id":"PROP-TIN-CASE"},"state_field":"condition.open","before":{"value":"closed","state_ref":{"src":"prop-states","record_id":"PSTATE-TIN-CLOSED-BADGE-IN"}},"after":{"value":"open","proposed_state_id":"PSTATE-TIN-OPEN-EMPTY"},"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A03"},"effective_range":{"from":"EP003/SC004/BLK-EP003-SC004-A03","until":"open_ended"},"reconciliation":{"next_linked_start":"EP003/SC005/start","status":"must_match_or_revise"},"creator_acceptance":{"status":"proposed","decision_ref":null},"affected_binding_refs":[{"src":"props","record_id":"PROP-TIN-CASE"}],"affected_binding_locators":[{"owner":"short-drama-storyboard","artifact":"剧集/EP003/storyboard/shots.jsonl","selector":{"asset_or_variant_ids":["PROP-TIN-CASE","PROP-CERAMIC-BADGE-017"]},"status":"future_until_shots_exist"}],"destination":"剧集/EP003/assets/continuity.jsonl"}
+{"example_only":true,"schema_version":"1.0.0-draft","delta_id":"DELTA-BADGE-TRANSFER","episode_id":"EP003","scene_id":"SC004","subject_ref":{"src":"props","record_id":"PROP-CERAMIC-BADGE-017"},"state_field":"custody","before":{"owner":"CHAR-GUHE","holder":"CHAR-GUHE","hand":"right"},"after":{"owner":"CHAR-WEISHU","holder":"CHAR-WEISHU","hand":"right"},"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A04"},"effective_range":{"from":"EP003/SC004/BLK-EP003-SC004-A04","until":"open_ended"},"reconciliation":{"next_linked_start":"EP003/SC005/start","status":"must_match_or_revise"},"creator_acceptance":{"status":"proposed","decision_ref":null},"affected_binding_refs":[{"src":"props","record_id":"PROP-CERAMIC-BADGE-017"}],"affected_binding_locators":[{"owner":"short-drama-storyboard","artifact":"剧集/EP003/storyboard/shots.jsonl","selector":{"asset_or_variant_ids":["PROP-CERAMIC-BADGE-017","CHAR-GUHE","CHAR-WEISHU"]},"status":"future_until_shots_exist"}],"destination":"剧集/EP003/assets/continuity.jsonl"}
+{"example_only":true,"schema_version":"1.0.0-draft","delta_id":"DELTA-OFFICE-BLACKOUT","episode_id":"EP003","scene_id":"SC004","subject_ref":{"src":"locations","record_id":"LOC-FERRY-OFFICE"},"state_field":"active_view","before":{"value":"VIEW-FERRY-OFFICE-NORTH-NIGHT"},"after":{"value":"VIEW-FERRY-OFFICE-NORTH-BLACKOUT"},"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A04"},"effective_range":{"from":"EP003/SC004/BLK-EP003-SC004-A04","until":"open_ended"},"reconciliation":{"next_linked_start":"EP003/SC005/start","status":"must_match_or_revise"},"creator_acceptance":{"status":"proposed","decision_ref":null},"affected_binding_refs":[{"src":"locations","record_id":"LOC-FERRY-OFFICE"}],"affected_binding_locators":[{"owner":"short-drama-storyboard","artifact":"剧集/EP003/storyboard/shots.jsonl","selector":{"asset_or_variant_ids":["LOC-FERRY-OFFICE","VIEW-FERRY-OFFICE-NORTH-BLACKOUT"]},"status":"future_until_shots_exist"}],"destination":"剧集/EP003/assets/continuity.jsonl"}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/decisions.example.jsonl

@@ -0,0 +1,5 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"occurrences":{"owner":"short-drama-assets","artifact":"剧集/EP003/assets/occurrences.jsonl"},"characters":{"owner":"short-drama-assets","artifact":"设定集/characters.jsonl"},"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP003/screenplay-index.jsonl"},"location-views":{"owner":"short-drama-assets","artifact":"设定集/location-views.jsonl"}}}
+{"example_only":true,"schema_version":"1.0.0-draft","decision_id":"DEC-OCC-001","occurrence_refs":[{"src":"occurrences","record_id":"OCC-EP003-SC004-001","authority":"candidate"}],"decision_kind":"new_variant","asset_kind":"character","proposed_binding":{"identity_id":"CHAR-GUHE","variant_id":"LOOK-GUHE-RAIN"},"base_ref":{"src":"characters","record_id":"CHAR-GUHE"},"persistent_evidence":["剧本沿用顾禾的身份和关系","已有永久识别锚点未改变"],"differences":["在工作装外加橙色旧雨衣","兜帽放下"],"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A01"},"validity":{"from":"EP003/SC004/BLK-EP003-SC004-A01","until":"EP003/SC006/BLK-EP003-SC006-A03"},"rationale":"人物持续身份不变；跨场服装需要精确绑定","creator_acceptance":{"status":"proposed","decision_ref":null},"downstream_impact":["character_image_prompt","affected_storyboard_bindings"],"destination":"剧集/EP003/assets/decisions.jsonl"}
+{"example_only":true,"schema_version":"1.0.0-draft","decision_id":"DEC-OCC-002","occurrence_refs":[{"src":"occurrences","record_id":"OCC-EP003-SC004-002","authority":"candidate"}],"decision_kind":"reuse","asset_kind":"location","proposed_binding":{"identity_id":"LOC-FERRY-OFFICE","variant_id":"VIEW-FERRY-OFFICE-NORTH-NIGHT"},"base_ref":{"src":"location-views","record_id":"VIEW-FERRY-OFFICE-NORTH-NIGHT"},"persistent_evidence":["北门、河窗和柜台的地理与已有 View 一致"],"differences":[],"cause_ref":null,"validity":{"from":"EP003/SC004","until":"EP003/SC004/BLK-EP003-SC004-A04"},"rationale":"同一空间、同一可复用方向与正常夜间光态","creator_acceptance":{"status":"proposed","decision_ref":null},"downstream_impact":["affected_storyboard_bindings"],"destination":"剧集/EP003/assets/decisions.jsonl"}
+{"example_only":true,"schema_version":"1.0.0-draft","decision_id":"DEC-OCC-003","occurrence_refs":[{"src":"occurrences","record_id":"OCC-EP003-SC004-003","authority":"candidate"}],"decision_kind":"new_asset","asset_kind":"prop","proposed_binding":{"identity_id":"PROP-TIN-CASE","variant_id":"PSTATE-TIN-CLOSED-BADGE-IN"},"base_ref":null,"persistent_evidence":["扁长黑铁匣","铰链盖","右前角永久凹陷","用于保存号牌"],"differences":[],"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A02"},"validity":{"from":"EP003/SC004","until":"open_ended"},"rationale":"现有 设定集 无同时匹配形制、唯一凹陷和叙事功能的 Prop","creator_acceptance":{"status":"proposed","decision_ref":null},"downstream_impact":["prop_image_prompt","affected_storyboard_bindings","continuity"],"destination":"剧集/EP003/assets/decisions.jsonl"}
+{"example_only":true,"schema_version":"1.0.0-draft","decision_id":"DEC-OCC-004","occurrence_refs":[{"src":"occurrences","record_id":"OCC-EP003-SC004-004","authority":"candidate"}],"decision_kind":"unresolved","asset_kind":"character","proposed_binding":null,"candidate_bindings":[{"identity_id":"CHAR-GUHE","support":"此前顾禾靠近北门","conflict":"最近动作主语已切换"},{"identity_id":"CHAR-WEISHU","support":"最近一句台词属于魏叔","conflict":"未写他走向北门"}],"persistent_evidence":[],"differences":[],"cause_ref":null,"validity":null,"rationale":"代词没有唯一先行项；不得以距离或最近姓名猜测","creator_question":"从北门离开的‘她’具体是谁？若为新人物，请补可识别称谓。","creator_acceptance":{"status":"pending_choice","decision_ref":null},"downstream_impact":["blocks_character_binding","blocks_dependent_storyboard"],"destination":"剧集/EP003/assets/decisions.jsonl"}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/location-view.example.jsonl

@@ -0,0 +1,3 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP003/screenplay-index.jsonl"},"cd-loc-001":{"owner":"creator","artifact":"创作者决策/cd-loc-001.json"},"locations":{"owner":"short-drama-assets","artifact":"设定集/locations.jsonl"},"cd-view-001":{"owner":"creator","artifact":"创作者决策/cd-view-001.json"}}}
+{"example_only":true,"destination":"设定集/locations.jsonl","schema_version":"1.0.0-draft","record_type":"location","location_id":"LOC-FERRY-OFFICE","display_name":"旧渡站值班室","spatial_identity":{"shape":"狭长室内","zones":["柜台内工作区","柜台外等候区"],"entrances":[{"id":"north_door","connects_to":"LOC-FERRY-HALL"}],"fixed_anchors":["东侧河窗","西侧整面旧柜台","柜台后墙配电箱"],"materials":["磨损木柜台","灰白粉刷墙","旧金属窗框"]},"not_identity":["夜间","停电","顾禾站在北门","低机位"],"source_refs":[{"src":"screenplay-index","record_id":"BLK-EP003-SC004-H01"}],"creator_acceptance":{"status":"accepted","decision_ref":{"src":"cd-loc-001","record_id":"CD-LOC-001"}}}
+{"example_only":true,"destination":"设定集/location-views.jsonl","schema_version":"1.0.0-draft","record_type":"location_view","view_id":"VIEW-FERRY-OFFICE-NORTH-BLACKOUT","location_ref":{"src":"locations","record_id":"LOC-FERRY-OFFICE"},"base_view_id":"VIEW-FERRY-OFFICE-NORTH-NIGHT","orientation":{"from_zone":"柜台内工作区","toward":"北门","visible_fixed_anchors":["北门","东侧河窗","柜台后墙配电箱"]},"state_differences":{"dressing":[],"time":"night","weather":"heavy_rain_outside","light":["顶灯熄灭","河窗冷光保留"]},"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A04"},"validity":{"from":"EP003/SC004/BLK-EP003-SC004-A04","until":"open_ended"},"creator_acceptance":{"status":"accepted","decision_ref":{"src":"cd-view-001","record_id":"CD-VIEW-001"}}}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/occurrences.example.jsonl

@@ -0,0 +1,5 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP003/screenplay-index.jsonl"}}}
+{"example_only":true,"schema_version":"1.0.0-draft","occurrence_id":"OCC-EP003-SC004-001","episode_id":"EP003","scene_id":"SC004","asset_kind":"character","surface_form":"顾禾","presence":"on_screen","source_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A01"},"source_blocks":["BLK-EP003-SC004-A01"],"extracted_projection":{"role":"derived_projection","visible_facts":["外穿橙色旧雨衣","兜帽放下"],"explicit_state":{"look_hint":"rain_shell","wetness":"dry_at_entry"}},"story_function":["enters_location","carries_case"],"production_disposition":"visual_asset_required","proposed_binding":{"character_id":"CHAR-GUHE","look_id":"LOOK-GUHE-RAIN"},"reconciliation":{"role":"derived_annotation","decision_locator":{"owner":"short-drama-assets","artifact":"剧集/EP003/assets/decisions.jsonl","selector":{"occurrence_id":"OCC-EP003-SC004-001"},"status":"future_until_decision_exists"},"status":"proposed"},"continuity_delta_ref":null,"destination":"剧集/EP003/assets/occurrences.jsonl"}
+{"example_only":true,"schema_version":"1.0.0-draft","occurrence_id":"OCC-EP003-SC004-002","episode_id":"EP003","scene_id":"SC004","asset_kind":"location","surface_form":"旧渡站值班室","presence":"on_screen","source_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-H01"},"source_blocks":["BLK-EP003-SC004-H01","BLK-EP003-SC004-A01"],"extracted_projection":{"role":"derived_projection","visible_facts":["北门通向候船厅","东侧河窗","夜间顶灯亮"],"explicit_state":{"time":"night","light":"ceiling_light_on"}},"story_function":["action_space","later_blackout_setup"],"production_disposition":"visual_asset_required","proposed_binding":{"location_id":"LOC-FERRY-OFFICE","view_id":"VIEW-FERRY-OFFICE-NORTH-NIGHT"},"reconciliation":{"role":"derived_annotation","decision_locator":{"owner":"short-drama-assets","artifact":"剧集/EP003/assets/decisions.jsonl","selector":{"occurrence_id":"OCC-EP003-SC004-002"},"status":"future_until_decision_exists"},"status":"proposed"},"continuity_delta_ref":null,"destination":"剧集/EP003/assets/occurrences.jsonl"}
+{"example_only":true,"schema_version":"1.0.0-draft","occurrence_id":"OCC-EP003-SC004-003","episode_id":"EP003","scene_id":"SC004","asset_kind":"prop","surface_form":"铁皮匣","presence":"on_screen","source_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A02"},"source_blocks":["BLK-EP003-SC004-A02"],"extracted_projection":{"role":"derived_projection","visible_facts":["顾禾将匣放上柜台","匣起初闭合"],"explicit_state":{"condition":"closed","holder":"CHAR-GUHE","location":"counter"}},"story_function":["contains_reveal_object","supports_readable_text_reveal"],"production_disposition":"hero_prop_required","proposed_binding":{"prop_id":"PROP-TIN-CASE","state_id":"PSTATE-TIN-CLOSED-BADGE-IN"},"reconciliation":{"role":"derived_annotation","decision_locator":{"owner":"short-drama-assets","artifact":"剧集/EP003/assets/decisions.jsonl","selector":{"occurrence_id":"OCC-EP003-SC004-003"},"status":"future_until_decision_exists"},"status":"proposed"},"destination":"剧集/EP003/assets/occurrences.jsonl","continuity_delta_locator":{"owner":"short-drama-assets","artifact":"剧集/EP003/assets/continuity.jsonl","selector":{"source_occurrence_id":"OCC-EP003-SC004-003"},"status":"future_until_delta_exists"}}
+{"example_only":true,"schema_version":"1.0.0-draft","occurrence_id":"OCC-EP003-SC004-004","episode_id":"EP003","scene_id":"SC004","asset_kind":"character","surface_form":"她","presence":"on_screen","source_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A05"},"source_blocks":["BLK-EP003-SC004-A05"],"extracted_projection":{"role":"derived_projection","visible_facts":["从北门离开"],"explicit_state":{}},"story_function":["exits_with_unknown_identity"],"production_disposition":"identity_resolution_required","proposed_binding":null,"candidate_bindings":["CHAR-GUHE","CHAR-WEISHU"],"ambiguity":"block 内无唯一先行项，两个已出场角色均可能","reconciliation":{"role":"derived_annotation","decision_locator":{"owner":"short-drama-assets","artifact":"剧集/EP003/assets/decisions.jsonl","selector":{"occurrence_id":"OCC-EP003-SC004-004"},"status":"future_until_decision_exists"},"status":"unresolved"},"continuity_delta_ref":null,"destination":"剧集/EP003/assets/occurrences.jsonl"}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/prop-state.example.jsonl

@@ -0,0 +1,3 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP003/screenplay-index.jsonl"},"cd-prop-001":{"owner":"creator","artifact":"创作者决策/cd-prop-001.json"},"props":{"owner":"short-drama-assets","artifact":"设定集/props.jsonl"},"cd-pstate-001":{"owner":"creator","artifact":"创作者决策/cd-pstate-001.json"}}}
+{"example_only":true,"destination":"设定集/props.jsonl","schema_version":"1.0.0-draft","record_type":"prop","prop_id":"PROP-TIN-CASE","display_name":"黑铁皮匣","identity_anchors":{"scale":"手掌至小臂长度的扁长匣","form":"铰链盖，长方体，右前角凹陷","materials":["黑色旧铁皮"],"function":"保存渡站号牌","permanent_marks":["右前角永久凹陷"]},"text_policy":{"mode":"exact_readable","text":"潮位 7","placement":"匣盖内侧","source_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A03"}},"source_refs":[{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A02"}],"creator_acceptance":{"status":"accepted","decision_ref":{"src":"cd-prop-001","record_id":"CD-PROP-001"}}}
+{"example_only":true,"destination":"设定集/prop-states.jsonl","schema_version":"1.0.0-draft","record_type":"prop_state","state_id":"PSTATE-TIN-CLOSED-BADGE-IN","prop_ref":{"src":"props","record_id":"PROP-TIN-CASE"},"condition":{"open":"closed","damage":"right_front_dent_only","powered":"not_applicable"},"custody":{"owner":"CHAR-GUHE","holder":"CHAR-GUHE","hand":null,"location":"under_ferry_office_counter"},"contents":["PROP-CERAMIC-BADGE-017"],"text_visibility":"hidden_while_closed","validity":{"from":"EP003/SC004/start","until":"EP003/SC004/BLK-EP003-SC004-A03"},"cause_ref":{"src":"screenplay-index","record_id":"BLK-EP003-SC004-A02"},"creator_acceptance":{"status":"accepted","decision_ref":{"src":"cd-pstate-001","record_id":"CD-PSTATE-001"}}}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/characters.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"input-script":{"owner":"creator","artifact":"input-script.md"},"decisions":{"owner":"creator","artifact":"decisions.json"}}}
+{"schema_version":"1.0.0-draft","record_type":"character","character_id":"CHAR-LIN","display_name":"林岚","aliases":[],"identity_anchors":["齐下颌黑发","左眉尾浅疤","站立时重心偏右"],"persistent_performance_facts":["回答前先看向出口"],"not_identity":["本场湿外套"],"source_refs":[{"src":"input-script","record_id":"SC001-A01"}],"creator_acceptance":{"status":"accepted","decision_ref":{"src":"decisions","record_id":"CD-CHAR-LIN"}}}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/looks.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"characters":{"owner":"short-drama-assets","artifact":"characters.jsonl"},"input-script":{"owner":"creator","artifact":"input-script.md"},"decisions":{"owner":"creator","artifact":"decisions.json"}}}
+{"schema_version":"1.0.0-draft","record_type":"look","look_id":"LOOK-LIN-RAIN","character_ref":{"src":"characters","record_id":"CHAR-LIN"},"base_look_id":"LOOK-LIN-BASE","differences":{"wardrobe_layers":["深蓝旧雨衣"],"weathering":["肩部雨水加深"]},"cause_ref":{"src":"input-script","record_id":"SC001-A01"},"validity":{"from":"SC001/A01","until":"SC002/end"},"creator_acceptance":{"status":"accepted","decision_ref":{"src":"decisions","record_id":"CD-LOOK-LIN-RAIN"}}}

package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/asset-review-checklist.md

@@ -0,0 +1,82 @@
+# 资产拆解审查清单
+
+## Binding gate (`AST-05`)
+
+资产设定完成前，每个下游引用都要解析到明确的身份条目，且变体必须在引用的剧情范围内有效。
+未解决的出现项继续保持未决；不得为了让提示词或分镜继续工作，猜一个看似合理的 ID。
+
+按“机械事实 → 语义判断 → 创作者接受”顺序检查。Owner 可按 finding 修订；修订动作本身
+不等于审查 verdict。需要 verdict 时另起一次审查动作，自检也可以如实记录有证据支持的结论。
+
+## A. 机械检查（`structural_invariant`）
+
+- [ ] 每个制作相关的剧本段都有资产处理结果，或明确说明本段没有资产变化。
+- [ ] 每个结果都指向可见场景 ID，并能从当前 `剧本.md` 找到依据。
+- [ ] 来源位置、剧本明示事实、资产判断与连续性变化没有混写。
+- [ ] 每个出现项恰为复用、新变体、新身份或未决之一。
+- [ ] 新变体写清基底、变化、原因、生效位置与结束位置；没有明确终点时标为持续。
+- [ ] ID 唯一；所有已接受 binding 精确解析到 Character+Look、Location+View 或
+  Prop+State。
+- [ ] 未决项没有伪造成已确认身份，不能流入图片提示词或分镜。
+- [ ] 每条变化有前态、后态、原因/来源、生效范围和受影响的可见 ID。
+- [ ] linked outgoing/incoming 状态一致，或有明确待处理 reconciliation。
+- [ ] 可读文字政策完整；`exact_readable` 不与 `no_readable_text` 冲突。
+
+机械失败指出具体文件、标题 ID、owner 和修复方向，不回显整段创作文本。
+
+## B. 语义审查（`reviewed_invariant`）
+
+逐条引用剧本/设定集 证据回答：
+
+- [ ] 含混代词、匿名人、同款多件物没有被猜成某个已有 ID。
+- [ ] Character 身份锚点与服装、伤势、湿污、姿势等临时状态分离。
+- [ ] Location 地理/固定锚点没有因角度、时段、天气、灯光被复制成新地点。
+- [ ] Prop 形制/功能身份没有因 owner、开合、破损、内容或文字状态被复制。
+- [ ] 每个新 asset 有不能复用的持久证据；每个 variant 说明 base 什么保持不变。
+- [ ] 提取没有凭空补脸、品牌、门窗、内容物、伤势、灯光或可读文字。
+- [ ] transfer、伤势、换装、停电、天气/光态和知识变化都有足以支持的剧情原因。
+- [ ] occurrence 的 production disposition 合理：提及不被误当出镜，关键操作物不被
+  降成普通布景。
+
+Reviewer finding 应含文件与标题 ID、证据、影响、修订结果、owner、严重程度和状态；不能只说
+“资产不够细”或“看起来 AI”。
+
+## C. Craft 默认（可覆盖，不单独阻断）
+
+- [ ] 身份未变时优先复用或 variant，没有追求“一场一资产”。
+- [ ] 瞬时 pose/camera/framing 留给 storyboard，没有制造 Look/View/State 爆炸。
+- [ ] 设定集 只保留识别、复用、prompt、镜头和连续性所需事实。
+- [ ] Location 先有地理/入口/固定锚点，再有氛围；Prop 有尺度/形制/材料/功能；
+  Character 有可观察的区分锚点。
+- [ ] outgoing 精简但足以让下一场/集无脑内补全地继续。
+
+Creator 可用制作原因覆盖，例如需要逐件审批背景陈设；记录 override，而非改成硬规则。
+
+## D. Taste 选项（只确认选择）
+
+- [ ] 群演按 group 还是个体管理已选择。
+- [ ] 同建筑空间拆分颗粒度能支持当前制作。
+- [ ] 蒙太奇/梦境/主观断裂已声明边界。
+- [ ] 临时可见状态用 delta 还是升为 variant 符合本项目复用策略。
+
+不得仅因 reviewer 偏好另一个选项而判失败。
+
+## E. 创作者确认
+
+给创作者看的摘要必须列出：
+
+1. 复用项及匹配证据；
+2. 新 variant 及 base/difference/cause/validity；
+3. 新 asset 及持久区分证据；
+4. unresolved 的原文证据、候选和不同选择的下游影响；
+5. continuity deltas 与跨集 outgoing；
+6. 确认后需要同步更新的下游文件。
+
+把创作者确认的结果直接写进 `视觉设定.md`，未确认选择保留为“未决”并说明影响。创作者确认不等于
+结构检查通过、审查通过或可以投产；这些动作各自独立发生。
+
+## 当前范围完成判据
+
+本次范围内结构检查通过、每个出现项已决定、没有未决引用、连续性可交接，且创作者已确认需要选择的
+新增/复用/变体/变化，即完成当前资产批次。审查与交付是后续独立动作，
+不作为图片提示词或 storyboard 这两个并列分支的隐式前置门槛。