@oh-story/dsh 0.1.0

package/lib/drama/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/lib/drama/skills/short-drama-assets/SKILL.md

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

package/lib/drama/skills/short-drama-assets/agents/openai.yaml

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

package/lib/drama/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/lib/drama/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/lib/drama/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/lib/drama/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/lib/drama/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/lib/drama/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/lib/drama/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/lib/drama/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"}}}