@oh-story/dsh 0.1.17 → 0.1.19

package/lib/types/workspace-route.d.ts

@@ -15,6 +15,12 @@ export declare function parseByteRange(value: string | undefined, size: number):
 export declare function assertCreativePath(path: string, kind: "text" | "media"): void;
 export declare function mediaMimeTypeForPath(path: string): string | undefined;
 export declare function gameRoot(path: string): boolean;
+/**
+ * The game's name from its brief's first heading, e.g. `# PRODUCT_BRIEF — 《雪夜渡》` → `雪夜渡`.
+ * The Studio adds its own 书名号 and separators, so neither the file label nor the work's
+ * 书名号 belong in the name.
+ */
+export declare function gameProjectTitle(content: string | undefined, fallback: string): string;
 /**
  * Emitted for EVERY preview response, not just HTML. previewContentType serves .svg as
  * image/svg+xml — an active document type — so a game that self-navigates its frame to a scripted

package/lib/types/workspace-route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-route.d.ts","sourceRoot":"","sources":["../../src/workspace-route.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAuCnD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AA8HD,MAAM,WAAW,SAAS;IAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAE3E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAcpG;AAwGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAW7E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAoHD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ9C;AAmMD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBnE;AA2JD,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAM7F"}
+{"version":3,"file":"workspace-route.d.ts","sourceRoot":"","sources":["../../src/workspace-route.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAuCnD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AA8HD,MAAM,WAAW,SAAS;IAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAE3E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAcpG;AAwGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAW7E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAoHD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ9C;AAsED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAStF;AA0HD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBnE;AA2JD,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAM7F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oh-story/dsh",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "A DSH plugin for fiction, short-drama, interactive-game, and video-recap production",
   "keywords": [
     "deepseek-harness",
@@ -98,26 +98,26 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.5",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-chat": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-tool": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-fs": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-skill": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-typert-registry": "0.2.1-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-store": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-tool": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-fs": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-skill": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-subagent": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-util-values": "0.2.1-rc.4",
     "@deepseek-ai/schemastery": "3.18.5",
     "@types/react": "18.3.28",
     "@types/react-dom": "18.3.7",

package/lib/drama/skills/short-drama-assets/assets/character-look.example.jsonl

@@ -1,3 +0,0 @@
-{"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

@@ -1,4 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-{"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

@@ -1,2 +0,0 @@
-{"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

@@ -1,2 +0,0 @@
-{"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/lib/drama/skills/short-drama-assets/scripts/asset_check.py

@@ -1,267 +0,0 @@
-#!/usr/bin/env python3
-"""Validate the structural core of standalone character and look records."""
-
-from __future__ import annotations
-
-import argparse
-import json
-import re
-import sys
-from pathlib import Path
-from typing import Any, NamedTuple
-
-MINIMUM_PYTHON = (3, 9)
-if sys.version_info < MINIMUM_PYTHON:
-    raise SystemExit("asset_check.py requires Python 3.9 or newer")
-
-SKILL_ROOT = Path(__file__).resolve().parents[1]
-HASH_RE = re.compile(r"[0-9a-f]{64}")
-ACCEPTANCE_STATUSES = {"accepted", "proposed", "pending_choice"}
-
-
-# ---------------------------------------------------------------------------
-# REFERENCE RESOLVER -- reference implementation.
-#
-# Each skill checker 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
-# ---------------------------------------------------------------------------
-
-
-class ValidationError(ValueError):
-    pass
-
-
-class RecordFile(NamedTuple):
-    """One JSONL file: its upstream snapshot declaration and its records."""
-
-    sources: dict[str, dict[str, Any]]
-    records: list[dict[str, Any]]
-
-
-def resolve_input(value: str | Path) -> Path:
-    path = Path(value).expanduser()
-    if path.exists() or path.is_absolute():
-        return path
-    return SKILL_ROOT / path
-
-
-def load_jsonl(value: str | Path) -> RecordFile:
-    path = resolve_input(value)
-    parsed: list[dict[str, Any]] = []
-    for number, line in enumerate(path.read_text(encoding="utf-8").splitlines(), 1):
-        if not line.strip():
-            continue
-        try:
-            record = json.loads(line)
-        except json.JSONDecodeError as exc:
-            raise ValidationError(f"{path}:{number}: invalid JSON") from exc
-        if not isinstance(record, dict):
-            raise ValidationError(f"{path}:{number}: each JSONL record must be an object")
-        parsed.append(record)
-    sources = load_sources(parsed)
-    records = [
-        record for record in parsed if record.get("record_type") != SOURCES_RECORD_TYPE
-    ]
-    if not records:
-        raise ValidationError(f"{path}: no records")
-    return RecordFile(sources, records)
-
-
-def require_text(record: dict[str, Any], key: str, label: str) -> str:
-    value = record.get(key)
-    if not isinstance(value, str) or not value.strip():
-        raise ValidationError(f"{label}: {key} must be non-empty text")
-    return value
-
-
-def require_list(record: dict[str, Any], key: str, label: str) -> list[Any]:
-    value = record.get(key)
-    if not isinstance(value, list) or not value:
-        raise ValidationError(f"{label}: {key} must be a non-empty list")
-    return value
-
-
-def validate_ref(
-    value: Any, sources: dict[str, dict[str, Any]], label: str
-) -> ResolvedRef:
-    resolved, finding = resolve_ref(value, sources, label)
-    if finding is not None:
-        raise ValidationError(f"{label}: {finding.code}: {finding.detail}")
-    assert resolved is not None
-    if not resolved.record_id or not resolved.record_id.strip():
-        raise ValidationError(f"{label}: record_id must be non-empty text")
-    return resolved
-
-
-def validate_acceptance(
-    value: Any, sources: dict[str, dict[str, Any]], label: str
-) -> None:
-    if not isinstance(value, dict) or value.get("status") not in ACCEPTANCE_STATUSES:
-        raise ValidationError(f"{label}: invalid creator_acceptance status")
-    decision_ref = value.get("decision_ref")
-    if value["status"] == "accepted" or decision_ref is not None:
-        resolved = validate_ref(decision_ref, sources, f"{label}.decision_ref")
-        # A decision_ref pointing at a block or an asset record binds acceptance to
-        # something that never recorded a creator decision.
-        if not str(resolved.record_id).startswith("CD-"):
-            raise ValidationError(
-                f"{label}.decision_ref: record_id must be a creator decision starting with CD-"
-            )
-
-
-def validate_records(characters: RecordFile, looks: RecordFile) -> dict[str, Any]:
-    character_ids: set[str] = set()
-    for index, record in enumerate(characters.records, 1):
-        label = f"character[{index}]"
-        character_id = require_text(record, "character_id", label)
-        if not character_id.startswith("CHAR-"):
-            raise ValidationError(f"{label}: character_id must start with CHAR-")
-        if character_id in character_ids:
-            raise ValidationError(f"{label}: duplicate character_id {character_id}")
-        character_ids.add(character_id)
-        require_text(record, "display_name", label)
-        anchors = require_list(record, "identity_anchors", label)
-        if any(not isinstance(item, str) or not item.strip() for item in anchors):
-            raise ValidationError(f"{label}: identity_anchors must contain text")
-        for ref_index, ref in enumerate(require_list(record, "source_refs", label), 1):
-            validate_ref(ref, characters.sources, f"{label}.source_refs[{ref_index}]")
-        validate_acceptance(record.get("creator_acceptance"), characters.sources, label)
-
-    look_ids: set[str] = set()
-    for index, record in enumerate(looks.records, 1):
-        label = f"look[{index}]"
-        look_id = require_text(record, "look_id", label)
-        if not look_id.startswith("LOOK-"):
-            raise ValidationError(f"{label}: look_id must start with LOOK-")
-        if look_id in look_ids:
-            raise ValidationError(f"{label}: duplicate look_id {look_id}")
-        look_ids.add(look_id)
-        character_ref = validate_ref(
-            record.get("character_ref"), looks.sources, f"{label}.character_ref"
-        )
-        if character_ref.record_id not in character_ids:
-            raise ValidationError(
-                f"{label}: character_ref does not resolve: {character_ref.record_id}"
-            )
-        differences = record.get("differences")
-        if not isinstance(differences, dict) or not any(differences.values()):
-            raise ValidationError(f"{label}: differences must describe an observable change")
-        validity = record.get("validity")
-        if not isinstance(validity, dict) or not validity.get("from"):
-            raise ValidationError(f"{label}: validity.from is required")
-        validate_acceptance(record.get("creator_acceptance"), looks.sources, label)
-
-    return {
-        "status": "valid",
-        "characters": len(characters.records),
-        "looks": len(looks.records),
-        # `source_declaration` is this file's own `sources` header resolving;
-        # `look_binding` is a real cross-record lookup, and it is one only
-        # because both files are handed to this checker.
-        "checks": ["unique_ids", "acceptance_shape", "source_declaration", "look_binding"],
-    }
-
-
-def validate_files(characters: str | Path, looks: str | Path) -> dict[str, Any]:
-    return validate_records(load_jsonl(characters), load_jsonl(looks))
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--characters", required=True)
-    parser.add_argument("--looks", required=True)
-    args = parser.parse_args()
-    try:
-        result = validate_files(args.characters, args.looks)
-    except (OSError, ValidationError) as exc:
-        print(f"asset check failed: {exc}", file=sys.stderr)
-        return 2
-    print(json.dumps(result, ensure_ascii=True, indent=2))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

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

@@ -1,89 +0,0 @@
-#!/usr/bin/env python3
-"""Offline self-test for the standalone asset checker."""
-
-from __future__ import annotations
-
-import copy
-import sys
-from pathlib import Path
-
-from asset_check import SKILL_ROOT, RecordFile, ValidationError, load_jsonl, validate_records
-
-MINIMUM_PYTHON = (3, 9)
-if sys.version_info < MINIMUM_PYTHON:
-    raise SystemExit("selftest.py requires Python 3.9 or newer")
-
-
-def require(condition: bool, message: str) -> None:
-    if not condition:
-        raise AssertionError(message)
-
-
-def expect_failure(characters: RecordFile, looks: RecordFile, marker: str) -> None:
-    try:
-        validate_records(characters, looks)
-    except ValidationError as exc:
-        if marker not in str(exc):
-            raise AssertionError(f"expected {marker!r}, got {exc!s}") from exc
-    else:
-        raise AssertionError(f"expected validation failure containing {marker!r}")
-
-
-def edited(source: RecordFile, index: int) -> tuple[RecordFile, dict]:
-    records = copy.deepcopy(source.records)
-    return RecordFile(copy.deepcopy(source.sources), records), records[index]
-
-
-def main() -> int:
-    example = Path(SKILL_ROOT, "examples/minimal")
-    characters = load_jsonl(example / "characters.jsonl")
-    looks = load_jsonl(example / "looks.jsonl")
-    result = validate_records(characters, looks)
-    require(result["characters"] == 1 and result["looks"] == 1, "valid fixture count")
-
-    duplicate = copy.deepcopy(characters.records[0])
-    expect_failure(
-        RecordFile(characters.sources, [*characters.records, duplicate]),
-        looks,
-        "duplicate character_id",
-    )
-
-    broken_look, record = edited(looks, 0)
-    record["character_ref"]["record_id"] = "CHAR-MISSING"
-    expect_failure(characters, broken_look, "does not resolve")
-
-    undeclared, record = edited(looks, 0)
-    record["character_ref"]["src"] = "not-declared"
-    expect_failure(characters, undeclared, "REF_SRC_IS_NOT_DECLARED")
-
-    unbound, record = edited(looks, 0)
-    record["character_ref"] = {"record_id": "CHAR-LIN"}
-    expect_failure(characters, unbound, "REF_HAS_NO_UPSTREAM_BINDING")
-
-    # A released project may still carry the snapshot inline on the reference.
-    inline, record = edited(looks, 0)
-    record["character_ref"] = {
-        **inline.sources["characters"],
-        "record_id": "CHAR-LIN",
-    }
-    inline.sources.pop("characters")
-    require(validate_records(characters, inline)["status"] == "valid", "inline snapshot")
-
-    candidate, record = edited(characters, 0)
-    record["creator_acceptance"] = {"status": "proposed", "decision_ref": None}
-    require(validate_records(candidate, looks)["status"] == "valid", "candidate status")
-
-    invalid, record = edited(characters, 0)
-    record["creator_acceptance"] = {"status": "approved", "decision_ref": None}
-    expect_failure(invalid, looks, "invalid creator_acceptance status")
-
-    misbound, record = edited(characters, 0)
-    record["creator_acceptance"]["decision_ref"]["record_id"] = "SC001-A01"
-    expect_failure(misbound, looks, "must be a creator decision starting with CD-")
-
-    print("9 self-tests passed")
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/lib/drama/skills/short-drama-image-prompts/examples/minimal-image-prompt-specs.jsonl

@@ -1,2 +0,0 @@
-{"record_type": "sources", "schema_version": "1.0.0", "sources": {"characters": {"owner": "short-drama-assets", "artifact": "characters.jsonl"}, "looks": {"owner": "short-drama-assets", "artifact": "looks.jsonl"}, "composition-reference": {"owner": "creator", "artifact": "composition-reference.png"}}}
-{"spec_id": "IMG-LIN-RAIN", "status": "candidate", "purpose": "character_sheet", "asset_binding": {"identity_ref": {"src": "characters", "record_id": "CHAR-LIN"}, "variant_ref": {"src": "looks", "record_id": "LOOK-LIN-RAIN"}}, "source_refs": [{"src": "characters", "record_id": "CHAR-LIN", "field": "/identity_anchors", "role": "identity_anchor"}], "reference_bindings": [{"slot_id": "REF-LIN-COMPOSITION", "order": 1, "artifact_ref": {"src": "composition-reference", "record_id": "REF-COMP-01"}, "role": "composition", "may_control": ["左右排版与留白"], "must_not_control": ["角色身份、服装、文字"], "admission_status": "creator_described", "reference_observation_ref": null, "unresolved_risks": []}], "intent": {"reuse_job": "保持角色在雨夜造型中的跨镜身份", "audience": "image production"}, "identity_or_form_anchors": ["齐下颌黑发", "左眉尾浅疤", "站立时重心偏右"], "variant_deltas": [{"field": "wardrobe", "observable_change": "深蓝旧雨衣，肩部被雨水加深", "valid_range": "SC001-SC002"}], "composition": {"view": "front and side reference sheet", "framing": "full body", "orientation": "neutral", "scale_relation": "consistent body proportions", "spatial_relations": []}, "appearance": {"materials": ["worn waterproof fabric"], "palette": "deep blue with muted skin tones", "lighting": "soft neutral studio light", "atmosphere": "clean reference presentation"}, "background": {"policy": "clean", "details": "plain light-gray background"}, "constraints": ["one coherent accepted look", "identity anchors remain visible"], "negative_constraints": ["no extra accessories", "no readable text"], "generic_prompt": "Character reference sheet for Lin Lan in one coherent rain look, jaw-length black hair, a shallow scar at the left eyebrow tail, weight resting slightly on the right leg, worn deep-blue raincoat with rain-darkened shoulders, front and side full-body views, neutral studio light, plain light-gray background, no extra accessories, no readable text.", "provenance": "creator_project"}