@oh-story/dsh 0.1.4 → 0.1.5

package/lib/novel-to-game/examples/jin-ping-mei/build/app/js/text.js

@@ -0,0 +1,32 @@
+// 玩家可见文案集中管理。路线对白在 data.js 中按设计节点集中管理。
+
+export const TEXT = Object.freeze({
+  title: '金瓶梅·风月总账',
+  subtitle: '白日把一宅人心压在账上，入夜看谁肯为你留门。',
+  identity: '你是西门庆。二十日里，要守住银库、声名和五处院门。偏爱可以，撒谎不行；想让五盏灯一起亮，就得接住她们各自的权限、退路与欲望。',
+  rating: '18+ · 仅限成年人 · 含成人关系、轻度裸露与亲密内容',
+  ageTitle: '十八岁以下，止步',
+  ageBody: '本作只供成年人，含成人关系、肩背与腿部等轻度裸露、亲密场景与成熟主题。所有可进入亲密路线的人物均为成年虚构角色。',
+  ageYes: '我已成年',
+  ageNo: '离开',
+  start: '进宅',
+  continue: '接着玩',
+  gallery: '场景册',
+  restart: '从头再来',
+  muteOn: '开声',
+  muteOff: '静音',
+  dayLead: '门外是债，门里是人心。先收拾一头，另一头入夜就会来问你。',
+  chooseVisit: '暮鼓一响，五处院门各亮了一盏灯。今夜先走向谁？',
+  sharedNightLead: '五个人都没走。账还没凉，酒已经热了——今夜是各回各院，还是在每个人都独立点头之后让五盏灯留在一处，就等你开口。',
+  nightLead: '她说完了，手却还搭在门闩上。今夜留到哪一步，看你怎么接她这句话。',
+  morningLead: '天刚透进窗纸，昨夜没说尽的话已经到了门外。',
+  banquetLead: '五只杯子都等着。这一次若把功劳、财权或证词分偏了，夜里就有一扇门先落闩。',
+  galleryEmpty: '册子还是空的。等有人肯把门留给你，再来看。',
+  galleryKeep: '从头再来，册页也不会丢。',
+  saveNote: '每次落子都会存下；旧版账本不续接。',
+  close: '合上',
+  sceneContinue: '接着往下',
+  endingRestart: '再走二十日',
+  endingGallery: '翻场景册',
+  reducedMotion: '已按系统设置减少动效',
+});

package/lib/novel-to-game/examples/jin-ping-mei/build/app/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "jinpingmei-fengyue-ledger",
+  "private": true,
+  "type": "module",
+  "description": "《金瓶梅·风月总账》20日男性第一人称成人后宫关系模拟：五条深线、五院共约、联院协力与公开问责",
+  "scripts": {
+    "start": "python3 -m http.server 5173",
+    "verify:model": "node ../../qa/verify_playable_model.mjs"
+  }
+}

package/lib/novel-to-game/examples/jin-ping-mei/build/app/vercel.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "headers": [
+    {
+      "source": "/assets/(.*)",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=31536000, immutable"
+        }
+      ]
+    },
+    {
+      "source": "/(.*)\\.(js|css)",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=3600, must-revalidate"
+        }
+      ]
+    }
+  ]
+}

package/lib/novel-to-game/examples/jin-ping-mei/build/art/generated-art.json

@@ -0,0 +1,161 @@
+{
+  "schemaVersion": 3,
+  "generatedAt": "2026-08-25",
+  "toolVersion": "Codex built-in image_gen",
+  "usage": "《金瓶梅·风月总账》四十一张运行图的二维新国风彻底重塑",
+  "reason": "旧棕黑 CG、古画册页样张、真人古装样张和现代时尚样张分别被判定为太暗、太旧、太真实和太现代。最终批准方向为完整晚明世界中的成熟理想化二维叙事游戏插画。",
+  "externalStyleResearch": {
+    "source": "https://github.com/freestylefly/awesome-gpt-image-2",
+    "principles": [
+      "Case 213：首先读作可进入的古代游戏空间，不借 MMO HUD、3D 真人渲染或暗街",
+      "Case 290：角色卡级身份色、器物锚点和即时情绪，不借 SSR 文案、镭射边框或暗底",
+      "Case 9：现代、多彩、明亮通透的国潮色光和留白，不借现代城市与宣传构图",
+      "Case 230：朱红、青蓝、鎏金的克制功能配色，不借品牌海报和现代地标"
+    ],
+    "rejected": [
+      "Case 206／242 式古画与书签媒介",
+      "Case 343／514 式现代时尚与硬边艺术",
+      "Case 207 式暗黑真人封面"
+    ],
+    "copyrightBoundary": "未复制或提交参考库案例图；只借媒介裁决、游戏化识别、色光与留白方法。"
+  },
+  "approvedStyleFrame": {
+    "asset": "app/assets/cg/group/title_new_guofeng.webp",
+    "sourceOutput": "codex-imagegen:exec-e1603504-1f87-4923-8f7d-7b6a45751299.png",
+    "promptSummary": "五名成年女性置于通透明代春庭；二维数字手绘、成熟理想化面孔、流动丝绸、朱砂石青青绿桃粉；人物居中右，左侧留真实 HTML 标题区。",
+    "required": [
+      "完整晚明建筑、服饰、发式、器物与关系空间",
+      "二维手绘游戏 CG 与可想象的人物材质",
+      "白日中高明度；夜景同时保留蓝紫月光和暖灯",
+      "五人脸型、成熟度、姿态、衣色与器物互异",
+      "画面内不承担正文排版"
+    ],
+    "forbidden": [
+      "真人摄影、3D 皮肤、现代时尚棚拍或品牌海报",
+      "古画复刻、工笔册页、宣纸旧化或全局黄褐滤镜",
+      "暗黑底、重暗角、全屏烟雾或不可读夜景",
+      "幼态、未成年人、胁迫、露点或性行为",
+      "现代物件、文字、标志或水印"
+    ]
+  },
+  "identityMasters": [
+    {
+      "character": "吴月娘",
+      "path": "app/assets/heroine/yue/night.webp",
+      "sourceOutput": "codex-imagegen:exec-bd1047ec-fc3b-40e4-ac8a-1d0acfe1e174.png",
+      "anchors": "石青与象牙、总账、铜钥匙"
+    },
+    {
+      "character": "潘金莲",
+      "path": "app/assets/heroine/pan/night.webp",
+      "sourceOutput": "codex-imagegen:exec-f521d0b2-b51a-428a-90cb-c3cbb0e5592e.png",
+      "anchors": "朱砂与暖粉、团扇、回看"
+    },
+    {
+      "character": "李瓶儿",
+      "path": "app/assets/heroine/pinger/night.webp",
+      "sourceOutput": "codex-imagegen:exec-314abee8-24ce-4494-9430-22b3122424df.png",
+      "anchors": "象牙与浅金、漆匣、私钥"
+    },
+    {
+      "character": "孟玉楼",
+      "path": "app/assets/heroine/meng/night.webp",
+      "sourceOutput": "codex-imagegen:exec-230a5eec-86c4-4923-8955-3715328c4cbe.png",
+      "anchors": "青绿与藕荷、名帖、曲谱、空席"
+    },
+    {
+      "character": "孙雪娥",
+      "path": "app/assets/heroine/xuee/night.webp",
+      "sourceOutput": "codex-imagegen:exec-262bebeb-8053-46d6-a1ff-5afd4a8811fa.png",
+      "anchors": "琥珀与深青、米账、仓绳、灶火"
+    },
+    {
+      "character": "李娇儿",
+      "path": "app/assets/household/li_jiaoer.webp",
+      "sourceOutput": "codex-imagegen:exec-24cda691-c334-48cc-b23b-e4feefe8e8c8.png",
+      "anchors": "梅紫与赭金、契纸、银秤、印匣"
+    }
+  ],
+  "batches": [
+    {
+      "usage": "世界与入口",
+      "promptSummary": "春日高机位宅院和明亮门槛催账；压力由契纸、人物姿态和受阻门槛表达。",
+      "assets": [
+        ["app/assets/bg/compound_new_guofeng.webp", "codex-imagegen:exec-c623d43c-e15a-4472-b9f4-f748ad848b56.png"],
+        ["app/assets/scene/gate_collector.webp", "codex-imagegen:exec-a7b0d1b1-e316-41b6-ad57-86d009bfbada.png"]
+      ]
+    },
+    {
+      "usage": "五人前奏与关系落定",
+      "promptSummary": "同一身份母版的夜间关系 CG；以目光、开掌、钥匙、出口和共享日用表达成年人的主动选择，完整着装，无性行为。",
+      "assets": [
+        ["app/assets/cg/yue/prelude.webp", "codex-imagegen:exec-1ac36cb6-30a6-413d-812c-4b1b482b8b2a.png"],
+        ["app/assets/cg/yue/explicit.webp", "codex-imagegen:exec-65126819-70a1-4773-9759-706eaf51e6e1.png"],
+        ["app/assets/cg/pan/prelude.webp", "codex-imagegen:exec-dcd0c85d-b0b1-4ae3-973f-40f8e2fa65e5.png"],
+        ["app/assets/cg/pan/explicit.webp", "codex-imagegen:exec-ae6c99ab-27ce-4652-81d1-2af468e8260a.png"],
+        ["app/assets/cg/pinger/prelude.webp", "codex-imagegen:exec-01830d1b-2d87-4e97-b97c-92f15ced287c.png"],
+        ["app/assets/cg/pinger/explicit.webp", "codex-imagegen:exec-a985ad93-a833-4272-b41e-ed493997eca4.png"],
+        ["app/assets/cg/meng/prelude.webp", "codex-imagegen:exec-f6a3adb4-0335-497b-8509-ee2c09f61780.png"],
+        ["app/assets/cg/meng/explicit.webp", "codex-imagegen:exec-00c1529b-543e-42fc-8dad-3de16000a529.png"],
+        ["app/assets/cg/xuee/prelude.webp", "codex-imagegen:exec-48622697-5ef3-443e-9a34-83e4a9c25859.png"],
+        ["app/assets/cg/xuee/explicit.webp", "codex-imagegen:exec-216df76e-b036-443a-9e70-529f2b12cdba.png"]
+      ]
+    },
+    {
+      "usage": "五人公开关系与共同办事",
+      "promptSummary": "五人以交叉视线、递证、按账、留座和轮值器物形成真实关系动作，不做并排群像。",
+      "assets": [
+        ["app/assets/cg/group/public_day5.webp", "codex-imagegen:exec-32d97fcc-b83b-41f4-8bae-d8e5bf286910.png"],
+        ["app/assets/cg/group/public_day10.webp", "codex-imagegen:exec-60f375a8-ae0f-426d-9de2-fdbda4649142.png"],
+        ["app/assets/cg/group/public_day15.webp", "codex-imagegen:exec-0be274e2-1562-4cb6-9354-7d437b27aa43.png"],
+        ["app/assets/cg/group/inner_court_alliance.webp", "codex-imagegen:exec-7651ef0d-f27b-4ed1-86f7-7aaa5d049f99.png"],
+        ["app/assets/cg/group/inner_court_accord_five.webp", "codex-imagegen:exec-1bc7fb07-e6df-4974-b802-69f6f32cf44b.png"],
+        ["app/assets/cg/group/inner_court_afterglow_five.webp", "codex-imagegen:exec-19692392-08c1-4eeb-8c63-ea86b1a2e07b.png"]
+      ]
+    },
+    {
+      "usage": "五组双院结果",
+      "promptSummary": "两名对应成年女性共同作用于一件证物；脸、衣色、器物和方法冲突继承身份母版。",
+      "assets": [
+        ["app/assets/cg/joint/yue_pan.webp", "codex-imagegen:exec-74e2b0e8-c46f-45c7-8ee6-e4ee651bd56d.png"],
+        ["app/assets/cg/joint/yue_pinger.webp", "codex-imagegen:exec-35f35c39-8dfc-40b2-bfaa-f6071929cdb0.png"],
+        ["app/assets/cg/joint/pan_pinger.webp", "codex-imagegen:exec-a0bb4acc-0a64-444d-9c5a-30b2d0fad595.png"],
+        ["app/assets/cg/joint/yue_meng.webp", "codex-imagegen:exec-02c5f590-a171-4fa0-8a79-b0324079a512.png"],
+        ["app/assets/cg/joint/pan_xuee.webp", "codex-imagegen:exec-5af38352-b063-4dbe-9b4a-af807faa2f94.png"]
+      ]
+    },
+    {
+      "usage": "五张个人终章与命数空宅",
+      "promptSummary": "人物用钥匙、席位、退路、名帖、停灶和轮值执行最后规则；命数页以无人空宅、六把钥匙和五张名签承接固定历史。",
+      "assets": [
+        ["app/assets/cg/finale/yue.webp", "codex-imagegen:exec-a0272894-bfa1-44e7-a15f-a749322db57f.png"],
+        ["app/assets/cg/finale/pan.webp", "codex-imagegen:exec-4ab8a42b-3d8b-4f81-8864-82ec3366b40f.png"],
+        ["app/assets/cg/finale/pinger.webp", "codex-imagegen:exec-8c08054f-b78f-492d-8187-6b80dcaecc73.png"],
+        ["app/assets/cg/finale/meng.webp", "codex-imagegen:exec-d3764cf3-67a3-4ae7-b98d-1b4f26083aea.png"],
+        ["app/assets/cg/finale/xuee.webp", "codex-imagegen:exec-ed7203e7-bcbb-4829-b1c1-417ee44cedf8.png"],
+        ["app/assets/cg/finale/fate_coda.webp", "codex-imagegen:exec-c29af8f8-fca4-4f71-aef0-5af5a4dd4d2a.png"]
+      ],
+      "editNote": "月娘、瓶儿、雪娥终章使用 image_gen 二次编辑清除模型伪文字。"
+    },
+    {
+      "usage": "五张中局转折",
+      "promptSummary": "空主位与轮值钥匙、矛盾口风与封口银、破锁空匣与退路、名帖网络、冷灶拒印分别成为可读危机。",
+      "assets": [
+        ["app/assets/cg/milestone/yue.webp", "codex-imagegen:exec-a84bb537-8fc2-4844-9d40-f6552b28fb4c.png"],
+        ["app/assets/cg/milestone/pan.webp", "codex-imagegen:exec-debb4c41-2c4e-41b8-8eff-3e1a272184ec.png"],
+        ["app/assets/cg/milestone/pinger.webp", "codex-imagegen:exec-43cace36-0bee-41d1-aa84-798882ad6d49.png"],
+        ["app/assets/cg/milestone/meng.webp", "codex-imagegen:exec-3adba92b-e8cf-4103-adf7-ac81026dbf41.png"],
+        ["app/assets/cg/milestone/xuee.webp", "codex-imagegen:exec-de699d51-80ee-4cc5-93d7-c0553f705f0f.png"]
+      ],
+      "editNote": "月娘、玉楼、雪娥转折图使用 image_gen 二次编辑清除模型伪文字。"
+    }
+  ],
+  "postProcessing": {
+    "command": "cwebp -q 88 -m 6 -metadata none",
+    "assetCount": 41,
+    "totalBytes": 10938766,
+    "intermediatePolicy": "image_gen 原始 PNG 留在工具缓存，不复制进仓库；运行目录只保留四十一张新 WebP。",
+    "reproducible": false
+  },
+  "acceptance": "人工巡检身份母版、个人夜景、五人群像、双院结果、终章与中局转折；浏览器 QA 另验证四十一张 URL 解码、旧资产清零、目标视口、流程输入和控制台。"
+}

package/lib/novel-to-game/examples/jin-ping-mei/example.json

@@ -0,0 +1,12 @@
+{
+  "language": "zh-Hans",
+  "title": "金瓶梅 · 风月总账",
+  "targetFinish": "playable-prototype",
+  "source": {
+    "chapters": 100,
+    "headingPattern": "^\\s*第([〇零○一二三四五六七八九十百]+)回\\s+(.+?)\\s*$",
+    "numeral": "chinese"
+  },
+  "coverageHeading": "全书覆盖",
+  "citationPattern": "第(\\d{1,3})(?:\\s*[-–—至]\\s*(\\d{1,3}))?回"
+}

package/lib/novel-to-game/examples/jin-ping-mei/qa/README.md

@@ -0,0 +1,31 @@
+# QA 证据说明
+
+本 example 只保留发布门禁需要的压缩证据与一张轻量渲染快照；浏览器驱动、完整输入轨迹和逐屏截图都留在仓库外临时工作区。
+
+2026-08-22 的最终候选完成了以下验证：
+
+- 逻辑账本基线 `d3f4087` 为 320/320；基线后唯一的引擎差异是把隐藏的关系数值摘要改成定性文案，当前候选已用定向断言复核。
+- Chromium 145 在正常速度下，以全键盘 Enter 激活 551 个可见控件，经过 552 个唯一状态到达第二十日结局，并成功重开到第一日。
+- 390×844、768×1024、1024×768、1280×800、1920×1080、2048×973 六个视口都走到结局；主游玩面板实际溢出为 0，浏览器错误数组为空。
+- 年龄确认前只请求封面与宅院两张启动图，共 653,950 bytes；成人内容资源请求为 0。
+- 临时请求拦截分别阻断一张安全关键图和一张持久场景册成人图，两条路径都进入 `#asset-error`，没有继续显示残页。
+
+压缩结果见 `verification.json` 与 `evidence/run.json`。这些证据不证明主观趣味、长期平衡、其他浏览器或所有结局。
+
+2026-08-25 的表现层重塑没有改规则、状态、存档或完成条件，因此没有把旧的正常速度完整路径伪装成
+一次新跑。当前构建另做了 566 次可见控件的快速视觉烟测，重新到达第二十日结局；41 张运行图全部
+解码，1280×800、1600×800 与 390×844 的年龄门／首屏和桌面关键流程无水平溢出、控制台错误或请求
+失败。仓内 `final-screen.webp` 保留表现层复核前的终局基线；复核后的桌面角色抉择、桌面终局和
+390×844 终局分别见 `evidence/visual-review-dialogue-after.jpg`、
+`evidence/visual-review-ending-after.jpg` 与 `evidence/visual-review-ending-mobile-after.jpg`。权威正常速度
+完整路径仍明确属于上面的 2026-08-22 候选。
+
+仓内另提供一条不依赖浏览器的可执行改编合同：
+
+```bash
+node examples/jin-ping-mei/qa/verify_playable_model.mjs
+```
+
+它对照 `playable-model.json` 与实际 `data.js` / `engine.js`，验证两种正堂起手的差异、三拍回响、非空
+回调载荷、证物来源与消费边界、同 seed 确定性、存档重演与分支污染拒绝。它不调用第 5/15/20 日、
+结局、一月笺或命数消费者，是设计回归，不冒充上面的真实渲染、输入或完整二十日证据。

package/lib/novel-to-game/examples/jin-ping-mei/qa/playable-model.json

@@ -0,0 +1,99 @@
+{
+  "schemaVersion": 1,
+  "source": "design/GAME_DESIGN.md#10-可执行切片合同",
+  "experienceProfile": "narrative-led",
+  "buildPath": "custom",
+  "versions": {
+    "contentRevision": "NOT_AVAILABLE: 现有候选早于内容修订号拆分",
+    "rulesRevision": "NOT_AVAILABLE: 现有候选早于规则修订号拆分",
+    "saveSchema": 67
+  },
+  "stateSurface": {
+    "resources": {
+      "initial": {
+        "silver": 220,
+        "power": 2,
+        "repute": 3,
+        "exposure": 0,
+        "strain": 0,
+        "house": 65
+      }
+    },
+    "relationshipActors": [
+      "wu_yueniang",
+      "pan_jinlian",
+      "li_pinger",
+      "meng_yulou",
+      "sun_xuee"
+    ],
+    "dayActions": ["ledger", "office", "listen", "banquet"],
+    "eventLog": "history",
+    "knowledgeLedger": "secrets"
+  },
+  "openingActions": [
+    {
+      "id": "opening_open_ledger",
+      "expected": {
+        "flag": "opened_true_ledger",
+        "absentFlag": "heard_all_five",
+        "house": 69,
+        "bonds": {
+          "wu_yueniang|li_pinger": 6,
+          "wu_yueniang|sun_xuee": 7
+        }
+      }
+    },
+    {
+      "id": "opening_hear_five",
+      "expected": {
+        "flag": "heard_all_five",
+        "absentFlag": "opened_true_ledger",
+        "house": 65,
+        "bonds": {
+          "pan_jinlian|meng_yulou": -1,
+          "pan_jinlian|sun_xuee": 10
+        }
+      }
+    }
+  ],
+  "callbacks": [
+    "publicEcho",
+    "day15Text",
+    "finalText",
+    "endingTexts",
+    "epilogueTexts",
+    "fateText"
+  ],
+  "knowledgeProbe": {
+    "opening": "opening_open_ledger",
+    "action": "listen",
+    "factId": "missing_fifty",
+    "source": "正堂开账听来的口风",
+    "confidence": "待互证",
+    "expiresOn": 7
+  },
+  "replay": {
+    "seed": 42,
+    "openingAftermathBeats": 3,
+    "expectedDayPhase": "day",
+    "tamperedStateMustBeRejected": true
+  },
+  "validationPaths": {
+    "primary": {
+      "opening": "opening_open_ledger",
+      "aftermathAdvances": 3,
+      "expectedFlag": "opened_true_ledger",
+      "absentFlag": "heard_all_five",
+      "expectedHouse": 69,
+      "expectedFeedback": "openingMemory 非空回调载荷存在"
+    },
+    "adjacentCounterexample": {
+      "opening": "opening_hear_five",
+      "aftermathAdvances": 3,
+      "expectedFlag": "heard_all_five",
+      "absentFlag": "opened_true_ledger",
+      "expectedHouse": 65,
+      "expectedFeedback": "openingMemory 非空回调载荷存在且分支摘要不同"
+    }
+  }
+}

package/lib/novel-to-game/examples/jin-ping-mei/qa/verification.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": 3,
+  "status": "PASS",
+  "verify": {
+    "command": "临时外部验证器：d3 账本基线 + 当前引擎定性摘要 + 关键资源失败拦截 + Chromium 当前候选全键盘路径 + 六视口布局路径",
+    "exitCode": 0
+  },
+  "completeRun": {
+    "id": "jin-ping-mei-release-candidate-2026-08-22",
+    "cleanContext": true,
+    "terminal": "day-20-unstable-ending",
+    "restart": "day-1-opening",
+    "evidence": "qa/evidence/run.json"
+  },
+  "checks": {
+    "launch": "PASS",
+    "render": "PASS",
+    "input": "PASS",
+    "coreLoop": "PASS",
+    "outcome": "PASS",
+    "restart": "PASS"
+  },
+  "limitations": [
+    {
+      "scope": "逻辑账本",
+      "reason": "320/320 来自 d3f4087 基线；其后唯一引擎差异是将隐藏的数值关系摘要改为定性文案，当前候选已做定向断言。"
+    },
+    {
+      "scope": "浏览器与路径",
+      "reason": "当前候选在本机 Chromium 完成正常速度键盘主路径和六个目标视口；未穷举其他浏览器与所有结局。"
+    },
+    {
+      "scope": "体验判断",
+      "reason": "证据只证明可运行、可输入、可走完、可重开及布局约束，不把主观趣味或长期平衡宣称为确定结论。"
+    },
+    {
+      "scope": "2026-08-25 表现层重塑",
+      "reason": "当前视觉候选完成三视口关键流程与快速结局烟测；没有把它表述为一次新的正常速度全路径权威验证，原完整路径证据仍属于 2026-08-22 候选。"
+    }
+  ]
+}

package/lib/novel-to-game/examples/jin-ping-mei/qa/verify_playable_model.mjs

@@ -0,0 +1,129 @@
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const contract = JSON.parse(readFileSync(resolve(here, 'playable-model.json'), 'utf8'));
+const data = await import(resolve(here, '../build/app/js/data.js'));
+const engine = await import(resolve(here, '../build/app/js/engine.js'));
+
+const digest = (value) => createHash('sha256').update(JSON.stringify(value)).digest('hex');
+const assertText = (value, label) => assert.equal(typeof value === 'string' && value.length > 0, true, label);
+
+function finishOpening(state) {
+  let beats = 0;
+  while (state.phase === 'opening_aftermath') {
+    const current = engine.currentOpeningAftermath(state);
+    assert.ok(current?.current, '开场后章必须存在当前拍');
+    assert.equal(engine.advanceOpeningAftermath(state).ok, true);
+    beats += 1;
+  }
+  assert.equal(beats, contract.replay.openingAftermathBeats);
+  assert.equal(state.phase, contract.replay.expectedDayPhase);
+}
+
+function runOpening(action) {
+  const state = engine.newGame(contract.replay.seed);
+  assert.deepEqual(state.resources, contract.stateSurface.resources.initial);
+  assert.deepEqual(Object.keys(state.relations), contract.stateSurface.relationshipActors);
+  const eventLog = state[contract.stateSurface.eventLog];
+  const knowledgeLedger = state[contract.stateSurface.knowledgeLedger];
+  assert.equal(Array.isArray(eventLog), true, '事件日志字段必须指向数组');
+  assert.equal(Array.isArray(knowledgeLedger), true, '知识账字段必须指向数组');
+  assert.equal(engine.chooseOpening(state, action.id).ok, true);
+  assert.equal(eventLog.length, 1);
+  assert.deepEqual(eventLog[0], {
+    day: 1,
+    type: 'opening',
+    choice: action.id,
+    public: true,
+  });
+  assert.equal(state.flags[action.expected.flag], true);
+  assert.equal(state.flags[action.expected.absentFlag], undefined, '未选起手不得污染 history/flags');
+  assert.equal(state.resources.house, action.expected.house);
+  for (const [key, value] of Object.entries(action.expected.bonds)) assert.equal(state.bonds[key], value, key);
+
+  finishOpening(state);
+  const memory = engine.openingMemory(state);
+  assert.equal(memory.choice, action.id);
+  for (const field of contract.callbacks) {
+    if (field === 'endingTexts' || field === 'epilogueTexts') {
+      assert.equal(Object.keys(memory[field]).length, 5, `${field} 应提供五份长期回调载荷`);
+      for (const text of Object.values(memory[field])) assertText(text, `${field} 不得为空`);
+    } else assertText(memory[field], `${field} 不得为空`);
+  }
+
+  const options = engine.dayOptions(state);
+  assert.deepEqual(options.map(({ id }) => id), contract.stateSurface.dayActions);
+  assert.equal(options.filter(({ resolvesPressure }) => resolvesPressure).length >= 1, true);
+
+  const serialized = engine.serialize(state);
+  assert.deepEqual(engine.deserialize(serialized), state, '合法 snapshot 必须从 history 重演通过');
+  const tampered = JSON.parse(serialized);
+  tampered.flags[action.expected.absentFlag] = true;
+  assert.equal(engine.deserialize(JSON.stringify(tampered)), null, '未选分支注入必须拒读');
+
+  return {
+    state: engine.snapshot(state),
+    digest: digest(state),
+  };
+}
+
+function verifyKnowledgeLedger() {
+  const probe = contract.knowledgeProbe;
+  const state = engine.newGame(contract.replay.seed);
+  assert.equal(engine.chooseOpening(state, probe.opening).ok, true);
+  finishOpening(state);
+  assert.equal(engine.chooseDayAction(state, probe.action).ok, true);
+  assert.equal(state[contract.stateSurface.knowledgeLedger].includes(probe.factId), true, '知识账必须记录已获知事实');
+  const fact = engine.secretInventory(state).find(({ id }) => id === probe.factId);
+  assertText(fact?.label, '证物标签不得为空');
+  assert.deepEqual(fact, {
+    id: probe.factId,
+    label: fact.label,
+    source: probe.source,
+    confidence: probe.confidence,
+    expiresOn: probe.expiresOn,
+    expired: false,
+    selected: false,
+  });
+  assert.equal(state.selectedSecret, null, '获得事实不等于已经选择提交');
+  assert.deepEqual(state.secretsUsed, [], '未选择的事实不得被动作标成已消费');
+  assert.equal(state.history.at(-1).secretUsed, null, '事件日志不得伪造事实消费');
+
+  const tampered = JSON.parse(engine.serialize(state));
+  tampered.secretsUsed.push(probe.factId);
+  assert.equal(engine.deserialize(JSON.stringify(tampered)), null, '伪造已消费事实必须拒读');
+}
+
+assert.equal(contract.schemaVersion, 1);
+assert.equal(contract.source, 'design/GAME_DESIGN.md#10-可执行切片合同');
+assert.equal(contract.experienceProfile, 'narrative-led');
+assert.equal(contract.buildPath, 'custom');
+assert.match(contract.versions.contentRevision, /^NOT_AVAILABLE:/);
+assert.match(contract.versions.rulesRevision, /^NOT_AVAILABLE:/);
+assert.equal(engine.SAVE_VERSION, contract.versions.saveSchema);
+assert.equal(contract.replay.tamperedStateMustBeRejected, true, '合同必须门控伪造状态拒读');
+assert.equal(contract.validationPaths.primary.opening, contract.openingActions[0].id);
+assert.equal(contract.validationPaths.adjacentCounterexample.opening, contract.openingActions[1].id);
+for (const [index, path] of Object.values(contract.validationPaths).entries()) {
+  const action = contract.openingActions[index];
+  assert.equal(path.aftermathAdvances, contract.replay.openingAftermathBeats);
+  assert.equal(path.expectedFlag, action.expected.flag);
+  assert.equal(path.absentFlag, action.expected.absentFlag);
+  assert.equal(path.expectedHouse, action.expected.house);
+  assertText(path.expectedFeedback, '固定验证路径必须声明预期反馈');
+}
+assert.deepEqual(Object.keys(data.DAY_ACTIONS), contract.stateSurface.dayActions);
+assert.deepEqual(data.HEROINE_IDS, contract.stateSurface.relationshipActors);
+assert.deepEqual(data.OPENING_CHOICES.map(({ id }) => id), contract.openingActions.map(({ id }) => id));
+
+const firstRuns = contract.openingActions.map(runOpening);
+const replayRuns = contract.openingActions.map(runOpening);
+assert.deepEqual(replayRuns.map(({ digest: value }) => value), firstRuns.map(({ digest: value }) => value));
+assert.notEqual(firstRuns[0].digest, firstRuns[1].digest, '两条起手必须产生可区分状态');
+verifyKnowledgeLedger();
+
+console.log('可执行改编合同：2 条起手、3 拍回响、非空回调载荷、知识来源、确定性重放与分支污染拒绝均一致');