@oh-story/dsh 0.1.16 → 0.1.18

package/lib/novel-to-game/README.md

@@ -359,7 +359,7 @@ Keep the choices and outcomes bounded; show each option's evidence, cost, visibl
 Label allowed additions and unresolved questions. Deliver design notes only—do not build, run QA, or claim a finished runtime.
 ```
 
-`quick` is the default: the agent drafts a product brief with sensible defaults, asks only about choices that materially change direction or touch safety, compares meaningful alternatives, and continues through design, build, and QA. Choose `director` when you want to pick the concept yourself; the agent stops at the concept stage with candidates and a recommendation, unless you have already named a direction.
+`quick` is the default: the agent drafts a product brief with sensible defaults, asks only about choices that materially change direction or touch safety, compares meaningful alternatives, and continues through design, build, and QA. Choose `director` when you want to make the key calls yourself: the agent stops with candidates and a recommendation at three points (the concept, what to cut after the whitebox playtest, and the visual target images) unless you have already decided.
 
 ## Workflow
 
@@ -367,7 +367,7 @@ Label allowed additions and unresolved questions. Deliver design notes only—do
 Novel → Source analysis → Concept → World design → Risk-matched whitebox ↺ → Art direction → Production build → QA → Playable game
 ```
 
-After world design, a whitebox (a rough build without final art) tests only the single largest design risk before full art production: narrative causality can be checked in text, but real-time control, space, physics, or camera cannot, and what it shows goes back to the design stage. The production build targets the approved runtime and prepares one authoritative verification command. QA may diagnose, fix, and rerun, but the final record binds all six checks to the same complete run; findings flow back to the product, design, art, or build document that owns them.
+After world design, a whitebox (a rough build without final art) tests only the single largest design risk before full art production: narrative causality can be checked in text, but real-time control, space, physics, or camera cannot, and what it shows goes back to the design stage. The whitebox playtest also shows which part players keep coming back to, so the story, dialogue and level budget is revised against it, and the brief's production budget is checked against the remaining scope there and again halfway through production. The production build targets the approved runtime and prepares one authoritative verification command. QA may diagnose, fix, and rerun, but the final record binds all six checks to the same complete run; findings flow back to the product, design, art, or build document that owns them.
 
 ## Skills
 
@@ -408,7 +408,7 @@ Say so in the request, as the second example above does. That locks `experienceP
 
 ### How long does a full run take, and what does it cost?
 
-The agent reads the whole novel, writes the adaptation documents, builds, and runs QA through separate skill calls. A full run may span more than one session. Token usage is billed by your coding agent. Generation services, engine licences or hosting may have separate costs; the requirements stage identifies paid services before use. The public examples' progress files do not record wall-clock time or token counts, so this README does not quote a number.
+The agent reads the whole novel, writes the adaptation documents, builds, and runs QA through separate skill calls. A full run may span more than one session. Token usage is billed by your coding agent. The product brief records the budget you give it (model quota, time or money), and the run checks the remaining scope against it after the whitebox and halfway through production, cutting content before the budget runs out. Generation services, engine licences or hosting may have separate costs; the requirements stage identifies paid services before use. The public examples' progress files do not record wall-clock time or token counts, so this README does not quote a number.
 
 ### The session ended halfway. Can it continue?
 

package/lib/novel-to-game/README_ZH.md

@@ -1,4 +1,4 @@
-<!-- Last synced with README.md: 2026-10-15 -->
+<!-- Last synced with README.md: 2026-10-19 -->
 
 <p align="center">
   <img src="https://zenstory.ai/brand/zenstory-ai-mark.svg" alt="" width="76" height="76">
@@ -360,7 +360,7 @@ PASS 只在记录下来的本地桌面浏览器里证明这六项效果。
 标明允许新增的设定与待决问题。只交付设计说明，不构建、不运行 QA，也不声称运行成品已经完成。
 ```
 
-`quick` 是默认模式：Agent 先用合理默认值起草产品简报，只追问会改变方向或涉及安全的选择，比较有效替代后继续设计、构建和 QA。想自己选概念时用 `director`：Agent 会在概念阶段停下，给出候选和推荐；你已明确选定方向时不再停靠。
+`quick` 是默认模式：Agent 先用合理默认值起草产品简报，只追问会改变方向或涉及安全的选择，比较有效替代后继续设计、构建和 QA。想自己做关键决定时用 `director`：Agent 会在概念方向、白盒试玩后的内容取舍和视觉目标图三处停下，给出候选和推荐；你已经做出决定的地方不再停靠。
 
 ## 工作流
 
@@ -368,7 +368,7 @@ PASS 只在记录下来的本地桌面浏览器里证明这六项效果。
 小说 → 游戏化拆解 → 游戏概念 → 世界设计 → 风险白盒 ↺ → 美术方向 → 正式构建 → QA → 可玩游戏
 ```
 
-世界设计完成后，先用白盒（不要求最终美术的粗略构建）只验证最大的一个设计风险，再进入完整美术生产：叙事因果可以用文本验证，实时操作、空间、物理或镜头不能；观察结果交回设计阶段。正式构建面向批准的运行环境，并准备一条权威验证命令。QA 可以诊断、修复和复跑，但最终记录把六项检查绑定到同一次完整运行；发现的问题按产品、设计、美术、构建各自的文档归属回流。
+世界设计完成后，先用白盒（不要求最终美术的粗略构建）只验证最大的一个设计风险，再进入完整美术生产：叙事因果可以用文本验证，实时操作、空间、物理或镜头不能；观察结果交回设计阶段。白盒试玩还要看出玩家反复回来做的是哪一部分，剧情、对白和关卡的内容预算据此修订；简报里的制作预算也在这一步、以及正式生产进行到一半时，与剩余范围各对照一次。正式构建面向批准的运行环境，并准备一条权威验证命令。QA 可以诊断、修复和复跑，但最终记录把六项检查绑定到同一次完整运行；发现的问题按产品、设计、美术、构建各自的文档归属回流。
 
 ## Skills
 
@@ -409,7 +409,7 @@ game-adaptations/<project>/
 
 ### 完整跑一次要多久、花多少钱？
 
-Agent 要通过不同的 skill 调用读完整本小说、写改编文档、构建并跑 QA，完整运行可能跨多次会话。token 用量按你所用编码 Agent 计费。生成服务、引擎许可或托管可能另有费用，需求确认阶段会在使用付费服务前说明。公开示例的进度文件没有记录耗时和 token 数，所以这里不给具体数字。
+Agent 要通过不同的 skill 调用读完整本小说、写改编文档、构建并跑 QA，完整运行可能跨多次会话。token 用量按你所用编码 Agent 计费。产品简报会记下你给出的预算（模型额度、工时或费用），流程在白盒之后和正式生产进行到一半时各用它对照一次剩余范围，在预算耗尽前先删减内容。生成服务、引擎许可或托管可能另有费用，需求确认阶段会在使用付费服务前说明。公开示例的进度文件没有记录耗时和 token 数，所以这里不给具体数字。
 
 ### 会话中途断了，能接着做吗？
 

package/lib/novel-to-game/VERSION

@@ -1 +1 @@
-0.5.0
+0.6.0

package/lib/novel-to-game/manifest.json

@@ -2,10 +2,10 @@
   "schemaVersion": 1,
   "upstream": {
     "repository": "https://github.com/zenstory-ai/novel-to-game.git",
-    "commit": "bf0ffbc0cedf20b3f40ba9b60212af27f6713221",
-    "releaseVersion": "0.5.0"
+    "commit": "7758caa8d9578f19780349e7b4e4115ef831fd7a",
+    "releaseVersion": "0.6.0"
   },
-  "generatedAt": "2026-10-15T10:50:57.961Z",
+  "generatedAt": "2026-10-19T08:12:54.284Z",
   "skills": [
     "game-art-direction",
     "game-build",
@@ -26,17 +26,17 @@
     },
     {
       "path": "README.md",
-      "sha256": "c7706c8e5ae9ecefed260c46ea455e52db8d34d4632e81a868373bf47af0c7b1",
-      "bytes": 38229
+      "sha256": "dc046f8d7f8cee9af8cc3882b51b274ba04b51d04ff3b3eafaf555b1cc10f1e0",
+      "bytes": 38777
     },
     {
       "path": "README_ZH.md",
-      "sha256": "86a84a37646ac018a495e10ad330b43a2623615a476d7ffd0dbde9522fff147e",
-      "bytes": 34306
+      "sha256": "5332bdb07c7744e8b556d253d28d1c3edd8e7feb04990d8a109fe19a643ff6ca",
+      "bytes": 34810
     },
     {
       "path": "VERSION",
-      "sha256": "a0ad50640139a524f86591157145bf1d4674ea9c065bfea21558f0f7b04430c8",
+      "sha256": "97a5d6e540a6120d09c39ddb667e0e8e2bac7fcc2ffef813b82e08fd60365bce",
       "bytes": 6
     },
     {
@@ -586,19 +586,24 @@
     },
     {
       "path": "skills/game-art-direction/references/art-direction-method.md",
-      "sha256": "8e9879bae6cedc01047792d305154e6bd9419ec9c455c541162b372be7395bdd",
-      "bytes": 2811
+      "sha256": "367b8d421b99c64151582f3803b9b07689ded244b32125cb50c86cf49cb19f41",
+      "bytes": 3162
     },
     {
       "path": "skills/game-build/SKILL.md",
-      "sha256": "895ab4669782f09e3ac72fc8ec89550cc186264c4fc7a4f292655003a199e720",
-      "bytes": 4882
+      "sha256": "4a1b79ed036d2f149fb0a19f68609bf7fd0a5335a171321b7bd67175cd6671d2",
+      "bytes": 5563
     },
     {
       "path": "skills/game-build/agents/openai.yaml",
       "sha256": "4fea64c3910933415a5e601bc3f423d22f0e5cfed8d7ab5c2aa38f60a3105cf0",
       "bytes": 272
     },
+    {
+      "path": "skills/game-build/references/baked-sprite-workflow.md",
+      "sha256": "aa7cbf2c255bae747a65b4d8eaef060ec77a4e3da137636d090e1b4583e390a5",
+      "bytes": 1671
+    },
     {
       "path": "skills/game-build/references/blender-asset-workflow.md",
       "sha256": "6fbf2e11f74ca2be1d2e3d3644dfc9ed82f04a6f0d92b67b2267894a710a4a42",
@@ -636,8 +641,8 @@
     },
     {
       "path": "skills/game-concept/references/concept-method.md",
-      "sha256": "ae45e4ffafe6c253e66ea06636d836f81485bf0b705fc3e6fbb4be8f94a0c859",
-      "bytes": 2939
+      "sha256": "c34c47b3920740957dbf4b8e64c7258e1b584604eff671ca2718baf340bc9538",
+      "bytes": 3284
     },
     {
       "path": "skills/game-qa/SKILL.md",
@@ -701,8 +706,8 @@
     },
     {
       "path": "skills/novel-to-game/SKILL.md",
-      "sha256": "12c82429d8bfeff5fa12bc839c618ef03897c97cb1126e0002236c59b3837957",
-      "bytes": 4223
+      "sha256": "b8ed42dd6d6e2d0a38f8f4014948b3d5a35f95199e364054878a256413105258",
+      "bytes": 4485
     },
     {
       "path": "skills/novel-to-game/agents/openai.yaml",
@@ -711,13 +716,13 @@
     },
     {
       "path": "skills/novel-to-game/references/intake-method.md",
-      "sha256": "33dc2c9f43f0e4cb840ad016fa6fb1d58b14d0a96ac7286442a8500dcaddd2bd",
-      "bytes": 2966
+      "sha256": "6ded64de535ed03f996e336fcc413adf358b454cc2b3e04331d83400b7daffae",
+      "bytes": 3112
     },
     {
       "path": "skills/novel-to-game/references/pipeline-contract.md",
-      "sha256": "96375b18d8babc7f73ca429c64ef18bf1607d7058f92109fdc4002531b22cfa7",
-      "bytes": 2942
+      "sha256": "ce943fec9b9de37914b4ae949b76ce82e774f154ec0ac5a63e6fae6b2044962d",
+      "bytes": 3998
     }
   ]
 }

package/lib/novel-to-game/package.json

@@ -0,0 +1,4 @@
+{
+  "private": true,
+  "description": "Bundled upstream Skills; no module type so scripts resolve as in an upstream install."
+}

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

@@ -31,6 +31,10 @@
 仅在高风险歧义或目标成色需要时制作视觉目标包：原创风格帧、构图草图或白盒改绘，
 附能裁决方向的可观察条件和失败例。应包含实际游戏界面，不用海报证明可操作性。
 
+每个身份锚点、关键时刻和主要界面先出约三张方向可区分的原创候选。流程处于 `director` 模式时停靠，
+由用户为每一项选定一张；`quick` 模式按这些可观察条件自选并写明理由。选中图进入视觉目标包，成为批量
+生产唯一的参考；落选图与被否决样张一样隔离。
+
 批准目标图后批量资产保持身份、光色、构图与文本空间；方向被否决时停止同方向扩批，
 隔离被否决样张，不让旧图继续作为生产参考。目标图只锁方向，不证明最终资产或发布质量。
 工具不可用时保留文字方向并记录未解决风险，不伪称图像已完成。

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

@@ -37,6 +37,8 @@ BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式
   [playable-model-contract.md](references/playable-model-contract.md) 的相关部分。
 - 语音策略不是 `none` 时读取 [tts-production-contract.md](references/tts-production-contract.md)。
 - 实际采用动态媒体时读取 [generative-media-pipeline.md](references/generative-media-pipeline.md)。
+- 2.5D 角色或物件需要多方向、多动作且身份一致的序列帧时，读取
+  [baked-sprite-workflow.md](references/baked-sprite-workflow.md)。
 
 ## 共同构建循环
 
@@ -45,6 +47,8 @@ BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式
 2. 实现 GAME_DESIGN 的状态、动作与结果；使用生成模型时，模型只解释输入和结果，规则器拥有提交权。
    存在 `signature_command` 时再执行可选合同的专属边界。
 3. 保留能复现问题的初态与输入路径，涉及随机性时固定 seed；修订后重放失败路径与相邻反例。
+   同一手感或表现问题连续两次修复无效时停止换方案，先查成熟作品处理同类问题的公开资料（开发者
+   演讲、技术复盘或开源实现），理解其原理后再实现。
 4. 回写实际工具链、install/build/start 命令和版本；未知值写 `NOT_AVAILABLE: 原因`，不猜。
    实际候选与 GAME_DESIGN、ART_DIRECTION 的事实描述不符时，交回对应 owner 修订或在 BUILD_BRIEF 标明冲突，
    不留下描述已不存在的玩法、表现或声音的文档。
@@ -59,7 +63,9 @@ BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式
 6. 运行最窄的开发检查与启动 smoke，修复构建失败、阻断日志、资源失败和崩溃；替代运行时未覆盖的
    目标平台输入、性能、打包或设备项写入 limitation。
 7. 达到 brief 的 `targetFinish`；更高完成度只处理已批准的焦点资产和招牌时刻，不制造与可玩闭环
-   无关的发布审计。
+   无关的发布审计。有批准目标图的界面与焦点资产，在目标视口截取实际运行画面与目标图并排比对，
+   逐项列出布局、比例、字体、色光与层级差异后修正；连续两轮没有改善就停止，把剩余差异写进
+   BUILD_BRIEF 的限制，不修改目标图去迁就实现。
 8. 交给 `game-qa`；诊断、复跑与事实源规则见契约「完成证据」。
 
 ## 输出

package/lib/novel-to-game/skills/game-build/references/baked-sprite-workflow.md

@@ -0,0 +1,19 @@
+# 2.5D 序列帧烘焙工作流（按需）
+
+适用于 2.5D 游戏里需要多方向、多动作且身份一致的角色或物件。逐帧二维生成很难在转向和动作之间保持
+同一张脸、同一套服装和同一比例；先做出三维模型、再按游戏镜头逐帧渲染，可以把这些事实锁在模型里。
+已有可用序列帧或程序化表现已经足够时不迁移。它是资产制作路径，不替代目标运行时，也不改变
+GAME_DESIGN 与 ART_DIRECTION 的裁决。
+
+## 流程
+
+1. 以 ART_DIRECTION 批准的角色目标图为唯一输入生成三维模型，对照目标图核对脸、发型、服装、标志道具
+   与比例；识别锚点偏离时重新生成，漂移的模型不进入后续步骤。
+2. 自动绑定骨骼，按 GAME_DESIGN 实际用到的状态套用或制作动作，检查关节弯曲处是否穿模、拉伸。
+3. 在目标引擎的无头模式或三维软件中，按游戏实际的镜头俯角、投影方式、主光方向和描边规则，逐方向、
+   逐动作渲染；同一批资产统一方向数、帧率、画布尺寸和脚底锚点。
+4. 打包图集并配置资产键，放回实际游戏镜头检查：转向是否顿挫（方向数不足或缺转身过渡）、移动时脚步
+   是否打滑、锚点是否抖动、光色是否与场景一致。只重做暴露问题的方向或动作。
+
+工具、模型与服务按当前能力、许可与费用选择；上传内容只含该角色的目标图。源模型、绑定文件、渲染脚本
+和最终图集都保存在工作区，供应商任务页不算资产。必需资产生成失败时明确报错，不用占位图静默通过。

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

@@ -45,5 +45,8 @@
 
 ## 选择依据
 
-先否决，再比较原作转化、玩家能动性、文化表达与最小验证成本。
+先否决，再比较原作转化、玩家能动性、文化表达、最小验证成本与内容成本。
+内容成本指每分钟游玩时长需要多少专门制作的场景、角色与文本。靠组合扩展内容的方向（装备词缀、可拼接的
+地图块、敌人变体、可复用的事件模板）比每章一套专属场景和演出更容易在预算内做完；小说改编天然偏向后者，
+所以要显式比较。
 推荐能用现有时间、工具和资产证明核心幻想、且否决观察最清楚的方向；相近方案不做伪精确排名。

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

@@ -21,7 +21,8 @@ description: "Turn a novel into a fully playable game on the selected target pla
 ## 模式
 
 - `quick`：默认；用推荐草案推进，比较有效替代后自动选择并完成全流程。
-- `director`：给出候选和推荐后停靠，等待用户选方向；已有明确选择时不重复停靠。
+- `director`：在概念方向、白盒试玩后的内容取舍和视觉目标候选三处给出候选与推荐后停靠，等待用户选择；
+  已有明确选择时不重复停靠。
 - `resume`：读取 `_progress.md` 和实际产物，从最早未完成的交接继续。
 
 ## 流程
@@ -33,8 +34,10 @@ description: "Turn a novel into a fully playable game on the selected target pla
    不适用时明确 `N/A`；`director` 的待决方向在此停靠。
 5. 调用 `game-world-design` 生成 `GAME_DESIGN.md`，其中锁定最大设计风险与最小可执行切片。
 6. 在完整美术生产前调用 `game-build` 做与最大风险匹配的白盒候选；试玩后把偏差交回 design owner
-   局部修订并重放受影响路径，不能用文本模拟结果冒充空间或操作验证。
-7. 调用 `game-art-direction` 生成 `ART_DIRECTION.md`；只有目标成色需要时再制作视觉目标包。
+   局部修订并重放受影响路径，不能用文本模拟结果冒充空间或操作验证；随后按流程契约做第一次预算与
+   范围复盘，据此请 design owner 调整剧情与关卡内容量。
+7. 调用 `game-art-direction` 生成 `ART_DIRECTION.md`；只有高风险歧义或目标成色需要时再制作视觉目标包，目标图选定后
+   才进入批量资产生产。
 8. 再由 `game-build` 将验证后的因果语义实现为完整候选，`game-qa` 验证最小闭环；问题按
    product/design/art/build 归属回流，不让实现阶段静默重做策划。
 

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

@@ -31,6 +31,7 @@
 | 内容尺度 | 分级、成人内容范围与平台约束 |
 | 核心幻想 | 玩家扮谁、追求什么、何时产生什么情绪 |
 | 时长与结构 | 验证切片时长、单局/长线结构 |
+| 制作预算 | 本次可用的模型额度、工时或费用上限；用户未给时按对话中的可用资源估计并列入未确认假设 |
 | 发行定位 | 买断、免费、N/A；只记录会影响玩法的部分 |
 | 引擎与运行时 | 生产引擎、目标运行时、可用的实际测试运行时 |
 | 玩家结构 | 单人/多人/异步/实时，以及切片内真实范围 |

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

@@ -32,7 +32,7 @@ JSON/YAML。设计理由仍由 `GAME_DESIGN.md` 拥有，运行状态与动作
 | `scope` | brief、source bible 和三份设计交接存在；范围、原作事实、目标运行形态、`targetFinish` 与 `experienceProfile` 不冲突 |
 | `playable` | `qa/verification.json` 的 `launch`、`render`、`input`、`coreLoop`、`outcome`、`restart` 均有真实运行证据 |
 
-`_progress.md` 只记录来源、模式、当前阶段、未确认假设、回流和这两项结果。详细测试状态留在
+`_progress.md` 只记录来源、模式、当前阶段、未确认假设、回流、预算复盘结论和这两项结果。详细测试状态留在
 `qa/verification.json`，不要复制到多份状态表。
 
 早期工作区缺少 `experienceProfile` 时，`resume` 按现有 `CONCEPT.md` 补记一次并继续；不得据此重做
@@ -41,12 +41,23 @@ JSON/YAML。设计理由仍由 `GAME_DESIGN.md` 拥有，运行状态与动作
 ## 证据角色
 
 构建准备候选与 verify 入口。QA 可诊断、修复后复跑；最终事实源原子记录当前同一次完整运行，
-不拼接旧 PASS。不要求真人试玩、逐项人工批准、重复证据对象或第二份 QA 报告。
+不拼接旧 PASS。QA 结论不要求真人试玩、逐项人工批准、重复证据对象或第二份 QA 报告。
 
 白盒试玩是设计回流，不是第七道顶层 QA 门。反馈至少记录观察位置、玩家输入、预期与实际差异、受影响
 的状态/动作/知识/回响节点和 owner；修订后用可复现的初态与输入路径复查，随机性相关时固定 seed。
 已有存档/日志因节点标识、变量语义、动作效果或知识权限变化而失效时，迁移或明确拒绝兼容，不能静默解释成新历史。
 
+白盒试玩还要回答玩家实际追着玩、反复回来做的是哪一部分。`director` 可在此停靠，请用户找一位目标
+玩家试玩；无人可找时，另起一个未读过设计文档与源码的代理会话，只凭画面和正常输入试玩。概念与设计阶段
+写下的剧情、对白和关卡内容预算按试玩结论修订，与核心乐趣无关的原作情节压成过场或删去。
+
+## 预算与范围复盘
+
+`PRODUCT_BRIEF.md` 记录本次制作可用的模型额度、工时或费用上限。白盒试玩结束、生产阶段完成约一半必做
+项时各复盘一次，把剩余预算与剩余范围对照；单次代理任务的耗时或消耗持续上升、并行代理反复改动同一批
+文件，都说明工程复杂度已逼近预算能支撑的上限。此时停止加内容，按玩家实际看到的收益删减或降级：做完
+少量内容胜过铺满占位，打磨先投给常驻屏幕的界面与主角，再到场景。每次删减写进 brief 的明确非目标。
+
 预算或工具耗尽只会留下 `NOT_RUN` / `FAIL`、缩小范围或延期，不会生成 PASS。
 
 ## resume 与回流