@lemoncat7/dsh-partner 2.4.2 → 2.7.0

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

@@ -0,0 +1,135 @@
+#!/usr/bin/env python3
+"""Offline self-test for confirmation-gated production and provider profiles."""
+
+from __future__ import annotations
+
+import json
+import sys
+import tempfile
+from pathlib import Path
+from typing import Any
+
+from production_tool import (
+    ConfirmationRequiredError,
+    confirm_job,
+    prepare_job,
+    run_job,
+)
+from provider_adapters import (
+    compile_gpt_image_2_payload,
+    compile_minimax_music_payload,
+    compile_seedance_payload,
+)
+
+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 RuntimeError(message)
+
+
+def main() -> int:
+    with tempfile.TemporaryDirectory() as directory:
+        base = Path(directory)
+        project = base / "project"
+        project.mkdir()
+        (project / "short-drama.json").write_text("{}\n", encoding="utf-8")
+        job_path = project / "music-job.json"
+        job: dict[str, Any] = {
+            "job_id": "SELFTEST-MUSIC-001",
+            "modality": "music",
+            "adapter": "fixture",
+            "prompt": "restrained instrumental tension",
+            "references": [],
+            "outputs": ["剧集/EP001/制作成果/music/cue.wav"],
+            "parameters": {"is_instrumental": True},
+            "overwrite": False,
+        }
+        job_path.write_text(json.dumps(job), encoding="utf-8")
+        config = base / "adapters.json"
+        fixture = Path(__file__).with_name("fixture_adapter.py")
+        config.write_text(
+            json.dumps(
+                {
+                    "adapters": {
+                        "fixture": {
+                            "command": [sys.executable, str(fixture)],
+                            "timeout_seconds": 30,
+                        }
+                    }
+                }
+            ),
+            encoding="utf-8",
+        )
+
+        preview = prepare_job(project, job_path)
+        try:
+            confirm_job(project, job_id=job["job_id"], confirmation="CONFIRM wrong")
+        except ConfirmationRequiredError:
+            pass
+        else:
+            raise AssertionError("a mismatched production confirmation was accepted")
+        confirm_job(
+            project,
+            job_id=job["job_id"],
+            confirmation=preview["confirmation"],
+        )
+        result = run_job(project, job_id=job["job_id"], adapter_config=config)
+        require(result["state"] == "succeeded", "fixture production did not succeed")
+        require(
+            (project / job["outputs"][0]).read_bytes().startswith(b"RIFF"),
+            "fixture production did not write WAV media",
+        )
+
+    require(
+        compile_gpt_image_2_payload(
+        {
+            "modality": "image",
+            "prompt": "portrait",
+            "references": [],
+            "outputs": ["制作成果/portrait.png"],
+            "parameters": {"size": "1024x1024"},
+        }
+        )["model"]
+        == "gpt-image-2",
+        "GPT Image 2 profile compiled the wrong model",
+    )
+    seedance = compile_seedance_payload(
+        {
+            "modality": "video",
+            "prompt": "slow push in",
+            "references": [],
+            "outputs": ["制作成果/shot.mp4"],
+            "parameters": {"duration": 5, "ratio": "9:16"},
+        },
+        model="configured-endpoint",
+        allowed_ratios={"9:16"},
+        duration_range=(5, 10),
+    )
+    require(
+        seedance.get("ratio") == "9:16" and seedance.get("duration") == 5,
+        "Seedance profile did not compile explicit API parameters",
+    )
+    require(
+        compile_minimax_music_payload(
+        {
+            "modality": "music",
+            "prompt": "restrained score",
+            "references": [],
+            "outputs": ["制作成果/cue.mp3"],
+            "parameters": {"is_instrumental": True},
+        }
+        )["model"]
+        == "music-3.0",
+        "MiniMax Music profile compiled the wrong model",
+    )
+
+    print("8 self-tests passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

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

@@ -0,0 +1,118 @@
+---
+name: short-drama-review
+description: 审查短剧项目中的原著分析、故事、剧本、视觉设定、图片提示词、分镜、冻结关键帧、视频提示词和已有媒体。用户提出“审稿/检查剧本”“检查资产或连续性”“检查图片/视频提示词”“检查原著分析”“审查模板感”“根据生产观察做项目校准”时使用；只写审查问题、结论和修订要求，不代替 owner 修改来源文件。
+license: MIT
+---
+
+# 短剧审查
+
+优先由未参与当前版本创作的 reviewer 执行；条件不允许时可以自检并如实说明。审查与修改是两个工作
+单元：本技能只定位问题、影响和必须达到的修订结果，不在同一轮替 owner 改来源。
+
+## Quick Start
+
+直接读取用户点名的当前文件。单集审查需要落盘时写 `审查/EP001-审查.md`；独立文件审查使用
+`审查/<主题>-审查.md`。用户只要口头结论时直接回复，不为“完整”创建审查文件。
+
+审查 Markdown 建议结构：
+
+```markdown
+# EP001 审查
+
+- 范围：剧本、分镜、视频提示词
+- 结论：REVISE
+- 复核方式：独立 reviewer / 自检
+
+## Blocker · REV-001 · 画面文字未被镜头承载
+- 位置：剧本.md / EP001-SC002；分镜.md / SHOT-EP001-004
+- 证据：……
+- 影响：……
+- 修订结果：由 short-drama-storyboard 补入准确文字及可读条件。
+- 规则：SHT-01 · reviewed_invariant
+```
+
+引用只使用文件名、标题 ID、行号或短引文；不建立 sources 声明、哈希、record ID 或第二套状态。
+
+## 选择审查范围
+
+- `source_analysis`
+- `story_script`
+- `assets_continuity`
+- `image_prompts`
+- `storyboard_keyframes`
+- `video_prompts`
+- `production_outputs`
+- `full_episode`
+- `delivery_privacy`
+- `project_calibration`
+
+只读对应资料，不预加载整个项目：
+
+- 原著分析：[原著分析审查表](references/rubric-source-analysis.md)
+- 故事、场景、行动与对白：[故事剧本审查表](references/rubric-story-script.md)
+- 身份、变体、连续性与图片提示词：[资产提示词审查表](references/rubric-assets-prompts.md)
+- 原文落实、镜头、关键帧与视频运动：[视觉运动审查表](references/rubric-visual-motion.md)
+- 完整审查方法：[审查方法](references/review-method.md)
+- 制作端常见缺陷：[生产质量门](references/production-quality-gates.md)
+- 授权生产观察的项目内校准：[项目校准](references/project-calibration.md)
+- 模板感、重复手法或 AI 味：[反模板修订](references/anti-template-repair.md)
+- 阶段边界、参考媒体与规则表：[阶段契约](references/stage-contract.md)
+
+## 工作流
+
+### 1. 冻结范围
+
+写清当前要审哪些文件、章节、镜头或提示词，以及创作者已经明确的限制。目标在审查中发生变化时，
+重新读取再下结论。
+
+### 2. 先查可证明事实
+
+- 五文档的可见 ID、引用和时长是否一致；
+- 剧本对白、动作、声音、画面文字是否都有画面/声音承载；
+- 人物、地点、道具状态和镜头起止是否连续；
+- 提示词是否从准确起点到准确终点；
+- 目标模型画音同轨时，声音内容、时序和发声边界是否与来源一致；无对白镜是否交代底声或静默
+  （`VID-22`、`VID-23`，见 [视觉运动审查表](references/rubric-visual-motion.md)）；
+- 私有输入、凭据、绝对路径或内部流程文字是否泄漏。
+
+缺少必要输入时只停止依赖它的判断，其他问题可以继续汇总。
+
+### 3. 带证据审内容
+
+每个 finding 包含：位置、必要短引文或冲突事实、观众/制作影响、必须达到的修订结果、owner、严重
+程度和规则等级。不能只说“AI 味”“不够电影感”或给无证据分数。
+
+### 4. 跨文档综合
+
+```text
+剧本事实 -> 视觉设定 -> 镜头职责与边界 -> 冻结关键帧 -> 视频运动 -> 下一状态
+```
+
+优先守住原意、知情时机与连续性，不奖励脱离来源的华丽提示词。
+
+### 5. 结论与分派
+
+- `APPROVE`：没有阻断问题；
+- `APPROVE_WITH_NOTES`：只有不阻断的改进；
+- `REVISE`：存在结构、内容或限制冲突；
+- `PROVISIONAL`：关键输入不足，暂时无法完成判断。
+
+按 owner 分组修订要求。本轮完成后交还控制权；修改和复审只有用户明确请求时开始。
+
+## 严重程度
+
+- `blocker`：不安全、不可交付或会让流程走错；
+- `major`：明显破坏剧情理解、连续性或制作结果；
+- `minor`：有具体影响但不阻断；
+- `note`：创作选择或可选润色。
+
+## 边界
+
+- 不提交图片、视频、TTS 或音乐任务，不配置 adapter，不把 Dashboard 操作当生产授权。
+- 无法读取媒体时明确限制，不从文字或 adapter 状态推断脸部一致、表演、口型、混音或市场表现。
+- 生产观察必须绑定准确输入、提示词、参考、配置和结果版本；不能泛化成通用规则。
+- 审查文件只保留修订所需的最小证据，不复制完整私有输入。
+
+## 安装维护
+
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/resources/skills/drama-production/upstream/skills/short-drama-review/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "短剧审查"
+  short_description: "审查短剧故事、资产、连续性、分镜与提示词并给出证据"
+  default_prompt: "使用 $short-drama-review 对短剧项目产物做独立、带证据的校验与审查。"

package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/finding-template.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay-index.jsonl"},"shots":{"owner":"short-drama-storyboard","artifact":"剧集/EP001/storyboard/shots.jsonl"},"screenplay":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay.md"}}}
+{"finding_id":"FIND-EXAMPLE","diagnostic_code":"SCR_SCENE_NO_TURN","knowhow_rule_id":"SCR-01","scope":"story_script","classification":"reviewed_invariant","enforcer":"reviewer","evidence":"Bounded explanation of the conflict","evidence_refs":[{"role":"source","src":"screenplay-index","record_id":"BLK-EP001-SC001-A01"},{"role":"conflicting_consumer","src":"shots","record_id":"SHOT-001","field":"/purpose"}],"impact":"Audience or production consequence","disposition":"keep | post_production | targeted_edit | resubmit | rewrite | not_applicable","disposition_rationale":"Why this disposition: is the defect text-controllable, and has it recurred? Use not_applicable outside project calibration.","required_change":"Outcome required from the owner, or empty when the disposition calls for no change","owner_skill":"short-drama-write","severity":"error","status":"open","target_ref":{"src":"screenplay","record_id":"EP001-SC001"}}

package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/supersession-decision.example.json

@@ -0,0 +1,42 @@
+{
+  "sources": {
+    "motion-specs-alternate": {
+      "owner": "short-drama-video-prompts",
+      "artifact": "剧集/EP001/storyboard/motion-specs.jsonl"
+    },
+    "motion-specs-master": {
+      "owner": "short-drama-video-prompts",
+      "artifact": "剧集/EP001/storyboard/motion-specs.jsonl"
+    },
+    "shots": {
+      "owner": "short-drama-storyboard",
+      "artifact": "剧集/EP001/storyboard/shots.jsonl"
+    }
+  },
+  "example_only": true,
+  "decision_id": "SUPERSESSION-EXAMPLE",
+  "alternate_ref": {
+    "src": "motion-specs-alternate",
+    "record_id": "MOTION-ALTERNATE",
+    "authority": "candidate"
+  },
+  "master_ref": {
+    "src": "motion-specs-master",
+    "record_id": "MOTION-MASTER",
+    "authority": "accepted"
+  },
+  "checked_obligations": [
+    {
+      "source_ref": {
+        "src": "shots",
+        "record_id": "SHOT-EXAMPLE",
+        "field": "/end_boundary",
+        "authority": "accepted"
+      },
+      "result": "covered | missing | changed",
+      "evidence": "<指出 alternate 中的对应字段>"
+    }
+  ],
+  "decision": "approve_supersession | reject_supersession",
+  "rationale": "<覆盖、对白、揭示、连续性和项目要求的复核结论>"
+}

package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/verdict-template.json

@@ -0,0 +1,32 @@
+{
+  "sources": {
+    "screenplay": {
+      "owner": "short-drama-write",
+      "artifact": "剧集/EP001/screenplay.md"
+    },
+    "findings": {
+      "owner": "short-drama-review",
+      "artifact": "审查/findings.jsonl"
+    }
+  },
+  "review_id": "REVIEW-EXAMPLE",
+  "scope": [
+    "story_script"
+  ],
+  "reviewed_artifacts": [
+    {
+      "src": "screenplay"
+    }
+  ],
+  "findings_ref": {
+    "src": "findings"
+  },
+  "review_method": "uninvolved_reviewer | self_check",
+  "reviewer": "<honest reviewer label>",
+  "structural_validation": "not_run",
+  "verdict": "PROVISIONAL",
+  "blocking_findings": [],
+  "open_blocker_count": 0,
+  "notes": [],
+  "supersession_decisions": []
+}

package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-findings.jsonl

@@ -0,0 +1,2 @@
+{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay-index":{"owner":"short-drama-write","artifact":"screenplay-index.jsonl"},"screenplay":{"owner":"short-drama-write","artifact":"screenplay.md"}}}
+{"finding_id":"FIND-SC001-TURN","diagnostic_code":"SCR_SCENE_NO_TURN","knowhow_rule_id":"SCR-01","scope":"story_script","classification":"reviewed_invariant","enforcer":"reviewer","evidence":"SC001 ends with the same decision and relationship state with which it began.","evidence_refs":[{"role":"source","src":"screenplay-index","record_id":"SC001-A01"},{"role":"source","src":"screenplay-index","record_id":"SC001-A04"}],"impact":"The scene consumes time without changing the audience's understanding or the characters' options.","disposition":"targeted_edit","disposition_rationale":"The defect is local to the written scene turn and has not recurred elsewhere.","required_change":"End SC001 with a visible choice or consequence while preserving the accepted entrance facts.","owner_skill":"short-drama-write","severity":"error","status":"open","target_ref":{"src":"screenplay","record_id":"SC001"}}

package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-verdict.json

@@ -0,0 +1,34 @@
+{
+  "sources": {
+    "screenplay": {
+      "owner": "short-drama-write",
+      "artifact": "screenplay.md"
+    },
+    "findings": {
+      "owner": "short-drama-review",
+      "artifact": "minimal-findings.jsonl"
+    }
+  },
+  "review_id": "REVIEW-SC001",
+  "scope": [
+    "story_script"
+  ],
+  "reviewed_artifacts": [
+    {
+      "src": "screenplay"
+    }
+  ],
+  "findings_ref": {
+    "src": "findings"
+  },
+  "review_method": "self_check",
+  "reviewer": "standalone example self-check",
+  "structural_validation": "passed",
+  "verdict": "REVISE",
+  "blocking_findings": [
+    "FIND-SC001-TURN"
+  ],
+  "open_blocker_count": 1,
+  "notes": [],
+  "supersession_decisions": []
+}

package/resources/skills/drama-production/upstream/skills/short-drama-review/references/anti-template-repair.md

@@ -0,0 +1,109 @@
+# 去模板感：诊断、修订与误报
+
+“像模板”不是稳定 finding。先定位重复机制如何伤害当前故事，再把修订交给 owner。
+
+## 目录
+
+- [诊断四层](#1-诊断四层)
+- [修订不是换同义词](#2-修订不是换同义词)
+- [误报反例](#3-误报反例)
+- [Finding 示例](#4-finding-示例)
+- [分级](#5-分级)
+
+## 1. 诊断四层
+
+1. **因果重复**：每轮都靠陌生人带来答案、巧合救场、对手自曝。
+2. **策略重复**：所有人物都用质问—否认—提高音量，没有各自筹码。
+3. **表达重复或过度工整**：动作总是“攥拳/眼神一冷”，每句对白都跟同构微动作，
+   或 prompt 总以泛化质量词开头。
+4. **镜头重复**：每句台词 close-up + push，camera 不随 attention/关系变化。
+
+只有能引用至少两个位置并说明损失，才发重复 finding。单次使用类型惯例不是模板罪证。
+
+表达层还要检查三种不靠逐字重复也会产生模板感的情况：
+
+- **过度解释**：动作、证据或台词已经表达人物选择，后面又补一句意义说明、心理翻译或
+  道德总结，夺走观众推断空间；
+- **过度收口**：每场都用总结句、金句或完整结论封死余波，下一场只能重新制造压力；
+- **过度工整**：每轮台词都配相同长度的微表情/手部动作，每场都以同构对仗或反问落点，
+  人物和场面失去自己的节奏。
+- **信息密度均匀**：每一拍携带的新信息量几乎相同，于是没有一件事像"事件"。这与过度
+  工整不同——那讲的是形式对称，这讲的是**疏密**：一场戏里本该有几拍是白给的、有一拍
+  是砸下来的。单看每一拍都合格，所以逐拍检查抓不到它；要把一场戏的各拍并排看信息量。
+- **代价即时结清**：本集造成的代价全部在本集内还完，于是什么都不积累。这是过度收口的
+  跨集版本。查法很具体——把本集造成的代价与它实际落地的集号列出来，若全部落在同一集，
+  就是这个病；短剧靠未结清的债务把观众带到下一集。
+
+这不是禁词表。Reviewer 仍要引用当前作品中至少两个位置，说明被重复解释、封死或抹平的
+具体意义；有意的仪式、喜剧节拍、人物口癖、方言和创作者选择继续按下文反例处理。
+
+## 2. 修订不是换同义词
+
+### 因果
+
+弱：主管再次嘲笑她。她拿出另一份证据，所有人震惊。
+
+诊断：证据无需选择便出现；第二轮只把第一轮“拿证据打脸”再演一次。
+
+给 write owner 的目标：保留公开施压与主角掌握证据；让主角必须在“马上公开”与“先保护
+会被顶罪者”之间作不可兼得的选择，并让选择产生下轮压力。不要在 finding 里代写完整台词。
+
+### 对话
+
+弱：
+
+~~~text
+A：你在骗我。
+B：我没有骗你。
+A：你就是在骗我。
+~~~
+
+若 B 手里有纸袋，A 手里有钥匙，可要求每轮改变筹码：A 用钥匙证明到访；B 用“拆袋即选边”
+重定义信任；A 选择拿走钥匙但不拆袋。沉默和物件完成第三轮，不必更响。
+
+### Prompt
+
+弱：“高级、电影感、精致、超清的神秘盒子。”
+
+Finding 应指出缺少哪个 accepted identity/scale/material/state/text policy。修订目标是补这些
+识别事实，不是禁用“高级”一词。
+
+### 镜头
+
+三个连续台词都 extreme close + push。先问每句 attention：第一轮是双方关系，可留 two-shot；
+第二轮证物被推过桌面，attention 落到手/边界；第三轮对方不碰证物，reaction 可由手和负空间
+完成。不是为了“景别多样化”，而是每个 cut 有不同 viewing purpose。
+
+## 3. 误报反例
+
+以下不能仅凭表面重复判模板：
+
+- 仪式场景刻意重复同一句/同构图，第二次因持有人改变而意义反转；
+- 喜剧 running gag 重复动作，但每次让新人物付出不同代价；
+- 审讯保持 locked two-shot，以拒绝剪切制造压迫；
+- 类型短剧多集使用相同片头结构，这是 accepted format；
+- 人物因创伤反复做同一动作，作品正在表现停滞而非遗漏变化。
+
+Reviewer 必须说明：重复是否是 creator choice、第二次新增了什么、若保留会伤害什么。
+不确定时记 note/question，不是 REVISE。
+
+## 4. Finding 示例
+
+~~~markdown
+## Major · REV-003 · 连续两集用同一种自曝完成揭示
+- 位置：剧本.md / EP002-SC003；剧本.md / EP003-SC002
+- 证据：两场都由主管主动说出隐藏事实，主角没有选择。
+- 影响：主角策略不参与揭示，连续两集的回报来自对手自曝。
+- 修订结果：保留两项事实，但让至少一项揭示由主角有代价的策略触发。
+- Owner：short-drama-write
+- 规则：SCR-04 · craft_default
+~~~
+
+位置只使用文件名、标题 ID、行号或必要短引文。不要复制上游快照，也不要为审查另建记录 ID。
+
+## 5. 分级
+
+- structural_invariant：finding 的位置、严重程度、owner 与结论明确且可复核。
+- reviewed_invariant：下游没有改写 source meaning；需证据判断。
+- craft_default：避免无意义的因果/策略/表达/镜头重复；可由创作者说明覆盖。
+- taste_option：类型惯例、仪式重复、running gag、固定镜头风格本身不阻断。