@oh-story/dsh 0.1.9 → 0.1.11

package/lib/novel-to-game/skills/game-build/references/build-brief-contract.md

@@ -1,109 +1,72 @@
 # 构建说明契约
 
-构建说明只约束产品边界、实际运行方式和证明方式；不要规定实现模型能从环境正确决定的类、着色器、
-框架或文件拆分。
+只压缩产品边界、必须保真的体验、实际运行方式与证据；不规定实现模型能自行决定的技术结构。
+以下是交接骨架，按项目填相关内容，不为空白补造系统。
 
 ```text
-# 成品目标
-targetFinish: [逐字继承 PRODUCT_BRIEF]
+# 目标与设计
+targetFinish: [继承 PRODUCT_BRIEF]
 buildStage: [whitebox | production]
 buildPath: [template | custom]
-[目标平台、目标交付物、受众、切片时长、视口/朝向/输入、分级、联网边界]
-
-# 必读设计
-- whitebox: [GAME_DESIGN.md]
-- production: [GAME_DESIGN.md, ART_DIRECTION.md]
+[平台、交付物、受众、范围、视口/输入、分级、联网边界]
+[whitebox 读取 GAME_DESIGN；production 追加 ART_DIRECTION]
 
 # 必须保真
-- 玩家承诺与核心幻想
-- experienceProfile: [逐字继承 GAME_DESIGN]
-- 3–5 个核心动词及各自输入、可观察状态变化
-- 会改变结果的规则、三段弧结束标记
-- 界面语言、人物声口和禁用句式
-- 叙事项目追加主要路径、结局条件、持久旗标读取点和人物知识边界
-- production 追加：每个界面/模式的招牌时刻、HUD 层级、主游玩面板的单焦点阅读边界与美术禁区
-
-# 可执行模型（两阶段都需要）
-- 最大风险与原型形态；采用 template 时列语法与脱离条件，custom 时列不可被模板替代的核心动词
-- 运行时真正消费的最小状态、动作、前置、效果、观察者/知识更新、事件和不变量
-- signature_command: [N/A，或 id / label / intents / slots / validators / commit；具体数量服从项目]
-- 到期事项与谈话回灌（实际采用时）：来源、due/trigger、携带事实、重新上桌、结清；谈话只提交已验证结构
-- contentRevision / rulesRevision / saveSchemaVersion / seed
-- snapshot 用于载入，event log 用于定位与重放；两者不能互相冒充
-- 固定验证路径：初态摘要、输入序列、预期终态/反馈、相邻反例
-- 反馈 patch：issue id、owner、目标节点、兼容性、受影响路径与重放结果
-
-# 范围
-[必须包含；明确排除；最终范围差异]
-
-# 运行与验证
+experienceProfile: [继承 GAME_DESIGN]
+[玩家承诺、核心动作及可观察变化、会改变结果的规则和结束标记]
+[产物语言与原作身份；叙事实际采用时记录路径、历史读取点和知识边界]
+[production 继承关键游戏时刻、视觉约束与批准目标图]
+
+# 最小实现与复现
+[最大风险、原型形态、复用语法及脱离条件]
+[运行时消费的状态、动作、前置、效果与不变量]
+[初态、输入路径、预期结果；随机性相关时固定 seed]
+[仅在采用生成式输入、知识权限、事件回放、存档迁移或专属命令时追加对应可执行模型合同]
+signature_command: [N/A，或继承 id / label / intents / slots / validators / commit]
+
+# 运行
 toolchain:
   targetPlatform: [批准平台]
-  targetRuntime: [计划交付的运行环境]
-  testedRuntime: [本次实际启动的运行环境]
+  targetRuntime: [计划交付环境]
+  testedRuntime: [本次实际启动环境]
   engine: [实际引擎/框架]
-  engineVersion: [实际版本或 NOT_AVAILABLE: 原因]
-  runtimeVersion: [实际版本或 NOT_AVAILABLE: 原因]
+  engineVersion: [版本或 NOT_AVAILABLE: 原因]
+  runtimeVersion: [版本或 NOT_AVAILABLE: 原因]
   packageManager: [name@version；无则 none]
 commands:
   install: [命令；无需安装写 NONE]
   buildOrExport: [命令；无需单独构建写 NONE]
   start: [命令]
-  modelCheck: [whitebox 的最窄模型/回放检查；production 可写 NONE]
-  verify: [production 的一条权威验证命令；whitebox 写 NOT_APPLICABLE]
+  modelCheck: [whitebox 的最窄风险检查；production 可写 NONE]
+  verify: [production 权威命令；whitebox 写 NOT_APPLICABLE]
 verification:
   owner: [whitebox 为 design owner；production 为 game-qa]
-  evidence: [whitebox 的结构化观察，或 production 完整运行生成的工作区相对路径]
+  evidence: [工作区相对路径]
 
-# 当前限制
-[scope / reason；testedRuntime 与 targetRuntime 不同时列目标独有未测试项]
+# 限制
+[实际范围差异、未测试项与原因；替代运行时不证明目标平台]
 ```
 
-## 最小完成证据
-
-whitebox 只证明被选中的最大风险：规则/场景模型能启动，固定路径可运行与重放，偏差能定位回
-GAME_DESIGN；不要求 ART_DIRECTION、最终 HUD、完整路径或 `qa/verification.json`，也不进入六项 QA 结论。
-
-production 的权威 verify 必须能在一次完整路径中证明：启动成功、非空且变化的真实渲染、真实输入改变状态、核心
-循环完成、至少一个设计结果可达、restart 回到定义初态。构建阶段只准备入口和可观察状态；由
-`game-qa` 实际运行一次并写结论。证据使用工作区相对路径，不能只留临时目录或逐点击截图。
-
-可执行模型、事件日志或 patch 存在时，verify 还应在项目回归中证明同版本同 seed/输入可重放、非法
-前置不提交、未选择分支不污染、未见证者不引用秘密，以及 patch 声明外的状态不变。这些诊断映射回
-六项玩家效果或写 limitation，不新增顶层 QA gate。
-
-测试环境与目标运行环境不同时，这六项只声明实际覆盖；源码身份、公网、营销、主观趣味、权利
-判断和完成度声明不进入这六项机器事实。
-
-## 条件台账
-
-### 视觉与必需资产
-
-只列批准的焦点资产与招牌时刻：资产键、生产状态、工作区证据和剩余问题。必需运行期资产失败必须
-阻断或进入明确错误界面；可降级项须预先写 fallback，并证明核心动作、状态、结果、可读反馈和重开
-仍成立。
-
-同时继承 `ART_DIRECTION.md` 的明度边界。非低照度题材检查首屏、核心循环、夜景和结果页，禁止用
-未经批准的全局黑罩、暗角、降曝光或灰色小字替代气氛设计；夜景至少能辨认人物轮廓与朝向、关键器物、
-行动目标、正文／选项和结果信号。批准的暗调界面须保留约定的亮度或高对比 fallback，并在目标视口
-用实际交互画面验证，而不是只验静态海报。
-
-时代题材另列目标图批准状态和三轴合同：世界时代、表现媒介、人物理想化程度。未批准前只生产最小
-样张；批准后批量资产必须引用目标图与身份母版，并继承光色、构图和文本留白。若用户否决样张，构建
-立即停止同方向扩批，替换所有运行引用并从发布目录清掉旧图、试验图和未引用变体。
+## 完成证据
 
-### 连续 3D
+whitebox 只证明选中的最大风险，保留可复现的实际观察并定位回 GAME_DESIGN；
+不要求最终美术、完整产品路径或 `qa/verification.json`，不进入六项 QA 结论。
 
-采用连续 3D 时记录输入控制权、相机/移动前向、失焦归零，以及会改变路线的可见布局与 collider
-边界。不要把渲染帧率或一条成功路线当碰撞证明。
+production 的权威 verify 必须在同一次完整运行中证明启动、真实渲染、真实输入、核心循环、
+至少一个设计结果与重开。证据留在工作区，不只保存在临时目录。
+构建者准备入口，不预填 PASS；game-qa 记录实际命令、退出码和结果。
 
-### 动态媒体与语音
+允许定向检查、修复和复跑；最终 `qa/verification.json` 原子替换为当前完整运行结果，
+失败不得残留旧 PASS，也不能拼接不同版本或不同运行的六项成功。
+有事件、知识权限或 patch 时，将其相关回归纳入项目验证，不另设顶层通用门禁。
 
-只记录游戏实际采用的媒体或语音资产、来源、运行文件、字幕/静音/缺音 fallback 和生成状态。密钥
-不入库；未生成写 `NOT_RUN: 原因`。生成请求、营销旁白和可重建中间文件不作为最小 QA 证据。
+## 按需交接
 
-## 权威验证
+- 视觉：只列批准的焦点资产、生产状态、运行中证据和剩余问题，继承 ART_DIRECTION，不重新裁决风格。
+  必需资产失败须明确报错；可降级项采用预先定义的替代，并验证玩家效果仍成立。
+- 连续 3D：记录控制权、相机/移动前向、失焦归零，以及改变路线的布局与碰撞边界；
+  帧率或一条成功路线不证明碰撞正确。
+- 动态媒体/语音：记录实际资产、来源、运行文件、字幕/静音/缺音替代与生成状态，
+  不把生成请求或营销旁白当成游戏运行证据。
 
-verify 可以组合现有游戏效果脚本，但最终 QA 只运行一次；由 `game-qa` 在 `qa/verification.json`
-回写实际 command、exit code、完整路径、六项结果和当前限制。构建者不得预填 PASS 或另跑一套平行
-验收。预算、时间或调用上限只会留下 NOT_RUN/FAIL、延期或缩小范围，不会替代证据。
+预算或工具缺口只能产生明确限制、NOT_RUN/FAIL 或经批准的范围调整，不能替代证据。

package/lib/novel-to-game/skills/game-build/references/generative-media-pipeline.md

@@ -1,56 +1,25 @@
 # 动态媒体生产合同
 
-仅当 `ART_DIRECTION.md` 已选择视频过场、环境循环或关键帧演出时使用。本文只规定改编连续性与
-交接边界；图片、视频工具和模型由当前环境决定，使用前按其官方文档核实能力、许可、费用与输出格式。
-
-动态媒体负责表现已批准的角色、场景和剧情状态，不重新设计人物身份、空间地理、玩法结果或镜头用途。
-
-## 采用判断
-
-- 固定构图、无需玩家改变视角或空间关系的短演出适合预渲染媒体。
-- 输入会改变视角、位置、碰撞或战术信息时使用实时场景，不用视频伪装交互。
-- 每条动态媒体都必须有静帧或低动效表达；跳过或降级后仍保留信息、节拍、输入机会和结果。
-- 只有 brief 明确把该媒体列为必需玩家效果时，缺失才阻断完整路径；否则使用已登记的 fallback，
-  并把完成度差异写入 limitation。
+仅在 ART_DIRECTION 选择动态媒体时使用。工具和模型由环境决定，使用前核实当前能力、许可与费用。
+媒体表现批准的状态，不重新决定人物身份、地理或玩法结果；需要改变视角、位置或空间关系时不能用视频伪装交互。
 
 ## 最小台账
 
-不要为每个供应商建立一套目录和审批流。在 BUILD_BRIEF 或资产台账中每条只记录：
-
-`asset_key | state_trigger | duration | references | locked_facts | allowed_motion | start_boundary | end_boundary | output | fallback | provenance | status`
-
-- `references`：已批准的角色、造型、场景或构图参考；声明各自允许控制的事实。
-- `locked_facts`：不得漂移的身份、服装、地理、道具状态、色板与材质。
-- `allowed_motion`：本镜允许发生的角色动作、状态变化和运镜，不重描外观。
-- `start_boundary` / `end_boundary`：镜头两端的位置、朝向、持物、服装、光线和剧情状态。
-- `provenance`：输入与输出的来源、权利边界和工作区路径；真实人物参考须有明确授权。
-
-## 生产顺序
-
-1. 先冻结持久事实与本镜临时状态，再生成关键帧或动态结果；不要用提示词临时补设计空白。
-2. 已有可用参考时做受控变体，只描述本镜差量；没有参考时才从风格与事实锁生成第一张基准图。
-3. 先用低成本草稿检查身份、构图、动作和边界，成立后再产最终尺寸；不要把分辨率当连续性。
-4. 输出立即保存到工作区并使用稳定文件名；临时下载地址、供应商任务页和缓存不是游戏资产。
-5. 密钥只留在受信环境。只在复现故障确有需要时保留去密钥请求摘要，不默认归档完整 API 往返。
-
-## 连续性检查
+在 BUILD_BRIEF 或资产台账记录：
 
-对每条媒体只检查会影响玩家理解的事实：
+`asset_key | state_trigger | references | locked_facts | allowed_motion | start_boundary | end_boundary | output | fallback | provenance | status`
 
-- 首、中、尾代表帧中的角色身份、临时造型、场景地理、道具状态和色板没有无依据漂移；
-- 上一镜 `end_boundary` 能接到下一镜 `start_boundary`；
-- 设计规定的状态变化发生在正确镜头，未提前泄露或丢失；
-- 没有凭空增加人物、道具、肢体或第二个主角；
-- 正常速度下动作、字幕与输入窗口可读，跳过后仍进入同一合法状态。
+- 参考声明允许控制的事实；锁定身份、服装、地理、道具状态与已批准风格。
+- 本镜只改变允许的动作与状态；开始/结束边界需能衔接相邻镜头。
+- 来源与权利可追溯，真实人物参考须有明确授权；不上传与本资产无关的原文或私人信息。
 
-这是构建检查，不新增真人审片或独立 QA 门禁。审美偏好保留为主观风险；只有身份、状态、边界或
-可读性破坏批准设计时才回流修复。
+## 连续性与运行验证
 
-## 接入与失败
+检查代表帧中的身份、地理和道具是否漂移，状态变化是否发生在正确镜头，
+是否泄露未获知事实；已有参考时用其约束变体，不用提示词临时补设计空白。
 
-- 由游戏状态机触发，预载、播放、跳过、失焦、静音和资源释放行为必须明确。
-- 运行环境不能解码最终格式时，在构建期转成目标环境支持的格式，不在运行时临时请求供应商。
-- 可降级资产失败时落到台账中的 fallback；必需资产失败时显示明确错误并让对应玩家效果 FAIL。
-- 项目自己的媒体诊断映射回既有六项可玩结果，不生成媒体专属 PASS、报告或重复证据对象。
+在实际触发位置验证播放、跳过与降级。跳过或低动效版本仍进入同一合法状态，
+保留必要信息、输入机会和结果。最终运行文件保存在工作区，供应商任务页不是资产。
 
-BUILD_BRIEF 字段见 [build-brief-contract.md](build-brief-contract.md)。
+必需媒体失败时明确报错；可降级媒体采用已定义替代并记录完成度差异。
+相关诊断映射到现有六项玩家效果或 limitation，不另造媒体 QA 等级。

package/lib/novel-to-game/skills/game-build/references/playable-model-contract.md

@@ -1,81 +1,46 @@
 # 可执行改编模型合同
 
-可执行模型只保存当前候选运行时必须消费的因果语义，不复制策划理由、美术方向或整份内容库。若项目
-已有代码原生状态机、对话引擎、规则表或引擎场景图，可直接把它声明为模型；不要为了文件名再造一份
-平行 JSON/YAML。独立数据文件只有在运行时实际加载，或作为测试合同逐项对照实现时才存在。
+仅在生成式自由输入、知识权限、事件回放、存档迁移或专属命令需要时读相关部分。
+复用已有状态机、对话引擎或场景图，不为了合同再造平行 JSON/YAML；
+独立数据只有被运行时消费或被测试逐项对照时才存在。
 
-## 选择原型与构建路径
+## 生成模型与规则的边界
 
-先按最大风险选白盒：
+模型可解释输入、提出动作候选、写对白或表达已确认结果；规则器唯一提交时间、资源、位置、
+物件、知识、承诺、胜负与事件。候选按适用的 schema、前置、数值范围、知识权限和原作边界验证。
 
-| 风险 | 最小可用形态 | 不能据此证明 |
-|---|---|---|
-| 知识、承诺、分支回响 | 文本/场景状态沙箱 | 操作手感、空间与镜头 |
-| 资源、门槛、策略反制 | 回合状态板或桌面沙箱 | 实时节奏与物理 |
-| 两层互相读写 | 场景叙事 + 最小系统 | 未实现层的完整质量 |
-| 走位、视线、相机、物理 | 目标引擎灰盒 | 最终美术完成度 |
+表现层只读取已提交状态。换文字、镜头、动画或三维表现不能改变因果、观察者、归属或后续回读。
+秘密、证词与误判区分世界事实、玩家知道、人物知道或相信；普通事实不维护多层知识模型。
 
-`template` 表示已有交互语法能直接承载核心动词；记录模板提供什么、原作改变什么、何时必须退出模板。
-`custom` 表示核心动作依赖模板没有的操作或世界规则。路径只决定复用方式，不决定题材或成色。
+## 身份专属命令
 
-## 最小语义面
+仅实现 GAME_DESIGN 已选的 `signature_command`，继承
+`id / label / intents / slots / validators / commit`，不扩展成通用聊天。
 
-按项目需要定义，不要求所有字段：
+解析器输出有限候选；schema、前置、资源、执行人可用性、空间权限、人物知识、
+冲突承诺或原作边界失败时，返回澄清/拒绝且不提交。
+否定、条件和互斥表达不能按关键词猜成相反行动。
 
-```text
-version: content / rules / save schema
-state: stable id / type / initial / visibility / invariant / source anchor
-action: id / actor / preconditions / costs / effects / observers / reveals / consumes
-event: action / before+after summary / witnesses / seed use / future callback
-knowledge: world fact / player knows / character knows or believes / open question
-commitment: who promised what / to whom / when it becomes irreversible / later reader
-validation path: initial state / seed / inputs / expected state / expected feedback
-```
+规则器输出执行轨迹与实际结果，再提交资源、物件、知识、关系、证物、见证和到期事项；
+叙述器只表达已确认事实。在线解析记录解析版本、规范化候选与验证结果，
+确定性回放从候选开始，不再次请求模型。
 
-只对会改变玩家决策或产生泄密风险的事实维护知识权限；普通环境事实无需多层心智模型。事件账本保留
-“发生过什么”，关系或资源保留“现在是什么”；只存终值无法解释回响，只存事件也不适合即时载入。
+私人谈话若能改变主线，只提出事实、承诺、权限、拒绝或见证候选，经同一规则验证；
+自由效果字段、聊天摘要或忠诚估值不能直接成为状态权威。
 
-## 裁决边界
+## 延期后果
 
-规则器唯一提交时间、资源、位置、物件归属、知识、承诺、胜负和事件。生成模型可解释自由输入、提出
-合法动作候选、写对白或根据已确认结果组织表达，但不能直接改最终状态。输出需先通过 schema、前置、
-数值范围、知识权限、原作边界和分支污染检查。
+记录来源行动、到期条件、携带事实、当前状态、重新进入决策面的方式与结清事件。
+载入或回放不得提前触发、重复触发或让已结事项复活。
 
-表现层只读取已提交语义。同一个事件可渲染为文字、镜头、动画或 3D 交互，但换表现不能更改原因、
-观察者、物件归属、知识披露或后续回读。
+## 回放与兼容性
 
-## 身份专属命令（按需）
+需要载入时用快照，需要重演时保留事件和规范化输入；不要求每个游戏同时维护两套存储。
+同一内容/规则版本、初态、seed 与规范化动作序列应复现规则终态和事件顺序；
+在线生成表达不参与权威状态比较。
 
-只有 GAME_DESIGN 选择 `signature_command` 时实现，并逐字继承其 `id / label / intents / slots /
-validators / commit` 六组结构；各组的具体条目数量服从项目。输入解析器把角色化表述变成有限候选，
-不拥有结算权；候选按项目需要携带 intent、执行人、对象、物件、地点、可见范围、期限等槽位。schema、前置、资源、
-执行人可用性、空间权限、人物知识、冲突承诺和原作边界任一失败时返回结构化澄清/拒绝，状态保持不变。
+回滚遵循已批准设计。节点标识、变量语义、行动效果或知识权限变化时迁移或明确拒绝旧存档/日志，
+不能静默重解释。局部修改声明基础版本、目标、预期差异与兼容性，重放失败路径及相邻反例，
+检查修改范围外的不变量。
 
-规则器再输出执行轨迹与实际结果：每一阻力环节说明通过、拒绝或部分完成，提交资源/物件/知识/关系，
-创建证物、见证与到期事项；叙述器只把这些已确认事实写成场面。否定、条件和互斥表达不得靠关键词猜成
-相反动作。若使用在线模型解析，日志保存 parser version、规范化候选与验证结果；确定性回放从候选开始，
-不再次请求模型。
-
-私人谈话若会改变主线，也走同一边界：模型只提出 `facts / promises / permissions / refusals / witnesses`
-候选，规则器验证后写入事件账。不得让自由 `effects`、原始聊天摘要或忠诚估值直接成为权威状态。
-
-## 到期事项
-
-延期后果记录 source action、due/trigger、携带的执行人/物件/见证/承诺、status、重新上桌方式和结清事件。
-到期时必须形成当前可见压力、机会或再次裁决；载入/回放不得提前触发、重复触发或让已结事项复活。
-
-## Snapshot、事件日志与回放
-
-- snapshot 服务快速载入，带内容/规则/存档版本；event log 服务定位、重演与测试。
-- 同一版本、初态、seed 和规范化动作输入序列必须得到同一终态与事件顺序；在线生成表达不进入裁决 hash。
-- 回滚模式由设计声明：自由重选、固定历史仅回看、或明确不可逆节点。渲染和 UI 回调不得偷偷改状态。
-- 节点 id、变量语义、行动效果、知识权限改变时提供迁移，或明确拒绝旧存档/日志；不得静默重解释。
-
-## 反馈与局部 patch
-
-反馈记录 `issue → observation → expected/actual → node → owner → patch → replay`。自然语言负责表达复杂
-偏差，标签负责聚类，结构化修改只触及被定位节点。patch 声明基础规则版本、目标节点、预期差异、
-存档兼容性和受影响路径；修改后重放原失败路径及一条相邻反例，确认声明外状态没有变化。
-
-白盒只回答被模拟的风险是否暴露、规则是否可执行和结果为何发生。选择是否困难、角色是否吸引人、
-节奏是否愿意重玩仍需真人研究，不写成确定性 PASS。
+这些检查只证明被覆盖的因果与回放，不证明角色魅力、选择重量或复玩意愿。

package/lib/novel-to-game/skills/game-build/references/tts-production-contract.md

@@ -1,37 +1,23 @@
 # 语音资产生产合同
 
-只在 `ART_DIRECTION.md` 已选择角色语音、旁白或朗读时启用。语音表现已批准的台词和角色方向，
-不创造新剧情，也不成为规则、目标、选择或结果的唯一载体。
+只在 ART_DIRECTION 已选择语音时启用，表现已批准台词，不创造剧情或成为必要信息的唯一载体。
 
-## 产品边界
+## 授权与数据边界
 
-- 默认在构建期生成或录制成本地资产，游戏运行不依赖网络、供应商或密钥。
-- 运行时动态语音只有在 PRODUCT_BRIEF 已批准联网、外部文本处理、成本、隐私和服务失效行为时采用；
-  客户端不持有服务密钥。
-- 只发送逐句台词与必要读音，不上传小说、SOURCE_BIBLE、设计文档、未公开手稿或无关个人信息。
-- 营销旁白与游戏内语音分别记账；一次成功不自动扩大到全量配音。
+默认构建期生成本地资产。运行时合成须由 PRODUCT_BRIEF 批准联网、外部文本处理、成本、隐私与失效行为；
+服务密钥不进入客户端、仓库、日志或证据。只发送逐句台词与必要读音，不上传小说、设计文档或无关私人信息。
 
-## 唯一台账
+音色来源须有使用权，真实人物克隆须明确许可。营销旁白不等于游戏语音，一次成功不自动扩大到全量配音。
+工具按当前能力与许可选择，不固定供应商或模型。
 
-每条采用语音只记录一行：
+## 台账与验证
 
-`line_id | speaker | trigger | exact_text | language/pronunciation | voice_direction | subtitle_key | provenance/rights | output | fallback | status`
-
-- 字幕和语音输入由同一 `exact_text` 派生；台词变化时旧音频失效。
-- `speaker` 继承美术方向的年龄感、节奏、文化依据和可听辨差异，不按语言给所有角色共用一个声线。
-- 音色只使用自录、获授权真人、获授权公共音色或合成设计音色；真实人物克隆需要明确许可。
-- `fallback` 至少保证静音、缺文件和自动播放受限时仍能读懂并完成游戏。
+每条采用语音记录：
 
-## 生产与检查
-
-1. 使用当前环境中合适的工具，按官方文档核实许可、输入处理和输出格式；仓库不固定供应商或模型。
-2. 密钥只从受信环境读取，不进入仓库、客户端、日志正文或证据文件；失败重试有明确上限。
-3. 把最终音频保存到工作区稳定路径；临时 URL、供应商任务页和缓存不是游戏资产。
-4. 确认文件非空、可被目标运行时解码，时长/声道/响度合理，并在实际触发位置播放一次。
-5. 检查字幕同步、说话者标识、专名读音、重复频率、跳过、静音、损坏文件和重开路径。
+`line_id | speaker | trigger | exact_text | language/pronunciation | voice_direction | subtitle_key | provenance/rights | output | fallback | status`
 
-自然度、魅力和音色偏好不写成机器 PASS，也不新增强制真人听审。可降级语音失败时保留字幕或普通
-音效并记 limitation；brief 明确列为必需的语音失败时，对应玩家效果 FAIL。
+字幕与语音来自同一台词，台词变化使旧音频失效；说话者继承批准的声口、文化身份和可辨差异。
+最终文件保存到工作区，在实际触发位置检查说话者、专名读音、字幕、跳过、静音、缺音和重开。
+降级后仍能理解并完成游戏；必需语音失败映射到对应玩家效果，否则保留替代并记 limitation。
 
-构建完成后只回写上述台账的本地输出、来源/权利、基本媒体信息和结果，不归档完整 API 往返、供应商
-页面截图或重复报告。
+不归档完整服务往返或重复报告。自然度、魅力和音色偏好不写成机器 PASS，也不新增强制真人听审。

package/lib/novel-to-game/skills/game-concept/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: game-concept
-description: "Design game concepts from a novel. From SOURCE_BIBLE and PRODUCT_BRIEF, generate three genuinely different directions on the dimensions still unlocked, then pick the most worthwhile playable prototype using hard vetoes and explicit trade-offs. Use for what game should this novel become, compare game concepts, choose a game direction for this book, decide whether this novel should become an interactive story. 小说游戏概念设计。根据 SOURCE_BIBLE 与 PRODUCT_BRIEF 在未锁定维度上生成三个真正不同的方案，用硬否决和关键取舍选择最值得做的可玩原型。用于判断小说适合做成什么游戏、该不该做成互动叙事、比较游戏方案等需求。"
+description: "Design game concepts from a novel. From SOURCE_BIBLE and PRODUCT_BRIEF, compare meaningful alternatives on the dimensions still unlocked, then select a playable direction using hard vetoes and explicit trade-offs. Use for what game should this novel become, compare game concepts, choose a game direction for this book, decide whether this novel should become an interactive story. 小说游戏概念设计。根据 SOURCE_BIBLE 与 PRODUCT_BRIEF 比较未锁定维度上的有效替代方案，用硬否决和关键取舍选择可玩方向。用于判断小说适合做成什么游戏、该不该做成互动叙事、比较游戏方案等需求。"
 ---
 # 游戏概念设计
 
@@ -18,38 +18,36 @@ description: "Design game concepts from a novel. From SOURCE_BIBLE and PRODUCT_B
 其中一个自动推出另一个。
 
 互动叙事是成熟玩法，不因以阅读和对白承载就降低标准；它的动词可以是读局面、追问、比对信息、
-表态、隐瞒、交出与承担回响。先例提供语法，原作规则负责改变动作对象、顺序、代价和世界回应，
-不能只做 IP 换皮。
+表态、隐瞒、交出与承担回响。
 
 概念还要判断验证形态：可用成熟交互语法表达时说明“已有语法 + 原作如何改变它”；核心依赖实时手感、
 空间、视线、物理或独特操作时明确走自定义灰盒。不要把文本原型当所有体验的统一前置层，也不要因有
 模板可用就让模板替原作决定玩法。
 
-## 三个方向
+## 比较范围
 
-先列 brief 的锁定维度和仍开放的维度。三个方向必须在至少三项开放维度上真正不同，例如玩家身份、
-子类型、核心循环、压力来源、原作选段、空间/镜头、成长关系或美术方向；已锁的主玩法不可偷换，
-未锁的核心循环可以正面比较。
+先列 brief 的锁定维度和仍开放的维度，只比较能揭示真实取舍的方向，不凑概念数量或差异维度。
+仅在方向仍开放时考察可信替代；用户已选定方向或不存在有效替代时说明原因，改为验证该方向的风险，
+不重开选择。
 
 ## 选择
 
 先按 concept-method 的硬否决逐个淘汰，不计算总分，再按其比较维度选择。`quick` 自动选证据最强的
-方向；`director` 给出推荐后等待用户决定。
+方向；`director` 只对尚未决定的方向给出推荐并等待用户选择。
 
 ## 输出
 
 生成一个 `concepts/CONCEPT.md`，只含：
 
 1. brief 锁定值与开放维度；
-2. 三条体验支柱，各配可观察现象和失败现象；
+2. 体验承诺及其可观察现象和失败现象；
 3. 紧凑先例说明；
-4. 三个概念卡，每张只写主类型、`experienceProfile`、借用/拒绝的玩法先例、3–5 个核心动词、循环、
-   压力、失败、世界响应，以及 `player_job`、`recurring_job_loop`、`resistance_chain` 和
-   `advancement_ladder`；仅当自然语言能体现玩家身份时写 `signature_command` 的 `id`、`label` 与候选
-   `intents`，否则写 `N/A`；最后说明原作张力如何由玩家亲手 enact、招牌画面、最小验证切片、最大风险
-   和否决观察；
+4. 候选概念卡：主类型、`experienceProfile`、借用/拒绝的玩法先例、核心动作与循环、压力、失败、
+   世界响应；说明玩家身份如何形成反复行动、执行阻力与可观察变化，不要求独立的固定键名。
+   `signature_command` 按方法「身份专属命令」写值或 `N/A`；最后说明原作张力如何由玩家亲手 enact、
+   招牌画面、最小验证切片、最大风险和否决观察；
 5. 硬否决结果、关键取舍、推荐与选择状态；
-6. 选定方向的玩家能动性合同、不可妥协体验承诺；上述五项交接字段必须独立成项；
+6. 选定方向的玩家能动性合同、不可妥协体验承诺；
 7. 最小验证问题与开放问题。
 
 `narrative-led` 或 `hybrid` 的叙事层还要选择一种分支结构语法并说明内容预算。交接前确认选定方向

package/lib/novel-to-game/skills/game-concept/references/concept-method.md

@@ -1,94 +1,47 @@
 # 概念选择方法
 
-## 类型与先例
+## 原作如何改变玩法
 
-类型由玩家大部分时间用什么能力解决问题决定，不由原作表面上有多少战斗、恋爱或对白决定。范围可以
-缩小，核心循环不能削到只剩一次判断或一个放行按钮。
-
-先例按设计问题选择，不按题材相似选择。一个主要玩法先例应能说明核心动词、循环、压力与熟练度；
-辅助先例只补主要先例回答不了的独立问题。记录借什么、明确不借什么和事实来源，不收集与当前决定
-无关的销量或排名。
-
-需要玩家操纵空间、视角或地形时使用实时空间；固定镜头和连续场景不必为了“更像游戏”强做三维。
-平台与技术只是实现约束，不替代玩法判断。
+类型由玩家反复做什么决定，不由原作战斗、恋爱或对白的篇幅决定。先例按设计问题选择，
+记录借用与拒绝之处；原作必须改变动作对象、顺序、代价或世界回应，而不只是替换专有名词。
 
 ## 硬否决
 
-出现任一情况就重做，不靠评分补偿：
+以下缺口不能靠综合评分补偿：
 
-- 玩家读完或点完一段只让既定剧情继续，换选择不会改变后续原因、关系、路线或结果；
-- 没有 3–5 个可重复参与手段，或这些动作不产生压力、取舍、状态变化与熟练度差异；
+- 动作不能闭合可参与的循环，选择或操作不改变可观察状态、后续机会或结果；
 - 原作中心规则、情感或伦理张力只存在于过场和名词，核心循环与它无关；
-- 删除专有名词后，本作与通用模板没有动作对象、代价或世界回应上的差异；
-- 最小切片依赖开放世界、多人服务、生产级内容量或不可获得资产；
-- 依赖复制其他游戏受保护的角色、地图、UI、文本或素材；
-- 玩法无法用一个主要先例或清楚的循环说明，玩家也无法预判自己反复在做什么；
-- 切片从头到尾只有数值或文本增加，没有新的参与手段、可达空间、可问对象或局面；
-- 玩家介入被兑现成花资源放行既定结果，缺少因果权或结算权。
-
-## 玩家能动性
-
-- **因果权**：玩家的选择决定事情为什么发生、朝哪里转；选什么都汇入同一原因即不成立。
-- **结算权**：世界会点名玩家做过的事，代价落在他在乎的对象上；只给总分或旁白总结不成立。
-
-每个方向用一句话回答：“玩家做了什么，使这件事只能这样发展，而且结果怎样看得出是他造成的？”
-
-## 身份专属命令
+- 删除专有名词后，与通用模板没有动作对象、代价或世界回应上的差异；
+- 最小切片超出 brief，依赖不可获得的工具、服务、内容量或资产；
+- 依赖复制其他游戏受保护的角色、地图、界面、文本或素材；
+- 声称有进展，却只有文本或读数增加，没有兑现本项目承诺的局面、能力或理解变化；
+- 玩家介入只是花资源放行既定剧情，世界不回读玩家做过的具体事。
 
-自然语言不是默认输入方式。只有当玩家需要以角色身份组织对象、执行人、条件、期限或知情范围，且措辞
-差异本身值得保留时，才选择一项 `signature_command`；实时瞄准、移动、节奏操作或已有按钮已经完整表达
-核心动词时写 `N/A`。不开放通用“你想做什么”，也不把每个 NPC 都变成聊天入口。
+不以动词数量、成长阶段或三维画面作为可玩性的替代判据。
 
-五项字段组成一条因果链：`player_job → recurring_job_loop → signature_command → resistance_chain →
-advancement_ladder`。`signature_command` 选中时只先锁 `id`、玩家可见 `label` 和候选 `intents`；具体
-槽位、验证器与提交项由世界设计裁决。意图数量服从最小切片，不设跨项目固定数；玩家表达先编译成
-有限候选动作，世界仍可拒绝、部分执行、走样、泄露或延期追责。若自由表达最后只等价于按一个现成
-按钮，且没有增加身份感、组合空间或可读后果，就不采用。
+## 玩家能动性与承载类型
 
-## 体验承载类型
+每个方向回答：玩家做什么改变事情的原因或方向（因果权），世界怎样具体兑现其后果（结算权）。
+短篇或命定结局可以收束结果，但不能因此抹掉玩家介入的意义。
 
-- `system-led`：玩家主要操作规则，熟练度来自走位、出招、分配、经营或建造。
-- `narrative-led`：玩家主要读局面、追问、比对信息、表态并承担回响；拿掉数值面板仍知道该争取什么。
-- `hybrid`：两层各自成立且双向影响；一层只是为另一层放行时，按真正承载体验的那层记录。
+`experienceProfile` 是交接字段：
 
-用“拿掉测试”判断：删掉系统层或场景/对白层，哪一边会让体验失去主要决策？两边都塌且彼此读写，
-才是 `hybrid`。
+- `system-led`：主要决策来自操作规则；
+- `narrative-led`：主要决策来自理解局面、人物、信息并承担回响；
+- `hybrid`：两层各自承载决策且互相影响。
 
-## 互动叙事结构
+按实际决策来源判断，不按界面上是否出现数值分类。叙事层说明分支结构与内容预算，不强套统一弧线。
 
-互动叙事的可重复循环可以是：读局面 → 追问/调查 → 比对证词与证据 → 表态或行动 → 承受回响。
-熟练度来自知道谁掌握什么、何时施压、什么必须隐瞒，以及先前行为怎样改变当前局面。
-
-按内容预算选择结构：
-
-| 结构 | 适用情况 | 主要成本 |
-|---|---|---|
-| 主干加瓶颈 | 关系与立场变化需要记忆，但关键事件可汇流 | 状态变体 |
-| 任务簇 | 调查、取证、地点顺序可交换 | 节点组合 |
-| 长廊 | 命定主线必须被所有玩家看到 | 分支较浅 |
-| 分院帽 | 前段选择分配到不同后半程 | 多套后半程 |
-| 树洞 | 短小、多周目、分支很少汇流 | 大量内容不可见 |
-
-不设汇流时分支不要连续膨胀；用“节点数 × 状态变体 × 关键人物数”估算内容，而不是画一棵无限树。
-
-## 三段弧
-
-三段弧要求玩家能力或局面发生质变：
-
-- 探索期：认识可用动作、对象和第一层风险；
-- 成长期：组合动作、读取先前状态，获得新手没有的选择；
-- 成熟期：在较少提示下利用早先积累，完成代表性结果。
+## 身份专属命令
 
-系统主导看新动词与新可达空间；叙事主导看新可问对象、质证手段、人物态度和只有知情者可达的场景。
-数字变大、多一段文本或无后果选项都不算弧线。
+自然语言不是默认输入。只有玩家需要以角色身份组织对象、执行人、条件、期限或知情范围，
+且自由表达增加身份感、组合空间或可读后果时，才选择 `signature_command`，否则写 `N/A`。
 
-## 比较维度
+选中时锁定 `id`、玩家可见 `label` 和候选 `intents`；槽位、验证器与提交项交给世界设计。
+说明身份、反复行动、执行阻力和后续变化如何相连。玩家表达只是有限动作候选，世界仍可拒绝、
+部分执行、走样、泄露或延期追责，不能把“说了”直接等同于“发生了”。
 
-1. 原作规则是否改变动作对象、顺序、代价或世界回应；
-2. 玩家是否亲手 enact 原作的情感或伦理张力；
-3. 玩家能动性是否在切片内被世界回读；
-4. 一张实际画面能否说明身份、动作和独特世界；
-5. 表达是否尊重原作文化，并适合目标界面语言与受众；
-6. 最小原型能否用现有时间、工具与资产证明最大风险。
+## 选择依据
 
-相近方案不做伪精确排序。选择能以最小切片证明核心幻想、且失败条件最清楚的方向。
+先否决，再比较原作转化、玩家能动性、文化表达与最小验证成本。
+推荐能用现有时间、工具和资产证明核心幻想、且否决观察最清楚的方向；相近方案不做伪精确排名。

package/lib/novel-to-game/skills/game-qa/SKILL.md

@@ -20,21 +20,20 @@ description: "Verify a game with evidence on its selected target runtime. Launch
 
 1. 读取 `targetRuntime`、`testedRuntime` 和权威 verify；与 PRODUCT_BRIEF/BUILD_BRIEF 冲突时先报错，
    不由 QA 猜值。
-2. 只运行一次权威 verify：它在 testedRuntime 从 clean start → 核心动作 → 设计结果 → restart
+2. 运行权威 verify：它在 testedRuntime 从 clean start → 核心动作 → 设计结果 → restart
    完成整条路径，并记录 command、exit code、环境、六项结果、最小证据和实际失败。
-3. 对照 GAME_DESIGN 中会改变结果的不变量和三段弧结束标记；只验证批准的设计承诺，不遍历所有
+3. 对照 GAME_DESIGN 中会改变结果的不变量和结束标记；只验证批准的设计承诺，不遍历所有
    代码路径。
 4. 若候选有可执行模型、事件日志、patch 或 `signature_command`，按 test-design-method 的对应合同把
-   项目回归嵌入同一权威 verify；失败映射到已有 checks 或 limitation，不另跑命令或新增门禁。
-5. 记录 limitation 和问题的 product/design/art/build 归属。趣味、长期平衡、留存和商业价值只能写成
-   未验证风险，不给确定性 PASS。
+   项目回归嵌入权威 verify；允许定向诊断、修复和复跑，最终六项证据必须来自同一次完整运行。
+   失败映射到已有 checks 或 limitation，不新增通用门禁。
+5. 记录 limitation 和问题的 product/design/art/build 归属。
 
 优先使用已有可观察状态；只有无法判断结果时才增加最小测试钩子。不要为了 QA 重构游戏或强制某种
 框架、测试库或调试接口。
 
 ## 输出
 
-- `qa/verification.json`：唯一 QA 事实源，包含三态 status、权威命令、complete run、六项 checks、
-  一条证据路径和 limitations；字段与证据要求见 qa-contract.md。
+- `qa/verification.json`：唯一 QA 事实源；字段与证据要求见 qa-contract.md。
 
 缺口写结构化 limitation，不发明 `PASS_WITH_GAPS`；未运行或失败的必需项不能满足整体 PASS。