From 86169065af0b5ef8d03b3594c3213741f759dee6 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Fri, 16 Oct 2026 02:17:00 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E7=94=A8=E8=AF=AD):=20A=20=E8=A1=A8?= =?UTF-8?q?=E5=85=A8=E9=87=8F=E8=AF=8D=E9=9D=A2=E6=8D=A2=E4=BB=A3=E6=89=B9?= =?UTF-8?q?=EF=BC=882026-10-16=20=E7=94=A8=E6=88=B7=E4=BB=A4=E7=AC=AC?= =?UTF-8?q?=E4=B8=80=E6=AD=A5=EF=BC=89=E2=80=94=E2=80=94design=20=E5=9B=9B?= =?UTF-8?q?=E5=9F=9F=2036=20=E6=96=87=E4=BB=B6=E6=9C=BA=E6=A2=B0=E6=9B=BF?= =?UTF-8?q?=E6=8D=A2=E7=BA=A6=20371=20=E5=A4=84=EF=BC=9A=E9=9A=8F=E6=89=B9?= =?UTF-8?q?=E2=86=92=E9=A1=BA=E5=B8=A6=20123=E3=80=81=E6=94=B6=E5=8F=A3?= =?UTF-8?q?=E2=86=92=E5=AE=8C=E6=88=90=20114=E3=80=81=E8=90=BD=E6=96=87?= =?UTF-8?q?=E2=86=92=E5=86=99=E5=85=A5=E6=96=87=E6=A1=A3=2076=E3=80=81?= =?UTF-8?q?=E4=B8=8D=E5=BE=97=E2=86=92=E7=A6=81=E6=AD=A2=2053=E3=80=81?= =?UTF-8?q?=E5=8F=B0=E8=B4=A6=E2=86=92=E7=8A=B6=E6=80=81=E8=AE=B0=E5=BD=95?= =?UTF-8?q?=2035=E3=80=81=E5=AF=B9=E6=8B=8D=E2=86=92=E9=80=90=E9=A1=B9?= =?UTF-8?q?=E6=AF=94=E5=AF=B9=2012=E3=80=81=E9=94=80=E5=8F=B7/=E9=94=80?= =?UTF-8?q?=E8=B4=A6=E2=86=92=E6=B3=A8=E9=94=80=2012=E3=80=81=E5=9C=A8?= =?UTF-8?q?=E9=A3=9E=E2=86=92=E6=AD=A3=E5=9C=A8=E6=89=A7=E8=A1=8C=E4=B8=AD?= =?UTF-8?q?=203=E3=80=81=E4=B8=8D=E6=8A=A5=E9=94=99=E2=86=92=E4=B8=8D?= =?UTF-8?q?=E8=BF=94=E5=9B=9E=E9=94=99=E8=AF=AF=201=EF=BC=9B=E8=B1=81?= =?UTF-8?q?=E5=85=8D=E9=9D=A2=E9=9B=B6=E8=A7=A6=E7=A2=B0=E2=80=94=E2=80=94?= =?UTF-8?q?=E7=89=88=E6=9C=AC=E5=8E=86=E5=8F=B2=E6=97=A2=E6=9C=89=E8=A1=8C?= =?UTF-8?q?=E3=80=81=E5=AF=B9=E7=85=A7=E6=80=A7=E6=9B=BF=E6=8D=A2=E8=AE=B0?= =?UTF-8?q?=E8=BD=BD=E5=8F=A5=EF=BC=88=E3=80=8CX=E3=80=8D=E2=86=92?= =?UTF-8?q?=E3=80=8CY=E3=80=8D=EF=BC=89=E3=80=81=E6=9C=AF=E8=AF=AD?= =?UTF-8?q?=E8=A1=A8=E4=B8=8E=20doc-conventions=20=E6=9D=A1=E6=96=87?= =?UTF-8?q?=E8=87=AA=E8=BA=AB=E3=80=81engine-reference=20=E7=95=99?= =?UTF-8?q?=E6=A1=A3=E5=8C=BA=E3=80=81=E7=BE=8E=E6=9C=AF=E5=AE=A1=E8=AE=A1?= =?UTF-8?q?=E4=BC=9A=E8=AF=9D=E5=AD=98=E6=A1=A3=E3=80=81buff/debuff=20?= =?UTF-8?q?=E4=BB=A3=E7=A0=81=E6=A0=87=E8=AF=86=E7=AC=A6=E3=80=81=E3=80=8C?= =?UTF-8?q?=E4=B8=8D=E5=BE=97=E4=B8=8D=E3=80=8D=E6=83=AF=E7=94=A8=E8=AF=AD?= =?UTF-8?q?=EF=BC=9B=E9=9A=BE=E5=BA=A6=E6=9B=B2=E7=BA=BF=E4=B8=8EBoss?= =?UTF-8?q?=E3=80=8C=E9=9A=8F=E6=89=B9=E6=AC=A1=E6=89=A9=E5=B1=95=E3=80=8D?= =?UTF-8?q?=E6=94=B9=E3=80=8C=E9=9A=8F=E5=90=8E=E7=BB=AD=E6=89=B9=E6=AC=A1?= =?UTF-8?q?=E6=89=A9=E5=B1=95=E3=80=8D=E9=81=BF=E8=AF=8D=E9=9D=A2=E8=AF=AF?= =?UTF-8?q?=E4=B8=AD=EF=BC=9B=E4=B8=89=E9=97=B8=E5=85=A8=E7=BB=BF=EF=BC=88?= =?UTF-8?q?gdd=5Flint=200=20=E4=B8=8D=E9=80=9A=E8=BF=87/doc=5Flink=20?= =?UTF-8?q?=E6=AD=BB=E9=93=BE=200/doc=5Fterm=20=E7=96=91=E4=BC=BC=E7=8E=B0?= =?UTF-8?q?=E8=A1=8C=200=20=E5=90=AB=20--strict=20=E5=A4=8D=E6=A0=B8?= =?UTF-8?q?=EF=BC=89=EF=BC=9B=E9=97=B8=E9=97=A8=E5=8D=87=E7=BA=A7=EF=BC=88?= =?UTF-8?q?--strict=20=E5=85=A5=E9=92=A9=E5=AD=90+=E8=B1=81=E5=85=8D?= =?UTF-8?q?=E5=9F=BA=E7=BA=BF=E6=B8=85=E5=8D=95=EF=BC=89=E6=8C=89=E7=94=A8?= =?UTF-8?q?=E6=88=B7=E4=BB=A4=E7=95=99=E5=BE=85=E5=90=8E=E7=BB=AD=E8=AE=A8?= =?UTF-8?q?=E8=AE=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/art/art-assets-checklist.md | 22 +-- design/art/art-bible.md | 140 +++++++++--------- design/art/art-status-checklist.md | 4 +- design/art/asset-path-map.md | 2 +- design/art/character-design.md | 24 +-- design/art/comfyui-prompts.md | 12 +- design/dev/architecture/architecture.md | 10 +- design/dev/code-conventions.md | 4 +- design/dev/concept-conventions.md | 6 +- design/dev/process-conventions.md | 30 ++-- design/dev/test-conventions.md | 4 +- design/gdd/06-待办清单.md | 96 ++++++------ design/gdd/systems/冒险循环/关卡节点图生成.md | 12 +- design/gdd/systems/冒险循环/关卡节点地图.md | 2 +- design/gdd/systems/冒险循环/冒险结构.md | 10 +- design/gdd/systems/冒险循环/奇物.md | 28 ++-- design/gdd/systems/冒险循环/难度曲线与Boss.md | 24 +-- design/gdd/systems/战斗循环/地图战斗资源.md | 2 +- design/gdd/systems/战斗循环/增益状态.md | 2 +- design/gdd/systems/战斗循环/战斗结算.md | 6 +- design/gdd/systems/战斗循环/敌人系统.md | 4 +- design/gdd/systems/排雷循环/地形变异.md | 6 +- design/gdd/systems/排雷循环/行动经济.md | 4 +- design/gdd/systems/表现与支撑/HUD框架.md | 4 +- design/gdd/systems/表现与支撑/音频.md | 2 +- design/gdd/systems/跨局循环/元进度.md | 12 +- design/gdd/systems/跨局循环/天赋树.md | 18 +-- design/gdd/systems/跨局循环/生涯.md | 4 +- design/gdd/systems/跨局循环/秘宝.md | 2 +- design/gdd/systems/跨局循环/锻造工坊.md | 12 +- design/gdd/ux/battle.md | 18 +-- design/gdd/ux/level-clear.md | 4 +- design/gdd/ux/level-map.md | 6 +- design/gdd/ux/shop.md | 2 +- design/registry/architecture.yaml | 4 +- design/registry/entities.yaml | 114 +++++++------- 36 files changed, 328 insertions(+), 328 deletions(-) diff --git a/design/art/art-assets-checklist.md b/design/art/art-assets-checklist.md index cb1d492a..1f010956 100644 --- a/design/art/art-assets-checklist.md +++ b/design/art/art-assets-checklist.md @@ -1,8 +1,8 @@ # 美术资源依赖清单（Art Assets Checklist） > **性质**：表现层升级批与战斗表现批的生产侧清单——把散在战斗表现 / HUD框架 / 关卡节点地图 / 敌人系统里的资产需求收拢成一张可执行的工单视图，**兼资产维度单一登记处**。**规范效力归各 owner 文档**（战斗表现、美术圣经、04-美术音频方向），本文只补「生产视角的需求规格」，冲突时以 owner 文档为准。 -> **建立**：2026-09-18 场景一（战斗画面呈现）讨论产物。**2026-09-22 GDD 过期账清偿批**：原 asset-checklist.md 并入本文后删除，本文自此为两份清单合并后的唯一清单；同批修正敌人键集/徽章数量/样张状态等过期事实（详见 art-bible 版本历史 v1.3）。**2026-09-22 §5 角色设计落地批**：剪影引用迁 art-bible §5.1、护甲区分方案落 §5.3（清偿两处待设计项）、提示词卡 v2.0 重生成（详见 art-bible 版本历史 v1.6）。**2026-09-23 复用盘点批**：立素材站复用渠道与复用闸（§0）；新增 §3.4–3.6 三条此前漏登记的需求（增益状态效果图标 / 营地与元进度件 / 字体）；各条目标注来源渠道。**2026-09-23 §5 抽离批**:角色设计内容迁独立文档 `character-design.md`(art-bible §5 自此为引用存根,小节号不变),本文 §5.x 剪影/护甲引用经存根仍可达;主角特征批(直剑→挖掘铲、加旗朱背旗)随批,主角形象锚见 character-design.md §5.4。**2026-09-23 §6–9 补全批**：art-bible 四章成文（§6 环境/§7 UI/§8 资产规范/§9 参考与反参考）；本文 §0 交付格式与像素尺寸行、参考图行、§6 依赖链随批改指 §8/§9 现行。 -> **更新纪律**：各条目「现状」行随批更新（未开始 / 候选已出 / 已裁决 / 已交付）；做完不删条目，改状态。与 06-待办清单的联动：本文是资产维度明细，06 只留指路存根。 +> **建立**：2026-09-18 场景一（战斗画面呈现）讨论产物。**2026-09-22 GDD 过期账清偿批**：原 asset-checklist.md 并入本文后删除，本文自此为两份清单合并后的唯一清单；同批修正敌人键集/徽章数量/样张状态等过期事实（详见 art-bible 版本历史 v1.3）。**2026-09-22 §5 角色设计落地批**：剪影引用迁 art-bible §5.1、护甲区分方案落 §5.3（清偿两处待设计项）、提示词卡 v2.0 重生成（详见 art-bible 版本历史 v1.6）。**2026-09-23 复用盘点批**：立素材站复用渠道与复用闸（§0）；新增 §3.4–3.6 三条此前漏登记的需求（增益状态效果图标 / 营地与元进度件 / 字体）；各条目标注来源渠道。**2026-09-23 §5 抽离批**:角色设计内容迁独立文档 `character-design.md`(art-bible §5 自此为引用存根,小节号不变),本文 §5.x 剪影/护甲引用经存根仍可达;主角特征批(直剑→挖掘铲、加旗朱背旗)顺带,主角形象锚见 character-design.md §5.4。**2026-09-23 §6–9 补全批**：art-bible 四章成文（§6 环境/§7 UI/§8 资产规范/§9 参考与反参考）；本文 §0 交付格式与像素尺寸行、参考图行、§6 依赖链顺带改指 §8/§9 现行。 +> **更新纪律**：各条目「现状」行顺带更新（未开始 / 候选已出 / 已裁决 / 已交付）；做完不删条目，改状态。与 06-待办清单的联动：本文是资产维度明细，06 只留指路存根。 ## 0. 生产渠道、规格与风格宪法 @@ -11,7 +11,7 @@ | 渠道 | 出什么 | 先例 | |---|---|---| | ♻ **素材站复用（轻改）** | UI 九宫格面板与按钮、字体、通用粒子与光效、通用图标、无缝纹理底噪 | 无（2026-09-23 本批立渠道）；来源偏好 CC0（如 Kenney 全站、OpenGameArt 标 CC0 件、itch.io 免费包） | -| ✦ **ComfyUI（用户自跑）** | 角色、插画级素材；每个敌种/主角建议出 **2–3 版候选**供裁决，不直接出终稿 | 主角站姿样张（2026-09-16 脚本管线产物，源文件已清理）；提示词规格卡 comfyui-prompts.md **v2.0 已重生成**（2026-09-22，美术圣经 §5 落地后正序重生；v1.0 移除决策归台账 125） | +| ✦ **ComfyUI（用户自跑）** | 角色、插画级素材；每个敌种/主角建议出 **2–3 版候选**供裁决，不直接出终稿 | 主角站姿样张（2026-09-16 脚本管线产物，源文件已清理）；提示词规格卡 comfyui-prompts.md **v2.0 已重生成**（2026-09-22，美术圣经 §5 落地后正序重生；v1.0 移除决策归状态记录 125） | | ⚙ **脚本管线（代理出）** | 图标、格面、样张类精度资产 | 格面占位渲染与程序化徽标（现行） | **通用规格纪律**： @@ -26,7 +26,7 @@ | 条款 | 对出图的具体要求 | |---|---| | 一句话视觉规则 | 明快的地牢，轻快的扫荡，仔细的推理——**明亮像素幻想，全年龄，非暗黑**，角色 2~3 头身 | -| 原则一「预告上格」 | 格内绘制优先级 **数字（含色牌）> 小人 > 旗 > 变异纹带 > 装饰变体 > 底色**；任何元素不得遮挡数字字形区；类型微光为底效泛光层，不入遮挡栈 | +| 原则一「预告上格」 | 格内绘制优先级 **数字（含色牌）> 小人 > 旗 > 变异纹带 > 装饰变体 > 底色**；任何元素禁止遮挡数字字形区；类型微光为底效泛光层，不入遮挡栈 | | 原则二「明亮为皮，明度分档为骨」（v3.0） | 暖倾向；数字亮墨直画已开格底（候选亮墨 L≥0.55 / 已开底 L 0.20–0.32，样张 v3 冻结），对比 ≥4.5:1；色牌 `#F5EAD3` 降级为复杂格底后备（牌上深墨 L≤0.027）；未开格底 L≥0.30、HSV 饱和 ≤0.55 | | 原则三「一砖一世界」 | 变体优先换色板不加新资产；危险状态必须**形状+颜色双通道**（色弱灰度可辨） | | 类型预读单通道（§4.6.3） | 未开格 = **类型常显微光**（五组色带 §4.2：芥末黄/黄绿/青/紫罗兰/绯红，色相+明度双码，均候选值，避 300°–345° 禁入带，样张批冻结）；不呈现极性、不泄危险格与安全格〔角嵌形状通道 2026-09-28 退役——用户裁微光格只留微光〕 | @@ -59,7 +59,7 @@ ## 2. P1 —— 角色级（样张通过后开工，ComfyUI） -> 提示词规格卡 comfyui-prompts.md 已于 2026-09-22 按「圣经 §5 落地后重生成」拍板重写为 **v2.0**（主角三态+八敌种，逐资产自包含完整提示词，整段可直贴）；v1.0 移除决策归台账 125 收口登记（production/session-state/active.md）。 +> 提示词规格卡 comfyui-prompts.md 已于 2026-09-22 按「圣经 §5 落地后重生成」拍板重写为 **v2.0**（主角三态+八敌种，逐资产自包含完整提示词，整段可直贴）；v1.0 移除决策归状态记录 125 完成登记（production/session-state/active.md）。 ### 2.1 主角战斗小人 @@ -112,7 +112,7 @@ - **要什么**：四类节点图标（战斗 / 奖励 / 恢复 / Boss）+ 图版行进器形象（棋子）。 - **风格/规格**：容器走石板圆角语法；Boss 节点可用紫赤；奖励节点可用奖励金；恢复节点绿=自然生机（零逻辑语义，仅氛围）；行进器=小人同族蓝。 - **来源**：♻ 素材站复用优先——通用地图/桌游图标（如 Kenney 件）改色量化，过复用闸；⚙ 兜底。行进器与小人同族，宜 ✦/⚙ 与主角同批出。 -- **联动**：正式节点图 UI 设计未成文（登记待办：排秘宝内容批后与美术批同期待拍板）；HUD框架义务清单漏「关卡节点地图」行，随批补。 +- **联动**：正式节点图 UI 设计未成文（登记待办：排秘宝内容批后与美术批同期待拍板）；HUD框架义务清单漏「关卡节点地图」行，顺带补。 - **现状**：程序化占位，够试玩。 ### 3.3 雷 / 旗 / 数字格面像素化 ⚙ @@ -131,7 +131,7 @@ ### 3.5 营地与元进度件（2026-09-23 新登记，此前清单漏登记） - **要什么**：钥石顶栏图标、永久强化条目图标（营地三柜台货架件）、柜台场景贴图（属性锻造/秘宝匣/奖励格图鉴）。 -- **来源/规格**：图标类 ♻ 通用钥匙/强化图标改色过闸；柜台场景贴图 ♻ 木石材质件拼装或 ✦ 插画级（烛光黄 `#F6C667` + 木色 `#8A5A34`，art-bible §4.4）；排期归 UI 贴图重构批（营地现为程序化占位，台账 121⑧ 口径）。 +- **来源/规格**：图标类 ♻ 通用钥匙/强化图标改色过闸；柜台场景贴图 ♻ 木石材质件拼装或 ✦ 插画级（烛光黄 `#F6C667` + 木色 `#8A5A34`，art-bible §4.4）；排期归 UI 贴图重构批（营地现为程序化占位，状态记录 121⑧ 口径）。 - **现状**：全占位。 ### 3.6 字体（数字像素字 + 中文像素字）（2026-09-23 新登记，此前清单漏登记） @@ -157,7 +157,7 @@ ## 5. 明确不在本清单 - **音乐音效**：文档定稿「MVP 占位即可，核心循环验证后再定」。 -- **秘宝图标**：内容归 Alpha 秘宝整体重设计批（台账 112 口径），内容未定不能先做；渠道届时按 ♻/✦ 另评。 +- **秘宝图标**：内容归 Alpha 秘宝整体重设计批（状态记录 112 口径），内容未定不能先做；渠道届时按 ♻/✦ 另评。 - **封面图/宣传图**：Alpha 后另批，不阻塞切片；需项目角色出镜，素材站合成观感差，宜 ✦。 - **地形变异专属纹理**：~~变异表为空，纹带种类待地形变异批定夺~~——**六类型已定稿（2026-09-20 地形变异批）**，纹带需求 = 2 纹形（伤害轴刺缺形/信息轴遮蔽形）× 3 图类型色板，**样张批后可排产**；形状通道规则见 art-bible §3.2。 - **精英/Boss 护甲类型视觉区分**：~~待设计项~~ **已落 art-bible §5.3**（候选方案：甲面覆盖率×甲材质色三档，样张批冻结）。 @@ -169,7 +169,7 @@ │ 战斗一屏样张(1.2) ──> 角色终稿(2.1/2.2) ──> 意图动画三档(2.3) ──> 演出类(P4) │ - └─> 敌人卡形态裁决 ✅已收口（2026-09-20 拍板全站桩，卡片式退役） + └─> 敌人卡形态裁决 ✅已完成（2026-09-20 拍板全站桩，卡片式退役） 徽章(3.1)/节点图(3.2)/效果图标(3.4) —— 独立线，可随时插队 ♻ 复用件(3.2/3.4/3.5/3.6/演出粒子) —— 不依赖样张，可随时插队（入包闸 = §0 复用四道） 字体(3.6)接入归表现批；营地件(3.5)归 UI 贴图重构批 @@ -184,7 +184,7 @@ | 素材包 | 授权 | 署名义务 | 结论 | |---|---|---|---| -| Kenney 全系(ui-pack/fantasy-ui-borders/game-icons/board-game-icons/kenney-fonts/roguelike 系/tiny-dungeon/tiny-town) | CC0 | 无 | ui-reuse 待审;tiny-dungeon 终局否决(架构不适配);余随批否决 | +| Kenney 全系(ui-pack/fantasy-ui-borders/game-icons/board-game-icons/kenney-fonts/roguelike 系/tiny-dungeon/tiny-town) | CC0 | 无 | ui-reuse 待审;tiny-dungeon 终局否决(架构不适配);余顺带否决 | | OGA Pixel UI 750(Kenney 作) / PixUI(CamTatz) / Handpainted stone | CC0 | 无 | ui-reuse 待审 | | DENZI public domain art | CC0 | 无 | 否决 | | beast-cave(OGA) | CC0 | 无 | **已选中入工程**(地砖批;2026-09-26 被 terrain_ 自产全套取代,源包归档) | @@ -197,7 +197,7 @@ | Golden UI 系列 | CC-BY-SA | — | **闸④不过,未下载** | | Gemini 生图(用户自跑) | 自产 | 无 | **terrain_ 高墙瓦片材质源(现行定稿)** | -### 复用四闸(台账 130,现行) +### 复用四闸(状态记录 130,现行) 色板量化 / 禁入带吸色 / 灰度可辨 / 授权干净(SA 不可、来路不明不可)。 ## 版本历史 diff --git a/design/art/art-bible.md b/design/art/art-bible.md index 1a4a43b9..707d08dd 100644 --- a/design/art/art-bible.md +++ b/design/art/art-bible.md @@ -1,11 +1,11 @@ # 美术圣经(Art Bible)— Dungeon Sweeper -> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归台账 125);历次修订明细见文末版本历史(现行为 v3.11) +> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归状态记录 125);历次修订明细见文末版本历史(现行为 v3.11) > > **Art Director Sign-Off (AD-ART-BIBLE)**:历次批均 SKIPPED(v1.8 §6–9 补全亦 SKIPPED)— Lean/Solo mode(非 PHASE-GATE;§6–9 已成文,full 门禁签核时机待用户表态) > 风格基调(2026-09-10 用户定稿):地牢题材但**非暗黑风**——轻快明亮的幻想冒险风,全年龄;像素风;角色 2~3 头身 > 参考池(用户审阅选定,三者相融):**Into the Breach**(网格信息分层;雷图棋盘呈现基准 = 其战棋地块质感 × 正俯视角,见 §3.2)× **Moonlighter**(明亮像素地牢质感)× **Peglin**(明快全年龄地牢色彩);参考截图存于 `design/art/references/`(三款×2 张,与点名池一一对应;gungeon 两张经 2026-09-22 裁决退场;正面取/弃与反面条款已成文 §9,反面图证待素材生成后另批增补) -> 约束(2026-09-10 用户强调):本圣经是**纯表现层文档**——明亮轻快是美术风格,不是玩法成分。圣经不得引入、暗示或预设任何玩法语义,不改变任何 GDD 已锁机制;凡表现层需要玩法钩子才能表达之处(如完美排雷检测、Boss 预警),一律标注「待 GDD 定夺」,圣经只规定"若有,则如何呈现"。GDD 机制与圣经冲突时,机制语义以 GDD 为准,呈现方案以本圣经为准 +> 约束(2026-09-10 用户强调):本圣经是**纯表现层文档**——明亮轻快是美术风格,不是玩法成分。圣经禁止引入、暗示或预设任何玩法语义,不改变任何 GDD 已锁机制;凡表现层需要玩法钩子才能表达之处(如完美排雷检测、Boss 预警),一律标注「待 GDD 定夺」,圣经只规定"若有,则如何呈现"。GDD 机制与圣经冲突时,机制语义以 GDD 为准,呈现方案以本圣经为准 > **条款验收标注纪律(2026-10-06 P2-4 用户拍板,全文书写规范)**:条款尾部按三档标注验收方式——**`←机检: <断言>`**(脚本可自动判定)/ **`←目检: <判据>`**(机器测不了,但看什么、算过有明确判据)/ **`←方向性`**(气质与方向原则,不承担验收);**新条款一律按此书写**,存量口号型条款分章补标(约 55%,06 挂账「口号型条款机检化批」分章推进、每章交付抽验);数值类条款推荐「**待定现用**」态(现行即执法、修订走登记,释义见 §4.1) --- @@ -22,7 +22,7 @@ **原则一|预告上格**(取自 Into the Breach;锚定 P1 推理的掌控感、P2 规划的延迟兑现) -继承其格内信息分层与"攻击预告画在目标格上"的范式:一切威胁、伤害与结算预告必须直接绘制在雷图格本体上,禁止只进侧栏或悬浮提示;格内绘制优先级固定:**数字(含色牌) > 小人标记 > 旗 > 变异纹带 > 装饰变体 > 底色**,任何元素不得遮挡数字(格面类型预读 = 类型微光单通道〔色相+明度双码,2026-09-28 角嵌退役〕,色带见 §4.2、键契约见 §4.6;徽章小图标族保留给库存与结算明细;类型微光为底效泛光层,不入遮挡栈、不遮任何元素)。与 ITB 之别:只取其信息骨架,弃其冷暗军事色调。 +继承其格内信息分层与"攻击预告画在目标格上"的范式:一切威胁、伤害与结算预告必须直接绘制在雷图格本体上,禁止只进侧栏或悬浮提示;格内绘制优先级固定:**数字(含色牌) > 小人标记 > 旗 > 变异纹带 > 装饰变体 > 底色**,任何元素禁止遮挡数字(格面类型预读 = 类型微光单通道〔色相+明度双码,2026-09-28 角嵌退役〕,色带见 §4.2、键契约见 §4.6;徽章小图标族保留给库存与结算明细;类型微光为底效泛光层,不入遮挡栈、不遮任何元素)。与 ITB 之别:只取其信息骨架,弃其冷暗军事色调。 *范围注(2026-09-10):本原则约束"已存在的信息往哪里画",不新增信息种类;预告类信息以战斗侧 GDD 实际定义的为准(如 P2 已锁的结算来源标注),GDD 未定义的预告不因本条而存在。* @@ -36,15 +36,15 @@ **原则三|一砖一世界**(融合 Moonlighter 地砖观;锚定 P3 风险与收益同源、P4 地牢下探隐喻) -格子即地牢地砖:未开 = 覆尘完整砖,已开 = 碎裂裸露,雷 = 被惊动的巢穴(格态定义与玩家说法见《排雷玩法》),图类型(board_type)= 同款地砖换色板。图类型与变异格的视觉差异一律先做色板变体,不做新资产;一切危险状态必须"形状 + 颜色"双通道冗余,色弱可辨。像 Moonlighter 之处在砖缝质感与暖色道具,但装饰不得伪装成逻辑差异——玩家须一眼分清"好看"与"有雷"。 +格子即地牢地砖:未开 = 覆尘完整砖,已开 = 碎裂裸露,雷 = 被惊动的巢穴(格态定义与玩家说法见《排雷玩法》),图类型(board_type)= 同款地砖换色板。图类型与变异格的视觉差异一律先做色板变体,不做新资产;一切危险状态必须"形状 + 颜色"双通道冗余,色弱可辨。像 Moonlighter 之处在砖缝质感与暖色道具,但装饰禁止伪装成逻辑差异——玩家须一眼分清"好看"与"有雷"。 -格子同时是**内容舞台**,格与格的美术表达按格内实态分层多样化(画法细则 §3.2):已开格按当格结果整格表达——产资源格嵌对应家族物件纹样(地图战斗资源九类型,§4.6.3)、纯安全格呈现干净裸土、危险格巢穴更凶;未开格在覆尘完整砖之上叠加**装饰变体**(裂纹/碎石斑/物件级点缀等氛围层;2026-09-29 v3.0 物件级解禁——物件级装饰〔小石块/陶片/骨殖等〕须走**专属装饰形状家族**:形与信息元素〔数字/小人/旗/纹样〕形状语言隔离,灰度下不与任何逻辑元素同形;零信息纪律不变——随机分布、与雷/安/类型零相关、不得构成可读线索、分布每板一次跨轮不复掷;焦点预算约束不变——装饰不构成完整凸形、不抢读,§3.4;数量配额按图类型定,候选 3–5 种,样张 v3 冻结;用途=破除大面积同砖平铺的重复感);未开格的类型预读画为**类型微光单通道**(色相+明度双码;仍只表达类型,不泄危险格与安全格——呈现契约见 §4.6.3;概念定义、可见范围与生命周期见《HUD框架》「未开格类型微光」节)。 +格子同时是**内容舞台**,格与格的美术表达按格内实态分层多样化(画法细则 §3.2):已开格按当格结果整格表达——产资源格嵌对应家族物件纹样(地图战斗资源九类型,§4.6.3)、纯安全格呈现干净裸土、危险格巢穴更凶;未开格在覆尘完整砖之上叠加**装饰变体**(裂纹/碎石斑/物件级点缀等氛围层;2026-09-29 v3.0 物件级解禁——物件级装饰〔小石块/陶片/骨殖等〕须走**专属装饰形状家族**:形与信息元素〔数字/小人/旗/纹样〕形状语言隔离,灰度下不与任何逻辑元素同形;零信息纪律不变——随机分布、与雷/安/类型零相关、禁止构成可读线索、分布每板一次跨轮不复掷;焦点预算约束不变——装饰不构成完整凸形、不抢读,§3.4;数量配额按图类型定,候选 3–5 种,样张 v3 冻结;用途=破除大面积同砖平铺的重复感);未开格的类型预读画为**类型微光单通道**(色相+明度双码;仍只表达类型,不泄危险格与安全格——呈现契约见 §4.6.3;概念定义、可见范围与生命周期见《HUD框架》「未开格类型微光」节)。 *设计测试:当新图类型或新变异格需要新视觉时,先换色板加形状,再谈新资产;当格子多样化与"好看/有雷"之辨冲突时,砍装饰,不动逻辑通道。* ### 1.3 修订记录(已迁出) -早期"对 brainstorm 视觉锚的修订记录"整节并入文末**版本历史**(v1.0/v1.1/v1.2/v1.3 条目承载);本节留号占位,正文只描述现行规则(台账 109 纪律)。 +早期"对 brainstorm 视觉锚的修订记录"整节并入文末**版本历史**(v1.0/v1.1/v1.2/v1.3 条目承载);本节留号占位,正文只描述现行规则(状态记录 109 纪律)。 ### 1.4 格子样张测试(验收标准,2026-09-13 成文) @@ -54,18 +54,18 @@ **验收项按序判定,第一项不过 = 整张否决(数字可读性定风格,风格服从可读)**: -1. **第一验收项|数字可读性(硬指标,可测;2026-09-29 v3.0 改格底分档承载)**:1–8 全档数字对其所在**已开格底**直画 WCAG 对比 ≥4.5:1(§4.1 参数域:已开格底走世界底层档,候选 L 0.08–0.14;棋盘数字墨亮族,L≥0.75 候选——均待样张 v3 冻结〔v3.0 原拟 L 0.20–0.32/L≥0.55 经 WCAG 实测不可达 4.5:1,候选带随样张批修正〕);复杂格底(物件纹样/变异纹带/微光叠加致直画对比不足)启用**色牌后备**,牌墨组合 ≥4.5:1(色牌 L≥0.70、牌上数字用深墨族),牌缘灰度可分;0.5× 缩放抽检数字仍可辨;纹带/裂纹/巢穴纹/物件纹样不得侵入数字字形占位区(砖心留白,§3.2)。 -2. **格态三形可辨(灰度通道)**:未开/已开/雷三态转灰度截图后仍可逐格分类(§3.2 完整度叙事;v3.0 起明度差〔墙亮/空间暗〕为合法分类通道,与碎裂形双通道冗余);装饰变体不得制造新的分类特征——同一格态下带与不带变体的灰度差异不得成为三态分类线索;色弱模拟(去色相)下旗、巢穴纹不与裂纹混淆;**五组类型微光互辨**——色弱玩家的类型主通道 = 微光(色相+明度双码,2026-09-28 角嵌退役后微光以明度梯度承载分组（组内不细分）,§2 信息面层内梯度),微光不得侵入数字字形占位区、明度梯度不得压破格底明度档(三态分类不受扰)。 +1. **第一验收项|数字可读性(硬指标,可测;2026-09-29 v3.0 改格底分档承载)**:1–8 全档数字对其所在**已开格底**直画 WCAG 对比 ≥4.5:1(§4.1 参数域:已开格底走世界底层档,候选 L 0.08–0.14;棋盘数字墨亮族,L≥0.75 候选——均待样张 v3 冻结〔v3.0 原拟 L 0.20–0.32/L≥0.55 经 WCAG 实测不可达 4.5:1,候选带随样张批修正〕);复杂格底(物件纹样/变异纹带/微光叠加致直画对比不足)启用**色牌后备**,牌墨组合 ≥4.5:1(色牌 L≥0.70、牌上数字用深墨族),牌缘灰度可分;0.5× 缩放抽检数字仍可辨;纹带/裂纹/巢穴纹/物件纹样禁止侵入数字字形占位区(砖心留白,§3.2)。 +2. **格态三形可辨(灰度通道)**:未开/已开/雷三态转灰度截图后仍可逐格分类(§3.2 完整度叙事;v3.0 起明度差〔墙亮/空间暗〕为合法分类通道,与碎裂形双通道冗余);装饰变体禁止制造新的分类特征——同一格态下带与不带变体的灰度差异禁止成为三态分类线索;色弱模拟(去色相)下旗、巢穴纹不与裂纹混淆;**五组类型微光互辨**——色弱玩家的类型主通道 = 微光(色相+明度双码,2026-09-28 角嵌退役后微光以明度梯度承载分组（组内不细分）,§2 信息面层内梯度),微光禁止侵入数字字形占位区、明度梯度禁止压破格底明度档(三态分类不受扰)。 3. **焦点预算成立(§3.4)**:任意一格至多一个完整凸形;数字所在格无第二焦点。 4. **图类型换皮抽测(§4.3)**:变体组中数字墨亮族三档、封印黑、危险红、奖励金、小人蓝、数字色牌(后备件)、类型微光五组恒定不动;变体格底仍过第 1、2 项指标。 **判定与回退**:第 1 项不过 → 按原则二设计测试回退——先调格底明度档,复杂格底垫色牌兜底,禁止缩字号换字形逃避;第 2–4 项不过 → 修形不修数。样张通过 = 砖面形态与色板冻结;新增图类型/变异色板须重跑本测试(§4.3)。执行时机:正式砖面资产开工前;《HUD框架》以本节为引用依据(2026-09-07 门禁:样张测试并入 art-bible 执行)。 -**整屏样张闸(2026-09-29 v3.0 新增)**:格子样张验"格",整屏样张验"屏"——战斗屏/关卡屏/菜单屏/营地屏各出一张整屏样张,验收四项:①全部文字(含菜单/说明/tooltip/按钮)对其直接背景 ≥4.5:1(WCAG AA;大字〔≥18px 或加粗档〕底线 3:1、目标 4.5:1);②明度分层三档带成立(信息面层 > 世界中层 > 世界底层,层间灰度可分);③整屏焦点预算(§3.4:首焦唯一——数字区/立绘/主按钮,无第二焦点竞争;负空间服务焦点,不属空窗);④文字禁直接压纹理底(垫容器或罩层)。闸形 = **方向稿目检先行**(防"机检过闸但气质否决"式返工),目检过后机检冻结。执行时机 = 屏级视觉落码开工前;过闸前一切屏级视觉为占位临时态(§7.1 收口条款)。现行 §1.4 格子样张机检断言集中涉色牌/明度档条目随样张 v3 重跑同步改造(登记 06-待办清单)。 +**整屏样张闸(2026-09-29 v3.0 新增)**:格子样张验"格",整屏样张验"屏"——战斗屏/关卡屏/菜单屏/营地屏各出一张整屏样张,验收四项:①全部文字(含菜单/说明/tooltip/按钮)对其直接背景 ≥4.5:1(WCAG AA;大字〔≥18px 或加粗档〕底线 3:1、目标 4.5:1);②明度分层三档带成立(信息面层 > 世界中层 > 世界底层,层间灰度可分);③整屏焦点预算(§3.4:首焦唯一——数字区/立绘/主按钮,无第二焦点竞争;负空间服务焦点,不属空窗);④文字禁直接压纹理底(垫容器或罩层)。闸形 = **方向稿目检先行**(防"机检过闸但气质否决"式返工),目检过后机检冻结。执行时机 = 屏级视觉落码开工前;过闸前一切屏级视觉为占位临时态(§7.1 完成条款)。现行 §1.4 格子样张机检断言集中涉色牌/明度档条目随样张 v3 重跑同步改造(登记 06-待办清单)。 > **样张 v2 记录(2026-09-28,四冻结生效)**:机检 16/16 全绿(扩展断言集:A3 图底分离 Δ≥55/F6 墙格顶面立面双明度带 Δ≥18/F7 整板悬崖 DEPTH_PX 与游戏渲染常量同源/A6 观感密度梯度均值 ≥4.70=v1 实测 4.09×1.15)。**四冻结**——①砖面形态:方案甲 21 瓦片+高墙感 D 投影档+整板悬崖(§3.2 高墙瓦片体系条定稿参数);②色板:小人蓝 #2E86DE/接触带微光 #D6ECFF/类型微光五组定稿(§4.1/§4.2);③动画方案:§8.4 帧数档冻结;④数字形制:色牌形制定稿(#F5EAD3 素色直角小牌+Fusion Pixel+字号 max(18, ceil(格边×0.5))+墨三档,§7.4)。产物=`artwork/mockups/sample-batch-v2-2026-09-28.png`,机检报告=git 提交 f9b0765;气质终审=批末用户目检(闸形 A,2026-09-27 拍板)。**(v3.0 注:四冻结之①砖面形态的数字承载面与④数字形制随色牌降级解冻,待样张 v3 重冻;②色板③动画维持冻结不变)** -> **样张 v3 冻结记录(2026-09-30,迭代 9 T1 批 A——四冻结①④重冻生效,圣经升 v3.1)**:机检 17/17 全绿,断言定值两件落锁——A3b 图底分离**定值 Δ≥30**(方向稿实测 38;v2 阈值 55 系色牌制地板 L0.036 时代校定,与格底分档带数学冲突退役)/A4 尺寸基线**硬等冻结**(立绘 46×48+棋盘小人源 32×32;资产升档批换代须显式解冻重校);F6 沿用 v3.4 双明度带口径 Δ≥18。**重冻两件**——①砖面形态:E 格高墙 30% 承接词表扩展(南邻墙地面格南部 30% 承接墙面、墙顶纹理**原亮度**直贴零暗档零阴影、(b)-(c) 连接处无边框〔渲染格线跳段〕、连续墙体内侧不出立面;南向厚度面+v3.4 暗档 D 投影保留)+**格底明度分档**(已开格底=世界底层档 L≈0.10,候选带 0.08–0.14;落码程序归一,地板素材重产归资产批)+装饰物件级解禁(专属形状家族,零信息纪律不变)/④数字形制:**亮墨三档直画**(1–3 冷亮 #D8ECF0/4–5 暖白 #F0E2C8/6–8 金亮 #F8E3A8,直画已开格底,实测对比 6.0–6.3:1)+**色牌后备**(#F5EAD3 仅复杂格底——物件纹样/装饰变体格——垫牌兜底,牌上深墨族 12:1)。②色板③动画维持 v2 冻结不变。产物=`artwork/mockups/sample-batch-v3-final-2026-09-30.png`,机检报告=git 提交 7a847c7【冻结】;气质终审=2026-09-29 用户验收豁免(新 v3.5 方向稿验收通过,台账 281)。 +> **样张 v3 冻结记录(2026-09-30,迭代 9 T1 批 A——四冻结①④重冻生效,圣经升 v3.1)**:机检 17/17 全绿,断言定值两件落锁——A3b 图底分离**定值 Δ≥30**(方向稿实测 38;v2 阈值 55 系色牌制地板 L0.036 时代校定,与格底分档带数学冲突退役)/A4 尺寸基线**硬等冻结**(立绘 46×48+棋盘小人源 32×32;资产升档批换代须显式解冻重校);F6 沿用 v3.4 双明度带口径 Δ≥18。**重冻两件**——①砖面形态:E 格高墙 30% 承接词表扩展(南邻墙地面格南部 30% 承接墙面、墙顶纹理**原亮度**直贴零暗档零阴影、(b)-(c) 连接处无边框〔渲染格线跳段〕、连续墙体内侧不出立面;南向厚度面+v3.4 暗档 D 投影保留)+**格底明度分档**(已开格底=世界底层档 L≈0.10,候选带 0.08–0.14;落码程序归一,地板素材重产归资产批)+装饰物件级解禁(专属形状家族,零信息纪律不变)/④数字形制:**亮墨三档直画**(1–3 冷亮 #D8ECF0/4–5 暖白 #F0E2C8/6–8 金亮 #F8E3A8,直画已开格底,实测对比 6.0–6.3:1)+**色牌后备**(#F5EAD3 仅复杂格底——物件纹样/装饰变体格——垫牌兜底,牌上深墨族 12:1)。②色板③动画维持 v2 冻结不变。产物=`artwork/mockups/sample-batch-v3-final-2026-09-30.png`,机检报告=git 提交 7a847c7【冻结】;气质终审=2026-09-29 用户验收豁免(新 v3.5 方向稿验收通过,状态记录 281)。 --- @@ -163,14 +163,14 @@ - **雷图棋盘呈现基准**:战棋地块质感 × 正俯视角——取 ITB 参考图(`references/itb_1.jpg`)的地表质感骨架:地块纹理多样、起伏体块感、岛缘/砖缘厚度、格上装饰小立牌;但相机一律正上方垂直向下,格线屏轴对齐,**禁等距/斜视角与菱形格**;形状语言仍守总纲圆角方形。砖缘厚度与岛缘立体面属形体塑造,不属状态/情绪表达,不受 §2 情绪明暗禁令约束(2026-09-29 v3.0:本例外上升为 §2 明度分层允许域通则;顶面格底仍守 §4.1 参数域);装饰小立牌属 ITB 参考的观感元素,本作不采用——装饰变体走氛围层纪律(纹理级/物件级形状家族,见下方装饰变体条),零信息纪律不变。←原二;原三;§2 - **地砖**:一切环境体由同一圆角方形衍生:未开=完整凸砖,已开=同形缺角碎裂,雷=碎裂加巢穴纹(危险格玩家说法见《排雷玩法》);只以"完整度"叙事,不为状态新造形。←原三;P4 -- **装饰变体(未开格氛围层)**:覆尘完整砖之上叠加裂纹/碎石斑/物件级点缀等装饰;2026-09-29 v3.0 物件级解禁——物件级装饰(小石块/陶片/骨殖等)须走**专属装饰形状家族**(与信息元素形状语言隔离、灰度下不与任何逻辑元素同形),数量配额按图类型定(候选 3–5 种,样张 v3 冻结),一律残缺、内凹、低对比而自然后退(§3.4);零信息纪律(分布随机、与雷/安/类型零相关、灰度下不得制造新分类特征、分布每板一次跨轮不复掷)以原则三为准,此处不赘。←原三 +- **装饰变体(未开格氛围层)**:覆尘完整砖之上叠加裂纹/碎石斑/物件级点缀等装饰;2026-09-29 v3.0 物件级解禁——物件级装饰(小石块/陶片/骨殖等)须走**专属装饰形状家族**(与信息元素形状语言隔离、灰度下不与任何逻辑元素同形),数量配额按图类型定(候选 3–5 种,样张 v3 冻结),一律残缺、内凹、低对比而自然后退(§3.4);零信息纪律(分布随机、与雷/安/类型零相关、灰度下禁止制造新分类特征、分布每板一次跨轮不复掷)以原则三为准,此处不赘。←原三 - **结果整格表达(已开格)**:已开格按当格结果整格表达(结果清单见原则三);画法——产资源格的家族物件纹样用 §3.1 道具点剪影语言(直线几何体)角嵌于砖缘,砖心与数字字形占位区留白(已开格仍承载数字);危险格巢穴纹较已开格更凶一档,形状+颜色双通道不变。←原三;P3 - **未开格预读通道(微光单通道)**:类型预读 = 类型微光单通道(色相+明度双码,色带 §4.2);色弱类型主通道 = 微光明度梯度（组粒度——组间互辨；§2 微光明度例外）;格内零角嵌/箭头/加号类附加形(2026-09-28 用户裁「微光格只留微光」,退役史见版本历史 v2.12)。←原一;原三 -- **旗(封印印记)**:插旗动作的叙事呈现 = **封印**(玩家可见专名,术语定义见 registry terminology「封印」条;插旗动作面见《排雷玩法》)——旗 = 封印印记;封印色(§4.1,现行封印黑)与格内优先级栈位(§1.2)不变。封印特效(施印瞬间 + 印记常显形态)资产归清单 §4 演出类;旗印记纹理已落位、字形占位退役（迭代 9 卡⑬兑现；原 06 债务条目已收口移除）。←原一;P2;术语批 2026-09-25;封印紫批 2026-09-26;封印黑批 2026-09-28 +- **旗(封印印记)**:插旗动作的叙事呈现 = **封印**(玩家可见专名,术语定义见 registry terminology「封印」条;插旗动作面见《排雷玩法》)——旗 = 封印印记;封印色(§4.1,现行封印黑)与格内优先级栈位(§1.2)不变。封印特效(施印瞬间 + 印记常显形态)资产归清单 §4 演出类;旗印记纹理已落位、字形占位退役（迭代 9 卡⑬兑现；原 06 债务条目已完成移除）。←原一;P2;术语批 2026-09-25;封印紫批 2026-09-26;封印黑批 2026-09-28 - **可挖域接触带微光(交互反馈层,2026-09-25 用户拍板)**:挖掘期,英雄格周界与可挖域(概念见《排雷玩法》动作合法性节;呈现义务见《HUD框架》可挖域指示)的接触面画呼吸微光——正交邻墙=该侧整条边,斜向邻墙=共享角点+向两侧各延伸半条边;光只画英雄格(空间)一侧、不进墙格(与装饰变体零冲突,数字砖心不涉);微光=空间的灯光边界(画法口径)。色相=蓝族浅一档(§4.2 蓝条;与主角蓝框的分层归样张批);呼吸=§2.1 挖掘期唯一在动元素,减动效停格。角点为斜墙与正交墙共享、不逐格归因,逐格指认=悬停金框(呈现交互归《HUD框架》悬停指示域)。←§2.1;§4.2;P1 -- **墙体**:圆角砌块堆叠,禁尖刺装饰——尖刺专属危险语义,装饰不得伪装逻辑差异。←原三 -- **高墙瓦片体系(2026-09-26 定稿,样张批追认)**:未挖格=**一整块 32×32 自含凸起岩体**(方案甲核心定义);素材语义名——未开格素材=**墙瓦片**,已开格素材=**地面瓦片**(术语 2026-09-26 用户立)。**边界=墨线纪律**:墙瓦片与相邻格分界一律 1px 深墨线、直线贴格边、零锯齿;墨线职责=分隔,不追求与地面融合(Tiny Dungeon 样图实证调研后否决出局——TD 拼块套不进方案甲自含岩体定义,2026-09-25 终局维持方案甲;记录=git 提交 70d2320)。**光照=单一北受光**:北缘=墨线内侧 1px 微亮棱(就地取色提亮,禁宽亮带);西/东缘=墨线后直进纹理、不加修饰;南缘=墨线+立面窄暗条(约 1/3 格高,横层理叠石、禁竖条纹栅栏感)。**凹角**:角点单像素落线;南立面侧凹角加 1px 立面收头——带身与转角竖线同列收尾,禁悬空、禁突出(v9.1/v9.2 两版返工实证)。现行定稿=`game/assets/art/board/terrain_*`(16 唯一墙瓦片+5 地面瓦片变体;词表与查表逻辑见 `高墙瓦片词表（已落码 board_world.gd 查表，文件已退役）`)。**高墙感 D 投影档+整板悬崖(样张 v2 定稿 2026-09-28,用户 2026-09-27 四变体挑档)**:南临空墙格=立面口沿高光 2px `Color8(196,172,132)`+双段暗带(0.16/0.25 格边,黑罩 α0.60/0.82);北邻墙地面格=三段渐隐投影(顶带 0.22 格边,α0.28 起);整板悬崖=板底/右侧 `DEPTH_PX 8px` 暗面+列分隔竖缝+岩层横纹+口沿高光+接触 AO+底线收边+悬浮影(游戏 `board_world.gd` 同款结构件,样张脚本与游戏渲染常量同源——机检 F7 承载)。←原三;台账 164;样张 v2 批 2026-09-28 -- **变异格形状通道**(双通道之"形",与色无关):底砖圆角外轮廓不变,砖面内缘绘一圈定宽专属几何纹带(纹带形全作不与他类共用),砖心留白予数字与旗;验收标准=**灰度截图下仍可分类**。种类清单 = 地形变异六类型已定稿(地形变异 GDD;荆棘丛/藤蔓缠绕/岩浆/烬覆/落石/矿尘):**纹带形按轴只分两种**——伤害轴(荆棘丛/岩浆/落石)= 刺/缺排斥形,信息轴(藤蔓缠绕/烬覆/矿尘)= 遮蔽/缠绕形;同轴跨图类型只做色板变体(§4.3 `variant_tint` 槽),不做新纹形。样张批增查:岩浆纹带橙红须与危险红互辨(变异格不是雷,色相邻近混淆风险);信息轴遮蔽呈现不得侵入数字字形占位区(§1.4 验收 1 延伸)。←原一(纹理位次第 4,让位于数字/小人/旗);原三 +- **墙体**:圆角砌块堆叠,禁尖刺装饰——尖刺专属危险语义,装饰禁止伪装逻辑差异。←原三 +- **高墙瓦片体系(2026-09-26 定稿,样张批追认)**:未挖格=**一整块 32×32 自含凸起岩体**(方案甲核心定义);素材语义名——未开格素材=**墙瓦片**,已开格素材=**地面瓦片**(术语 2026-09-26 用户立)。**边界=墨线纪律**:墙瓦片与相邻格分界一律 1px 深墨线、直线贴格边、零锯齿;墨线职责=分隔,不追求与地面融合(Tiny Dungeon 样图实证调研后否决出局——TD 拼块套不进方案甲自含岩体定义,2026-09-25 终局维持方案甲;记录=git 提交 70d2320)。**光照=单一北受光**:北缘=墨线内侧 1px 微亮棱(就地取色提亮,禁宽亮带);西/东缘=墨线后直进纹理、不加修饰;南缘=墨线+立面窄暗条(约 1/3 格高,横层理叠石、禁竖条纹栅栏感)。**凹角**:角点单像素落线;南立面侧凹角加 1px 立面收头——带身与转角竖线同列收尾,禁悬空、禁突出(v9.1/v9.2 两版返工实证)。现行定稿=`game/assets/art/board/terrain_*`(16 唯一墙瓦片+5 地面瓦片变体;词表与查表逻辑见 `高墙瓦片词表（已落码 board_world.gd 查表，文件已退役）`)。**高墙感 D 投影档+整板悬崖(样张 v2 定稿 2026-09-28,用户 2026-09-27 四变体挑档)**:南临空墙格=立面口沿高光 2px `Color8(196,172,132)`+双段暗带(0.16/0.25 格边,黑罩 α0.60/0.82);北邻墙地面格=三段渐隐投影(顶带 0.22 格边,α0.28 起);整板悬崖=板底/右侧 `DEPTH_PX 8px` 暗面+列分隔竖缝+岩层横纹+口沿高光+接触 AO+底线收边+悬浮影(游戏 `board_world.gd` 同款结构件,样张脚本与游戏渲染常量同源——机检 F7 承载)。←原三;状态记录 164;样张 v2 批 2026-09-28 +- **变异格形状通道**(双通道之"形",与色无关):底砖圆角外轮廓不变,砖面内缘绘一圈定宽专属几何纹带(纹带形全作不与他类共用),砖心留白予数字与旗;验收标准=**灰度截图下仍可分类**。种类清单 = 地形变异六类型已定稿(地形变异 GDD;荆棘丛/藤蔓缠绕/岩浆/烬覆/落石/矿尘):**纹带形按轴只分两种**——伤害轴(荆棘丛/岩浆/落石)= 刺/缺排斥形,信息轴(藤蔓缠绕/烬覆/矿尘)= 遮蔽/缠绕形;同轴跨图类型只做色板变体(§4.3 `variant_tint` 槽),不做新纹形。样张批增查:岩浆纹带橙红须与危险红互辨(变异格不是雷,色相邻近混淆风险);信息轴遮蔽呈现禁止侵入数字字形占位区(§1.4 验收 1 延伸)。←原一(纹理位次第 4,让位于数字/小人/旗);原三 ### 3.3 UI 形状语法(方向指导,细则迁 §7.1) @@ -204,18 +204,18 @@ **对比硬指标(可测;2026-09-29 v3.0 改写)**:数字可读性由**格底明度分档**承载——棋盘数字亮墨 **L≥0.55**(候选)对**已开格底 L 0.20–0.32**(候选)⇒ 直画对比 **≥4.5:1 恒成立**(WCAG AA,样张 v3 逐组合抽测冻结);**色牌后备**:色牌素色恒定 **L≥0.70**、牌上数字深墨 **L≤0.027** ⇒ 任意牌墨组合 ≥4.5:1(实测样例:#33261B/#F5EAD3 = 12.3:1)。未开格底槽(含全部图类型)相对亮度 **L≥0.30**(墙顶面受光档)、HSV 饱和 **≤0.55**、避 Boss 禁入色相带;已开格底走世界底层档(上见)。物件识别不依赖格底(§5.1 轮廓通道),旗面、金色不作识别依赖。←原二;地形变异 AC-9 -**色板增量纪律(2026-10-06 P2 对账批新增;数值状态 = **待定现用**)**:全作色板硬上限 **48 色**(现行 ≈45,余量 3——2026-10-14 迭代 26 新入 GOLD_BRIGHT/HERO_BLUE_BRIGHT/SLOT_BACKDROP_SOFT 三枚 UI 亮档/柔和档 token,均已过 §4.2 语义检查〔不占语义色段〕与 RGB 三通道差 ≥8/255 两道门;审计"色板逼近失控线"的封口条款);新色入板须同时过两道门:①§4.2 语义检查(不占语义色段/禁入带);②**与既有任一色的 RGB 三通道差 ≥8/255**——反例即审计实证:#3A2E22 ↔ #362B20 三通道差均 <5,肉眼不可辨,同板共存只增噪。不过门即触发「换色合并」(把意图色并进最近既有色),**禁加色绕行**;加色义务随批登记于本表修订。**「待定现用」态释义(2026-10-06 用户立第三态)**:数值**现行即执法**(色板检查器按此拦,§8.3)——非候选(不存在"等冻结"空窗)、非死规(后续需求引入时可变);调整走本节修订并登记,改值 = 修订不是违约。 +**色板增量纪律(2026-10-06 P2 对账批新增;数值状态 = **待定现用**)**:全作色板硬上限 **48 色**(现行 ≈45,余量 3——2026-10-14 迭代 26 新入 GOLD_BRIGHT/HERO_BLUE_BRIGHT/SLOT_BACKDROP_SOFT 三枚 UI 亮档/柔和档 token,均已过 §4.2 语义检查〔不占语义色段〕与 RGB 三通道差 ≥8/255 两道门;审计"色板逼近失控线"的封口条款);新色入板须同时过两道门:①§4.2 语义检查(不占语义色段/禁入带);②**与既有任一色的 RGB 三通道差 ≥8/255**——反例即审计实证:#3A2E22 ↔ #362B20 三通道差均 <5,肉眼不可辨,同板共存只增噪。不过门即触发「换色合并」(把意图色并进最近既有色),**禁加色绕行**;加色义务顺带登记于本表修订。**「待定现用」态释义(2026-10-06 用户立第三态)**:数值**现行即执法**(色板检查器按此拦,§8.3)——非候选(不存在"等冻结"空窗)、非死规(后续需求引入时可变);调整走本节修订并登记,改值 = 修订不是违约。 ### 4.2 语义色彩规则 > **适用域(2026-09-29 v3.0 立)**:本节「X 只说 Y」约束**信息层**(格内信息/UI 数据/预告/语义标识)与**语义物件**(金币=收益金、血条=危险红等);**纯环境氛围**(背景/装饰变体/远景/非语义物件)不受色相独占约束,改受 §3.4 焦点预算与低饱和后退约束(不抢读即可用色)。禁入带 300°–345°:信息层与语义物件禁入不变;环境层可入但限低饱和(高饱和紫赤仍 Boss 独占,§2.6)。 -- **红只说危险**:危险红=兑现档(旗朱预告档随封印紫批退役,红族单档)。禁(信息层域):红不得用于奖励、装饰性标识与常规 UI(微光群伤组除外——见「类型微光色带」条,其色相刻意错开语义红)。←原三;P2;§2.1;封印紫批 2026-09-26 -- **金只说收益与兑现**(奖励、结算、胜利)。禁(信息层与语义物件域):金不得作危险障碍色、不上格底、不作日常 UI 强调(防通胀;微光通用增益组的芥末黄属「类型微光色带」条色带,非收益语义金)。←P2;P3;§2.2–2.4 -- **蓝只说己方与冷静信息**(小人、光标、工具信息——含可挖域接触带呼吸微光,蓝族浅一档 `#D6ECFF`〔样张 v2 定稿 2026-09-28〕,2026-09-25 拍板)。禁(信息层域):蓝不得表示敌方危险;暮蓝 `#5A6C8C` 为失败独占(§2.5),只作全屏氛围,不作物件色。←P1;§2.5 -- **紫赤只说 Boss 与精英** `#8F2F6A`(色相 323°):郑重来自色相独占,不来自压暗。禁:**HSV 色相 300°–345° 为信息层与语义物件禁入带**——UI、粒子、类型微光、语义物件及图类型色板信息面不得落入;环境层(背景/装饰)可入但限低饱和,高饱和紫赤仍 Boss 独占(2026-09-29 v3.0 域限定)。←§2.6;原三 -- **绿只说自然生机**(环境植被;恢复类状态若有则用绿——待增益状态定夺)。**例外:类型微光治疗组**(见下条「类型微光色带」)。禁(信息层域):绿不得承载逻辑状态(微光色带除外),不得与红构成唯一区分对。←原三;T1 裁决 2026-09-22 -- **类型微光色带 = 格面类型先验专用逻辑色带**(未开格类型预读的色彩通道;概念定义、可见范围与生命周期见《HUD框架》「未开格类型微光」节):未开格类型微光的信息色彩按以下五组执行——**通用增益组**(attack/defense/weaken/action/gp 五族)芥末黄 `#D6C13A`(≈52°)、**治疗组**(heal)黄绿 `#5CB83A`(≈104°)、**穿刺组**(pierce)青 `#2E9E9E`(≈180°)、**魔法组**(magic)紫罗兰 `#7B5BD6`(≈256°)、**群伤组**(blast)绯红 `#FF2D55`(≈349°,刻意避开危险红色相段与 300°–345° 禁入带)——**样张 v2 定稿(2026-09-28)**,组间互辨抽检随机检报告;v2 呈现参数=内缘带状泛光 α170/带宽 cell÷8(亮度不压格底明度档,§2 微光例外)。分域纪律:微光色相只承载类型先验,不迁移复用为物件/阵营/UI 语义色;微光 = **色相+明度双码**(2026-09-28 角嵌退役批起明度梯度承载分组（组间五色相、组内不细分——通用增益组五族同色相、不再承诺组内分型；§2 微光明度例外:梯度不得压破格底明度档/三态分类);色弱玩家的类型主通道 = 微光双码（组粒度：组间五色相 + 各组一档明度互辨）。←T1 裁决 2026-09-22;角嵌退役批 2026-09-28;§4.6.3 +- **红只说危险**:危险红=兑现档(旗朱预告档随封印紫批退役,红族单档)。禁(信息层域):红禁止用于奖励、装饰性标识与常规 UI(微光群伤组除外——见「类型微光色带」条,其色相刻意错开语义红)。←原三;P2;§2.1;封印紫批 2026-09-26 +- **金只说收益与兑现**(奖励、结算、胜利)。禁(信息层与语义物件域):金禁止作危险障碍色、不上格底、不作日常 UI 强调(防通胀;微光通用增益组的芥末黄属「类型微光色带」条色带,非收益语义金)。←P2;P3;§2.2–2.4 +- **蓝只说己方与冷静信息**(小人、光标、工具信息——含可挖域接触带呼吸微光,蓝族浅一档 `#D6ECFF`〔样张 v2 定稿 2026-09-28〕,2026-09-25 拍板)。禁(信息层域):蓝禁止表示敌方危险;暮蓝 `#5A6C8C` 为失败独占(§2.5),只作全屏氛围,不作物件色。←P1;§2.5 +- **紫赤只说 Boss 与精英** `#8F2F6A`(色相 323°):郑重来自色相独占,不来自压暗。禁:**HSV 色相 300°–345° 为信息层与语义物件禁入带**——UI、粒子、类型微光、语义物件及图类型色板信息面禁止落入;环境层(背景/装饰)可入但限低饱和,高饱和紫赤仍 Boss 独占(2026-09-29 v3.0 域限定)。←§2.6;原三 +- **绿只说自然生机**(环境植被;恢复类状态若有则用绿——待增益状态定夺)。**例外:类型微光治疗组**(见下条「类型微光色带」)。禁(信息层域):绿禁止承载逻辑状态(微光色带除外),禁止与红构成唯一区分对。←原三;T1 裁决 2026-09-22 +- **类型微光色带 = 格面类型先验专用逻辑色带**(未开格类型预读的色彩通道;概念定义、可见范围与生命周期见《HUD框架》「未开格类型微光」节):未开格类型微光的信息色彩按以下五组执行——**通用增益组**(attack/defense/weaken/action/gp 五族)芥末黄 `#D6C13A`(≈52°)、**治疗组**(heal)黄绿 `#5CB83A`(≈104°)、**穿刺组**(pierce)青 `#2E9E9E`(≈180°)、**魔法组**(magic)紫罗兰 `#7B5BD6`(≈256°)、**群伤组**(blast)绯红 `#FF2D55`(≈349°,刻意避开危险红色相段与 300°–345° 禁入带)——**样张 v2 定稿(2026-09-28)**,组间互辨抽检随机检报告;v2 呈现参数=内缘带状泛光 α170/带宽 cell÷8(亮度不压格底明度档,§2 微光例外)。分域纪律:微光色相只承载类型先验,不迁移复用为物件/阵营/UI 语义色;微光 = **色相+明度双码**(2026-09-28 角嵌退役批起明度梯度承载分组（组间五色相、组内不细分——通用增益组五族同色相、不再承诺组内分型；§2 微光明度例外:梯度禁止压破格底明度档/三态分类);色弱玩家的类型主通道 = 微光双码（组粒度：组间五色相 + 各组一档明度互辨）。←T1 裁决 2026-09-22;角嵌退役批 2026-09-28;§4.6.3 - **金/红兼作极性色相槽(§4.6)**:极性(概念定义与符号矩阵见《地图战斗资源》极性提案)的视觉取色只在这两族间——有利兑付 = 金族,有害兑付 = 红族,不新增语义色。←§4.6;原二 ### 4.3 图类型色板换皮规则(board_type) @@ -243,7 +243,7 @@ 4. 奖励金 vs 危险红(色弱下皆偏褐):§3.1 道具点两类剪影 + §3.4 满圆对刺缺 + 金粒运动,无需另加 5. Boss 紫赤 vs 其他敌:§5.1 形状独占,无需另加 6. 小人蓝 vs 青墨数字:明度悬殊 + 小人轮廓与底盘,无需另加 -7. **UI 红/金强调对:纹带不管面板——需补图标+文案冗余,且破坏性确认不得与常规确认同位(位置通道)** ←原三 +7. **UI 红/金强调对:纹带不管面板——需补图标+文案冗余,且破坏性确认禁止与常规确认同位(位置通道)** ←原三 8. 失败暮蓝 vs 小人蓝:状态互斥,不承载区分,无需冗余 9. 图标键族(§4.6):图标身份全靠纹样形状通道(一键一纹样,色相不承载身份);未开格类型预读 = **类型微光单通道**(五组色带,§4.2;2026-09-28 角嵌退役批起色相+明度双码——明度档间互辨承载色弱场景);极性金/红对由框形满/缺冗余——色相全失效时图标仍可逐一辨认与定极性。←原三;增益状态×4②;T1 裁决 2026-09-22 @@ -257,7 +257,7 @@ - **身份 = 形状纹样键**:一键一纹样,全作不复用;**色相不承载身份**(七效果不七色——防色相爆炸,亦防色弱失效)。 - **极性 = 色相槽 + 框形**:有利兑付 = 金族(§4.2"金只说收益"),有害兑付 = 红族("红只说危险")——零新增语义色;框形冗余:满框对缺框(§3.4"收益用满与圆,危险用刺与缺")。极性判定的数据源 = 战斗结算 SettlementTable 效果语义(非 magnitude 符号——增益状态×4③),本契约只锁视觉通道、不锁数据映射。 -- **格面身份预读 = 类型微光;徽章 = 附属小图标**:格面的类型身份预读画在格上——类型走类型微光(§3.2/§4.2,底效泛光不入遮挡栈),不得构成格内第二焦点(§3.4);徽章小图标族用于库存条与结算明细。〔角嵌位随 2026-09-28 退役批消失〕 +- **格面身份预读 = 类型微光;徽章 = 附属小图标**:格面的类型身份预读画在格上——类型走类型微光(§3.2/§4.2,底效泛光不入遮挡栈),禁止构成格内第二焦点(§3.4);徽章小图标族用于库存条与结算明细。〔角嵌位随 2026-09-28 退役批消失〕 - **未开格预读 = 类型微光单通道**(色相+明度双码;2026-09-22 T1 裁决立双通道→2026-09-28 角嵌退役批改单通道):微光五组色带见 §4.2「类型微光色带」。只表达类型、不呈现极性、不泄雷/安(信息口径见《HUD框架》「未开格类型微光」节;约束出处见《地图战斗资源》极性提案 R3);兑付面与库存徽章可用语义族色,终稿归样张批。 #### 4.6.1 效果图标键（九行 = 增益状态现行实态，2026-09-24 纹样系统定稿；键集事实源归增益状态 GDD 与 `status_effects.tres`，本表键名随其修订自动跟随） @@ -306,7 +306,7 @@ - 库存常读条义务与兑付/库存语义见《地图战斗资源》。 - 格面预读按**家族类型**微光呈现(§4.6.3;呈现粒度决策见《地图战斗资源》极性提案 R1)。 - **2026-09-22 勘误**:修订指导底稿曾记 gp 组键名为 gp_gain/gp_loss,以 `reward.tres` 实际键 **gp_coin/gp_lose** 为准(配置是事实源)。 -- **资产契约(2026-10-06 P1-2 批——审计「19 枚格面徽章 0 张」缺口收口;状态图标 §4.6.1 模式复刻「键→文件名→尺寸」;尺寸候选,样张批冻结)**:19 枚 = `ui/icons/reward_.png`(键 = 本表 reward_id,正向/负向/清图槽同模式),源 40×40、显示 20px(格面小记号级)/40px(明细面)双档候选;极性视觉按本表「极性视觉」列(金族满框/红族缺框 = 形状+色彩双通道纪律)。**契约立前此族 0 张为已知缺口**(审计 P1-2),程序化占位在役;出图工单归 art-assets-checklist/PRD,交付后 art-status-checklist 随批 ✅。 +- **资产契约(2026-10-06 P1-2 批——审计「19 枚格面徽章 0 张」缺口完成;状态图标 §4.6.1 模式复刻「键→文件名→尺寸」;尺寸候选,样张批冻结)**:19 枚 = `ui/icons/reward_.png`(键 = 本表 reward_id,正向/负向/清图槽同模式),源 40×40、显示 20px(格面小记号级)/40px(明细面)双档候选;极性视觉按本表「极性视觉」列(金族满框/红族缺框 = 形状+色彩双通道纪律)。**契约立前此族 0 张为已知缺口**(审计 P1-2),程序化占位在役;出图工单归 art-assets-checklist/PRD,交付后 art-status-checklist 顺带 ✅。 #### 4.6.3 格面类型图标键(九类——地图战斗资源现行实态;键契约冻结,终稿归样张批) @@ -325,7 +325,7 @@ - **呈现约束(2026-09-28 角嵌退役批更新)**:未开格呈现**类型微光单通道**(五组色带,§4.2「类型微光色带」,色相+明度双码;样张 v2 定稿 2026-09-28;可见范围与时机见《HUD框架》「未开格类型微光」节);不呈现极性、不呈现雷/安(信息口径见该权威定义节);样张批微光组间互辨抽测含明度档互辨(误读率指标出处见《地图战斗资源》极性提案)。 - **状态声明**:键集九值封闭(attack/defense/heal/blast/weaken/pierce/magic/action/gp,与 RewardTable 现行 cell_type 词表一致),扩键走本节修订。 - 与 §4.6.1 的关系:同语义域的键(attack↔attack_up 等)可共族设计,键分立、纹样须可区分(格面小记号级对槽内图标级)。 -- **资产契约(2026-10-06 P1-2 批——审计「6 类地形变异纹带 0 张」缺口收口;尺寸候选,样张批冻结)**:纹带族 = `board/band_.png`(键 = 变异类型 id,键集事实源 = [地形变异](../gdd/systems/排雷循环/地形变异.md)「变异框架与类型清单」region 六行〔荆棘丛/藤蔓缠绕/岩浆/烬覆/落石/矿尘〕+ registry `variant_pool_gate`;通配 global 型〔贫矿脉〕无格子布置域、**不在纹带族**),源 64×64 四边无缝(叠于已开格底)、显示 1× = 格边长。呈现锚 = 「变异格未开时无预告呈现(遭遇式)」——纹带是**已开变异格**的标识层(地形变异 GDD「视觉标识归表现层升级批」的素材承载),半透明叠加、不得侵入数字字形占位区(§4.1 砖心留白同理)。程序化纹带在役 = 占位(◐);出图工单归 PRD,交付后 art-status-checklist 随批 ✅。 +- **资产契约(2026-10-06 P1-2 批——审计「6 类地形变异纹带 0 张」缺口完成;尺寸候选,样张批冻结)**:纹带族 = `board/band_.png`(键 = 变异类型 id,键集事实源 = [地形变异](../gdd/systems/排雷循环/地形变异.md)「变异框架与类型清单」region 六行〔荆棘丛/藤蔓缠绕/岩浆/烬覆/落石/矿尘〕+ registry `variant_pool_gate`;通配 global 型〔贫矿脉〕无格子布置域、**不在纹带族**),源 64×64 四边无缝(叠于已开格底)、显示 1× = 格边长。呈现锚 = 「变异格未开时无预告呈现(遭遇式)」——纹带是**已开变异格**的标识层(地形变异 GDD「视觉标识归表现层升级批」的素材承载),半透明叠加、禁止侵入数字字形占位区(§4.1 砖心留白同理)。程序化纹带在役 = 占位(◐);出图工单归 PRD,交付后 art-status-checklist 顺带 ✅。 #### 4.6.4 敌种线索键(映射键 = enemy_id;键集事实源归敌人系统 GDD 与 registry/enemy 表,2026-09-22 核) @@ -337,9 +337,9 @@ | 恒定义务 | enemy_id 键映射跨 run 恒定、禁重掷;图像不报数——精确数值的明细承载见《战斗结算》 | - **敌种键集 = 八敌种**(registry enemy mvp_content,2026-09-25 核):goblin 地精(light)/ bugbear 熊地精(light;**L2 熊地精 = bugbear 复用**,第二关三行显示名熊地精系,同剪影换色板,非独立键)/ ogre_chief 食人魔酋长(light,第一关关底 Boss)/ giant_spider 巨蜘蛛(light,群行 [2,3])/ drider 蛛化卓尔精灵(ward,第二关 Boss)/ duergar 灰矮人(heavy)/ hook_horror 钩爪恐魔(light,群行)/ duergar_king 灰矮人石君王(heavy,第三关 Boss)。键数据与甲档实态见《敌人系统》与 `enemy.tres`。 -- **资产需求下限三类**(敌人系统登记,呈现归 HUD框架/战斗表现):受击反馈(可共用一组)/ 死亡表现(**灰化+碎裂退场,不得直接消失**)/ 顺位标记(敌多时可读)。 +- **资产需求下限三类**(敌人系统登记,呈现归 HUD框架/战斗表现):受击反馈(可共用一组)/ 死亡表现(**灰化+碎裂退场,禁止直接消失**)/ 顺位标记(敌多时可读)。 - Boss 表现约束:§2.6 紫赤色相独占 + §5.1 Boss 形状独占双通道;键集扩容随内容批入本表。 -- 剪影通用性:剪影不得借特定格底色成立(§5.1)——棋盘/结算/任一战斗舞台同一套。 +- 剪影通用性:剪影禁止借特定格底色成立(§5.1)——棋盘/结算/任一战斗舞台同一套。 --- @@ -357,17 +357,17 @@ ### 6.1 战斗舞台背景(B 区环境) -- **双舞台常驻下的 B 区环境**:战斗画面区(站桩立绘所在)的背景 = 明亮地窟,与 §1 风格基调同源——暖倾向、无压抑;背景整体**低对比自然后退**(§3.4 焦点预算延伸):背景不得构成完整凸形、不得抢 B 区立绘与 D 区数字的焦点,识别层级恒为 立绘 > 背景。 -- **舞台正面目标(2026-09-29 v3.0 新增——原条只有负面约束,病根 6)**:B 区 = **地窟看台**——立绘脚下地台/落影承载(世界中层),背景环境层低饱和后退、明度走世界底层档,允许光源氛围(洞顶光柱/暖光晕候选);角色不得直接贴平色底。规格与终值归整屏样张闸(§1.4)冻结。 -- **明度分层适用(2026-09-29 v3.0 改条)**:背景氛围的情绪表达仍不得以压暗/渐晕实现(§2 禁令);空间纵深与洞穴感走明度分层允许域——世界底层档、光照氛围、色相饱和与形体承载(§3.2 同款逻辑)。 +- **双舞台常驻下的 B 区环境**:战斗画面区(站桩立绘所在)的背景 = 明亮地窟,与 §1 风格基调同源——暖倾向、无压抑;背景整体**低对比自然后退**(§3.4 焦点预算延伸):背景禁止构成完整凸形、禁止抢 B 区立绘与 D 区数字的焦点,识别层级恒为 立绘 > 背景。 +- **舞台正面目标(2026-09-29 v3.0 新增——原条只有负面约束,病根 6)**:B 区 = **地窟看台**——立绘脚下地台/落影承载(世界中层),背景环境层低饱和后退、明度走世界底层档,允许光源氛围(洞顶光柱/暖光晕候选);角色禁止直接贴平色底。规格与终值归整屏样张闸(§1.4)冻结。 +- **明度分层适用(2026-09-29 v3.0 改条)**:背景氛围的情绪表达仍禁止以压暗/渐晕实现(§2 禁令);空间纵深与洞穴感走明度分层允许域——世界底层档、光照氛围、色相饱和与形体承载(§3.2 同款逻辑)。 - **图类型联动**:背景 tint 走 §4.3 `wall_ambient` 槽,随三关换挡(方向候选见 §6.3);紫赤仅 Boss 战允许短暂进入背景氛围纹样(§2.6 色相独占的舞台侧延伸,高饱和独占不变),非 Boss 战高饱和紫赤禁入。 -- **资产渠道**:✦ 插画级(演出类场景贴图,清单 §4 联动登记);战斗一屏样张(§1.4 清单 1.2)含背景出样。**资产契约(2026-10-06 P1-2 批——审计「B 区舞台背景插画 0 张」缺口收口;尺寸候选,样张批冻结)**:基准一张 = `stage/stage_bg.png`(源 1280×270,B 区全高含明细带底;三关换挡走 §4.3 `wall_ambient` tint 槽,不按板出三张——换皮成本复用棋盘同款逻辑),显示 1×;呈现约束按本节各条(低对比后退/明度世界底层档/光柱氛围保留)。程序化平色+光柱在役 = 占位(◐);插画工单归 PRD,交付后 art-status-checklist 随批 ✅。 +- **资产渠道**:✦ 插画级(演出类场景贴图,清单 §4 联动登记);战斗一屏样张(§1.4 清单 1.2)含背景出样。**资产契约(2026-10-06 P1-2 批——审计「B 区舞台背景插画 0 张」缺口完成;尺寸候选,样张批冻结)**:基准一张 = `stage/stage_bg.png`(源 1280×270,B 区全高含明细带底;三关换挡走 §4.3 `wall_ambient` tint 槽,不按板出三张——换皮成本复用棋盘同款逻辑),显示 1×;呈现约束按本节各条(低对比后退/明度世界底层档/光柱氛围保留)。程序化平色+光柱在役 = 占位(◐);插画工单归 PRD,交付后 art-status-checklist 顺带 ✅。 ### 6.2 营地场景 - **情绪与色域**:承载 §2.8——全作最暖:烛光黄 `#F6C667` × 木色 `#8A5A34`(§7.2),中等饱和,无棋盘式高对比。 - **场景构成**:营地三柜台(属性锻造/秘宝匣/奖励格图鉴)在烛光下一字排开,钥石余额常驻顶栏;柜台 = 石板圆角容器(§7.1)+ 木石材质贴图;每购得一件永久强化,对应柜台亮起一格暖光——亮起只走饱和/色相手段,不动明度(§2)。 -- **事实源边界**:柜台与钥石的系统语义(解锁条件/价格/存档写入)归元进度 GDD 与 `MetaProgression`,本节只定画法;贴图与图标资产归清单 §3.5;现行以程序化占位承载(占位收口条款见 §7.1)。 +- **事实源边界**:柜台与钥石的系统语义(解锁条件/价格/存档写入)归元进度 GDD 与 `MetaProgression`,本节只定画法;贴图与图标资产归清单 §3.5;现行以程序化占位承载(占位完成条款见 §7.1)。 ### 6.3 三关图类型色板候选(board_type 换挡方向) @@ -404,11 +404,11 @@ **半拟物:容器穿戏服,数据素面。**面板=石板圆角矩形(与地砖同圆角率,全 UI 恒定),按钮=凸圆角的"可按的砖"(按压态=下沉一档,运动手段 §2),仪式性确认(胜利等)=圆形蜡封(呼应 §2.4);数字框、准线、进度条一律直角细线、无纹理;**数字色牌 = 直角小素牌**(2026-09-29 v3.0 后备件)——宽随数字位、无纹理无装饰,仅复杂格底兜底时垫于数字正下方一层(色值 §4.1),属"须精确的信息"侧、走直角律。判据:圆角=可触摸的物件,直角=须精确的信息。与参考分界:取 ITB 的信息分层,弃其冷硬斜切 HUD;取 Moonlighter 的木石亲和,不做全拟物。 -- **极性强调冗余**(§4.5⑦):UI 红/金强调对必须补图标+文案冗余;破坏性确认与常规确认不得同位(位置通道)。 +- **极性强调冗余**(§4.5⑦):UI 红/金强调对必须补图标+文案冗余;破坏性确认与常规确认禁止同位(位置通道)。 - **圆角率单点注记(2026-10-06 UI 设计对齐批 P5 甲)**:容器/按钮圆角值收敛为全站唯一 `RADIUS_OBJECT = 5`(ui_kit 单点;与主/危按钮原 5px 同值,面板与按钮同圆角率即满足本节「全 UI 恒定圆角率」);数据框/数字牌/AP 点阵/准线/血条维持 0 直角;**例外三件保留**=标题屏底座椭圆 17/结算金印 200(圆形蜡封)/状态脉冲环 100(圆形)。收敛前实测 0/2/3/4/5/6/8/17/100/200 十档并存。 - **九宫格切片注记(2026-10-06 UI 设计对齐批 P4 乙+Q1 丙)**:panel 石皮 `PANEL_SLICE = 16`(原 8→16,与原型 .plate9 slice16 对齐;button 维持 8、仪式框维持 12——素材 panel_stone/button_stone 均 48×48 不动);`panel_skinned` 工厂内 **content margin clamp**=低于切片的分量自动抬到切片(石框纹理不吃内容;工厂单点,调用点零改)。本节原无切片条款,此为新增注记。 - **资产渠道**:♻ 九宫格面板/按钮改色过复用闸优先(清单 §0),⚙ 兜底;样式终稿随 §1.4 样张闸后定稿。 -- **占位收口条款(2026-09-29 v3.0 新增,病根 8)**:程序化占位 = **临时态**,任何屏的终稿闸 = §1.4 整屏样张过闸;占位态不得跨里程碑。 +- **占位完成条款(2026-09-29 v3.0 新增,病根 8)**:程序化占位 = **临时态**,任何屏的终稿闸 = §1.4 整屏样张过闸;占位态禁止跨里程碑。 - **实现侧边界**:样式收敛 ui_kit;ui_kit 的工程契约归《HUD框架》,本节不重述。 ### 7.2 UI 色板细则(自 §4.4 迁入) @@ -418,7 +418,7 @@ **数据素面的墨来自世界的墨**:UI 数字、进度、准线一律主墨 `#33261B` 系——棋盘与面板读同一种墨;容器穿木石材质色,数据只穿墨。**营地与棋盘**:菜单容器背景用全作最暖的烛光黄 `#F6C667` 与木色 `#8A5A34`(§2.8;场景构成 §6.2);战斗容器转中性石色,防暖色渗入棋盘分走数字对比预算——氛围色向可读色让路。UI 不新增语义色,一切强调沿用 §4.2。**暗底呈现态双色墨制**(关卡画面样张 v1 冻结 2026-09-28):暗底系(已过/未来/候选/Boss 方块、暗数据框)图标与读数一律暖白 `#F0E2C8`(WARM)、亮底(当前金 `#F0A828`)转深墨 `#181410`(INK_ROUTE)——各态对比 ≥4.5:1;已过节点暗金冻结 `GOLD_DONE #68562C`(专用呈现态值,旧 GOLD_DIM `#8C743C` 对双色墨均不达标退役出该呈现位);Boss 描边 = 紫赤 2px + 外缘 1px 深墨环(灰度冗余通道——§4.2 色相独占本色不变,§4.5 灰度可分类承载)。 - **琥珀双岗注记（2026-10-04 UI 落码批 M0）**：主操作色与收益金分轨——主按钮/候选节点/钥石徽章底用烛光黄 `#F6C667`（CANDLE，独立 token），奖励数字/钥石读数/地图「当前位置」仍独占 §4.1 奖励金 `#F0A828`。烛光黄族身兼「主操作 + 收益邻近氛围」双岗系主动取舍（原型评审 C 组留痕），非疏忽，防回改。底色三件套同步换代：BG_ROOT `#3A2E22`/BG_OVERLAY `#362B20`/新增 BG_BRIGHT `#453723`（配色总纲「提暖提亮禁近黑」）；暖米族 WARM_SOFT `#E8D5A8`/WARM_FAINT `#CDB88C`（「米色去灰」）。 -- **色板五件对齐注记（2026-10-06 UI 设计对齐批 P7 乙——demo=唯一来源）**：数据板 `PANEL_DATA #E9D9B8`/板线 `PANEL_BORDER #786E58`/状态槽底 `SLOT_BACKDROP #3E362C`/血条深底 `HP_BAR_BACK #282220`/营地头带 `CAMP_HEADER_BAND #6E4526` 五 token 取值换代向原型 v2.1 对齐（Δ≤6/255 目视不可辨；代码与文档同批双侧落文）。色板唯一来源 = ui_kit 单点不变；原型文件只读不改（artwork 红线）。 +- **色板五件对齐注记（2026-10-06 UI 设计对齐批 P7 乙——demo=唯一来源）**：数据板 `PANEL_DATA #E9D9B8`/板线 `PANEL_BORDER #786E58`/状态槽底 `SLOT_BACKDROP #3E362C`/血条深底 `HP_BAR_BACK #282220`/营地头带 `CAMP_HEADER_BAND #6E4526` 五 token 取值换代向原型 v2.1 对齐（Δ≤6/255 目视不可辨；代码与文档同批双侧写入文档）。色板唯一来源 = ui_kit 单点不变；原型文件只读不改（artwork 红线）。 ### 7.3 布局栅格 @@ -435,11 +435,11 @@ ### 7.5 营地界面 -- 三柜台界面画法 = §6.2 场景构成 + §7.2 最暖色域;柜台货架件 = 永久强化条目图标 + 价格(图标归清单 §3.5);钥石余额常驻顶栏(呈现位与系统语义边界见 §6.2);界面视觉终稿以表现层样张过审为前置(§1.4 整屏样张闸),现行以程序化占位承载(占位收口条款见 §7.1)。 +- 三柜台界面画法 = §6.2 场景构成 + §7.2 最暖色域;柜台货架件 = 永久强化条目图标 + 价格(图标归清单 §3.5);钥石余额常驻顶栏(呈现位与系统语义边界见 §6.2);界面视觉终稿以表现层样张过审为前置(§1.4 整屏样张闸),现行以程序化占位承载(占位完成条款见 §7.1)。 -### 7.6 引擎原生控件与按钮状态规格(2026-10-14 迭代 25/26 反哺落文——原无条款,两批实现=临时权威,本批按呈报转正) +### 7.6 引擎原生控件与按钮状态规格(2026-10-14 迭代 25/26 反哺写入——原无条款,两批实现=临时权威,本批按呈报转正) -> **来源与边界**:迭代 25(UI 全局主题批)立引擎原生控件皮肤、迭代 26(UI 交互与观感批)立按钮五态矩阵与全局纹理过滤——此前 §7 无相应条款,两批实现系临时权威,用户 2026-10-14 裁「全部按呈报落文」转正为本节。**定值单点纪律(§8 头注)遵守**:本节只锁形态/尺寸档/对比度底线等规则,色值一律指路——主题色值事实源 = `game/assets/theme/README.md` 溯源表(与 ui_kit 常量双源,见本节末注),本节不复述色值。 +> **来源与边界**:迭代 25(UI 全局主题批)立引擎原生控件皮肤、迭代 26(UI 交互与观感批)立按钮五态矩阵与全局纹理过滤——此前 §7 无相应条款,两批实现系临时权威,用户 2026-10-14 裁「全部按呈报写入文档」转正为本节。**定值单点纪律(§8 头注)遵守**:本节只锁形态/尺寸档/对比度底线等规则,色值一律指路——主题色值事实源 = `game/assets/theme/README.md` 溯源表(与 ui_kit 常量双源,见本节末注),本节不复述色值。 **(一)按钮五态矩阵(迭代 26 T1;冒烟 V1/V2 35 断言在闸)** @@ -477,27 +477,27 @@ ### 8.1 分辨率档位与格边长口径 - **两档定案**:1280×800(基座)+ 1920×1080,窗口不可调;后续调整走修订。 -- **格边长口径**:按档位与板形计算——固定档位下格子量增加则格边长相应变小;现行 1280×800 基座锚点值 = 45px(10×10 板)/36px(12×12 板),扩板(13×13/14×14)换算值未定稿（1920 档已裁决全局等比缩放——迭代 9 卡⑮落码；原 06 分辨率债务条目已收口移除）;装板可行性校验规则见《HUD框架》。 +- **格边长口径**:按档位与板形计算——固定档位下格子量增加则格边长相应变小;现行 1280×800 基座锚点值 = 45px(10×10 板)/36px(12×12 板),扩板(13×13/14×14)换算值未定稿（1920 档已裁决全局等比缩放——迭代 9 卡⑮落码；原 06 分辨率债务条目已完成移除）;装板可行性校验规则见《HUD框架》。 ### 8.2 像素基准与画布 - **缩放纪律(硬规则,2026-09-30 v3.1 起按资产两类分级——2026-09-26 用户裁「更改规则,不做个案豁免」)**: - **甲类·文本与语义件**(数字、图标、旗、砖面 tile、格面纹样):维持严格整数倍缩放硬规则——可读性与语义精确性优先,**禁非整数缩放不变**。 - - **全局纹理过滤与平滑渐变件例外(2026-10-14 迭代 26 反哺②落文)**:`project.godot` `default_texture_filter=0`(Nearest)全局——像素风 UI 皮(九宫格/主题石纹样式盒/滑轨抓子/勾选/箭头图标)翻 Nearest=意图面;**显式 LINEAR 豁免清单(有意例外,与状态图标抗锯齿例外同族先例)= vignette / gradient_base / beams 三件程序化平滑渐变件**——保平滑连续 alpha 的程序化氛围件,Q5 已裁(§7.6 三);新增平滑件须同批入册本清单,禁静默挂 LINEAR。翻转面枚举与冒烟断言(6 条)在闸。 + - **全局纹理过滤与平滑渐变件例外(2026-10-14 迭代 26 反哺②写入文档)**:`project.godot` `default_texture_filter=0`(Nearest)全局——像素风 UI 皮(九宫格/主题石纹样式盒/滑轨抓子/勾选/箭头图标)翻 Nearest=意图面;**显式 LINEAR 豁免清单(有意例外,与状态图标抗锯齿例外同族先例)= vignette / gradient_base / beams 三件程序化平滑渐变件**——保平滑连续 alpha 的程序化氛围件,Q5 已裁(§7.6 三);新增平滑件须同批入册本清单,禁静默挂 LINEAR。翻转面枚举与冒烟断言(6 条)在闸。 - **显示档登记例外(2026-10-06 UI 设计对齐批 P6 甲——64 源 0.5×,待素材批消除)**:柜台四枚 `icon_forge/workshop/atlas/keystone`(64×64 源)显示档统一 **32px = 0.5×**;状态九枚(32×32 源)mini(站桩)档 **16px = 0.5×**。两处均系「显示尺寸侧唯一可调、素材一字节禁改」红线下的人工检整数半倍档,登记为**待消除例外**——素材批出 32px 源后回归 1×。常规档显示一律 1×(状态九枚 32px、手绘十枚 20px/40px 双档、BCard 图标槽 40px=2×)。 - **乙类·角色与单位精灵**(有机形体、非文字):允许运行时非整数倍缩放(NEAREST 过滤不变),容忍轻度像素宽窄不均;判据 = 实机目检,可感不适即回整数档。乙类今后免逐案豁免(豁免蔓延断根)。 - **站桩立绘槽位=高定宽随(2026-10-04 原型审计教训落规)**:立绘/精灵槽位只定「高度的整数倍档」,宽度随源图宽高比自适应——**禁止把全部立绘塞进统一方框强拉**(纵横倍率必须恒等)。实例=UI 原型 88×92 方框把 23×48 地精源横拉 3.83×/纵拉 1.92×、26×48 熊地精 3.38×/1.92× 压扁发花,46×48 主角近方恰等比故独活——方框是按主角比例定的,窄条生物(细长本体裁掉透明边)进主角的框必变形。乙类的非整数豁免只覆盖**等比**缩放,不含纵横异倍变形。 - **1920×1080 档策略(2026-09-30 三裁决案甲落定——三案呈报见 design/qa/m3-iter9-t8-rulings-2026-09-30.md)**:全局等比(stretch=canvas_items+aspect **keep**)——16:10 设计在 16:9 窗口=等比 1.35×+左右黑边各 ~96px,构图与 1280×800 基准档完全一致(逻辑布局 1920/1280 逐键一致实测);甲类 1.35 非整数缩放例外注记:轻度宽窄不均系本档位接受代价(像素游戏 shipped 常态),实机目检可感不适→回乙案(1920 独立 2× 基准)重议;乙类同前款。 - **画布基准(2026-09-23 用户暂定值)**: - **主角人设原图 = 48×72**(1× 基准,暂定;与站姿降采样可读性验证一致); - - **主角战斗状态图(含 B 区站桩侧向)= 48×72**(同上暂定;v1.9 待决注记「主角立绘档空缺」由此收口); + - **主角战斗状态图(含 B 区站桩侧向)= 48×72**(同上暂定;v1.9 待决注记「主角立绘档空缺」由此完成); - **棋盘小人 = 32×32 二头身派生版(暂定,允许更小)**——独立资产,自人设定稿压缩派生(人物设计档 §5.4),不吞数字位、占位 ≤ 0.75× 格边长;36px 板 × 32px 源的占比摩擦(v1.9 待决注记①)沿「独立小源档」路线随格边长终值在样张批定终值; - - **站桩立绘源档 = 八敌逐键定档(2026-10-06 定档批,用户确认定档总图;原三档 48/64/96 候选与 v3.0 档位上调方向候选一并收口)**:主角 48 不变;八敌源档高 = goblin 36 / giant_spider 38 / duergar 46 / hook_horror 58 / bugbear 62 / ogre_chief 74 / drider 90 / duergar_king 94,显示一律 **×2 整数档(NEAREST)** = 72–188。定档依据 = 生物体型三约束(用户拍板:钩爪恐魔>灰矮人、灰矮人<熊地精、食人魔>熊地精——体量=物种体型,非强度线性映射,人物设计档 §5.2 随批修订);可读性实测门槛 = 源高 ≥32(24 糊/32 可读/48 清楚/64 细节完整),全阶梯 36–94 达标;派生管线 = pixel-1.png 紧裁 → 等比缩至档高 → dom_block_resize 块内众数降采样(tools/pixelize_candidates.py `STANDEE_TIER_H`,`SIZES` 降格为管线上游中间分辨率表);存在感问题(v3.0 病根 6)经方案二整屏对比(B 区 270/立绘显示上限 188)解决。 + - **站桩立绘源档 = 八敌逐键定档(2026-10-06 定档批,用户确认定档总图;原三档 48/64/96 候选与 v3.0 档位上调方向候选一并完成)**:主角 48 不变;八敌源档高 = goblin 36 / giant_spider 38 / duergar 46 / hook_horror 58 / bugbear 62 / ogre_chief 74 / drider 90 / duergar_king 94,显示一律 **×2 整数档(NEAREST)** = 72–188。定档依据 = 生物体型三约束(用户拍板:钩爪恐魔>灰矮人、灰矮人<熊地精、食人魔>熊地精——体量=物种体型,非强度线性映射,人物设计档 §5.2 顺带修订);可读性实测门槛 = 源高 ≥32(24 糊/32 可读/48 清楚/64 细节完整),全阶梯 36–94 达标;派生管线 = pixel-1.png 紧裁 → 等比缩至档高 → dom_block_resize 块内众数降采样(tools/pixelize_candidates.py `STANDEE_TIER_H`,`SIZES` 降格为管线上游中间分辨率表);存在感问题(v3.0 病根 6)经方案二整屏对比(B 区 270/立绘显示上限 188)解决。 - **站桩立绘排版 = 方案二(2026-10-06 用户拍板)**:① 区高 B 区 270(≈1/3)/C 区 530(≈2/3),**扫雷盘 438×438 原尺寸不缩、格子不变**(区高事实源 battle.md 区表;压缩由 C 区面板空档吸收);② 站桩内部重排——立绘双脚落石台上缘(弃盒内居中)、**血条+状态/名字行落底排**(立绘→血条→状态 顺序,全场血条对齐一线;血条嵌石板位、台缘线留作地面线、落影保留接地感),状态空时该行退化为名字行;③ 大体档(显示 >150px 级:drider/duergar_king)头部探出盒顶压进光柱区,血条仍落底;意图徽标悬浮头顶上方(探顶档压胸);④ 原「血条悬浮头顶+立绘盒内居中」排式退役——盒顶固定 y 与盒内居中在高盒下拉开血条-立绘空洞(2026-10-06 用户点名否决)。 ### 8.3 导出格式与命名规范 -- **归档纪律(2026-10-06 P0-1 用户口径落文)**:图片素材**不入 git 版本管理**——仓库只保留运行时引用资产(game/assets);生成链路原始产物(AI 原图/中间产物/候选版本)归档至 `archive/` 并择机上对象存储备份;主文档(圣经/GDD/清单)**禁引用 artwork/ 散文件路径**——定稿成图以 game/assets 为唯一事实源,过程稿引用一律用归档包路径或描述性出处。 +- **归档纪律(2026-10-06 P0-1 用户口径写入文档)**:图片素材**不入 git 版本管理**——仓库只保留运行时引用资产(game/assets);生成链路原始产物(AI 原图/中间产物/候选版本)归档至 `archive/` 并择机上对象存储备份;主文档(圣经/GDD/清单)**禁引用 artwork/ 散文件路径**——定稿成图以 game/assets 为唯一事实源,过程稿引用一律用归档包路径或描述性出处。 - **入包与对账检查器(2026-10-06 P2 固化挂点——本批只立挂点,实现随 PRD 工具批)**:①**色板检查器**——扫描新素材色板,报新增色/近色告警/超 §4.1 上限(48)拦截,挂素材流入包步(asset-path-map §2 第 3 步);②**路径核对器**——扫描 asset-path-map 声明的全部路径,悬空/退役未清即报,随大批与审计例行跑(2026-10-06 三处悬空即此类失守);③**standee_asset_check 硬闸升级规格**(审计 §07-2/3)——按 §8.2 逐键定档校验体量与档高(现「宽 1–75」虚设区间退役)、像素域色数 ≤32、无非整数倍缩放痕迹、描边亮度达标(亮描边明度档,§8.2 描边层级);把 v3.6「高定宽随」教训变成代码闸而非文字。 - **交付格式**:PNG 透明底;动画 = 序列帧或引擎精灵表(SpriteFrames),帧尺寸恒定、横向等宽排列(候选)。 - **命名规范(候选草案)**:`<域>_<对象键>_<状态|变体>[_<序号>].png`,全小写 snake_case;**对象键 = 数据表主键**(effect_id/reward_id/cell_type/enemy_id——图标键契约 §4.6 的文件侧延伸:资产文件名键 = 图标键,全局恒定禁运行时换图);图类型变体后缀 = board_type 键(`_dungeon`/`_underdark`/`_deep_underdark`);候选评审件与终稿分目录(`candidates/` 承载评审件)。 @@ -520,7 +520,7 @@ ## 9. 参考与反参考(References & Anti-References) -> **白话**:正面参考 = 向谁抄什么;反面参考 = 避什么。两者同等效力——方案违反反面条款时,不得以「参考了某游戏」辩护。参考图库存于 `design/art/references/`(点名池三款×2 张,与头注点名池一一对应)。 +> **白话**:正面参考 = 向谁抄什么;反面参考 = 避什么。两者同等效力——方案违反反面条款时,禁止以「参考了某游戏」辩护。参考图库存于 `design/art/references/`(点名池三款×2 张,与头注点名池一一对应)。 ### 9.1 正面参考(点名池,用户审阅选定) @@ -538,7 +538,7 @@ |---|---|---| | **Darkest Dungeon** 式压暗 | §2 情绪明暗禁令(明度分层下仍禁) | 状态与情绪只走色相/饱和/运动/元素四手段,不以变暗表达情绪(失败重开,世界无光暗记忆) | | **传统扫雷白牌/贴纸式数字承载**(2026-09-29 v3.0 新增) | §1.2 原则二(明度分档为骨) | 数字由格底明度分档承载、直画入世界;色牌仅复杂格底后备——满屏白牌=电子表格观感,非游戏画面 | -| **Enter the Gungeon** 式粒子与色相爆炸 | §3.4 焦点预算;§4.2 色相纪律 | 信息层不得被特效与杂色吞没,特效入画先过焦点预算 | +| **Enter the Gungeon** 式粒子与色相爆炸 | §3.4 焦点预算;§4.2 色相纪律 | 信息层禁止被特效与杂色吞没,特效入画先过焦点预算 | | **Hades** 式特效密度 | §2.2 兑现爽感的上限 | 爽感靠逐行因果归因,不靠满屏特效;承载元素以 §2.2 清单为界 | | **传统扫雷 1–8 八色分色** | §4.1 数字墨三档 | 八色必撞红/金/蓝/紫赤语义色段;数字只走墨族三档色温,字形为唯一数值载体 | @@ -546,46 +546,46 @@ ## 版本历史 -- **v3.14(2026-10-14)迭代 24/25/26 反哺落文批(用户裁「全部按呈报落文」——qa 收尾批)**:①**§4.1 新入三 token**(GOLD_BRIGHT #E0B860 收益金亮档 / HERO_BLUE_BRIGHT #7EBAF0 小人蓝亮档 / SLOT_BACKDROP_SOFT #806A4E 图标槽柔和档——迭代 26 反哺③语义岗登记转正,色板计数 42→45);②**§7.6 新增「引擎原生控件与按钮状态规格」节**(迭代 25 反哺①+迭代 26 反哺①④——原无条款,两批实现临时权威转正:按钮五态矩阵〔悬停 modulate 1.06/按下本族下沉/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环〕+原生控件组件规格〔滚动条 StyleBox 柄/滑轨两段可辨/气泡/输入件/预盖件/字体防御〕+氛围层平滑件与抖动派并存留样张批+主题色值双源注记〔迭代 25 反哺④〕);③**§8.2 增全局纹理过滤与平滑渐变件例外条款**(迭代 26 反哺②——Nearest 全局+三件 LINEAR 豁免清单);④连带 = §7 白话章节清单补 §7.6。色值遵守定值单点纪律指路 theme README 溯源表,零复述 +- **v3.14(2026-10-14)迭代 24/25/26 反哺写入批(用户裁「全部按呈报写入文档」——qa 收尾批)**:①**§4.1 新入三 token**(GOLD_BRIGHT #E0B860 收益金亮档 / HERO_BLUE_BRIGHT #7EBAF0 小人蓝亮档 / SLOT_BACKDROP_SOFT #806A4E 图标槽柔和档——迭代 26 反哺③语义岗登记转正,色板计数 42→45);②**§7.6 新增「引擎原生控件与按钮状态规格」节**(迭代 25 反哺①+迭代 26 反哺①④——原无条款,两批实现临时权威转正:按钮五态矩阵〔悬停 modulate 1.06/按下本族下沉/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环〕+原生控件组件规格〔滚动条 StyleBox 柄/滑轨两段可辨/气泡/输入件/预盖件/字体防御〕+氛围层平滑件与抖动派并存留样张批+主题色值双源注记〔迭代 25 反哺④〕);③**§8.2 增全局纹理过滤与平滑渐变件例外条款**(迭代 26 反哺②——Nearest 全局+三件 LINEAR 豁免清单);④连带 = §7 白话章节清单补 §7.6。色值遵守定值单点纪律指路 theme README 溯源表,零复述 - **v3.13(2026-10-10)营地柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）**：§2.8 承载元素与 §6.2 场景构成两处三柜台括注改名。零素材新增 -- **v3.12(2026-10-07)类型微光组粒度批（用户裁——道具三层重设计·地图层随批）**：§4.2 类型微光色带「组内明度梯度分型」降为「组间五色相+组内不细分」——逐型明度映射从未定义、cell÷8 泛光上五级明度物理不可读；色弱通道随迁组粒度（§2 验收2/§4.5⑨ 同批措辞同步）；gp 不拆独立色相（用户裁：攻击三类+治疗+通用=五色已达玩家记忆上限）；五组色相本身不动（样张 v2 冻结维持） +- **v3.12(2026-10-07)类型微光组粒度批（用户裁——道具三层重设计·地图层顺带）**：§4.2 类型微光色带「组内明度梯度分型」降为「组间五色相+组内不细分」——逐型明度映射从未定义、cell÷8 泛光上五级明度物理不可读；色弱通道随迁组粒度（§2 验收2/§4.5⑨ 同批措辞同步）；gp 不拆独立色相（用户裁：攻击三类+治疗+通用=五色已达玩家记忆上限）；五组色相本身不动（样张 v2 冻结维持） - **v3.11(2026-10-06)文档层三小活收尾(审计 §07 吸收对账后剩余项)**:①**§8 头注新增「定值单点纪律」**(审计 §07-1 落规——数字定值只落 §4.1 主色板 + §8.2 两张表,其余章节指路禁复述;character-design §5.5 数值指路 §8.2);②**§8.3 检查器挂点补 standee_asset_check 硬闸升级规格**(审计 §07-2/3——按 §8.2 逐键定档校验/色数 ≤32/无非整数缩放痕迹/描边亮度达标,现「宽 1–75」虚设区间退役,实现归 PRD 工具批);③连带 = art-status-checklist 状态图标行悬空路径(candidates/status-icons-2026-09-23/)按归档纪律改描述性出处;审计 §07-3 体量分区数字表建议**改判作废**(已被「生物体型+逐键定档」语义取代)。 -- **v3.10(2026-10-06)两拍板落文批(P2 收尾)**:①**§4.1 色板数值改「待定现用」态**(用户立第三态,非候选非死规——现行即执法、需求引入时走修订并登记;释义随条);②**头注新增「条款验收标注纪律」**——全文条款尾部三档标注(←机检/←目检/←方向性,用户拍板「符合工作流程」),新条款按此书写,存量口号型分章补标(06 挂账批执行);③连带 = 06「口号型条款机检化批」状态补格式已拍板注记。 -- **v3.9(2026-10-06)P2 清理项文档处置批(审计 04 节四项;零素材新增)**:①**§4.1 新增色板增量纪律**——硬上限 48 色(现行 ≈42)+新色双门(§4.2 语义检查 / 与既有色 RGB 三通道差 ≥8/255,反例 #3A2E22↔#362B20 差 <5),不过门走「换色合并」禁加色绕行;数值候选待样张批冻结。②asset-path-map.md 三处悬空/过时更正——candidates 目录注「按需创建非作废」、废路径 production/mockups/** 改 `artwork/mockups/**`(实存)、board/ 现役改 terrain_floor__ + flag_seal(旧 board_floor/wall 退役)。③P2-1 草稿整理批(3349 个)与 P2-4 口号型条款机检化批登记 06 待办(前者执行须 dry-run 先行)。④待决项 A/B/C 前批已全部收口,本批零遗留。 +- **v3.10(2026-10-06)两拍板写入文档批(P2 收尾)**:①**§4.1 色板数值改「待定现用」态**(用户立第三态,非候选非死规——现行即执法、需求引入时走修订并登记;释义随条);②**头注新增「条款验收标注纪律」**——全文条款尾部三档标注(←机检/←目检/←方向性,用户拍板「符合工作流程」),新条款按此书写,存量口号型分章补标(06 挂账批执行);③连带 = 06「口号型条款机检化批」状态补格式已拍板注记。 +- **v3.9(2026-10-06)P2 清理项文档处置批(审计 04 节四项;零素材新增)**:①**§4.1 新增色板增量纪律**——硬上限 48 色(现行 ≈42)+新色双门(§4.2 语义检查 / 与既有色 RGB 三通道差 ≥8/255,反例 #3A2E22↔#362B20 差 <5),不过门走「换色合并」禁加色绕行;数值候选待样张批冻结。②asset-path-map.md 三处悬空/过时更正——candidates 目录注「按需创建非作废」、废路径 production/mockups/** 改 `artwork/mockups/**`(实存)、board/ 现役改 terrain_floor__ + flag_seal(旧 board_floor/wall 退役)。③P2-1 草稿整理批(3349 个)与 P2-4 口号型条款机检化批登记 06 待办(前者执行须 dry-run 先行)。④待决项 A/B/C 前批已全部完成,本批零遗留。 - **v3.8(2026-10-06)零定义资产族契约批(P1-2,用户拍板「写进圣经、不另立文件」)**:零素材新增,纯契约登记——①§4.6.2 奖励徽章 19 枚资产契约(`ui/icons/reward_.png`,源 40×40,显示 20/40 双档候选);②§4.6.3 新增地形变异纹带族资产契约(`board/band_.png`,键集事实源 = 地形变异 GDD region 六行,源 64×64 无缝,已开变异格标识层);③§6.1 舞台背景插画资产契约(`stage/stage_bg.png` 基准一张 1280×270,三关换挡走 wall_ambient tint 槽不出三张)。三族照抄状态图标「键→文件名→尺寸」模式(§4.6.1 全链唯一完全合规族,审计点名可复制);程序化占位在役,出图工单归 PRD;art-status-checklist 看板随交付 ✅。 -- **v3.7(2026-10-06)立绘八敌定档批+方案二排版落文+归档纪律(P0 收口讨论批;工作流程铁律 = 讨论期只动文档,代码实装另批走 PRD→迭代)**:①**§8.2 画布基准——站桩立绘源档八敌逐键定档**(goblin 36/giant_spider 38/duergar 46/hook_horror 58/bugbear 62/ogre_chief 74/drider 90/duergar_king 94,×2 整数显示;原三档 48/64/96 候选与 v3.0 档位上调方向候选一并收口;依据 = 用户三体型约束+定档总图确认;可读性门槛源高 ≥32 实测;派生管线 = pixel-1→紧裁→dom_block_resize);②**§8.2 缩放纪律——站桩立绘排版 = 方案二**(B 区 270 ≈1/3/C 区 530 ≈2/3/扫雷盘 438 不缩;立绘底锚落台+血条状态落底排全场对齐+大体档探顶;原「血条悬浮头顶」退役——高盒空洞用户点名否决);③**§8.3 归档纪律**(P0-1 用户口径:图片不入 git/归档+对象存储/主文档禁引用 artwork 散路径);④连带 = character-design.md §5.2 体量语义修订(强度先验→生物体型)+§5.5 源档注记+钩爪恐魔宽≥高豁免登记、battle.md 区表/组件/线框/空态/修订记录随批。 +- **v3.7(2026-10-06)立绘八敌定档批+方案二排版写入文档+归档纪律(P0 完成讨论批;工作流程铁律 = 讨论期只动文档,代码实装另批走 PRD→迭代)**:①**§8.2 画布基准——站桩立绘源档八敌逐键定档**(goblin 36/giant_spider 38/duergar 46/hook_horror 58/bugbear 62/ogre_chief 74/drider 90/duergar_king 94,×2 整数显示;原三档 48/64/96 候选与 v3.0 档位上调方向候选一并完成;依据 = 用户三体型约束+定档总图确认;可读性门槛源高 ≥32 实测;派生管线 = pixel-1→紧裁→dom_block_resize);②**§8.2 缩放纪律——站桩立绘排版 = 方案二**(B 区 270 ≈1/3/C 区 530 ≈2/3/扫雷盘 438 不缩;立绘底锚落台+血条状态落底排全场对齐+大体档探顶;原「血条悬浮头顶」退役——高盒空洞用户点名否决);③**§8.3 归档纪律**(P0-1 用户口径:图片不入 git/归档+对象存储/主文档禁引用 artwork 散路径);④连带 = character-design.md §5.2 体量语义修订(强度先验→生物体型)+§5.5 源档注记+钩爪恐魔宽≥高豁免登记、battle.md 区表/组件/线框/空态/修订记录顺带。 - **v3.6(2026-10-04)站桩槽「高定宽随」条款落规(UI 重设计原型审计教训)**:§8.2 缩放纪律新增**站桩立绘槽位=高定宽随**条——槽位只定高度的整数倍档、宽度随源图宽高比自适应,禁统一方框强拉(纵横倍率恒等;实例=原型 88×92 方框把 23×48 地精横拉 3.83×/纵拉 1.92×、26×48 熊地精 3.38×/1.92× 压扁,46×48 主角近方恰等比独活;三层成因=窄条源图/方框一刀切/非整数倍 pixelated 发花);**乙类非整数豁免口径收窄注记=只覆盖等比缩放,不含纵横异倍变形**。同批原型侧修复=站槽 height:96 width:auto(48px 源 2×)+开始屏背景怪/大立绘/庆祝像/旗/图标显示尺寸整数倍对齐。文档核查=battle.md/HUD框架 均无强制方框条文(缺口是规则本身缺位,本批补) - **v3.5(2026-10-03)视野迷雾黑暗区域渲染规格批(迭代 11 第④批实施批 T1;上位裁决=《HUD框架》「视野迷雾」节 v0.13,现行事实源已定论照抄)**:新增 §6.5——菱形灯光区=曼哈顿距离 ≤LIGHT_RADIUS(基准 8,表值/常量参数化;两圈分立注=类型微光仍贴身 8 邻格不随灯光区扩;提灯 +2 插值位预留不接效果);区外未开格全黑不渲染(照抄现行事实源「全黑不渲染」,非高遮蔽档,三档信息阶梯理由在节内);区外已开格暗淡记忆态(记忆板 #3A3A3A/记忆墨 #C4C4C4 provisional,数字 ≥4.5:1,三通道可辨判据在案,色牌格退牌归板,旗印记随未开格全黑隐没);过渡边=硬边逐格二值(禁渐变晕边);结算期去饱和叠加互斥口径(记忆态为终态档);§2 光照氛围允许域自查注记在节内;§6 开篇枚举行补「棋盘视野迷雾遮蔽」一词。纯呈现层零素材新增(程序化遮罩/调制),微光语义零改动,明度值 provisional(样张/实机自检锚,代拍板白名单内) - **v3.4(2026-10-01)数字呈现三态修订(甲案深墨族方案渲染帧取证证伪后改版)**:v3.3 的「L2/L3 切深墨族直画」经 board_shot_probe 渲染帧取证证伪——underdark 系地板双峰纹理(近黑斑 p10 0.011+近白筋 p90 0.40+)上深墨直画融黑斑隐形(用户实机复测「还是看不清」实证),任何墨族直画不可救;改**三态**:dungeon 亮族直画(门 p90≥4.5/均值≥2.5)/中暗板深墨直画(门 p90≥4.5/均值≥3.0)/双峰板**色牌垫底**(素牌+深墨 12:1,v2 色牌形制复役);机检三关呈现模式断言 19/19;目视验证面=board_shot_probe 渲染帧取证入流程(机检≠看得清)。§1.4 样张闸第四验收项判读随三态口径件注记。 - **v3.3(2026-10-01)数字墨按板自适应修订(L2/L3 亮瓦融字缺陷修复,用户裁甲案「墨色按关自适应+补三关对比断言」)**:§4.1 数字墨双色制①改**按板自适应双族**——暗纹理板维持亮族三档(样张 v3 冻结原样),亮筋纹板(underdark/deep_underdark)切深墨族三档(青墨/赭墨/锈墨复役);选族判据=所选族对归一后地板 p90 亮斑 ≥4.5:1 且对均值 ≥2.0:1,落码单点 `board_view._digit_ink_mode`,机检=`terrain_tile_sets_test` 三关对比断言 21/21;缺盘平色回退默认深墨族。§4.1 其余条款(字形唯一载体/三档色温/垫牌后备)不变。 -- **v3.1(2026-09-30)越权清理批(用户指令:按域内审查修订案修改,概念定义归还 GDD 权威文档)**:①**微光口径四处改指路**——§1.2 原则三/§1.4 样张清单去「常显」、§4.2 色带条去「常显」、§4.6.3 去「全部未开格」,统一指路《HUD框架》「未开格类型微光」节(2026-09-30 收口批落位的唯一事实源,他文只许指路);②**概念越权剥离**——危险格叙事属名与换轴史、封印插旗语义(→registry「封印」条+《排雷玩法》玩家说法)、极性定义(→《地图战斗资源》极性提案)、完美排雷定义与兑付结构(→同)、敌意图预告语义与「待机即预示」(→《敌人系统》意图线索节)、奖励 weight 与兑付/库存语义(→《地图战斗资源》)、键名沿革史(empower/fortify 来源=敌方技能施放、alert 2026-09-20 八型批换装、ac_up 2026-09-16 换装——自 §4.6.1 移除留痕)、甲档 armor 数据实态(L1 全轻甲/L2 除 drider 外全轻甲/L3 duergar·duergar_king 重甲)与旧键集史({grub, ambusher} 随 DND 更名退役——自 §4.6.4 移除留痕)、「敌不占格」断言、「类型分布即先验」机制 rationale、「分布属初始化随机」归属断言(改画法口径「分布每板一次跨轮不复掷」);③**实装状态与排期注记移本历史留痕**——游戏 UiKit.HERO_BLUE 已同步 #2E6E8E→#2E86DE、UiKit.CONTACT_GLOW 同值 #D6ECFF、旧可挖域绿相 DIG_EDGE 已随接触带方案退役、死亡表现切片实装=程序化 tween(灰化罩+碎块弹飞 5 块 0.45s,挂 unit_died)、封印特效「待表现批」、§6.1 背景插画「排期归表现层升级批」、panel_stone/button_stone 接线归最近表现批、§7.2 对比度违例「修复归表现批」、§7.5「占位不空窗」注记;④**角嵌退役条改写**为现行「未开格预读通道(微光单通道)」条(退役史见 v2.12);⑤**残留矛盾清除**——§3.2 呈现基准条「装饰变体一律纹理级」旧措辞随 v3.0 物件级解禁同步;⑥§2.8 营地承载元素/§7.5 钥石呈现位改指 §6.2(事实源边界在该节);⑦**补漏五处(同批完工审计发现,同类剥离留痕)**——§4.1 危险红「机关红」更名史、§6.2 营地贴图「排期归 UI 贴图重构批」与「占位不空窗」注记、§7.4 字体「接入归表现批」注记、§8.1 扩板与 1920 档换算值「归表现层升级批成文」(改债务指路 06「分辨率档位与棋盘格边长口径」条)、§8.3 「终稿目录归表现批定」注记、§1.4 整屏样张闸「表现层落码批开工前」改屏级落码开工前、§7.1 「样式终稿归样张后表现批」改随样张闸后定稿。**零美术信息损失**:全部色值/机检断言/纹样描述/画法参数不动,样张 v2 四冻结之②③维持 -- **v3.2(2026-09-30)样张 v3 冻结批+缩放分级修订+案甲落定(迭代 9 T1/T2/T9;需求卡片已退役（git 710f9b7 出口批）)**:①§1.4 补**样张 v3 冻结记录**——机检 17/17 全绿,断言定值两件(A3b 图底分离定值 Δ≥30〔实测 38〕/A4 尺寸基线硬等冻结 立绘 46×48+小人源 32×32),F6 沿用 v3.4;**四冻结①④重冻**——①砖面形态=E 格高墙 30% 词表扩展+格底明度分档(世界底层档 L≈0.10)+装饰物件级解禁/④数字形制=亮墨三档直画+色牌后备;②色板③动画维持冻结。产物 `artwork/mockups/sample-batch-v3-final-2026-09-30.png`+机检报告【冻结】;气质终审=2026-09-29 用户验收豁免(台账 281)。②**§8.2 缩放纪律分级修订**(2026-09-26 用户裁「改规则不豁免」落文,修订窗口=v3.0 已入库):甲类文本语义件(数字/图标/旗/砖面/纹样)维持严格整数倍;乙类角色精灵允许运行时非整数倍(NEAREST 不变,判据=实机目检可感不适即回整数档);1920 档策略经三裁决**案甲落定**(全局等比 stretch keep——v3.2 当日 T9 落文,详见 §8.2)。头注「现行为」随批 v3.2。 -- **v3.0(2026-09-29)中修批(案 B,用户拍板;审视报告=git fbaadb8（已退役）,六病根+三案呈报)**:①**§2 明度恒定→明度分层**——三档明度带(信息面层/世界中层/世界底层),情绪与状态明暗禁令保留(状态区分仍只走色相/饱和/运动/元素),空间纵深/光照/形体塑造开允许域;§2.1/2.2/2.3/2.5/2.7 各状态条措辞随改,§2.7 增「明度带随深度微移」候选。②**原则二色牌降级**——「明亮为皮,色牌为骨」改「明度分档为骨」:已开格走世界底层档(候选 L 0.20–0.32),棋盘数字墨亮族直画(候选 L≥0.75,冷亮/暖白/金亮三档色温承袭密度语义),色牌仅复杂格底后备(垫牌场景用深墨族,12.3:1 实测保留);§1.4 验收 1/2/4 与判定回退口径同步,样张 v2 四冻结之①④(砖面形态之数字承载面/数字形制)**解冻待样张 v3 重冻**(②③冻结〔色板/动画〕不受影响)。③**语义色适用域限定**——§4.2 各条「X 只说 Y」约束信息层与语义物件,纯环境氛围解禁(焦点预算与低饱和后退接管防抢焦);紫赤禁入带环境层低饱和可入、高饱和独占不变;§4.3 换皮槽与不变槽口径随改。④**装饰变体物件级解禁**——专属装饰形状家族+零信息纪律不变+焦点预算约束,配额候选 3–5 种(原则三/§3.2)。⑤**§6.1 舞台正面目标**——B 区=地窟看台(地台/落影/光源氛围候选),补原条只有负面约束之缺。⑥**§1.4 整屏样张闸新增**——战斗/关卡/菜单/营地四屏,验收四项(全局文字 ≥4.5:1/明度三档带/整屏焦点预算/文字禁压纹理),闸形=方向稿目检先行→机检冻结。⑦**§7 三件**——7.1 占位收口条款(占位=临时态,终稿闸=整屏样张)/7.2 全局文字可读性硬指标/7.4 字号下限 16/14px 对齐 ux-designer PC 规范+层级手段解禁(字号档差+墨色+字重)。⑧**§8.2 档位上调方向候选**(主角 64×96/敌 64/96/128 评估,归整屏样张闸,本批不重产资产)。⑨**§9 参考表**——Moonlighter 取列增光照层次、§9.2 DD 条款改名+新增「传统扫雷白牌」反面行。⑩**§3.4 焦点双机制**(完整度+明度带)。**连带文档同步**:character-design.md(提灯点亮解禁候选)/interaction-patterns.md/level-map.md/art-assets-checklist.md/battle.md/04-美术音频方向.md 引用口径随批。**挂账(06 登记)**:样张 v3 重跑批(断言改造+新参数冻结)/ui_kit 与棋盘渲染落码批(明度分层/格底分档/亮墨/UI 对比度修复)/资产升档重产批/mockup v3 方向稿(按 v3.0 重出)。**代拍板三项 2026-09-29 当日已追认**（闸形两段式/色牌后备范围/升档只立方向）。 +- **v3.1(2026-09-30)越权清理批(用户指令:按域内审查修订案修改,概念定义归还 GDD 权威文档)**:①**微光口径四处改指路**——§1.2 原则三/§1.4 样张清单去「常显」、§4.2 色带条去「常显」、§4.6.3 去「全部未开格」,统一指路《HUD框架》「未开格类型微光」节(2026-09-30 完成批落位的唯一事实源,他文只许指路);②**概念越权剥离**——危险格叙事属名与换轴史、封印插旗语义(→registry「封印」条+《排雷玩法》玩家说法)、极性定义(→《地图战斗资源》极性提案)、完美排雷定义与兑付结构(→同)、敌意图预告语义与「待机即预示」(→《敌人系统》意图线索节)、奖励 weight 与兑付/库存语义(→《地图战斗资源》)、键名沿革史(empower/fortify 来源=敌方技能施放、alert 2026-09-20 八型批换装、ac_up 2026-09-16 换装——自 §4.6.1 移除留痕)、甲档 armor 数据实态(L1 全轻甲/L2 除 drider 外全轻甲/L3 duergar·duergar_king 重甲)与旧键集史({grub, ambusher} 随 DND 更名退役——自 §4.6.4 移除留痕)、「敌不占格」断言、「类型分布即先验」机制 rationale、「分布属初始化随机」归属断言(改画法口径「分布每板一次跨轮不复掷」);③**实装状态与排期注记移本历史留痕**——游戏 UiKit.HERO_BLUE 已同步 #2E6E8E→#2E86DE、UiKit.CONTACT_GLOW 同值 #D6ECFF、旧可挖域绿相 DIG_EDGE 已随接触带方案退役、死亡表现切片实装=程序化 tween(灰化罩+碎块弹飞 5 块 0.45s,挂 unit_died)、封印特效「待表现批」、§6.1 背景插画「排期归表现层升级批」、panel_stone/button_stone 接线归最近表现批、§7.2 对比度违例「修复归表现批」、§7.5「占位不空窗」注记;④**角嵌退役条改写**为现行「未开格预读通道(微光单通道)」条(退役史见 v2.12);⑤**残留矛盾清除**——§3.2 呈现基准条「装饰变体一律纹理级」旧措辞随 v3.0 物件级解禁同步;⑥§2.8 营地承载元素/§7.5 钥石呈现位改指 §6.2(事实源边界在该节);⑦**补漏五处(同批完工审计发现,同类剥离留痕)**——§4.1 危险红「机关红」更名史、§6.2 营地贴图「排期归 UI 贴图重构批」与「占位不空窗」注记、§7.4 字体「接入归表现批」注记、§8.1 扩板与 1920 档换算值「归表现层升级批成文」(改债务指路 06「分辨率档位与棋盘格边长口径」条)、§8.3 「终稿目录归表现批定」注记、§1.4 整屏样张闸「表现层落码批开工前」改屏级落码开工前、§7.1 「样式终稿归样张后表现批」改随样张闸后定稿。**零美术信息损失**:全部色值/机检断言/纹样描述/画法参数不动,样张 v2 四冻结之②③维持 +- **v3.2(2026-09-30)样张 v3 冻结批+缩放分级修订+案甲落定(迭代 9 T1/T2/T9;需求卡片已退役（git 710f9b7 出口批）)**:①§1.4 补**样张 v3 冻结记录**——机检 17/17 全绿,断言定值两件(A3b 图底分离定值 Δ≥30〔实测 38〕/A4 尺寸基线硬等冻结 立绘 46×48+小人源 32×32),F6 沿用 v3.4;**四冻结①④重冻**——①砖面形态=E 格高墙 30% 词表扩展+格底明度分档(世界底层档 L≈0.10)+装饰物件级解禁/④数字形制=亮墨三档直画+色牌后备;②色板③动画维持冻结。产物 `artwork/mockups/sample-batch-v3-final-2026-09-30.png`+机检报告【冻结】;气质终审=2026-09-29 用户验收豁免(状态记录 281)。②**§8.2 缩放纪律分级修订**(2026-09-26 用户裁「改规则不豁免」写入文档,修订窗口=v3.0 已入库):甲类文本语义件(数字/图标/旗/砖面/纹样)维持严格整数倍;乙类角色精灵允许运行时非整数倍(NEAREST 不变,判据=实机目检可感不适即回整数档);1920 档策略经三裁决**案甲落定**(全局等比 stretch keep——v3.2 当日 T9 写入文档,详见 §8.2)。头注「现行为」顺带 v3.2。 +- **v3.0(2026-09-29)中修批(案 B,用户拍板;审视报告=git fbaadb8（已退役）,六病根+三案呈报)**:①**§2 明度恒定→明度分层**——三档明度带(信息面层/世界中层/世界底层),情绪与状态明暗禁令保留(状态区分仍只走色相/饱和/运动/元素),空间纵深/光照/形体塑造开允许域;§2.1/2.2/2.3/2.5/2.7 各状态条措辞随改,§2.7 增「明度带随深度微移」候选。②**原则二色牌降级**——「明亮为皮,色牌为骨」改「明度分档为骨」:已开格走世界底层档(候选 L 0.20–0.32),棋盘数字墨亮族直画(候选 L≥0.75,冷亮/暖白/金亮三档色温承袭密度语义),色牌仅复杂格底后备(垫牌场景用深墨族,12.3:1 实测保留);§1.4 验收 1/2/4 与判定回退口径同步,样张 v2 四冻结之①④(砖面形态之数字承载面/数字形制)**解冻待样张 v3 重冻**(②③冻结〔色板/动画〕不受影响)。③**语义色适用域限定**——§4.2 各条「X 只说 Y」约束信息层与语义物件,纯环境氛围解禁(焦点预算与低饱和后退接管防抢焦);紫赤禁入带环境层低饱和可入、高饱和独占不变;§4.3 换皮槽与不变槽口径随改。④**装饰变体物件级解禁**——专属装饰形状家族+零信息纪律不变+焦点预算约束,配额候选 3–5 种(原则三/§3.2)。⑤**§6.1 舞台正面目标**——B 区=地窟看台(地台/落影/光源氛围候选),补原条只有负面约束之缺。⑥**§1.4 整屏样张闸新增**——战斗/关卡/菜单/营地四屏,验收四项(全局文字 ≥4.5:1/明度三档带/整屏焦点预算/文字禁压纹理),闸形=方向稿目检先行→机检冻结。⑦**§7 三件**——7.1 占位完成条款(占位=临时态,终稿闸=整屏样张)/7.2 全局文字可读性硬指标/7.4 字号下限 16/14px 对齐 ux-designer PC 规范+层级手段解禁(字号档差+墨色+字重)。⑧**§8.2 档位上调方向候选**(主角 64×96/敌 64/96/128 评估,归整屏样张闸,本批不重产资产)。⑨**§9 参考表**——Moonlighter 取列增光照层次、§9.2 DD 条款改名+新增「传统扫雷白牌」反面行。⑩**§3.4 焦点双机制**(完整度+明度带)。**连带文档同步**:character-design.md(提灯点亮解禁候选)/interaction-patterns.md/level-map.md/art-assets-checklist.md/battle.md/04-美术音频方向.md 引用口径顺带。**挂账(06 登记)**:样张 v3 重跑批(断言改造+新参数冻结)/ui_kit 与棋盘渲染落码批(明度分层/格底分档/亮墨/UI 对比度修复)/资产升档重产批/mockup v3 方向稿(按 v3.0 重出)。**代拍板三项 2026-09-29 当日已追认**（闸形两段式/色牌后备范围/升档只立方向）。 - **v2.15(2026-09-28)人设旗脱钩批(用户拍板)**:§5.4 速览背包旗改旗朱红矩形旗+§4.1 封印黑条红族口径限定棋盘侧;封印黑仍为棋盘封印专属色不变;人设侧详见 character-design 对应版本行(v1.7) - **v2.14(2026-09-28)关卡画面样张 v1 冻结批(M-2 迭代 4 T1–T4,机检闸形 A——11/11 全绿即冻结)**:§7.2 增「暗底呈现态双色墨制」条(暗底系图标/读数=暖白 #F0E2C8、当前金底转深墨 #181410,各态 ≥4.5:1;已过节点暗金冻结 **GOLD_DONE #68562C** 专用呈现态值——旧 GOLD_DIM #8C743C 对双色墨均不达标;Boss 描边=紫赤 2px+外缘 1px 深墨环灰度冗余通道——§4.2 色相独占本色不变);冻结面=节点图标形制(♻ kenney-board-game-icons 五键 bow/award/campfire/crown_b/pouch,20px 烘焙 1:1 消费,WARM 单色,复用闸①②③④)+通道质感(折线 2/3/4px 直角肘形)+画布公式(70+层×122+34/52+槽×58+26+8 下限 620×240——routebug 83c11a1 根修件同源)+底栏样式(暗数据框 WARM/WARM_SOFT 双墨)+屏底(BG_ROOT+backdrop_stone);换层色板渐变挂点落码(§2.7 切片档——level_index→tint 表候选值随 §6.3 方向,明度带归一,终值归色板样张批)。规格承载=level-map.md(修订记录同日行);产物=`artwork/mockups/level-map-sheet-v1-2026-09-28.png`,机检报告=git 提交 9a79927;气质终审=M-2 出口闸真人目检 -- **v2.9(2026-09-26)高墙瓦片体系定稿批**(高墙批全程收官,用户拍板;台账 163/164):§3.2 新增「高墙瓦片体系」条——未挖格=一整块 32×32 自含凸起岩体(方案甲核心定义)+术语(墙瓦片/地面瓦片)+墨线边界纪律(1px 深墨线直线零锯齿,职责=分隔不融合)+单一北受光(北缘 1px 微亮棱/南缘立面窄暗条/凹角角点+立面侧 1px 齐平收头),定稿=`game/assets/art/board/terrain_*` 21 枚;§8.5 增「生产分工」条——材质归模型(AI 只出无缝填充纹理)、结构归程序(autotile 拼接约束超 2D 生图能力,实证在案)+镜像规则(只许 flip_h 禁旋转)。条口径=样张批追认(与 §8.4 方向集先例同)。词表与查表逻辑、搜包评估记录归 design/research 两档;过程文档随批清退(中间产物不入库先例,台账 127)。 -- **v2.10(2026-09-26)封印紫批**(用户拍板:插旗色 旗朱 #C63D22 → **封印紫 #7C3AA8**,色相 ≈267°):§4.1 旗朱条改写为封印紫条(候选值样张批冻结;禁入带合规+与魔法微光/妨害紫间距登记)、§4.2 红只说危险改单档(旗朱预告档退役)、§3.2 旗条/§1.4 验收 4/§4.3 不变槽/§3.2 变异互辨/§5.4 速览随批。**语义面**——封印自术语批(2026-09-25)获专属色相,红族收敛为危险红单档;攻击预告/弹道/拒绝等非封印红统一归危险红族(RED_MINE)。**连带**——character-design §5.4 背旗、battle.md 三处、关卡节点地图 Boss 描边、清单封印特效行随批;comfyui-prompts 生图卡颜色词随样张 v2 重生成。 -- **v2.11(2026-09-28)封印黑批**(用户拍板:封印色 封印紫 #7C3AA8 → **封印黑 #000000**——紫色与微光蓝族色相冲突,黑色无色相天然合规):§4.1 封印紫条改写封印黑条、§3.2 旗条/§1.4 不变槽/§4.3/§5.4 速览随批;代码 UiKit.SEAL_PURPLE→SEAL_BLACK 改名迁移+board_view/board_fx_view 换色+样张脚本同步;胜利彩带装饰紫位改亮金(紫赤系 Boss 独占不入装饰);远程生图单主角旗 purple→black 十六进制锁色重锁。历史行(v2.10 等)按文档纪律留痕不改 +- **v2.9(2026-09-26)高墙瓦片体系定稿批**(高墙批全程收官,用户拍板;状态记录 163/164):§3.2 新增「高墙瓦片体系」条——未挖格=一整块 32×32 自含凸起岩体(方案甲核心定义)+术语(墙瓦片/地面瓦片)+墨线边界纪律(1px 深墨线直线零锯齿,职责=分隔不融合)+单一北受光(北缘 1px 微亮棱/南缘立面窄暗条/凹角角点+立面侧 1px 齐平收头),定稿=`game/assets/art/board/terrain_*` 21 枚;§8.5 增「生产分工」条——材质归模型(AI 只出无缝填充纹理)、结构归程序(autotile 拼接约束超 2D 生图能力,实证在案)+镜像规则(只许 flip_h 禁旋转)。条口径=样张批追认(与 §8.4 方向集先例同)。词表与查表逻辑、搜包评估记录归 design/research 两档;过程文档顺带清退(中间产物不入库先例,状态记录 127)。 +- **v2.10(2026-09-26)封印紫批**(用户拍板:插旗色 旗朱 #C63D22 → **封印紫 #7C3AA8**,色相 ≈267°):§4.1 旗朱条改写为封印紫条(候选值样张批冻结;禁入带合规+与魔法微光/妨害紫间距登记)、§4.2 红只说危险改单档(旗朱预告档退役)、§3.2 旗条/§1.4 验收 4/§4.3 不变槽/§3.2 变异互辨/§5.4 速览顺带。**语义面**——封印自术语批(2026-09-25)获专属色相,红族收敛为危险红单档;攻击预告/弹道/拒绝等非封印红统一归危险红族(RED_MINE)。**连带**——character-design §5.4 背旗、battle.md 三处、关卡节点地图 Boss 描边、清单封印特效行顺带;comfyui-prompts 生图卡颜色词随样张 v2 重生成。 +- **v2.11(2026-09-28)封印黑批**(用户拍板:封印色 封印紫 #7C3AA8 → **封印黑 #000000**——紫色与微光蓝族色相冲突,黑色无色相天然合规):§4.1 封印紫条改写封印黑条、§3.2 旗条/§1.4 不变槽/§4.3/§5.4 速览顺带;代码 UiKit.SEAL_PURPLE→SEAL_BLACK 改名迁移+board_view/board_fx_view 换色+样张脚本同步;胜利彩带装饰紫位改亮金(紫赤系 Boss 独占不入装饰);远程生图单主角旗 purple→black 十六进制锁色重锁。历史行(v2.10 等)按文档纪律留痕不改 - **v2.12(2026-09-28)角嵌退役批**(用户裁「微光的展示只有微光,不要加额外的箭头或者加号在格子里面」——样张 v1 否决原因之一):未开格类型角嵌纹样**彻底退役**——类型预读改类型微光单通道(色相+明度双码),§2 微光明度恒定开例外(明度梯度承载类型,梯度不压格底明度档/三态分类),色弱类型主通道=微光双码;§1.2 优先级栈/§1.4 样张清单与验收 2/§3.2 角嵌条(标退役)/§3.4/§4.2 色带条/§4.5⑨/§4.6.3 呈现约束同步;已开格物件纹样(角嵌于砖缘画法动词)不在退役面;机检新增「微光格零墨色附加像素」断言;角嵌误读率指标转微光误读率 | -- **v2.13(2026-09-28)样张 v2 冻结批(M-1 迭代 2 T1,机检闸形 A——全过即冻结)**:§1.4 增样张 v2 记录(机检 16/16:现行 13 条+A3 上调 Δ≥55/F6 顶面立面双明度带 Δ≥18/F7 悬崖 DEPTH_PX 同源/A6 观感密度梯度 ≥4.70=v1 实测 4.09×1.15——v1 四否决原因断言化收官);**四冻结落文**——①砖面形态:§3.2 高墙瓦片体系条增「D 投影档+整板悬崖」定稿参数(口沿高光 2px Color8(196,172,132)/立面双段暗带 0.16+0.25 格边 α0.60·0.82/地面投影 0.22 格边三段渐隐 α0.28/悬崖 DEPTH_PX 8px board_world 同款);②色板:§4.1 小人蓝候选→定稿 #2E86DE(UiKit 同步)+§4.2 接触带微光色值 #D6ECFF 定稿+类型微光五组候选→定稿(v2 呈现 α170/带宽 cell÷8);③动画方案:§8.4 帧数规格候选档→冻结(待机 4/攻击 6/受击 2/死亡=灰化+程序化碎块弹飞 5 块 0.45s,序列帧归缺料清单);④数字形制:色牌形制定稿(#F5EAD3 直角小牌+Fusion Pixel+字号 max(18,ceil(格边×0.5))+墨三档)。产物命名带 v2(v1 被覆盖欠账清偿),报告迁 `design/research/`;连带=图例旗色封印黑漏网修正(#C63D22→#000000) | -- **v2.8(2026-09-25)可挖域接触带微光定稿批**(用户两拍板:①画法=接触带·空间侧——光画英雄格周界,正交邻墙=整边、斜向邻墙=角点+两半边;②色相=蓝族浅一档,顺路清偿旧 DIG_EDGE 绿相违 §4.2 绿禁则):§3.2 新增「可挖域接触带微光」条(画法/光只住空间一侧/角点不逐格归因、指认=悬停金框/呼吸与减动效守 §2.1/实现切换归表现批);§2.1 承载元素、§4.2 蓝条随批;battle.md 注记随批。背景=用户世界观口径「未开格=墙、已开格=挖出的空间」,微光=空间的灯光边界。 -- **v2.7(2026-09-25)封印术语批**(用户拍板:Node2D 实现后「插旗」动作等价为**封印**——玩家对未开格插旗即对该格巢穴实施封印,旗 = 封印印记;机制键与规则全不变):§3.2 新增「旗(封印印记)」条——呈现语义/旗朱与栈位不变/封印特效(施印瞬间+印记常显形态)待表现批/现行占位 = 旗朱「旗」字形;§2.5 失败承载元素措辞随批(插过的旗 = 封印印记)。**登记面**——registry terminology 新增「封印」词条、00-游戏概念 术语层级专名表随收;连带同步:battle.md 呈现注记、art-assets-checklist §4 演出类新增封印特效两件(施印特效+印记常显)、art-status-checklist P3 行、character-design.md §5.4 插旗条注记(主角即插旗者)。**关联面**——可挖域接触带微光方案(用户同日提出:微光画英雄格周界接触面,正交整边/斜向角点+两半边)评估可行,实现归表现批,未入本批。 -- **v2.6(2026-09-25)世界观对齐扫描批(甲档回填 + 完美排雷钩子收口 + 引用锚内联;用户三拍板)**:①**§4.6.4 敌种甲档回填数据实态**——bugbear(ward→light)/ ogre_chief(heavy→light)/ drider(heavy→ward),并注记甲档事实源 = `enemy.tres` armor_type(2026-09-18 甲重配批后 L1 全轻甲、L2 除 drider 外全轻甲、L3 duergar/duergar_king 重甲);连带修订 character-design.md §5.5(熊地精轻甲化/食人魔弃金属甲板改裸身皮条/卓尔改魔法甲符纹)与 comfyui-prompts.md v2.8(熊地精/食人魔/卓尔三卡提示词随改)——食人魔视觉重设计经用户拍板「按最新设定,裸身+魔法甲符纹」。②**§2.2 完美排雷钩子收口**——「若…落实…待 GDD 定夺」改现行事实(零误标且至少标中一面旗→追加第二份清图兑付+结算高光行,地图战斗资源 GDD 已定稿)。③**引用锚内联**——§3/§4 尾注 P1–P4 支柱语义内联(概念期 brainstorm 编号,现行 GDD 树不单列),§1.4 两处 game-concept 编号引用改语义内联。扫描背景=用户发起的圣经×关卡/世界观对齐审计;变异六类型/格面九类/状态九键/奖励 19 键/敌种八键/三柜台钥石/三关色板方向经核对全部一致,零其余不符。 +- **v2.13(2026-09-28)样张 v2 冻结批(M-1 迭代 2 T1,机检闸形 A——全过即冻结)**:§1.4 增样张 v2 记录(机检 16/16:现行 13 条+A3 上调 Δ≥55/F6 顶面立面双明度带 Δ≥18/F7 悬崖 DEPTH_PX 同源/A6 观感密度梯度 ≥4.70=v1 实测 4.09×1.15——v1 四否决原因断言化收官);**四冻结写入文档**——①砖面形态:§3.2 高墙瓦片体系条增「D 投影档+整板悬崖」定稿参数(口沿高光 2px Color8(196,172,132)/立面双段暗带 0.16+0.25 格边 α0.60·0.82/地面投影 0.22 格边三段渐隐 α0.28/悬崖 DEPTH_PX 8px board_world 同款);②色板:§4.1 小人蓝候选→定稿 #2E86DE(UiKit 同步)+§4.2 接触带微光色值 #D6ECFF 定稿+类型微光五组候选→定稿(v2 呈现 α170/带宽 cell÷8);③动画方案:§8.4 帧数规格候选档→冻结(待机 4/攻击 6/受击 2/死亡=灰化+程序化碎块弹飞 5 块 0.45s,序列帧归缺料清单);④数字形制:色牌形制定稿(#F5EAD3 直角小牌+Fusion Pixel+字号 max(18,ceil(格边×0.5))+墨三档)。产物命名带 v2(v1 被覆盖欠账清偿),报告迁 `design/research/`;连带=图例旗色封印黑漏网修正(#C63D22→#000000) | +- **v2.8(2026-09-25)可挖域接触带微光定稿批**(用户两拍板:①画法=接触带·空间侧——光画英雄格周界,正交邻墙=整边、斜向邻墙=角点+两半边;②色相=蓝族浅一档,顺路清偿旧 DIG_EDGE 绿相违 §4.2 绿禁则):§3.2 新增「可挖域接触带微光」条(画法/光只住空间一侧/角点不逐格归因、指认=悬停金框/呼吸与减动效守 §2.1/实现切换归表现批);§2.1 承载元素、§4.2 蓝条顺带;battle.md 注记顺带。背景=用户世界观口径「未开格=墙、已开格=挖出的空间」,微光=空间的灯光边界。 +- **v2.7(2026-09-25)封印术语批**(用户拍板:Node2D 实现后「插旗」动作等价为**封印**——玩家对未开格插旗即对该格巢穴实施封印,旗 = 封印印记;机制键与规则全不变):§3.2 新增「旗(封印印记)」条——呈现语义/旗朱与栈位不变/封印特效(施印瞬间+印记常显形态)待表现批/现行占位 = 旗朱「旗」字形;§2.5 失败承载元素措辞顺带(插过的旗 = 封印印记)。**登记面**——registry terminology 新增「封印」词条、00-游戏概念 术语层级专名表随收;连带同步:battle.md 呈现注记、art-assets-checklist §4 演出类新增封印特效两件(施印特效+印记常显)、art-status-checklist P3 行、character-design.md §5.4 插旗条注记(主角即插旗者)。**关联面**——可挖域接触带微光方案(用户同日提出:微光画英雄格周界接触面,正交整边/斜向角点+两半边)评估可行,实现归表现批,未入本批。 +- **v2.6(2026-09-25)世界观对齐扫描批(甲档回填 + 完美排雷钩子完成 + 引用锚内联;用户三拍板)**:①**§4.6.4 敌种甲档回填数据实态**——bugbear(ward→light)/ ogre_chief(heavy→light)/ drider(heavy→ward),并注记甲档事实源 = `enemy.tres` armor_type(2026-09-18 甲重配批后 L1 全轻甲、L2 除 drider 外全轻甲、L3 duergar/duergar_king 重甲);连带修订 character-design.md §5.5(熊地精轻甲化/食人魔弃金属甲板改裸身皮条/卓尔改魔法甲符纹)与 comfyui-prompts.md v2.8(熊地精/食人魔/卓尔三卡提示词随改)——食人魔视觉重设计经用户拍板「按最新设定,裸身+魔法甲符纹」。②**§2.2 完美排雷钩子完成**——「若…落实…待 GDD 定夺」改现行事实(零误标且至少标中一面旗→追加第二份清图兑付+结算高光行,地图战斗资源 GDD 已定稿)。③**引用锚内联**——§3/§4 尾注 P1–P4 支柱语义内联(概念期 brainstorm 编号,现行 GDD 树不单列),§1.4 两处 game-concept 编号引用改语义内联。扫描背景=用户发起的圣经×关卡/世界观对齐审计;变异六类型/格面九类/状态九键/奖励 19 键/敌种八键/三柜台钥石/三关色板方向经核对全部一致,零其余不符。 -- **v2.5(2026-09-25)装饰变体纹理级修订批**(地形高墙瓦片批复审发现,见 `candidates/terrain-walls-2026-09-25/0-需求规格与验收闸.md` §八;用户裁定):§1.2 原则三与 §3.2 装饰变体条——例子「苔藓/裂纹/碎屑」改「裂纹/碎石斑等纹理级氛围层」(苔藓在三个现行关卡 dungeon/underdark/灰矮人矿城设定中不存在);新增约束——装饰变体一律为纹理级、禁物件级(巨石/小石堆等读作"格子里有个东西"的元素与"格子=内容舞台"冲突,会跟奖励/旗子抢读),数量保持最少(约 2 种),用途仅为破除大面积同砖平铺的重复感;随机分布/与危险格与安全格类型零相关/不得构成可读线索等既有约束不动。§3.2 雷图棋盘呈现基准连带同步——「装饰小立牌=装饰变体的立体档」改「本作不采用立体小立牌档」。§1.4 样张清单「至少两种装饰变体」与约束一致,不动。 +- **v2.5(2026-09-25)装饰变体纹理级修订批**(地形高墙瓦片批复审发现,见 `candidates/terrain-walls-2026-09-25/0-需求规格与验收闸.md` §八;用户裁定):§1.2 原则三与 §3.2 装饰变体条——例子「苔藓/裂纹/碎屑」改「裂纹/碎石斑等纹理级氛围层」(苔藓在三个现行关卡 dungeon/underdark/灰矮人矿城设定中不存在);新增约束——装饰变体一律为纹理级、禁物件级(巨石/小石堆等读作"格子里有个东西"的元素与"格子=内容舞台"冲突,会跟奖励/旗子抢读),数量保持最少(约 2 种),用途仅为破除大面积同砖平铺的重复感;随机分布/与危险格与安全格类型零相关/禁止构成可读线索等既有约束不动。§3.2 雷图棋盘呈现基准连带同步——「装饰小立牌=装饰变体的立体档」改「本作不采用立体小立牌档」。§1.4 样张清单「至少两种装饰变体」与约束一致,不动。 - **v2.4(2026-09-24)结构件完整性与参考核验纪律批**:新增 §8.5——①格面立体结构(顶面/缘件/角件/周界轮廓)必须来自素材本体绘制的结构件拼装,禁以调色/渐变/滤镜/跨格投影伪造缺失结构,样稿暴露缺件即停报「换素材/自产缺件」由用户裁决;②宣称「参考 X 游戏」前必须取得并像素级查看 X 截图证据并存档,仅凭文字/印象的断言无效;③图底分离由素材选型承载。立规动因=beast-cave 高墙批 G(渐变)/I(阴影)两稿以调色伪造结构、且参考 Necesse 未看截图,被用户两次纠偏返工。 - **v2.3(2026-09-24)棋盘小人方向集批**:§8.4 增方向集条款——4 向(下/上/侧,侧向左右镜像共用画稿)+斜向移动/挖掘按主导轴吸附最近正交向,不出 45° 斜向帧(用户拍板;镜像豁免「旗恒画右」纪律为代拟口径、样张批追认)。 - **v2.2（2026-09-24）效果图标纹样系统定稿批**：§4.6.1 九行纹样描述由用户逐键口述定稿（主体三轴白剑/白盾/白眼+右下角箭头语言绿↑红↓双绿↑，同族键共用同图）；旧语义锚文字退役。 -- **v2.1(2026-09-23)停点前移批连带同步(批内代拍板②引用,worktree stoppoint-shift-20260923,台账 142)**:§6 开篇与 §7.2 结构行「双舞台四区」改「双舞台三区(B/C/D,字母保持不重编)」、扫雷图区锚点 1036×476→1036×504——战斗屏 A 区进度条随停点前移批退役(战后返回关卡画面,节点链进度由关卡画面选路覆盖层节点态承载),28px 纵向空间归 C/D 底行;裁决权与事实源归属 battle.md/HUD框架 不变,历次版本历史行不动。 -- **v2.0(2026-09-23)UI 章迁入批 + 画布定档 + 色板方向裁定(用户对 v1.8 代拍板四项逐条表态+五缺口给口径;worktree art-ch69-amend-20260923,台账 138)**:①**§3.3/§4.4 物理迁入 §7**(用户拍板:UI 具体选择须在 UI 章定义,三/四章只留简单定义与方向指导——v1.8 代拍板①「按引用整合」据此推翻):§3.3/§4.4 降为方向指导节(各留一段+指路),细则全文迁 **§7.1 形状语法细则/§7.2 UI 色板细则**;§7 重排号 7.1–7.5(原 7.4 组件库语义并入 7.1,零内容损失);§6.2/§7.3/§7.5 与清单引用随改。②**§8.2 画布基准暂定值**(用户缺口一裁定):主角人设原图=48×72、主角战斗状态图(侧向)=48×72〔v1.9 待决注记「主角立绘档空缺」收口〕、棋盘小人=32×32 二头身独立派生资产(允许更小;36px 板占比摩擦沿「独立小源档」路线样张批定终值)、敌种立绘三档 48/64/96=普通怪(小)/精英(中)/Boss(大)对应关系经确认保留候选;旧「像素基准 32px」通用候选退役;1920 档缩放策略与帧数规格维持待裁决,登记 06-待办清单(表现与支撑/HUD框架节新条目),样张批时提醒。③**§6.3 三关色板方向**(用户裁定):underdark 幽暗地域=**冷调幽暗**(灰白蓝主调+少量紫黑点缀,紫系取紫罗兰域 ≈256° 候选、禁入带 300°–345° 不变)、deep_underdark 灰矮人矿城=**灰黑主调+矿脉金属色点缀**(金属质感族冷银/铜灰候选,奖励金亮金禁上格底 §4.2 不变)——替换 v1.8 苔绿/冷灰岩方向草案。④**§9.1 扩池候选否决**(Forager/杀戮尖塔不入池且撤登记——用户裁定美术参考意义不足;代拍板④收口)。⑤命名规范草案获确认(代拍板②收口)。清单 §0 像素行与风格宪法表指向随批。 -- **v1.9(2026-09-23)§8.2 待决注记批**(侧会话用户指令「你在这里直接把这件事给做了吧」;worktree art-s82-note-20260923,台账 137):§8.2 增两条待决注记——①**36px 板 × 32px 源摩擦**:32px 源在 45px 格 1× 占 ≈71% 合规、在 36px 格 1× 占 ≈89% 超「≤0.75 格边」红线且禁非整数缩放回退,出路二选一(棋盘小人独立更小源档如 24px 级 vs 两种板各出一版),样张批随格边长终值一并裁决,裁决前棋盘小人源图不排产;②**主角立绘档空缺**:主角 B 区站桩立绘未单独立档(现行 48/64/96px 阶梯按敌种 archetype 写),随战斗一屏样张锁「角色剪影方向/战斗空间」时一并定。头注「现行为」随批 v1.9。 -- **v1.8(2026-09-23)§6–9 四章补全批(D 框架 D1/D2/D4/D5 落地,圣经全章成文;worktree art-ch6-9-20260923,台账 136)**:**§6 环境与场景**——6.1 战斗舞台背景(明亮地窟/低对比自然后退/明度恒定适用/`wall_ambient` 联动/紫赤仅 Boss 战)、6.2 营地场景(烛光黄×木色/三柜台一字排开/亮起走饱和不动明度/系统语义归元进度 GDD)、6.3 三关图类型色板候选(dungeon 暖石棕基准档/underdark 苔绿偏灰/deep_underdark 冷灰岩,方向候选归样张批重跑 §1.4 冻结,增「与五组微光互辨」抽测)、6.4 下探过渡(渐变取下一关槽值,只动色相饱和);**§7 UI 设计**——7.1 视觉基准(§3.3/§4.4 上位法**按引用整合**,D5 框架「迁入」不物理迁移——保持形状/色彩两章完整性,物理迁移待用户另有裁决)、7.2 布局栅格(四区结构事实源归 battle.md+4px 步进档候选)、7.3 字体字号(Kenney CC0/Fusion Pixel OFL 候选+整数倍缩放+下限 18/14/13 事实源 HUD框架+禁字重区分)、7.4 组件库三类容器语义+极性冗余、7.5 营地界面;**§8 资产与技术规范**——8.1 两档定案+格边长口径(锚点 45/36px 事实源 battle.md,扩板与 1920 档换算归表现批)、8.2 像素基准 32px 候选(active.md 58 条挂账清偿入章)+整数倍缩放纪律+1920 档适配策略候选+画布档位候选、8.3 导出 PNG/SpriteFrames+命名规范候选草案(对象键=数据表主键,图标键契约的文件侧延伸)、8.4 帧数规格候选档;**§9 参考与反参考**——9.1 正面三款取/弃表+扩池候选(Forager/杀戮尖塔)仅登记不入池、9.2 反面四条绑条款(Darkest Dungeon 压暗/Gungeon 粒子色相爆炸/Hades 特效密度/传统扫雷八色),反面图证待素材生成。**同步面**——头注状态行/Sign-Off 注记/参考池行、art-assets-checklist §0 像素尺寸行与参考图行及 §6 依赖链、04-美术音频方向.md 参考指引随批。**代拍板四项待追认**——①D5「迁入」按引用整合不物理迁移;②命名规范候选草案;③栅格/画布/帧数候选值系起草非裁决;④扩池候选两款不入池仅登记。 +- **v2.1(2026-09-23)停点前移批连带同步(批内代拍板②引用,worktree stoppoint-shift-20260923,状态记录 142)**:§6 开篇与 §7.2 结构行「双舞台四区」改「双舞台三区(B/C/D,字母保持不重编)」、扫雷图区锚点 1036×476→1036×504——战斗屏 A 区进度条随停点前移批退役(战后返回关卡画面,节点链进度由关卡画面选路覆盖层节点态承载),28px 纵向空间归 C/D 底行;裁决权与事实源归属 battle.md/HUD框架 不变,历次版本历史行不动。 +- **v2.0(2026-09-23)UI 章迁入批 + 画布定档 + 色板方向裁定(用户对 v1.8 代拍板四项逐条表态+五缺口给口径;worktree art-ch69-amend-20260923,状态记录 138)**:①**§3.3/§4.4 物理迁入 §7**(用户拍板:UI 具体选择须在 UI 章定义,三/四章只留简单定义与方向指导——v1.8 代拍板①「按引用整合」据此推翻):§3.3/§4.4 降为方向指导节(各留一段+指路),细则全文迁 **§7.1 形状语法细则/§7.2 UI 色板细则**;§7 重排号 7.1–7.5(原 7.4 组件库语义并入 7.1,零内容损失);§6.2/§7.3/§7.5 与清单引用随改。②**§8.2 画布基准暂定值**(用户缺口一裁定):主角人设原图=48×72、主角战斗状态图(侧向)=48×72〔v1.9 待决注记「主角立绘档空缺」完成〕、棋盘小人=32×32 二头身独立派生资产(允许更小;36px 板占比摩擦沿「独立小源档」路线样张批定终值)、敌种立绘三档 48/64/96=普通怪(小)/精英(中)/Boss(大)对应关系经确认保留候选;旧「像素基准 32px」通用候选退役;1920 档缩放策略与帧数规格维持待裁决,登记 06-待办清单(表现与支撑/HUD框架节新条目),样张批时提醒。③**§6.3 三关色板方向**(用户裁定):underdark 幽暗地域=**冷调幽暗**(灰白蓝主调+少量紫黑点缀,紫系取紫罗兰域 ≈256° 候选、禁入带 300°–345° 不变)、deep_underdark 灰矮人矿城=**灰黑主调+矿脉金属色点缀**(金属质感族冷银/铜灰候选,奖励金亮金禁上格底 §4.2 不变)——替换 v1.8 苔绿/冷灰岩方向草案。④**§9.1 扩池候选否决**(Forager/杀戮尖塔不入池且撤登记——用户裁定美术参考意义不足;代拍板④完成)。⑤命名规范草案获确认(代拍板②完成)。清单 §0 像素行与风格宪法表指向顺带。 +- **v1.9(2026-09-23)§8.2 待决注记批**(侧会话用户指令「你在这里直接把这件事给做了吧」;worktree art-s82-note-20260923,状态记录 137):§8.2 增两条待决注记——①**36px 板 × 32px 源摩擦**:32px 源在 45px 格 1× 占 ≈71% 合规、在 36px 格 1× 占 ≈89% 超「≤0.75 格边」红线且禁非整数缩放回退,出路二选一(棋盘小人独立更小源档如 24px 级 vs 两种板各出一版),样张批随格边长终值一并裁决,裁决前棋盘小人源图不排产;②**主角立绘档空缺**:主角 B 区站桩立绘未单独立档(现行 48/64/96px 阶梯按敌种 archetype 写),随战斗一屏样张锁「角色剪影方向/战斗空间」时一并定。头注「现行为」顺带 v1.9。 +- **v1.8(2026-09-23)§6–9 四章补全批(D 框架 D1/D2/D4/D5 落地,圣经全章成文;worktree art-ch6-9-20260923,状态记录 136)**:**§6 环境与场景**——6.1 战斗舞台背景(明亮地窟/低对比自然后退/明度恒定适用/`wall_ambient` 联动/紫赤仅 Boss 战)、6.2 营地场景(烛光黄×木色/三柜台一字排开/亮起走饱和不动明度/系统语义归元进度 GDD)、6.3 三关图类型色板候选(dungeon 暖石棕基准档/underdark 苔绿偏灰/deep_underdark 冷灰岩,方向候选归样张批重跑 §1.4 冻结,增「与五组微光互辨」抽测)、6.4 下探过渡(渐变取下一关槽值,只动色相饱和);**§7 UI 设计**——7.1 视觉基准(§3.3/§4.4 上位法**按引用整合**,D5 框架「迁入」不物理迁移——保持形状/色彩两章完整性,物理迁移待用户另有裁决)、7.2 布局栅格(四区结构事实源归 battle.md+4px 步进档候选)、7.3 字体字号(Kenney CC0/Fusion Pixel OFL 候选+整数倍缩放+下限 18/14/13 事实源 HUD框架+禁字重区分)、7.4 组件库三类容器语义+极性冗余、7.5 营地界面;**§8 资产与技术规范**——8.1 两档定案+格边长口径(锚点 45/36px 事实源 battle.md,扩板与 1920 档换算归表现批)、8.2 像素基准 32px 候选(active.md 58 条挂账清偿入章)+整数倍缩放纪律+1920 档适配策略候选+画布档位候选、8.3 导出 PNG/SpriteFrames+命名规范候选草案(对象键=数据表主键,图标键契约的文件侧延伸)、8.4 帧数规格候选档;**§9 参考与反参考**——9.1 正面三款取/弃表+扩池候选(Forager/杀戮尖塔)仅登记不入池、9.2 反面四条绑条款(Darkest Dungeon 压暗/Gungeon 粒子色相爆炸/Hades 特效密度/传统扫雷八色),反面图证待素材生成。**同步面**——头注状态行/Sign-Off 注记/参考池行、art-assets-checklist §0 像素尺寸行与参考图行及 §6 依赖链、04-美术音频方向.md 参考指引顺带。**代拍板四项待追认**——①D5「迁入」按引用整合不物理迁移;②命名规范候选草案;③栅格/画布/帧数候选值系起草非裁决;④扩池候选两款不入池仅登记。 - **v1.7(2026-09-23)§5 抽离批 + 主角特征批**(用户两拍板:①角色设计自圣经 §5 抽离成独立文档 `character-design.md`,圣经 §5 改引用存根,小节号 §5.1–§5.6 不变、既有 §5.x 引用经存根可达;②主角特征改动——背后加扫雷联动旗、直剑换挖掘铲):§3.1 迁移注改指人物设计文档;主角两特征与三态措辞修订明细归 character-design.md 版本历史 v1.0,提示词执行侧归 comfyui-prompts.md v2.1。 -- **v1.6(2026-09-22)§5 角色设计落地批(D 框架 D3)+ 提示词卡重生成**(用户拍板走正序:先补 §5 角色章,再重生成 comfyui-prompts.md;worktree art-char-s5-20260922):**新增 §5 角色设计**——§5.1 角色剪影与轮廓通道(自 §3.1 迁入:角色四类 archetype + 轮廓通道硬规则,「禁黑描边」随批固化;道具点剪影留在 §3.1 并改题「道具点剪影」);§5.2 头身比与体量档位(2~3 头身两档、体量单调递增、像素画布归 §8 另批);§5.3 护甲类型视觉区分(候选方案待样张批冻结:通道 = 甲面覆盖率×甲材质色——轻甲裸、魔法护甲符纹饰带、重甲冷灰金属甲板;天然甲壳不计甲档;灰度按覆盖率三档可辨;清偿 §4.6.4 强度档位行挂起的待设计项);§5.4 主角三态规格(形象锚站姿样张/三态约束/小人蓝同族明暗/蓝族敌方禁入);§5.5 八敌种逐卡(键集随 registry,主色域物种本色豁免语义禁则、禁入带与蓝族两例外;兄弟精换色板不换形);§5.6 意图准备动画三档规格承载(自 2026-09-18 拍板与清单 §2.3 收编)。**引用随迁**——§4.5⑤/§4.6.4 两处 §3.1 改指 §5.1,§4.6.4 强度档位行改指 §5.3;art-assets-checklist §0/§2.2 引用与待设计项表述、战斗表现 §3.1 引用两处随批。**comfyui-prompts.md 重生成 v2.0**(主角三态+八敌种逐资产自包含完整提示词——正向底座/主体/动作已拼妥、负向底座/增补已并妥,整段可直贴;继承 seed 纪律/禁入带/#F2F2F2 生成底色;主角蓝族随 v1.1 换装 #2E86DE;新增 duergar/hook_horror/duergar_king 三卡;护甲视觉短语按 §5.3 注入各卡;bugbear 主体改敦实圆肩守 §5.1 普通怪宽≥高;兄弟精变体配色弃冷蓝灰改灰褐战纹,避与小人蓝同屏混淆)。§6–9(D4/D5/D1/D2)仍待后续批。 +- **v1.6(2026-09-22)§5 角色设计落地批(D 框架 D3)+ 提示词卡重生成**(用户拍板走正序:先补 §5 角色章,再重生成 comfyui-prompts.md;worktree art-char-s5-20260922):**新增 §5 角色设计**——§5.1 角色剪影与轮廓通道(自 §3.1 迁入:角色四类 archetype + 轮廓通道硬规则,「禁黑描边」顺带固化;道具点剪影留在 §3.1 并改题「道具点剪影」);§5.2 头身比与体量档位(2~3 头身两档、体量单调递增、像素画布归 §8 另批);§5.3 护甲类型视觉区分(候选方案待样张批冻结:通道 = 甲面覆盖率×甲材质色——轻甲裸、魔法护甲符纹饰带、重甲冷灰金属甲板;天然甲壳不计甲档;灰度按覆盖率三档可辨;清偿 §4.6.4 强度档位行挂起的待设计项);§5.4 主角三态规格(形象锚站姿样张/三态约束/小人蓝同族明暗/蓝族敌方禁入);§5.5 八敌种逐卡(键集随 registry,主色域物种本色豁免语义禁则、禁入带与蓝族两例外;兄弟精换色板不换形);§5.6 意图准备动画三档规格承载(自 2026-09-18 拍板与清单 §2.3 收编)。**引用随迁**——§4.5⑤/§4.6.4 两处 §3.1 改指 §5.1,§4.6.4 强度档位行改指 §5.3;art-assets-checklist §0/§2.2 引用与待设计项表述、战斗表现 §3.1 引用两处顺带。**comfyui-prompts.md 重生成 v2.0**(主角三态+八敌种逐资产自包含完整提示词——正向底座/主体/动作已拼妥、负向底座/增补已并妥,整段可直贴;继承 seed 纪律/禁入带/#F2F2F2 生成底色;主角蓝族随 v1.1 换装 #2E86DE;新增 duergar/hook_horror/duergar_king 三卡;护甲视觉短语按 §5.3 注入各卡;bugbear 主体改敦实圆肩守 §5.1 普通怪宽≥高;兄弟精变体配色弃冷蓝灰改灰褐战纹,避与小人蓝同屏混淆)。§6–9(D4/D5/D1/D2)仍待后续批。 -- **v1.5(2026-09-22)中间产物引用解挂批**(用户裁决:修订指导与审计报告系中间产物不入库,工作区未跟踪留存;worktree midprod-unref-20260922):头注 D1–D5 框架引用改内联编号映射(明细归台账 125);本历史 v1.3 条目中的修订指导路径引用自此不再可达(历史文本如实保留);art-assets-checklist 两处「交接要点存审计报告」改指路台账 125。 +- **v1.5(2026-09-22)中间产物引用解挂批**(用户裁决:修订指导与审计报告系中间产物不入库,工作区未跟踪留存;worktree midprod-unref-20260922):头注 D1–D5 框架引用改内联编号映射(明细归状态记录 125);本历史 v1.3 条目中的修订指导路径引用自此不再可达(历史文本如实保留);art-assets-checklist 两处「交接要点存审计报告」改指路状态记录 125。 - **v1.4(2026-09-22)gungeon 退场批**(用户拍板:gungeon 两张移出即可,暂不设反面案例——反面参考待素材生成后另批增补;worktree gungeon-exit-20260922):`references/gungeon_1/2.jpg` 删除;头注参考池行定稿三款×2 张,目录自此与点名池一一对应。 -- **v1.3(2026-09-22)GDD 过期账清偿批 + 类型微光裁决**(用户四拍板:①未开格类型预读采纳彩色常显微光;②分辨率档位已定案两档 1280×800+1920×1080〔清单侧承载〕;③§5–9 按 D1–D5 框架分批补全,框架登记于 `art-docs-revision-guide-2026-09-22.md` 第 6 节;④两份美术清单合并以 art-assets-checklist 为底〔清单侧承载〕;worktree art-docs-settlement-20260922):**§4.6 契约表对齐数据实态**——§4.6.1 效果键七行→九行(ac_up/alert/empower/fortify 入表,defense_up/ambush 死键清除,sapped「待实施」旧注删除);§4.6.2 奖励徽章键整表重写为九型字典正负 18 行+清图槽 clear_blast(旧可选类三键/attack_up_basic/defense_up_basic/clear_knife 清除,「群伤 40」数值删除归配置事实源;gp 组键名按 reward.tres 勘误为 gp_coin/gp_lose);§4.6.4 敌种线索键整节重写(键集 {grub,ambusher}→八敌种现行键集,意图姿态改 2026-09-18 动画三档,Rule 8/伏击池/OQ7 退役表述清除);**微光改向**——§4.6.3 呈现约束由「墨族单色」单一通道改「角嵌纹样(形状)+类型常显微光(色彩)」双通道(R3 不泄危险格与安全格约束不变),§4.2 增「类型微光色带」分域条款与五组候选色相(芥末黄/黄绿/青/紫罗兰/绯红,避 300°–345° 禁入带与既有语义色段,样张批冻结),红/绿/紫赤/金条款加微光分域例外,§4.5⑨/§3.2 角嵌纹样条/§1.2 原则一/§1.4 样张清单与验收 2·4/§3.4 同步;**过期挂点清偿**——§3.2/§4.3 变异挂点落地(六类型定稿,纹带形按轴两分:伤害轴刺缺形/信息轴遮蔽形,同轴只做色板变体;样张批增岩浆橙红与危险红/旗朱互辨、信息轴遮蔽不入色牌占位区两项检查);§2.8 营地改三柜台+钥石(「天赋树」退役);**更名**——biome/board_biome/biome_tag 正文全量更名图类型(board_type),§4.3 标题随批(键名事实源 = 棋盘生成 GDD 与 board_gen.tres);**结构收敛**——§1.3「对 brainstorm 视觉锚的修订记录」整节并入本版本历史(正文留号占位,台账 109 正文零历史纪律),头注压缩(状态行与 Sign-Off 并行),原则三与 §3.2 重复条款收敛(零信息纪律/结果清单单点成文)。gungeon 两张参考图去留待表态(T2)。 -- **v1.2(2026-09-22)雷图棋盘呈现基准批**(用户拍板:雷图要有 ITB 参考图的战棋棋盘质感,但 45° 摆正成正俯视角——「摆正视角方格」读法):§3.2 增「雷图棋盘呈现基准」条——ITB 地表质感骨架(纹理多样/起伏体块/岛缘砖缘厚度/格上装饰立牌)× 相机正上方垂直向下、格线屏轴对齐、禁等距斜视与菱形格;砖缘厚度/岛缘立体面显式划为形体塑造、不触 §2 明度恒定(该规则禁的是状态/情绪明暗表达),顶面格底仍守 §4.1 参数域;装饰立牌 = 装饰变体立体档、零信息纪律不变;头部参考池行与资产清单样张要求随批。**勘误**——v1.1 台账所记「参考池资产失配」判断有误:references/ 中 itb/moonlighter/peglin(点名池)+gungeon(未点名)四款×2 张一直在库,删除的十张系额外五款(CatQuest3/Dicey/Roundguard/Tangledeep/WonderBoy)退场,参考池本身无失配;gungeon 两张点名与否待用户表态。 +- **v1.3(2026-09-22)GDD 过期账清偿批 + 类型微光裁决**(用户四拍板:①未开格类型预读采纳彩色常显微光;②分辨率档位已定案两档 1280×800+1920×1080〔清单侧承载〕;③§5–9 按 D1–D5 框架分批补全,框架登记于 `art-docs-revision-guide-2026-09-22.md` 第 6 节;④两份美术清单合并以 art-assets-checklist 为底〔清单侧承载〕;worktree art-docs-settlement-20260922):**§4.6 契约表对齐数据实态**——§4.6.1 效果键七行→九行(ac_up/alert/empower/fortify 入表,defense_up/ambush 死键清除,sapped「待实施」旧注删除);§4.6.2 奖励徽章键整表重写为九型字典正负 18 行+清图槽 clear_blast(旧可选类三键/attack_up_basic/defense_up_basic/clear_knife 清除,「群伤 40」数值删除归配置事实源;gp 组键名按 reward.tres 勘误为 gp_coin/gp_lose);§4.6.4 敌种线索键整节重写(键集 {grub,ambusher}→八敌种现行键集,意图姿态改 2026-09-18 动画三档,Rule 8/伏击池/OQ7 退役表述清除);**微光改向**——§4.6.3 呈现约束由「墨族单色」单一通道改「角嵌纹样(形状)+类型常显微光(色彩)」双通道(R3 不泄危险格与安全格约束不变),§4.2 增「类型微光色带」分域条款与五组候选色相(芥末黄/黄绿/青/紫罗兰/绯红,避 300°–345° 禁入带与既有语义色段,样张批冻结),红/绿/紫赤/金条款加微光分域例外,§4.5⑨/§3.2 角嵌纹样条/§1.2 原则一/§1.4 样张清单与验收 2·4/§3.4 同步;**过期挂点清偿**——§3.2/§4.3 变异挂点落地(六类型定稿,纹带形按轴两分:伤害轴刺缺形/信息轴遮蔽形,同轴只做色板变体;样张批增岩浆橙红与危险红/旗朱互辨、信息轴遮蔽不入色牌占位区两项检查);§2.8 营地改三柜台+钥石(「天赋树」退役);**更名**——biome/board_biome/biome_tag 正文全量更名图类型(board_type),§4.3 标题顺带(键名事实源 = 棋盘生成 GDD 与 board_gen.tres);**结构收敛**——§1.3「对 brainstorm 视觉锚的修订记录」整节并入本版本历史(正文留号占位,状态记录 109 正文零历史纪律),头注压缩(状态行与 Sign-Off 并行),原则三与 §3.2 重复条款收敛(零信息纪律/结果清单单点成文)。gungeon 两张参考图去留待表态(T2)。 +- **v1.2(2026-09-22)雷图棋盘呈现基准批**(用户拍板:雷图要有 ITB 参考图的战棋棋盘质感,但 45° 摆正成正俯视角——「摆正视角方格」读法):§3.2 增「雷图棋盘呈现基准」条——ITB 地表质感骨架(纹理多样/起伏体块/岛缘砖缘厚度/格上装饰立牌)× 相机正上方垂直向下、格线屏轴对齐、禁等距斜视与菱形格;砖缘厚度/岛缘立体面显式划为形体塑造、不触 §2 明度恒定(该规则禁的是状态/情绪明暗表达),顶面格底仍守 §4.1 参数域;装饰立牌 = 装饰变体立体档、零信息纪律不变;头部参考池行与资产清单样张要求顺带。**勘误**——v1.1 状态记录所记「参考池资产失配」判断有误:references/ 中 itb/moonlighter/peglin(点名池)+gungeon(未点名)四款×2 张一直在库,删除的十张系额外五款(CatQuest3/Dicey/Roundguard/Tangledeep/WonderBoy)退场,参考池本身无失配;gungeon 两张点名与否待用户表态。 - **v1.1(2026-09-22)视觉自由度修订批**(用户三拍板:①原则二改数字色牌方案;②已开后表达+零信息装饰变体;③只换主角蓝微调其余):原则二更名「明亮为皮,色牌为骨」——数字可读性改由数字色牌(素色直角小牌)承载,格底压素让路条款退役、饱和上限 0.40→0.55(候选),§1.2 优先级栈/§1.4 验收 1·2·4/§3.3/§3.4/§4.1 硬指标/§4.3 同步改查牌;原则三增格子多样化——已开格按当格结果整格表达(九类型物件纹样/纯安全格裸土/危险格巢穴更凶),未开格加零信息装饰变体(随机分布、禁逐轮重掷),未开格类型预读由小徽章升级为角嵌纹样(R3 不泄危险格与安全格约束不变),§3.2/§4.5⑨/§4.6 同步;主色板——小人蓝 `#2E6E8E`→`#2E86DE`、新增数字色牌 `#F5EAD3`(均候选值,样张批冻结终值),格面类型表五类→九类对齐(pierce/magic/action/gp)。§2 氛围层与明度恒定硬规则未动;§4.6 其余键表(效果 §4.6.1/奖励 §4.6.2/敌种 §4.6.4)数据过期账未清,另批处理;执行侧 ui_kit `HERO_BLUE` 等色值同步义务已登记,归样张批冻结后的表现批。 - **v1.0**(2026-09-10 初稿;2026-09-13 增补批——徽章栈位/危险格隐喻换轴/格子样张验收成文/图标键契约冻结;2026-09-15 去雾批)。 diff --git a/design/art/art-status-checklist.md b/design/art/art-status-checklist.md index 81f2d3f6..4ccecf17 100644 --- a/design/art/art-status-checklist.md +++ b/design/art/art-status-checklist.md @@ -1,7 +1,7 @@ # 美术素材状态清单（Art Status Checklist） > **性质**：纯看板——每条素材只记三件事：**素材名 × 是否完成 × 需求文档指针**。要什么、怎么做、验收标准一概不记：需求规格归 [art-assets-checklist.md](art-assets-checklist.md)，风格/规范定义处归各 owner 文档（第三列）。 -> **更新纪律**：随批只改「状态」列；做完不删行，改 ✅。条目编号与 art-assets-checklist.md 的 P0–P3 一一对应。 +> **更新纪律**：顺带只改「状态」列；做完不删行，改 ✅。条目编号与 art-assets-checklist.md 的 P0–P3 一一对应。 > **建档**：2026-09-24，状态列为当日快照。**2026-10-06 P1-3 对账批**：按实机在役状态与圣经 v3.7 冻结记录全量复核更新（审计发现看板反超条目已对齐；对账后 = ✅ 4 / ◐ 8 / ⬜ 3，共 15 条）。 **状态图例**：⬜ 未开始 ｜ ◐ 占位在役（程序化占位，够试玩不达标） ｜ ◑ 候选已出待审 ｜ ✅ 已交付 @@ -28,7 +28,7 @@ | 格面资源徽章 19 枚 | ◐ | [art-bible](art-bible.md) §4.6 | | 关卡节点图图标组 | ◐ | [art-assets-checklist](art-assets-checklist.md) §3.2（正式 UI 设计未成文） | | 雷/旗/数字砖面全套 | ◐ | [art-bible](art-bible.md) §1.4/§3.2（前置：格子样张） | -| 增益状态效果图标 9 枚 | ✅ 已接入（2026-09-24 台账 156） | [art-bible](art-bible.md) §4.6.1（候选原稿：状态图标批 2026-09-23 远程出图，归 candidates 档——路径描述性引用，归档纪律见 art-bible §8.3） | +| 增益状态效果图标 9 枚 | ✅ 已接入（2026-09-24 状态记录 156） | [art-bible](art-bible.md) §4.6.1（候选原稿：状态图标批 2026-09-23 远程出图，归 candidates 档——路径描述性引用，归档纪律见 art-bible §8.3） | | 营地与元进度件 | ◐ | [art-bible](art-bible.md) §4.4 | | 字体（数字像素字 + 中文像素字） | ◐ | [art-bible](art-bible.md) §4.4 | diff --git a/design/art/asset-path-map.md b/design/art/asset-path-map.md index 9da59865..037fa939 100644 --- a/design/art/asset-path-map.md +++ b/design/art/asset-path-map.md @@ -1,6 +1,6 @@ # 素材路径分工约定（asset-path-map） -- 定立：2026-09-26（用户立约指令「把哪些路径、哪些位置是干什么的确定好」——台账 161） +- 定立：2026-09-26（用户立约指令「把哪些路径、哪些位置是干什么的确定好」——状态记录 161） - 效力：全仓素材批的路径判据单点；新素材批开工前对照，违例=实施缺陷 ## 1. 目录分工总表 diff --git a/design/art/character-design.md b/design/art/character-design.md index 6cbebf8b..c6eaa2d3 100644 --- a/design/art/character-design.md +++ b/design/art/character-design.md @@ -7,7 +7,7 @@ ## 5.1 角色剪影与轮廓通道(自圣经 §3.1 迁入) -硬规则:**所有角色自带轮廓通道**——亮色描边(暖白族,禁黑描边)+落影底盘,识别不依赖所在背景。敌人不占格,剪影不得借格底色成立;同一套剪影因此在棋盘、结算画面与任一战斗舞台通用,不为战斗表现未决的舞台问题付重画成本。←已锁事实;「禁黑描边」= 2026-09-20 提示词卡实践随批固化 +硬规则:**所有角色自带轮廓通道**——亮色描边(暖白族,禁黑描边)+落影底盘,识别不依赖所在背景。敌人不占格,剪影禁止借格底色成立;同一套剪影因此在棋盘、结算画面与任一战斗舞台通用,不为战斗表现未决的舞台问题付重画成本。←已锁事实;「禁黑描边」= 2026-09-20 提示词卡实践顺带固化 **主角描边例外(2026-10-06 待决项 B 用户拍板——显式例外,非漂移)**:主角四态硬描边 = **深褐 `(40,19,13)`**,不入暖白族——深描边在浅砖面格底上对比更高、主角更突出;暖白达标率 0–28% 属例外内允许(敌人仍暖白族,实测达标 27–69%,不变)。素材不随本条修改;样张批(圣经 §1.4)终审复核例外成立性,复核义务登记 06 待办。 @@ -47,7 +47,7 @@ - **三态**:① 待机 = 窄、直立、对称(§5.1 小人原型,含背包、旗与提灯记账);② 攻击 = 允许破对称,整体仍窄、不超格宽;③ 受击 = 无血红、无伤害数字(伤害数字归 HUD 层,不进精灵图)。 - **随身件 = 秘宝形象候选池(2026-09-23 用户提案登记)**:铲、旗、背包、提灯四件随身件是未来秘宝批的**形象候选池**——道具实装可借用主角身上已有的同款(彩蛋闭环:玩家在道具栏认出主角身上的物件);具体道具语义/数值归秘宝批 GDD,人设侧义务 = 四件画得出来、认得出。 - **配色修订(2026-09-23 用户拍板:弃全蓝,蓝只在明显处)**:**小人蓝 `#2E86DE` 只保留在兜帽**(披肩状态仍可辨,与棋盘小人/光标识别一致,"全作唯一蓝色"语义不变);上衣改**暖米白 `#EFE3C8`**(数字色牌同族暖纸白)、长裤改**深棕工装 `#6B4A2E`**(木色族深化)——与掩尘棋盘同域协调、靠明度差保持身份识别;皮革件木色族 `#8A5A34`;眼部用数字墨 `#33261B` 族。(色值均候选,样张批圣经 §1.4 冻结终稿)←圣经 §4.1 -- **语义约束**:蓝只说己方(圣经 §4.2)——主角是全作唯一蓝色角色,敌方与物件主色不得入蓝族;禁入带 300°–345° 对全角色生效(Boss 独占例外,§5.5)。 +- **语义约束**:蓝只说己方(圣经 §4.2)——主角是全作唯一蓝色角色,敌方与物件主色禁止入蓝族;禁入带 300°–345° 对全角色生效(Boss 独占例外,§5.5)。 - **生成顺序口径(2026-09-23 用户确认)**:先人设定稿(本档 §5.4 + 提示词卡待机态),定稿后再逐状态出图——战斗画面的**侧身面向怪物**形象属状态图,随表现层批次另行生成;状态图需侧/背身时,该卡负向提示词中的 `side view / back view` 条目按卡摘除(人设立绘卡仍保留禁侧背)。 - **棋盘小人(2026-09-23 用户拍板,原开放项定案)**:棋盘格上的主角小人 = **主角人设图压缩至二头身后的简化版像素小人**——随人设定稿派生(同款装备剪影:铲/背包/旗可辨),二头身在 §5.2 两档内;派生工艺(最近邻降采样+手修简化)归一屏样张批与脚本管线定。 @@ -83,13 +83,13 @@ ## 版本历史 -- **v1.9(2026-10-06)主角描边例外条款批(审计报告待决项 B 用户拍板)**:§5.1 新增**主角描边例外**条——主角四态硬描边 = 深褐 `(40,19,13)` 显式例外(浅砖面对比更高/主角更突出),敌人维持暖白族;系描边不一致的定性收口(不一致源自早期生成素材,按用户口径以约束条款认可为有意设计,素材不改);样张批终审复核义务登记 06 待办。 -- **v1.8(2026-10-06)体量语义修订+立绘源档定档批(P0 收口讨论批;工作流程铁律 = 只动文档,代码实装另批走 PRD→迭代)**:①**§5.2 体量档位改「生物体型通道」**——原「强度先验·普通 < 精英 < Boss 单调递增」读法退役,依据 = 用户三体型约束(钩爪恐魔>灰矮人/灰矮人<熊地精/食人魔>熊地精,小体型精英与大体型普通怪并存);强度先验读法改由意图徽标(§5.6)与甲档(§5.3)承担;②**§5.5 新增立绘源档高注记**(八敌 36–94 定档、主角 48 不变、显示 ×2 整数档;圣经 §8.2 v3.7 同批)+**钩爪恐魔「宽≥高」豁免登记**(58 高窄条束状剪影,待样张批终审)。 -- **v1.7(2026-09-28)人设旗脱钩批**(用户三拍板:①背包旗与棋盘封印色脱钩——封印色沿革〔旗朱 #C63D22→封印紫 2026-09-26→封印黑 2026-09-28〕仅作用于棋盘格封印旗,封印黑仅棋盘格,人设旗回归旗朱红 `#C63D22`;②旗形三角→矩形,以 normal/hit 定稿成图为基准;③兜帽=披肩式披于颈肩非垂背):§5.4 形象锚/背包旗条随批。 -- **v1.6(2026-09-25)甲档核对回填批**(圣经×关卡/世界观对齐扫描发现;用户拍板「按最新设定」:食人魔裸身、卓尔魔法甲符纹):§5.5 三行甲档回填 `enemy.tres` 数据实态(2026-09-18 甲重配批后未回填的过期账)——bugbear 魔法护甲→轻甲(粗陋皮条无甲板无符纹)、ogre_chief 重甲→轻甲(弃冷灰金属甲板,改甲面覆盖率≈0 的裸身皮条/骨饰)、drider 重甲→魔法护甲(加符纹饰带);§5.5 头注事实源措辞随改;提示词卡 v2.8 熊地精/食人魔/卓尔三卡随批。giant_spider/hook_horror 的几丁质天然甲壳纪律不变(不计甲档,§5.3)。同日封印术语批:§5.4 插旗条附「插旗动作呈现名 = 封印」注记(详见 art-bible v2.7)。 -- **v1.5(2026-09-23)配装修订批**(用户四拍板:①弃全蓝配色——蓝只保留在兜帽等明显处,上衣改暖米白、长裤改深棕工装,与掩尘棋盘协调;②兜帽不戴头上、取下披于肩上,露棕色短发与脸;③待机姿势改"铲插立地上、一手扶铲柄";④旗子加大到比头大、插在背包一侧,可被头部分遮挡):§5.4 形象锚/配色条/铲条/背包旗条/护目镜条随批;提示词卡 v2.6 三卡随批。线上 API 试生成渠道由用户自跑(本地 ComfyUI 通道同日停用)。 -- **v1.4(2026-09-23)肤色+定案批**(用户四拍板:①肤色**白皙**(fair skin,弃小麦色);②LoRA 触发词 `Pixel art style.` 加入——执行侧提示词卡 v2.5 全卡正向以触发词开头;③提灯腰挂定案不手持(备选撤销);④棋盘小人定案 = 主角人设图压缩至二头身的简化版像素小人,随人设派生、同款装备剪影):§5.4 形象锚/腰灯条/棋盘小人条随批。 -- **v1.3(2026-09-23)衣着细节批**(用户拍板:半指手套 + 卷裤脚皮护膝):§5.4 形象锚随批,新增衣着细节条(棕色半指手套/裤脚卷起+棕皮护膝,皮革木色族,不占剪影预算);提示词卡 v2.4 三卡随批。 -- **v1.2(2026-09-23)背包具形批 + 装备彩蛋池**(用户三拍板:①背包措辞与体量——弃"鼓胀掳获袋",改结构式帆布冒险背包(翻盖+皮扣带),宽 ≈1.5× 体宽两侧各露一点,正面参照合金弹头双主角大背包/奇诺比奥队长、反面禁特里式 3× 超宽;②头部饰品唯一化——护目镜推额前,头灯退役,灯改**小号铜色提灯挂腰间**(不点亮,备选另手持);③随身件=魔法道具形象候选池登记——铲/旗/背包/提灯四件,道具语义归魔法道具批):§5.4 形象锚/身份件条/三态①随批,新增护目镜与腰灯条、候选池条。 -- **v1.1(2026-09-23)掳获包裹批**(用户拍板:背旗改"背负大号鼓胀布包裹、旗杆插于包裹顶"——"地牢扫荡者满载而归"的角色化;包裹帆布暖卡其色+绳索捆扎):§5.4 形象锚/身份件条/三态①记账随批,旗朱三条纪律不变(破例组改按"包裹+旗"整组)。 -- **v1.0(2026-09-23)§5 抽离批 + 主角特征批**(用户两拍板:①人物设计自圣经 §5 抽离成独立文档、圣经留引用存根——人设高频改动免动圣经;②主角两特征改动——背后加扫雷联动旗帜、直剑换挖掘铲):§5.1–§5.3/§5.5/§5.6 自 art-bible v1.6 原文迁移(圣经内部节引用改注"圣经 §x"前缀,小节号不变);**§5.4 重写**——形象锚"直剑"改"圆头挖掘铲"(挖安全格动作语义角色化,攻击表现即挥铲),新增"旗朱背旗"(与棋盘插旗同物同色 `#C63D22`,主角唯一破对称件、旗面恒定画右、凹凸预算 +1),三态②"刀光"措辞改"铲击光效";新增生成顺序口径(先人设后状态图,侧背身状态卡按卡摘负向禁侧背条)与棋盘小人同旗开放项(归样张批)。执行侧 comfyui-prompts.md 主角三卡随批更新(v2.1)。 +- **v1.9(2026-10-06)主角描边例外条款批(审计报告待决项 B 用户拍板)**:§5.1 新增**主角描边例外**条——主角四态硬描边 = 深褐 `(40,19,13)` 显式例外(浅砖面对比更高/主角更突出),敌人维持暖白族;系描边不一致的定性完成(不一致源自早期生成素材,按用户口径以约束条款认可为有意设计,素材不改);样张批终审复核义务登记 06 待办。 +- **v1.8(2026-10-06)体量语义修订+立绘源档定档批(P0 完成讨论批;工作流程铁律 = 只动文档,代码实装另批走 PRD→迭代)**:①**§5.2 体量档位改「生物体型通道」**——原「强度先验·普通 < 精英 < Boss 单调递增」读法退役,依据 = 用户三体型约束(钩爪恐魔>灰矮人/灰矮人<熊地精/食人魔>熊地精,小体型精英与大体型普通怪并存);强度先验读法改由意图徽标(§5.6)与甲档(§5.3)承担;②**§5.5 新增立绘源档高注记**(八敌 36–94 定档、主角 48 不变、显示 ×2 整数档;圣经 §8.2 v3.7 同批)+**钩爪恐魔「宽≥高」豁免登记**(58 高窄条束状剪影,待样张批终审)。 +- **v1.7(2026-09-28)人设旗脱钩批**(用户三拍板:①背包旗与棋盘封印色脱钩——封印色沿革〔旗朱 #C63D22→封印紫 2026-09-26→封印黑 2026-09-28〕仅作用于棋盘格封印旗,封印黑仅棋盘格,人设旗回归旗朱红 `#C63D22`;②旗形三角→矩形,以 normal/hit 定稿成图为基准;③兜帽=披肩式披于颈肩非垂背):§5.4 形象锚/背包旗条顺带。 +- **v1.6(2026-09-25)甲档核对回填批**(圣经×关卡/世界观对齐扫描发现;用户拍板「按最新设定」:食人魔裸身、卓尔魔法甲符纹):§5.5 三行甲档回填 `enemy.tres` 数据实态(2026-09-18 甲重配批后未回填的过期账)——bugbear 魔法护甲→轻甲(粗陋皮条无甲板无符纹)、ogre_chief 重甲→轻甲(弃冷灰金属甲板,改甲面覆盖率≈0 的裸身皮条/骨饰)、drider 重甲→魔法护甲(加符纹饰带);§5.5 头注事实源措辞随改;提示词卡 v2.8 熊地精/食人魔/卓尔三卡顺带。giant_spider/hook_horror 的几丁质天然甲壳纪律不变(不计甲档,§5.3)。同日封印术语批:§5.4 插旗条附「插旗动作呈现名 = 封印」注记(详见 art-bible v2.7)。 +- **v1.5(2026-09-23)配装修订批**(用户四拍板:①弃全蓝配色——蓝只保留在兜帽等明显处,上衣改暖米白、长裤改深棕工装,与掩尘棋盘协调;②兜帽不戴头上、取下披于肩上,露棕色短发与脸;③待机姿势改"铲插立地上、一手扶铲柄";④旗子加大到比头大、插在背包一侧,可被头部分遮挡):§5.4 形象锚/配色条/铲条/背包旗条/护目镜条顺带;提示词卡 v2.6 三卡顺带。线上 API 试生成渠道由用户自跑(本地 ComfyUI 通道同日停用)。 +- **v1.4(2026-09-23)肤色+定案批**(用户四拍板:①肤色**白皙**(fair skin,弃小麦色);②LoRA 触发词 `Pixel art style.` 加入——执行侧提示词卡 v2.5 全卡正向以触发词开头;③提灯腰挂定案不手持(备选撤销);④棋盘小人定案 = 主角人设图压缩至二头身的简化版像素小人,随人设派生、同款装备剪影):§5.4 形象锚/腰灯条/棋盘小人条顺带。 +- **v1.3(2026-09-23)衣着细节批**(用户拍板:半指手套 + 卷裤脚皮护膝):§5.4 形象锚顺带,新增衣着细节条(棕色半指手套/裤脚卷起+棕皮护膝,皮革木色族,不占剪影预算);提示词卡 v2.4 三卡顺带。 +- **v1.2(2026-09-23)背包具形批 + 装备彩蛋池**(用户三拍板:①背包措辞与体量——弃"鼓胀掳获袋",改结构式帆布冒险背包(翻盖+皮扣带),宽 ≈1.5× 体宽两侧各露一点,正面参照合金弹头双主角大背包/奇诺比奥队长、反面禁特里式 3× 超宽;②头部饰品唯一化——护目镜推额前,头灯退役,灯改**小号铜色提灯挂腰间**(不点亮,备选另手持);③随身件=魔法道具形象候选池登记——铲/旗/背包/提灯四件,道具语义归魔法道具批):§5.4 形象锚/身份件条/三态①顺带,新增护目镜与腰灯条、候选池条。 +- **v1.1(2026-09-23)掳获包裹批**(用户拍板:背旗改"背负大号鼓胀布包裹、旗杆插于包裹顶"——"地牢扫荡者满载而归"的角色化;包裹帆布暖卡其色+绳索捆扎):§5.4 形象锚/身份件条/三态①记账顺带,旗朱三条纪律不变(破例组改按"包裹+旗"整组)。 +- **v1.0(2026-09-23)§5 抽离批 + 主角特征批**(用户两拍板:①人物设计自圣经 §5 抽离成独立文档、圣经留引用存根——人设高频改动免动圣经;②主角两特征改动——背后加扫雷联动旗帜、直剑换挖掘铲):§5.1–§5.3/§5.5/§5.6 自 art-bible v1.6 原文迁移(圣经内部节引用改注"圣经 §x"前缀,小节号不变);**§5.4 重写**——形象锚"直剑"改"圆头挖掘铲"(挖安全格动作语义角色化,攻击表现即挥铲),新增"旗朱背旗"(与棋盘插旗同物同色 `#C63D22`,主角唯一破对称件、旗面恒定画右、凹凸预算 +1),三态②"刀光"措辞改"铲击光效";新增生成顺序口径(先人设后状态图,侧背身状态卡按卡摘负向禁侧背条)与棋盘小人同旗开放项(归样张批)。执行侧 comfyui-prompts.md 主角三卡顺带更新(v2.1)。 diff --git a/design/art/comfyui-prompts.md b/design/art/comfyui-prompts.md index 41f8a46d..58b2bb49 100644 --- a/design/art/comfyui-prompts.md +++ b/design/art/comfyui-prompts.md @@ -299,12 +299,12 @@ Seamless tileable pixel art texture of dry dirt ground, top-down, for a dungeon - **v2.8(2026-09-25)敌种甲档回填批**(圣经×关卡/世界观对齐扫描发现,规格上游 character-design.md v1.6 同批;用户拍板「按最新设定」):三卡随 `enemy.tres` 甲档实态修订——①熊地精 3.2 两版(A/B)正向:魔法甲「暖白符纹饰带」措辞退役,改轻甲「粗陋皮条+裸蓬毛无甲板」;②食人魔酋长 3.3:标题重甲→轻甲,正向「冷灰金属肩胸甲板」改「皮条骨饰+裸厚皮无甲板」,规格注随改;③蛛化卓尔精灵 3.5:标题重甲→魔法护甲,正向加「卓尔上体暖白秘法符纹饰带」(蛛腹几丁质保留、属天然甲壳),规格注随改。duergar/duergar_king 重甲卡与数据一致不动。 -- **v2.7(2026-09-23)真像素硬化 + 本地通道清退批**(用户拍板:本地 ComfyUI 生图路线彻底关闭,生图一律线上 API 自跑;gg1 风格诊断后硬化方案随批写入):①全部 13 张正向卡触发词后插入真像素约束段——`true pixel art game sprite / tiny 48x72 pixel canvas / chunky square pixels / strict pixel grid alignment / hard edges / no anti-aliasing / no gradients / limited 16-color palette / aseprite style`;②各卡负向底座并入平滑系禁词——`smooth lines / anti-aliasing / gradient shading / painterly / glossy / high detail / vector illustration`;③§0「现行管线」句(Z-Image-Turbo GGUF + 像素 LoRA + 母版工作流 `art-t2i-master.json`,成因见 v2.1/v2.5)改写为线上 API 口径,自然语言类模型改写指引随批;④「ComfyUI 通道」措辞改「生图通道」(文件名沿用不改)。同日 repo 侧清退:`production/comfy/` 已删、comfy-mcp 注册已移除。 +- **v2.7(2026-09-23)真像素硬化 + 本地通道清退批**(用户拍板:本地 ComfyUI 生图路线彻底关闭,生图一律线上 API 自跑;gg1 风格诊断后硬化方案顺带写入):①全部 13 张正向卡触发词后插入真像素约束段——`true pixel art game sprite / tiny 48x72 pixel canvas / chunky square pixels / strict pixel grid alignment / hard edges / no anti-aliasing / no gradients / limited 16-color palette / aseprite style`;②各卡负向底座并入平滑系禁词——`smooth lines / anti-aliasing / gradient shading / painterly / glossy / high detail / vector illustration`;③§0「现行管线」句(Z-Image-Turbo GGUF + 像素 LoRA + 母版工作流 `art-t2i-master.json`,成因见 v2.1/v2.5)改写为线上 API 口径,自然语言类模型改写指引顺带;④「ComfyUI 通道」措辞改「生图通道」(文件名沿用不改)。同日 repo 侧清退:`production/comfy/` 已删、comfy-mcp 注册已移除。 - **v2.6(2026-09-23)配装修订批**(用户四拍板:①弃全蓝——蓝只在兜帽,上衣暖米白、长裤深棕工装,与掩尘棋盘协调;②兜帽取下披肩、露棕色短发;③待机姿势改"铲插地+扶柄";④旗加大到比头大、插背包一侧、可被头部分遮挡):主角三卡正向提示词整体重写(形象锚措辞随改,2.2"斗篷飘动"改"兜帽布料飘动");线上 API 试生成由用户自跑,规格上游 character-design.md 同批升 v1.5。 - **v2.5(2026-09-23)触发词+肤色批**(用户三拍板:①LoRA 触发词 `Pixel art style.` **加入**——全部正向提示词(主角三卡+八敌种各卡)一律以触发词开头;②肤色改**白皙**(fair skin,弃小麦色),主角三卡随改;③提灯腰挂定案、棋盘小人定案归 character-design.md 同批 v1.4):§0 模型适配注由"待拍板"改"已加入";版本历史承接 v2.4。 -- **v2.4(2026-09-23)衣着细节批**(用户拍板:半指手套 + 卷裤脚皮护膝):主角三卡正向提示词随批插入 `brown fingerless gloves` 与 `leather knee pads with trouser legs rolled up above them`(皮革族小件,不占剪影预算);§2 形象锚随改;规格上游 character-design.md §5.4 同批升 v1.3。 -- **v2.3(2026-09-23)背包具形批 + 装备彩蛋池**(用户三拍板:①背包措辞与体量——弃"鼓胀掳获袋"改结构式帆布冒险背包,宽 ≈1.5× 体宽,正面参照合金弹头双主角大背包/奇诺比奥队长、反面禁特里式 3× 超宽;②护目镜推额前、头灯退役、灯改小号铜色提灯挂腰间(不点亮);③随身件=魔法道具形象候选池——铲/旗/背包/提灯,道具语义归魔法道具批):主角三卡正向提示词随批更新(背包短语+护目镜+腰灯);§2 形象锚随改;规格上游 character-design.md §5.4 同批升 v1.2。 -- **v2.2(2026-09-23)掳获包裹批**(用户拍板:背旗改"背负大号鼓胀布包裹、旗杆插于包裹顶"——"地牢扫荡者满载而归"的角色化):主角三卡正向提示词随批更新(包裹短语 `large bulging tan canvas loot sack tied with rope on his back` + 旗改插于包裹顶);§2 形象锚随改(包裹、旗与铲三态恒在);规格上游 character-design.md §5.4 同批升 v1.1。 -- **v2.1(2026-09-23)主角特征批**(用户两拍板:直剑→圆头挖掘铲——挖安全格动作语义角色化,攻击表现即挥铲;背后加旗朱三角旗——与棋盘插旗同物同色 `#C63D22`):主角三卡正向提示词随批更新(铲+背旗短语,三态同旗同形象,背旗为主角唯一破对称件);§2 形象锚与 2.1/2.2 规格措辞随改(2.2"刀光"改"铲击光效");规格上游改指 character-design.md §5.4(人物设计自圣经 §5 抽离成独立文档,圣经 §5 为存根);§0 模型适配注补现行管线(Z-Image-Turbo GGUF + 像素 LoRA 已挂母版工作流,触发词 `Pixel art style.` 入正向待拍板)。 -- **v2.0(2026-09-22)重生成批**(用户拍板正序:美术圣经 §5 角色设计落地(v1.6)后重写本卡;v1.0 于同日经裁决移除,台账 125):六敌种→**八敌种**(新增灰矮人/钩爪恐魔/灰矮人石君王三卡);**逐资产提示词改自包含完整串**(正向底座+主体+动作拼妥、负向底座+增补并妥,整段可直贴,零拼装);主角蓝族随 art-bible v1.1 换装(`#2E86DE`,同族候选 `#5FA8E8`/`#1C5CA4`);护甲视觉短语按 §5.3 注入各卡(轻甲无甲板/魔法护甲暖白符纹/重甲冷灰甲板,天然甲壳不计甲档);bugbear 主体由「高瘦」改「敦实圆肩」守 §5.1 普通怪宽≥高;兄弟精备选配色弃冷蓝灰(蓝族禁入敌方)改灰褐战纹;验收速查五关→六关(增甲档);引用基线改 art-assets-checklist 单清单(asset-checklist 已随合并批删除)。 +- **v2.4(2026-09-23)衣着细节批**(用户拍板:半指手套 + 卷裤脚皮护膝):主角三卡正向提示词顺带插入 `brown fingerless gloves` 与 `leather knee pads with trouser legs rolled up above them`(皮革族小件,不占剪影预算);§2 形象锚随改;规格上游 character-design.md §5.4 同批升 v1.3。 +- **v2.3(2026-09-23)背包具形批 + 装备彩蛋池**(用户三拍板:①背包措辞与体量——弃"鼓胀掳获袋"改结构式帆布冒险背包,宽 ≈1.5× 体宽,正面参照合金弹头双主角大背包/奇诺比奥队长、反面禁特里式 3× 超宽;②护目镜推额前、头灯退役、灯改小号铜色提灯挂腰间(不点亮);③随身件=魔法道具形象候选池——铲/旗/背包/提灯,道具语义归魔法道具批):主角三卡正向提示词顺带更新(背包短语+护目镜+腰灯);§2 形象锚随改;规格上游 character-design.md §5.4 同批升 v1.2。 +- **v2.2(2026-09-23)掳获包裹批**(用户拍板:背旗改"背负大号鼓胀布包裹、旗杆插于包裹顶"——"地牢扫荡者满载而归"的角色化):主角三卡正向提示词顺带更新(包裹短语 `large bulging tan canvas loot sack tied with rope on his back` + 旗改插于包裹顶);§2 形象锚随改(包裹、旗与铲三态恒在);规格上游 character-design.md §5.4 同批升 v1.1。 +- **v2.1(2026-09-23)主角特征批**(用户两拍板:直剑→圆头挖掘铲——挖安全格动作语义角色化,攻击表现即挥铲;背后加旗朱三角旗——与棋盘插旗同物同色 `#C63D22`):主角三卡正向提示词顺带更新(铲+背旗短语,三态同旗同形象,背旗为主角唯一破对称件);§2 形象锚与 2.1/2.2 规格措辞随改(2.2"刀光"改"铲击光效");规格上游改指 character-design.md §5.4(人物设计自圣经 §5 抽离成独立文档,圣经 §5 为存根);§0 模型适配注补现行管线(Z-Image-Turbo GGUF + 像素 LoRA 已挂母版工作流,触发词 `Pixel art style.` 入正向待拍板)。 +- **v2.0(2026-09-22)重生成批**(用户拍板正序:美术圣经 §5 角色设计落地(v1.6)后重写本卡;v1.0 于同日经裁决移除,状态记录 125):六敌种→**八敌种**(新增灰矮人/钩爪恐魔/灰矮人石君王三卡);**逐资产提示词改自包含完整串**(正向底座+主体+动作拼妥、负向底座+增补并妥,整段可直贴,零拼装);主角蓝族随 art-bible v1.1 换装(`#2E86DE`,同族候选 `#5FA8E8`/`#1C5CA4`);护甲视觉短语按 §5.3 注入各卡(轻甲无甲板/魔法护甲暖白符纹/重甲冷灰甲板,天然甲壳不计甲档);bugbear 主体由「高瘦」改「敦实圆肩」守 §5.1 普通怪宽≥高;兄弟精备选配色弃冷蓝灰(蓝族禁入敌方)改灰褐战纹;验收速查五关→六关(增甲档);引用基线改 art-assets-checklist 单清单(asset-checklist 已随合并批删除)。 - v1.0(2026-09-20):首版。主角三态 + 六敌种提示词卡成文;兄弟精改荐脚本换色通道;候选入库/后处理/转正五步流程成文。(2026-09-22 移除,本版为重生成。) diff --git a/design/dev/architecture/architecture.md b/design/dev/architecture/architecture.md index 7ac177ff..48dab47a 100644 --- a/design/dev/architecture/architecture.md +++ b/design/dev/architecture/architecture.md @@ -95,7 +95,7 @@ | **action_economy**（A3） | AP/RAP 账本、last_round_end、轮次相位机 {Idle, Active, Waiting}、结束仲裁 | 8 API 全布尔面：notify_round_start / request_dig / request_flag_place / request_flag_pull / request_stop / request_refresh / notify_settlement_done / notify_combat_end；ap/rap/phase 只读 | ConfigDB（ActionEconomyTable）；B1 回发 next_round_mode/battle_over | 无 | | **variation 定义**（A4） | VariationTable schema（现行 7 行：六 region + skewed_veins 一 global——全局作用域变异首发批 2026-10-04）与 F1 候选池门控谓词 | `variant_pool(level_index, board_type, node_type="")`（门控三维：unlock+board_types+节点身份——global 行仅 boss/elite 入池，缺省跳过零扰动）；`global_variant_row(level_index, board_type, node_type)`（全局型单行决议访问器） | ConfigDB（VariationTable） | 无 | | **status_container**（B3） | 状态实例容器（战斗域生命周期、跨轮跨图延续） | 5 API：notify_battle_start / apply_effect / query_active / decay_round / notify_battle_end | ConfigDB（StatusEffectTable） | 无（RefCounted） | -| **save_system**（D3，Alpha；iter27 已升格 autoload「SaveManager」） | 存档格式与版本比较 | （契约规范源：`../../gdd/systems/表现与支撑/存档序列化.md`——契约锚：SCHEMA_VERSION + master_seed + 各流 scope 计数器快照，须在无在飞 open_stream 实例时切出） | ConfigDB、RngService 只读计数器 | FileAccess——LOW | +| **save_system**（D3，Alpha；iter27 已升格 autoload「SaveManager」） | 存档格式与版本比较 | （契约规范源：`../../gdd/systems/表现与支撑/存档序列化.md`——契约锚：SCHEMA_VERSION + master_seed + 各流 scope 计数器快照，须在无正在执行中的 open_stream 实例时切出） | ConfigDB、RngService 只读计数器 | FileAccess——LOW | | **settings/localization**（D6，愿景） | 设置项、翻译数据 | （契约规范源：`../../gdd/systems/表现与支撑/设置与本地化.md`） | ConfigDB | 无 | ### 核心层 @@ -123,7 +123,7 @@ | 模块 | 独占职责 | 对外暴露 | 消费依赖 | 引擎 API | |---|---|---|---|---| -| **D1 HUD**（切片 lite 已拆 9 单元：BoardView / HUDView / HudPresenter / BattleLogView / ItemWindowOverlay / NodeOverlay / LevelStripView / TunePanel / UiKit + 组合根 main.gd；营地覆盖层=四柜台并排〔树淬炼主界面/锻造工坊·秘宝匣钥匙门/图鉴常开——迭代 21 T6 程序占位重排〕） | 全部 Control/CanvasLayer（例外：BoardView 棋盘本体与 BattleStageView 站桩本体 = Control 壳 + SubViewportContainer + SubViewport + Node2D 世界〔BoardWorld/CellUnit；StageWorld/StandeeBody——B 区 slot_row 伴随件留壳层〕，探针契约面不变——棋盘 Node2D 迁移批 Phase A 2026-09-23 / 战斗舞台 Phase B 2026-09-26）、输入→意图翻译（**唯一提交路径 = settle_batch，不直调 A3**）、呈现义务台账（A2×6 / B2×4 / B3×4 / B4×5 / B1×3） | 视图单元接口（信号外发、setter 只读注入） | A2 compute_move_path / ActionOutcome；A3 ap/rap；B1 步骤流行协议（数据源）；ConfigDB display_name | **MEDIUM**：Control / CanvasLayer / draw_* / InputEvent / RichTextLabel——对照 breaking-changes.md 4.5–4.7 条目（CanvasItem 线条无抗锯齿羽化、设备 ID 常量、RichTextLabel 图片参数两轮变化） | +| **D1 HUD**（切片 lite 已拆 9 单元：BoardView / HUDView / HudPresenter / BattleLogView / ItemWindowOverlay / NodeOverlay / LevelStripView / TunePanel / UiKit + 组合根 main.gd；营地覆盖层=四柜台并排〔树淬炼主界面/锻造工坊·秘宝匣钥匙门/图鉴常开——迭代 21 T6 程序占位重排〕） | 全部 Control/CanvasLayer（例外：BoardView 棋盘本体与 BattleStageView 站桩本体 = Control 壳 + SubViewportContainer + SubViewport + Node2D 世界〔BoardWorld/CellUnit；StageWorld/StandeeBody——B 区 slot_row 伴随件留壳层〕，探针契约面不变——棋盘 Node2D 迁移批 Phase A 2026-09-23 / 战斗舞台 Phase B 2026-09-26）、输入→意图翻译（**唯一提交路径 = settle_batch，不直调 A3**）、呈现义务状态记录（A2×6 / B2×4 / B3×4 / B4×5 / B1×3） | 视图单元接口（信号外发、setter 只读注入） | A2 compute_move_path / ActionOutcome；A3 ap/rap；B1 步骤流行协议（数据源）；ConfigDB display_name | **MEDIUM**：Control / CanvasLayer / draw_* / InputEvent / RichTextLabel——对照 breaking-changes.md 4.5–4.7 条目（CanvasItem 线条无抗锯齿羽化、设备 ID 常量、RichTextLabel 图片参数两轮变化） | | **battle_presentation**（B5，垂直切片后） | 结算动画 / 伤害数字 / 战斗舞台 | （契约规范源：`../../gdd/systems/战斗循环/战斗表现.md`——前置「战斗表现美术测试」锁双舞台陷阱） | B1 步骤流（回放脚本源）、D1 | **MEDIUM**：AnimationPlayer（String→StringName 变更）/ Tween | | **audio**（D4，Alpha） | 音频挂点 | （挂点 = B1 明细行类型流；负反馈聚合——单结算至多一次） | B1 流水 | AudioStreamPlayer（4.7 area_mask 默认 1→0 注意） | | **tutorial**（D5，Alpha） | 教学条目 | （口径来源：A2/A3/B3/B1 各教学条目） | 各上游 | 无 | @@ -154,7 +154,7 @@ | **SCRIPT ERROR 扫描** | 已落实（闸③，外部扫描——GDScript 无脚本错误陷阱 API，闸设在外部包装） | **缺失** | **缺失** | **缺失** | 不适用（静态域无运行时错误面） | | **断言数下限** | 无独立下限（闸②摘要行必须在案，防「跑一半仍 PASS」；脚本错误吞断言路径由闸③兜住） | **缺失**（27 套件跑完不校验断言总数，零断言套件可绿） | 不适用（逐段 PASS 标记判定，无断言总数概念） | 不适用（golden 容差 + 取证存在性判定） | 不适用（逐规则命中判定） | -背景事实（run_smoke 头注在案）：GDScript 运行时脚本错误不改进程退出码、不计入冒烟失败数、且静默中断所在函数剩余断言——2026-09-19 台账 83 实证「309 项 0 失败」实为断言未跑全。这是 SCRIPT ERROR 扫描必须存在于判定层的原因。 +背景事实（run_smoke 头注在案）：GDScript 运行时脚本错误不改进程退出码、不计入冒烟失败数、且静默中断所在函数剩余断言——2026-09-19 状态记录 83 实证「309 项 0 失败」实为断言未跑全。这是 SCRIPT ERROR 扫描必须存在于判定层的原因。 ### 静态扫描域 S1–S8 承接清单 @@ -175,7 +175,7 @@ ### 依赖约束 -测试域不得反向依赖呈现层具体实现。五闸及其调用的探针场景、审计脚本只允许依赖两类边界： +测试域禁止反向依赖呈现层具体实现。五闸及其调用的探针场景、审计脚本只允许依赖两类边界： 1. **autoload 边界**——ConfigDB / RngService 的公开面（--script 模式不加载 autoload 且不注册全局标识符，测试文件自带显式实例化夹具）； 2. **场景契约**——探针场景的信号外发面与视图单元接口（信号外发、setter 只读注入），禁直引呈现层实现内部（如 UiKit 工厂内部状态、BoardView 绘制细节）。 @@ -218,7 +218,7 @@ D1 ◀──呈现数据源：A2 事件流 / B1 步骤流 / A3 ap-rap / ConfigDB ### 3. 存档/读档路径（MVP 无存档；契约已锁） -- MVP 无元进度持久化（C4/D3 归 Alpha）。**已锁契约**：续玩/复盘快照 = master_seed + 各流 scope 计数器 + 意图序列 + 窗口选择序列；快照切出须发生在无在飞 `open_stream` 实例时（scope 事件边界外——B1 编排保证：切点 = board install 边界）。 +- MVP 无元进度持久化（C4/D3 归 Alpha）。**已锁契约**：续玩/复盘快照 = master_seed + 各流 scope 计数器 + 意图序列 + 窗口选择序列；快照切出须发生在无正在执行中的 `open_stream` 实例时（scope 事件边界外——B1 编排保证：切点 = board install 边界）。 - 可回放性已实证：切片冒烟同种子双跑步骤流逐行相同（B1 AC-33 前身）。 - D3 Alpha 期按此契约设计格式；SCHEMA_VERSION 高版本拒读。 diff --git a/design/dev/code-conventions.md b/design/dev/code-conventions.md index a7b1f660..2f9bbbdf 100644 --- a/design/dev/code-conventions.md +++ b/design/dev/code-conventions.md @@ -15,7 +15,7 @@ ### 1.2 一切功能以类封装，禁止裸函数堆 设计稿与实现同尺度：功能 = 类（状态 + 行为 + 信号），类是封装的最小交付单位。工具性纯函数只允许挂在明确的宿主类下（静态装配器/工厂），不允许无主散落。 -### 1.3 依赖单向，核心写调用收口 +### 1.3 依赖单向，核心写调用完成 依赖方向唯一：`views →（信号）→ 组合根 →（写调用）→ core`。视图零核心写调用（纯 setter / 信号外发优先）；"读核心状态 → 拼展示文案"集中于装配器（presenter）；核心写接口（settle_batch / submit_window_selection / runner 推进）只允许在组合根出现。 ### 1.4 命名 = 领域命名，禁止系统 ID 前缀 @@ -89,6 +89,6 @@ ## 6. 流程纪律 -1. **大改动三段走**：设计稿/伪代码 → 用户审阅 → 实现；实现不得先于审阅。修改记录落切片 README。 +1. **大改动三段走**：设计稿/伪代码 → 用户审阅 → 实现；实现禁止先于审阅。修改记录落切片 README。 2. **实现批收尾双登记**：切片 README 修改记录 + 根目录 `active.md` 条目（会话状态唯一状态源），缺一不可。 3. **呈现层缺陷的教训回写 D1 GDD 设计输入**（信号载荷 schema / 场景级测试 / 时点状态可见性）。 diff --git a/design/dev/concept-conventions.md b/design/dev/concept-conventions.md index ceb1f756..f47b06e4 100644 --- a/design/dev/concept-conventions.md +++ b/design/dev/concept-conventions.md @@ -23,7 +23,7 @@ **切分正例**（现行排雷循环即按此切分）：棋盘是地图级对象，包含多个格；格是成员对象，危险格/安全格是它的枚举属性；格上可能挂的奖励或惩罚（格面资源）是独立对象，本体与规则归地图战斗资源与战斗结算，格只保留"有无资源资格"一个挂载位。反面基准：把奖励的类型、数值、极性全摊开写成格子的属性字段——奖励规则一改，棋盘文档就得跟着改，这便是没封装。 -**无权威文档，不下定义**：一个概念还没有权威文档时，任何其他文档都不得替它下定义——只能引用概念名，并在 `design/gdd/06-待办清单.md` 登记「待落位」；谁先立权威文档，谁拿走全部定义权。（反例：某概念长期无权威文档，art-bible 复述、06 登记、需求卡片摘要三处各自给出口径，范围限定词在层层复述中丢失，最终放大成「全板常显」的错误事实。） +**无权威文档，不下定义**：一个概念还没有权威文档时，任何其他文档都禁止替它下定义——只能引用概念名，并在 `design/gdd/06-待办清单.md` 登记「待落位」；谁先立权威文档，谁拿走全部定义权。（反例：某概念长期无权威文档，art-bible 复述、06 登记、需求卡片摘要三处各自给出口径，范围限定词在层层复述中丢失，最终放大成「全板常显」的错误事实。） **与引用纪律的关系**：第 1 节管单个概念的边界与归属（概念级封装），第 2 节管概念之间、文档之间的引用（跨文档解耦）——先有封装，第 2 节的单点定义、反向边与删除 SOP 才有干净的作用对象。 @@ -40,7 +40,7 @@ | 依赖逐条列出 | 系统文档的「依赖与输出」节逐条列出本系统依赖的他人概念（规范名 + 链接）——这份清单就是删除概念时的影响面清单 | | 引用必登记反向边 | 引用他系统概念时，在被引方的 registry 条目 `referenced_by` 里登记——影响面靠它机械列出，不靠全仓搜 | | 链接断了也好读 | 引用处的句子在链接失效后仍通顺完整（写"变异规则见《地形变异》"，不把半截语义挂在链接里） | -| 待办单点登记 | 全项目待办事项单点登记于 `design/gdd/06-待办清单.md`：系统文档的「待办」节只留指路存根，不得自建条目表；新增待办条目直接登记清单，裁决后改「状态」列留痕、不删条目 | +| 待办单点登记 | 全项目待办事项单点登记于 `design/gdd/06-待办清单.md`：系统文档的「待办」节只留指路存根，禁止自建条目表；新增待办条目直接登记清单，裁决后改「状态」列留痕、不删条目 | **引用格式**：一律 Markdown 相对链接，指向文件、必要时带节锚点（例：`[地形变异 · 变异类型](systems/排雷循环/地形变异.md#变异类型)`）——机械可查，死链可被工具检出。 @@ -50,5 +50,5 @@ ## 3. 归档与事实源 -- 旧文档里的概念写进现行文档时，必须翻译成现行术语与现行决策口径（例：已退役机制不得作为现行机制引用）。 +- 旧文档里的概念写进现行文档时，必须翻译成现行术语与现行决策口径（例：已退役机制禁止作为现行机制引用）。 - registry 中 owner 仍指向旧 GDD 路径的条目，在对应新系统文档定稿后逐条改指新路径。 diff --git a/design/dev/process-conventions.md b/design/dev/process-conventions.md index 8d32b084..19cf3b21 100644 --- a/design/dev/process-conventions.md +++ b/design/dev/process-conventions.md @@ -7,11 +7,11 @@ ## 1. 分支纪律（worktree 铁律） -主工作区（master 检出）只作合并落点与共享状态载体，一切开发/设计改动不得直接发生在主工作区： +主工作区（master 检出）只作合并落点与共享状态载体，一切开发/设计改动禁止直接发生在主工作区： 1. **开工**：每批次先建独立 worktree：`git worktree add ../g-plan2-<任务名> -b <任务分支>`；所有改动与验证都在 worktree 内进行（未跟踪文件不会出现在新 worktree，需手工搬运） -2. **收尾**：迭代 loop 批次验证全绿（冒烟+场景探针）后在主工作区 `git merge --no-ff <任务分支>`，再 `git worktree remove`+删分支；合并前先看 active.md 尾部状态记录，防并行会话撞号/漏捎带；收口按 doc-conventions 第 10 节退役规则删除已完结条目。非 loop 批次默认收口不跑闸（两入口铁规），用户点名或当场问 -3. **豁免面**：仅根目录 `active.md`（会话收口）、`.zcode/`（钩子与配置，入库）与 `.qoder/`（本机 harness 配置，gitignored 不入 git，走 worktree 反而带不进去）允许主工作区直改；其余一律走 worktree，主工作区 git commit 被钩子拦截 +2. **收尾**：迭代 loop 批次验证全绿（冒烟+场景探针）后在主工作区 `git merge --no-ff <任务分支>`，再 `git worktree remove`+删分支；合并前先看 active.md 尾部状态记录，防并行会话撞号/漏捎带；完成按 doc-conventions 第 10 节退役规则删除已完结条目。非 loop 批次默认完成不跑闸（两入口铁规），用户点名或当场问 +3. **豁免面**：仅根目录 `active.md`（会话完成）、`.zcode/`（钩子与配置，入库）与 `.qoder/`（本机 harness 配置，gitignored 不入 git，走 worktree 反而带不进去）允许主工作区直改；其余一律走 worktree，主工作区 git commit 被钩子拦截 4. 本铁律由 PreToolUse 钩子 `.zcode/hooks/worktree-guard.sh` 强制兜底；钩子只约束 agent，用户手工改动不受限 ## 2. 三段开发流程 @@ -20,9 +20,9 @@ | 段 | 产出 | 出入口铁律 | |---|---|---| -| 一·设计 | GDD 文档或 art-bible | 用户提起或从 `06-待办清单` 取出；会话内进行、用户主导、禁无监管自跑；经用户点头确认心智一致才许落文档；完成判据=待裁点清零，带未裁点的是讨论稿；不自动进写卡段，写卡须用户另行发令 | +| 一·设计 | GDD 文档或 art-bible | 用户提起或从 `06-待办清单` 取出；会话内进行、用户主导、禁无监管自跑；经用户点头确认心智一致才许写入文档档；完成判据=待裁点清零，带未裁点的是讨论稿；不自动进写卡段，写卡须用户另行发令 | | 二·写需求卡片 | 需求卡片（写作规范见用户级技能 req-card） | 设计定稿后用户发令；例外=缺陷修复/工程债/测试基建/重构凭 bug 证据或 06 条目直接进入；新玩法/新系统/新内容必须有设计定稿前置；卡片必经 grilling 多轮复核、零待裁点才成立；入库必在 06 登记一条（防遗忘）；编入后续未完成迭代（roadmap 迭代行），无空位与用户确认开新一轮 | -| 三·实现 | 代码与配置，可运行的游戏 | 需求卡片永不单独施工，统一由用户指定迭代号触发（=U0 开工令），按 /iter 技能与本文 §3 执行；设计权威文档（GDD/art-bible）批内一律不更新，实现批只出迭代实现报告（见 §3 第 12 条）；收口人闸=实机目检清单+代拍板追认单登记交用户即完成批内义务 | +| 三·实现 | 代码与配置，可运行的游戏 | 需求卡片永不单独施工，统一由用户指定迭代号触发（=U0 开工令），按 /iter 技能与本文 §3 执行；设计权威文档（GDD/art-bible）批内一律不更新，实现批只出迭代实现报告（见 §3 第 12 条）；完成人闸=实机目检清单+代拍板追认单登记交用户即完成批内义务 | ## 3. 批次工作流标准清单 @@ -35,20 +35,20 @@ **环境与基线** 4. **独立 worktree+拷导入缓存**——按 §1 建 worktree；先拷主区 `.godot/` 目录与字体 `.import` 边车再跑测试，否则全量重导入资源近似卡死 -5. **改码前定基线三查**——记录冒烟全绿数目、单元测试套数、现行模拟基线读数；改完同口径对拍，红绿才能归因到本批 -6. **涉数值改动先采改前读数**——与改后同随机种子配对比较并写明对拍口径；无数值改动禁跑模拟 +5. **改码前定基线三查**——记录冒烟全绿数目、单元测试套数、现行模拟基线读数；改完同口径逐项比对，红绿才能归因到本批 +6. **涉数值改动先采改前读数**——与改后同随机种子配对比较并写明逐项比对口径；无数值改动禁跑模拟 **实施** 7. **新功能必配新测试**——新增玩法/机制必须配套新测试套件进 `tests/run_all`；没有对应测试的变更不许合并 8. **验收改动先行声明**——验收变化（基线换代/探针增改/旧断言改判）预先写进需求卡片，禁事后补 9. **验收函数变异验证**——新增/改写的验收函数（冒烟断言/探针自检/闸机判据）必须配一次变异验证：故意把被测件改坏成该类缺陷形态 → 跑最窄那道闸确认变红 → `git checkout` 精确还原；变异点/跑的闸/红输出摘要/还原结论四件记入实现报告变异验证记录表；**无变异红记录的断言不写「已验收」，只写「已实现，拦截能力未证」**（细则见 test-conventions §6） -**收口** +**完成** 10. **批末全量验收才合并**——在任务 worktree 内跑 `tools/run_all_gates.sh`（不带 `--quick`），全绿才合回 master。该脚本是全部验证闸的**唯一入口与唯一清单**，闸件增减只改它；**本文与其他文档禁另列闸件清单**（清单散落多处正是 iter27 漏跑 `probe_gate --full` 的成因）。跑完写回执 `game/tests/.gates/receipt.json`，合回时由 worktree-guard 强制校验 11. **合并后主区全量复跑**——合并可能引入冲突或环境差异，落回 master 后再跑全套 -12. **会话收口落记**——active.md 快照与状态记录更新（含删除已完结旧条目，doc-conventions 第 10 节）；跨会话教训写入记忆库；漏删旧条目由 `tools/audit_active_state.py` 在全量档抓（合回闸强制，脚本即清单） -13. **文档同步闸**——机械面文档（roadmap 行/registry/active.md 记账/README 工具注）合并前随批更新完毕方算收口；设计权威文档批内不更新：实现批收口出迭代实现报告（`design/qa/iter-实现报告-<日期>.md`：各卡状态+代拍板追认单+GDD 反哺点节），反哺点同步登记 `06-待办清单`，用户逐点裁决后另批落文；反哺点未落文期间相关 GDD 节视为待反哺，读前先查 06；需求卡片必列「关联文档同步面」按两层标注 -14. **实机目检归用户，只登记不阻塞**——真人检测项登记进实现报告目检总清单与 07-体验验证清单即完成批内义务；禁把等目检当停工理由或收口前置 +12. **会话完成落记**——active.md 快照与状态记录更新（含删除已完结旧条目，doc-conventions 第 10 节）；跨会话教训写入记忆库；漏删旧条目由 `tools/audit_active_state.py` 在全量档抓（合回闸强制，脚本即清单） +13. **文档同步闸**——机械面文档（roadmap 行/registry/active.md 记账/README 工具注）合并前顺带更新完毕方算完成；设计权威文档批内不更新：实现批完成出迭代实现报告（`design/qa/iter-实现报告-<日期>.md`：各卡状态+代拍板追认单+GDD 反哺点节），反哺点同步登记 `06-待办清单`，用户逐点裁决后另批写入文档；反哺点未写入期间相关 GDD 节视为待反哺，读前先查 06；需求卡片必列「关联文档同步面」按两层标注 +14. **实机目检归用户，只登记不阻塞**——真人检测项登记进实现报告目检总清单与 07-体验验证清单即完成批内义务；禁把等目检当停工理由或完成前置 15. **中间产物吸收即死**——细则见 CLAUDE.md 硬性红线与 doc-conventions 第 11 节 ## 4. 测试执行两入口铁规（细则） @@ -57,7 +57,7 @@ **MC/verifier 触发细则**：仅在数值验证场景触发（改数值前后取证）；normal 档为主、perfect 按需；**无数值改动的会话禁跑 MC**；结构位移类「存档锚」须先向用户请示定性再跑；需求卡片预设步骤的前提消失时（如「带值裁定后重锚」实际未投值）停问勿照字面执行。 -**分级周期口径**：全部验证闸收编在 `tools/run_all_gates.sh` 一个入口下（**脚本即清单**），分两档——`--quick` 档跳过渲染闸（需开显示器）与静态扫描，供迭代中段自检；**收口出库一律跑全量档（不带 `--quick`）**，回执由合回闸强制校验。真人实机目检归用户不进自动闸。 +**分级周期口径**：全部验证闸收编在 `tools/run_all_gates.sh` 一个入口下（**脚本即清单**），分两档——`--quick` 档跳过渲染闸（需开显示器）与静态扫描，供迭代中段自检；**完成出库一律跑全量档（不带 `--quick`）**，回执由合回闸强制校验。真人实机目检归用户不进自动闸。 ## 5. MC 采集档位细则 @@ -70,18 +70,18 @@ | 三档·小调 | 只测不判 | 总量 ≤20、每档 ≤10 | 数值验证场景 | | 四档·微量 | sanity 门，零统计判读 | 总量 ≤5 | 数值验证场景 | -配套纪律：超档=停机呈报，窗口不足如实挂起，禁在二/三/四档下带值结论；改前/改后锚同 seed0 配对、改前锚留盘禁补跑；对拍断言零新跑（复验用锚内子集 ≤20）；读数缺陷（零 gameplay/RNG 触碰）禁整套重跑、走事件流重构补算；≥60 局采集先 N=5 pilot 校验字段；二/三/四档会话累计 ≤20 分钟；零数值改动=零 MC；四档仅承接数值验证场景，两入口铁规不变。 +配套纪律：超档=停机呈报，窗口不足如实挂起，禁在二/三/四档下带值结论；改前/改后锚同 seed0 配对、改前锚留盘禁补跑；逐项比对断言零新跑（复验用锚内子集 ≤20）；读数缺陷（零 gameplay/RNG 触碰）禁整套重跑、走事件流重构补算；≥60 局采集先 N=5 pilot 校验字段；二/三/四档会话累计 ≤20 分钟；零数值改动=零 MC；四档仅承接数值验证场景，两入口铁规不变。 ## 6. 闸机轮次纪律 1. **孤立验证先行**——新代码/新工具/新断言进全套闸之前，先走通最小可运行路径的 standalone 验证（30 秒级：新断言=单独驱动函数直跑；新工具=最小参数全路径试车含产出落盘；新探针=单 .tscn 直跑）；禁以全套闸首跑充当新码首验 2. **调试期最窄确认**——出红→修复→确认只跑出红的最小单元（单探针/单套件/单函数）；全套闸每个里程碑步（波/T 段）出口最多一次，红灯补跑只跑红件；修的是全部探针/套件共用的共享件（冒烟包装器、闸机脚本本身）时全套即最小充分单元，注记说明即可 -3. **长批试车**——≥2 分钟的跑批（逐位对拍冻结/MC 批/批量模拟）发起前，先用最小参数把工具完整路径（含解析/落盘/写锚全链）跑通一遍再放长批 +3. **长批试车**——≥2 分钟的跑批（逐位逐项比对冻结/MC 批/批量模拟）发起前，先用最小参数把工具完整路径（含解析/落盘/写锚全链）跑通一遍再放长批 4. **开工坑册扫描**——每波/T 段开工前，按要触碰的面扫一遍在册坑（worktree 缓存三件套、--script 模式无 autoload、守卫文本匹配等） ## 7. 像素结构件工作纪律 1. **先抄后造**——画像素结构件前，先从参考素材裁同类结构放大逐像素描述，再实现同款；禁凭印象/第一性原理发明像素结构（art-bible §8.5 参考核验的执行口径） -2. **验收口径写成像素级视觉判据**——开工前把合格标准写成"X 与 Y 同列收尾/无悬空/无突出"式句子；自检放大最差交界处逐行核像素，不只看整板观感 +2. **验完成径写成像素级视觉判据**——开工前把合格标准写成"X 与 Y 同列收尾/无悬空/无突出"式句子；自检放大最差交界处逐行核像素，不只看整板观感 3. **±1px 一律坐标推导**——单像素级结构先写坐标推导（哪条线在哪列、谁与谁齐平）留档再写码；禁蒙数试错 4. **修复默认附前后对比图+像素审计**，不等用户索要 diff --git a/design/dev/test-conventions.md b/design/dev/test-conventions.md index 3bb052f8..5fa11d33 100644 --- a/design/dev/test-conventions.md +++ b/design/dev/test-conventions.md @@ -33,13 +33,13 @@ 需求卡片 §7「逐需求点验收清单」每一条都要落成可执行的验证；本文定统一写法，卡里定每批的具体内容（测什么/注入哪里）。写卡期查不出执行载体的条目=不可测，当场呈报，禁拖到实现期。 -1. **执行载体五选一，逐条声明**：单元测试（`tests/run_all`）／冒烟断言（`smoke_all.gd` 对应场景段）／场景探针（`smoke/` 下 `*_probe`）／MC 同种子对拍／人工核对（仅限无法自动化的纪律类需求点，如命名锁定、数值占位）。行为类条目以自动化载体为主。 +1. **执行载体五选一，逐条声明**：单元测试（`tests/run_all`）／冒烟断言（`smoke_all.gd` 对应场景段）／场景探针（`smoke/` 下 `*_probe`）／MC 同种子逐项比对／人工核对（仅限无法自动化的纪律类需求点，如命名锁定、数值占位）。行为类条目以自动化载体为主。 2. **粒度与对应关系**：每条清单条目至少一个自动断言；多条条目可合用一个测试函数。断言失败消息末尾带编号尾缀〔卡短名 Vn〕（如〔秘宝批 V3〕）——断言与卡片清单可互相 grep 查找。 3. **断言词汇按验证对象五选一**： | 词汇 | 适用场景 | |---|---| - | 逐位相等 | 同种子下确定性公式与结算的精确对拍 | + | 逐位相等 | 同种子下确定性公式与结算的精确逐项比对 | | 区间/差值带 | 概率与平衡读数（MC 同种子配对比较，出带即红） | | 快照比对 | 存档域结构、配置表行结构 | | 重放 | 同种子断点回放、改前改后配对 | diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 03e2a8bb..f334b190 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -8,7 +8,7 @@ **归属**：呈现层表现批（纯工程；素材已有按钮常态与按下两张图） -**状态**：**已完成（2026-10-14，迭代 26 T1「UI 交互与观感批」收口）**——五态矩阵补齐：普通钮悬停=常态图+modulate 1.06 提亮（乙案落地，代拍板1）、禁用=本族底+α0.45 幽灵化（甲案，代拍板2，取代旧「disabled=按压图」错配）、焦点=INK 2px 内缩 1px 环（甲案，代拍板3，逐实例 override、主题层零新增）、危险钮补本族 pressed（深红 darkened(0.18) 深档）+disabled+focus；冒烟 V1/V2 断言 35 条在闸（四工厂逐只五态非空/hover≠normal/disabled≠pressed/危险钮非石纹/焦点环参数锚定+主题双红线维持）。原待拍板点（悬停甲/乙）已由 grilling 第一轮②裁乙案。键盘导航批量面归「棋盘战斗键盘/手柄输入」Beta 条连带裁决点③（本批焦点态是其前置件，已交付） +**状态**：**已完成（2026-10-14，迭代 26 T1「UI 交互与观感批」完成）**——五态矩阵补齐：普通钮悬停=常态图+modulate 1.06 提亮（乙案落地，代拍板1）、禁用=本族底+α0.45 幽灵化（甲案，代拍板2，取代旧「disabled=按压图」错配）、焦点=INK 2px 内缩 1px 环（甲案，代拍板3，逐实例 override、主题层零新增）、危险钮补本族 pressed（深红 darkened(0.18) 深档）+disabled+focus；冒烟 V1/V2 断言 35 条在闸（四工厂逐只五态非空/hover≠normal/disabled≠pressed/危险钮非石纹/焦点环参数锚定+主题双红线维持）。原待拍板点（悬停甲/乙）已由 grilling 第一轮②裁乙案。键盘导航批量面归「棋盘战斗键盘/手柄输入」Beta 条连带裁决点③（本批焦点态是其前置件，已交付） #### 全局纹理过滤未设为邻近采样——像素资源非整数倍缩放会发糊（2026-10-13 登记，UI 美化三层诊断 · 第一层） @@ -16,11 +16,11 @@ **归属**：呈现层表现批（一行渲染设置） -**状态**：**已完成（2026-10-14，迭代 26 T2 收口）**——`project.godot` `[rendering]` 增 `textures/canvas_textures/default_texture_filter=0`（Nearest）；T0 翻转面全枚举闭合：无显式 filter 的纹理节点仅 3 处（ui_kit vignette/beams/gradient_base）已挂显式 LINEAR 白名单，九宫格 UI 皮与主题石纹样式盒翻 Nearest＝意图面，.tscn 零纹理节点；冒烟 V3 断言 6 条在闸。原风险提示（改前须确认无资源依赖线性插值）已由枚举+白名单+实机目检项（07 ㉕）覆盖 +**状态**：**已完成（2026-10-14，迭代 26 T2 完成）**——`project.godot` `[rendering]` 增 `textures/canvas_textures/default_texture_filter=0`（Nearest）；T0 翻转面全枚举闭合：无显式 filter 的纹理节点仅 3 处（ui_kit vignette/beams/gradient_base）已挂显式 LINEAR 白名单，九宫格 UI 皮与主题石纹样式盒翻 Nearest＝意图面，.tscn 零纹理节点；冒烟 V3 断言 6 条在闸。原风险提示（改前须确认无资源依赖线性插值）已由枚举+白名单+实机目检项（07 ㉕）覆盖 #### UI 贴图重构批——营地与元进度件仍是程序化占位（原登记在美术侧，2026-10-13 由 UI 美化三层诊断转立本清单专条） -**现状**：营地的柜台场景贴图目前是程序化画出来的临时形态，没有上贴图。这条债原先只写在美术侧的资产清单里（[美术资产清单](../art/art-assets-checklist.md) 第 134 行与第 175 行，原文注明"营地现为程序化占位，台账 121⑧ 口径，排期归 UI 贴图重构批"），规格其实已经定了——烛光黄 `#F6C667` 配木色 `#8A5A34`（见 [美术圣经](../art/art-bible.md) §4.4），素材来源允许走"通用图标改色复用"这条低成本渠道。 +**现状**：营地的柜台场景贴图目前是程序化画出来的临时形态，没有上贴图。这条债原先只写在美术侧的资产清单里（[美术资产清单](../art/art-assets-checklist.md) 第 134 行与第 175 行，原文注明"营地现为程序化占位，状态记录 121⑧ 口径，排期归 UI 贴图重构批"），规格其实已经定了——烛光黄 `#F6C667` 配木色 `#8A5A34`（见 [美术圣经](../art/art-bible.md) §4.4），素材来源允许走"通用图标改色复用"这条低成本渠道。 **归属**：UI 贴图重构批（美术线；须先裁决是自己画还是找 CC0 素材改色，两条备选见 [美术资产清单](../art/art-assets-checklist.md) §0 的复用渠道闸） @@ -36,7 +36,7 @@ #### 战斗一屏样张 P0 未开工——界面成品是否过审的那把尺子还没建（2026-10-13 登记，UI 美化三层诊断 · 第二层） -**现状**：[美术圣经](../art/art-bible.md) §7.1 明文写着"程序化占位＝临时态，任何屏的终稿闸＝§1.4 整屏样张过闸；占位态不得跨里程碑"。而 [美术素材状态清单](../art/art-status-checklist.md) 把「战斗一屏样张」这件最高优先级的素材标的是**未开始**——也就是说，**判定界面美术算不算过关的那把尺子到现在还没造出来**。看板总账十五件：已完成四件、占位在役八件、未开始三件。 +**现状**：[美术圣经](../art/art-bible.md) §7.1 明文写着"程序化占位＝临时态，任何屏的终稿闸＝§1.4 整屏样张过闸；占位态禁止跨里程碑"。而 [美术素材状态清单](../art/art-status-checklist.md) 把「战斗一屏样张」这件最高优先级的素材标的是**未开始**——也就是说，**判定界面美术算不算过关的那把尺子到现在还没造出来**。看板总账十五件：已完成四件、占位在役八件、未开始三件。 **归属**：美术线（战斗一屏样张的验收标准归 [战斗表现](systems/战斗循环/战斗表现.md) 与 [美术圣经](../art/art-bible.md) §5.1 共裁） @@ -48,7 +48,7 @@ **归属**：呈现层表现批（光柱纯改代码；九宫格切片需连带核对素材尺寸能否撑住新切片值，可能要重出素材，属美术线连带面） -**状态**：**半完成（2026-10-14，迭代 26 T4 收口）**——①光柱硬边**已修**：带内 alpha 0→0.05→0 三角过渡＋纵向衰减上亮下暗（连续 alpha 方案，grilling Q7 裁；纹理 filter 挂 LINEAR 白名单）；冒烟 T4 结构断言 3 条在闸。②九宫格切片错位**存续**（未动）——须先核素材尺寸能否撑住新切片值（border_stone 48×48 按 12 切片、panel_stone 48×48 按 16 切片，铺到四百多像素宽面板的拉伸接缝），可能要重出素材＝美术线连带面，归后续贴图批次 +**状态**：**半完成（2026-10-14，迭代 26 T4 完成）**——①光柱硬边**已修**：带内 alpha 0→0.05→0 三角过渡＋纵向衰减上亮下暗（连续 alpha 方案，grilling Q7 裁；纹理 filter 挂 LINEAR 白名单）；冒烟 T4 结构断言 3 条在闸。②九宫格切片错位**存续**（未动）——须先核素材尺寸能否撑住新切片值（border_stone 48×48 按 12 切片、panel_stone 48×48 按 16 切片，铺到四百多像素宽面板的拉伸接缝），可能要重出素材＝美术线连带面，归后续贴图批次 #### UI 元素细节修——滑轨填充不可辨、图标垫深块、留白失衡、开发件外泄（2026-10-13 登记，UI 美化三层诊断 · 第三层） @@ -58,32 +58,32 @@ **归属**：呈现层表现批 -**状态**：**已完成（2026-10-14，迭代 26 T5/T5b 收口）**——②③④全部落地：②图标垫深块（明度差降档：BCard 图标槽换 SLOT_BACKDROP_SOFT #806A4E 柔和档，对米色卡面 3.69:1〔旧 8.53:1〕，白图标 5.14:1 ≥3:1 硬约束；范围按实查订正=仅三选一 BCard，商店卡实为纯文字行卡无图标）；③留白失衡（商店卡片区 ALIGNMENT_CENTER 垂直居中；营地四栏等高=三 holder 统一 min 高 336+四面板纵向 FILL+锁文居中；范围按实查订正=仅商店+营地，三选一已居中）；④诊断转储钮退出玩家画面（迁调试浮窗，grilling Q8 裁甲，dump_diagnosis 卡死取证保留）。①滑轨填充已随迭代 25 销号。本条四项全部完成，整条销号 +**状态**：**已完成（2026-10-14，迭代 26 T5/T5b 完成）**——②③④全部落地：②图标垫深块（明度差降档：BCard 图标槽换 SLOT_BACKDROP_SOFT #806A4E 柔和档，对米色卡面 3.69:1〔旧 8.53:1〕，白图标 5.14:1 ≥3:1 硬约束；范围按实查订正=仅三选一 BCard，商店卡实为纯文字行卡无图标）；③留白失衡（商店卡片区 ALIGNMENT_CENTER 垂直居中；营地四栏等高=三 holder 统一 min 高 336+四面板纵向 FILL+锁文居中；范围按实查订正=仅商店+营地，三选一已居中）；④诊断转储钮退出玩家画面（迁调试浮窗，grilling Q8 裁甲，dump_diagnosis 卡死取证保留）。①滑轨填充已随迭代 25 注销。本条四项全部完成，整条注销 #### 需求卡片：UI 交互与观感批（2026-10-13 成文，待裁） -**内容**：UI 美化三层诊断剩余可纯工程落地部分的收口批，六项——①按钮五态矩阵补齐（普通钮悬停态甲/乙待裁、禁用态错配修正、危险钮本族按下态、三工厂焦点样式盒）；②全局纹理过滤设邻近采样（project.godot 一行＋显式 LINEAR 白名单＋翻转面枚举）；③三处 <4.5:1 文字位换墨（站桩护甲徽标两处＋敌顺位徽标＋RAP 反馈行，机检断言锚定）；④光柱硬边修（带内 alpha 渐变＋纵向衰减）；⑤元素细节余②③（BCard 图标槽明度差降档、商店卡片区垂直居中、营地四栏等高）；⑥诊断转储钮移入调试浮窗。**范围按代码实查订正**（ iter25 滑轨条同款订正先例）：②垫块仅三选一 BCard 一处（商店卡实为纯文字行卡无图标）；③仅商店+营地（三选一卡片区实查已居中）；危险钮「无按下态」订正为「按下态在但皮肤错配（红钮承石纹按压图）」。任务卡 T0-T6 共 ≈2–2.5d，验证闸 V1-V7，代拍板白名单八项，反哺点三条。 +**内容**：UI 美化三层诊断剩余可纯工程落地部分的完成批，六项——①按钮五态矩阵补齐（普通钮悬停态甲/乙待裁、禁用态错配修正、危险钮本族按下态、三工厂焦点样式盒）；②全局纹理过滤设邻近采样（project.godot 一行＋显式 LINEAR 白名单＋翻转面枚举）；③三处 <4.5:1 文字位换墨（站桩护甲徽标两处＋敌顺位徽标＋RAP 反馈行，机检断言锚定）；④光柱硬边修（带内 alpha 渐变＋纵向衰减）；⑤元素细节余②③（BCard 图标槽明度差降档、商店卡片区垂直居中、营地四栏等高）；⑥诊断转储钮移入调试浮窗。**范围按代码实查订正**（ iter25 滑轨条同款订正先例）：②垫块仅三选一 BCard 一处（商店卡实为纯文字行卡无图标）；③仅商店+营地（三选一卡片区实查已居中）；危险钮「无按下态」订正为「按下态在但皮肤错配（红钮承石纹按压图）」。任务卡 T0-T6 共 ≈2–2.5d，验证闸 V1-V7，代拍板白名单八项，反哺点三条。 **指针**：`design/research/需求卡片-UI交互与观感批-2026-10-13.md` -**状态**：**已收口（2026-10-14，迭代 26 总收口——单会话 /goal+iter U0 全量交付）**——六项全落地（T0 基线+枚举/T1 五态/T2 Nearest+白名单/T3 换墨/T4 光柱/T5 细节/T5b 诊断钮），冒烟 987→1055/0（+68 断言）+run_all 25 套+probe click/full+render_gate golden 处置在册+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。上方第一层第二/三条、第三层四条（<4.5:1／氛围层光柱半／元素细节余项）按卡片 §5 同步面已销号或改写；实现报告=design/qa/iter26-实现报告-2026-10-14.md；反哺点四条见下条待用户逐点裁决 +**状态**：**已完成（2026-10-14，迭代 26 总完成——单会话 /goal+iter U0 全量交付）**——六项全落地（T0 基线+枚举/T1 五态/T2 Nearest+白名单/T3 换墨/T4 光柱/T5 细节/T5b 诊断钮），冒烟 987→1055/0（+68 断言）+run_all 25 套+probe click/full+render_gate golden 处置在册+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。上方第一层第二/三条、第三层四条（<4.5:1／氛围层光柱半／元素细节余项）按卡片 §5 同步面已注销或改写；实现报告=design/qa/iter26-实现报告-2026-10-14.md；反哺点四条见下条待用户逐点裁决 -#### 迭代 26 UI 交互与观感批——GDD 反哺点四条（2026-10-14 随批登记，待用户逐点裁决另批落文） +#### 迭代 26 UI 交互与观感批——GDD 反哺点四条（2026-10-14 顺带登记，待用户逐点裁决另批写入文档） -**来源**：迭代 26 实现报告 §五（已退役，git 历史可考）——实现与 [美术圣经](../art/art-bible.md) 的差异/缺口，按 2026-10-10 文档同步闸 v2 立规：设计权威文档不随批直改，逐点待用户裁决后另批落文。 +**来源**：迭代 26 实现报告 §五（已退役，git 历史可考）——实现与 [美术圣经](../art/art-bible.md) 的差异/缺口，按 2026-10-10 文档同步闸 v2 立规：设计权威文档不顺带直改，逐点待用户裁决后另批写入文档。 - **反哺点①（§7 按钮五态/焦点态规格缺项）**：art-bible §7 无按钮五态（悬停/按下/禁用/键盘焦点）与焦点环的规格条款，本批实现（modulate 1.06 提亮/α0.45 幽灵化/INK 2px 内缩 1px 环）目前是**临时权威**——是否立条款、值是否冻结待裁。 - **反哺点②（§7/§8.2 平滑渐变件白名单无例外条款）**：全局 Nearest 下 vignette/gradient_base/beams 三件程序化平滑渐变挂显式 LINEAR，属对「像素风全局邻近」的有意豁免；art-bible 无相应例外条款（§8.2 已有状态图标抗锯齿例外先例可援）——豁免清单是否入册待裁。 - **反哺点③（§4.1 新色 token 语义岗登记）**：本批新立三 token——GOLD_BRIGHT #E0B860（金族亮档）/HERO_BLUE_BRIGHT #7EBAF0（小人蓝亮档）/SLOT_BACKDROP_SOFT #806A4E（图标槽柔和档），§4.1 语义岗未登记——语义命名与值是否转正待裁。 - **反哺点④（氛围层风格一致性）**：vignette/gradient_base/beams 保平滑连续 alpha，与卡顶类型色带 DitherBand 的 Bayer 有序抖动派并存——grilling Q5 已裁「保平滑」，两派不一致性留整屏样张批统一裁决（样张批未开工，06 在册）。 -**归属**：[美术圣经](../art/art-bible.md) §7/§4.1/§8.2（裁决后另批落文） +**归属**：[美术圣经](../art/art-bible.md) §7/§4.1/§8.2（裁决后另批写入文档） -**状态**：✅ **已落文（2026-10-14，用户裁「全部按呈报落文」——qa 收尾批同批）**——①③④落**art-bible.md v3.14**（①=§7.6(一) 按钮五态矩阵转正〔悬停 modulate 1.06/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环〕；③=§4.1 三枚新 token 语义岗登记+色板计数 42→45；④=§7.6(三) 氛围层两派并存留整屏样张批统一裁决）；②落**art-bible.md v3.14 §8.2**（全局 Nearest+三件程序化平滑渐变 LINEAR 豁免清单入册）。报告 §五已逐条标注落点 +**状态**：✅ **已写入（2026-10-14，用户裁「全部按呈报写入文档」——qa 收尾批同批）**——①③④落**art-bible.md v3.14**（①=§7.6(一) 按钮五态矩阵转正〔悬停 modulate 1.06/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环〕；③=§4.1 三枚新 token 语义岗登记+色板计数 42→45；④=§7.6(三) 氛围层两派并存留整屏样张批统一裁决）；②落**art-bible.md v3.14 §8.2**（全局 Nearest+三件程序化平滑渐变 LINEAR 豁免清单入册）。报告 §五已逐条标注落点 #### 旧行为 MC 行为锚全数作废——重锚归数值批（2026-10-06 登记） -**现状**：案C 地图伤害账殿后批（git 7ef18ac，状态记录 371）改变每轮结算行为序——授予段不再兑付任何伤害（伤害形态单据暂存至战斗段末，段内序=主角先手→逐敌还手→地图账），主角死亡短路语义随之换代（「授予段伤害致死短路先手」路径消失）。既有全部 MC 行为锚与对拍锚所锚行为已不存在，**全数作废**；新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则（无数值调整禁重跑），重锚不在改动批执行。 +**现状**：案C 地图伤害账殿后批（git 7ef18ac，状态记录 371）改变每轮结算行为序——授予段不再兑付任何伤害（伤害形态单据暂存至战斗段末，段内序=主角先手→逐敌还手→地图账），主角死亡短路语义随之换代（「授予段伤害致死短路先手」路径消失）。既有全部 MC 行为锚与基线逐项比对锚所锚行为已不存在，**全数作废**；新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则（无数值调整禁重跑），重锚不在改动批执行。 **归属**：M-4 数值批（用户 2026-10-06 确认此为影响数值难度的重要变量）。 @@ -132,15 +132,15 @@ **归属**：[锻造工坊](systems/跨局循环/锻造工坊.md)（设计权威文档，v0.1〔时名「武器锻造」〕起自本专条独立成文；2026-10-11 用户令系统更名锻造工坊） -**状态**：**17 裁点全部拍板、本条设计面收口（2026-10-12 锻造工坊裁决会话续，用户逐点裁决）**——设计文档 design/gdd/systems/跨局循环/锻造工坊.md〔成文时名「武器锻造.md」，2026-10-11 随系统更名〕**v0.5** 落文：A 组（v0.4，四柜台承载/生命归树脊柱/攻防所有权切分/钥匙无前置/2c·5a 结案）+ B 组 15 点（1 丙/1a 一次冒险一件武器+一件甲/1b 营地可换·冒险内锁死/1c 免费/2a 伪裁点消解/2b 随 3a 消解/3a 魔法护甲统一命名/3b 敌方攻击缺省普通·克制反向当下生效/3c 每型独立路线/4a 前缓后陡/4b 自闭环/4b-1 并联双通道/5b 纯钥石/5c 零材料/6 **满级特效本期不做留扩展位**/8a 工作间两区定名）。**推翻推荐案四行（2a/3b/6/8a）+ 呈报方撤回一条（4a-1）**，全表见该文档「裁决结果清单」节；「工作间内容清单」节为实装批需求卡片输入。数值 provisional 终值归 Alpha 收官 M4 数值批〔未排期〕。实装待办见下条。 +**状态**：**17 裁点全部拍板、本条设计面完成（2026-10-12 锻造工坊裁决会话续，用户逐点裁决）**——设计文档 design/gdd/systems/跨局循环/锻造工坊.md〔成文时名「武器锻造.md」，2026-10-11 随系统更名〕**v0.5** 写入文档：A 组（v0.4，四柜台承载/生命归树脊柱/攻防所有权切分/钥匙无前置/2c·5a 结案）+ B 组 15 点（1 丙/1a 一次冒险一件武器+一件甲/1b 营地可换·冒险内锁死/1c 免费/2a 伪裁点消解/2b 随 3a 消解/3a 魔法护甲统一命名/3b 敌方攻击缺省普通·克制反向当下生效/3c 每型独立路线/4a 前缓后陡/4b 自闭环/4b-1 并联双通道/5b 纯钥石/5c 零材料/6 **满级特效本期不做留扩展位**/8a 工作间两区定名）。**推翻推荐案四行（2a/3b/6/8a）+ 呈报方撤回一条（4a-1）**，全表见该文档「裁决结果清单」节；「工作间内容清单」节为实装批需求卡片输入。数值 provisional 终值归 Alpha 收官 M4 数值批〔未排期〕。实装待办见下条。 #### 锻造工坊实装批 — 待办（冻结：迭代规划冻结中，重启=用户发令）（2026-10-09 随成文批登记，时名「武器锻造系统实装批」；2026-10-11 随系统更名换代） -**内容**：按 [锻造工坊](systems/跨局循环/锻造工坊.md) **v0.6** 定案口径实装（需求卡片输入=其「裁决结果清单」+「工作间内容清单」两节）——迁移面八项：① **新建锻造路线行族**（forge_products 已随迭代 21 T5 整体退役、无改造对象——v0.6 事实订正：行族/访问器/购买面三处退役登记在册，本批新建而非改造；落位=新表 forge.tres〔ForgeTable〕，钥石定价历史考古 20/150%、provisional 投值归 M4 终值）；② **两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档域 forge_routes+冒险开始参数面注入；一次冒险一个武器类型+一个甲型，营地免费切换、冒险开始后锁死）；③ `feats.tres` magic_vs_magic 死条件行——复活案作废（2026-10-11 核结：所属件魔网织者在素材库表二 27 件退役删除名单），随专长退役删行批消解，本批零触碰；④ 存档域新增三武器+三甲型等级与当前选中标记（**不设特效域**——2026-10-12 裁 6；开发阶段无迁移——旧档缺键补齐=初始持有态，v6→v7 空迁移；存档序列化文档与 registry 随批登记）；⑤ **满级特效本期不实装**（2026-10-12 裁 6：不开三条新参数位、不加效果类型词，扩展位留空，启用需另立项）；⑥ **敌方攻击类型轴填值（3b 裁连带，跨系统汇合点）**——敌方攻击单据 `attack_type` 按「未设置=默认 normal」填值使其参与克制矩阵查表（现役为 `""` 恒不查矩阵；`enemy.tres:527` 轴未开、全部 normal 档）：**执行面归敌人系统/战斗结算侧**，本批只登记需求与数值影响（全局平移主角受伤点数：穿重甲 −1、穿魔法护甲 +1，须进⑧配对读数验证）；敌方 attack_type 为敌方定义数据（与敌种名字/血量同批同时读写、无独立时序），填值归敌人系统/战斗结算侧自然推进；本批只按 3b 裁落结构面（矩阵查表现役已支持）（2026-10-12 订正：原「两批排期协商（可同批做，也可先行）」句删除——用户裁：时序问题不存在）**（✅ 已完成 2026-10-13 迭代 24 卡① N3：20 行全填 normal+schema 枚举校验+单位快照+开单第 9 参传值+敌方结算克制消费点；全局平移穿重甲 −1/魔法护甲 +1/轻甲 0 经同种子三甲型配对实测在案——矩阵数值零触碰）**；⑦ 术语登记——三型甲统一命名（轻甲/重甲/魔法护甲；**「魔法甲」系笔误不登记别名**）+ 工作间两区定名（武器锻造区/护甲锻造区）登记 registry entities.yaml；⑧ 数值验证义务=改前/改后同随机种子配对读数验证难度影响，统一调整归 M4 数值批。**解锁通道**：四条待解锁路线（长枪/法杖/重甲/魔法护甲）均走并联双通道（练满前一档 OR 一次性解锁价，互不影响、玩家自选），不设串联门槛。**前置**：17 裁点用户逐点裁决——**已清零（2026-10-12 B 组 15 点逐裁落文 v0.5；2c/5a 于 v0.4 结案）**。**关联（2026-10-11 换代）**：锻造工坊钥匙节点改无前置直接可点亮（2026-10-11 用户裁，原等级阈值前置作废）；树脊柱砍攻/护两线（攻防所有权切分——攻击唯一入口=武器路线、AC 唯一入口=甲路线，树侧落文归天赋树会话交接批）后本批=攻防数值唯一实装面；树结构换代（33→12）已随迭代 21 入库——本批④存档域 forge_routes 独立成域（已预登记存档序列化.md v7 计划行），无共域冲突（2026-10-12 订正：原「排期两批合并评估」语境随树批入库消失——用户裁：非裁点）。**前置信息（2026-10-12 用户裁定：不在本批考虑）**：3b 后现行数据三型成纯序（重甲正向 > 轻甲中性 > 魔法护甲负向，敌方现行无魔法攻击故暂无优势窗口）——系**后续开发改造的前置事实**，敌方攻击类型差异化与魔法护甲的正当性归后续批次（含 M4 在基础 AC / 解锁价上的取值）；本批只按统一伤害轴落结构与字段。 +**内容**：按 [锻造工坊](systems/跨局循环/锻造工坊.md) **v0.6** 定案口径实装（需求卡片输入=其「裁决结果清单」+「工作间内容清单」两节）——迁移面八项：① **新建锻造路线行族**（forge_products 已随迭代 21 T5 整体退役、无改造对象——v0.6 事实订正：行族/访问器/购买面三处退役登记在册，本批新建而非改造；落位=新表 forge.tres〔ForgeTable〕，钥石定价历史考古 20/150%、provisional 投值归 M4 终值）；② **两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档域 forge_routes+冒险开始参数面注入；一次冒险一个武器类型+一个甲型，营地免费切换、冒险开始后锁死）；③ `feats.tres` magic_vs_magic 死条件行——复活案作废（2026-10-11 核结：所属件魔网织者在素材库表二 27 件退役删除名单），随专长退役删行批消解，本批零触碰；④ 存档域新增三武器+三甲型等级与当前选中标记（**不设特效域**——2026-10-12 裁 6；开发阶段无迁移——旧档缺键补齐=初始持有态，v6→v7 空迁移；存档序列化文档与 registry 顺带登记）；⑤ **满级特效本期不实装**（2026-10-12 裁 6：不开三条新参数位、不加效果类型词，扩展位留空，启用需另立项）；⑥ **敌方攻击类型轴填值（3b 裁连带，跨系统汇合点）**——敌方攻击单据 `attack_type` 按「未设置=默认 normal」填值使其参与克制矩阵查表（现役为 `""` 恒不查矩阵；`enemy.tres:527` 轴未开、全部 normal 档）：**执行面归敌人系统/战斗结算侧**，本批只登记需求与数值影响（全局平移主角受伤点数：穿重甲 −1、穿魔法护甲 +1，须进⑧配对读数验证）；敌方 attack_type 为敌方定义数据（与敌种名字/血量同批同时读写、无独立时序），填值归敌人系统/战斗结算侧自然推进；本批只按 3b 裁落结构面（矩阵查表现役已支持）（2026-10-12 订正：原「两批排期协商（可同批做，也可先行）」句删除——用户裁：时序问题不存在）**（✅ 已完成 2026-10-13 迭代 24 卡① N3：20 行全填 normal+schema 枚举校验+单位快照+开单第 9 参传值+敌方结算克制消费点；全局平移穿重甲 −1/魔法护甲 +1/轻甲 0 经同种子三甲型配对实测在案——矩阵数值零触碰）**；⑦ 术语登记——三型甲统一命名（轻甲/重甲/魔法护甲；**「魔法甲」系笔误不登记别名**）+ 工作间两区定名（武器锻造区/护甲锻造区）登记 registry entities.yaml；⑧ 数值验证义务=改前/改后同随机种子配对读数验证难度影响，统一调整归 M4 数值批。**解锁通道**：四条待解锁路线（长枪/法杖/重甲/魔法护甲）均走并联双通道（练满前一档 OR 一次性解锁价，互不影响、玩家自选），不设串联门槛。**前置**：17 裁点用户逐点裁决——**已清零（2026-10-12 B 组 15 点逐裁写入文档 v0.5；2c/5a 于 v0.4 结案）**。**关联（2026-10-11 换代）**：锻造工坊钥匙节点改无前置直接可点亮（2026-10-11 用户裁，原等级阈值前置作废）；树脊柱砍攻/护两线（攻防所有权切分——攻击唯一入口=武器路线、AC 唯一入口=甲路线，树侧写入文档归天赋树会话交接批）后本批=攻防数值唯一实装面；树结构换代（33→12）已随迭代 21 入库——本批④存档域 forge_routes 独立成域（已预登记存档序列化.md v7 计划行），无共域冲突（2026-10-12 订正：原「排期两批合并评估」语境随树批入库消失——用户裁：非裁点）。**前置信息（2026-10-12 用户裁定：不在本批考虑）**：3b 后现行数据三型成纯序（重甲正向 > 轻甲中性 > 魔法护甲负向，敌方现行无魔法攻击故暂无优势窗口）——系**后续开发改造的前置事实**，敌方攻击类型差异化与魔法护甲的正当性归后续批次（含 M4 在基础 AC / 解锁价上的取值）；本批只按统一伤害轴落结构与字段。 **归属**：[锻造工坊](systems/跨局循环/锻造工坊.md) 实装（跨 meta/hero/feats/存档/战斗开场参数五面） -**状态**：✅ **已入库（2026-10-12，/goal+iter U0 开工单会话交付——T1 行族/T2 两轴移交/T3 写口族/T5 存档 v7〔序调先行：写口硬依赖〕/T4 注入链/T6 工作间 UI/T7 收口七提交；冒烟 938/0+run_all 24 套+重闸全绿+MC 同种子配对零漂移；实现报告已退役，git 历史可考；残留人闸=实机目检工作间形态与购买交互〔07 ㉒，2026-10-14 已核销〕）。**收尾（2026-10-13）**：代拍板追认单九项用户逐项追认通过（无修改意见）；GDD 反哺点三条已落文（锻造工坊.md v0.7=Q1 等级语义正文衔接+效果类型闭集 31 订正+实装边界 1 实态回填；元进度.md v1.18=effective_ac 第一层终态句+钥石入口族三写口登记；术语表.md v1.9=路线 id/存档域键名词条）——本条义务全清。** +**状态**：✅ **已入库（2026-10-12，/goal+iter U0 开工单会话交付——T1 行族/T2 两轴移交/T3 写口族/T5 存档 v7〔序调先行：写口硬依赖〕/T4 注入链/T6 工作间 UI/T7 完成七提交；冒烟 938/0+run_all 24 套+重闸全绿+MC 同种子配对零漂移；实现报告已退役，git 历史可考；残留人闸=实机目检工作间形态与购买交互〔07 ㉒，2026-10-14 已核销〕）。**收尾（2026-10-13）**：代拍板追认单九项用户逐项追认通过（无修改意见）；GDD 反哺点三条已写入（锻造工坊.md v0.7=Q1 等级语义正文衔接+效果类型闭集 31 订正+实装边界 1 实态回填；元进度.md v1.18=effective_ac 第一层终态句+钥石入口族三写口登记；术语表.md v1.9=路线 id/存档域键名词条）——本条义务全清。** #### 玩家向显示名改名小批（局内三轴 + 临时 AC 状态）——跨循环名称冲突清偿（2026-10-12 用户逐裁，锻造工坊裁决会话续 8a 连带） @@ -167,26 +167,26 @@ | `game/data/tables/status_effects.tres:18` | 护甲强化 | **盾牌加护** | | `game/smoke/smoke_all.gd:1199` | `== "护甲强化"` 硬编码断言 | **`== "盾牌加护"`（必须同步改，否则冒烟红）** | **残留肃清（2026-10-12 同批追加）**：`reward.tres:219`、`status_effects.tres:99` 两处 2026-09-16 护甲等级掷点批历史注记 + `game/smoke/defense_scan.gd:24/:35` 打印标题与注释内的旧名「护甲强化」——主改名批合入后全库复扫发现（`display_name` 主改名未覆盖注记段），走 worktree 小批 `blessing-residue-sweep-20261012` 更新为现名「盾牌加护」并括注"2026-10-12 由'护甲强化'改名"（历史动作部分保留）→ 冒烟 864/0 → 合入 master `0144f60`。**game/ 全库现役旧名归零**——仅存的两处"护甲强化"为有意的改名留痕括注；`defense_scan.gd` 系独立手动扫描脚本（不在冒烟主链、标题无断言依赖）。 -> 附带约定（用户提案沿用）：**「加护」= AC 判定层，「护盾」= 保险丝那样的吸收层（`grant shield` 效果类型），两者不得混用**——`feats.tres:411` 保险丝给的是护盾层，与本状态是两种东西。 +> 附带约定（用户提案沿用）：**「加护」= AC 判定层，「护盾」= 保险丝那样的吸收层（`grant shield` 效果类型），两者禁止混用**——`feats.tres:411` 保险丝给的是护盾层，与本状态是两种东西。 > **【D 已执行（2026-10-12）】**——解阻过程：本会话初判"C/D 均零连带"有误，`game/smoke/smoke_all.gd:1199` 硬编码 `== "护甲强化"` 实为代码断言，只改配置会判红；如实呈报后用户追加授权（"可以简单地修改，你这次一并改完吧。但是注意我们的合入规则，避免合入失败了"）。三行同批替换 → worktree 冒烟 864 项 0 失败 → 合入 master `0c93a71`。（若只改 `status_effects.tres` 会造成格子与状态两处不同名，该方案未采纳。） -**配套文档面**：① `奇物.md` §1.2「属性值提升」**保留为机制分类名**（它与 `adventure.tres` 分类绑定），只在玩家向文案挂新层次名；② registry entities.yaml 登记"祝福"条目、旧名"X锻升"退役；③ 已占用的近义词登记**石肤**（现有奇物件，效果即 AC +1），新名勿与之撞。——**②③已执行（2026-10-13 迭代 23 反哺落文批补登）**：terminology 新增「攻击祝福/生命祝福/护甲祝福」词条（旧名保留检索别名）与「石肤（近义词占用）」备忘词条。 +**配套文档面**：① `奇物.md` §1.2「属性值提升」**保留为机制分类名**（它与 `adventure.tres` 分类绑定），只在玩家向文案挂新层次名；② registry entities.yaml 登记"祝福"条目、旧名"X锻升"退役；③ 已占用的近义词登记**石肤**（现有奇物件，效果即 AC +1），新名勿与之撞。——**②③已执行（2026-10-13 迭代 23 反哺写入批补登）**：terminology 新增「攻击祝福/生命祝福/护甲祝福」词条（旧名保留检索别名）与「石肤（近义词占用）」备忘词条。 **归属**：独立改名小批（2026-10-12 已执行完毕并合入 master）；跨 [奇物](systems/冒险循环/奇物.md)（值提升三轴的机制 owner）/ [地图战斗资源](systems/战斗循环/地图战斗资源.md)（D 的格面侧）/ [增益状态](systems/战斗循环/增益状态.md)（D 的状态侧）/ [锻造工坊](systems/跨局循环/锻造工坊.md)（冲突提出方）/ HUD 呈现面 **状态**：**已完成（2026-10-12）**——C/D 全部替换 + `smoke_all.gd:1199` 断言同步 + 残留肃清，均已在 worktree 分支执行并合入 master（`0c93a71` 改名主批 + `0144f60` 残留肃清批；冒烟两跑均 864 项检查 0 项失败，FAIL 仅存量 fx_reveal 脚本错误——迭代20 T1 a57489e9 遗留、iter21 在册，与本批无关）。**配套文档面**：① 地图战斗资源.md 版本表补 v0.23 跟随登记；② art-bible.md §4.6.1/§4.6.2 两表 display_name 列跟随（契约句"键名随其修订自动跟随"）；③ 07 体验验证清单⑫目检行跟随；④ **registry entities.yaml 登记"祝福"条目、旧名"X锻升"退役未执行**——归锻造工坊实装批术语登记面（迁移面八项⑦同域）一并做。 -#### 天赋树实装批登记欠账三条——AP 上限 clamp / 三选一刷新软上限 / Y 不入断点存档（2026-10-12 随批入册自实现报告迁立专条；2026-10-13 原批条目随入库销号拆出） +#### 天赋树实装批登记欠账三条——AP 上限 clamp / 三选一刷新软上限 / Y 不入断点存档（2026-10-12 顺带入册自实现报告迁立专条；2026-10-13 原批条目随入库注销拆出） -**现状**：迭代 21 天赋树实装批已全量入库（2026-10-12，worktree g-plan2-iter21-tree，T1-T6 代码批+T7 文档同步批；实现报告已退役，git 历史可考），批内登记欠账三条「本批不做、随批入册」；原批条目销号后由本专条承接。2026-10-13 代码复核：①③实态与登记一致仍在案；②原「另立待办」从未成条，本条即其落位。 +**现状**：迭代 21 天赋树实装批已全量入库（2026-10-12，worktree g-plan2-iter21-tree，T1-T6 代码批+T7 文档同步批；实现报告已退役，git 历史可考），批内登记欠账三条「本批不做、顺带入册」；原批条目注销后由本专条承接。2026-10-13 代码复核：①③实态与登记一致仍在案；②原「另立待办」从未成条，本条即其落位。 - **① AP 上限 clamp 缺位（缺陷）**：树「开局姿态」（每关首轮 AP+1）、AP 件、时沙同走 `action_economy.gd:239 _pending_ap_delta` 排队，轮始兑现仅下限钳制（`:254 maxi(0, …)`，无上限）——旧单源时代缺陷不可观测，新叠加源使其可观测化。**已裁（2026-10-13 用户）：暂不设上限**——provisional 天花板亦不投，随 Alpha 收官 M4 数值批一并调整（届时连同全部 AP 数值统一标定）。 - **② 三选一刷新软上限（设计问）**：停点内 GP 付费刷新倍率增长（×1.8/次曲线）×停点间基础价随进度递增，全程无软上限——是否设上限归调参批裁决。**已裁（2026-10-13 用户）：维持现状**——定性确认=设计问非缺陷，归 M4 数值批调参窗口处理，不提前单开讨论。 -- **③ Y（_attune_refresh_y）不入断点存档（可利用漏洞）**：断点快照存 `_refresh_stock`（adventure_runner.gd:236 回填）与 Y 升级档（账号级 attune_refresh_level），不存当局 Y 余量；续玩路径自参数面重新整额注入（:225）——用完 Y 退菜单再续玩即满血复活。V15 仅验账本一致性，未覆盖该面；刷新链路可用性不受影响。**已裁（2026-10-13 用户）：须修**，但不单独开工——用户令「所有都确定完了之后再一起修」，归确认工作收官后的集中修批执行；修法届时零待裁点（断点扩列一行+续玩优先读断点，`_snapshot_breakpoint` 内六个同款先例〔refresh_stock/battery_pending/feat_ticket_pity 等，扩列向后兼容〕）。**✅ 已修复（2026-10-13 同日用户令提前单独开修——「C类先不做，把还没修的 bug 修了，按正常流程走」）**：断点快照扩列 `attune_refresh_y`（`_snapshot_breakpoint`）+ 续玩 `resume_adventure` 优先读断点（缺键回退参数面=旧档行为零变化）+ 单测⑥段两断言（余量随断点还原／旧档回退）；批末冒烟 938/0+单测 24 套全绿。本件销号。 +- **③ Y（_attune_refresh_y）不入断点存档（可利用漏洞）**：断点快照存 `_refresh_stock`（adventure_runner.gd:236 回填）与 Y 升级档（账号级 attune_refresh_level），不存当局 Y 余量；续玩路径自参数面重新整额注入（:225）——用完 Y 退菜单再续玩即满血复活。V15 仅验账本一致性，未覆盖该面；刷新链路可用性不受影响。**已裁（2026-10-13 用户）：须修**，但不单独开工——用户令「所有都确定完了之后再一起修」，归确认工作收官后的集中修批执行；修法届时零待裁点（断点扩列一行+续玩优先读断点，`_snapshot_breakpoint` 内六个同款先例〔refresh_stock/battery_pending/feat_ticket_pity 等，扩列向后兼容〕）。**✅ 已修复（2026-10-13 同日用户令提前单独开修——「C类先不做，把还没修的 bug 修了，按正常流程走」）**：断点快照扩列 `attune_refresh_y`（`_snapshot_breakpoint`）+ 续玩 `resume_adventure` 优先读断点（缺键回退参数面=旧档行为零变化）+ 单测⑥段两断言（余量随断点还原／旧档回退）；批末冒烟 938/0+单测 24 套全绿。本件注销。 **归属**：① [行动经济](systems/排雷循环/行动经济.md)；② 行动经济+三选一/商店刷新经济（数值归 Alpha 收官 M4 数值批）；③ [存档序列化](systems/表现与支撑/存档序列化.md)（断点域）+ [冒险结构](systems/冒险循环/冒险结构.md)（续玩参数面）——三件均系缺陷修批/调参批输入，未排批 -**状态**：**三件终态（2026-10-13）**：① 暂不设上限随 M4 数值批／② 维持现状归 M4 数值批（两件批内零动作，数值统一标定归 M4）；③ ✅ 同日缺陷修批已修复销号（用户令提前单独开修）——本条转为记账条，无待裁点 +**状态**：**三件终态（2026-10-13）**：① 暂不设上限随 M4 数值批／② 维持现状归 M4 数值批（两件批内零动作，数值统一标定归 M4）；③ ✅ 同日缺陷修批已修复注销（用户令提前单独开修）——本条转为记账条，无待裁点 #### 现役 UI/文案两处自相冲突（2026-10-09 登记——审查批呈报 B5，用户裁「记录待办、后续迭代解决」） @@ -270,14 +270,14 @@ **内容**：三件事合一——① **N1** (1,2) 降档（hp 50→22、ac 3→2，**敌种 bugbear 不动**）；② **N2** 第二/三关普通敌技能投放（`skills.tres` 新增 `venom_spit` 毒吐 / `shield_bash` 盾击 两行，挂 6 个池，首遇位 (2,4) 不动）；③ **N3** 敌方 `attack_type` 加列并全填 normal（挂敌种行，不做差异化）。 -**收口去向**：本卡入库后，上条「第一关遭遇表数值异常」、「第二关技能池与投放」、锻造工坊条迁移面⑥「敌方攻击类型轴填值」**三条一并销号**。 +**完成去向**：本卡入库后，上条「第一关遭遇表数值异常」、「第二关技能池与投放」、锻造工坊条迁移面⑥「敌方攻击类型轴填值」**三条一并注销**。 **归属**：[敌人系统](systems/战斗循环/敌人系统.md) + [难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md) -**状态**：**已入库收口（2026-10-13，迭代 24 卡① 单会话交付）**——N1 降档/N2 两新行六池/N3 attack_type 轴全落地（master 三提交：26d669f N1+N2 / ab3ba4f N3 / 收口批）；冒烟 949/0（基线 938+N1 两断言+N2 五断言+N3 四断言）+run_all 25 套+探针全绿；MC 同种子配对 40 局×both（seed0=9000）位移在册实现报告；收口去向三条（「第一关遭遇表数值异常」「第二关技能池与投放」、锻造工坊条迁移面⑥）已随批销号；残留=实机目检三件（07 ㉓）+GDD 反哺点五条（下条，待用户裁决另批落文） +**状态**：**已入库完成（2026-10-13，迭代 24 卡① 单会话交付）**——N1 降档/N2 两新行六池/N3 attack_type 轴全落地（master 三提交：26d669f N1+N2 / ab3ba4f N3 / 完成批）；冒烟 949/0（基线 938+N1 两断言+N2 五断言+N3 四断言）+run_all 25 套+探针全绿；MC 同种子配对 40 局×both（seed0=9000）位移在册实现报告；完成去向三条（「第一关遭遇表数值异常」「第二关技能池与投放」、锻造工坊条迁移面⑥）已顺带注销；残留=实机目检三件（07 ㉓）+GDD 反哺点五条（下条，待用户裁决另批写入文档） -#### 迭代 24 敌人表内容修批——GDD 反哺点五条（2026-10-13 随批登记，待用户逐点裁决另批落文） +#### 迭代 24 敌人表内容修批——GDD 反哺点五条（2026-10-13 顺带登记，待用户逐点裁决另批写入文档） **来源**：迭代 24 实现报告 §六（已退役，git 历史可考；设计权威文档零触碰——2026-10-10 立规：文档更新必须经用户同意）。 @@ -289,19 +289,19 @@ | ④ | [敌人系统](systems/战斗循环/敌人系统.md) | 「八敌种」表缺 `hobgoblin`（有数据行 (1,3)、无立绘、不在敌种表——登记在案已知缺口，本批未动） | | ⑤ | [难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md) | N2 投放后 L2/L3 难度带位移（perfect 配对 +20~25pp 在案）+N3 全局平移（重甲 −1/魔法甲 +1/轻甲 0）——数值终值归 M4 | -**状态**：✅ **已落文（2026-10-14，用户裁「全部按呈报落文」——qa 收尾批）**——①-④落**敌人系统.md v0.18**（attack_type 字段行+矩阵消费面双向在役注记/技能错峰两轨/敌种表两行池构成/hobgoblin 缺口登记）；⑤落**难度曲线与Boss.md v0.29**（只测不判读数登记，数值终值归 M4）。报告 §六已逐条标注落点 +**状态**：✅ **已写入（2026-10-14，用户裁「全部按呈报写入文档」——qa 收尾批）**——①-④落**敌人系统.md v0.18**（attack_type 字段行+矩阵消费面双向在役注记/技能错峰两轨/敌种表两行池构成/hobgoblin 缺口登记）；⑤落**难度曲线与Boss.md v0.29**（只测不判读数登记，数值终值归 M4）。报告 §六已逐条标注落点 -#### 迭代 25 UI 全局主题批——GDD 反哺点（2026-10-14 补登——前序批次漏登；iter24/26 同款专条模式，待用户逐点裁决另批落文） +#### 迭代 25 UI 全局主题批——GDD 反哺点（2026-10-14 补登——前序批次漏登；iter24/26 同款专条模式，待用户逐点裁决另批写入文档） -**来源**：迭代 25 实现报告 §五（已退役，git 历史可考；设计权威文档不随批改，逐点待用户裁）。 +**来源**：迭代 25 实现报告 §五（已退役，git 历史可考；设计权威文档不顺带改，逐点待用户裁）。 - **反哺点①（art-bible §7 组件规格缺项）**：滚动条/滑轨/悬停气泡/输入件的组件规格条款（尺寸档、圆角、对比度底线）目前无条款，本批色值与微观值=**临时权威**——是否立条款入 §7、值是否冻结待裁。 - **反哺点②（第三层①诊断描述与代码面不符）**：UI 美化三层诊断称音量滑轨两段「同一个深棕色」，实为 #B8A582/#7A5232（2.84:1，低于 3:1 图形参考线）——「偏难辨」成立、「同色」不成立；已在 06「UI 元素细节修」条状态注记呈报，是否需回改诊断源文待裁。 -- **反哺点③（需求卡片 v1.2 注③事实订正）**：CheckButton 与 CheckBox 同套 `checked`/`unchecked`(+_disabled) 图标名（Godot 4.7.2 源码实证，「on/off」不存在）——卡片已退役归档不修订，订正只随实现报告留痕，**无落文动作**。 +- **反哺点③（需求卡片 v1.2 注③事实订正）**：CheckButton 与 CheckBox 同套 `checked`/`unchecked`(+_disabled) 图标名（Godot 4.7.2 源码实证，「on/off」不存在）——卡片已退役归档不修订，订正只随实现报告留痕，**无写入文档动作**。 - **反哺点④（主题色值双处存在）**：`.tres` 字面量与 ui_kit 常量双源（卡片立项时已知代价，README 溯源表缓解）——长期是否将主题色值收敛回代码单点（程序化 Theme 生成）待裁。 -- 〔附〕反哺点⑤=专项观察点二（滑轨柄 CANDLE 抢焦点/滚动条槽可见性）归用户目检，已登记 07 ㉔，非落文项。 +- 〔附〕反哺点⑤=专项观察点二（滑轨柄 CANDLE 抢焦点/滚动条槽可见性）归用户目检，已登记 07 ㉔，非写入文档项。 -**归属**：[美术圣经](../art/art-bible.md) §7/§8.2 + 诊断源文（裁决后另批落文） +**归属**：[美术圣经](../art/art-bible.md) §7/§8.2 + 诊断源文（裁决后另批写入文档） **状态**：✅ **已落文（2026-10-14，用户裁「全部按呈报落文」——qa 收尾批）**——①落**art-bible.md v3.14 §7.6(二)**（引擎原生控件组件规格转正，色值遵守定值单点纪律指路 theme README 溯源表）；②落**本清单「UI 元素细节修」条现状①措辞订正**（「同一个深棕色」不符代码面，实为 #B8A582/#7A5232 2.84:1——「偏难辨」成立、「同色」不成立）；④落**art-bible.md v3.14 §7.6 末注**（主题色值双源事实+收敛候选未排期）。③无落文动作（卡片已退役归档）；⑤归 07 ㉔ 目检（已核销） @@ -331,7 +331,7 @@ #### 冒险前资源配比预设（构筑提案） -**现状**：2026-09-18 用户提案，方向评估通过，登记在案。核心想法 = 玩家在**开始冒险前**预设地图战斗资源的类型配比——预设的是**分布**（八型在格面上的权重占比），不是落位：装板摇号仍按专属随机流摇出各格类型身份，玩家定分布、摇号定落位，无固定出招剧本（与既定随机性立场相容）。两分法：① **基础资源配比**——玩家对九型格面池（attack 增伤 / defense 护甲 / heal 回血 / blast 群伤 / weaken 削弱 / pierce 穿刺 / magic 魔法 / action 行动点 / gp 金币——2026-10-04 立项裁决批口径收口：原登记时 gp 型未入池写八型，现行九型正向权重合计 77）的正向行权重做配比，经覆盖值通道在开局注入，摇号按覆盖后的分布落位；② **关卡特殊资源**——不同关卡（board_biome 图主题）的地图携带配比池之外的特殊资源与差异化分布。设计红利：危险格与安全格同池 + 极性矩阵使配比自带代价轴——调高某型权重，安全格正向与危险格负向同步变多，配比 =「赌自己挖掘少失误 + 赌关卡敌人构成怕什么」的双重下注，不是免费午餐，无需另发明平衡机制。架构红利：① 的注入通道 = [元进度](systems/跨局循环/元进度.md) v1.0 刚定稿的「冒险开始参数面 + 覆盖值通道」（追加/替换集合操作已登记），零新机制；② 正是[棋盘生成](systems/排雷循环/棋盘生成.md) board_biome 上下文与[地图战斗资源](systems/战斗循环/地图战斗资源.md)`clear_<图类型>` 差异化插槽、P1 功能道具渠道等预留位的启用场景。 +**现状**：2026-09-18 用户提案，方向评估通过，登记在案。核心想法 = 玩家在**开始冒险前**预设地图战斗资源的类型配比——预设的是**分布**（八型在格面上的权重占比），不是落位：装板摇号仍按专属随机流摇出各格类型身份，玩家定分布、摇号定落位，无固定出招剧本（与既定随机性立场相容）。两分法：① **基础资源配比**——玩家对九型格面池（attack 增伤 / defense 护甲 / heal 回血 / blast 群伤 / weaken 削弱 / pierce 穿刺 / magic 魔法 / action 行动点 / gp 金币——2026-10-04 立项裁决批口径完成：原登记时 gp 型未入池写八型，现行九型正向权重合计 77）的正向行权重做配比，经覆盖值通道在开局注入，摇号按覆盖后的分布落位；② **关卡特殊资源**——不同关卡（board_biome 图主题）的地图携带配比池之外的特殊资源与差异化分布。设计红利：危险格与安全格同池 + 极性矩阵使配比自带代价轴——调高某型权重，安全格正向与危险格负向同步变多，配比 =「赌自己挖掘少失误 + 赌关卡敌人构成怕什么」的双重下注，不是免费午餐，无需另发明平衡机制。架构红利：① 的注入通道 = [元进度](systems/跨局循环/元进度.md) v1.0 刚定稿的「冒险开始参数面 + 覆盖值通道」（追加/替换集合操作已登记），零新机制；② 正是[棋盘生成](systems/排雷循环/棋盘生成.md) board_biome 上下文与[地图战斗资源](systems/战斗循环/地图战斗资源.md)`clear_<图类型>` 差异化插槽、P1 功能道具渠道等预留位的启用场景。 **影响面（按循环）**： - 排雷循环：[行动经济](systems/排雷循环/行动经济.md)——经济契约对账以资源行值为原材料，类型频次构成随配比漂移，对账窗口须按配比包络复算；[棋盘生成](systems/排雷循环/棋盘生成.md)——生成管线零改动（资源身份摇号不在其域），board_biome 词表定稿是关卡特殊资源的前置；[排雷玩法](systems/排雷循环/排雷玩法.md)——挖掘/标旗动作决定极性、承载配比的风险轴，机制零改动；[秘宝](systems/跨局循环/秘宝.md)——相邻：预读类道具读取身份查询面，配比改变分布先验后「资源预读与推理的边界」读感联动，不做机制耦合。 @@ -365,9 +365,9 @@ **归属**：①元进度设计批 + 曲线调参批 ②曲线调参批（现行窗） ③~~秘宝同调实施批~~（已清偿 2026-10-03） -**状态**：已登记（2026-10-01，迭代 10 批随批）——**①②已编入 Alpha 收官 M4 数值批〔未排期，2026-10-07 用户令移出迭代 18 暂不启动〕〔2026-10-06 用户令自迭代 17 卡②移出——不影响 17 正在执行中的开发〕（2026-10-05——裁点已全裁〔2026-10-06 用户令：P1甲/P2甲/P3甲/P4甲〕待 U0：design/research/需求卡片-M4数值批-2026-10-05.md；钥石产出重标 + 通关率带重扫 = 件③，跑批发起前须用户批准）** +**状态**：已登记（2026-10-01，迭代 10 批顺带）——**①②已编入 Alpha 收官 M4 数值批〔未排期，2026-10-07 用户令移出迭代 18 暂不启动〕〔2026-10-06 用户令自迭代 17 卡②移出——不影响 17 正在执行中的开发〕（2026-10-05——裁点已全裁〔2026-10-06 用户令：P1甲/P2甲/P3甲/P4甲〕待 U0：design/research/需求卡片-M4数值批-2026-10-05.md；钥石产出重标 + 通关率带重扫 = 件③，跑批发起前须用户批准）** -#### 调参批数值点评登记（八型批随批登记） +#### 调参批数值点评登记（八型批顺带登记） **现状**：格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 50/25 不对称是否有意；② 削弱型 65/25 同问（且 percent 套个位数取整偏粗——主角攻击 2 点时 ±25% 常取整无感）；③ 回血奖励过薄（值 1、权重全池最低 2）；④ 警觉/行动点修正两新词数值全部 provisional；⑤ 行动经济"满停一轮 = 一刷"节拍在 AP±1 修正下的对账；⑥ **格面资源正负兑付倍率差回调（2026-10-07 用户裁）**——2026-10-01「踩雷必须痛」抬档（heal +2/−6、pierce/magic +2/−8 等，负向 3-4 倍于正向）系错误的加难杠杆：难度提升应走怪物性能路线而非抬地图惩罚，回调归 M4 数值批（2026-10-09 里程碑立规：M4=Beta 阶段、M3 未由用户明令关闭前不排期——原「下一迭代数值批」表述作废）；标错/开雷同档同罚维持不动（同批裁）。 @@ -405,11 +405,11 @@ #### 基线通关率越带，加难杠杆扫描未执行 -**现状**：现行扫描读数 60%，越 [30%, 50%] 上界（2026-09-18 注：目标带已随 2026-09-17 数值纪律收口批改为 [10%, 25%]〔用户拍板〕，旧读数 60% 系压缩批前口径、已失效——本条现状文本按新带校正：新带下加难紧迫性待验收批重测后重判）。三类杠杆候选已登记：血量锚走廊 r_boss [1.1, 1.35]（Boss 生命 180–207）（2026-09-17 注：数值压缩批后 Boss 生命已 ÷3 缩水，180–207 为压缩前基线锚，复算随调参批）、群战上探、注入衰减 0.5 → 0.6；扫描步未执行。落带前全部现行行值维持 provisional-pending-scan。**2026-09-20 地形变异首批类型定稿批注记（台账 96）**：变异已天然加难一大步——R3+unique 基线格读数（atk+0%/hp+0%，对无变异基线）：普通档 L1 83%→43% / L2 87%→60%、完美档 L1 87%→70% / L2 87%→60%，加难扫描的紧迫性与剩余缺口随本批重判；**新增调参杠杆位 = 变异 effect_value（荆棘丛 1 / 岩浆 2）与 percent_of_cells（5%）/ per_level_bonus（+2/关）**，扫描时与既有三类杠杆合并比较（行值全部 provisional 归本批）。**2026-09-20 重投基线批注记（台账 105〔登记时撞并行会话 103 号，顺延让号〕）**：主角增益续时+伏击退役/警觉+行动点第八型三批行为变更后全量重投（N=300/画像/关，production/qa/mc-reinvest-baseline-2026-09-20.md）——普通档 L1 47% / L2 34%；同日基线通关率带随用户拍板分带修正为 L1 [35,55] / L2 [25,45]（旧 [10,25] 失锚作废）——**新带下普通档双关落带，加难紧迫性解除**；完美档 56%/40% 亦落带（完美档带 [35,65] 不变）；本条剩余面 = 调参批的行值 provisional→正式扫描义务（门 = 真人批 k 系数） +**现状**：现行扫描读数 60%，越 [30%, 50%] 上界（2026-09-18 注：目标带已随 2026-09-17 数值纪律完成批改为 [10%, 25%]〔用户拍板〕，旧读数 60% 系压缩批前口径、已失效——本条现状文本按新带校正：新带下加难紧迫性待验收批重测后重判）。三类杠杆候选已登记：血量锚走廊 r_boss [1.1, 1.35]（Boss 生命 180–207）（2026-09-17 注：数值压缩批后 Boss 生命已 ÷3 缩水，180–207 为压缩前基线锚，复算随调参批）、群战上探、注入衰减 0.5 → 0.6；扫描步未执行。落带前全部现行行值维持 provisional-pending-scan。**2026-09-20 地形变异首批类型定稿批注记（状态记录 96）**：变异已天然加难一大步——R3+unique 基线格读数（atk+0%/hp+0%，对无变异基线）：普通档 L1 83%→43% / L2 87%→60%、完美档 L1 87%→70% / L2 87%→60%，加难扫描的紧迫性与剩余缺口随本批重判；**新增调参杠杆位 = 变异 effect_value（荆棘丛 1 / 岩浆 2）与 percent_of_cells（5%）/ per_level_bonus（+2/关）**，扫描时与既有三类杠杆合并比较（行值全部 provisional 归本批）。**2026-09-20 重投基线批注记（状态记录 105〔登记时撞并行会话 103 号，顺延让号〕）**：主角增益续时+伏击退役/警觉+行动点第八型三批行为变更后全量重投（N=300/画像/关，production/qa/mc-reinvest-baseline-2026-09-20.md）——普通档 L1 47% / L2 34%；同日基线通关率带随用户拍板分带修正为 L1 [35,55] / L2 [25,45]（旧 [10,25] 失锚作废）——**新带下普通档双关落带，加难紧迫性解除**；完美档 56%/40% 亦落带（完美档带 [35,65] 不变）；本条剩余面 = 调参批的行值 provisional→正式扫描义务（门 = 真人批 k 系数） **归属**：难度曲线与Boss调参批，扫描执行与[棋盘生成](systems/排雷循环/棋盘生成.md)工具交付联动 -**状态**：**C1 终态已落表（返工批 2026-09-29）**——占比回退 5+plb 0+岩浆 1；U2 裁决记录（2026-09-29：b 项推翻 C3 四件组合裁 **C1 两刀**〔岩浆 effect_value 2→1+逐层变异基数 2→0；变异占比维持 5%、卓尔血维持 130〕——已落表的占比 4→5、卓尔 100→130 两行回退；a 项推翻丙裁 **甲=新杠杆授权**〔完美 L1 89% 挂账废止，见新条目「完美 L1 新杠杆授权」〕）。C1+v1 AC 组合双窗读数已到账；r_boss 复算 ≈0.33 仍低于域〔挂账维持〕；L3 密度 5%+0（介于 9% 与 4% 间）带外观察态；完美 L1 越带收敛已归难度曲线与Boss.md 带换代节承接（全局难度批、M-4 排序；原「完美 L1 新杠杆授权」「战斗阶段数值问题」两 06 条目 2026-10-03 收口移除）。原扫描记录见 迭代5杠杆扫描报告（已退役，git 历史可查），U2 裁断全录见 git 提交 f9c1a8a +**状态**：**C1 终态已落表（返工批 2026-09-29）**——占比回退 5+plb 0+岩浆 1；U2 裁决记录（2026-09-29：b 项推翻 C3 四件组合裁 **C1 两刀**〔岩浆 effect_value 2→1+逐层变异基数 2→0；变异占比维持 5%、卓尔血维持 130〕——已落表的占比 4→5、卓尔 100→130 两行回退；a 项推翻丙裁 **甲=新杠杆授权**〔完美 L1 89% 挂账废止，见新条目「完美 L1 新杠杆授权」〕）。C1+v1 AC 组合双窗读数已到账；r_boss 复算 ≈0.33 仍低于域〔挂账维持〕；L3 密度 5%+0（介于 9% 与 4% 间）带外观察态；完美 L1 越带收敛已归难度曲线与Boss.md 带换代节承接（全局难度批、M-4 排序；原「完美 L1 新杠杆授权」「战斗阶段数值问题」两 06 条目 2026-10-03 完成移除）。原扫描记录见 迭代5杠杆扫描报告（已退役，git 历史可查），U2 裁断全录见 git 提交 f9c1a8a #### 三方向各自的解锁清单与定价 @@ -425,10 +425,10 @@ **归属**：HUD 批（M-4，批未立项）——已随迭代 17 卡③实施 -**状态**：✅ 代码面已交付待实机目检（2026-10-06，迭代 17 卡③暂停层只读入口批〔时名——2026-10-13 改名状态面板〕——worktree g-plan2-iter17-pause 分支 iter17-pause-20261006，提交 c08a901/fc9eb1e/d44fdd5+收口笔；P1丁常驻角标/P2甲设置层同档 dim 遮罩/P3甲余额+三柜台进度/P4甲零动效直开直关全落；badge 已按 Q10 甲工厂化入 ui_kit 并同步迁营地钥石徽；机检=冒烟 788/0+run_all 17 套+四探针全绿〔含输入锁 case⑯/只读巡检/零动效契约/钥石徽对比度对〕+doc 三闸零新增；改名批机检=冒烟 938/0+run_all 24 套+probe --click/--full+render_gate 全绿；**人闸=用户实机目检** 迭代17人闸清单（已退役，git 历史可查）——过闸后本条注销；Esc 快捷通道维持本清单键盘/手柄条登记随键盘批办理） +**状态**：✅ 代码面已交付待实机目检（2026-10-06，迭代 17 卡③暂停层只读入口批〔时名——2026-10-13 改名状态面板〕——worktree g-plan2-iter17-pause 分支 iter17-pause-20261006，提交 c08a901/fc9eb1e/d44fdd5+完成笔；P1丁常驻角标/P2甲设置层同档 dim 遮罩/P3甲余额+三柜台进度/P4甲零动效直开直关全落；badge 已按 Q10 甲工厂化入 ui_kit 并同步迁营地钥石徽；机检=冒烟 788/0+run_all 17 套+四探针全绿〔含输入锁 case⑯/只读巡检/零动效契约/钥石徽对比度对〕+doc 三闸零新增；改名批机检=冒烟 938/0+run_all 24 套+probe --click/--full+render_gate 全绿；**人闸=用户实机目检** 迭代17人闸清单（已退役，git 历史可查）——过闸后本条注销；Esc 快捷通道维持本清单键盘/手柄条登记随键盘批办理） #### 未开格类型徽章呈现时机（2026-09-18 方向已拍板，待实施批） -**现状**：2026-09-18 用户拍板方向——未开格常显奖励类型微光（周围 8 格泛光：魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄），让玩家能针对敌人护甲类型规划优先开哪些格。设计依据：护甲克制轴已落地（穿刺弹/魔法矢），玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新（T1 裁决：采纳彩色常显微光）**：原五色与圣经语义色条款三方冲突（紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方），经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤)，见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」（候选值，样张批冻结）；圣经 §4.6.3 呈现约束已同步为「角嵌纹样(形状)+常显微光(色彩)」双通道，类型预读呈现方案在美术侧已成文。连带裁决面：① 本方向修订[不做清单](05-不做清单.md)「未开格不显示奖励身份」裁定（owner 修订，合法）；② ~~与 art-bible §4.6.3 家族类型徽章口径对齐归美术批~~——已完成（2026-09-22 美术文档修订批）；③ 探宝罗盘（预读 3×3）价值被清空，效果重定归秘宝内容批；④ ~~色板与既有格面徽标/UI 用色冲突检查归样张批~~——冲突面已在色相重选时规避，样张批保留组间互辨抽测义务；⑤ 原「资源预读与推理的边界」条目并入口径（2026-09-19 用户拍板：预读边界按本条微光方案定——类型级常显；探宝罗盘重定两方案另立条目评估）；⑥ 实施窗口 = 表现层升级批（会改推理信息面，切片期默认不开、保护验收读数基线）。**2026-09-30 口径校正（用户裁决）**：微光正确口径=**英雄周围 8 格内的未开格显示类型微光**（非全板常显）——本条历史文本中的「常显」为无范围复述、「魔法=紫/穿刺=蓝…」为 2026-09-18 原案旧色（已被 T1 重选五组取代，现行见 art-bible §4.2）；概念权威定义已落 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节（2026-09-30 收口批落位），本条此后只承载实施状态、不再承载定义。 +**现状**：2026-09-18 用户拍板方向——未开格常显奖励类型微光（周围 8 格泛光：魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄），让玩家能针对敌人护甲类型规划优先开哪些格。设计依据：护甲克制轴已落地（穿刺弹/魔法矢），玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新（T1 裁决：采纳彩色常显微光）**：原五色与圣经语义色条款三方冲突（紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方），经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤)，见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」（候选值，样张批冻结）；圣经 §4.6.3 呈现约束已同步为「角嵌纹样(形状)+常显微光(色彩)」双通道，类型预读呈现方案在美术侧已成文。连带裁决面：① 本方向修订[不做清单](05-不做清单.md)「未开格不显示奖励身份」裁定（owner 修订，合法）；② ~~与 art-bible §4.6.3 家族类型徽章口径对齐归美术批~~——已完成（2026-09-22 美术文档修订批）；③ 探宝罗盘（预读 3×3）价值被清空，效果重定归秘宝内容批；④ ~~色板与既有格面徽标/UI 用色冲突检查归样张批~~——冲突面已在色相重选时规避，样张批保留组间互辨抽测义务；⑤ 原「资源预读与推理的边界」条目并入口径（2026-09-19 用户拍板：预读边界按本条微光方案定——类型级常显；探宝罗盘重定两方案另立条目评估）；⑥ 实施窗口 = 表现层升级批（会改推理信息面，切片期默认不开、保护验收读数基线）。**2026-09-30 口径校正（用户裁决）**：微光正确口径=**英雄周围 8 格内的未开格显示类型微光**（非全板常显）——本条历史文本中的「常显」为无范围复述、「魔法=紫/穿刺=蓝…」为 2026-09-18 原案旧色（已被 T1 重选五组取代，现行见 art-bible §4.2）；概念权威定义已落 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节（2026-09-30 完成批落位），本条此后只承载实施状态、不再承载定义。 **归属**：[地图战斗资源](systems/战斗循环/地图战斗资源.md)极性提案实施批与HUD框架共裁 @@ -436,11 +436,11 @@ #### 呈现层残余 <4.5:1 文字位（迭代 16 批外邻接发现，2026-10-06 登记） -**现状**：迭代 16「UI 设计对齐批」T0 实机复算中，七点测点范围外的邻接文字位实测对直背景 <4.5:1（§7.2 无区域例外）——①B 区站桩名行/护甲徽标四墨（WARM_FAINT≈6.2 过/HERO_BLUE 3.23/GOLD_DEEP 3.26/WARM 过，直背=舞台底 `STAGE_BG #3E342A`）；②敌顺位徽标 ①②③ `GOLD_DEEP` 13px；③RAP 反馈行 `STONE_FAINT` 对 PANEL_DATA（2.73）。均系批前既有呈现、非迭代 16 引入；迭代 16 七点修法面已收口（站桩血数/意图徽标四色/C区槽两态/RAP 主标签），本条为其漏出范围，未动。来源=`迭代16出口报告（已退役，git 历史可查）` §T0。 +**现状**：迭代 16「UI 设计对齐批」T0 实机复算中，七点测点范围外的邻接文字位实测对直背景 <4.5:1（§7.2 无区域例外）——①B 区站桩名行/护甲徽标四墨（WARM_FAINT≈6.2 过/HERO_BLUE 3.23/GOLD_DEEP 3.26/WARM 过，直背=舞台底 `STAGE_BG #3E342A`）；②敌顺位徽标 ①②③ `GOLD_DEEP` 13px；③RAP 反馈行 `STONE_FAINT` 对 PANEL_DATA（2.73）。均系批前既有呈现、非迭代 16 引入；迭代 16 七点修法面已完成（站桩血数/意图徽标四色/C区槽两态/RAP 主标签），本条为其漏出范围，未动。来源=`迭代16出口报告（已退役，git 历史可查）` §T0。 **归属**：呈现优化后续批（或 UI 设计对齐批第二轮）；开工 = 用户点名 -**状态**：**已完成（2026-10-14，迭代 26 T3 收口）**——三处全部换墨达标：敌顺位徽标①②③与重甲徽标换 GOLD_BRIGHT #E0B860（对舞台底 6.47:1）、魔法护甲徽标换 HERO_BLUE_BRIGHT #7EBAF0（5.88:1）、RAP 反馈行换 STONE_DEEP（对 PANEL_DATA 5.98:1）；GOLD_DEEP/HERO_BLUE 常量本尊不动（语义岗在役），新 token 三枚落 ui_kit 单点；冒烟 V4 断言 9 条机检锚定（≥4.5:1+消费点原位+旧墨清零）。站桩名行与轻甲档原已过，不动 +**状态**：**已完成（2026-10-14，迭代 26 T3 完成）**——三处全部换墨达标：敌顺位徽标①②③与重甲徽标换 GOLD_BRIGHT #E0B860（对舞台底 6.47:1）、魔法护甲徽标换 HERO_BLUE_BRIGHT #7EBAF0（5.88:1）、RAP 反馈行换 STONE_DEEP（对 PANEL_DATA 5.98:1）；GOLD_DEEP/HERO_BLUE 常量本尊不动（语义岗在役），新 token 三枚落 ui_kit 单点；冒烟 V4 断言 9 条机检锚定（≥4.5:1+消费点原位+旧墨清零）。站桩名行与轻甲档原已过，不动 #### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 用户裁定，Alpha 阶段需完成） @@ -468,7 +468,7 @@ **归属**：[art-bible](../art/art-bible.md) §8.2 · 资产管线批 -**状态**：**已裁决案乙（2026-09-30 迭代 9 三裁决，用户「按推荐来」）**——本迭代不升档，先收 Alpha 真人读数再定（B 区舞台落影已改善存在感；T10 黄金图基准本迭代内建成不被作废）；升档批=M-4 候选位，届时提灯点亮解禁候选一并重议；A4 尺寸基线冻结（立绘 46×48/小人源 32×32）维持有效。**2026-10-04 用户令：暂不做、先忽略**（真人读数虽已收，用户裁不编入当前迭代表、挂起不讨论；重启=用户点名）。**2026-10-06 用户令：优先级再降**（维持挂起；同日 playnote 立绘批评〔像素粒度过低看不清 / 怪物大小比例不合理〕留 playnote 在案，重启时并入设计输入——**该批评实已由同日「立绘逐键定档批」承接兑现**：①像素粒度过低 → 派生管线改「pixel-1 紧裁 → 等比缩至各自档高 → dom_block_resize」，八敌源档 36–94 全过可读门槛（实测 24 糊 / 32 可读 / 48 清楚）；②怪物大小比例不合理 → 体量语义改**生物体型**（character-design §5.2，弃强度线性映射）+ 八敌逐键定档〔art-bible §8.2〕）。**2026-10-06 方案二批收口注记**：v3.0 的「档位上调方向候选」已被 art-bible v3.7 八敌逐键定档（源档 36–94、显示 ×2 整数）**实质收口**——存在感问题改经方案二（B 区 270 / 立绘显示上限 188 / 血条状态落底排）解决，不再走 64/96/128 升档路线；本条剩余挂起项 = 提灯点亮解禁候选（重启=用户点名或 M-4 升档批）。 +**状态**：**已裁决案乙（2026-09-30 迭代 9 三裁决，用户「按推荐来」）**——本迭代不升档，先收 Alpha 真人读数再定（B 区舞台落影已改善存在感；T10 黄金图基准本迭代内建成不被作废）；升档批=M-4 候选位，届时提灯点亮解禁候选一并重议；A4 尺寸基线冻结（立绘 46×48/小人源 32×32）维持有效。**2026-10-04 用户令：暂不做、先忽略**（真人读数虽已收，用户裁不编入当前迭代表、挂起不讨论；重启=用户点名）。**2026-10-06 用户令：优先级再降**（维持挂起；同日 playnote 立绘批评〔像素粒度过低看不清 / 怪物大小比例不合理〕留 playnote 在案，重启时并入设计输入——**该批评实已由同日「立绘逐键定档批」承接兑现**：①像素粒度过低 → 派生管线改「pixel-1 紧裁 → 等比缩至各自档高 → dom_block_resize」，八敌源档 36–94 全过可读门槛（实测 24 糊 / 32 可读 / 48 清楚）；②怪物大小比例不合理 → 体量语义改**生物体型**（character-design §5.2，弃强度线性映射）+ 八敌逐键定档〔art-bible §8.2〕）。**2026-10-06 方案二批完成注记**：v3.0 的「档位上调方向候选」已被 art-bible v3.7 八敌逐键定档（源档 36–94、显示 ×2 整数）**实质完成**——存在感问题改经方案二（B 区 270 / 立绘显示上限 188 / 血条状态落底排）解决，不再走 64/96/128 升档路线；本条剩余挂起项 = 提灯点亮解禁候选（重启=用户点名或 M-4 升档批）。 #### 立绘清晰度回退评估——是否改用高清图（2026-10-13 用户裁定归美术线，Alpha 阶段需完成） @@ -492,7 +492,7 @@ #### 主角描边素材侧复核（2026-10-06 待决项 B 登记注记） -**现状**：待决项 B 已按用户拍板走**文档例外条款**（character-design.md §5.1 v1.9：主角四态硬描边 = 深褐 `(40,19,13)` 显式例外，浅砖面对比更高；**素材不随批修改**）。本条仅为复核钩子：样张批（圣经 §1.4）终审时若发现深描边例外不成立（对比优势不实/与敌方同屏割裂感可感），素材侧修订（描边统一暖白族）**须先经本条重启**再开工，禁止直接动图。 +**现状**：待决项 B 已按用户拍板走**文档例外条款**（character-design.md §5.1 v1.9：主角四态硬描边 = 深褐 `(40,19,13)` 显式例外，浅砖面对比更高；**素材不顺带修改**）。本条仅为复核钩子：样张批（圣经 §1.4）终审时若发现深描边例外不成立（对比优势不实/与敌方同屏割裂感可感），素材侧修订（描边统一暖白族）**须先经本条重启**再开工，禁止直接动图。 **归属**：[character-design](../art/character-design.md) §5.1 · 样张批 @@ -582,7 +582,7 @@ ### 文档与结构 -#### 文档/结构闸存量欠账（2026-10-08 迭代 19 总收口批登记） +#### 文档/结构闸存量欠账（2026-10-08 迭代 19 总完成批登记） 新重闸口径首次全闸套跑翻出；经 T0 基点 9160942 复测确认为存量/外部批旧债，非本迭代新增。 - gdd_lint 表格占比 3 件：01-核心循环（35%）/06-待办清单（0%）/07-体验验证清单（6%）——T0 基点已 2 件存量在案，第 3 件疑外部道具批 80 行散文写入稀释占比 @@ -635,9 +635,9 @@ **状态**：备忘（长函数拆分无独立需求驱动不动；lambda 连接数若有审计工具化需求归类型闸后续） -#### 迭代 27 代码架构技术债修复批——GDD 反哺点两条（2026-10-14 随批登记，待用户逐点裁决另批落文） +#### 迭代 27 代码架构技术债修复批——GDD 反哺点两条（2026-10-14 顺带登记，待用户逐点裁决另批写入文档） -**现状**：五波全量入库（单会话交付；逐位一致对拍三变体五跑全同；实现报告=design/qa/iter27-实现报告-2026-10-14.md）。实现与设计权威文档的差异/缺口如下，经裁决后另批写入文档——**机械面已顺带改动的只有本条与 07/roadmap**。 +**现状**：五波全量入库（单会话交付；逐位一致逐项比对三变体五跑全同；实现报告=design/qa/iter27-实现报告-2026-10-14.md）。实现与设计权威文档的差异/缺口如下，经裁决后另批写入文档——**机械面已顺带改动的只有本条与 07/roadmap**。 **归属**：工程债/重构批完成反哺（不阻塞，不排期） @@ -652,15 +652,15 @@ #### 启动装配与生命周期验收补全批——需求卡片登记（2026-10-15 编入迭代 28） -**现状**：启动装配与生命周期三件坏事实代码级实查在案——①`game/presentation/main.gd:207-210` 装配顺序错（菜单屏先挂垫底、冒险屏后挂顶层盖死菜单，F5 见战斗界面）；②`game/smoke/smoke_all.gd:176-177` V2 断言把错误顺序 `menu@0 adventure@1` 写成期望值（测试在保护 bug）；③`game/smoke/shot_probe.gd`+`tools/shot_checker.py` 菜单截图无内容断言（被埋菜单坐标处亮光柱过对比度线即放行）。需求卡片=design/research/需求卡片-启动装配与生命周期验收补全批-2026-10-15.md（v1.0，六任务：T1 装配语义合同+顺序修复+V2 断言重写/T2 boot 链路时序后置条件/T3 生命周期存活性矩阵/T4 渲染面内容断言/T5 变异验证横切/T6 规范落文+收口）。 +**现状**：启动装配与生命周期三件坏事实代码级实查在案——①`game/presentation/main.gd:207-210` 装配顺序错（菜单屏先挂垫底、冒险屏后挂顶层盖死菜单，F5 见战斗界面）；②`game/smoke/smoke_all.gd:176-177` V2 断言把错误顺序 `menu@0 adventure@1` 写成期望值（测试在保护 bug）；③`game/smoke/shot_probe.gd`+`tools/shot_checker.py` 菜单截图无内容断言（被埋菜单坐标处亮光柱过对比度线即放行）。需求卡片=design/research/需求卡片-启动装配与生命周期验收补全批-2026-10-15.md（v1.0，六任务：T1 装配语义合同+顺序修复+V2 断言重写/T2 boot 链路时序后置条件/T3 生命周期存活性矩阵/T4 渲染面内容断言/T5 变异验证横切/T6 规范写入文档+完成）。 **归属**：测试基建/工程债批（迭代 28；零玩法行为变更，装配顺序修复除外） -**状态**：✅ **已入库收口（2026-10-15，迭代 28 单会话交付——用户预批连做全批；T1 装配合同 `LAYER_CONTRACT` 单点化＋顺序修复＋V1a-d 断言重写／T2 `_smoke_boot_chain` 十断言／T3 `_smoke_lifecycle_matrix` 九阶段×五引用面／T4 渲染面三件（探针两自检＋墨色判据＋启动态菜单 golden）／T5 变异验证六次注入全见红并精确还原／T6 规范三处落文；冒烟 1086→1125/0〔+39＝新增 42−退役裸下标断言 3〕；run_all 全套＋probe_gate --click/--full＋render_gate 四闸全绿；MC 零跑〔零数值零行为变更〕；实现报告=design/qa/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕）**。本批立新硬规则「验收函数无变异红记录不算验收成立」，已落 CLAUDE.md 第 9 条＋code-conventions.md §3.6＋req-card 技能 §7 三处；GDD 反哺点三条见下条待用户逐点裁决 +**状态**：✅ **已入库完成（2026-10-15，迭代 28 单会话交付——用户预批连做全批；T1 装配合同 `LAYER_CONTRACT` 单点化＋顺序修复＋V1a-d 断言重写／T2 `_smoke_boot_chain` 十断言／T3 `_smoke_lifecycle_matrix` 九阶段×五引用面／T4 渲染面三件（探针两自检＋墨色判据＋启动态菜单 golden）／T5 变异验证六次注入全见红并精确还原／T6 规范三处写入文档；冒烟 1086→1125/0〔+39＝新增 42−退役裸下标断言 3〕；run_all 全套＋probe_gate --click/--full＋render_gate 四闸全绿；MC 零跑〔零数值零行为变更〕；实现报告=design/qa/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕）**。本批立新硬规则「验收函数无变异红记录不算验收成立」，已落 CLAUDE.md 第 9 条＋code-conventions.md §3.6＋req-card 技能 §7 三处；GDD 反哺点三条见下条待用户逐点裁决 --- -#### 迭代 28 启动装配与生命周期验收补全批——GDD 反哺点三条（2026-10-15 随批登记，待用户逐点裁决另批落文） +#### 迭代 28 启动装配与生命周期验收补全批——GDD 反哺点三条（2026-10-15 顺带登记，待用户逐点裁决另批写入文档） **现状**：六任务全量入库（单会话交付；变异验证六次注入全见红并精确还原；实现报告=design/qa/iter28-实现报告-2026-10-15.md）。实现与设计权威文档的差异/缺口如下，经裁决后另批写入文档——**机械面已顺带改动的有 roadmap/本条/07/active.md/CLAUDE.md/code-conventions.md/req-card 技能（仓外）**。**与迭代 27 反哺点①的关系**：迭代 27 只登记了「场景分层/会话生命周期陈述滞后于实态」的方向性缺口，本批把其中「层序＝谁说了算」「boot 后置条件是什么」「会话引用面何时活何时死」三件做成了代码级事实与可执行断言，本条是其**具体化承接**——写入文档时可合并处理。 diff --git a/design/gdd/systems/冒险循环/关卡节点图生成.md b/design/gdd/systems/冒险循环/关卡节点图生成.md index 8ad53526..405bb59f 100644 --- a/design/gdd/systems/冒险循环/关卡节点图生成.md +++ b/design/gdd/systems/冒险循环/关卡节点图生成.md @@ -2,7 +2,7 @@ > 一句话：单关节点图怎么从固定配置变成逐局随机——图模板池、抽签与实例化 > 状态：**v0.5 台阶一已实施**（迭代 5 T5，2026-09-28 落 master 前挂 worktree m3-iter5-20260928——15 张骨架+node_map 扩签+首次冒险固定脚本+池内全模板校验+MC 分层出数，冒烟 576/0；文档本节规则与实现一致性以本批落地为准，台阶二/三仍后置） -> 旧版参考：无（旧体系未单独成文；事项自 2026-09-20 立项，池重生成已落地〔2026-09-29 返工批，二轮目检 15/15 过〕，原 06 条目已收口移除） +> 旧版参考：无（旧体系未单独成文；事项自 2026-09-20 立项，池重生成已落地〔2026-09-29 返工批，二轮目检 15/15 过〕，原 06 条目已完成移除） ## 设计目的 @@ -79,7 +79,7 @@ 教学位随骨架走：各骨架的"第一场战斗节点"沿用教学位纪律（首遇位固定数量不加骰）——教学位属性是骨架的内容标注，不跟节点编号走（拍板点①裁决后第一关也参与抽签，例外见下节）。 -### 首次冒险的固定脚本（拍板点①裁决落文） +### 首次冒险的固定脚本（拍板点①裁决写入文档） **人话阶段**：教学关不该第一局就随机——玩家第一次玩，地图必须是设计好的那一张。拍板点①裁决（2026-09-27）：**全部关卡都参与抽签，唯独玩家的第一次冒险全程走固定脚本**。这也是参照游戏的通用做法（首次冒险特殊脚本）。 @@ -116,9 +116,9 @@ 2. **基线可比**：基线批（与基线数据逐项比对、重投）跑固定模板口径——把池临时缩到 N=1（回滚档）或固定抽签 scope，保证新旧基线在同一张图上对话。 3. **实施门**：随机量（扩池）上线排在[难度曲线与Boss](难度曲线与Boss.md)曲线调参批完成之后——现行行值 provisional 收带前叠加布局随机，归因会失真；抽签机制本身可先行落地（池保持 N=1 行为零变化，见拍板点③选项 C）。 -另两条暂缓理由随批消解：**类型集未稳**——五类节点封闭枚举已随商店房批定稿，扩类走文档修订的既有通道对模板同样适用（模板 schema 跟随枚举走）；**内容量不足**——台阶一的模板就是内容批，按内容批节奏逐张走，不设批量生产目标。 +另两条暂缓理由顺带消解：**类型集未稳**——五类节点封闭枚举已随商店房批定稿，扩类走文档修订的既有通道对模板同样适用（模板 schema 跟随枚举走）；**内容量不足**——台阶一的模板就是内容批，按内容批节奏逐张走，不设批量生产目标。 -## 拍板点（登记 [06-待办清单](../../06-待办清单.md)，随批更新条目） +## 拍板点（登记 [06-待办清单](../../06-待办清单.md)，顺带更新条目） | # | 拍板点 | 状态 | |---|---|---| @@ -186,8 +186,8 @@ | 优先级 | 内容 | 后置原因 | |---|---|---| -| P1 | 台阶二：骨架固定+属性随机（候选槽位掷定） | 台阶一完成后另批立项；商店必经位的槽位排除规则随批成文 | -| P2 | 台阶三：全程序生成（参数化构造） | 台阶二完成后另批立项；参数取值域与重掷预算随批修订本文 | +| P1 | 台阶二：骨架固定+属性随机（候选槽位掷定） | 台阶一完成后另批立项；商店必经位的槽位排除规则顺带成文 | +| P2 | 台阶三：全程序生成（参数化构造） | 台阶二完成后另批立项；参数取值域与重掷预算顺带修订本文 | ## 调参表 diff --git a/design/gdd/systems/冒险循环/关卡节点地图.md b/design/gdd/systems/冒险循环/关卡节点地图.md index cfcb3548..abfb27cb 100644 --- a/design/gdd/systems/冒险循环/关卡节点地图.md +++ b/design/gdd/systems/冒险循环/关卡节点地图.md @@ -108,7 +108,7 @@ Boss 兑付（胜利或英雄死亡）触发关卡收束点，此后不再有选 第二关的"新内容 = 既有池新技能"（技能池构成已定稿入[敌人系统](../战斗循环/敌人系统.md)技能池节）投放时，改的是战斗侧行里引用的技能池内容——节点图结构原样不动，本文无需为投放留任何新结构位。 -**节点奖励 = 提升三选一（迭代 10 追加批——用户 2026-10-01 拍板：与通关三选一共享同池）**：奖励节点到达即开三选一（呈现 = 提升三选一覆盖层共用面，spec：[node-reward.md](../../ux/node-reward.md) v2.0）——从提升池七种（攻击/生命上限/护甲/GP 袋/行动点件/恢复件/刷新件）按同一令牌库洗牌不放回抽 3（同 kind 去重、同 reward_pick 封闭流），玩家点选一件兑付（选中踢池、未选回池；秘宝件已随迭代 11 第①批出池，满位替换子交互随之不再触发）。件获取次数计数与令牌库为冒险级单例——两渠道同一令牌库合计消耗。原「秘宝投放渠道三选一」（迭代 7 拍板②丙过渡形态）随批退役；秘宝局外同调件形态已随同调实施批落地（迭代 11 第①批；原提案 §9，git 57da58c 已退役）。「池空直通」为合法态——池耗即枯竭，空库 = 零候选合法态直通（见[冒险结构](冒险结构.md)令牌池节）。 +**节点奖励 = 提升三选一（迭代 10 追加批——用户 2026-10-01 拍板：与通关三选一共享同池）**：奖励节点到达即开三选一（呈现 = 提升三选一覆盖层共用面，spec：[node-reward.md](../../ux/node-reward.md) v2.0）——从提升池七种（攻击/生命上限/护甲/GP 袋/行动点件/恢复件/刷新件）按同一令牌库洗牌不放回抽 3（同 kind 去重、同 reward_pick 封闭流），玩家点选一件兑付（选中踢池、未选回池；秘宝件已随迭代 11 第①批出池，满位替换子交互随之不再触发）。件获取次数计数与令牌库为冒险级单例——两渠道同一令牌库合计消耗。原「秘宝投放渠道三选一」（迭代 7 拍板②丙过渡形态）顺带退役；秘宝局外同调件形态已随同调实施批落地（迭代 11 第①批；原提案 §9，git 57da58c 已退役）。「池空直通」为合法态——池耗即枯竭，空库 = 零候选合法态直通（见[冒险结构](冒险结构.md)令牌池节）。 ### 关卡收束点：先清库、后宣布 diff --git a/design/gdd/systems/冒险循环/冒险结构.md b/design/gdd/systems/冒险循环/冒险结构.md index 64a323ce..1f6ac969 100644 --- a/design/gdd/systems/冒险循环/冒险结构.md +++ b/design/gdd/systems/冒险循环/冒险结构.md @@ -35,7 +35,7 @@ | 节点奖励件的分类与凭证定义、池结构与抽取机制（案D——共享池库存账本仍归本文） | [奇物](奇物.md) | | 通关率带、敌我数值与 Boss 设计 | [难度曲线与Boss](难度曲线与Boss.md) | | 钥石与跨局成长 | [元进度](../跨局循环/元进度.md) | -| 冒险总结结算（呈现摘要五件事；呈现 spec：design/gdd/ux/settlement-summary.md——旧称「摘要结算画面」随 spec 命名收口退役）与关卡推进指示 | [HUD框架](../表现与支撑/HUD框架.md) | +| 冒险总结结算（呈现摘要五件事；呈现 spec：design/gdd/ux/settlement-summary.md——旧称「摘要结算画面」随 spec 命名完成退役）与关卡推进指示 | [HUD框架](../表现与支撑/HUD框架.md) | ## 在核心循环中的位置 @@ -170,7 +170,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗 **奖励节点三选一池（结构层——池机制事实源=[奇物](奇物.md)「池结构与抽取」节，2026-10-11 迭代 20 案D 换代）**：池 = 四级令牌库 70/25/9/0=104 张（案D——普通打底/优秀·稀有做翼/传说惊喜位空集；曝光槽 = 三选一 2 格全池 + 1 格优秀档以上子池，令牌 = 出现次数上限、概率与已拿上限解耦；构成数字与抽取细节全读[奇物](奇物.md)与 `adventure.tres`，provisional 归[难度曲线与Boss](难度曲线与Boss.md)曲线调参批，本节零复制）。**池为冒险级单例**（迭代 10 追加批）：关卡内奖励节点的三选一与商店货架共享同一令牌库（同库同摘牌），库存 = 剩余令牌数；消费 reward_pick 封闭随机流（主种子派生、[数据配置](../表现与支撑/数据配置.md)口径），同种子同操作序列同三选项可复放；**MC 策略 316-f**：autoplay 1 级优先度=最稀有（rarest>rare>common）、2 级=最左。断点附随件承载池余库逐枚还原；兑付语义归[关卡节点地图](关卡节点地图.md)。 -**秘宝件受同调位约束**（2026-10-09 注：道具件已随迭代 11 第①批 T7 出池——三选一/奖励节点/战斗内渠道现行零道具件投放，下述渠道约束与替换交互无现役触发面，保留作渠道恢复时的契约口径；同调位读数现行事实源=attunement_growth.tres 谓词表实时求值）：道具持有上限 = 同调位数。读数源 = 同调位里程碑谓词表 attunement_growth.tres 实时求值（0 起步、硬上限 3、增长 = 通关次数 + Boss 击杀数——同调实施批 2026-10-03 落地，过渡读数源 transitional_sync_slots 已随批退役；原提案八拍板 git 57da58c 已退役）。获取渠道约束形态（迭代 10 过渡承载）：三选一道具件超位触发**替换交互**（现有件与新件 N+1 选 N——丢任一原有件腾位收新，或放弃新件不获取；终态恒 ≤ 同调位）；奖励节点与战斗内渠道超位**不授予**（候选拒绝 + 掉落沉没，逐行归因留痕）——停点渠道全覆盖的替换交互随同调实施批统一完成（原 06 条目已随收口移除）。 +**秘宝件受同调位约束**（2026-10-09 注：道具件已随迭代 11 第①批 T7 出池——三选一/奖励节点/战斗内渠道现行零道具件投放，下述渠道约束与替换交互无现役触发面，保留作渠道恢复时的契约口径；同调位读数现行事实源=attunement_growth.tres 谓词表实时求值）：道具持有上限 = 同调位数。读数源 = 同调位里程碑谓词表 attunement_growth.tres 实时求值（0 起步、硬上限 3、增长 = 通关次数 + Boss 击杀数——同调实施批 2026-10-03 落地，过渡读数源 transitional_sync_slots 已顺带退役；原提案八拍板 git 57da58c 已退役）。获取渠道约束形态（迭代 10 过渡承载）：三选一道具件超位触发**替换交互**（现有件与新件 N+1 选 N——丢任一原有件腾位收新，或放弃新件不获取；终态恒 ≤ 同调位）；奖励节点与战斗内渠道超位**不授予**（候选拒绝 + 掉落沉没，逐行归因留痕）——停点渠道全覆盖的替换交互随同调实施批统一完成（原 06 条目已随完成移除）。 最后一关通关不发三选一与部分回血：没有下一战可受益——只做冒险完成结算，末关 Boss 钥石照常入账。设计意图：清库之后才兑付、末关不兑付，都是从「奖励只朝下一战生效」这一条推出来的。 @@ -191,10 +191,10 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗 冒险进行中随时关游戏走人（**中断**），下次启动可从最近停点继续——承载 = 存档 `breakpoint` 域（格式归[存档序列化](../表现与支撑/存档序列化.md)，内容口径归本文）。 - **停点粒度**：快照只挂选路停点（入口呈现/战斗胜利后/兑付确认后的选路态）——这是唯一可恢复停点形态。战斗进行中不写快照：中断恢复后**当场战斗从头打**，棋盘中局不入档。 -- **七字段拍板面**：关卡序号 / 节点位 / 生命 / 本关加成区 / GP 钱包 / 商店已购档 / 已抽模板。附随件（续玩正确性必需，随批登记）：主种子 + 取数计数器（rng 快照契约回填——续玩从断点号位精确续接原随机时间线，已抽模板零重抽）、钥石累计（Boss 掉落逐杀入账的中途值，终局摘要不失真）、已到节点序（关卡画面图条重建）、秘宝库存（奖励节点已选件防静默丢失）、**奖励选择态**（三选一停点中断：已选件 / 同调位替换在途——续玩已选不丢失；候选一致性=快照现状非强求 feature，2026-10-01 用户裁决）、**件获取次数计数**（kind 维度派生账本——断点附随件与读数承载）、**令牌池余库**（bonus_deck 逐枚还原——TP0 扩列，池消耗即上限的续玩正确性承载；旧版断点缺键=满库重建防御口径，单版本周期）、**商店货架态**（当前货架三件 + 本次进店已购次数——P2 甲扩列随迭代 11 第②批；离开店=空架合法态，货架续玩由确定性重放承载：重进店同种子同货架逐位）、**Y 刷新池余量**（attune_refresh_y——冒险周期池消耗余量随断点：续玩优先读断点、不自参数面整额重注入，堵「用完 Y 退菜单再续玩满血复活」可利用漏洞；旧断点缺键回退参数面=旧档行为零变化。2026-10-13 缺陷修批）。 +- **七字段拍板面**：关卡序号 / 节点位 / 生命 / 本关加成区 / GP 钱包 / 商店已购档 / 已抽模板。附随件（续玩正确性必需，顺带登记）：主种子 + 取数计数器（rng 快照契约回填——续玩从断点号位精确续接原随机时间线，已抽模板零重抽）、钥石累计（Boss 掉落逐杀入账的中途值，终局摘要不失真）、已到节点序（关卡画面图条重建）、秘宝库存（奖励节点已选件防静默丢失）、**奖励选择态**（三选一停点中断：已选件 / 同调位替换在途——续玩已选不丢失；候选一致性=快照现状非强求 feature，2026-10-01 用户裁决）、**件获取次数计数**（kind 维度派生账本——断点附随件与读数承载）、**令牌池余库**（bonus_deck 逐枚还原——TP0 扩列，池消耗即上限的续玩正确性承载；旧版断点缺键=满库重建防御口径，单版本周期）、**商店货架态**（当前货架三件 + 本次进店已购次数——P2 甲扩列随迭代 11 第②批；离开店=空架合法态，货架续玩由确定性重放承载：重进店同种子同货架逐位）、**Y 刷新池余量**（attune_refresh_y——冒险周期池消耗余量随断点：续玩优先读断点、不自参数面整额重注入，堵「用完 Y 退菜单再续玩满血复活」可利用漏洞；旧断点缺键回退参数面=旧档行为零变化。2026-10-13 缺陷修批）。 - **中断与退出两口径分离**（2026-09-29 用户裁决）：中断（关游戏）= 留断点可续；**退出冒险**（放弃流程）= 失败同型结算 + **清除断点**——退出后「继续上局」不再出现。 - **续玩**：自断点重建到最近停点（账面逐字段回填 + 随机流回填），停点处玩家重新选路。三结局（通关/失败/放弃）一律清断点——断点只活在一个进行中的冒险上。 -- 与测量面的关系：断点面只在注入存档承载的正式冒险路径生效；模拟/冒烟不注入 = 整面静默，MC 对拍零扰动。 +- 与测量面的关系：断点面只在注入存档承载的正式冒险路径生效；模拟/冒烟不注入 = 整面静默，MC 逐项比对零扰动。 ### 与关卡节点地图的边界：收束点与接口四件套 @@ -274,7 +274,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗 结构冻结（非调参项）：序列线性无跳关、关底 Boss 恒为末节点、倒下即冒险终、大奖励构成 = 通关部分回血 + 专长三选一（按档配比加权抽取——2026-10-11 迭代 20 换代；钥石退役出大奖励，改 Boss/精英击杀掉落——2026-09-30 拍板重构）、一冒险一主种子、收束点先清库后宣布的次序。 -参数联动：恢复比例与通关回血比例越厚通关越有余量（对冲杠杆语义归难度曲线与Boss）；三选一属性件/AP 件抬高后续战斗强度，件值/权重/上限改值须按难度曲线与Boss的口径重扫通关率带（回血比例自「血回满」改 20% 系难度上压方向，带判定随批呈报）。 +参数联动：恢复比例与通关回血比例越厚通关越有余量（对冲杠杆语义归难度曲线与Boss）；三选一属性件/AP 件抬高后续战斗强度，件值/权重/上限改值须按难度曲线与Boss的口径重扫通关率带（回血比例自「血回满」改 20% 系难度上压方向，带判定顺带呈报）。 ## 验收标准 diff --git a/design/gdd/systems/冒险循环/奇物.md b/design/gdd/systems/冒险循环/奇物.md index 37680dc7..219f7984 100644 --- a/design/gdd/systems/冒险循环/奇物.md +++ b/design/gdd/systems/冒险循环/奇物.md @@ -17,7 +17,7 @@ ## 专长（重设计·基础框架 v1） -> 本节是专长分类的现行事实源（2026-10-07 用户终审认同落文）。件表为设计声明——数值全 provisional 归调参批；命名全为代号，正式命名归用户。**新框架已随迭代 20 专长实装批落地（2026-10-11）：`feats.tres` 29 行=基础 27+迁入 2，行为与数据行 1:1。** +> 本节是专长分类的现行事实源（2026-10-07 用户终审认同写入文档）。件表为设计声明——数值全 provisional 归调参批；命名全为代号，正式命名归用户。**新框架已随迭代 20 专长实装批落地（2026-10-11）：`feats.tres` 29 行=基础 27+迁入 2，行为与数据行 1:1。** ### 设计原则 @@ -27,7 +27,7 @@ 4. **信息红线**：禁止任何效果让数字说谎（信息规则不豁免）；揭示类效果只揭真格。 5. **防兑换环**：互相转换的通道必须有损耗或每轮上限；单向通道优先。 -> **落行注记（迭代 20 反哺落文，2026-10-12 追认⑤）**：「每第 N 次 / 积满触发」的数据行条件写 **N−1**——效果引擎 dispatch 时 when 先于 do 读计数器现值（预评估），故「满 N 触发」落行写 N−1（例：地质学家「满 4 种」写 eq 3、封印匠「每第 3 次」写 mod_eq ref 2、双管镐「每第 2 次」写 mod_eq ref 1）。行为仍为每第 N 次准点触发，单元测试钉住；新件落行照此口径。 +> **落行注记（迭代 20 反哺写入，2026-10-12 追认⑤）**：「每第 N 次 / 积满触发」的数据行条件写 **N−1**——效果引擎 dispatch 时 when 先于 do 读计数器现值（预评估），故「满 N 触发」落行写 N−1（例：地质学家「满 4 种」写 eq 3、封印匠「每第 3 次」写 mod_eq ref 2、双管镐「每第 2 次」写 mod_eq ref 1）。行为仍为每第 N 次准点触发，单元测试钉住；新件落行照此口径。 ### 基础件表（27 件，五族 + 跨族桥 + 契约尖点） @@ -65,7 +65,7 @@ | 石肤 | on 受伤：AC +1（本场累计，上限 M） | 受击成长型护甲——越挨打越硬；恒定减伤形态被否（用户裁「太硬霸」），M 归调参批 | | 背水 | when 生命 ≤50%：受伤额外 −N | 风险联动减伤——低血不再是纯劣势；自爆流刀口舔血兜底（扩签：生命比例〔条件事实——实现前置需求，06 在册〕） | -**踩雷转化对账锚（自爆流 kill-switch，2026-10-11 用户裁随批登记）**：踩雷的净血账期望必须为负——雷伤 > 血蜜回复 + 其余转化件的血当量；对账归调参批，两轮数值迭代压不住则砍血蜜。防「见雷就踩」退化（喂雷流 R5 甲教训同源）；主动/误踩不判定（用户裁：不预判玩家意图，拿件自选收益最高的操作）。 +**踩雷转化对账锚（自爆流 kill-switch，2026-10-11 用户裁顺带登记）**：踩雷的净血账期望必须为负——雷伤 > 血蜜回复 + 其余转化件的血当量；对账归调参批，两轮数值迭代压不住则砍血蜜。防「见雷就踩」退化（喂雷流 R5 甲教训同源）；主动/误踩不判定（用户裁：不预判玩家意图，拿件自选收益最高的操作）。 **跨族桥（插旗系 × 踩雷系）（1）** @@ -104,7 +104,7 @@ 惊巢反制=退役进素材库（不迁入）。 -### 扩签登记（迭代 20 实装已承载——2026-10-12 追认④落文换代） +### 扩签登记（迭代 20 实装已承载——2026-10-12 追认④写入文档换代） - **落地结果**：事实候选 10 条中 6 条落 FACTS 词位（边缘格判定/空白连锁判定/单次伤害量/被挖格当时有旗/雷罚伤害量/生命比例），4 条改道 adventure 域计数器（类型集合计数器/本轮挖格花费/本轮开格数/本轮踩雷数计数器——跨事件累积量走计数器+value_event 比较，不占 fact 词位，T0 定架构）；停手事件已落（dig_stop）；实现随裁补位=battle_won 事件（战地包扎所需，登记未列）、mod_eq 算子（周期触发）、hp_ratio（百分比 int 口径）等 3 项事实、新效果类型 7 项。 - **连带**：净化工兵退役，rewrite_board 效果类型自引擎除名（扩签「暂缓：清图事件」不受影响，继续挂起）。 @@ -116,7 +116,7 @@ ## 资源（重设计·基础框架 v1） -> 本节是资源分类的现行事实源（2026-10-07 五件新凭证用户裁准落文）。资源成员 = **转换源**：不是资源本身，是「到手即结算成独立资源或系统数值的凭证」——凭证加完消尽，被写入的账各有自己的寿命档位。判据句与归类方法见 §1.3/§1.4。**新凭证已随迭代 20 专长实装批落表（2026-10-11，新 5+留任 2）。** +> 本节是资源分类的现行事实源（2026-10-07 五件新凭证用户裁准写入文档）。资源成员 = **转换源**：不是资源本身，是「到手即结算成独立资源或系统数值的凭证」——凭证加完消尽，被写入的账各有自己的寿命档位。判据句与归类方法见 §1.3/§1.4。**新凭证已随迭代 20 专长实装批落表（2026-10-11，新 5+留任 2）。** ### 凭证件表（新 5 + 留任 2；代号制命名归用户；稀有度档、配额与面值数值归调参批） @@ -366,7 +366,7 @@ 现行实现里**三条渠道共用同一个候选池**（商店货架按 2.4 可计算条件切边去掉计价物），三个分类出现条件一样、只有出现概率不同——上表渠道分工中的**凭证形式（非 Boss 渠道给凭证 + 保底限购）已随迭代15② 入表实装**（见 2.2 与调参表）；**Boss 渠道直接给专长已裁随专长实装批本批落地**（2026-10-11 用户裁，不再分期）。相关的实施批次登记在 [06-待办清单](../../06-待办清单.md) 的 BD 分层条目下，本文件不复制。 -**池结构选型澄清（2026-10-11）**：池结构正主=案 D（v3.3 落文，用户定夺在案）；「概率与上限解耦」的实现路径（v3.4 在册三案）系**实装侧自选项，非用户裁定项**——按「实现设计不定于现在」的原裁定，实装批内依代码事实自选，不再上问。 +**池结构选型澄清（2026-10-11）**：池结构正主=案 D（v3.3 写入文档，用户定夺在案）；「概率与上限解耦」的实现路径（v3.4 在册三案）系**实装侧自选项，非用户裁定项**——按「实现设计不定于现在」的原裁定，实装批内依代码事实自选，不再上问。 ### 3. 作用对象与范围 @@ -469,25 +469,25 @@ | **v2.4** | 2026-10-05 | **顶层由「奖励」改名为「奇物」（Wondrous Item）**。用户否决了「奖励」「收益」与全部自造词（进益/造化/机缘/遇获），要求回到 DND／西幻既有名词。定名依据：DMG 魔法物品九分类中的 Wondrous Item，官方中文译名即「奇物」，是专装不好归类但有奇效之物的兜底杂类——正好对应本概念下三个互不相干的分类。此前考虑过的 Treasure（宝物）因偏财物、装不下专长而落选；roguelike 品类惯例 Relic 因用户否决遗物落选。**代码词族定为 `curio_*`、`ADVENTURE_CURIO`**（`reward_*` 已被 `reward_pick` / `reward_node` / `reward_preview` 占用，不能对齐）。 | | **v2.5** | 2026-10-05 | **第三类定名「资源」**（用户拍板，父节点定为「奇物」后解锁）。定名依据：行动点上限 / 刷新次数 / 金币 / 回复都是可以调动、可以花掉的余量。「资源」偏泛（能力资源、财富资源都叫资源），因此在 1.5 写死判据句——**给的是可消耗或可重掷的余量，不是角色基础属性的永久抬升**，这一句是把泛用词收回本类定义的唯一凭据。**回复归属同时定案：留在资源，不独立成第四类**——它与金币同为即时兑付、判据同源，拆出去第四类只剩两项且与本类判据重合。附带修复：1.5 段末与「### 2. 渠道轴」标题粘连（缺换行）。 | | **v2.6** | 2026-10-05 | **修正核心循环位置图：奇物不是打一场战斗给一份**（用户纠错）。原图把"关内 排雷推理 → 战斗结算 → 通关 → 得到一份奇物"画成一条链，读起来就是每场战斗通关都给一份——**错在把关内普通战斗的通关与关底 Boss 的通关混为一谈**。按 [冒险结构](冒险结构.md) 的定义，**通关一关 = 该关关底 Boss 被击杀**，所以"击败 Boss"与"通过这一关"是同一个时刻、不是一条链上的两步。改法：① 图改为分支结构（普通战斗节点→不给、往下走；关底 Boss 击败→专长三选一＋通关回血）；② **一关只兑付一次**写成显式口径；③ 2.1 节渠道名由"终局前 Boss 击败后"改为"关底 Boss 击败（即通过这一关）"，并写明触发点就是关卡推进本身那一刻；④ 文首引言加"兑付频率"条，交叉表渠道名与 registry 同步；⑤ 连带修掉一处污染——节点类型封闭枚举五种里的"奖励"曾被 v2.4 批量替换误伤成"奇物"（节点类型里没有奇物这一类），已复原。 | -| **v2.7** | 2026-10-05 | **三个子节点正式定名（用户拍板：去「类」字后缀）**。此前三个分类只有带后缀的描述（机制类 / 属性提升类 / 资源类），是文档层临时叫法，既非专名也非玩家可读的词。现定专名：**专长**（Feat）/ **属性值提升**（ASI）/ **资源**。定名依据：前两个是 DND 规则书官方中文，且与用户 v1.1 原话一致（当时原话就是「属性提升（ASI）」与「专长」，v1.1 落文时被加了「类」字后缀而退化成描述）。「机制类」这个叫法本身还有硬伤——它的 28 个成员里没有一件是"机制"，实际是"在结算挂点上改一条规则"，读者看到会误解为游戏机制。 +| **v2.7** | 2026-10-05 | **三个子节点正式定名（用户拍板：去「类」字后缀）**。此前三个分类只有带后缀的描述（机制类 / 属性提升类 / 资源类），是文档层临时叫法，既非专名也非玩家可读的词。现定专名：**专长**（Feat）/ **属性值提升**（ASI）/ **资源**。定名依据：前两个是 DND 规则书官方中文，且与用户 v1.1 原话一致（当时原话就是「属性提升（ASI）」与「专长」，v1.1 写入文档时被加了「类」字后缀而退化成描述）。「机制类」这个叫法本身还有硬伤——它的 28 个成员里没有一件是"机制"，实际是"在结算挂点上改一条规则"，读者看到会误解为游戏机制。 | **新增 1.6 节「三层结构与命名」**（用户 2026-10-05 拍板做玩家可见的三层）：奇物（总称）／三个分类／具体单件。明确**命名是本节规矩、呈现是另一件事**——分类名在卡面不出现（归 battle.md / node-reward.md 裁决），但帮百科、成就名、效果描述的指代三处都要用，所以它必须是玩家读一遍就懂的正式名词。连带：修掉批量替换撞出的五处「专长（专长）」类自撞、v2.0 历史行内的自撞并标注当时的旧称、registry 的「资源（命名待定）」过期标注。 -| **v2.8** | 2026-10-06 | **效果行为数据驱动换代（内容数据驱动扩展批）**：专长的效果声明从「挂点+效果字典」换为「订阅行」——每件声明**订阅哪个事件（on）/ 什么条件（when）/ 什么效果（do）**，由效果引擎统一解释执行；旧挂点枚举消亡（事件名+效果类型取代）。配套事实：效果引擎 `game/core/effect_engine.gd`（事件 16 / 效果类型 24 / 条件事实 9 / 算子封闭词表）；专长行 `feats.tres` 27 件全量迁移，秘宝被动六件同批订阅化；行为与迁移前逐位一致（MC 同种子 40 局逐位对拍实证）。 +| **v2.8** | 2026-10-06 | **效果行为数据驱动换代（内容数据驱动扩展批）**：专长的效果声明从「挂点+效果字典」换为「订阅行」——每件声明**订阅哪个事件（on）/ 什么条件（when）/ 什么效果（do）**，由效果引擎统一解释执行；旧挂点枚举消亡（事件名+效果类型取代）。配套事实：效果引擎 `game/core/effect_engine.gd`（事件 16 / 效果类型 24 / 条件事实 9 / 算子封闭词表）；专长行 `feats.tres` 27 件全量迁移，秘宝被动六件同批订阅化；行为与迁移前逐位一致（MC 同种子 40 局逐位逐项比对实证）。 | **v2.9** | 2026-10-07 | **专长体系推倒重设计裁（用户裁——道具三层重设计·奇物层）**：专长分类的**流派标签（archetype）与档位机制（集件质变）框架级作废**——用户判流派式设计「烂到极点」，且流派标签从未被认可为呈现面概念（命名铁律：流派名禁上玩家可见面，06「内部分类禁写入玩家可见面」条升格）；现行 27 件全数待重设，重设计主权归用户，灵感原材料归调研批（design/research 两份 2026-10-07 调研）；审查「六流派档位兑付位立项」方向随档位作废注销。专长=机制改写件的分类定位、凭证/渠道机制、属性值提升与资源两分类不受影响。新增准入校验（重设计适用）：**代价与收益须同账可核算**——「纯代价件」禁止出生（深挖钻头/整备军备教训）；头部加冻结遗留态横幅。 | | **v3.0** | 2026-10-07 | **专长基础框架落地批（用户终审认同——道具三层重设计·奇物层）**：新增「专长（重设计·基础框架 v1）」节=新现行事实源——设计原则五条（触发器句式/事件族组织不上卡面/准入校验同账可核算/信息红线/防兑换环）+基础件表 18 件（开格系6/插旗系3/踩雷系3/节奏系3/战斗系3+契约尖点1；代号制命名归用户）+扩签登记（新事实候选6+停手挂点+清图事件暂缓）+老27件处置（随实装批整体替换、仅作素材库不默认继承）；横幅由「推倒重设计中」翻转「基础框架已立」；数值归调参批、实装归重设计实装批。 | -| **v3.1** | 2026-10-07 | **档位名与 rarity 语义约束随批（现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批落文）**：稀有度四级采用**普通/优秀/稀有/传说**——本层旧三档名映射=普通→普通、稀有→优秀、罕见→稀有，第四级「传说」=新增头奖位（正文档名扫改归奇物批次）；**专长 rarity 语义约束落为文档约束**——Boss 三选一候选按档配比或加权抽取（双脱钩修复：此前 rarity 不影响抽选也不稳代表幅度；配比数值归调参批，MC「最稀有优先」策略的读数偏颇随实装一并校正）；「获取概率提升不动保底」护栏同批。 | -| **v3.2** | 2026-10-07 | **资源分类基础框架落地批（五件新凭证用户裁准——道具三层重设计·奇物层）**：新增「资源（重设计·基础框架 v1）」节=新现行事实源——定义句重写为**转换源**（成员=到手即结算成独立资源/系统数值的凭证，加完消尽，账各有寿命档）+凭证件表新 5 留任 2（刷新券/储备金袋RAP/同调电池/时沙/完美保险+小金币袋/应急口粮；代号制命名归用户，稀有度档配额面值归调参批）+上架原则（默认原则全渠道可出）；§1.3 判据句与异质性节随迁重写（凭证全部即时消尽，异质性=账的寿命不在凭证上）；池子档位形态（各档装什么）待用户裁后随批 | -| **v3.3** | 2026-10-07 | **池结构与抽取落文（用户裁案D——归档打底做翼+曝光槽，道具三层重设计·奇物层）**：新增「池结构与抽取（重设计 v1）」节——令牌=出现次数上限明文化（拿消耗/没拿回池/刷新不消耗，「只刷出没拿」不计次，TP0 语义沿用）；内容归档=普通档面粉打底、优秀/稀有档功能凭证做翼、传说档惊喜位（按决策影响力归档不按数值）；曝光槽=三选一 2 格全池+1 格「优秀档以上」子池（子池空回退全池，池空直通同族）；凭证维持独立计数体系不进子池；配额改动须用户重裁（TP0 结构锚非调参）；MC 策略读数影响随实装复核 | +| **v3.1** | 2026-10-07 | **档位名与 rarity 语义约束顺带（现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批写入文档）**：稀有度四级采用**普通/优秀/稀有/传说**——本层旧三档名映射=普通→普通、稀有→优秀、罕见→稀有，第四级「传说」=新增头奖位（正文档名扫改归奇物批次）；**专长 rarity 语义约束落为文档约束**——Boss 三选一候选按档配比或加权抽取（双脱钩修复：此前 rarity 不影响抽选也不稳代表幅度；配比数值归调参批，MC「最稀有优先」策略的读数偏颇随实装一并校正）；「获取概率提升不动保底」护栏同批。 | +| **v3.2** | 2026-10-07 | **资源分类基础框架落地批（五件新凭证用户裁准——道具三层重设计·奇物层）**：新增「资源（重设计·基础框架 v1）」节=新现行事实源——定义句重写为**转换源**（成员=到手即结算成独立资源/系统数值的凭证，加完消尽，账各有寿命档）+凭证件表新 5 留任 2（刷新券/储备金袋RAP/同调电池/时沙/完美保险+小金币袋/应急口粮；代号制命名归用户，稀有度档配额面值归调参批）+上架原则（默认原则全渠道可出）；§1.3 判据句与异质性节随迁重写（凭证全部即时消尽，异质性=账的寿命不在凭证上）；池子档位形态（各档装什么）待用户裁后顺带 | +| **v3.3** | 2026-10-07 | **池结构与抽取写入文档（用户裁案D——归档打底做翼+曝光槽，道具三层重设计·奇物层）**：新增「池结构与抽取（重设计 v1）」节——令牌=出现次数上限明文化（拿消耗/没拿回池/刷新不消耗，「只刷出没拿」不计次，TP0 语义沿用）；内容归档=普通档面粉打底、优秀/稀有档功能凭证做翼、传说档惊喜位（按决策影响力归档不按数值）；曝光槽=三选一 2 格全池+1 格「优秀档以上」子池（子池空回退全池，池空直通同族）；凭证维持独立计数体系不进子池；配额改动须用户重裁（TP0 结构锚非调参）；MC 策略读数影响随实装复核 | | **v3.4** | 2026-10-07 | **概率与上限解耦约束+耦合问题登记（用户指出的令牌模型冲突——道具三层重设计·奇物层）**：池结构节补两条——①**概率与上限解耦**（设计约束，新内容必检：概率位与已拿上限=两个独立字段，拿了才计/刷出不计，互不决定）；②已知耦合问题与实现路径候选三案登记（令牌 N 张同时承担概率与上限不可独立设定——抽象权重表+独立计数器/令牌池+提前退役计数器/维持耦合已否；选型归实装批，影响面=MC 对账与断点存档）。用户裁：实现设计不定于现在，只落约束与问题点防后续撞车 | | **v3.5** | 2026-10-07 | **秘宝域迁出两件迁入登记（用户裁——秘宝层归留裁决同批）**：淬毒刃纹→战斗系克制向（`on attack_commit + advantageous → 追加 +N`）；标中殉爆→插旗系（`on flag_hit → 全体存活敌 N 群伤`，插旗系补第 4 件；数值均归调参批）；惊巢反制→退役进素材库（归[秘宝](../跨局循环/秘宝.md)速览「目录处置」同批）；实装批执行数据迁移 treasure→feats 并补入件表 | | **v3.6** | 2026-10-09 | **旧条例外科摘除批（用户令——流派方向讨论中暴露的活矛盾）**：①分类表专长行、§1.1、生命周期表、P1 后置四处「流派标签·集件档位质变」残句摘除——v2.9 已框架级作废，残句以正文规则身份存活、持续误导设计（「战斗系占比须治理」伪问题即其衍生）；②验收标准第 4 条 B1 铁律（每流派标签 ≥1 件挂排雷侧触发点）作废，替换为条件判据「收益必挂条件、无条件数值归属性值提升」（用户同日讯：纯属性增加不是专长，通过条件获得数值才是专长要做的）；③待办两条（档位阈值匹配复裁 / charge 标签缺陷）因对象消亡注销。未动：冻结遗留（老 27 件清单与战斗结算侧现行代码行为描述）仍随重设计实装批整体替换；06-待办清单内三处描述性残留（BD 分层条目现状文 / charge 条 / 档位呈现裁点）归 06 条目自身生命周期，另行列出。 | | **v3.7** | 2026-10-09 | **去毒批（用户立「文档去毒」为首要任务）**：退役术语魔法道具→秘宝（正文各处，含关联边界表）/档名三档→四级扫改（罕见→稀有）/凭证与刷新入表状态订正（迭代15② 已入库，调参表与 P1 与待办节同步）/资源成员指路凭证件表/验收第 3 条改令牌口径——新老框架分家第一步，老章节冻结段随实装批整体替换不变。 | | **v3.8** | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①§1.6 命名节例子「同标签达到 4 件时质变」摘除（流派标签集件档位 v2.9 已框架级作废，换为不引退役机制的归类指代例）；②渠道轴交叉表专长行自撞「专长（专长）」修为「专长」（v2.7 同类自撞漏网）；③§2.4 回复节现状句订正——shop.tres pool_shelf 六行已含回复（迭代15② 落地，默认原则对齐），「货架四项、回复缺席须补上」过期表述替换；④§2.5 在册事项订正——凭证形式已随迭代15② 入表实装，渠道分工仅 Boss 渠道直接给专长仍为目标状态；⑤生命周期表选定行老规则「选定即从池中剔除、任何渠道不再见」改令牌口径（拿消耗、刷出不计、耗尽不再出现——对齐验收第 3 条与 TP0 在役语义）；⑥依赖与输出表摘除「档位求值结果」（集件档位作废的漏网输出）；⑦§1.2 补成员变动在途注（行动点上限归属性值提升轴，在役仍三项、迁动归实装批——对齐 §1.3 表下现行事实源注）。 | -| **v3.9** | 2026-10-09 | **B3/B4 两裁落文（用户令）**：①P1 后置「两项合成高阶项」注销——非用户设计意图的脏信息，合成方向若需要按新体系重新生一件；②§3 刷新次数例外句口径换代——一律按最新设计口径：刷新次数由刷新券替代（凭证到手即结算进刷新存量账、加完消尽不进持有集），旧「进同一份持有账本」表述作废、随实装批整节删除 | +| **v3.9** | 2026-10-09 | **B3/B4 两裁写入文档（用户令）**：①P1 后置「两项合成高阶项」注销——非用户设计意图的脏信息，合成方向若需要按新体系重新生一件；②§3 刷新次数例外句口径换代——一律按最新设计口径：刷新次数由刷新券替代（凭证到手即结算进刷新存量账、加完消尽不进持有集），旧「进同一份持有账本」表述作废、随实装批整节删除 | | **v3.10** | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：①§1.3 异质性节「被写入的账」清单对齐凭证件表——旧四项时代「AP 上限」摘除（已归属性值提升轴，§1.2 在途注），补生命账/秘宝充能两账；②依赖与输出表 `relics.tres` 改 `feats.tres`（表文件已随词族对齐批换代，data/tables/ 无 relics.tres——代码实证） | | **v3.11** | 2026-10-10 | **正文换代批（方案甲，用户裁「旧的删、误标改」——同秘宝.md v2.2 同法）**：①头部冻结横幅摘除——所指「流派/档位/27 件清单」旧章节正文已不存在，名单承载=[道具退役素材库](../../../research/道具退役素材库.md)表二；②专长/资源两节引言去「冻结遗留态/随实装批整体替换」错标，各落一句「新框架实装批落地前，现役代码按同框架运行」；③§1.3 旧资源四项枚举表删除（成员去向一行交代：行动点上限归属性值提升轴/刷新次数由刷新券替代/金币回复留任为小金币袋/应急口粮），回复归属裁定并入「资源为什么单独成一类」段；④§1.2 在途注与 §3 刷新例外去标注改正文（行动点上限归本轴/刷新券口径一律按最新设计）；⑤§1.6 单件举例换新框架件（奥术余烬/贯穿射击→双管镐/疼痛记忆）；⑥「谓词」用词清除——「可计算谓词」改「可计算条件」（正文与验收，版本历史行引述豁免）；⑦验收 4/7/8/9 换代新口径+尾部现役代码运行线；⑧P1/P2 括注清算（已清偿/已注销条目由版本历史承载）+待办节收编为 06 单点指针。真旧内容承载=素材库表二+git 历史 | -| **v3.12** | 2026-10-11 | **自爆流扩容批（用户逐裁——踩雷系从被动补偿转主动输出循环）**：踩雷/受伤系 3→7——新增爆芯（踩雷→本轮攻击 +N，走面板乘区）/连爆（同轮多雷递进加层，与疼痛记忆 combo 涌现）/爆心冲击（踩雷→全体敌 雷伤×倍率 直伤，倍率 >1 结构锚——「角色与怪物互相吃伤害」系用户形态本体：开安全格零代价、引爆有代价故回报须更高）/雷蜜（踩雷→回复 N，比值 <1 结构锚）；新增跨族桥引信标定（挖开有旗危险格→+1 层——旗=标定引信、挖=引爆，插旗×踩雷推理闭环）；扩签登记 +3（本轮踩雷数计数器/被挖格当时有旗/雷罚伤害量）；**踩雷转化对账锚**随批登记（净血账期望须为负，两轮压不住砍血蜜——喂雷流 R5 甲教训同源的 kill-switch）；用户裁定：主动/误踩不判定（不预判玩家意图，拿件自选收益最高操作）、爆芯走面板、爆心冲击按倍率非折扣；防御向两件（保险丝/安全帽）保留不动——双刃剑两刃相辅相成；附带修正基础件表战斗系计数 3→2（v3.0 起表头与行数不符），件表总 18→23 | +| **v3.12** | 2026-10-11 | **自爆流扩容批（用户逐裁——踩雷系从被动补偿转主动输出循环）**：踩雷/受伤系 3→7——新增爆芯（踩雷→本轮攻击 +N，走面板乘区）/连爆（同轮多雷递进加层，与疼痛记忆 combo 涌现）/爆心冲击（踩雷→全体敌 雷伤×倍率 直伤，倍率 >1 结构锚——「角色与怪物互相吃伤害」系用户形态本体：开安全格零代价、引爆有代价故回报须更高）/雷蜜（踩雷→回复 N，比值 <1 结构锚）；新增跨族桥引信标定（挖开有旗危险格→+1 层——旗=标定引信、挖=引爆，插旗×踩雷推理闭环）；扩签登记 +3（本轮踩雷数计数器/被挖格当时有旗/雷罚伤害量）；**踩雷转化对账锚**顺带登记（净血账期望须为负，两轮压不住砍血蜜——喂雷流 R5 甲教训同源的 kill-switch）；用户裁定：主动/误踩不判定（不预判玩家意图，拿件自选收益最高操作）、爆芯走面板、爆心冲击按倍率非折扣；防御向两件（保险丝/安全帽）保留不动——双刃剑两刃相辅相成；附带修正基础件表战斗系计数 3→2（v3.0 起表头与行数不符），件表总 18→23 | | **v3.13** | 2026-10-11 | **生存件扩容批（用户令「增加生存类的个数」——四类盘点呈报后逐裁）**：件表 23→27——①石肤（on 受伤：AC +1 本场累计上限 M）入踩雷/受伤系——恒定减伤形态被否（用户裁「太硬霸」），改受击成长型护甲；②背水（when 生命 ≤50%：受伤额外 −N）入踩雷/受伤系——风险联动减伤，低血不再是纯劣势；生命比例条件事实系其实现前置需求，用户批扩签+待办登记 06；③铁旗（on 标中：本轮 AC +N）入插旗系——生存奖励挂正确推理，与旗语回响共享事件；④战地包扎（on 战斗胜利：回复 N）入战斗系——战后通用恢复，补「恢复只服务自爆流」缺口。四类占比换代：减伤 2（安全帽/背水）/护甲 3（保险丝/石肤/铁旗）/恢复 2（雷蜜/战地包扎）对增伤 8 ≈ 1:1；用户口径订正=保险丝护盾归提升护甲类（AC 判定）、减伤专指受击直接扣减伤害 | -| **v3.14** | 2026-10-11 | **实装前置两项裁定落文（用户裁）**：①§2.5——Boss 渠道直接给专长（主渠道、唯一直接渠道）**已裁随专长实装批本批落地不再分期**；②§2.5 新增池结构选型澄清——池结构正主=案 D（v3.3 用户定夺在案：归档打底做翼+曝光槽 2+1+令牌=出现次数上限），「概率与上限解耦」实现路径（v3.4 在册三案）系**实装侧自选项非用户裁定项**（原裁定「实现设计不定于现在」=实装批内依代码事实自选不再上问）——成因=会话误将实装侧自选升级为用户裁定项重问已定夺事项，经历史记录（2026-10-07 讨论记忆+TP0 令牌池天然兼顾核实结论）找回定夺后澄清；06 渠道分工条状态行随批同步 | +| **v3.14** | 2026-10-11 | **实装前置两项裁定写入文档（用户裁）**：①§2.5——Boss 渠道直接给专长（主渠道、唯一直接渠道）**已裁随专长实装批本批落地不再分期**；②§2.5 新增池结构选型澄清——池结构正主=案 D（v3.3 用户定夺在案：归档打底做翼+曝光槽 2+1+令牌=出现次数上限），「概率与上限解耦」实现路径（v3.4 在册三案）系**实装侧自选项非用户裁定项**（原裁定「实现设计不定于现在」=实装批内依代码事实自选不再上问）——成因=会话误将实装侧自选升级为用户裁定项重问已定夺事项，经历史记录（2026-10-07 讨论记忆+TP0 令牌池天然兼顾核实结论）找回定夺后澄清；06 渠道分工条状态行顺带同步 | | **v3.15** | 2026-10-11 | **专长件第一版命名批（用户裁——对外命名纪律：无「雷」无「插旗」，插旗对外=封印、危险格对外风味=地下城陷阱/怪物巢穴；「扫雷插旗」系内部开发用语、对外=探索/挖掘地下城）**：九件代号换代——插旗系：旗语回响→**封印回响**/猎旗手→**封印匠**/铁旗→**封印桩**；踩雷/受伤系：爆芯→**陷阱本能**/连爆→**连环陷阱**/爆心冲击→**陷阱爆发**/雷蜜→**血蜜**；跨族桥：引信标定→**破封一击**；迁入登记：标中殉爆→**封印爆裂**；示警烟火/疼痛记忆/保险丝/见血开窍/石肤/背水/爆破会计等保留（无雷/旗字）；纪律登记=术语表新增「对外命名纪律」节（v1.6）；版本历史行引用旧代号系留痕不动；命名纪律试例=件名，后续全部对外命名（显示名/UI 文案）同尺 | | **v3.16** | 2026-10-12 | **迭代 20 反哺落文批（用户令「先回写 GDD」——追认单①裁决齐，06 追认结果条承载裁决记录）**：①设计原则新增**落行注记**：「每第 N 次/积满触发」预评估落行=N−1（when 先于 do 读计数器现值，例：地质学家 eq 3/封印匠 mod_eq ref 2）；②疼痛记忆件表「下场战斗」→「下一次攻击」（2026-10-12 用户定性笔误，无需 battle-gate 面）；③弃图兑换落法回写=停手后首次攻击全额附加、用后清零、多攻击不拆分；④血税件表补生效时点（均**下一战起生效**——战末汇入冒险加算区，战界重建契约所致滞后一战）+账列换代双向同账细则；⑤时沙落法回写=下一战首轮 AP 队列兑付（hero_ap_bonus 既有通道），§1.3 判据句与异质性账清单「当前 AP=回合级」随迁「时沙挂账=至下一战首轮兑付」；⑥扩签登记节换代为实装承载记录（10 候选=6 fact+4 计数器改道/dig_stop 落/battle_won+mod_eq+hp_ratio 等随裁补位/新效果类型 7/rewrite_board 除名、清图事件继续暂缓）；⑦专长/资源两节引言「新框架实装批落地前」过渡句随批落地 expiry 换代（29 行=基础 27+迁入 2/凭证新 5+留任 2 已落表）；⑧流派口径澄清落档=**对外永不显示、对内保留事件族五系划分**（v2.9 作废所指=流派作玩法机制非对内划分本身，2026-10-12 用户重申——设计原则第 2 条原文已符，正文零改动）；待办=血税卡面 desc（feats.tres）补「下一战起生效」系代码侧一行改，另行小批 | | **v3.17** | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 7 处**——「不得」→「禁止」3 处（信息红线条、代码词族 reward_* 句、验收第 6 条）；「若干」→写具体数值 2 处（核心循环位置图「三关串联」、生命周期表出现行「3 个候选」）；「收口」改写 2 处（§1.3 判据句「收口凭据」→「界定凭据」、§2.1 悬案句→「完成裁决」）。机制与数值零改动 | diff --git a/design/gdd/systems/冒险循环/难度曲线与Boss.md b/design/gdd/systems/冒险循环/难度曲线与Boss.md index 2dd2aabe..727b009a 100644 --- a/design/gdd/systems/冒险循环/难度曲线与Boss.md +++ b/design/gdd/systems/冒险循环/难度曲线与Boss.md @@ -54,7 +54,7 @@ | 轴 | 规则 | 说明 | |---|---|---| | 关间台阶（关卡序号） | 每关至少投放一项新内容（新敌种或既有池新技能），加基准数值跳升 | 台阶必须能归因到看得见的变化，不是纯数字膨胀；投放断档是内容生产缺口，调参修补不了（技能池批措辞修订 2026-09-16：行为环段 → 既有池新技能） | -| 关内坡度（节点深度） | 同敌种数值平缓上移，深度也可表达为敌人成群 | 数量是比单体质变更优先的深度表达：保持技能池 EV 读数不变（权重即旋钮、EV 重锚随批登记）、总量受控 | +| 关内坡度（节点深度） | 同敌种数值平缓上移，深度也可表达为敌人成群 | 数量是比单体质变更优先的深度表达：保持技能池 EV 读数不变（权重即旋钮、EV 重锚顺带登记）、总量受控 | | Boss 与精英修饰（预留第三轴） | Boss 走最深深度直填行；精英只有字段命名空间预留 | Boss 不走修饰表；修饰乘数表 MVP 为空表、零行为，首个使用场景 = 精英节点（随[关卡节点地图](关卡节点地图.md)定稿联动）；数值所有权在本系统，[棋盘生成](../排雷循环/棋盘生成.md)只按表生成。精英怪设定已登记预留（迭代 10 奖励重构批——与其他普通小怪同一立绘 + 附加特征标记 + 数值更强；视觉特征三件 = 名称前后缀「精英·」+ 底座光环 + 描边变色，色板合规与样张闸义务随怪物设定批实装） | **结论**：关内坡度 = 每深一档同敌种基准上移，或按"深度也可表达为敌人成群"改由数量承载——单体生命随深度的具体走向以 `enemy.tres` 行值为准（数量优先于单体；s_hp 线性式为建模工具，现行行值不承诺随深度单调上移）；关间台阶 = 相邻关同敌种基准乘 1.3–1.6（域语义如上；s_hp / k_L 现行行值读 `enemy.tres`，域登记见 registry）。 @@ -111,7 +111,7 @@ MVP 行值并不逐式现算，而是按此式量级直填经切片验证过的 | 带 | 定稿口径 | 含义 | |---|---|---| -| 通关率带 | 口径已换代·现行带 = 四带甲案（2026-10-03 用户拍板）：带 A 白板完美执行战役全通率 [0%,10%] / 带 B 白板第一关通过率 [50%,85%] / 带 C 营地满成长战役全通率 [30%,60%]（预立） / 带 D 响应曲线每雷边际 ≤15pp·S 形——旧普通档 L1 [35,55] / L2 [10,15] 与完美档 [35,65] 正式作废，全文见本节末「带换代」条。实证：直入口 L2 普通 5% vs 冒险条件口径 L2 90% 同期并存〔「营地检查点」= balance_verifier 营地循环判定段旧称（现名营地循环战役）——2026-09-30 词源考证收口，见审计报告 git 提交 c095916 拍板点 9（已按生命周期条款退役）；与冒险结构「没有检查点」铁律的字面相撞就此解除〕 | 四带按类型基准锚定、每条带均有外部锚点：带 B 管首关 = 过滤器不是墙；带 A 管白板全通的顶尖难度；带 C 留元进度爬升空间（满成长实装后启用）；带 D 管响应曲线无悬崖 | +| 通关率带 | 口径已换代·现行带 = 四带甲案（2026-10-03 用户拍板）：带 A 白板完美执行战役全通率 [0%,10%] / 带 B 白板第一关通过率 [50%,85%] / 带 C 营地满成长战役全通率 [30%,60%]（预立） / 带 D 响应曲线每雷边际 ≤15pp·S 形——旧普通档 L1 [35,55] / L2 [10,15] 与完美档 [35,65] 正式作废，全文见本节末「带换代」条。实证：直入口 L2 普通 5% vs 冒险条件口径 L2 90% 同期并存〔「营地检查点」= balance_verifier 营地循环判定段旧称（现名营地循环战役）——2026-09-30 词源考证完成，见审计报告 git 提交 c095916 拍板点 9（已按生命周期条款退役）；与冒险结构「没有检查点」铁律的字面相撞就此解除〕 | 四带按类型基准锚定、每条带均有外部锚点：带 B 管首关 = 过滤器不是墙；带 A 管白板全通的顶尖难度；带 C 留元进度爬升空间（满成长实装后启用）；带 D 管响应曲线无悬崖 | | 通关余量带 | 通关者通关时剩余生命的 p90 / p10 按现生命轴上限百分比表达（压缩前绝对血量带已作废；界值重标随验收批） | **通关余量** = 通关瞬间还剩多少血。余量太肥说明赢得太从容，压生存侧；太瘦说明"剩一两滴血惨胜"成常态，抬治疗供给或恢复点收益 | | 第一关形态带 | 教学位绿档 + 中段黄档 + Boss 黄档不红 | **形态带**管一关内各战三档判定的排布形状：第一战必须稳过，中段有输的可能，Boss 战紧但不许是配置事故 | @@ -121,11 +121,11 @@ MVP 行值并不逐式现算，而是按此式量级直填经切片验证过的 **迭代 20 投放读数（只测不判——2026-10-12 反哺批登记，用户裁③数值暂不调整只落内容）**：奇物池换代后构成 = 四级 70/25/9/0=104 张（凭证四件入稀有档 +6 张 provisional）；MC shop=off 止步分布 {1:90, 2:10}→{1:93, 2:7}（通关率 0% 两代持平，新基线 seed 71000）——位移归因曝光槽高档候选加速（[奇物](奇物.md)池结构联动注记的预期行为，非难度恶化信号）；判读与带重锚随曲线调参批，本注记只登记不判读。 -**迭代 24 敌人表内容修批读数（只测不判——2026-10-14 反哺落文批登记，用户裁「全部按呈报落文」；数值终值归 M4 数值批）**：同种子配对 seed0=9000（沿用迭代 23 配对种子）改前/改后各 40 局×both——①**N2 普通敌技能投放**（毒吐/盾击两新行六池）后 perfect L2 通关 8/20→13/20（+25pp）、L3 全通 6/20→10/20（+20pp）——方向符合预期（L1 减压后更健康抵达 L2/L3），量级低于二档配对判读带 ~30pp，倍率 provisional 归 M4；normal 档基率地板（0/20）无判读力；②**N3 敌方攻击类型轴**（20 行全填 normal+敌方兑付路径克制消费）后全局平移 = 主角穿重甲受伤点数 −1 / 魔法护甲 +1 / 轻甲 0（V5 冒烟同种子三甲型配对实测单发恒 ±1：heavy 2==light 3−1 · ward 4==light 3+1）；taken 中位 normal 29.5→27.5、perfect 76.5→97.0——后者系**构成效应**（全通 6→10 局通关更深自然累计更多承伤），非单发异常；③N1 (1,2) 降档（hp 50→22·ac 3→2）后 perfect L1 通关 19/20→20/20——5 倍墙消除方向符合预期。判读与带重锚随 M4 数值批，本注记只登记不判读。 +**迭代 24 敌人表内容修批读数（只测不判——2026-10-14 反哺写入批登记，用户裁「全部按呈报写入文档」；数值终值归 M4 数值批）**：同种子配对 seed0=9000（沿用迭代 23 配对种子）改前/改后各 40 局×both——①**N2 普通敌技能投放**（毒吐/盾击两新行六池）后 perfect L2 通关 8/20→13/20（+25pp）、L3 全通 6/20→10/20（+20pp）——方向符合预期（L1 减压后更健康抵达 L2/L3），量级低于二档配对判读带 ~30pp，倍率 provisional 归 M4；normal 档基率地板（0/20）无判读力；②**N3 敌方攻击类型轴**（20 行全填 normal+敌方兑付路径克制消费）后全局平移 = 主角穿重甲受伤点数 −1 / 魔法护甲 +1 / 轻甲 0（V5 冒烟同种子三甲型配对实测单发恒 ±1：heavy 2==light 3−1 · ward 4==light 3+1）；taken 中位 normal 29.5→27.5、perfect 76.5→97.0——后者系**构成效应**（全通 6→10 局通关更深自然累计更多承伤），非单发异常；③N1 (1,2) 降档（hp 50→22·ac 3→2）后 perfect L1 通关 19/20→20/20——5 倍墙消除方向符合预期。判读与带重锚随 M4 数值批，本注记只登记不判读。 **判读口径同步（迭代 5 基线重测批，2026-09-28）**：通关率带的测量口径 = 冒险条件通关率（打通 k−1 关才到达第 k 关，balance_verifier 冒险段派生；单关直入口口径已随 2026-09-23 拍板退役）——带值沿用 2026-09-20 分带修正（普通档 L1 [35,55] / L2 [25,45]、完美档 [35,65]；迭代 5 计划书 C4 冻结：改带=用户拍板）。上方行 115 的「带退役待重锚、重锚前只测不判」注记按本条同步理解：迭代 5 基线重测已按现行带对冒险条件口径判读（读数报告见 git 提交 e55dc10,已按生命周期条款退役）；是否在新口径上重取带值，归迭代 5 出口判读由用户拍板，本批不动带数字。 -> **⚠ 带失效待重锚（2026-10-01 数值修复批）**：模拟档位重构（普通档 v2 新手画像→v3=完美策略+受控失误注入；完美档补元游戏选路与商店购买）+数值三刀（hero max_hp 20→26/直伤雷 4/5/5→6/8/8/L1 系敌 atk 2→1）后，上方三条验收带的测量基准已失义——旧普通档=比真人弱 20 倍的新手画像（真人实证推翻），旧带值系照坏尺子校定。新尺读数（N=100/200）与调优轨迹见 `数值修复批读数（已退役，git 历史可查）`；~~新带值须新尺重测后用户拍板，重锚前只测不判~~（已由下行带换代收口）。 +> **⚠ 带失效待重锚（2026-10-01 数值修复批）**：模拟档位重构（普通档 v2 新手画像→v3=完美策略+受控失误注入；完美档补元游戏选路与商店购买）+数值三刀（hero max_hp 20→26/直伤雷 4/5/5→6/8/8/L1 系敌 atk 2→1）后，上方三条验收带的测量基准已失义——旧普通档=比真人弱 20 倍的新手画像（真人实证推翻），旧带值系照坏尺子校定。新尺读数（N=100/200）与调优轨迹见 `数值修复批读数（已退役，git 历史可查）`；~~新带值须新尺重测后用户拍板，重锚前只测不判~~（已由下行带换代完成）。 **带换代（迭代 9 出口带值批，2026-10-03 用户拍板四带甲案）**：旧三条通关率带（普通 L1 [35,55] / L2 [10,15]、完美 [35,65]）**正式作废**，换类型基准锚定四带（依据与官方统计出处=《[Roguelike 难度类型基准](难度外部基准调研（已退役，git 历史可查）)》§3.2，每条带均有外部锚点）： @@ -138,7 +138,7 @@ MVP 行值并不逐式现算，而是按此式量级直填经切片验证过的 配套裁决（同日逐项拍板）：普通档 v3.4 **留任失败常态窗**（只记读数不设带，验收只看带 A/带 B+真人侧）；直伤雷当量 **6/8/8 转正**（去 provisional）；模拟承伤 k 系数保留（k=真人整关承伤中位÷模拟完美档承伤中位，**正常预期 >0.5（用户裁）、预警线 <0.3**，字段随 81000 重锚入库后补算）。**位阶事实**：现行完美档 78.5% 落带 A 外（越上界 68.5pp）、普通档 L1 13% 落带 B 外——落带收敛归全局难度批（Beta 阶段，未排期；排序先带 D 悬崖修复后带值收敛，顺序有讲究），81000 重锚只测不判。 -**改带（迭代 5 返工出口收口批，2026-09-30 用户拍板）**：普通档 L2 带 [25,45] → **[10,15]**（用户裁：数值没有问题、本来就应该通关率很低，之前的 25~45 设定上就有问题）——返工批终态双窗读数 10.6%（MC）/13.6%（verifier）在新带下落带，返工计划书批点丙追认成立，C1 两刀+AC v1+新池组合基线转正（去 provisional）。普通档 L1 [35,55]、完美档 [35,65] 不动。历史读数报告中的 [25,45] 判列系当时口径留档不改。 +**改带（迭代 5 返工出口完成批，2026-09-30 用户拍板）**：普通档 L2 带 [25,45] → **[10,15]**（用户裁：数值没有问题、本来就应该通关率很低，之前的 25~45 设定上就有问题）——返工批终态双窗读数 10.6%（MC）/13.6%（verifier）在新带下落带，返工计划书批点丙追认成立，C1 两刀+AC v1+新池组合基线转正（去 provisional）。普通档 L1 [35,55]、完美档 [35,65] 不动。历史读数报告中的 [25,45] 判列系当时口径留档不改。 ### 越带回滚阶梯（四级阶梯，2026-09-28 落档——自 acceptance-ap6-ac v1.0 §e 收编） @@ -175,7 +175,7 @@ GP（显示名「金币」）与商店房随 2026-09-20 GP+商店房批落地， 公式语义与钱包账本归[冒险结构](冒险结构.md)（GP 冒险账本节），商店房编排归[关卡节点地图](关卡节点地图.md)；行值读 `data/tables/shop.tres`（registry 为准），全部 provisional 归本文曲线调参批。 -**分层验收 defer（2026-09-20 用户拍板成文）**：按"商店存在与否"分层的通关率验收——MC 双格（shop=off 现行基线 / shop=on 购买画像）、shop=on 的带平移量、商店属性提升的换算率登记（换算率强条目纪律同类）——**全部随曲线调参批执行**，与「基线通关率越带」同窗（原「L2 Boss 承伤微越带」「大奖励数值随难度曲线联动」两 06 条目已收口移除——前者 2026-09-28 读数自愈、后者随迭代 10 大奖励退役失义）。执行前 shop=off 续用现行带判读，shop=on 读数只登记不判读、不得用 shop=off 读数外推 shop=on。L3 首遇绿档冒烟断言仍按成长代理档口径，不因商店批改判。**v0.22 注记（迭代 11 第②批）**：shop=off 对照 = legacy 固定三件模式（MC 对拍 off_n60 逐位，迭代 11 第②批 T5）；shop=on 首锚 = 共享池货架面 N=60 双策略（`runsum_m4iter11b_t5shopon_n60_20261003.jsonl`，attune=off 同种子配对）——带平移判读仍归调参批，终局池读数（pool_stock）随行只测不判。 +**分层验收 defer（2026-09-20 用户拍板成文）**：按"商店存在与否"分层的通关率验收——MC 双格（shop=off 现行基线 / shop=on 购买画像）、shop=on 的带平移量、商店属性提升的换算率登记（换算率强条目纪律同类）——**全部随曲线调参批执行**，与「基线通关率越带」同窗（原「L2 Boss 承伤微越带」「大奖励数值随难度曲线联动」两 06 条目已完成移除——前者 2026-09-28 读数自愈、后者随迭代 10 大奖励退役失义）。执行前 shop=off 续用现行带判读，shop=on 读数只登记不判读、禁止用 shop=off 读数外推 shop=on。L3 首遇绿档冒烟断言仍按成长代理档口径，不因商店批改判。**v0.22 注记（迭代 11 第②批）**：shop=off 对照 = legacy 固定三件模式（MC 逐项比对 off_n60 逐位，迭代 11 第②批 T5）；shop=on 首锚 = 共享池货架面 N=60 双策略（`runsum_m4iter11b_t5shopon_n60_20261003.jsonl`，attune=off 同种子配对）——带平移判读仍归调参批，终局池读数（pool_stock）随行只测不判。 ### Boss 设计：食人魔酋长与关底血量锚 @@ -218,13 +218,13 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板 | 护甲等级 ↔ 攻击基线 ↔ 区间带宽 | [战斗结算](../战斗循环/战斗结算.md) | 敌种与主角的护甲等级行值变更须复算生存链区间（掷点带宽随折扣档位与攻击基线同向放大）；掷点形式与档位已定稿（d20 三档——档位读 `settlement.tres`；nat20 暴击形式留档，倍率同表），护甲等级行值变更仍须复算生存链区间并同步 registry——现行行值读 `hero.tres` / `enemy.tres` 的 armor_class 列（均暂定），敌方正式行值随怪物设定批投值、与加难杠杆扫描合并调 | | GP 供给 ↔ 商品定价 | [冒险结构](冒险结构.md)、[关卡节点地图](关卡节点地图.md) | 供给 × 定价 = 入关属性参数，单边移动须复算分层通关率带（商店与 GP 经济杠杆节）——动供给必复算分层带，禁独立调参 | | 旗溢价系数 δ ↔ 完美乘数 p_perfect ↔ ap_per_round | [战斗结算](../战斗循环/战斗结算.md)、[行动经济](../排雷循环/行动经济.md) | 旗激励三件套同窗检算（防标旗 rush 复发：δ 与 ×2 叠加通胀、AP 吞吐上限）——任一变动须重跑双画像标旗率读数（2026-10-05 判式换代批新增） | -| η 读数 ↔ 模拟画像定义 ↔ 可推理率 ι ↔ min_safe_count/生成尝试上限 | sim 档位、[棋盘生成](../排雷循环/棋盘生成.md) | η 是画像条件量：画像重构即锚漂移，重锚随批；可推理率三元组既有联动扩一员（2026-10-05 判式换代批新增） | +| η 读数 ↔ 模拟画像定义 ↔ 可推理率 ι ↔ min_safe_count/生成尝试上限 | sim 档位、[棋盘生成](../排雷循环/棋盘生成.md) | η 是画像条件量：画像重构即锚漂移，重锚顺带；可推理率三元组既有联动扩一员（2026-10-05 判式换代批新增） | | β 带端点 β_lo/β_hi ↔ D_ref ↔ hero max_hp ↔ AC 折算档（5pp 系数） | [战斗结算](../战斗循环/战斗结算.md) | 带是 D_ref 的函数：换锚（D_ref/max_hp）须全带重推；AC 档值变更改 5pp 系数，同罪（2026-10-05 判式换代批新增） | | 直伤雷三行（6/8/8） ↔ 正向同轴行（heal_minor/pierce_strike/magic_bolt） | [地图战斗资源](../战斗循环/地图战斗资源.md) | **同轴镜像比入对账面**：负向/正向比超出 β 带内推导区间即越带；单边动负向三行今后必须带正向镜像行联合检算（2026-10-05 判式换代批新增——d70f6c3/数值修复批两先例的单边动教训成文） | | clear_blast 区间（24/40/32） ↔ p_perfect | [地图战斗资源](../战斗循环/地图战斗资源.md) | 完美排雷第二份的补贴基数进旗激励对账；单边动清图奖励 = 变相动旗（2026-10-05 判式换代批新增） | | 标中强化池权重 ↔ 正向池权重（77 分母） ↔ 关级恒等式奖励占比 [15,40%] | [地图战斗资源](../战斗循环/地图战斗资源.md) | 形态 (b) 专属池重摇启用时生效（现行不启）：双池分布变动 = E_dig 与 W 同时漂移，须联合检算 + 恒等式占比复核（2026-10-05 判式换代批新增，条件生效行） | -五条经济契约的对账由[战斗结算](../战斗循环/战斗结算.md)闭合验收；挖掘风险不等式已于 2026-10-05 判式换代批重立（三层口径+β 带+条件二旗溢价——结构层接替与数值层带判读详见行动经济 F1 条款3 推导节），本系统的对账义务转为按 β 带逐 u 检算（常设重跑入口 `tools/clear_dominance_audit.py`，现行 u=3 β=1.17 微破下限登记态）；清图支配性已于 2026-09-19 按现行值链重跑、裁决②"非支配设计态"维持（回执见 git 提交 2ca3e20,报告已退役）——判式换代后的全套判值重跑随本系统下一次调参批随批执行。完美排雷乘数的调参权在本系统。 +五条经济契约的对账由[战斗结算](../战斗循环/战斗结算.md)闭合验收；挖掘风险不等式已于 2026-10-05 判式换代批重立（三层口径+β 带+条件二旗溢价——结构层接替与数值层带判读详见行动经济 F1 条款3 推导节），本系统的对账义务转为按 β 带逐 u 检算（常设重跑入口 `tools/clear_dominance_audit.py`，现行 u=3 β=1.17 微破下限登记态）；清图支配性已于 2026-09-19 按现行值链重跑、裁决②"非支配设计态"维持（回执见 git 提交 2ca3e20,报告已退役）——判式换代后的全套判值重跑随本系统下一次调参批顺带执行。完美排雷乘数的调参权在本系统。 元进度接口预留：**结论——元进度解锁对难度的影响，以生存链区间的平移换算率接入；接口启用形态已定稿（2026-09-18 元进度定稿批，用户拍板）：永久强化影响折算为通关率带平移量，判读口径不变；换算率表首版三行（生命上限 / 基础攻击 / 护甲等级——护甲行强条目，验收读数须按解锁后参数重测）与键结构登记见 registry `meta_progression_conversion_table`，数值行读 `data/tables/`、标定随元进度设计批。** 元进度数值行落地前，本系统不为它预留任何数值行。 @@ -259,8 +259,8 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板 | 优先级 | 内容 | 后置原因 | |---|---|---| -| P1 | 加难杠杆扫描落带 | 候选杠杆已登记（血量锚走廊、群战上探、注入衰减上调候选），域内取样扫描已执行（迭代 5——r_boss 0.8 档，见「Boss 设计」节加难走廊行），全杠杆落带扫描未收口；护甲等级换装点锚定（基准护甲等级自带敌方输出期望的结构性削减 + 减伤墙退役 + 伤害下限）的方向性偏移并入本扫描一并调带（带宽补扫含暴击档与折扣档）；落带前现行行值维持 provisional-pending-scan。第二关行集随分支节点图批落地后并入本扫描（L2 读数基线/加成档已随批实测，见 v0.7） | -| P1 | 挖掘风险不等式与清图支配性对账重跑 | **挖掘风险不等式半边已收口（2026-10-05 判式换代批，迭代14②号卡）**——判式三层重立落文+条件二旗溢价机制闭合+β 带判读制度化（残留=u=3 β=1.17 微破下限登记态，不强制回滚；δ 敏感度判读随批出口报告），本行对挖掘风险不等式的「重跑义务」改判读回执：后续调参按 β 带检算执行，不再立独立重跑批。清图支配性已于 2026-09-19 按现行值链重跑（裁决②"非支配设计态"维持——缺口收窄主读数 L1≈24/L2≈45 当量〔u=1〕，设计权威回执=git 提交 2ca3e20，重跑入口 tools/clear_dominance_audit.py）；调参批执行时按当期行值随批重跑 | +| P1 | 加难杠杆扫描落带 | 候选杠杆已登记（血量锚走廊、群战上探、注入衰减上调候选），域内取样扫描已执行（迭代 5——r_boss 0.8 档，见「Boss 设计」节加难走廊行），全杠杆落带扫描未完成；护甲等级换装点锚定（基准护甲等级自带敌方输出期望的结构性削减 + 减伤墙退役 + 伤害下限）的方向性偏移并入本扫描一并调带（带宽补扫含暴击档与折扣档）；落带前现行行值维持 provisional-pending-scan。第二关行集随分支节点图批落地后并入本扫描（L2 读数基线/加成档已顺带实测，见 v0.7） | +| P1 | 挖掘风险不等式与清图支配性对账重跑 | **挖掘风险不等式半边已完成（2026-10-05 判式换代批，迭代14②号卡）**——判式三层重立写入文档+条件二旗溢价机制闭合+β 带判读制度化（残留=u=3 β=1.17 微破下限登记态，不强制回滚；δ 敏感度判读顺带出口报告），本行对挖掘风险不等式的「重跑义务」改判读回执：后续调参按 β 带检算执行，不再立独立重跑批。清图支配性已于 2026-09-19 按现行值链重跑（裁决②"非支配设计态"维持——缺口收窄主读数 L1≈24/L2≈45 当量〔u=1〕，设计权威回执=git 提交 2ca3e20，重跑入口 tools/clear_dominance_audit.py）；调参批执行时按当期行值顺带重跑 | | P1 | 真人通关率修正系数标定 | 带按模拟口径定义；试玩批次实测真人显著强于模拟者，系数待后续试玩批次定量 | | P1 | 迭代 10 奖励重构带重扫义务 | 恢复经济收紧（通关血回满→部分回血 20%，难度上压方向）+ 局内成长节奏变动（三选一件值/权重/次数上限 knob 全读冒险表；AP 件 = 每场战斗开始首轮 +1 AP 的强度敏感轴）——通关率带重扫随曲线调参批现行窗执行；Boss 钥石掉落重锚（首杀 3/复杀 2）连带元进度产出标定义务重开（归元进度设计批） | | P1 | 完美策略档的结构性加难杠杆 | 数值杠杆对完美档已被实测证伪，结构候选未裁决（登记 [06-待办清单](../../06-待办清单.md)） | @@ -274,7 +274,7 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板 首发行值几乎全部 provisional，其中加难相关数值处于 provisional-pending-scan（扫描未执行）；完整行集读表，不在此整表搬运。 -敌人表行值（行集与坐标覆盖随批次扩展，行值读 `enemy.tres`——本文只登记行模板与坐标语义）： +敌人表行值（行集与坐标覆盖随后续批次扩展，行值读 `enemy.tres`——本文只登记行模板与坐标语义）： **混编行集难度归属注记（2026-10-07 行集多行批——机制放开、本批零投放）**：敌人表同一坐标允许多行混编多种敌种后，混编遭遇的难度 = 行集内各行值按既有口径独立生效再叠加（数量区间各行各掷、行集实例总数 ≤ 4），不引入新的难度轴或乘区；首个混编行连同 Boss 多行的实际投放归后续内容批，投时行值 provisional 归本文调参的既有口径不变，且投放批须附 MC 取证（先报批）与难度带读数。机制批次（本批）零内容投放、零数值变更。 @@ -284,7 +284,7 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板 第二关图版注记（分支节点图批）：L2 熊地精三行 = bugbear 复用（幽暗地域部族设定——display_name 熊地精系与第一关"熊地精"错开；池差异化改造 = 蓄力拍退役换突刺，复用共享技能行）；巨蜘蛛 = 新敌种（群行倾向、首遇位固定数量不加骰——首遇教学位纪律）；蛛化卓尔精灵 = Boss 专属池（独占技毒爆 + 权重轮廓，血量为 r_boss 口径 provisional 锚——定位本关最大单场消耗）；护甲面：轻甲（蜘蛛）与魔法护甲（熊地精三行）同关错开克制面，Boss 重甲。L2 三行复用 bugbear、显示名熊地精系（2026-09-17 用户拍板）；Boss 定名蛛化卓尔精灵（用户同日拍板）。节点编号 2 = 奖励点、3 = 恢复点（rest_heal_pct 行字段兑付）——不开战斗、无敌人/棋盘行。 -第三关图版注记（第三关内容批）：行集 = 与第二关同模板的九节点图（六战 + Boss + 奖励 + 恢复，节点编号 2/3 同为奖励点/恢复点——不开战斗、无敌人/棋盘行）。敌种生态：灰矮人 = duergar 新敌种（单体重甲中坚——第二关单体生态位的关间台阶）；钩爪恐魔 = hook_horror 新敌种（群行，复用撕咬共享技能行）；灰矮人石君王 = duergar_king Boss 专属池（独占妨害技大地脉动 earth_pulse = 乏力 sapped 首发——第二妨害词汇，池载荷口径同蛛网束缚）。两敌种首遇位（节点 0 / 节点 1）固定数量不加骰——首遇教学位纪律同第二关注记。克制面重轻错开：重甲灰矮人是重甲首次登台，轻甲钩爪恐魔保穿刺/普通分量有用武之地，Boss 重甲收束"轻甲 → 魔法护甲 → 重甲"教学梯度（第三档在 L3 补完）。Boss 血量 75 = Σ普通战生命期望 91 × r_boss≈0.82（provisional 锚，域 [0.5, 1.1]——Boss 锚在案口径，逐数闭合随调参批在调参日志留档）。棋盘 13×13 / Boss 14×14、密度 0.25 维持、地形变异第三关对落石（直伤 3 点）+ 矿尘（数字遮蔽）随批铺行；armor_class 恒 0（正式投值仍归「敌方护甲等级正式行值」在案条目全表同批）。行值读 `enemy.tres` / `board_gen.tres` / `skills.tres` / `variation.tres`，全部 provisional-pending-growth（L3 口径见「期望值带」节）。 +第三关图版注记（第三关内容批）：行集 = 与第二关同模板的九节点图（六战 + Boss + 奖励 + 恢复，节点编号 2/3 同为奖励点/恢复点——不开战斗、无敌人/棋盘行）。敌种生态：灰矮人 = duergar 新敌种（单体重甲中坚——第二关单体生态位的关间台阶）；钩爪恐魔 = hook_horror 新敌种（群行，复用撕咬共享技能行）；灰矮人石君王 = duergar_king Boss 专属池（独占妨害技大地脉动 earth_pulse = 乏力 sapped 首发——第二妨害词汇，池载荷口径同蛛网束缚）。两敌种首遇位（节点 0 / 节点 1）固定数量不加骰——首遇教学位纪律同第二关注记。克制面重轻错开：重甲灰矮人是重甲首次登台，轻甲钩爪恐魔保穿刺/普通分量有用武之地，Boss 重甲收束"轻甲 → 魔法护甲 → 重甲"教学梯度（第三档在 L3 补完）。Boss 血量 75 = Σ普通战生命期望 91 × r_boss≈0.82（provisional 锚，域 [0.5, 1.1]——Boss 锚在案口径，逐数闭合随调参批在调参日志留档）。棋盘 13×13 / Boss 14×14、密度 0.25 维持、地形变异第三关对落石（直伤 3 点）+ 矿尘（数字遮蔽）顺带铺行；armor_class 恒 0（正式投值仍归「敌方护甲等级正式行值」在案条目全表同批）。行值读 `enemy.tres` / `board_gen.tres` / `skills.tres` / `variation.tres`，全部 provisional-pending-growth（L3 口径见「期望值带」节）。 群伤负向 = 警觉（敌方护甲等级 +1——2026-09-20 八型批伏击退役换装）；一轮踩雷数由行动点预算天然封顶（原 advantage_per_round_cap 行值同日先行删除）。攻击浮动开战时掷定一次、整战持久；数量区间同流掷定，教学位与首遇位都不豁免——没有区间上界的行自然取定值，那不是豁免，是区间宽度为零。 diff --git a/design/gdd/systems/战斗循环/地图战斗资源.md b/design/gdd/systems/战斗循环/地图战斗资源.md index 169f1b71..2f854470 100644 --- a/design/gdd/systems/战斗循环/地图战斗资源.md +++ b/design/gdd/systems/战斗循环/地图战斗资源.md @@ -200,7 +200,7 @@ | 优先级 | 内容 | 后置原因 | |---|---|---| -| P1 | ~~功能道具渠道~~（已由秘宝体系承接——局外同调件：营地解锁 + 同调位装配，同调实施批 2026-10-03 落地；关卡节点渠道形态随批退役） | 数值型伤害/治疗道具已删除（2026-09-15 用户定）；本系统只留结构位不变 | +| P1 | ~~功能道具渠道~~（已由秘宝体系承接——局外同调件：营地解锁 + 同调位装配，同调实施批 2026-10-03 落地；关卡节点渠道形态顺带退役） | 数值型伤害/治疗道具已删除（2026-09-15 用户定）；本系统只留结构位不变 | | P1 | 清图池按图类型差异化 | 默认槽之外的结构位已留；词表现行三值（{dungeon, underdark, deep_underdark}），差异化行随内容批配置 | | P1 | 未开格资源类型的呈现深度 | 基础档已定——微光只读类型不读危险格与安全格（2026-10-07 案甲，实施归呈现批、06 在案）；更深档与推理的界线另议 | | P1 | 增攻（attack）型行值与权重终调 | 内容决策，归[难度曲线与Boss](../冒险循环/难度曲线与Boss.md) | diff --git a/design/gdd/systems/战斗循环/增益状态.md b/design/gdd/systems/战斗循环/增益状态.md index 2bb56271..87b24b31 100644 --- a/design/gdd/systems/战斗循环/增益状态.md +++ b/design/gdd/systems/战斗循环/增益状态.md @@ -193,7 +193,7 @@ empower 与 fortify 是敌方技能池增益技在容器侧的数据落点（技 | 优先级 | 内容 | 后置原因 | |---|---|---| -| P1 | 刷新、并存两类合并策略的后续内容行 | 语义已定义、容器已承载；刷新类已有内容（empower/fortify 2026-09-16 敌人技能池批、weaken 2026-09-18 续时定案），并存仍空，首个并存内容行上线时随批补验收 | +| P1 | 刷新、并存两类合并策略的后续内容行 | 语义已定义、容器已承载；刷新类已有内容（empower/fortify 2026-09-16 敌人技能池批、weaken 2026-09-18 续时定案），并存仍空，首个并存内容行上线时顺带补验收 | | P1 | 清图奖励含增益的授予路径 | 来源类别已预留；内容与档位归[地图战斗资源](地图战斗资源.md)定稿 | | P1 | 单体寻址扩展位 | 现行对敌效果一律全体共享；首个"只作用于其中一个敌人"的效果上线时给实例加目标字段 | | P2 | 驱散 / 延时 / 转移接口 | 状态一旦生效，玩家没有任何手段摘掉、延后或挪给别人——省掉一整类界面复杂度是明确的设计决定；要加属于新增接口的修订，不是调参 | diff --git a/design/gdd/systems/战斗循环/战斗结算.md b/design/gdd/systems/战斗循环/战斗结算.md index 9d0601c8..f9eec3de 100644 --- a/design/gdd/systems/战斗循环/战斗结算.md +++ b/design/gdd/systems/战斗循环/战斗结算.md @@ -115,7 +115,7 @@ percent 类（每结算、每层）: E = |层数 × 行值| ÷ 100 × | 层数 × 行值 | 单条效果的叠层数与行值，读[增益状态](增益状态.md)的实例数据 | 行值归该系统 | | 完美乘数 | 完美排雷给清图奖励的乘数，配置值 | 读 `settlement.tres` p_perfect（现行值读表） | -**gp / ap 当量口径注记（2026-10-05 判式换代批 T3——口径空白登记）**：上式 flat 类枚举（直伤、治疗、行动点）不含 gp——现行对账按 **gp 当量 = flat power 代理**计（金币袋 3 / 破财 2，方案报告假设 A5）；ap 当量 = flat 表值 1，机会成本口径（+1AP ≈ 多挖一格 ≈ E_dig + 进度 + 信息价值）更高，差异仅登记不进主算（假设 A6）。gp 的精确口径应经商店定价换算（1 GP 的边际属性当量），归状态层/商店批复核后换代。旗溢价兑付（条款3 条件二形态 a，`settlement.tres` flag_hit_premium=125 provisional）按同型正向 ×(1+δ) 兑付——当量换算随同型行口径同步放大，整数量级取整四舍五入（与伤害管线 round_direction=floor 分域，registry 随批登记）。 +**gp / ap 当量口径注记（2026-10-05 判式换代批 T3——口径空白登记）**：上式 flat 类枚举（直伤、治疗、行动点）不含 gp——现行对账按 **gp 当量 = flat power 代理**计（金币袋 3 / 破财 2，方案报告假设 A5）；ap 当量 = flat 表值 1，机会成本口径（+1AP ≈ 多挖一格 ≈ E_dig + 进度 + 信息价值）更高，差异仅登记不进主算（假设 A6）。gp 的精确口径应经商店定价换算（1 GP 的边际属性当量），归状态层/商店批复核后换代。旗溢价兑付（条款3 条件二形态 a，`settlement.tres` flag_hit_premium=125 provisional）按同型正向 ×(1+δ) 兑付——当量换算随同型行口径同步放大，整数量级取整四舍五入（与伤害管线 round_direction=floor 分域，registry 顺带登记）。 ### 授予段兑付：极性路由，四类动作各归各账 @@ -212,7 +212,7 @@ percent 类（每结算、每层）: E = |层数 × 行值| ÷ 100 × 主角攻击 = 单一基础分量（2026-09-19 充能退役批）：量 = 攻击力基线（表值），类型 = 主角表 `attack_type`（营地永久强化换型 = 改字段；未来冒险前参数面承接"按关配型"的策略位）。原"普通 + 穿刺/魔法充能三分量"模型整体退役——挖掘期与战斗期之间不再有弹药供给线，克制应对从局内攒桶改为冒险前配型 + 棋盘火力（穿刺弹/魔法矢等直伤奖励道具，消费面不变）。 -**护甲等级掷点：必中、非归零，只吃基础攻击分量**（2026-09-16 定稿落地，判定式与全部数值已拍板；判定对象措辞随敌人技能池批改述）。防守方由此多了一条数值轴——护甲等级（数据键 `armor_class`）：攻击永远命中，没有 miss、没有零收益白回合；只有吃掷点的分量在掷点低于防守方护甲等级时按减伤档位打折，档位再重也不归零。判定式：攻击结算时掷单骰（骰面读表），掷点 ≥ 防守方护甲等级 + 攻击加成 → 全额；掷点 < 护甲等级按缺口（护甲等级 − 掷点）查减伤档位表打折——边界与档值读 `settlement.tres` 减伤档位表，三档皆非零档。暴击：天然最大面（读表）使该次基础攻击分量 ×暴击倍率（读表），双方同规，且天然最大面恒全额（暴击与折扣互斥；天然最大面〔nat20〕暴击是掷点层概念，与技能重击〔池技能〕严格区分——两层禁止混述）。伤害下限：**任何来源的伤害落地**至少 damage_floor（读表，全局 max(damage_floor, ·)——2026-09-20 用户拍板扩全来源：攻击双方、棋盘直伤与爆裂、地形变异、负向反噬；伤害取值域 [1, +∞)，**不设上限**）——"被减伤归零 v=0"零值伤害行语义随批退役，重档折扣的攻击行在行文本记"被压制"。掷点范围：只有基础攻击分量吃掷点——主角先手攻击的基础分量，敌方技能的基础伤害分量（= 攻击基线 × 技能伤害倍率，普通攻击倍率 1 为特例）；无伤害分量的技能（增益/妨害类）不掷不折；棋盘来源一律无视护甲等级——爆裂、清障炸药、奖励即时伤害、技能必中附加分量（rider，2026-09-19）全部必中全额不掷，这是本机制的边界切口，与"奖励/惩罚必中"同构。护甲等级（数值轴，掷点打折）与护甲类型（属性轴，克制修正）严格分离：护甲类型不做护甲等级映射，克制修正点数读表、消费面不变，两概念在文档、表字段与代码键中禁止混用。数值载体：主角与敌方护甲等级行值读 hero / enemy 表的 armor_class 列（正式行值归怪物设定批，登记[待办清单](../../06-待办清单.md)），ac_up（盾牌加护）在其上加算（幅度/层数读 `status_effects.tres`）。攻击加成（`attack_bonus`）为结构位预留字段，切片恒 0，未来归元进度 / 武器附魔投值。掷点时机在结算战斗段内、每次基础攻击伤害计算时判定，消费 `armor_roll` 封闭流（逐次掷逐次取号，可逐位回放）。 +**护甲等级掷点：必中、非归零，只吃基础攻击分量**（2026-09-16 定稿落地，判定式与全部数值已拍板；判定对象措辞随敌人技能池批改述）。防守方由此多了一条数值轴——护甲等级（数据键 `armor_class`）：攻击永远命中，没有 miss、没有零收益白回合；只有吃掷点的分量在掷点低于防守方护甲等级时按减伤档位打折，档位再重也不归零。判定式：攻击结算时掷单骰（骰面读表），掷点 ≥ 防守方护甲等级 + 攻击加成 → 全额；掷点 < 护甲等级按缺口（护甲等级 − 掷点）查减伤档位表打折——边界与档值读 `settlement.tres` 减伤档位表，三档皆非零档。暴击：天然最大面（读表）使该次基础攻击分量 ×暴击倍率（读表），双方同规，且天然最大面恒全额（暴击与折扣互斥；天然最大面〔nat20〕暴击是掷点层概念，与技能重击〔池技能〕严格区分——两层禁止混述）。伤害下限：**任何来源的伤害落地**至少 damage_floor（读表，全局 max(damage_floor, ·)——2026-09-20 用户拍板扩全来源：攻击双方、棋盘直伤与爆裂、地形变异、负向反噬；伤害取值域 [1, +∞)，**不设上限**）——"被减伤归零 v=0"零值伤害行语义顺带退役，重档折扣的攻击行在行文本记"被压制"。掷点范围：只有基础攻击分量吃掷点——主角先手攻击的基础分量，敌方技能的基础伤害分量（= 攻击基线 × 技能伤害倍率，普通攻击倍率 1 为特例）；无伤害分量的技能（增益/妨害类）不掷不折；棋盘来源一律无视护甲等级——爆裂、清障炸药、奖励即时伤害、技能必中附加分量（rider，2026-09-19）全部必中全额不掷，这是本机制的边界切口，与"奖励/惩罚必中"同构。护甲等级（数值轴，掷点打折）与护甲类型（属性轴，克制修正）严格分离：护甲类型不做护甲等级映射，克制修正点数读表、消费面不变，两概念在文档、表字段与代码键中禁止混用。数值载体：主角与敌方护甲等级行值读 hero / enemy 表的 armor_class 列（正式行值归怪物设定批，登记[待办清单](../../06-待办清单.md)），ac_up（盾牌加护）在其上加算（幅度/层数读 `status_effects.tres`）。攻击加成（`attack_bonus`）为结构位预留字段，切片恒 0，未来归元进度 / 武器附魔投值。掷点时机在结算战斗段内、每次基础攻击伤害计算时判定，消费 `armor_roll` 封闭流（逐次掷逐次取号，可逐位回放）。 EV 参考数不入正文（派生读数，需要时按判定式与现行表值自行复算）；旧 defense_up 的减伤墙已整体退役换装为 AC（无双轨，见版本历史）。微调旋钮 = 档位边界与档位值，不动护甲等级值。换装点锚定：基准 AC（读 hero 表）自带的方向性偏移与[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)已登记的加难杠杆扫描合并处理；其生存链区间模型按掷点带宽口径复核（带宽含暴击档与折扣档），"零红档"验收保留。 @@ -322,7 +322,7 @@ EV 参考数不入正文（派生读数，需要时按判定式与现行表值 | 甲效矩阵 | 整数点数 {−1, 0, +1} | 三档加法修正（克制 +1 / 中性 0 / 被克 −1）九格现行值读 `settlement.tres`（provisional——2026-09-18 加法核换装，量纲 percent 退役） | 键集 = 攻击类型 {普通, 穿刺, 魔法} × 护甲类型 {轻甲, 魔法护甲, 重甲}，3×3 满格结构冻结；数值归调参 | | 护甲等级掷点 | 骰面 int [2,1000] · nat 最大面 [1,骰面] · 暴击倍率 percent [100,999] | 骰面 / nat 最大面 / 暴击倍率读表（2026-09-16 拍板定稿） | 回合内随机：每吃掷点分量逐次掷骰，掷点低于防守方护甲等级 + 攻击加成触发档位折扣；天然最大面暴击 ×暴击倍率（读表）且恒全额（双方同规）；消费 `armor_roll` 封闭流（逐次掷逐次取号） | | 减伤档位表 | 边界升序 + 档位值降序 percent [1,99]，档数 = 边界数 + 1 | 边界与档值读 `settlement.tres`（roll_tier_bounds / discount 档位，2026-09-16 拍板定稿） | 低掷缺口按边界查档（读表）；档位不设零档（非归零）；微调旋钮 = 本表，不动护甲等级值 | -| 伤害下限 `damage_floor` | int [1, 999] | 读 `settlement.tres` damage_floor（2026-09-16 拍板定稿；2026-09-20 扩全来源） | 任何来源的伤害落地全局 max(damage_floor, ·)；零值伤害行语义随批退役 | +| 伤害下限 `damage_floor` | int [1, 999] | 读 `settlement.tres` damage_floor（2026-09-16 拍板定稿；2026-09-20 扩全来源） | 任何来源的伤害落地全局 max(damage_floor, ·)；零值伤害行语义顺带退役 | | 攻击加成 `attack_bonus` | int [0, 999] | 0（结构位） | 掷点阈值 = 防守方护甲等级 + 攻击加成；切片恒 0，未来归元进度 / 武器附魔投值 | | 护甲等级 `armor_class`（防守方字段） | int [0, 999] | 主角与敌方现行值读 hero / enemy 表 armor_class 列（暂定） | 字段本体在敌人表与主角表（归[敌人系统](敌人系统.md)），行值投值归[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)；敌方正式行值归怪物设定批（见待办清单）；与护甲类型（克制属性轴）两概念禁止混用 | | 段序常量 | 固定五段 | 结构冻结 | 加载期恒等校验，违例拒绝启动 | diff --git a/design/gdd/systems/战斗循环/敌人系统.md b/design/gdd/systems/战斗循环/敌人系统.md index d97c3bd8..b9eb2a4b 100644 --- a/design/gdd/systems/战斗循环/敌人系统.md +++ b/design/gdd/systems/战斗循环/敌人系统.md @@ -91,7 +91,7 @@ | 钩爪恐魔 | 普通攻击 + 撕咬 + 蓄力 | 行值读表 | 行值读表 | L2/L3 群行位（蜘蛛同构池） | | 灰矮人石君王 | 普通攻击 + 重击 + 大地脉动 + **岩崩**（半血解锁） | 行值读表 | 行值读表 | L3 关底 Boss；大地脉动独占 | -护甲类型（轻甲 / 魔法护甲 / 重甲）与攻击类型的克制结算矩阵归[战斗结算](战斗结算.md)，本系统只提供每个敌种的护甲类型数据——**护甲列自 2026-10-05 技能池执行批起改读表口径**（本表轮廓列不再记具体甲型：现行 L1 全轻甲 / L2 仅 Boss 魔法甲 / L3 heavy 登台的错峰投放以 `enemy.tres` 行值为准；历史「本表写魔甲/重甲」与表失同步的欠账随批清偿）。护甲等级是另一条数值轴（防守方字段，基础攻击掷点的折扣判定读数）：敌人表与主角表各增 `armor_class` 一列（域 [0, 999]），掷点与折扣的结算归[战斗结算](战斗结算.md)，行值投值归[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)——三敌种首关与主角的护甲等级行值读配置表（第一关怪物 AC 相对较低，正式行值待怪物设定投值，登记[待办清单](../../06-待办清单.md)），两条轴的概念与字段禁止混用。举证：生成与护甲为数据面规则，无计算。 +护甲类型（轻甲 / 魔法护甲 / 重甲）与攻击类型的克制结算矩阵归[战斗结算](战斗结算.md)，本系统只提供每个敌种的护甲类型数据——**护甲列自 2026-10-05 技能池执行批起改读表口径**（本表轮廓列不再记具体甲型：现行 L1 全轻甲 / L2 仅 Boss 魔法甲 / L3 heavy 登台的错峰投放以 `enemy.tres` 行值为准；历史「本表写魔甲/重甲」与表失同步的欠账顺带清偿）。护甲等级是另一条数值轴（防守方字段，基础攻击掷点的折扣判定读数）：敌人表与主角表各增 `armor_class` 一列（域 [0, 999]），掷点与折扣的结算归[战斗结算](战斗结算.md)，行值投值归[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)——三敌种首关与主角的护甲等级行值读配置表（第一关怪物 AC 相对较低，正式行值待怪物设定投值，登记[待办清单](../../06-待办清单.md)），两条轴的概念与字段禁止混用。举证：生成与护甲为数据面规则，无计算。 ### 技能池：每敌种一张带权技能池，每拍开轮摇号出招 @@ -146,7 +146,7 @@ 蓄力语义（2026-09-16 纠偏定稿）：蓄力不是重击前奏——它是一行增益技：0 伤害动作，施加 empower 状态（幅度读 `status_effects.tres`），持续 1 个有效结算（provisional）。旧环"蓄力→猛击"的固定配对是哥布林弹珠的拷贝（给玩家输出窗口用的），随行为环一并退役；蓄力与重击之间**没有任何组合语义**——增益与技能倍率恰好同拍只是增益倍率 × 技能倍率的两层乘法共存（增益幅度 × 增益幅度 = 两层乘法读表可得），蓄力后摇中普通攻击则是增益倍率的加成平砍，两者同为平常事，不是设计的连招。技能冷却（几拍内不能再摇中，技能行属性）与增益持续（状态挂几回合，状态行属性）是两个计时器，互不相干。施放行 = 0 伤害动作，不掷不折（原"零兑付、不读伏击"的读怪奖励语义随伏击退役作废——2026-09-20 八型批）。 -Boss 专属身份 = 专属池承载：独占技能 + 权重轮廓（**技能错峰两轨口径，2026-10-05 技能池执行批立 Boss 轨、2026-10-13 迭代 24 N2 补普通敌轨**：**Boss 轨** = L1 酋长池含独占增益技"硬化"〔敌方防御池词汇载体〕+ 半血解锁伤害技"震地怒击"；L2 卓尔池独占妨害技"蛛网束缚"+伤害技"毒爆"+ 半血解锁"遏毒"；L3 石君王池独占妨害技"大地脉动"+ 半血解锁"岩崩"——独占技随关错峰投放，三行解锁技=每 Boss 一行新独占伤害技〔用户裁案甲，2026-10-04〕；**普通敌轨** = L2/L3 普通敌种技能随关错峰投放（2026-10-13 N2：巨蜘蛛族+毒吐〔(2,5)/(2,6)/(2,7)，首遇教学位 (2,4) 不投〕、灰矮人族+盾击〔(3,0)/(3,5)/(3,7)〕，`skills.tres` 12→14 行）——第一关不见的招式第二/三关普通战可见；旧"专属四拍环且含蓄力拍"约定随批退役，增益 ≤1 纪律下旧蓄力拍不进 Boss 池）。 +Boss 专属身份 = 专属池承载：独占技能 + 权重轮廓（**技能错峰两轨口径，2026-10-05 技能池执行批立 Boss 轨、2026-10-13 迭代 24 N2 补普通敌轨**：**Boss 轨** = L1 酋长池含独占增益技"硬化"〔敌方防御池词汇载体〕+ 半血解锁伤害技"震地怒击"；L2 卓尔池独占妨害技"蛛网束缚"+伤害技"毒爆"+ 半血解锁"遏毒"；L3 石君王池独占妨害技"大地脉动"+ 半血解锁"岩崩"——独占技随关错峰投放，三行解锁技=每 Boss 一行新独占伤害技〔用户裁案甲，2026-10-04〕；**普通敌轨** = L2/L3 普通敌种技能随关错峰投放（2026-10-13 N2：巨蜘蛛族+毒吐〔(2,5)/(2,6)/(2,7)，首遇教学位 (2,4) 不投〕、灰矮人族+盾击〔(3,0)/(3,5)/(3,7)〕，`skills.tres` 12→14 行）——第一关不见的招式第二/三关普通战可见；旧"专属四拍环且含蓄力拍"约定顺带退役，增益 ≤1 纪律下旧蓄力拍不进 Boss 池）。 举证：**摇定结果 = 可摇集合按权重份额归一的一次抽签；当前可摇集合 = 实例池排除冷却中技能（保底命中时 = 全部特殊技）。**连带可判别：把权重当固定百分比、把冷却当只锁高伤技、把蓄力当重击前奏，都是与本规约相悖的旧口径。 diff --git a/design/gdd/systems/排雷循环/地形变异.md b/design/gdd/systems/排雷循环/地形变异.md index a5eb13d1..eff8d379 100644 --- a/design/gdd/systems/排雷循环/地形变异.md +++ b/design/gdd/systems/排雷循环/地形变异.md @@ -21,7 +21,7 @@ | 数据侧行为约定 | 变异是格子的只读数据，随图生灭；读取方按数据行动 | | 零特判原则 | 禁止任何系统为变异改写扫雷规则本体——框架的承重约束（见核心规则） | | 枚举抽象 | 每类变异以「效果（effect）/ 触发（trigger）/ 布置约束（placement）」三枚举声明机制；读取方按枚举路由，不按类型名分支 | -| 反制道具配套义务 | **已作废（2026-10-03 用户终裁）**——原义务「每定稿一类变异，随批配至少一件反制道具」（义务在本系统，道具本体归秘宝；首批四类型的兑现改排 Alpha——2026-09-19 用户拍板）：同调位反制件=冒险周期常驻资源对抗关卡周期局部威胁，层级错配，设计废弃（详见下文 §反制道具配套义务 节注记） | +| 反制道具配套义务 | **已作废（2026-10-03 用户终裁）**——原义务「每定稿一类变异，顺带配至少一件反制道具」（义务在本系统，道具本体归秘宝；首批四类型的兑现改排 Alpha——2026-09-19 用户拍板）：同调位反制件=冒险周期常驻资源对抗关卡周期局部威胁，层级错配，设计废弃（详见下文 §反制道具配套义务 节注记） | 不负责： @@ -100,7 +100,7 @@ region 型变异是「格子级」的：布置段往候选格域写格子快照 ### 反制道具配套义务 -**【已作废——2026-10-03 用户终裁】** 原义务：每定稿一类变异，必须随批配套至少一件反制道具（针对该变异、给玩家提供应对手段的道具），不让任何变异成为只亏不赚的纯税。义务归属方是本系统；"反制"作为道具的一个维度，由秘宝的五维度框架承接，效果、时效与定价归秘宝定稿。首批四类型的反制兑现改排 Alpha（2026-09-19 用户拍板），类型行 counter_items 字段位已预留。 +**【已作废——2026-10-03 用户终裁】** 原义务：每定稿一类变异，必须顺带配套至少一件反制道具（针对该变异、给玩家提供应对手段的道具），不让任何变异成为只亏不赚的纯税。义务归属方是本系统；"反制"作为道具的一个维度，由秘宝的五维度框架承接，效果、时效与定价归秘宝定稿。首批四类型的反制兑现改排 Alpha（2026-09-19 用户拍板），类型行 counter_items 字段位已预留。 **终裁理由（2026-10-03）**：原计划反制件入同调目录（局外装配、伴随整局、稀缺槽位）对抗按关绑定的局部威胁（unlock_level 关绑定），被定性为层级错配的失败设计——「拿冒险循环的东西对抗关卡循环」，等同做一个只对第三关生效的道具，其余关卡全部用不上；且关卡序列与变异分布固定，装配时信息完备，反制选牌退化为查表必带清单，坍缩随机构筑多样性。 @@ -130,7 +130,7 @@ region 型变异是「格子级」的：布置段往候选格域写格子快照 | 优先级 | 内容 | 后置原因 | |---|---|---| | 迭代 12（调研前置） | 反制路径重定（原：首批四类型的反制道具兑现，counter_items 回填——已作废） | 2026-10-03 用户终裁：同调位反制件=层级错配失败设计，义务作废；变异应对是否以局内形态补入，待双层 BD 调研仲裁后重新立项 | -| ~~Alpha~~ **已落地** | 全局作用域变异（精英/Boss 图整图生效的变异形态） | **2026-10-04 全局作用域变异首发批落地**（迭代 14 ③号卡）——首批型=贫矿脉（案A 资源面·微贫向偏斜，替换制/恒定制/L1 Boss 免疫/三层预告）；裁决全录见调研报告 §7（全局作用域设计空间调研（已退役，git 历史可查）；原需求卡片已退役，git b3bbea5/01bfc15）；带 A 杠杆注册全局难度批（Beta 阶段，未排期）随批读数只测不判；精英图留词表前向位（首发零表行） | +| ~~Alpha~~ **已落地** | 全局作用域变异（精英/Boss 图整图生效的变异形态） | **2026-10-04 全局作用域变异首发批落地**（迭代 14 ③号卡）——首批型=贫矿脉（案A 资源面·微贫向偏斜，替换制/恒定制/L1 Boss 免疫/三层预告）；裁决全录见调研报告 §7（全局作用域设计空间调研（已退役，git 历史可查）；原需求卡片已退役，git b3bbea5/01bfc15）；带 A 杠杆注册全局难度批（Beta 阶段，未排期）顺带读数只测不判；精英图留词表前向位（首发零表行） | | P2 | "地形成本修饰"价目钩子启用 | 由行动经济持有；启用须随变异类型扩展，与行动经济重议按格定价的接口 | | P2 | 变异解锁节奏复核 | "每关至少引入一个新元素"的推进节奏，随[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)定稿复核 | | P2 | 变异格视觉标识与预告呈现 | 首批为遭遇式（未开无预告）；标识位随表现层升级批 | diff --git a/design/gdd/systems/排雷循环/行动经济.md b/design/gdd/systems/排雷循环/行动经济.md index b08f1641..3b9e2c86 100644 --- a/design/gdd/systems/排雷循环/行动经济.md +++ b/design/gdd/systems/排雷循环/行动经济.md @@ -79,7 +79,7 @@ ### 停手与储备行动点 -停手是玩家在挖掘期任意时刻的主动决定：立即结束本轮，剩余行动点按 1:1 原值存入储备池——基线没有乘数、没有加成。图没开完，下一轮接着在同一张图上挖。停手不是收入来源，而是纯粹的风险管理工具：它买到的是"退出权"，不是战斗收益。停手意图经排雷玩法的批次提交入口进入账本（保证单一结算序），由账本仲裁后自行外发轮次结束消息。**转存率参数化（迭代 22 秘宝批反哺落文，2026-10-12）**：转存率实现为 `finish_round_stop(transfer_pct)` 参数面——缺省 100=1:1 与旧口径逐位一致；秘宝「储备罐」注入 125=1.25:1（整数除法向下取整——每 4 点剩余 AP 多转 1 点 RAP，零头顺延向下）；无装配时行为与参数化前逐位相同。转存率归秘宝操作包络参数，本账本的仲裁与发射结构不变。 +停手是玩家在挖掘期任意时刻的主动决定：立即结束本轮，剩余行动点按 1:1 原值存入储备池——基线没有乘数、没有加成。图没开完，下一轮接着在同一张图上挖。停手不是收入来源，而是纯粹的风险管理工具：它买到的是"退出权"，不是战斗收益。停手意图经排雷玩法的批次提交入口进入账本（保证单一结算序），由账本仲裁后自行外发轮次结束消息。**转存率参数化（迭代 22 秘宝批反哺写入，2026-10-12）**：转存率实现为 `finish_round_stop(transfer_pct)` 参数面——缺省 100=1:1 与旧口径逐位一致；秘宝「储备罐」注入 125=1.25:1（整数除法向下取整——每 4 点剩余 AP 多转 1 点 RAP，零头顺延向下）；无装配时行为与参数化前逐位相同。转存率归秘宝操作包络参数，本账本的仲裁与发射结构不变。 储备池的生命周期以一场战斗为界：战斗内跨轮次、跨雷图一直累积；战斗结束立刻清零。清零必须在界面上可见，防止玩家觉得"攒的钱凭空没了"。MVP 阶段储备池没有上限。 @@ -238,7 +238,7 @@ | refresh_cap_per_round | int | 表值（provisional，结构位预留） | 每轮刷新上限，开轮重置计数 | | （跨表）跨冒险行动点加成 | int [0,10] / int [0,99]，冒险表 | adventure_table bonus_ap_flat / bonus_cap_ap（provisional） | 三选一 AP 件兑现值与全冒险次数上限；加成轴语义见「跨冒险行动点加成轴」节 | -字段名注记：2026-09-18 措辞收口批已全链对齐正式名——表字段与本文行名统一为 `refresh_cap_per_round`，账本入口统一为 `request_refresh`（registry naming_unification 兑现，切片临时名零残留）。 +字段名注记：2026-09-18 措辞完成批已全链对齐正式名——表字段与本文行名统一为 `refresh_cap_per_round`，账本入口统一为 `request_refresh`（registry naming_unification 兑现，切片临时名零残留）。 跨字段校验：任一动作成本禁止超过每轮预算，违反即加载期致命（fail-fast）。各域上界（8 / 64）是 MVP 量级护栏而非推导界，随调参需要修订。 diff --git a/design/gdd/systems/表现与支撑/HUD框架.md b/design/gdd/systems/表现与支撑/HUD框架.md index f0f6f9a6..885b9858 100644 --- a/design/gdd/systems/表现与支撑/HUD框架.md +++ b/design/gdd/systems/表现与支撑/HUD框架.md @@ -166,11 +166,11 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻 配套拍板（同日）：魔法提灯=灯甲形态（光照圈外扩 +2 格，flat 整数档）随迷雾立项；**类型微光不随视野扩大**（类型先读仍只贴身 8 格，微光锚=可挖域）；提灯载体归 aux_items 新行（登记原文——2026-10-07 用户令改道为独立卡，2026-10-08 裁案A=秘宝·同调位新行落位，见下方实施状态注记；**2026-10-09 用户裁退役**——新目录 15 件未收提灯，fog_lantern 数据行与卡④接线拆除归退役删行批〔实装批〕，功能由新目录普通档「阔视野带」承接，06 登记条在册），呈现面挂「资产升档重产批」（挂账不动）。 -**实施状态（2026-10-03 迭代 11 第④批已入库）**：迷雾遮蔽+菱形灯光区跟随+暗淡记忆态上线，探针断言顺带扩（ui_input_probe case⑮）。四裁决逐条对账——①案甲视野迷雾立项（纯呈现层）：迷雾开关分层验证可用（呈现态布尔，off 态=无迷雾基线），同板同动作序列与 MC 对拍逐位一致；②暗淡记忆态：区外已开格灰显+数字可读，明度按 [art-bible](../../../art/art-bible.md) §6.5 落文值（记忆板 #3A3A3A/记忆墨 #C4C4C4，provisional）；③灯光半径=微光环 8 格同圈：LIGHT_RADIUS=8 参数化（曼哈顿菱形，常量）；④提灯 +2、微光不扩：FOG_LANTERN_BONUS=+2（落码常量实名——本条旧记 LIGHT_RADIUS_LANTERN_BONUS 系文档侧拟名，随卡④入库对齐），类型微光仍贴身 8 邻格零改动。**〔2026-10-05 迭代14⑤接线注记〕公共接线面已就位**——`board_view.set_fog_lantern(enabled)`（true=半径 8+2、false=复原 0；写入即 refresh 重算雾态），半径算式消费 `_fog_lantern` 迷雾批已在位；ui_input_probe case⑮ 增接线断言（开=dist 9 格转可见+lantern=2／关=复原）。**〔2026-10-08 迭代 19 卡④入库注记〕载体到位+接线闭环=功能可达**——载体=秘宝·同调位新行 `fog_lantern`「魔法提灯」（treasure_items.tres 表尾追加，desc「灯光区半径+2」，slot_cost 1、营地秘宝匣同调装配获渠，行字段=用户「按推荐」全收）；生产路径=runner set_attunement→enc.attunement→begin_battle 注入 orchestrator 装配集→公共只读出口 `attune_has`→组合根呈现桥 `main._sync_fog_lantern` 每战首轮装配链**显式重算含否**（🔴 复原语义=禁战斗结束隐式复原——卸装/未装配写 0，断点续玩/跨关天然正确）；未装配=false 写 0=缺省零扰动基线逐位不变。顺带测试：case⑮ 载体级段（装配→lantern=2+dist R+1 转可见+卸装复原）+smoke 行字段/同调目录投影（九件→十件）/装配贯通断言+存档回归 Part 6+单测 fog_lantern_wiring（run_all 17→18 套）。原「提灯载体归 aux_items 新行随 Alpha 信息件重定批」登记去向就此销账（改道留痕=需求卡片-提灯载体道具批-2026-10-07 §一）。验收线（本篇「验收标准」视野迷雾行）逐条转正式验收：区内完整渲染／区外已开格灰显可读／区外未开格不可见／灯光区随移动跟随／两态结算逐位一致；实机目检人闸（迷雾观感/记忆态可读性/移动跟随流畅度）随出口闸。黑暗区域渲染规格承载 = art-bible §6.5（v3.5）。 +**实施状态（2026-10-03 迭代 11 第④批已入库）**：迷雾遮蔽+菱形灯光区跟随+暗淡记忆态上线，探针断言顺带扩（ui_input_probe case⑮）。四裁决逐条对账——①案甲视野迷雾立项（纯呈现层）：迷雾开关分层验证可用（呈现态布尔，off 态=无迷雾基线），同板同动作序列与 MC 逐项比对逐位一致；②暗淡记忆态：区外已开格灰显+数字可读，明度按 [art-bible](../../../art/art-bible.md) §6.5 写入文档值（记忆板 #3A3A3A/记忆墨 #C4C4C4，provisional）；③灯光半径=微光环 8 格同圈：LIGHT_RADIUS=8 参数化（曼哈顿菱形，常量）；④提灯 +2、微光不扩：FOG_LANTERN_BONUS=+2（落码常量实名——本条旧记 LIGHT_RADIUS_LANTERN_BONUS 系文档侧拟名，随卡④入库对齐），类型微光仍贴身 8 邻格零改动。**〔2026-10-05 迭代14⑤接线注记〕公共接线面已就位**——`board_view.set_fog_lantern(enabled)`（true=半径 8+2、false=复原 0；写入即 refresh 重算雾态），半径算式消费 `_fog_lantern` 迷雾批已在位；ui_input_probe case⑮ 增接线断言（开=dist 9 格转可见+lantern=2／关=复原）。**〔2026-10-08 迭代 19 卡④入库注记〕载体到位+接线闭环=功能可达**——载体=秘宝·同调位新行 `fog_lantern`「魔法提灯」（treasure_items.tres 表尾追加，desc「灯光区半径+2」，slot_cost 1、营地秘宝匣同调装配获渠，行字段=用户「按推荐」全收）；生产路径=runner set_attunement→enc.attunement→begin_battle 注入 orchestrator 装配集→公共只读出口 `attune_has`→组合根呈现桥 `main._sync_fog_lantern` 每战首轮装配链**显式重算含否**（🔴 复原语义=禁战斗结束隐式复原——卸装/未装配写 0，断点续玩/跨关天然正确）；未装配=false 写 0=缺省零扰动基线逐位不变。顺带测试：case⑮ 载体级段（装配→lantern=2+dist R+1 转可见+卸装复原）+smoke 行字段/同调目录投影（九件→十件）/装配贯通断言+存档回归 Part 6+单测 fog_lantern_wiring（run_all 17→18 套）。原「提灯载体归 aux_items 新行随 Alpha 信息件重定批」登记去向就此注销（改道留痕=需求卡片-提灯载体道具批-2026-10-07 §一）。验收线（本篇「验收标准」视野迷雾行）逐条转正式验收：区内完整渲染／区外已开格灰显可读／区外未开格不可见／灯光区随移动跟随／两态结算逐位一致；实机目检人闸（迷雾观感/记忆态可读性/移动跟随流畅度）随出口闸。黑暗区域渲染规格承载 = art-bible §6.5（v3.5）。 ### 营地覆盖层：四柜台并排（程序占位——视觉终稿归营地视觉批） -营地覆盖层自 2026-10-12（迭代 21 落地）为**四柜台并排**布局：①树淬炼（树脊柱界面形态，营地主界面）②锻造工坊（钥匙门+点亮展开工作间）③秘宝匣（钥匙门+目录与同调装配）④奖励格图鉴（常开无门槛）——宽度不足横向滚动兜底；全部程序占位视觉（占位纪律延续，2026-10-11 用户令），**视觉与布局终稿归 HUD 营地视觉批**（未立项）。结构现行事实源 = [天赋树](../跨局循环/天赋树.md)「营地=树：统一模型」节（2026-10-13 迭代 21 反哺⑤落文登记——本篇原无营地柜台登记面，顺带补缺）。 +营地覆盖层自 2026-10-12（迭代 21 落地）为**四柜台并排**布局：①树淬炼（树脊柱界面形态，营地主界面）②锻造工坊（钥匙门+点亮展开工作间）③秘宝匣（钥匙门+目录与同调装配）④奖励格图鉴（常开无门槛）——宽度不足横向滚动兜底；全部程序占位视觉（占位纪律延续，2026-10-11 用户令），**视觉与布局终稿归 HUD 营地视觉批**（未立项）。结构现行事实源 = [天赋树](../跨局循环/天赋树.md)「营地=树：统一模型」节（2026-10-13 迭代 21 反哺⑤写入文档登记——本篇原无营地柜台登记面，顺带补缺）。 ### 可访问性基线：看得清、不闪、纯鼠标玩得通 diff --git a/design/gdd/systems/表现与支撑/音频.md b/design/gdd/systems/表现与支撑/音频.md index 5d6fcf8b..fe188a79 100644 --- a/design/gdd/systems/表现与支撑/音频.md +++ b/design/gdd/systems/表现与支撑/音频.md @@ -94,7 +94,7 @@ 明确不覆盖（切片期不出声）：坍塌显形连锁音效——与连锁动画同批对位设计，批次未定（见「待办」）；道具使用音频反馈——[秘宝](../跨局循环/秘宝.md)登记的表现打磨项，排 Alpha。 -切片期验收口径：必覆盖五个挂点逐点有声，缺一即不过；换掉临时音频文件不需要改动任何逻辑代码（临时与正式走同一批挂点）；挖掘、踩雷、结算、终局四类反馈听感互相可区分，负反馈不逐行轰炸；声音永远跟着已经发生的事走，禁止先于事件。 +切片期验完成径：必覆盖五个挂点逐点有声，缺一即不过；换掉临时音频文件不需要改动任何逻辑代码（临时与正式走同一批挂点）；挖掘、踩雷、结算、终局四类反馈听感互相可区分，负反馈不逐行轰炸；声音永远跟着已经发生的事走，禁止先于事件。 ### 坍塌显形：与连锁动画配对的音效半边 diff --git a/design/gdd/systems/跨局循环/元进度.md b/design/gdd/systems/跨局循环/元进度.md index 6a0d5af7..4830c428 100644 --- a/design/gdd/systems/跨局循环/元进度.md +++ b/design/gdd/systems/跨局循环/元进度.md @@ -62,14 +62,14 @@ | 柜台 | 内容 | 解锁渠道 | |---|---|---| | 属性锻造 | 生命上限、基础攻击、护甲等级——三档可重复升级的属性强化 | 钥石直购 | -| 秘宝匣 | 秘宝解锁与同调装配——**件的目录与效果权威定义在[秘宝](秘宝.md)「目录（重设计 v1）」**（12 件三档〔2026-10-11 裁回能器删/换装券撤/第四只手删〕；旧目录全退役只作素材库） | 解锁=混合制（基础件钥石购买/特定件条件解锁——见秘宝.md「道具从哪来」；装配只在冒险开始前配置，冒险中零更换途径〔2026-10-11 终裁〕）；**迭代 22 实装批落地（2026-10-12）**：购买钮（余额不足禁用态）+条件解锁进度呈现+分档装配呈现（名后缀·档位/未解锁禁装）+空目录合法态；柜台数据投影=`treasure_shop_status`（解锁态/条件进度/价格单点）；旧道具工坊渠道面（行族/词表/解锁函数）已随批退役；钥石定价与阈值 provisional 归调参批 | +| 秘宝匣 | 秘宝解锁与同调装配——**件的目录与效果权威定义在[秘宝](秘宝.md)「目录（重设计 v1）」**（12 件三档〔2026-10-11 裁回能器删/换装券撤/第四只手删〕；旧目录全退役只作素材库） | 解锁=混合制（基础件钥石购买/特定件条件解锁——见秘宝.md「道具从哪来」；装配只在冒险开始前配置，冒险中零更换途径〔2026-10-11 终裁〕）；**迭代 22 实装批落地（2026-10-12）**：购买钮（余额不足禁用态）+条件解锁进度呈现+分档装配呈现（名后缀·档位/未解锁禁装）+空目录合法态；柜台数据投影=`treasure_shop_status`（解锁态/条件进度/价格单点）；旧道具工坊渠道面（行族/词表/解锁函数）已顺带退役；钥石定价与阈值 provisional 归调参批 | | 奖励格图鉴 | 特殊奖励格的解锁——更强效果的格面 | 结构位现定；格子内容排 Alpha，随[地图战斗资源](../战斗循环/地图战斗资源.md)差异化批落地 | 属性锻造的树形节点结构已随迭代 12 落地在役——**结构/节点/数值的现行事实源 = [天赋树](天赋树.md)，本文不复制树侧内容、只作指路**；本柜台三档直线强化与树淬炼 flat 在注入面叠加生效（注入口径见下文「跨局注入」节）。 -属性锻造的攻击、护甲两档已按[锻造工坊](锻造工坊.md) v0.6（成文时名「武器锻造」，2026-10-11 更名）设计定案转为武器与护甲的独立等级路线——**行族本体随迭代 21 T5 退役、路线为新建行族，已随迭代 23 实装入库（2026-10-12，新表 `forge.tres`）**。营地钥石入口族换代（2026-10-13 v1.18 迭代 23 反哺落文）：buy_forge 随 forge_products 退役删除后，本柜台钥石消费写口 = **forge_buy_level（逐级锻造价）/ forge_buy_unlock（一次性解锁价）/ forge_select_weapon·armor（免费选中）**——写口唯一经 MetaProgression 锻造写口族（契约 9 写口单点，UI 只发意图）；钥石定价历史考古参数 20 钥石/150% 公比见 `meta.tres:82-84` 退役批注，provisional 投值终值归 M4。 +属性锻造的攻击、护甲两档已按[锻造工坊](锻造工坊.md) v0.6（成文时名「武器锻造」，2026-10-11 更名）设计定案转为武器与护甲的独立等级路线——**行族本体随迭代 21 T5 退役、路线为新建行族，已随迭代 23 实装入库（2026-10-12，新表 `forge.tres`）**。营地钥石入口族换代（2026-10-13 v1.18 迭代 23 反哺写入）：buy_forge 随 forge_products 退役删除后，本柜台钥石消费写口 = **forge_buy_level（逐级锻造价）/ forge_buy_unlock（一次性解锁价）/ forge_select_weapon·armor（免费选中）**——写口唯一经 MetaProgression 锻造写口族（契约 9 写口单点，UI 只发意图）；钥石定价历史考古参数 20 钥石/150% 公比见 `meta.tres:82-84` 退役批注，provisional 投值终值归 M4。 -**营地统一（2026-10-11 天赋树设计会话裁案甲；2026-10-13 v1.20 迭代 21 反哺落文——「落地前维持现役」过渡态终结）**：树=营地本体，本属性锻造柜台已随迭代 21 退役、属性升级唯一入口=树脊柱淬炼节点（四柜台并排已实装，2026-10-12 入库）。**完整模型（四柜台并排/钥匙工作间/图鉴常开）唯一事实源 = [天赋树](天赋树.md)「营地=树：统一模型」节——本文只登记本柜台在系统内的去留，不复制树侧内容。** +**营地统一（2026-10-11 天赋树设计会话裁案甲；2026-10-13 v1.20 迭代 21 反哺写入——「落地前维持现役」过渡态终结）**：树=营地本体，本属性锻造柜台已随迭代 21 退役、属性升级唯一入口=树脊柱淬炼节点（四柜台并排已实装，2026-10-12 入库）。**完整模型（四柜台并排/钥匙工作间/图鉴常开）唯一事实源 = [天赋树](天赋树.md)「营地=树：统一模型」节——本文只登记本柜台在系统内的去留，不复制树侧内容。** **投值语言锁定（2026-09-18 数值语言拍板）**：三柜台属性强化一律 **flat 整数加减**（"每级 +1 基础攻击"式，而非"+50% 攻击"式）——避开百分比词条被数值成长稀释的先例陷阱、守住数字可读性锚；具体每级数值仍归元进度设计批投值。 @@ -99,11 +99,11 @@ 执行口径：开始一次新冒险时，本系统按存档内的永久强化状态算好一份 override，逐字段显式传给战斗初始化——配置因此不是完全静态的，随游戏进程动态改变（用户拍板原话口径）。字段清单随柜台扩展：道具池、遭遇权重、奖励格解锁是集合操作，参数面登记**追加 / 替换**两种语义。 -**开局属性四层叠加（2026-10-12 v1.16 补登记——事实源=[锻造工坊](锻造工坊.md)「注入衔接」节 v0.6 / [天赋树](天赋树.md)；原「属性锻造三档是数值覆盖」随迭代 21 T5 行族退役换代为下述分层；2026-10-13 v1.18 迭代 23 反哺落文补终态句）**：开局属性 = 角色基础值 + 树生命/命中淬炼 flat + 锻造路线加值（当前选中武器的攻击加值 + 当前甲的 AC 加值——默认值由锻造工坊配置常驻持有、与柜台解锁状态解耦，当前选中读存档域）+ 局内加算区 flat。入战 AC 三层可加 = 甲型基础 AC + 甲路线等级加值 + 局内加算区累加——**第一层「甲型基础 AC」= 选中甲路线行 `base_ac`（`forge.tres`，轻 10/重 12/魔法护甲 9 provisional），已随迭代 23 实装在役（`effective_ac` 三层公式第一层，树 flat + 锻造路线加值同批在役）**。 +**开局属性四层叠加（2026-10-12 v1.16 补登记——事实源=[锻造工坊](锻造工坊.md)「注入衔接」节 v0.6 / [天赋树](天赋树.md)；原「属性锻造三档是数值覆盖」随迭代 21 T5 行族退役换代为下述分层；2026-10-13 v1.18 迭代 23 反哺写入补终态句）**：开局属性 = 角色基础值 + 树生命/命中淬炼 flat + 锻造路线加值（当前选中武器的攻击加值 + 当前甲的 AC 加值——默认值由锻造工坊配置常驻持有、与柜台解锁状态解耦，当前选中读存档域）+ 局内加算区 flat。入战 AC 三层可加 = 甲型基础 AC + 甲路线等级加值 + 局内加算区累加——**第一层「甲型基础 AC」= 选中甲路线行 `base_ac`（`forge.tres`，轻 10/重 12/魔法护甲 9 provisional），已随迭代 23 实装在役（`effective_ac` 三层公式第一层，树 flat + 锻造路线加值同批在役）**。 ### 解锁界面：双入口框架 -（2026-09-18 拍板）主菜单设营地独立入口（消费钥石、查看与管理永久强化）；局内状态面板（原称暂停层，2026-10-13 改名——游戏非实时无暂停语义）也可查看钥石余额与已解锁清单（只读）。钥石余额在 HUD 常驻展示。呈现 spec 已出生：[ux/camp.md](../../ux/camp.md) v1.0（2026-09-30 审计拍板点 4A 裁决落文——退役/封存件「已退役/已解锁·能力封存中」呈现语义随 spec 落位）；视觉终稿已随迭代 9 9A 段落码（2026-09-30）。本节锁框架与需求，呈现细节归 spec；局内状态面板入口已实装（2026-10-06 迭代 17 卡③〔时名暂停层〕——实机目检待用户，06 登记条在册）。 +（2026-09-18 拍板）主菜单设营地独立入口（消费钥石、查看与管理永久强化）；局内状态面板（原称暂停层，2026-10-13 改名——游戏非实时无暂停语义）也可查看钥石余额与已解锁清单（只读）。钥石余额在 HUD 常驻展示。呈现 spec 已出生：[ux/camp.md](../../ux/camp.md) v1.0（2026-09-30 审计拍板点 4A 裁决写入文档——退役/封存件「已退役/已解锁·能力封存中」呈现语义随 spec 落位）；视觉终稿已随迭代 9 9A 段落码（2026-09-30）。本节锁框架与需求，呈现细节归 spec；局内状态面板入口已实装（2026-10-06 迭代 17 卡③〔时名暂停层〕——实机目检待用户，06 登记条在册）。 ### 单局循环零依赖：排期边界的推论 @@ -132,7 +132,7 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)整体 | P1 | 三柜台内容铺量与定价数字 | 柜台结构已定稿；清单明细、几何定价的起步价与公比、Boss 两档产出数值，随设计批配读数投值 | | P1 | 秘宝匣钥石直购价 | **已投 provisional 占位**（普通档 10/优秀档 25 钥石，迭代 22 落地，2026-10-12）；终值归调参批（原「首版只挂通关次数渠道」排期态随混合制落地消解） | | P1 | 奖励格图鉴的格子内容 | 排 Alpha，随[地图战斗资源](../战斗循环/地图战斗资源.md)差异化批 | -| P1 | 换算率表数值行标定 | **已完成**（2026-09-23 换算率标定批——首版三行投值 6/9/1，护甲行强条目重测随批履行并修复护甲断链）（原系笔误孤例，registry 与 meta.tres 均为 6/9/1——2026-09-30 勘误） | +| P1 | 换算率表数值行标定 | **已完成**（2026-09-23 换算率标定批——首版三行投值 6/9/1，护甲行强条目重测顺带履行并修复护甲断链）（原系笔误孤例，registry 与 meta.tres 均为 6/9/1——2026-09-30 勘误） | | P2 | 营地界面与解锁呈现实现 | 归[HUD 框架](../表现与支撑/HUD框架.md)协作批，以表现层样张过审为前置 | ## 调参表 diff --git a/design/gdd/systems/跨局循环/天赋树.md b/design/gdd/systems/跨局循环/天赋树.md index 889a0644..bcd03ca1 100644 --- a/design/gdd/systems/跨局循环/天赋树.md +++ b/design/gdd/systems/跨局循环/天赋树.md @@ -1,9 +1,9 @@ # 天赋树 > 一句话：营地本身——跨局成长的结构承载：钥石逐节点点亮一棵树，属性淬炼、工作间解锁、规则抉择与同调挂载全部组织在树上 -> 状态：**v0.10 R1 机制位批（2026-10-13，用户推翻迭代 21 追认单 #1 裁撤案）**——「等级阈值前置」以机制位形态随批重立：schema 新增 `requires_level: {node_id: n}`（前置节点等级 ≥ n 才可购；键悬空/阈值 <1/类型错加载即拒）+ 购买判定分支 + 行板门槛呈现（未达标 🔒 标+悬停门槛文案）+ 单测八断言；**现役 12 行零配置=机制位空转零行为影响**，配置归表行随需填。承 v0.9 迭代 21 反哺落文（2026-10-13，用户裁「按呈报落文」）——全文档换代为 12 节点落地实态：头部实装态 / 节点总表前言 / schema 连带 / 已建未接面（三条→两接一维持）/ P0 段 / 依赖表 / 验收实态七处换代；「设计避让」句按卡片 v1.7 ⑪②裁决改写为折扣定义边界口径。承 v0.8 Fork 一节点双态换代（2026-10-11 用户裁——开局姿态/危险直觉/财富之道三天赋=三节点、购买解锁后 A/B 双态可切，现役 A/B 双行结构收编、全树 15→12） +> 状态：**v0.10 R1 机制位批（2026-10-13，用户推翻迭代 21 追认单 #1 裁撤案）**——「等级阈值前置」以机制位形态顺带重立：schema 新增 `requires_level: {node_id: n}`（前置节点等级 ≥ n 才可购；键悬空/阈值 <1/类型错加载即拒）+ 购买判定分支 + 行板门槛呈现（未达标 🔒 标+悬停门槛文案）+ 单测八断言；**现役 12 行零配置=机制位空转零行为影响**，配置归表行随需填。承 v0.9 迭代 21 反哺写入（2026-10-13，用户裁「按呈报写入文档」）——全文档换代为 12 节点落地实态：头部实装态 / 节点总表前言 / schema 连带 / 已建未接面（三条→两接一维持）/ P0 段 / 依赖表 / 验收实态七处换代；「设计避让」句按卡片 v1.7 ⑪②裁决改写为折扣定义边界口径。承 v0.8 Fork 一节点双态换代（2026-10-11 用户裁——开局姿态/危险直觉/财富之道三天赋=三节点、购买解锁后 A/B 双态可切，现役 A/B 双行结构收编、全树 15→12） -> **📖 节点台账指引（读这份文档先看这里）**：本树全部 12 个节点=下方「核心规则 → 节点总表」，逐节点列名称/脉/类型/前置/效果方向；**全部数值行（价格 / 等级上限 / 每级效果取值 / 限次值）不在本文**，事实源 = 配置文件 `game/data/tables/meta_tree.tres`（provisional 归数值批）。要查"有哪些节点、怎么连"看本文总表，要查"多少钱、加多少"开配置文件。 +> **📖 节点状态记录指引（读这份文档先看这里）**：本树全部 12 个节点=下方「核心规则 → 节点总表」，逐节点列名称/脉/类型/前置/效果方向；**全部数值行（价格 / 等级上限 / 每级效果取值 / 限次值）不在本文**，事实源 = 配置文件 `game/data/tables/meta_tree.tres`（provisional 归数值批）。要查"有哪些节点、怎么连"看本文总表，要查"多少钱、加多少"开配置文件。 ## 设计目的 @@ -19,7 +19,7 @@ | 负责 | 说明 | |---|---| -| 节点结构与解锁规则 | 12 节点的一脊三脉构成、脊柱行门槛（节点第 N 级）、点亮前置（requires）+ **等级阈值前置（requires_level——R1 机制位 2026-10-13 随批重立，现役零配置空转）**、Fork 一节点双态与免费切换、彩蛋觉醒——结构事实源 = `data/tables/meta_tree.tres` + schema MetaTreeTable（**已实装在役，迭代 21 T1**） | +| 节点结构与解锁规则 | 12 节点的一脊三脉构成、脊柱行门槛（节点第 N 级）、点亮前置（requires）+ **等级阈值前置（requires_level——R1 机制位 2026-10-13 顺带重立，现役零配置空转）**、Fork 一节点双态与免费切换、彩蛋觉醒——结构事实源 = `data/tables/meta_tree.tres` + schema MetaTreeTable（**已实装在役，迭代 21 T1**） | | 树的购买与货币规则 | 全树钥石单币；free 节点零币；购买校验四件套（等级上限 / 行门槛 / 前置 / 未解锁） | | 营地统一模型 | 树=营地本体（呈现=四柜台并排）：生命/命中淬炼唯一入口=树脊柱淬炼节点，攻/AC 唯一入口=锻造工坊路线（所有权切分，2026-10-11 裁）；工作间钥匙模型（锻造工坊 / 秘宝匣）；图鉴常开；旧属性锻造柜台退役（生命归脊柱、攻防归锻造工坊） | | 树域存档的内容语义 | tree_nodes（node_id→已购等级）与 fork_sides（fork_group→激活态）两域语义；旧档废弃规则（开发阶段无迁移——2026-10-11 用户裁） | @@ -67,7 +67,7 @@ | 钥石脉（keystone） | 2 | 秘宝匣（kind=unlock，free，工作间钥匙）/ 刷新升级（kind=rule） | 前置链：秘宝匣 ← 脊柱生命第 1 级；刷新升级 ← 秘宝匣 | | 同调脉（attune） | 6 | 同调位 1/2/3 三节点（kind=socket）+ Fork 3 节点（kind=fork，一节点双态）= **3 同调位 + 3 双态开关节点** | **同调位 1 为根节点、无前置**，其后逐级前置（1→2→3）；全部 Fork 前置 = 同调位 1；Fork=开局姿态/危险直觉/财富之道各一节点（2026-10-11 用户裁：一节点双态、解锁后 A/B 可切——非六节点） | -节点类型是封闭枚举六类：stat（生命/命中两线数值）/ rule（全局规则）/ unlock（内容解锁）/ socket（同调位）/ fork（一节点双态开关）/ easter（彩蛋觉醒）。字段、词表与跨字段约束由 schema 校验（MetaTreeTable.validate：脉 / 类型 / 币出域即拒、effects 键封闭、Fork 三组每组恰一节点、彩蛋 ≤3、禁 archetype 键——加载期校验）。**schema 连带已随迭代 21 T1 落地**：Fork 由 A/B 双行改单行双态（行持 a/b 双效果键 effects_a/b+name_a/b，效果按激活态取值；Fork 组词表 4→3 组）、规则键词表 2→6 键（见 Fork 节）、row 字段随一线一节点退役；「等级阈值前置」机制位 **2026-10-13 随批重立**（requires_level 字段+加载校验，现役零配置——见头部状态行）。 +节点类型是封闭枚举六类：stat（生命/命中两线数值）/ rule（全局规则）/ unlock（内容解锁）/ socket（同调位）/ fork（一节点双态开关）/ easter（彩蛋觉醒）。字段、词表与跨字段约束由 schema 校验（MetaTreeTable.validate：脉 / 类型 / 币出域即拒、effects 键封闭、Fork 三组每组恰一节点、彩蛋 ≤3、禁 archetype 键——加载期校验）。**schema 连带已随迭代 21 T1 落地**：Fork 由 A/B 双行改单行双态（行持 a/b 双效果键 effects_a/b+name_a/b，效果按激活态取值；Fork 组词表 4→3 组）、规则键词表 2→6 键（见 Fork 节）、row 字段随一线一节点退役；「等级阈值前置」机制位 **2026-10-13 顺带重立**（requires_level 字段+加载校验，现役零配置——见头部状态行）。 ### 节点总表（12 节点） @@ -94,7 +94,7 @@ 所有付费节点只收钥石（2026-10-07 用户裁甲落定；行内 currency 字段保留为呈现元数据）。free 节点零币：两枚工作间钥匙（锻造工坊 / 秘宝匣）与彩蛋（觉醒）不经购买消费。 -购买校验四件套，全部通过才受理：①当前等级未满上限；②行门槛——脊柱节点第 N 级需全树已购总等级 ≥ 4×(N−1)（总等级口径 = tree_nodes 全部节点等级之和，免费点亮与分叉激活均计入——2026-10-11 歧义扫描裁甲沿现役实态；常量 SPINE_ROW_GATE=4；2026-10-11 一线一节点换代后门槛主语=节点目标等级，原层行判定作废；达成节奏重算归数值批）；③requires 前置满足——点亮前置（前置节点全部已点亮）+ **等级阈值前置（requires_level：指定前置节点等级 ≥ n——R1 机制位 2026-10-13 随批重立，2026-10-12 曾按卡片默认裁撤案执行、用户推翻补机制位；现役 12 行零配置空转，配置归表行随需填）**；④Fork 节点未解锁（一节点双态——解锁后的态切换走零币切换口，不经购买）。执行购买时另查钥石余额：余额不足则购买失败，存档零副作用（等级、余额、激活态均不动）。 +购买校验四件套，全部通过才受理：①当前等级未满上限；②行门槛——脊柱节点第 N 级需全树已购总等级 ≥ 4×(N−1)（总等级口径 = tree_nodes 全部节点等级之和，免费点亮与分叉激活均计入——2026-10-11 歧义扫描裁甲沿现役实态；常量 SPINE_ROW_GATE=4；2026-10-11 一线一节点换代后门槛主语=节点目标等级，原层行判定作废；达成节奏重算归数值批）；③requires 前置满足——点亮前置（前置节点全部已点亮）+ **等级阈值前置（requires_level：指定前置节点等级 ≥ n——R1 机制位 2026-10-13 顺带重立，2026-10-12 曾按卡片默认裁撤案执行、用户推翻补机制位；现役 12 行零配置空转，配置归表行随需填）**；④Fork 节点未解锁（一节点双态——解锁后的态切换走零币切换口，不经购买）。执行购买时另查钥石余额：余额不足则购买失败，存档零副作用（等级、余额、激活态均不动）。 写口唯一：营地界面只发购买意图信号（tree_buy_requested），扣币、升级、写盘全部经 MetaProgression.tree_buy；Fork 节点购买走 tree_buy_fork（购即解锁、默认 A 态），态切换走 tree_toggle_fork（零币、只改激活态）。 @@ -108,7 +108,7 @@ Fork 组是封闭词表三组（2026-10-11 裁：克制专精整组砍除，类 |---|---|---|---| | fg_posture 开局姿态 | 先手压制 = 每关首轮 AP +1 | 稳健拓荒 = 每关首轮内受击减伤 | 两侧同收**每关首轮窗**（每关第一场战斗的第一轮，第二关自动刷新——时间范围一致性裁甲） | | fg_sense 危险直觉 | 锋 = 踩中危险格伤害减半·每关限次 | 守 = 危险格标记错误返还行动点·每关限次 | 唯一根植排雷半边的组；玩家文案沿用「危险格 / 安全格」正主词，不出现雷字、不另造别名（2026-10-11 歧义扫描裁甲，废「陷阱/危险标记」自造词）。**前提核实在册**：标记错误机制存在性随实装批 T0 实查，查无则守侧换安全网向等价效果经用户裁 | -| fg_economy 财富之道 | 聚 = 战斗掉落 GP 增益 | 散 = GP 消费折价 | 范围（2026-10-11 歧义扫描裁）：聚 = **仅战斗掉落渠道**；散 = **全部 GP 消费面**。**折扣定义边界（2026-10-12 卡片 v1.7 ⑪②裁决落文——原「设计避让」句按裁决改写）**：散的折价只覆盖商品购买价（键 `gp_cost_mult`），不含三选一付费刷新与商店刷新（`shop_refresh_cost` 不折）——这是折扣的定义边界本身，非对外两处旋钮的临时避让 | +| fg_economy 财富之道 | 聚 = 战斗掉落 GP 增益 | 散 = GP 消费折价 | 范围（2026-10-11 歧义扫描裁）：聚 = **仅战斗掉落渠道**；散 = **全部 GP 消费面**。**折扣定义边界（2026-10-12 卡片 v1.7 ⑪②裁决写入文档——原「设计避让」句按裁决改写）**：散的折价只覆盖商品购买价（键 `gp_cost_mult`），不含三选一付费刷新与商店刷新（`shop_refresh_cost` 不折）——这是折扣的定义边界本身，非对外两处旋钮的临时避让 | 「每关限次」的计数生命周期（2026-10-11 歧义扫描裁甲）：限次计数随单次冒险持久、按关重置、新冒险清零、断点续玩保留。 @@ -134,7 +134,7 @@ A/B 态只放规则面：节点行持 a/b 双效果键（封闭规则键词表 R ② 规则通道——tree_rule_keys = 各 Fork 组激活态的效果键集，经冒险开始参数面 tree_rules 下传；每场战斗 begin_battle 时由效果引擎 rebuild 合成订阅行生效。开新冒险与继续上局两入口同参同值。 -### 已建未接面（接线落地态——2026-10-13 迭代 21 反哺落文换代） +### 已建未接面（接线落地态——2026-10-13 迭代 21 反哺写入换代） 三条原「已建表/已可购但消费面未接」的实态，**两条已随迭代 21 接线在役、一条维持纪律**： @@ -157,7 +157,7 @@ A/B 态只放规则面：节点行持 a/b 双效果键（封闭规则键词表 R ## P0 最小闭环 -**P0 语义已随迭代 21 全量落地（2026-10-12 入库；2026-10-13 反哺落文换代——原「33 节点现役态维持」过渡态终结）**：12 节点结构（脊柱 = 生命/命中一线一节点、Fork = 三节点双态）+ 营地统一（树 = 营地本体、生命/命中唯一入口、攻防归锻造工坊、工作间钥匙、四柜台呈现）+ 三组 Fork 双态真效果 + 购买/切换/门槛/彩蛋/注入/旧档废弃全链，机检 = 冒烟 886/0 + run_all 22 套 + probe 全绿 + MC 三组配对差 0.0pp（迭代 21 出口闸读数）；残留人闸 = 实机目检营地四柜台（07 ⑳）。旧 33 节点结构随 `TREE_STRUCT_VERSION=2` 废弃重置（禁迁移，Q3 裁）。 +**P0 语义已随迭代 21 全量落地（2026-10-12 入库；2026-10-13 反哺写入换代——原「33 节点现役态维持」过渡态终结）**：12 节点结构（脊柱 = 生命/命中一线一节点、Fork = 三节点双态）+ 营地统一（树 = 营地本体、生命/命中唯一入口、攻防归锻造工坊、工作间钥匙、四柜台呈现）+ 三组 Fork 双态真效果 + 购买/切换/门槛/彩蛋/注入/旧档废弃全链，机检 = 冒烟 886/0 + run_all 22 套 + probe 全绿 + MC 三组配对差 0.0pp（迭代 21 出口闸读数）；残留人闸 = 实机目检营地四柜台（07 ⑳）。旧 33 节点结构随 `TREE_STRUCT_VERSION=2` 废弃重置（禁迁移，Q3 裁）。 ## P1 / P2 后置 @@ -181,7 +181,7 @@ A/B 态只放规则面：节点行持 a/b 双效果键（封闭规则键词表 R ## 验收标准 -> **落地实态（2026-10-13 反哺落文注）**：下列各条已随迭代 21 实装并过出口闸——机检 = 冒烟 886/0（V1-V10/V16 断言随批）+ run_all 22 套（tree_rules_v11_test 六键闭集）+ probe --click/--full 八探针 + render_gate + MC 三组同种子配对差 0.0pp（V19）；残留人闸 = 实机目检营地四柜台（07 ⑳）。命中线「暂不注入」括注 = 契约 6 纪律维持（非缺陷——消费面开启归数值批）。 +> **落地实态（2026-10-13 反哺写入注）**：下列各条已随迭代 21 实装并过出口闸——机检 = 冒烟 886/0（V1-V10/V16 断言顺带）+ run_all 22 套（tree_rules_v11_test 六键闭集）+ probe --click/--full 八探针 + render_gate + MC 三组同种子配对差 0.0pp（V19）；残留人闸 = 实机目检营地四柜台（07 ⑳）。命中线「暂不注入」括注 = 契约 6 纪律维持（非缺陷——消费面开启归数值批）。 - 结构封闭：meta_tree.tres 通过 schema 校验零违例——12 节点、脉 / 类型 / 币词表出域即拒、Fork 三组每组恰一节点且持 a/b 双效果键、彩蛋 ≤3、effects 键封闭、零 archetype 键。 - 行门槛可判：全树已购总等级 < 4×(N−1) 时脊柱节点第 N 级不可购；总等级达标当刻该级开放购买。 diff --git a/design/gdd/systems/跨局循环/生涯.md b/design/gdd/systems/跨局循环/生涯.md index 344aff46..baabc742 100644 --- a/design/gdd/systems/跨局循环/生涯.md +++ b/design/gdd/systems/跨局循环/生涯.md @@ -6,7 +6,7 @@ ## 一、信息架构 -生涯入口是主菜单一级按钮，与营地平级（2026-10-06 用户裁，备选案与淘汰依据见需求卡片 P1）。现行主菜单按钮组由 `build_start_overlay` 构造（`game/presentation/ui_assembler.gd:103`）：「冒险」组（继续上局 / 开始冒险）与「营地与系统」组（营地 / 生涯〔期一已落位，营地钮与设置钮之间〕 / 设置 / 退出游戏）。具体行序排版属实装细节随批落位（本文不画布局稿）。 +生涯入口是主菜单一级按钮，与营地平级（2026-10-06 用户裁，备选案与淘汰依据见需求卡片 P1）。现行主菜单按钮组由 `build_start_overlay` 构造（`game/presentation/ui_assembler.gd:103`）：「冒险」组（继续上局 / 开始冒险）与「营地与系统」组（营地 / 生涯〔期一已落位，营地钮与设置钮之间〕 / 设置 / 退出游戏）。具体行序排版属实装细节顺带落位（本文不画布局稿）。 ``` 主菜单（开始覆盖层） @@ -86,7 +86,7 @@ ## 五、待裁点 -P0-P5 六点已于 2026-10-06 用户全裁（案甲 × 6，备选案与淘汰依据在需求卡片 §8），结论已落文上文对应节，不重复列。本批新发现的待裁点一项： +P0-P5 六点已于 2026-10-06 用户全裁（案甲 × 6，备选案与淘汰依据在需求卡片 §8），结论已写入上文对应节，不重复列。本批新发现的待裁点一项： ### P6 · 营地底栏「最近冒险」条带去留（期二必答项） diff --git a/design/gdd/systems/跨局循环/秘宝.md b/design/gdd/systems/跨局循环/秘宝.md index 26e76555..17cb178f 100644 --- a/design/gdd/systems/跨局循环/秘宝.md +++ b/design/gdd/systems/跨局循环/秘宝.md @@ -7,7 +7,7 @@ ## 定位与形态 -**现行形态 = 局外同调件**：开局前在营地装配（营地·秘宝匣柜台「同调装配」段）、占同调位（0 起步、固定 3 格，每件固定占 1 格）、被动件整局生效/主动件每冒险充能（冒险开始重置）。实现面 = `treasure_items.tres` + `game/core/attunement.gd`（同调位数量判定源=天赋树同调位节点点亮数——2026-10-11 Q2 裁甲、迭代 21 T4 槽位收编落地；原 `attunement_growth.tres` 谓词表已随批退役；解锁条件=数据行内 `unlock_requires` 字段承载——迭代 22 实装落地，2026-10-12）。**新目录 12 件已随迭代 22 实装批全量落地（2026-10-12，T1-T7）**，逐件实录见「目录（重设计 v1）」各表实态列。 +**现行形态 = 局外同调件**：开局前在营地装配（营地·秘宝匣柜台「同调装配」段）、占同调位（0 起步、固定 3 格，每件固定占 1 格）、被动件整局生效/主动件每冒险充能（冒险开始重置）。实现面 = `treasure_items.tres` + `game/core/attunement.gd`（同调位数量判定源=天赋树同调位节点点亮数——2026-10-11 Q2 裁甲、迭代 21 T4 槽位收编落地；原 `attunement_growth.tres` 谓词表已顺带退役；解锁条件=数据行内 `unlock_requires` 字段承载——迭代 22 实装落地，2026-10-12）。**新目录 12 件已随迭代 22 实装批全量落地（2026-10-12，T1-T7）**，逐件实录见「目录（重设计 v1）」各表实态列。 **沿革一句话**：本系统前身为切片期掉落消耗品形态（2026-09-29 迭代 7），2026-10-03 随同调实施批整体替换为现行形态；旧目录九件已全数退役入素材库（2026-10-08/10 用户裁）。历史细节见版本历史与 git 提交史。 diff --git a/design/gdd/systems/跨局循环/锻造工坊.md b/design/gdd/systems/跨局循环/锻造工坊.md index 8eb783ec..9aa45c71 100644 --- a/design/gdd/systems/跨局循环/锻造工坊.md +++ b/design/gdd/systems/跨局循环/锻造工坊.md @@ -1,7 +1,7 @@ # 锻造工坊 > 一句话：营地的武器与护甲成长——武器锻造区三条路线、护甲锻造区三条路线各练各的，钥石消费，一次冒险各选一件，满级特效留位本期不做 -> 状态：**v0.8 迭代 21 反哺④残余落文（2026-10-13）**——「树侧钥匙」句换代：钥匙节点 forge_workshop 已随迭代 21 实装在役（free 无前置、点亮展开本柜台、锁定态零购买路径），原「实装归 06」悬置指针终结（详见版本历史 v0.8 行）。承 v0.7 迭代 23 反哺落文（2026-10-13）——正文补 Q1 等级语义衔接（0 = 未练合法态）、效果类型闭集 24→31 订正、实装边界 1 回填实装实态（已随迭代 23 入库）。承 v0.6 完备性检查批（承 v0.5 B 组定案——**17 裁点全数清零**：1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名；2c、5a 已于 v0.4 结案）。**v0.6 变更（2026-10-12 完备性检查批·grilling 用户逐条裁）**：现役事实基线换代（forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径）；**两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入）；「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**（只留扩展位）；全部数值 provisional，终值归 Alpha 收官 M4 数值批〔未排期〕；实装待办在册 [06-待办清单](../../06-待办清单.md)「锻造工坊实装批」条——**开工门 = 17 裁点清零 + 用户发令，裁点门已满足** +> 状态：**v0.8 迭代 21 反哺④残余写入文档（2026-10-13）**——「树侧钥匙」句换代：钥匙节点 forge_workshop 已随迭代 21 实装在役（free 无前置、点亮展开本柜台、锁定态零购买路径），原「实装归 06」悬置指针终结（详见版本历史 v0.8 行）。承 v0.7 迭代 23 反哺写入（2026-10-13）——正文补 Q1 等级语义衔接（0 = 未练合法态）、效果类型闭集 24→31 订正、实装边界 1 回填实装实态（已随迭代 23 入库）。承 v0.6 完备性检查批（承 v0.5 B 组定案——**17 裁点全数清零**：1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名；2c、5a 已于 v0.4 结案）。**v0.6 变更（2026-10-12 完备性检查批·grilling 用户逐条裁）**：现役事实基线换代（forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径）；**两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入）；「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**（只留扩展位）；全部数值 provisional，终值归 Alpha 收官 M4 数值批〔未排期〕；实装待办在册 [06-待办清单](../../06-待办清单.md)「锻造工坊实装批」条——**开工门 = 17 裁点清零 + 用户发令，裁点门已满足** > 成文底稿：`design/research/提案-武器锻造系统-2026-10-07.md`（提案过程稿——全部备选案与淘汰依据、用户原案逐条对照见彼；本文只收录定案口径；**未启用的满级特效候选池亦留彼 §八**，不进正文） ## 设计目的 @@ -51,7 +51,7 @@ **工作间内两区并列**（A③ 裁）：武器区/护甲区并列呈现，机制层面零顺序门槛；同屏分栏或页签切换=呈现细节归 HUD 批。 -**树侧钥匙（2026-10-11 裁：无前置）**：本柜台由天赋树「锻造工坊」钥匙节点展开——free 节点、**无前置条件、直接可点亮**（原「攻击淬炼累计 ≥2 级 且 护甲淬炼累计 ≥2 级」等级阈值前置，随树脊柱砍攻/护两线作废）；未点亮时本柜台锁定态，点亮后开放。树侧结构换代（脊柱砍攻/护两线 + 一线一节点 + Fork 一节点双态，三轮换代 **29→21→15→12**，地脉共鸣条件效果随之换代——2026-10-12 订正：原记「29→21」系 v0.6 时点旧数，树侧现行终态 12 节点）设计权威文档 = [天赋树](天赋树.md)；**钥匙节点 forge_workshop 已随迭代 21 实装在役（2026-10-12 入库——free 无前置、点亮展开本柜台、锁定态零购买路径），2026-10-13 反哺落文换代原「实装归 06」悬置指针**。 +**树侧钥匙（2026-10-11 裁：无前置）**：本柜台由天赋树「锻造工坊」钥匙节点展开——free 节点、**无前置条件、直接可点亮**（原「攻击淬炼累计 ≥2 级 且 护甲淬炼累计 ≥2 级」等级阈值前置，随树脊柱砍攻/护两线作废）；未点亮时本柜台锁定态，点亮后开放。树侧结构换代（脊柱砍攻/护两线 + 一线一节点 + Fork 一节点双态，三轮换代 **29→21→15→12**，地脉共鸣条件效果随之换代——2026-10-12 订正：原记「29→21」系 v0.6 时点旧数，树侧现行终态 12 节点）设计权威文档 = [天赋树](天赋树.md)；**钥匙节点 forge_workshop 已随迭代 21 实装在役（2026-10-12 入库——free 无前置、点亮展开本柜台、锁定态零购买路径），2026-10-13 反哺写入换代原「实装归 06」悬置指针**。 **注入衔接（所有权切分，2026-10-11 裁）**：每根数值轴全游戏单一来源——生命/命中唯一入口=树脊柱；**攻击唯一入口=武器路线、AC 唯一入口=甲路线（本系统）**，树零攻防来源（红线）。锻造路线加值 = 当前武器攻击加值 + 当前甲路线 AC 加值，与树淬炼 flat、局内加算区在开局属性注入面分层相加（通道现行事实源 = [元进度](元进度.md)「跨局注入」节）；锻造加值只按**当前选中**的武器/甲生效（长剑的练度在换带长枪后回家待命，不丢级、不生效）。 @@ -106,7 +106,7 @@ - 每条路线（三武器 + 三甲）的等级终点各预留 1–2 条特效挂点，本期**为空位**； - 启用前提 = 后续专门立项，**不随锻造工坊实装批落地**； -- 启用时沿用的既有约束：优先复用现役效果引擎效果类型闭集（**31 种**——2026-10-13 迭代 23 反哺落文订正，原记 24 系 2026-10-07 旧快照；迭代 20 T1 +7、迭代 22 T3 +1），**不往闭集加新词**——闭集是高代价变更面（加载校验 / 文档词表 / 回归测试三处连带）； +- 启用时沿用的既有约束：优先复用现役效果引擎效果类型闭集（**31 种**——2026-10-13 迭代 23 反哺写入订正，原记 24 系 2026-10-07 旧快照；迭代 20 T1 +7、迭代 22 T3 +1），**不往闭集加新词**——闭集是高代价变更面（加载校验 / 文档词表 / 回归测试三处连带）； - 未启用的候选池（长剑破甲 / 长剑暴击面扩大 / 长枪先手连击 / 法杖开局魔法矢 / 轻甲灵巧 / 重甲反震 / 魔法护甲护盾，共七条）**不进正文**，留在过程稿 `design/research/提案-武器锻造系统-2026-10-07.md` §八，届时取用或推翻。 **对相邻口径的三处连带**：① 设计目的节"能力解锁的节奏"台阶收缩为新武器 / 新甲型解锁（不再含特效）；② 实装边界不再有"特效三条新参数位"条目；③ 存档域不设特效域。 @@ -132,7 +132,7 @@ | 敌方装甲分布：轻甲×14 / 重甲×4 / 魔法护甲×1（L2 Boss 蛛化卓尔精灵） | `enemy.tres` | | 甲效矩阵 normal 行取值：轻甲 0 / 魔法护甲 +1 / 重甲 −1（整数点数：+1 被克 / 0 中性 / −1 挡住） | `settlement.tres:31-47` | | 敌方攻击类型轴**未开**——单据 `attack_type` 栏现役为 `""`（空串恒不查矩阵，`""` 与"群伤/反噬/地形/敌方技"同列无类型族）；`enemy.tres` 登记「敌方技能攻击类型轴仍未开（全部 normal 档）」 | `damage_controller.gd:19/:550-552`、`enemy.tres:527` | -| 效果引擎效果类型闭集 **31 种**（原记 24 系 2026-10-07 旧快照——迭代 20 T1 +7、迭代 22 T3 +1，2026-10-13 迭代 23 反哺落文订正；冒烟断言钉 31，将来加词即转红提示复核） | `effect_engine.gd` | +| 效果引擎效果类型闭集 **31 种**（原记 24 系 2026-10-07 旧快照——迭代 20 T1 +7、迭代 22 T3 +1，2026-10-13 迭代 23 反哺写入订正；冒烟断言钉 31，将来加词即转红提示复核） | `effect_engine.gd` | | 营地消费货币=钥石（现役入口 tree_buy / buy_attune_refresh → spend_keystone——buy_forge 随 forge_products 退役删除）；GP=局内一次性货币，开局清零不入存档 | `meta_progression.gd:175/:354`、`adventure_runner.gd:116` | ## 实装边界（执行归实装批，本文只登记方案） @@ -143,7 +143,7 @@ 4. **存档域**：新增三武器等级 + 三甲等级 + 当前选中标记（各 1 个）；**不设特效域**（6 裁）。旧档按开发阶段无迁移红线破坏性废弃（2026-10-11 用户裁，禁迁移/折算）。**已于 2026-10-12 v0.6 完备性检查批预登记**（存档序列化.md 域清单表 + 版本沿革 v7 计划行——用户令文档批次即登记、不等实装批）。 5. **满级特效：本期不实装**（6 裁）——不开三条新参数位（暴击面 / 折扣档 / 护盾量），不加效果类型词，扩展位留空。 6. **敌方攻击类型轴填值（3b 裁连带，跨系统汇合点）**：敌方攻击单据 `attack_type` 按「未设置 = 默认 normal」填值，使其参与克制矩阵查表（现役为 `""` 恒不查）。**执行面归敌人系统 / 战斗结算侧**，锻造工坊实装批只登记该需求与其数值影响——该改动会全局平移主角受伤点数（穿重甲 −1、穿魔法护甲 +1），属数值敏感变更，须纳入第 8 条的配对读数验证。敌方 attack_type 是敌方定义数据（enemy.tres / skills.tres 行级，与敌种名字/血量同批同时读写、无独立时序），填值归敌人系统/战斗结算侧自然推进——本批只按 3b 裁落结构面（矩阵查表现役已支持），与锻造工坊批期无耦合（2026-10-12 订正：原「两批排期协商（可同批做，也可先行）」句删除——用户裁：时序问题不存在）。 -7. **术语登记**：三型甲统一命名——**只有「魔法护甲」（「魔法甲」系笔误，不登记为别名）**；连同工作间两区定名（武器锻造区 / 护甲锻造区）随批登记 `design/registry/entities.yaml`。 +7. **术语登记**：三型甲统一命名——**只有「魔法护甲」（「魔法甲」系笔误，不登记为别名）**；连同工作间两区定名（武器锻造区 / 护甲锻造区）顺带登记 `design/registry/entities.yaml`。 8. **数值验证义务**：实装批必须带改前/改后同随机种子配对读数验证难度影响；统一调整归 Alpha 收官 M4 数值批。 ## 裁决结果清单（17 裁点全表·2026-10-12 清零） @@ -237,5 +237,5 @@ | v0.5 | 2026-10-12 | **B 组定案落文（锻造工坊裁决会话续，用户逐点裁决）——17 裁点清零**：①1 丙=当前武器单选+每件独立路线；②1a 扩面=**一次冒险一个武器类型+一个甲型**（原只问武器携带数）；③1b/1c=营地免费切换·冒险开始后锁死；④**2a 推翻**——伪裁点消解：伤害结算只有一套、单据自带 attack_type 栏，删"叠加/替代/互斥"三分法，改陈述「同一矩阵·单据自带类型·差异只在单据形态与生命周期」；⑤**2b 随 3a 自动消解**（非独立裁点，条件是"魔法甲≠ward"）；⑥3a=统一命名**魔法护甲**（ward；「魔法甲」系**笔误**不做简称处理，registry 不登记别名）；⑦**3b 推翻**——敌方攻击有类型、未设置=默认普通 ⇒ 甲型差异「基础 AC + 克制修正」两轴当下即生效，原"诚实收窄/克制反向留结构位"整段作废，并如实登记现役落差（敌方单据 attack_type="" 恒不查矩阵、`enemy.tres:527` 轴未开）为**跨系统汇合点**（填值面归敌人系统/战斗结算）+ 连带后果（三型成纯序、魔法护甲双负无优势窗口）；⑧3c=每型独立路线；⑨4a=前缓后陡（只锁方向）；⑩**4a-1 撤回**——"曲线×定价=又贵又弱"结论无依据，不落方向性判断，只留"两条旋钮同批标定"程序句；⑪4b=锻造内自闭环；⑫4b-1=**并联双通道**（练满前一档 OR 一次性解锁价，互不影响）；⑬5b=纯钥石（用户注：后续若要区分再重构，不预先建面）；⑭5c=零材料；⑮**6 推翻**——满级特效**本期不做**，只留扩展位（不设计清单/不定值/不实装/不开参数位/存档不设特效域），七条候选池退回过程稿 §八；⑯8a=工作间**两区定名 + 路线行名**（区=武器锻造区/护甲锻造区；行=长剑锻造·长枪锻造·法杖锻造、轻甲锻造·重甲锻造·魔法护甲锻造，第一件武器显示名 剑→**长剑**）；**并核结用户指出的事实——局内不存在武器/护甲提升**：商店货架三行"攻击锻升/生命锻升/护甲锻升"实为奇物「属性值提升」三轴的货架前台标签（`shop.tres` pool_shelf kind_id → `adventure.tres` CURIO_KINDS），与锻造无关，是否去"锻"字归实装批呈现面。连带：设计目的节能力台阶收缩为新武器/新甲解锁；实装边界重编号（特效条目改"本期不实装"、新增敌方攻击类型填值条）；「待裁决清单」换代为「裁决结果清单（17 裁点全表）」+新增「工作间内容清单（实装批需求卡片输入）」两件交付。**同日五点澄清（不升版本）**：①2a 用户确认无异议——按**统一伤害轴**走（删三分法）；②2b 连带确认：只有魔法护甲一型，**「魔法甲」系笔误**而非别名，registry 不登记别名、第四甲型议题彻底消解；③3b 的连带后果**不在本批考虑**——用户裁定其为**后续开发改造的前置信息**（敌方攻击差异化与魔法护甲正当性归后续批，本批只按统一伤害轴落结构与字段）；④**8a 的 Y 层**（路线行名）定案="件名 + 锻造"，第一件武器显示名 剑 → **长剑**；⑤**用户指出局内不存在武器提升——属实**：货架三行"锻升"是奇物「属性值提升」三轴（`shop.tres` pool_shelf 的 kind_id 指向 `adventure.tres` CURIO_KINDS）的货架前台标签，进冒险加算区、冒险结束清零，不是武器也不是护甲；**⑥同日 C/D 两项改名裁决**——C：货架三行「X锻升」→「**X祝福**」（攻击祝福 / 生命祝福 / 护甲祝福，后缀 = 用户选定，D&D 参照为 Blessing），机制分类名「属性值提升」不动、只改玩家向显示名，执行归独立改名小批（06 在册，本会话按禁动 game/ 纪律不代执行）；D：棋盘格 defense 正向行与 `ac_up` 状态的同名次 **护甲强化** → **盾牌加护**（用户提案，理由=它是临时叠层状态而非护甲本体；附带约定「加护 = AC 判定层，护盾 = 保险丝那种吸收层，两者不得混用」），同样归改名小批——**注：D 改名连带 `smoke_all.gd:1199` 一条硬编码断言，必须同步改，否则冒烟红**。开工门（17 裁点清零）已满足 | | v0.4 | 2026-10-11 | **A 组定案落文（锻造工坊裁决会话，用户逐裁）**：①承载换代——营地四柜台并排（树淬炼/锻造工坊/秘宝匣/奖励格图鉴），攻防独立柜台、工作间内武器/护甲两区并列零顺序门槛、宽度不足滚动条兜底、程序占位视觉终稿归 HUD 营地批（A②A③）；②生命档移除——生命强化唯一入口=树脊柱生命线，本工作间纯攻防（A①；实装边界①同步）；③**攻防所有权切分**——攻击唯一入口=武器路线、AC 唯一入口=甲路线，树脊柱砍攻击/护甲两线、树零攻防来源（红线；树侧 29→21 落文归天赋树会话交接批）；④树侧钥匙改无前置直接可点亮（原等级阈值前置随两线砍除作废）；⑤注入衔接落文——锻造路线加值=当前武器攻击加值+当前甲 AC 加值，只按当前选中生效；⑥死条件 magic_vs_magic 复活案作废（D 组核结：魔网织者在素材库表二退役名单；2c 结案）；⑦「道具工坊」退役词清除（承载节随 A② 改写一并换代为秘宝匣）；⑧存档域改旧档废弃口径（开发阶段无迁移）。B 组 15 裁点挂起待用户发令 | | v0.6 | 2026-10-12 | **完备性检查批（grilling 全库核查——现役代码事实/关联文档/引用一致性三路，用户逐条裁）**：①**现役事实基线换代**——`meta.tres` forge_products 行族已随迭代 21 T5 攻防所有权切分整体退役（行族/访问器/购买面三处退役登记），「改造现役行（吸收）」语义全线订正为「新建行族」（现役代码事实表/三件武器表/工作间清单/实装边界 1 五处）；定价「现役参数沿用」改「历史考古参数（20 钥石/150% 公比，`meta.tres:82-84` 退役批注）、实装投值归 M4 从零标定」；②**两根类型轴所有权移交（用户裁）**——`attack_type`/`armor_type` 默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除；选中态写存档域+冒险开始参数面注入（订正原「写 hero.tres 休眠轴」口径——与现役「表运行期只读」纪律 `meta_progression.gd:12-13/119` 及本文存档域条目双重冲突）；默认值与柜台解锁状态解耦（未解锁=无交互入口但配置常驻可读，不存在读不到默认值的窗口）；③**两处无依据表述订正删除**——「与秘宝解锁的混合制同构」（「同构」非本项目概念；与秘宝仅共享钥石单币+直购/条件解锁成分语义，通道结构不同：件级单通道分派 vs 同路线双通道并联）、「选长枪激活穿刺系专长的价值」（现役专长均为跨攻击类型通用件、不按 attack_type 分系，`feats.tres` 29 行实证，该表述无现役对应物）；④货架坐标订正（CURIO_KINDS 实为 `adventure_table.gd:29` schema 常量、feat_ticket 为显式豁免种 5/6 命中）+ 改名小批执行态回写（已合入 master `0c93a71`/`0144f60`）；⑤存档域预登记存档序列化.md（用户令：验收文档现在做、不等实装批）；⑥联动落文：元进度.md「跨局注入」节补四层叠加公式（v1.4）、术语表.md 新增锻造工坊节、entities.yaml terminology 补词条+新建锻造工坊条目。**不在本批范围（呈报归属，谁的问题谁改）**：registry ac_up 显示名失同步（归改名小批 D 项）、「魔法甲」四处残留（敌人系统/美术三档，归 3a 裁执行面）、registry meta_table 条目 forge_products 滞后（归元进度线）、天赋树.md 状态行滞后、06 提案条标题旧名 | -| —— | 2026-10-12 | **同日续裁落文（不升版本）**：①**编入迭代 23**（用户令——roadmap 主线序列 + 06 实装批条状态同步；M4 数值批顺延迭代 24+）；②实装边界 6 订正——敌方 attack_type 为敌方定义数据（enemy.tres/skills.tres 行级，与敌种名字/血量同批同时读写、无独立时序），「两批排期协商」句删除（用户 D 裁：时序问题不存在；本批只按 3b 裁落结构面）；③存档域「合并评估」语境订正——forge_routes 独立成域已预登记，树批入库后无共域冲突（用户 C 裁：非裁点，06 实装批条同句订正）；④A 项（未解锁时默认值读取路径）确认口径=配置表常驻持有、解锁只门控交互不门控读取，v0.6 正文已落此文；⑤**等级语义裁（Q1）**——初始持有路线 0 级起步：未解锁/未锻造=0 加值（裸体态，类型=普通/轻甲）；解锁并锻造第一级=「获得装备」=1 级=首个 +1 加值；逐级递进。正文「1 到上限」为量级描述（1-5 级），0=未练合法态；⑥**provisional 值落卡（Q2）**——需求卡片 T1 锚表：cap 5/武器与护甲每级增量统一 +1（累计 1/2/3/4/5；provisional 线性起步，4a 前缓后陡为终值形状方向归 M4）/甲型基础 AC 10/12/9（现役结构值）/价格 20×150%^n（20/30/45/67/101）/解锁价 200（中段三级 213 的九折）；provisional 归代拍板沿锚投值、终值 M4 | +| —— | 2026-10-12 | **同日续裁写入文档（不升版本）**：①**编入迭代 23**（用户令——roadmap 主线序列 + 06 实装批条状态同步；M4 数值批顺延迭代 24+）；②实装边界 6 订正——敌方 attack_type 为敌方定义数据（enemy.tres/skills.tres 行级，与敌种名字/血量同批同时读写、无独立时序），「两批排期协商」句删除（用户 D 裁：时序问题不存在；本批只按 3b 裁落结构面）；③存档域「合并评估」语境订正——forge_routes 独立成域已预登记，树批入库后无共域冲突（用户 C 裁：非裁点，06 实装批条同句订正）；④A 项（未解锁时默认值读取路径）确认口径=配置表常驻持有、解锁只门控交互不门控读取，v0.6 正文已落此文；⑤**等级语义裁（Q1）**——初始持有路线 0 级起步：未解锁/未锻造=0 加值（裸体态，类型=普通/轻甲）；解锁并锻造第一级=「获得装备」=1 级=首个 +1 加值；逐级递进。正文「1 到上限」为量级描述（1-5 级），0=未练合法态；⑥**provisional 值落卡（Q2）**——需求卡片 T1 锚表：cap 5/武器与护甲每级增量统一 +1（累计 1/2/3/4/5；provisional 线性起步，4a 前缓后陡为终值形状方向归 M4）/甲型基础 AC 10/12/9（现役结构值）/价格 20×150%^n（20/30/45/67/101）/解锁价 200（中段三级 213 的九折）；provisional 归代拍板沿锚投值、终值 M4 | | v0.9 | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 2 处**——「落文」→「写入」1 处（裁决结果清单表头「落文处」→「写入处」）；「收口」→「完成裁决」1 处（4b-1 行备注「原正文"或"字歧义收口」）。另按失同步核对修正文头状态行：版本注 v0.7 → v0.8（v0.8 迭代 21 反哺④残余落文行已入库而状态行未随批更替，本批补齐，事实零变更）。机制与数值零改动 | diff --git a/design/gdd/ux/battle.md b/design/gdd/ux/battle.md index 7344c7fb..1aa0d14f 100644 --- a/design/gdd/ux/battle.md +++ b/design/gdd/ux/battle.md @@ -433,18 +433,18 @@ | 日期 | 改动 | |---|---| | 2026-09-15 | 雾格残留清理：格态收窄为已开 / 未开两态（删除雾图变体状态行、四格态 AC 与已开雾格 tint / 雾区全开信号两条 AC）；图例面板与 toast 槽去掉雾条目与雾首遇提示；BoardView 纹带、绘制优先级与色弱冗余改按通用变异纹带表述；`ux_hint_shown` 的 hint_id 枚举去掉 fog_first；输入义务与 §13 义务对照表去掉 地形变异×3 一项；目标感知示例与提示文案 OQ 措辞同步。本 spec 不装载被移除机制的呈现义务 | -| 2026-09-16 | 格面资源批 UI 欠账收口（随 2026-09-15 可选类道具删除的代码收口同步文档）：① 布局四区化——删 E 区道具面板行、布局决策 2（道具窗口形态=右栏原位激活）整段删除（编号留空防交叉引用失锚）、ASCII 线框图重绘为 A/B/C/D 四区（D 区横向加宽 ~1036px）、A 区节点链示例改文字签槽实际渲染（战/赏/疗/王）；② States 删道具窗口态与零库存空态（「道包空空」）；③ 结算口径五段化（授予→增益/减益→战斗→衰减→判定）与明细行 10 类封闭协议（删 15 类行、四类行旧口径；「奖励未生效」行保留）；④ 交互/动效/事件表删道具窗口行、跳过按钮、`ux_window_choice`、`submit_window_selection`；⑤ 数据源登记删 `query_inventory` 与窗口载荷，奖励身份按现行 `query_identity` 只读回调口径校正；⑥ 验收清单删窗口断言、五区改四区、未生效类行改现行两型（溢出未生效/奖励未生效）；⑦ 关卡末清库反馈义务改载秘宝背包（随秘宝 P0 落地，本批不设计具体呈现）；⑧ OQ7（道具窗口原位激活）删除、OQ 重编号，「囤刀待机」等旧可选类措辞清理。本 spec 不装载被删除机制的呈现义务 | -| 2026-09-20 | **敌人卡形态裁决收口（2026-09-20 用户看对照样张拍板，06 待办「敌人卡形态」解决移除——台账 99）**：全站桩形态定稿——① B 区主角与敌人均为无框立绘+底座（站桩式），**英雄卡/敌人卡组件整体退役，卡片式不再作为候选**；主角血条悬浮头顶、状态效果小图标一排挂血条正下方，敌人血条+顺位徽标悬浮头顶、状态小图标同款挂血条下；攻击值等规划数据仍归 C 区数据框（C 区不动）；② 布局表 B 区行、Component Inventory 英雄卡/敌人卡两行随裁决改写（敌方 side 池共享层数各立绘同值、意图动画占位等既有语义平移到站桩载体，不随形态改变）；③ ASCII 线框图 B 区重绘（旧"意图:爪击/环点"示意早已随行为环退役，本次一并清掉）；④ OQ4 改写为裁决已收口注记，对照样张存档 `production/mockups/`；呈现义务细节重述（受击/退场演出挂点等）随表现层升级批执行 | -| 2026-09-23 | **停点前移批（冒险入口流程倒置修复，用户 2026-09-23 拍板；上位裁决 = 棋盘/战斗舞台 Node2D 迁移批（已执行完毕，git 历史可查），代码实装另批并行）**：① 布局四区 → 三区——删布局表 A 区关卡进度条行与 Component Inventory LevelStripView 行（LevelStripView 退役删除，节点链进度只留关卡画面，战斗屏零进度承载）；C/D 底行 520 → 548；ASCII 线框图重绘为 B/C/D 三区；② 新流程口径落文——关卡画面（选路覆盖层常驻形态）为关卡内常驻枢纽：Navigation Position 图、到达语境、Entry 表、信息层级第 5 层、Data Requirements 节点图行改「关卡开始即出图选路、战后返回关卡画面再选路」；③ AC 四区措辞改三区。**批内代拍板三项已追认（2026-09-24 用户确认）**：① B/C/D 字母保持不重编；② 28px 纵向空间划归 C/D 底行（520 → 548）；③ 关卡画面进度呈现由选路覆盖层节点态承载（暗金已过 / 金当前 / 亮金候选通道 / 旗朱 Boss）、不另设进度条组件 | +| 2026-09-16 | 格面资源批 UI 欠账完成（随 2026-09-15 可选类道具删除的代码完成同步文档）：① 布局四区化——删 E 区道具面板行、布局决策 2（道具窗口形态=右栏原位激活）整段删除（编号留空防交叉引用失锚）、ASCII 线框图重绘为 A/B/C/D 四区（D 区横向加宽 ~1036px）、A 区节点链示例改文字签槽实际渲染（战/赏/疗/王）；② States 删道具窗口态与零库存空态（「道包空空」）；③ 结算口径五段化（授予→增益/减益→战斗→衰减→判定）与明细行 10 类封闭协议（删 15 类行、四类行旧口径；「奖励未生效」行保留）；④ 交互/动效/事件表删道具窗口行、跳过按钮、`ux_window_choice`、`submit_window_selection`；⑤ 数据源登记删 `query_inventory` 与窗口载荷，奖励身份按现行 `query_identity` 只读回调口径校正；⑥ 验收清单删窗口断言、五区改四区、未生效类行改现行两型（溢出未生效/奖励未生效）；⑦ 关卡末清库反馈义务改载秘宝背包（随秘宝 P0 落地，本批不设计具体呈现）；⑧ OQ7（道具窗口原位激活）删除、OQ 重编号，「囤刀待机」等旧可选类措辞清理。本 spec 不装载被删除机制的呈现义务 | +| 2026-09-20 | **敌人卡形态裁决完成（2026-09-20 用户看对照样张拍板，06 待办「敌人卡形态」解决移除——状态记录 99）**：全站桩形态定稿——① B 区主角与敌人均为无框立绘+底座（站桩式），**英雄卡/敌人卡组件整体退役，卡片式不再作为候选**；主角血条悬浮头顶、状态效果小图标一排挂血条正下方，敌人血条+顺位徽标悬浮头顶、状态小图标同款挂血条下；攻击值等规划数据仍归 C 区数据框（C 区不动）；② 布局表 B 区行、Component Inventory 英雄卡/敌人卡两行随裁决改写（敌方 side 池共享层数各立绘同值、意图动画占位等既有语义平移到站桩载体，不随形态改变）；③ ASCII 线框图 B 区重绘（旧"意图:爪击/环点"示意早已随行为环退役，本次一并清掉）；④ OQ4 改写为裁决已完成注记，对照样张存档 `production/mockups/`；呈现义务细节重述（受击/退场演出挂点等）随表现层升级批执行 | +| 2026-09-23 | **停点前移批（冒险入口流程倒置修复，用户 2026-09-23 拍板；上位裁决 = 棋盘/战斗舞台 Node2D 迁移批（已执行完毕，git 历史可查），代码实装另批并行）**：① 布局四区 → 三区——删布局表 A 区关卡进度条行与 Component Inventory LevelStripView 行（LevelStripView 退役删除，节点链进度只留关卡画面，战斗屏零进度承载）；C/D 底行 520 → 548；ASCII 线框图重绘为 B/C/D 三区；② 新流程口径写入文档——关卡画面（选路覆盖层常驻形态）为关卡内常驻枢纽：Navigation Position 图、到达语境、Entry 表、信息层级第 5 层、Data Requirements 节点图行改「关卡开始即出图选路、战后返回关卡画面再选路」；③ AC 四区措辞改三区。**批内代拍板三项已追认（2026-09-24 用户确认）**：① B/C/D 字母保持不重编；② 28px 纵向空间划归 C/D 底行（520 → 548）；③ 关卡画面进度呈现由选路覆盖层节点态承载（暗金已过 / 金当前 / 亮金候选通道 / 旗朱 Boss）、不另设进度条组件 | | 2026-09-23 | 实现注记（棋盘 Node2D 迁移批 Phase A，代码实装同批）：棋盘渲染 Node2D 化（BoardView = Control 壳 + SubViewportContainer + SubViewport + Node2D 世界，信号/click_cell/_cells 契约保持，新增 push_input 端到端输入探针）；格尺寸公式锚点不变（set_cell_area = floor((min(宽,高) − 预留 − (N−1)×格间距) / N) 单点可调），布局与交互语义零改动 | | 2026-09-26 | 实现注记（战斗舞台 Node2D 迁移批 Phase B，代码实装同批）：B 区战斗画面 Node2D 化（BattleStageView = Control 壳 + SubViewportContainer + SubViewport + Node2D 世界，站桩本体 StandeeBody 世界精灵；set_enemies/clear_enemies/on_step_row_fx/gray_all_enemies 等 setter 面签名保持，弹道落点锚点=壳层口径 world_to_shell 单点）；状态图标行与悬停 tooltip 保留 Control 载体挂壳层；三区布局尺寸零改动（B 区外框 252px 逐位） | -| 2026-09-26 | **封印紫批**（用户拍板）：插旗呈现色 旗朱 #C63D22 → 封印紫 #7C3AA8（色相 ≈267°，避开禁入带）——旗字形/已承诺封印框/旗化暴击弹道随批换色；拒绝边框闪语义归危险红；Boss 节点描边归紫赤本色。修订记录历史行旗朱字样系当时口径留痕不改 | -| 2026-09-26 | **战斗屏信息归属批（用户 2026-09-26 三轮纠偏后拍板；代码实装另批——hero_info_panel_view.gd / hud_presenter.gd 改造 + 探针断言迁移，登记待办）**：立两条信息归属原则并全屏贯行——①循环口径原则（战斗屏只展小循环内被消费、影响当下决策的数据；中/大循环资源不得入侵）②单一展示面原则（同一信息全屏唯一展示面；单位本体已承载的信息数据框不重复；资源数字贴唯一消费口）。随拍板落地：① B 区站桩 = HP 与状态效果唯一展示面——C 区 HP 条/HP 文字/立绘占位/状态效果槽×4 退役（重复展示；证据链 = hud_presenter.gd 同一 s.hero.hp/s.hero_effects 双投喂 B/C 两区）；② RAP 读数（点阵+数字）迁 D 区 AP 条、置弃图刷新按钮旁（RAP 唯一消费口 = 弃图刷新——就近原则）；③ C 区状态槽悬停 tooltip 职责并入 B 区站桩状态小图标；④ GP（中循环）/钥石（大循环）迁出战斗屏，去向挂 OQ14；⑤ C 区改「攻击数据框 + 秘宝槽（预留）+ 本关强化列表（预留）」——预留区来自秘宝与关卡内属性提升的既有立项；⑥ 空态/清零反馈/悬停交互/AC/§13 义务表载体同步改写。**批内遗留两项待拍板（OQ13/14）**：护甲 AC 是否补入 C 区数据框；GP/钥石去向 | -| 2026-09-26 | **信息归属二轮拍板（用户 2026-09-26，OQ13/14 收口）**：① 我方护甲 AC 补入 C 区攻击数据框（唯一展示面——布局表/组件清单/线框图同步）；② GP/钥石去向定案：GP = 关卡画面常驻总量 + 战斗结算画面总量+增量，钥石 = 结算画面 + 营地（具体呈现归对应 UX spec 批次）；③ 敌方 AC 展示面挂起——用户口径「敌方 AC 无任何展示」与现行代码冲突（standee_view.gd 底库名字行渲染「名字·护甲·AC%d」，系敌人技能池批克制对策可读性义务），证据链已呈报待终裁，本 spec 暂不改敌人站桩行 | -| 2026-09-26 | **敌方 AC 展示终裁收口（用户 2026-09-26 终裁）**：敌方 AC 数值全屏退役（任何区不直接展示）、护甲类型改图标方式展示（形状+色相双通道，终稿图标资产归美术批）、敌人站桩底座下名字行退回纯名字+护甲类型图标；旧「克制对策可读性义务」降级承载——类型保留、数值退役。终裁理由（用户口径）：HP 信息已足够，攻防数值不直接写上；护甲类型图标保留克制对策可读性。同步改写：信息归属树敌人站桩行、Component Inventory 敌人站桩立绘行、OQ13。**代码实装说明**：`standee_view.gd` 改造（站桩名字行去 AC 数值 + 护甲类型图标化）由并行代码批执行，本批只做文档同步 | -| 2026-09-27 | **UX 文档欠账处置批（用户四项拍板：player-journey 不建 / accessibility 不另立改指 HUD框架 / node-reward 改挂秘宝内容重定批 / level-clear 建档 design/gdd/ux/level-clear.md）**：① 删 §Player Context ⚠️ player-journey 未建注记，OQ1 改收口注记；② §Accessibility 头、§Transitions 减动效行、OQ2 改指 HUD框架「可访问性基线」节 + 设置与本地化待设计清单 #1（tools/doc_link_known.txt 欠账行随之清空）；③ 导航残留修正——§Navigation Position 图胜利分支、§Entry/Exit 离开表、§Interaction Map 胜利 overlay 行改按现行代码实态（胜利后返回关卡画面选路；节点覆盖层 = 关卡画面域、落地奖励/恢复节点时开出；胜利/失败 overlay 组件锚 battle_end_overlay.gd）——原「胜利 → 节点奖励/恢复覆盖层」系停点前移批前残留；④ OQ3 过期陈述更正（interaction-patterns.md 2026-09-12 已建成）、OQ8 改收口注记。本批只动文档面，代码零改动 | +| 2026-09-26 | **封印紫批**（用户拍板）：插旗呈现色 旗朱 #C63D22 → 封印紫 #7C3AA8（色相 ≈267°，避开禁入带）——旗字形/已承诺封印框/旗化暴击弹道顺带换色；拒绝边框闪语义归危险红；Boss 节点描边归紫赤本色。修订记录历史行旗朱字样系当时口径留痕不改 | +| 2026-09-26 | **战斗屏信息归属批（用户 2026-09-26 三轮纠偏后拍板；代码实装另批——hero_info_panel_view.gd / hud_presenter.gd 改造 + 探针断言迁移，登记待办）**：立两条信息归属原则并全屏贯行——①循环口径原则（战斗屏只展小循环内被消费、影响当下决策的数据；中/大循环资源禁止入侵）②单一展示面原则（同一信息全屏唯一展示面；单位本体已承载的信息数据框不重复；资源数字贴唯一消费口）。随拍板落地：① B 区站桩 = HP 与状态效果唯一展示面——C 区 HP 条/HP 文字/立绘占位/状态效果槽×4 退役（重复展示；证据链 = hud_presenter.gd 同一 s.hero.hp/s.hero_effects 双投喂 B/C 两区）；② RAP 读数（点阵+数字）迁 D 区 AP 条、置弃图刷新按钮旁（RAP 唯一消费口 = 弃图刷新——就近原则）；③ C 区状态槽悬停 tooltip 职责并入 B 区站桩状态小图标；④ GP（中循环）/钥石（大循环）迁出战斗屏，去向挂 OQ14；⑤ C 区改「攻击数据框 + 秘宝槽（预留）+ 本关强化列表（预留）」——预留区来自秘宝与关卡内属性提升的既有立项；⑥ 空态/清零反馈/悬停交互/AC/§13 义务表载体同步改写。**批内遗留两项待拍板（OQ13/14）**：护甲 AC 是否补入 C 区数据框；GP/钥石去向 | +| 2026-09-26 | **信息归属二轮拍板（用户 2026-09-26，OQ13/14 完成）**：① 我方护甲 AC 补入 C 区攻击数据框（唯一展示面——布局表/组件清单/线框图同步）；② GP/钥石去向定案：GP = 关卡画面常驻总量 + 战斗结算画面总量+增量，钥石 = 结算画面 + 营地（具体呈现归对应 UX spec 批次）；③ 敌方 AC 展示面挂起——用户口径「敌方 AC 无任何展示」与现行代码冲突（standee_view.gd 底库名字行渲染「名字·护甲·AC%d」，系敌人技能池批克制对策可读性义务），证据链已呈报待终裁，本 spec 暂不改敌人站桩行 | +| 2026-09-26 | **敌方 AC 展示终裁完成（用户 2026-09-26 终裁）**：敌方 AC 数值全屏退役（任何区不直接展示）、护甲类型改图标方式展示（形状+色相双通道，终稿图标资产归美术批）、敌人站桩底座下名字行退回纯名字+护甲类型图标；旧「克制对策可读性义务」降级承载——类型保留、数值退役。终裁理由（用户口径）：HP 信息已足够，攻防数值不直接写上；护甲类型图标保留克制对策可读性。同步改写：信息归属树敌人站桩行、Component Inventory 敌人站桩立绘行、OQ13。**代码实装说明**：`standee_view.gd` 改造（站桩名字行去 AC 数值 + 护甲类型图标化）由并行代码批执行，本批只做文档同步 | +| 2026-09-27 | **UX 文档欠账处置批（用户四项拍板：player-journey 不建 / accessibility 不另立改指 HUD框架 / node-reward 改挂秘宝内容重定批 / level-clear 建档 design/gdd/ux/level-clear.md）**：① 删 §Player Context ⚠️ player-journey 未建注记，OQ1 改完成注记；② §Accessibility 头、§Transitions 减动效行、OQ2 改指 HUD框架「可访问性基线」节 + 设置与本地化待设计清单 #1（tools/doc_link_known.txt 欠账行随之清空）；③ 导航残留修正——§Navigation Position 图胜利分支、§Entry/Exit 离开表、§Interaction Map 胜利 overlay 行改按现行代码实态（胜利后返回关卡画面选路；节点覆盖层 = 关卡画面域、落地奖励/恢复节点时开出；胜利/失败 overlay 组件锚 battle_end_overlay.gd）——原「胜利 → 节点奖励/恢复覆盖层」系停点前移批前残留；④ OQ3 过期陈述更正（interaction-patterns.md 2026-09-12 已建成）、OQ8 改完成注记。本批只动文档面，代码零改动 | | 2026-09-27 | 关卡画面 UX spec 建档联动（关卡画面 UX 批）：§Navigation Position 上游屏/下游屏行挂 [level-map.md](level-map.md) 屏级 spec 指针——关卡画面（选路覆盖层常驻形态）的布局/组件/交互/状态规格自此有独立权威文档。零机制改动 | | 2026-10-06 | **方案二·立绘定档与站桩落底排批（用户拍板；工作流程铁律 2026-10-06 = 讨论期只动文档，代码实装另批走 PRD→迭代）**：① B 区 252→270（演出 ≈1/3 屏）/ C 区 548→530（**棋盘 438×438 原尺寸不缩、格子不变**，压缩全部由面板空档吸收）——布局表 B/C/D 三行随改；② 站桩排式重排：**立绘→血条→状态 落底排**（全场血条对齐一线；血条嵌石板位、台缘线留作地面线、落影保留），原「血条悬浮头顶」退役（高盒下血条-立绘空洞，用户点名否决）——Component Inventory 主角/敌人站桩两行随改；③ 大体档（显示 >150px 级：drider/duergar_king）头部探出盒顶压光柱区，血条仍落底；意图徽标上移头顶上方（探顶档压胸）；④ 空态行措辞随改；⑤ ASCII 线框图 B 区重绘。立绘八敌源档定档归 art-bible §8.2（v3.7）与 character-design.md §5.5（体量=生物体型修订） | -| 2026-10-09 | 文档正确性审查批（在役态对齐）：①秘宝槽「已实装四槽两步交互/关卡域库存/清库义务载体 = 秘宝背包」过期——过渡形态随迭代 11①退役，现行 = 营地同调装配（四槽壳空槽占位，展示重接归装配面批次）；②奇物列表「预留」改已实装（现行标题「特性」，迭代 9⑫+迭代 12 呈现补齐）；③明细回看 overlay/入口/交互三处随 P-C7 退役订正（回看归「生涯」）；④TunePanel 三处改调试浮窗（迭代 15①退役）+减动效开关 = 设置面（迭代 8④）；⑤棋盘尺寸 N∈{10,12} 扩 {10,12,13,14}（第三关内容批）；⑥OQ9 TunePanel 退役计划收口 | +| 2026-10-09 | 文档正确性审查批（在役态对齐）：①秘宝槽「已实装四槽两步交互/关卡域库存/清库义务载体 = 秘宝背包」过期——过渡形态随迭代 11①退役，现行 = 营地同调装配（四槽壳空槽占位，展示重接归装配面批次）；②奇物列表「预留」改已实装（现行标题「特性」，迭代 9⑫+迭代 12 呈现补齐）；③明细回看 overlay/入口/交互三处随 P-C7 退役订正（回看归「生涯」）；④TunePanel 三处改调试浮窗（迭代 15①退役）+减动效开关 = 设置面（迭代 8④）；⑤棋盘尺寸 N∈{10,12} 扩 {10,12,13,14}（第三关内容批）；⑥OQ9 TunePanel 退役计划完成 | | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：Exit 表关卡结算行「无关卡域清库面」表述精确化——旧关卡域库存 treasure_inventory 经代码实证仍在（level_runner.gd:520 快照计数/battle_orchestrator.gd:745 consume），系投放渠道全退役后恒空的机械惰性承载，拆线归实装批；同调装配件不经此域的结论不变 | | 2026-10-15 | **简明技术中文用语规范批（用户令，词面层）**：词面修正 30 处——不得×5→禁止（信息层级依据句/信息归属循环口径条/敌人意图映射目录注记〔键名禁作现行 enemy_id 引用〕/敌人死亡呈现行〔敌人系统资产下限〕/AC 效果行）；收口×11→完成（C 区奇物列表批注〔含随批→顺带〕/布局表 B 区行/意图映射目录命名双轨注记/线框图头注 2026-09-20/OQ1/OQ2/OQ8/OQ9/OQ13 已终裁收口→已终裁完成/OQ14 已拍板收口→已拍板完成＋「随 spec 命名收口退役」→「随 spec 命名完成退役」）；buff×1→增益（胜利终局行微文案引句「我的增益哪去了」）；台账×10→状态记录（Events 呈现订阅行/Data Requirements 三处/终局数据锚行/架构注记/更新触发注记/场景级测试头/§13 记法注/义务表战斗结算行与地图战斗资源行）；随批×2→顺带（下游屏行/可挖域微光注记）；Last Updated 同步本批。ambusher（伏击者）历史退役词留痕行一字未动 | diff --git a/design/gdd/ux/level-clear.md b/design/gdd/ux/level-clear.md index 1903b4a0..f70902a0 100644 --- a/design/gdd/ux/level-clear.md +++ b/design/gdd/ux/level-clear.md @@ -126,9 +126,9 @@ | 日期 | 改动 | |---|---| | 2026-09-27 | 初稿（UX 文档欠账处置批，用户拍板建档）：义务锁定版——大奖励三件套/钥石入账/清库反馈预留成文；现行载体（_inter_overlay 与 BattleEndOverlay 复用）与代码锚如实登记；GP 归属两处登记不一致挂 OQ1，拍板前不新增 GP 呈现义务 | -| 2026-09-27 | GP 归属拍板对齐批（用户口径：战斗胜利→战斗总结结算展示获得资源〔目前 GP〕；战斗失败→冒险总结结算→确认回存档首页）：OQ1 收口——GP 总量+增量归战斗胜利总结结算（battle.md OQ14 为准），本屏不承载 GP；OQ3 收口——「结算画面」指认 = 冒险总结结算，大奖励屏钥石进账 + 冒险总结结算明细两处并存维持；信息归属 GP 移入禁入清单；Data Requirements GP 行改零访问；06 归属行同步修正 | +| 2026-09-27 | GP 归属拍板对齐批（用户口径：战斗胜利→战斗总结结算展示获得资源〔目前 GP〕；战斗失败→冒险总结结算→确认回存档首页）：OQ1 完成——GP 总量+增量归战斗胜利总结结算（battle.md OQ14 为准），本屏不承载 GP；OQ3 完成——「结算画面」指认 = 冒险总结结算，大奖励屏钥石进账 + 冒险总结结算明细两处并存维持；信息归属 GP 移入禁入清单；Data Requirements GP 行改零访问；06 归属行同步修正 | | 2026-09-27 | 关卡画面 UX spec 建档联动：§Navigation Position 下游屏行挂 level-map.md 屏级 spec 指针。零机制改动 | -| 2026-10-01 | **三选一选择交互重写（迭代 10 奖励重构批——用户 2026-09-30 拍板案丙；T2 UX spec 卡）**：①Purpose/载体/导航/进出/层级/状态/交互/数据全节重写——「大奖励三件套快照展示」退役，改「部分回血反馈 + 提升三选一三卡点选 + 确认兑付 + 同调位替换子交互」；②钥石元素全屏退役（增量行迁战斗总结结算，禁入清单机检化）；③交互范式 = choice_box 按钮族 + 选路两段式复用，零新增原语；④AC 五条改写 + 断点中断/减动效/禁入机检三条新增；⑤OQ3 改钥石三面化收口、OQ5 改替换子交互视觉归样张批 | +| 2026-10-01 | **三选一选择交互重写（迭代 10 奖励重构批——用户 2026-09-30 拍板案丙；T2 UX spec 卡）**：①Purpose/载体/导航/进出/层级/状态/交互/数据全节重写——「大奖励三件套快照展示」退役，改「部分回血反馈 + 提升三选一三卡点选 + 确认兑付 + 同调位替换子交互」；②钥石元素全屏退役（增量行迁战斗总结结算，禁入清单机检化）；③交互范式 = choice_box 按钮族 + 选路两段式复用，零新增原语；④AC 五条改写 + 断点中断/减动效/禁入机检三条新增；⑤OQ3 改钥石三面化完成、OQ5 改替换子交互视觉归样张批 | | 2026-10-09 | 文档正确性审查批（在役态对齐）：①三选一候选订正——自迭代 15② 渠道分离起通关三选一 = 纯专长（原「六种池加权抽三」与秘宝件直显条款退役）；②同调位替换子交互全节退役（秘宝件迭代 11① 出池后本屏无道具件候选）；③过渡键 transitional_sync_slots 引用删除（同调位现行事实源 = attunement_growth.tres）；④载体组件名订正 = curio_pick_overlay（与奖励节点共用面） | | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：Data Requirements 三候选行「加权洗牌掷 3」漏网旧口径清偿——冒险结构 v0.14 令牌池换代后 = 令牌池洗牌不放回抽 3（同 kind 去重），与冒险结构/关卡节点地图/node-reward 同口径 | | 2026-10-15 | **简明技术中文用语规范批（用户令，词面层）**：词面修正 4 处——随批×2→顺带（Status 行目检清单交付/OQ4 实装后目检清单交付）；收口×2→已完成（OQ1 GP 增量展示面归属/OQ3 钥石呈现三面化）；文头 Last Updated 滞后对齐（原 2026-10-01 → 本批） | diff --git a/design/gdd/ux/level-map.md b/design/gdd/ux/level-map.md index 0e0a355d..de08e8ed 100644 --- a/design/gdd/ux/level-map.md +++ b/design/gdd/ux/level-map.md @@ -241,10 +241,10 @@ | 日期 | 改动 | |---|---| -| 2026-09-28 | **视觉终稿冻结批（M-2 迭代 4 T1–T4，闸形 A：样张 v1 机检 11/11 全绿即冻结）**：Status 升格定稿版；Layout 节点图区冻结值成文（画布公式 70+层×122+34 / 52+槽×58+26+8 下限 620×240、通道 2/3/4px、节点图标 ♻ kenney 五键 20px 烘焙+双色墨制、编号右上角）；已过态 = GOLD_DONE #68562C 冻结新值（旧 GOLD_DIM 对双色墨 <4.5:1 逼守）；Accessibility 增 Boss 深墨环灰度冗余+对比断言承载注记；States 换层进入改「淡入+换层色板渐变挂点（§2.7 切片档）」；组件清单节点图画布实现锚更新；OQ ④ 视觉终稿收口；线框图注记随改。产物：样张 `artwork/mockups/level-map-sheet-v1-2026-09-28.png` + 机检报告 git 提交 9a79927 + 出口闸检查单 `M2 出口检查单（已退役，git 历史可查）` | +| 2026-09-28 | **视觉终稿冻结批（M-2 迭代 4 T1–T4，闸形 A：样张 v1 机检 11/11 全绿即冻结）**：Status 升格定稿版；Layout 节点图区冻结值成文（画布公式 70+层×122+34 / 52+槽×58+26+8 下限 620×240、通道 2/3/4px、节点图标 ♻ kenney 五键 20px 烘焙+双色墨制、编号右上角）；已过态 = GOLD_DONE #68562C 冻结新值（旧 GOLD_DIM 对双色墨 <4.5:1 逼守）；Accessibility 增 Boss 深墨环灰度冗余+对比断言承载注记；States 换层进入改「淡入+换层色板渐变挂点（§2.7 切片档）」；组件清单节点图画布实现锚更新；OQ ④ 视觉终稿完成；线框图注记随改。产物：样张 `artwork/mockups/level-map-sheet-v1-2026-09-28.png` + 机检报告 git 提交 9a79927 + 出口闸检查单 `M2 出口检查单（已退役，git 历史可查）` | | 2026-09-28 | **形态升格独立屏批（M-2 迭代 3 T1，用户裁决：独立存在为最终形态，覆盖层实现定性=测试阶段形态）**：Status/覆盖范围/到达方式/Navigation Position——「模态覆盖层形态（暗幕 0.6 底层透出）」全量改写为「独立屏独占呈现（战斗屏宿主整体隐藏，零透出）」；Layout 屏底=深底+石纹底噪（M-1 框材件）；Transitions=独立屏淡入 200ms（alpha 淡入非明度变化——art-bible §2）；AC「模态纪律」条改「独立性断言」（激活期战斗屏隐藏/选路提交战斗节点后恢复/兑付覆盖层关闭后本屏恢复）；节点/商店覆盖层「本屏域内弹出」语义随形态明确（本屏保持激活，模态栈遮挡恢复语义复用）；实现锚改名 level_map_screen.gd（RouteOverlay 退役）；battle.md 三处选路覆盖层措辞随改；视觉终稿前置改指 M-2 迭代 4 关卡画面样张 | -| 2026-09-27 | 初稿（关卡画面 UX 批，用户拍板立项）：占位升格版——信息层级五层/三分区布局/组件清单/三停点状态/交互与数据锚/AC 成文；停点标题措辞修正（清偿台账 143 遗留）；GP 常驻徽章落地面（2026-09-26 二轮拍板去向，经 GP 归属拍板对齐批维持）；三项提案挂 OQ（HP 常驻读数/图上直接点击选路/放弃二次确认）登记 06 待拍板；视觉终稿以表现层样张为前置。实现锚 = route_overlay.gd 程序化占位现行 | -| 2026-09-27 | **三拍板收口批（用户逐项裁决）**：① 底栏 = 状态展示——生命/属性（攻击·AC 有效值）/本关已选加成三组常读（原提案顶栏 HP 扩为底栏状态栏，布局决策 4）；② 图上直接点击选路定稿——候选按钮整列退役、图上点击为唯一提交通道（布局决策 2；press_candidate 探针面随实装批改造注记）；③ 放弃冒险二次确认定稿（布局决策 3）。信息层级六层重排/组件清单/States/交互表/Data Requirements（属性与加成读数入口）/AC/线框图随改；06 拍板点条目解决移除（去向 = 本批台账 204） | +| 2026-09-27 | 初稿（关卡画面 UX 批，用户拍板立项）：占位升格版——信息层级五层/三分区布局/组件清单/三停点状态/交互与数据锚/AC 成文；停点标题措辞修正（清偿状态记录 143 遗留）；GP 常驻徽章落地面（2026-09-26 二轮拍板去向，经 GP 归属拍板对齐批维持）；三项提案挂 OQ（HP 常驻读数/图上直接点击选路/放弃二次确认）登记 06 待拍板；视觉终稿以表现层样张为前置。实现锚 = route_overlay.gd 程序化占位现行 | +| 2026-09-27 | **三拍板完成批（用户逐项裁决）**：① 底栏 = 状态展示——生命/属性（攻击·AC 有效值）/本关已选加成三组常读（原提案顶栏 HP 扩为底栏状态栏，布局决策 4）；② 图上直接点击选路定稿——候选按钮整列退役、图上点击为唯一提交通道（布局决策 2；press_candidate 探针面随实装批改造注记）；③ 放弃冒险二次确认定稿（布局决策 3）。信息层级六层重排/组件清单/States/交互表/Data Requirements（属性与加成读数入口）/AC/线框图随改；06 拍板点条目解决移除（去向 = 本批状态记录 204） | | 2026-10-09 | 文档正确性审查批：States 减动效行「切片期 TunePanel」过期订正——减动效开关已转正设置面（迭代 8 卡④；TunePanel 随迭代 15 卡①退役） | | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：正文四处里程碑前缀按 2026-10-09 口径清偿——「M-2 迭代 4」三处删前缀只留「迭代 4」（Status 行/节点图画布实现锚/线框图注记）；「M-1 框材组冻结件」改「迭代 2 框材组冻结件」（git 9abf5ff 实证框材组=M-1 迭代 2） | | 2026-10-15 | **简明技术中文用语规范批（用户令，词面层）**：词面修正 6 处——收口×4→完成（Status 行三项提案拍板/顶栏语境行 HP 拍板注/Open Questions 两「已收口」头注→「已完成」）；台账×2→状态记录（布局决策 1 清偿 143 遗留/AC 三停点标题条）；Last Updated 同步本批 | diff --git a/design/gdd/ux/shop.md b/design/gdd/ux/shop.md index 73ac44ce..1f9e368c 100644 --- a/design/gdd/ux/shop.md +++ b/design/gdd/ux/shop.md @@ -1,6 +1,6 @@ # 商店覆盖层 UX spec（shop） -> 状态：v1.1（2026-09-30 审计拍板点 4B 用户裁决落文——甲+乙并行：编排面小节落关卡节点地图、呈现面独立成文） +> 状态：v1.1（2026-09-30 审计拍板点 4B 用户裁决写入文档——甲+乙并行：编排面小节落关卡节点地图、呈现面独立成文） > 事实源：`game/presentation/views/shop_overlay_view.gd`（ShopOverlay） > 机制权威：[关卡节点地图](../systems/冒险循环/关卡节点地图.md)（商店房编排：每关恰 1/Boss 前一位必经/兑付触发）；定价数值归[难度曲线与Boss](../systems/冒险循环/难度曲线与Boss.md)（shop.tres，provisional） diff --git a/design/registry/architecture.yaml b/design/registry/architecture.yaml index d79bc80b..5371d39d 100644 --- a/design/registry/architecture.yaml +++ b/design/registry/architecture.yaml @@ -27,7 +27,7 @@ api_decisions: - name: test_carrier decision: 双载体（--headless --script 逻辑冒烟 + headless 场景探针）+ 静态扫描域 S1–S8 + CI 外部 wall-clock 超时；gdUnit4 deferred（数据配置 OQ1 关闭形态） - name: save_contract - decision: SCHEMA_VERSION 比较逻辑归 存档序列化（存档版本 > 当前 = 拒读）；RNG 快照 = master_seed + 各流 scope 计数器 + 意图/窗口选择序列，切出须在 scope 事件边界外（无在飞 open_stream 实例——战斗结算 编排保证） + decision: SCHEMA_VERSION 比较逻辑归 存档序列化（存档版本 > 当前 = 拒读）；RNG 快照 = master_seed + 各流 scope 计数器 + 意图/窗口选择序列，切出须在 scope 事件边界外（无正在执行中的 open_stream 实例——战斗结算 编排保证） core_decisions: - name: effect_engine_interpreter @@ -50,4 +50,4 @@ forbidden_patterns: - name: hero_override_parameter_passing decision: 主角加成值经 encounter 显式参数传入（begin_battle 增 hero_atk/hero_max_hp 字段；敌人系统.spawn 增 atk_override/max_hp_override 参数，-1 = 表值兜底）——db.hero 表值运行期只读（切片原表写通道 _apply_hero_override/runner 写表废除） - note: 2026-09-13 E4 收口；接口漂移 = 敌人系统.spawn 签名 +2 参数、战斗结算 encounter +2 字段（正式侧 战斗结算/敌人系统 GDD 修订随正式化批）；ui_tune_probe ⑦⑧ 为表不可变 + 单次加成的回归断言载体 + note: 2026-09-13 E4 完成；接口漂移 = 敌人系统.spawn 签名 +2 参数、战斗结算 encounter +2 字段（正式侧 战斗结算/敌人系统 GDD 修订随正式化批）；ui_tune_probe ⑦⑧ 为表不可变 + 单次加成的回归断言载体 diff --git a/design/registry/entities.yaml b/design/registry/entities.yaml index b484a4f6..8971e614 100644 --- a/design/registry/entities.yaml +++ b/design/registry/entities.yaml @@ -1,6 +1,6 @@ # 实体注册表（Entity Registry） # 跨系统事实的唯一登记处：各 GDD 定稿的命名实体/公式/常量在此登记， -# 后续 GDD 写作时作为"已锁事实"引用——不得默默改值，冲突必须显式提出。 +# 后续 GDD 写作时作为"已锁事实"引用——禁止默默改值，冲突必须显式提出。 # 维护规则：见 design-system 技能 Phase 5b。value 字段只能由 owner GDD 修订。 # 命名注记（2026-09-15）：本表历史上以 A1–D6 系统代号命名文档与义务，已全部清偿为中文规范名；英文代号对照表见 design/gdd/02-系统清单.md。owner 已改指新骨架文档路径（部分为待成文占位，随各文档定稿修订——doc-conventions §8 既定清偿路径）；a2_/a5_/d1_/b1_/b4_ 前缀键名与夹具名同批改领域命名（minesweeper_/aux_/hud_/settlement_/reward_）。 @@ -50,8 +50,8 @@ entities: attributes: variables: [SINGLE_SALT, master_seed, scope] output_range: "[0, 2^63)" - golden_vectors: 统一流 8 常量（**2026-09-27 统一随机流批单盐重登记**——Python 参考实现逐位交叉验证；m=42：scope0=8672514112661456564 / scope1=8834291164406037215 / scope2=7714373262647006282 / scope3=1280102845971471347 / scope4=82585501446482399 / scope5=8078924421474470922 / scope6=6638052740430622424 / scope7=8264196488417721294；scope 0-3 与并流前 board_gen 向量逐位连续〔单盐沿用原 board_gen 盐〕；并流前分盐向量 10 常量随批作废） - salt: 0xA0761D6478BD642F（统一单盐——沿用并流前 board_gen 盐；历史分盐 salt_reward_roll/encounter/armor_roll/behavior_roll/variant_place/gp_drop 六常量随批退役） + golden_vectors: 统一流 8 常量（**2026-09-27 统一随机流批单盐重登记**——Python 参考实现逐位交叉验证；m=42：scope0=8672514112661456564 / scope1=8834291164406037215 / scope2=7714373262647006282 / scope3=1280102845971471347 / scope4=82585501446482399 / scope5=8078924421474470922 / scope6=6638052740430622424 / scope7=8264196488417721294；scope 0-3 与并流前 board_gen 向量逐位连续〔单盐沿用原 board_gen 盐〕；并流前分盐向量 10 常量顺带作废） + salt: 0xA0761D6478BD642F（统一单盐——沿用并流前 board_gen 盐；历史分盐 salt_reward_roll/encounter/armor_roll/behavior_roll/variant_place/gp_drop 六常量顺带退役） multiplier: 0x9E3779B97F4A7C15 finalizer_mix: splitmix64 finalizer 变体（2026-09-19 B 案——derive = mix64(SINGLE_SALT XOR wrap64(master + scope×GOLDEN))；乘数 0xBF58476D1CE4E5B9 / 0x94D049BB133111EB、加数同 GOLDEN_RATIO；全程 63 位掩码；动机=窄种子窗×短局复用会把裸派生种子头部窗口的面值彩票放大进聚合统计，混淆使任何窄种子窗表现如随机抽样） impl_spec: wrap64=二补数自然回绕；禁 float 中间量、禁对中间量用 %、禁"主动修复溢出"；常量用分段表达式书写；掩码收尾；mix64 内全程 OUT_MASK 63 位掩码（有符号 int64 算术移位在 63 位正值域与逻辑移位逐位一致——参考实现对齐关键） @@ -134,7 +134,7 @@ entities: attributes: variables: [unlock_level, level_index, board_types, board_type] rule: pool = {v ∈ VariationTable | unlock_level ≤ level_index ∧ (board_types=∅ ∨ board_types ∋ board_type)}；直接整数比较（无 数据配置 R1 floor）；∅ = 通配语义 - output_range: pool 集合（现行 L1 dungeon = {thorn, vine} / L2 underdark = {magma, ash}；空池合法——静默布置普通图，不报错） + output_range: pool 集合（现行 L1 dungeon = {thorn, vine} / L2 underdark = {magma, ash}；空池合法——静默布置普通图，不返回错误） board_type: String（值域 = 棋盘生成 BoardGenTable 词表 v1.0 {dungeon, underdark}，2026-09-19 定稿；域校验 = 词表成员检查，fail-fast 闭合） downstream: 战斗结算 布置段候选池门控（2026-09-20 起布置执行位 = 战斗初始化第 4 步，非棋盘生成管线）；多变异选取须消费 variant_place 流（回放确定性） referenced_by: [战斗结算, 棋盘生成] @@ -149,7 +149,7 @@ entities: display_name: String target_side: enum {hero, enemy} magnitude: int——percent ∈ [-100,100] ∧ ≠0 | flat ≥ 1（跨字段校验） - unit: enum {percent, flat, ac}（**2026-09-18 结构修复批补登 ac 量纲枚举——2026-09-16 护甲等级掷点批换装时的 fields 漏登，随本批顺手收口**；ac_up 2026-09-16、off_guard 2026-09-18 两行在用） + unit: enum {percent, flat, ac}（**2026-09-18 结构修复批补登 ac 量纲枚举——2026-09-16 护甲等级掷点批换装时的 fields 漏登，随本批顺手完成**；ac_up 2026-09-16、off_guard 2026-09-18 两行在用） duration_settlements: int [1,99] stack_policy: enum {stack, refresh, independent} max_stack: int [1,16]（仅 stack 消费——refresh/independent 行内容约定恒 1，非校验项） @@ -167,12 +167,12 @@ entities: ambush_unit_definition: **伏击量纲（已退役——2026-09-20 格面资源八型批）**：原每层伏击 = 每次攻击类行为附加 magnitude 主角 HP 伤害（后置加法不进倍乘），charge 拍零兑付；**继任 = alert 警觉**（敌方护甲等级 +1/层，unit ac、target_side enemy、1 结算、stack 16——blast 负向 enemy_alert 行载体，消费 = 战斗结算 _defender_ac 敌方侧 ac 型读法本批接线）；数值 provisional 归 难度曲线与Boss anchor_warning: weaken 行 vs 行动经济 F1 条款 2 锚两独立线性代理同向预检不过（百分点·结算暴露 25 vs 100；原型战斗量级 ≈1 vs ≈4 当量）——战斗结算 对照验收优先裁决，登记 战斗结算 强制检查点输入。**修复空间不对称（2026-09-09 增补）**：每结算瞬时当量归一 m_w≥51 可行（F2 越域界随移 AP 界 −408%/表界 −816%）；每 AP 总暴露归一 m_w>100 被 percent ∈ [-100,100] 域禁止（该分支不可行）——OQ1 前置步骤：战斗结算 先钉死归一口径，口径落定前禁止数值修订；落总暴露则现实解 = 地图战斗资源 重定最低档参照。**参照对象迁移注记（2026-09-09 地图战斗资源 评审；2026-09-11 回迁）**：最低档安全格 buff 当量的参照对象曾迁 defense_up 当量（attack_up 时为死行——地图战斗资源 F4 迁移）——**2026-09-11 用户裁决"基础攻击恒存在"（HeroTable.atk 域 [1,999]、0 加载拒绝、MVP=6）后 attack_up 复活，参照对象回迁 attack_up 当量**（消费面 = 主角战斗段先手攻击——战斗结算 GDD 同批；defense_up 迁移退役为历史记录，attack_up 入池时 tier_min_buff 重算）；本条与 clause3_supply.direction_precheck 的 25 vs 100 预检算术系 attack_up 口径历史登记——defense_up |−50|×dur2 与 attack_up 数值巧合全等（100pp），今日结论不变；**迁移后预检未按新参照重跑**的义务已于 2026-09-14 战斗结算 重算批兑现（F0/F1 按 attack_up 当量重跑 + F1 锚对照实物改 attack_up 行——本迁移注记关闭）。**F0 裁决回执（2026-09-10 战斗结算 GDD——红警关闭）**：归一口径 = **每结算瞬时当量**（总暴露分支被 percent schema 域禁止 + 与"单结算自然边界"已锁事实冲突，排除）；m_w 修订 −25 → **值域 [60,85]/默认 −65**（mvp_content.weaken 已同批改写——锚两腿 @D_ref=12：7.8 > 6.0 严格大于 ✓ / 7.8 ≥ E_dig 4.5 ✓〔E_dig 读数 2026-09-14 战斗结算 重算批按 难度曲线与Boss v3 曲线重推——原 7.2 随口径退役〕）；地板 = 乘数零点 −100pp、交叉层数 = ⌈100/m_w⌉ = 2（原"7 层触地板"预读按 −400% 合成带估读，更正）；defense_up 参照保持（总暴露分支的"重定参照"现实解未采纳）；终值 = 地图战斗资源/战斗结算 共裁（战斗结算 OQ2）；增益状态 GDD 正文不改以本条为准（收编先例） rule4_exemption: 定义表非进度成长表，键 = effect_id（数据配置 Rule 4 豁免，schema 注释承载） - single_enemy_assumption: **回验结果 = 不成立——敌人系统 定多敌（用户 2026-09-09 拍板；同日 敌人系统 GDD 兑现 增益状态 预授权接口漂移条款）**：MVP 战斗 = 1–3 个同敌种敌单位（EnemyTable.unit_count）；效果 side-wide 语义改"全体存活敌单位"（层数 = side 共享池，**增益状态 现接口零变更兼容**）；target_ref（单体寻址）= 扩展位义务——首个单体效果上线时 增益状态 补列（随批：战斗结算 归集语义/HUD框架 呈现裁决）；增益状态 GDD 正文不改，以本条为准（行动经济 OQ5 收编先例） + single_enemy_assumption: **回验结果 = 不成立——敌人系统 定多敌（用户 2026-09-09 拍板；同日 敌人系统 GDD 兑现 增益状态 预授权接口漂移条款）**：MVP 战斗 = 1–3 个同敌种敌单位（EnemyTable.unit_count）；效果 side-wide 语义改"全体存活敌单位"（层数 = side 共享池，**增益状态 现接口零变更兼容**）；target_ref（单体寻址）= 扩展位义务——首个单体效果上线时 增益状态 补列（顺带：战斗结算 归集语义/HUD框架 呈现裁决）；增益状态 GDD 正文不改，以本条为准（行动经济 OQ5 收编先例） mechanics: 战斗域统一状态容器（三向效果同构实例）· 单一时限量纲 remaining_settlements（先兑付后衰减，每轮结算 −1，dur=1=一次性；跨轮跨图延续、battle_over 全清不跨战斗）· 按行叠层（stack 授予不触碰 R；refresh 重置取实例授予时快照 D；合并在授予时、结算作用顺序归 战斗结算——两序分离）· 满层授予拒绝原子（false+容器零写）· 合成 = L×m 加算、percent 越域不 clamp（地板/换算归 战斗结算 SettlementTable）· 授予集中在 战斗结算 结算编排（排雷玩法/地图战斗资源 零直接接口）· 零随机（无 RNG 流消费）· 零信号外发（纯被动容器） api: notify_battle_start / apply_effect(effect_id, source) -> bool / query_active(side) -> Array（插入序；六归因字段+display_name+授予时快照投影）/ decay_round() -> int / notify_battle_end() -> bool——战斗结算 消费契约，provisional 登记 settlement_obligations: 八项（战斗结算 GDD 门禁评审缺项即 blocking）——① 同轮多授予按确定次序调用 ② 事实→授予恰一次转化（增益状态 不去重）③ percent→乘数换算方向与合成值地板成文 ④ 最后一轮 decay 判定 ⑤ F1 条款 1 效果档位对照表以 增益状态 实例为对照实物 ⑥ 每结算编排恰一次 decay_round（2026-09-09 增——decay 基数=1 先决条件）⑦ 结算明细按授予流水逐条标注来源（合并坍缩归因补偿，2026-09-09 增）⑧ “溢出未生效”行进结算明细协议（Rule 5 后半承载，2026-09-09 增）。**履行回执（2026-09-10）**：八项已全数落位 战斗结算 GDD（Core Rules 3/5/8/10/11 + Formulas F0–F2——落位映射 = 战斗结算 AC 覆盖矩阵"上游义务 23 条"行；③的 AP/表界数值随 F0 修订更新为 −520%/−1040%）。**2026-09-20 修订**：⑧ 随伏击单轮上限删除（用户拍板）退役——溢出未生效行类型下线（行协议 10→9 类），满层拒收走奖励未生效行 presentation_obligations: （2026-09-09 登记 systems-index，缺项即 blocking）HUD框架×4——HUD 常显+EC12 空态规格定稿 / effect_id→icon 映射键契约（形状+色相双通道）/ 有利有害极性呈现映射（数据源 = 战斗结算 SettlementTable 效果语义，非 magnitude 符号）/ 全清状态栏去留；战斗表现×2——溢出行呈现 / origin_cell→玩家可读形态（缩略图/格子高亮）；教学引导——“同轮拿满优于跨轮叠”教学（OQ7 配套）；地图战斗资源——奖励身份预读（创意风险 #1 切面） - ownership_note: 行动经济 OQ5“标中旗 debuff 档位归 地图战斗资源 表设计”经用户 2026-09-08 拍板收编——初值定稿权归 增益状态（2026-09-15 起为七行：标错反噬批两行 + 格面资源批 sapped 一行随批收编），锚验收权仍归 地图战斗资源/战斗结算，修订走接口漂移回写本条 + ownership_note: 行动经济 OQ5“标中旗 debuff 档位归 地图战斗资源 表设计”经用户 2026-09-08 拍板收编——初值定稿权归 增益状态（2026-09-15 起为七行：标错反噬批两行 + 格面资源批 sapped 一行顺带收编），锚验收权仍归 地图战斗资源/战斗结算，修订走接口漂移回写本条 dangling_ref_policy: effect_id 悬空校验**已激活**（2026-09-09 地图战斗资源 RewardTable 首个 effect_id 引用行〔defense_up〕回填——dangling_ref_policy"首个引用字段 owner 补"条款兑现；条件性夹具 = 地图战斗资源 reward_dangling_effect〔AC-17〕） referenced_by: [战斗结算, 地图战斗资源, 敌人系统, HUD框架, 教学引导, 战斗表现] @@ -187,7 +187,7 @@ entities: metrics: 生成期指标集四项 = 实际 inferability(metric_version)/实际雷数与实际 |S|（增益状态——先布后删漂移观测，|M|≤N）/attempts_used/降级标记(shortfall+非法产物) batch_assertions: F4 调参期（N=256/行默认，σ(L,D)=10^9+2^20·L+2^12·D——R4 修订防碰撞，版本库清单）——断言 A 可推理率**严格零**/A″ target ≥ 0.85 绝对下限（战斗结算）/A′ 非法产物零容忍/**B 达成区数=count 板占比 ≥ 0.95（B6 修订收紧——降级率上限）**/E 难度方向 advisory（R2，monotone_in_depth 标记字段）；报告 C 按行 p10/p50/p90 inferability_vs_p_safe: "inferability 是盘面级免赌占比（生成侧）；P(安全) 是单格认知概率（决策侧、经济口径）——免赌集内 P(安全)≡1，风险收缩到残余集（占比 ≤1−inferability）；inferability 是 P(安全) 的生成端结构性上界代理之占比形式，非同义词。战斗结算 条款 3 对账输入 = **actuals 分布 p10（F4 报告 C）而非 target 参数**"。**战斗结算 消费回执（2026-09-10）**：条款③闭合消费本条口径——P(安全) 代理式 = 残余盲猜端上界 P(雷) = |M|÷(|M|+(1−ι)×|S|)（ι = actuals p10，未交付前行 target 代乐观代理）；对账重跑义务 = 棋盘生成 报告 C 交付后强制（战斗结算 AC-39）" - mvp_reference_rows: L1·D0 与 L2·D0 两参考行——**全部 provisional，仅 schema 自洽性证明，曲线数值归 难度曲线与Boss 调参所有权**；参考行现行值不列于本 registry，读 data/tables/board_gen.tres（2026-09-18 指路化收口——原 d0.10/t0.95/att16、d0.12/t0.92/att16 读数随切片 SLICE-TUNED 改值作废）。**2026-09-20 第三关内容批**：L3 战斗/Boss 节点 (3, 0/1/4/5/6/7/8) 七行精确铺满——板面 13×13 / Boss 14×14（「Boss 板 = 本关最大板形」纪律）、min_safe_count 70/82（~0.42 格占比外推）、max_gen_attempts 32/32、board_type=deep_underdark；行值全 provisional 归 难度曲线与Boss + mvp_reference_rows: L1·D0 与 L2·D0 两参考行——**全部 provisional，仅 schema 自洽性证明，曲线数值归 难度曲线与Boss 调参所有权**；参考行现行值不列于本 registry，读 data/tables/board_gen.tres（2026-09-18 指路化完成——原 d0.10/t0.95/att16、d0.12/t0.92/att16 读数随切片 SLICE-TUNED 改值作废）。**2026-09-20 第三关内容批**：L3 战斗/Boss 节点 (3, 0/1/4/5/6/7/8) 七行精确铺满——板面 13×13 / Boss 14×14（「Boss 板 = 本关最大板形」纪律）、min_safe_count 70/82（~0.42 格占比外推）、max_gen_attempts 32/32、board_type=deep_underdark；行值全 provisional 归 难度曲线与Boss minesweeper_dual_containment: 双包含回验登记 排雷玩法 GDD——① 排雷玩法 实际展开域 ⊆ 棋盘生成 排除域（既有）② 棋盘生成 求解器初始态 ⊆ 排雷玩法 实际初始展开域（F1 注记④度量保真对偶） golden_vectors: 推理器黄金图回归向量协议（五类手工核验小板，整数对比对禁浮点容差，逐格信息源推导记录入版本库；换 solver_rules/信息源/metric_version = GDD 修订 + 向量重制）——数据配置 R2 先例同源 initial_expansion_narrowing: （2026-10-05 初始展开收窄批 T1-T3，迭代14①——D1-D5 已裁+S1 停机呈报用户裁方案A）两新参数：**shave_ring_radius**（int [0,2] knob 现行 1——剃雷域=距 spawn_center 切比雪夫距离 ≤1+r 的格，r=1→5×5=25 格；原「R₀ flood 域∪外扩 1 环」全域剃雷退役=开局开阔地巨大根因治理；零 RNG 消费变化，同种子布雷序列逐位一致）+ **r0_max_cap**（int 护栏 [出生格数 9, 板格数一半] 加载期致命；0=闸关 legacy 防御口径；现行按板形投值 **45**〔10×10〕/43〔12×12〕/51〔13×13〕/59〔14×14〕——板面 30% 锚**除 10×10 用户裁 S1 方案A 上调 30→45**：r=1 自然 R₀ 均值 39>30 锚结构性倒挂〔94% 尝试被拒、inf 0.976→0.719、常态 accept_worst 非法板〕，P1「上调若闸过频」预案字面执行；12×12/13×13 健康侧〔inf 达标、拒绝 42%<50% S1 线〕维持）。机制面：R₀≤cap 合法性闸（r0_cap_exceeded——合法性先于质量评分同 inv4 先例；超阈整板作废同流重试；耗尽走既有三分出口 accept_worst 诚实降级）+ metrics 增 r0_cap_rejected 尝试事实（占比=闸触发率读数）。改后结构读数（calibrate_boards 200 板/行，2026-10-05，种子 900000 系）：R₀ 均值 39.7/37.9/42.8/46.6（改前 68.6/83.2——10×10 收窄 42%、12×12 收窄 54%）、尾部被闸精确截断（r0_max==cap 全行）、实际雷密度 19.2-21.6%（<25% 相变线；改前 12.9/15.7% 上浮=知情登记，联动四带复算归 T6）、闸触发率 22%/42%/42%/24%（全 <50%）、inferability 0.939/0.881/0.929/0.921 全行 ≥0.88。T6 MC 四带复算读数批后置（跑批待用户批准，07 挂单）；**锚换代声明**：改前 R₀ 结构读数（68.6/83.2 等）与清图率历史锚只测不判 @@ -198,7 +198,7 @@ entities: owner: design/gdd/systems/排雷循环/排雷玩法.md attributes: kind: 三事件回边契约（发射面封闭——TD-SYSTEM-BOUNDARY 回边裁决的 排雷玩法 侧定稿；增删事件 = 接口漂移修订） - cell_revealed: "{cell, kind ∈ {safe, mine}, digit【仅 kind=safe 携带、恒真透传——呈现隐藏归 HUD框架，判定源 = variant_ids，排雷玩法×4③】, variant_ids, channel ∈ {initial, chain, dig}, resource【initial 恒 false（封锁格无资源）/ chain·dig 恒 true——安全格与雷格一视同仁，雷格亦携带格面资源（负向兑付归 战斗结算 极性路由）】}" # 2026-09-15 格面资源批：reward_eligible → resource，旧口径"mine 恒 false"随批作废 + cell_revealed: "{cell, kind ∈ {safe, mine}, digit【仅 kind=safe 携带、恒真透传——呈现隐藏归 HUD框架，判定源 = variant_ids，排雷玩法×4③】, variant_ids, channel ∈ {initial, chain, dig}, resource【initial 恒 false（封锁格无资源）/ chain·dig 恒 true——安全格与雷格一视同仁，雷格亦携带格面资源（负向兑付归 战斗结算 极性路由）】}" # 2026-09-15 格面资源批：reward_eligible → resource，旧口径"mine 恒 false"顺带作废 flag_judged: "{cell, hit = [cell ∈ M]}×N——轮末统一判定批（基线 = 轮次结束事务开始时旗位，被拔不判；行主序枚举）；排雷玩法 诚实重复上报、兑付去重归 战斗结算/地图战斗资源（资格以雷格实例为键——action_economy.flag_rules/行动经济 OQ5）" round_end: "{path_tag ∈ {ap_exhausted, cleared}, continuation_hint}——棋盘路径由 排雷玩法 外发、核心字段逐字段取自 行动经济.last_round_end（读取权 = 接口契约），与 行动经济 stopped 路径 payload 同构；stopped 由 行动经济 直发、排雷玩法 禁双发（action_economy.round_end_carrier 双发射源）" event_order: 同一轮次结束事务内 flag_judged ×N 先于 round_end（全路径统一——stop 腿 排雷玩法 先发旗判定再委托 request_stop，停手不改旗故基线等价）；战斗结算 结算触发 = Waiting 相位编排点、不依赖事件到达序（战斗结算×3 强制项之一，systems-index 排雷玩法 门禁块） @@ -283,8 +283,8 @@ entities: 魔法护甲: 三型甲之一（= 现役甲域 ward，基础 AC 最低、被普通攻击克 +1）；「魔法甲」系笔误、非别名，不单独登记（3a 裁；锻造工坊.md 首次定义） 并联双通道: 待解锁路线的解锁结构——练满前一档 OR 一次性解锁价，两通道互不影响、玩家自选其一、不设串联门槛（4b-1 裁；锻造工坊.md 首次定义） 出场选择: 一次冒险 = 一个武器类型 + 一个甲型；营地内免费切换、冒险开始后锁死（1a/1b/1c 裁；锻造工坊.md 首次定义） - 攻击祝福/生命祝福/护甲祝福: 局内商店货架三行的玩家向显示名 = 奇物「属性值提升」三轴（攻击/生命上限/AC）的前台标签（机制分类名不动、只改玩家向显示名；2026-10-12 用户裁 8a 连带 C 项——后缀取「祝福」〔D&D Blessing 参照〕，与营地锻造彻底脱离字面关联；旧名「攻击锻升/生命锻升/护甲锻升」就此退役——shop.tres pool_shelf+products 六行 display_name 已换代，改名小批 0c93a71/0144f60 落地，旧名保留本条作检索别名；锻造工坊.md 8a 连带首次定义；registry 补登 2026-10-13 迭代 23 反哺落文批 = 06 改名小批条配套文档面②） - 石肤（近义词占用）: 现有奇物件名（效果即 AC +1）——近义词占用备忘，新命名勿与之撞（2026-10-12 改名小批登记；registry 补登 2026-10-13 迭代 23 反哺落文批 = 06 改名小批条配套文档面③） + 攻击祝福/生命祝福/护甲祝福: 局内商店货架三行的玩家向显示名 = 奇物「属性值提升」三轴（攻击/生命上限/AC）的前台标签（机制分类名不动、只改玩家向显示名；2026-10-12 用户裁 8a 连带 C 项——后缀取「祝福」〔D&D Blessing 参照〕，与营地锻造彻底脱离字面关联；旧名「攻击锻升/生命锻升/护甲锻升」就此退役——shop.tres pool_shelf+products 六行 display_name 已换代，改名小批 0c93a71/0144f60 落地，旧名保留本条作检索别名；锻造工坊.md 8a 连带首次定义；registry 补登 2026-10-13 迭代 23 反哺写入批 = 06 改名小批条配套文档面②） + 石肤（近义词占用）: 现有奇物件名（效果即 AC +1）——近义词占用备忘，新命名勿与之撞（2026-10-12 改名小批登记；registry 补登 2026-10-13 迭代 23 反哺写入批 = 06 改名小批条配套文档面③） referenced_by: [排雷玩法, 敌人系统, 地图战斗资源, 战斗结算, HUD框架, 秘宝, art-bible, game-concept, 关卡节点地图, 冒险结构, 关卡节点图生成, 锻造工坊] - name: enemy @@ -300,17 +300,17 @@ entities: atk_min/atk_max: 可选配对 int [0,999]（2026-09-14 敌方攻击区间批——上阶/下阶区间随机；缺省 = 定值行向后兼容；跨字段：必成对 · **atk = floor((min+max)/2) 向下取整中点锚**〔2026-09-18 与切片 schema 校验式对齐——int 截断，奇数和区间（如 1+2）取下半，期望当量微偏下界为现行口径〕；roll 时机 = 遭遇骰同流〔encounter 恰一 scope，数量骰先、atk 骰后〕spawn 期**整战持久**〔每拍抖动否决——数字可读性锚〕，战斗结算.begin_battle roll → 敌人系统.spawn enemy_atk_override 收确定值〔敌人系统 零随机纪律保持〕；MVP 六行 ±3 provisional 归 难度曲线与Boss；验收 = 完美策略档 0 加成通关 ≤40%〔OQ7〕；接口漂移 = 敌人系统.spawn 签名 +1 参数〔正式侧 GDD/registry 修订随正式化批〕） armor_type: enum {light, ward, heavy} 缺省 light（2026-09-14 护甲克制批转正登记——攻击类型 × 护甲克制，克制矩阵 = settlement_table.armor_effectiveness〔三档加法修正 克制 +1/中性 0/被克 −1，点数读表——2026-09-18 加法核换装批：百分比量纲退役，消费面 = 主角侧〕；MVP 映射 goblin=light / bugbear=ward / ogre_chief=heavy；**2026-09-15 命名统一批：原 enum {none, a, b} 为位置键（无语义、且"无甲/甲A/甲B"在文档间已分裂成四种写法），改 {light, ward, heavy} = 轻甲 / 魔法护甲 / 重甲**；数值 provisional 归 难度曲线与Boss） attack_type: enum {normal, pierce, magic} 缺省 normal（**迭代 24 N3 2026-10-13 轴开列——敌方攻击类型轴**，承接锻造工坊实装批迁移面⑥；消费面 = 伤害控制器敌方技兑付 `_counter_delta(t.attack_type, 主角护甲)`，开单第 9 参由单位快照传值；现行 20 行全填 normal 不做差异化——全局平移主角受伤点数：穿重甲 −1 / 魔法护甲 +1 / 轻甲 0（同种子三甲型配对实测在案）；差异化填值（pierce/magic）属新设计另立项） - armor_class: int [0,999] 缺省 0（**2026-09-15 护甲等级批新增，2026-09-16 定稿落地**——防守方护甲等级，主角普通分量 / 敌方技能基础伤害分量的掷点折扣判定读数，掷点与折扣结算归 settlement_table.ac_roll / ac_discount_tiers〔战斗结算〕；**与 armor_type〔克制属性轴 light/ward/heavy〕是两个概念、字段与文档口径不得混用**；三敌种首关行值 0 暂定，正式行值归怪物设定批〔06 清单登记〕） + armor_class: int [0,999] 缺省 0（**2026-09-15 护甲等级批新增，2026-09-16 定稿落地**——防守方护甲等级，主角普通分量 / 敌方技能基础伤害分量的掷点折扣判定读数，掷点与折扣结算归 settlement_table.ac_roll / ac_discount_tiers〔战斗结算〕；**与 armor_type〔克制属性轴 light/ward/heavy〕是两个概念、字段与文档口径禁止混用**；三敌种首关行值 0 暂定，正式行值归怪物设定批〔06 清单登记〕） hp: int [1,999]（knob——难度修饰前基线；MVP 18 provisional 出处待查） atk: int [0,999]（knob——attack 行为伤害基值；MVP 4 provisional 出处待查；0 合法不拒——2026-09-20 八型批去"纯伏击伤敌种"旧注） - pool: Array of {skill_id, weight[, unlock_hp_pct]}（**2026-09-16 敌人技能池批——池模板**，定义层；weight ∈ (0,9999] knob、池内 skill_id 不重复；**unlock_hp_pct 可选 int [1,99]——2026-10-05 技能池执行批新增〔迭代14④〕：Boss 半血解锁门槛，缺省无字段=无门槛；锁定条目双面过滤不进可摇与保底集合、单向闩、解锁出一次归因行+一次性技能名 toast〔语义=敌人系统 意图呈现节；投放纪律=仅 Boss 行，不做跨表硬闸〕**；每池恰一行普通攻击 + 增益技 ≤1 + skill_id 悬空致命〔加载校验在 config_db.validate_skill_pool_links 跨表通道〕；实例池〔快照+冷却状态〕在 单位容器 spawn——三敌种建议池构成与权重不列于本 registry，读 data/tables/enemy.tres（provisional 归 难度曲线与Boss；EV 锚与含闸长期速率实测读数随验收批另测登记〔2026-09-18 指路化收口〕））。**历史（2026-09-16 退役）**：heavy_multiplier int [1,16]（重击倍率归技能行 damage_mult）与 pattern StringList（行为环环数组）两字段随行为环整体退役——固定出招剧本废除 - rowset_rule: 行集构成纪律（**2026-10-07 行集多行批换代——原「每行集恰一敌种」退役**，违规一律加载期致命）：①行集内 enemy_id 唯一（同坐标同敌种仍只许一行）②同坐标多行必须表文件内相邻且行序 = 声明序 = 生成序（行序即契约——resolver 返回序/开战叙述取首行/生成序全依赖文件行序）③行集实例总数（各行开战骰后数量求和）≤ 4（单行数量域 [1,3] 不变，UNIT_COUNT_MAX 语义 = 单种数）——同坐标多行混编合法（含 Boss 行集，P1 甲 + P4 乙用户裁 2026-10-06；本批零内容投放 P3 丙，首个混编行归后续内容批）——同层多遭遇已由节点编号消解（2026-09-17 关卡节点地图 v1.0：node_depth 语义 = 关卡内唯一节点编号，同层不同节点各查各行、键结构零改动）；进度键解析全仓统一 ceil 版行集数组（原 EnemyTable.resolve_rowset floor 单行版同批退役——双算法销号，状态记录 312）；精英/Boss 不设编码位——Boss = 最大编号节点（图唯一终点）、精英 P2 内容承载（强敌行集）。**精英怪设定登记（迭代 10 奖励重构批 P-D——实装随怪物批）**：与其他普通小怪同一立绘 + 附加特征标记 + 数值更强；视觉特征三件 = 名称前后缀（「精英·熊地精」式——沿用既有译名不换词根）+ 精英底座光环（程序化零立绘改动）+ 精英描边变色（色板合规与样张闸义务随实装批）；掉落挂点 = 钥石 1 个（meta.tres boss_keystone 精英行随实装批落） - mvp_content: **八敌种（2026-09-14 难度曲线与Boss 修订批转正 goblin / bugbear / ogre_chief 三敌种〔DND 更名批用户指令：grub→goblin / ambusher→bugbear / boss_guardian→ogre_chief〕；2026-09-17 分支节点图批新增 giant_spider / drider，本条 2026-09-18 补收编；2026-09-20 第三关内容批新增 duergar / hook_horror / duergar_king，本条随批补收编；敌人系统 物种集断言随批更新为 {goblin, bugbear, ogre_chief, giant_spider, drider, duergar, hook_horror, duergar_king}）**：goblin（地精，armor=light）/ bugbear（熊地精，armor=ward）/ ogre_chief（食人魔酋长，armor=heavy）/ giant_spider（巨蜘蛛）/ drider（蛛化卓尔精灵，Boss = 最大编号节点图唯一终点）/ duergar（灰矮人，单体重甲中坚——重甲首次登台，armor=heavy）/ hook_horror（钩爪恐魔，群行捕食者，armor=light）/ duergar_king（灰矮人石君王，L3 Boss，重甲收束「轻甲→魔法甲→重甲」教学梯度）。技能池构成与权重、armor_type 行映射**不列于本 registry**——〔**2026-09-28 M-3 迭代 5 T4 AC 投值批→2026-09-29 返工批 U2 裁 v1 重投**：初版 Boss-only（杂鱼全 0·Boss 8/9/12）被 U2 推翻——终版 **v1 硬梯度**=杂鱼按 T4 报告 §一 软梯度恢复（0~5 带内）+重击手 8/重装手 9（逐行手设值，非精英编码位——解读 A 追认）+Boss 台阶 8/10/12；v1 中间态未入 git，杂鱼行按报告表值代拟恢复（台账 247）；演化链与三版读数见 git 提交 8ffc555，裁断全录 git 提交 f9c1a8a；冒烟带宽断言随新形态更新（杂鱼 0~5·重击手/重装手 8~9·Boss 8~12 台阶）〕读 data/tables/enemy.tres（L3 行值语义：duergar 关间台阶 ≈L2 单体 ×1.5 落 [1.3,1.6] 域、hook_horror 复用 bite 共享技能行、两敌种首遇位〔节点 0/1〕固定数量不加骰、Boss 血 75 = Σ普通战生命期望 91 × r_boss≈0.82 provisional 锚；行值全 provisional 归 难度曲线与Boss）。**2026-09-17 数值压缩批·文档同步——hp/atk 等数值列改指路存根**：L1/L2 节点编号行集（D0–D8）共 12 行的 hp · atk · atk_min · atk_max · unit_count · unit_count_max · advantage_per_round_cap · armor_class 等现行值**不列于本 registry**——读 `data/tables/enemy.tres`（数值压缩批注释登记：`L1 D0 24/7 → 8/2`、`L1 D1 13/5 → 4/2`、`L1 D2 40/9 → 13/3`、`L1 D3 18/6 → 6/2`、`L1 D4 150/9 → 50/3` Boss、`L2 D0 30/7 → 10/2`、`L2 D1 15/5 → 5/2`、`L2 D4 14/5 → 5/2`、`L2 D5 38/8 → 13/3`、`L2 D6 12/4 → 4/1`、`L2 D7 13/5 → 4/2`、`L2 D8 175/8 → 58/3` drider）；armor_type / armor_class / unit_count 区间 / 技能池权重 / advantage_per_round_cap 不压缩（相对轴与概率轴）。**2026-09-16 敌人技能池批**：行为环拍序列（[attack] 单拍环 / [attack,charge,heavy] 三拍环 / [attack,attack,charge,heavy] 四拍环）与 heavy_multiplier=2 退役，改池模板 + 技能表共享技能行（重击倍率 2 = 技能行 damage_mult）；出处 = 切片 enemy.tres（技能池批改型），曲线数值与池权重归 难度曲线与Boss + pool: Array of {skill_id, weight[, unlock_hp_pct]}（**2026-09-16 敌人技能池批——池模板**，定义层；weight ∈ (0,9999] knob、池内 skill_id 不重复；**unlock_hp_pct 可选 int [1,99]——2026-10-05 技能池执行批新增〔迭代14④〕：Boss 半血解锁门槛，缺省无字段=无门槛；锁定条目双面过滤不进可摇与保底集合、单向闩、解锁出一次归因行+一次性技能名 toast〔语义=敌人系统 意图呈现节；投放纪律=仅 Boss 行，不做跨表硬闸〕**；每池恰一行普通攻击 + 增益技 ≤1 + skill_id 悬空致命〔加载校验在 config_db.validate_skill_pool_links 跨表通道〕；实例池〔快照+冷却状态〕在 单位容器 spawn——三敌种建议池构成与权重不列于本 registry，读 data/tables/enemy.tres（provisional 归 难度曲线与Boss；EV 锚与含闸长期速率实测读数随验收批另测登记〔2026-09-18 指路化完成〕））。**历史（2026-09-16 退役）**：heavy_multiplier int [1,16]（重击倍率归技能行 damage_mult）与 pattern StringList（行为环环数组）两字段随行为环整体退役——固定出招剧本废除 + rowset_rule: 行集构成纪律（**2026-10-07 行集多行批换代——原「每行集恰一敌种」退役**，违规一律加载期致命）：①行集内 enemy_id 唯一（同坐标同敌种仍只许一行）②同坐标多行必须表文件内相邻且行序 = 声明序 = 生成序（行序即契约——resolver 返回序/开战叙述取首行/生成序全依赖文件行序）③行集实例总数（各行开战骰后数量求和）≤ 4（单行数量域 [1,3] 不变，UNIT_COUNT_MAX 语义 = 单种数）——同坐标多行混编合法（含 Boss 行集，P1 甲 + P4 乙用户裁 2026-10-06；本批零内容投放 P3 丙，首个混编行归后续内容批）——同层多遭遇已由节点编号消解（2026-09-17 关卡节点地图 v1.0：node_depth 语义 = 关卡内唯一节点编号，同层不同节点各查各行、键结构零改动）；进度键解析全仓统一 ceil 版行集数组（原 EnemyTable.resolve_rowset floor 单行版同批退役——双算法注销，状态记录 312）；精英/Boss 不设编码位——Boss = 最大编号节点（图唯一终点）、精英 P2 内容承载（强敌行集）。**精英怪设定登记（迭代 10 奖励重构批 P-D——实装随怪物批）**：与其他普通小怪同一立绘 + 附加特征标记 + 数值更强；视觉特征三件 = 名称前后缀（「精英·熊地精」式——沿用既有译名不换词根）+ 精英底座光环（程序化零立绘改动）+ 精英描边变色（色板合规与样张闸义务随实装批）；掉落挂点 = 钥石 1 个（meta.tres boss_keystone 精英行随实装批落） + mvp_content: **八敌种（2026-09-14 难度曲线与Boss 修订批转正 goblin / bugbear / ogre_chief 三敌种〔DND 更名批用户指令：grub→goblin / ambusher→bugbear / boss_guardian→ogre_chief〕；2026-09-17 分支节点图批新增 giant_spider / drider，本条 2026-09-18 补收编；2026-09-20 第三关内容批新增 duergar / hook_horror / duergar_king，本条顺带补收编；敌人系统 物种集断言顺带更新为 {goblin, bugbear, ogre_chief, giant_spider, drider, duergar, hook_horror, duergar_king}）**：goblin（地精，armor=light）/ bugbear（熊地精，armor=ward）/ ogre_chief（食人魔酋长，armor=heavy）/ giant_spider（巨蜘蛛）/ drider（蛛化卓尔精灵，Boss = 最大编号节点图唯一终点）/ duergar（灰矮人，单体重甲中坚——重甲首次登台，armor=heavy）/ hook_horror（钩爪恐魔，群行捕食者，armor=light）/ duergar_king（灰矮人石君王，L3 Boss，重甲收束「轻甲→魔法甲→重甲」教学梯度）。技能池构成与权重、armor_type 行映射**不列于本 registry**——〔**2026-09-28 M-3 迭代 5 T4 AC 投值批→2026-09-29 返工批 U2 裁 v1 重投**：初版 Boss-only（杂鱼全 0·Boss 8/9/12）被 U2 推翻——终版 **v1 硬梯度**=杂鱼按 T4 报告 §一 软梯度恢复（0~5 带内）+重击手 8/重装手 9（逐行手设值，非精英编码位——解读 A 追认）+Boss 台阶 8/10/12；v1 中间态未入 git，杂鱼行按报告表值代拟恢复（状态记录 247）；演化链与三版读数见 git 提交 8ffc555，裁断全录 git 提交 f9c1a8a；冒烟带宽断言随新形态更新（杂鱼 0~5·重击手/重装手 8~9·Boss 8~12 台阶）〕读 data/tables/enemy.tres（L3 行值语义：duergar 关间台阶 ≈L2 单体 ×1.5 落 [1.3,1.6] 域、hook_horror 复用 bite 共享技能行、两敌种首遇位〔节点 0/1〕固定数量不加骰、Boss 血 75 = Σ普通战生命期望 91 × r_boss≈0.82 provisional 锚；行值全 provisional 归 难度曲线与Boss）。**2026-09-17 数值压缩批·文档同步——hp/atk 等数值列改指路存根**：L1/L2 节点编号行集（D0–D8）共 12 行的 hp · atk · atk_min · atk_max · unit_count · unit_count_max · advantage_per_round_cap · armor_class 等现行值**不列于本 registry**——读 `data/tables/enemy.tres`（数值压缩批注释登记：`L1 D0 24/7 → 8/2`、`L1 D1 13/5 → 4/2`、`L1 D2 40/9 → 13/3`、`L1 D3 18/6 → 6/2`、`L1 D4 150/9 → 50/3` Boss、`L2 D0 30/7 → 10/2`、`L2 D1 15/5 → 5/2`、`L2 D4 14/5 → 5/2`、`L2 D5 38/8 → 13/3`、`L2 D6 12/4 → 4/1`、`L2 D7 13/5 → 4/2`、`L2 D8 175/8 → 58/3` drider）；armor_type / armor_class / unit_count 区间 / 技能池权重 / advantage_per_round_cap 不压缩（相对轴与概率轴）。**2026-09-16 敌人技能池批**：行为环拍序列（[attack] 单拍环 / [attack,charge,heavy] 三拍环 / [attack,attack,charge,heavy] 四拍环）与 heavy_multiplier=2 退役，改池模板 + 技能表共享技能行（重击倍率 2 = 技能行 damage_mult）；出处 = 切片 enemy.tres（技能池批改型），曲线数值与池权重归 难度曲线与Boss load_bearing_rules: 多敌模型（1–3 同敌种单位，增益状态 单敌假设回验不成立——见 status_effect.single_enemy_assumption）· 行为环确定性轮转（零随机；先作用后推进；死亡即不动手——轮到前被杀本拍不打指针冻结；同步轮转定理）· 效果 side-wide（原伏击池 = side 共享、增益状态 零接口变更——伏击池随 2026-09-20 八型批退役，side-wide 承载改由增益状态 alert 行承接）· 行值快照抗热重载（增益状态 EC9 同款——池模板同在快照范围，实例池冷却全零起步）· **技能池摇号出招（2026-09-16 敌人技能池批改写——原"行为环确定性轮转/同步轮转定理"退役）**：每拍做什么 = 实例池权重摇号〔开轮时点，随机消费在 战斗结算 换算层 behavior_roll 封闭流；本系统语义零随机不变、单位容器收确定值〕；两道闸 = 全技能各自冷却 + 保底 M；死亡即不动手（摇定后兑现前死亡 → 本拍作废不进账）；拍结构保留（每结算每存活敌恰行动一次/行序/先作用后推进）· 零随机零 UI 零事件订阅（排雷玩法 事件面不含 敌人系统——事实经 战斗结算 转化） settlement_obligations: 六项（敌人系统 GDD 门禁评审缺项即 blocking）——① 行动每结算恰一次（敌单位专属——主角无环）+ 结算内调用序成文 按摇定技能行兑现→apply_damage→commit_action〔2026-09-16 技能池批改型——原 query_attack→apply_damage→advance 随行为环退役〕 ② 雷→伏击恰一次转化 ③ clamp/负值/溢杀与死亡判定时机成文 ④ F1 条款 3 闭合对账（cap 表值 + 量纲 + 棋盘生成 actuals p10 非 target 参数）⑤ 默认目标消费与单体/AOE 分流 ⑥ 伏击 cap 溢出"溢出未生效"明细行协议。**履行回执（2026-09-10）**：六项已全数落位 战斗结算 GDD（Core Rules 5/6/9/10/12 + Formulas F3/F4——落位映射 = 战斗结算 AC 覆盖矩阵）。**2026-09-20 修订**：④⑥ 随伏击单轮上限删除（用户拍板）退役——对账面去 cap 表值、溢出行协议作废；八型批再修订（2026-09-20 格面资源八型批）：② 雷→伏击恰一次转化改 雷→警觉恰一次转化 hud_obligations: 四项（视觉推测型呈现，缺项即 blocking）——① enemy_id→图像线索映射清单成文（预告时序=下一拍预告、挖掘期全程可见；含强度档位/环长直觉编码说明；形状+色相双通道）② 映射全局恒定（enemy_id 键——跨 run 禁重掷）③ 顺位与存活可读 ④ 敌方 side 池呈现口径 rule4_status: 本表是进度成长表（棋盘生成 BoardGenTable 同型，无 Rule 4 豁免） - skill_unlock_mechanics: （2026-10-05 技能池执行批 T3-T5，迭代14④——D7 案甲+D8 呈现面全裁）机制面=单位容器 check_skill_unlocks〔开轮摇号前逐敌检查，hp ≤ round(max_hp×pct/100) 一次过门单向闩，确定性谓词零随机〕+ rollable_skills/special_skills 双面过滤〔保底不得逼出锁定技〕；编排面=battle_orchestrator._roll_round_actions 解锁出归因行「XX 解锁了 YY」〔type=highlight 高光键 skill_unlock，行协议零新增〕；呈现面=row_pacer 对 skill_unlock 行弹一次性技能名 toast〔非演出零动画资产〕；数据面=三 Boss 池尾 +1 门控条目〔震地怒击 ×2.5/CD4·遏毒 ×2.0/CD3·岩崩 ×2.5/CD4——权重 2+unlock 50，provisional 归调参〕；EV 重锚=酋长含闸长期速率抽样 1.1948、smoke EV 抽样带重锚 [1.10,1.30]；读数义务=≥50 distinct seeds 节奏重测〔T7——过涝判读带，跑批待用户批准挂 07；S2 过涝越带→解锁技权重/倍率回调呈报禁自动调〕 + skill_unlock_mechanics: （2026-10-05 技能池执行批 T3-T5，迭代14④——D7 案甲+D8 呈现面全裁）机制面=单位容器 check_skill_unlocks〔开轮摇号前逐敌检查，hp ≤ round(max_hp×pct/100) 一次过门单向闩，确定性谓词零随机〕+ rollable_skills/special_skills 双面过滤〔保底禁止逼出锁定技〕；编排面=battle_orchestrator._roll_round_actions 解锁出归因行「XX 解锁了 YY」〔type=highlight 高光键 skill_unlock，行协议零新增〕；呈现面=row_pacer 对 skill_unlock 行弹一次性技能名 toast〔非演出零动画资产〕；数据面=三 Boss 池尾 +1 门控条目〔震地怒击 ×2.5/CD4·遏毒 ×2.0/CD3·岩崩 ×2.5/CD4——权重 2+unlock 50，provisional 归调参〕；EV 重锚=酋长含闸长期速率抽样 1.1948、smoke EV 抽样带重锚 [1.10,1.30]；读数义务=≥50 distinct seeds 节奏重测〔T7——过涝判读带，跑批待用户批准挂 07；S2 过涝越带→解锁技权重/倍率回调呈报禁自动调〕 referenced_by: [战斗结算, 地图战斗资源, 关卡节点地图, 难度曲线与Boss, HUD框架, 战斗表现, 教学引导] - name: hero @@ -321,7 +321,7 @@ entities: fields: max_hp: int [1,999]（knob；现行值读 data/tables/hero.tres） atk: int [1,999]（**0 = 加载拒绝**——基础攻击恒存在，"0 基线 × 百分比增益恒零"死锁自 schema 层杜绝〔2026-09-11 用户裁决，原"机制开关 MVP=0、激活裁决归 地图战斗资源/战斗结算"作废〕；现行值读 data/tables/hero.tres〔2026-09-17 数值压缩批改型〕；消费面 = 主角战斗段先手攻击——战斗结算 GDD 2026-09-11 增补） - armor_class: int [0,999]（**2026-09-15 护甲等级批新增，2026-09-16 掷点批定稿落地**——主角作为防守方的护甲等级，敌方攻击拍 / 重击拍基线的掷点折扣判定读数；掷点结算归 settlement_table.ac_roll〔战斗结算〕，与 armor_type〔克制属性轴〕两概念不得混用；现行值读 data/tables/hero.tres〔暂定，调参归 难度曲线与Boss〕） + armor_class: int [0,999]（**2026-09-15 护甲等级批新增，2026-09-16 掷点批定稿落地**——主角作为防守方的护甲等级，敌方攻击拍 / 重击拍基线的掷点折扣判定读数；掷点结算归 settlement_table.ac_roll〔战斗结算〕，与 armor_type〔克制属性轴〕两概念禁止混用；现行值读 data/tables/hero.tres〔暂定，调参归 难度曲线与Boss〕） armor_type: enum {light, ward, heavy}（**2026-09-18 营地扩展前置批新增**——主角护甲类型轴可配置可修改，缺省 light 向后兼容；消费面 = 战斗结算甲效矩阵〔敌方攻击自迭代 24 N3 2026-10-13 起随单轴查矩阵——穿重甲受伤 −1/魔法护甲 +1/轻甲 0，全局平移实测在案；原「轴休眠」注随轴开列退役〕；现行值读 data/tables/hero.tres） attack_type: enum {normal, pierce, magic}（**2026-09-18 营地扩展前置批新增**——主角基础攻击量〔atk 量轴〕与攻击类型抽象分离的承载字段：营地永久强化"换成魔法/穿刺攻击" = 改此字段，量轴零改动；消费面 = 战斗结算·战斗段基础分量查甲效矩阵〔原硬编码 normal 退役〕；现行值读 data/tables/hero.tres） rule4_exemption: 单行全局定义表（主角不随关卡自动成长——成长=天赋 元进度/奖励侧；ActionEconomyTable 先例） @@ -390,15 +390,15 @@ entities: p_perfect: int {100,200} percent（knob，默认 200 provisional——完美排雷清图奖励**第二份兑付触发**；2026-09-10 战斗结算 评审批修订：真实双份交付载体〔Core Rule 13#2〕——100 = 仅高光、200 = 双份交付，非整数倍数乘数无运行时载体、域外加载致命；上界受护栏 B 约束〔双读数：D_ref 口径 24 / DPS 严格读数 ≈8，裁决归 难度曲线与Boss〕） segment_order: StringList（结构冻结——段序骨架 [grant, buff_debuff, combat, decay, verdict]；加载期恒等拍板序校验违例致命，防实现乱序静默漂移；2026-09-15 格面资源批五段——item_window/item 两段随可选类删除下线，旧七段序见底部修订记录） source_label_map: Dictionary source_class→文案键（结构冻结——P2 归因呈现映射；键集 = 增益状态 source_class ∪ {判定扩展, enemy_action, flag_miss}——2026-09-10 战斗结算 评审批修订；2026-09-15 格面资源批删"道具"扩展键；新增键 = 接口漂移） - effect_pool_map: Dictionary effect_id→pool {hero_offense|hero_defense|enemy_output|enemy_defense|flat_attach}（结构冻结——F2 效果语义映射，增益状态 Rule 7 载体；键 ⊆ StatusEffectTable 活行集、悬空加载期致命；新 effect_id 上线须随批登记——2026-09-15 格面资源批随 sapped 行收编登记：sapped → hero_offense；**2026-09-16 护甲等级掷点批：删 defense_up → hero_defense 键**〔减伤百分比行退役，hero_defense 池现仅 off_guard 正向行〕；ac_up 为 AC 阈值轴效果、不入任何池；**2026-09-16 敌人技能池批：增 empower → enemy_output · fortify → enemy_defense**〔敌方防御池新词汇——硬化载体，消费面 = 主角攻击合计后 ×(100+clamp(enemy_defense))/100，四池对称：敌打主角 = hero_defense × enemy_output、主角打敌 = hero_offense × enemy_defense；切片现状注记：hero_offense 现行走普通分量 attack_up 直乘、未并入合计乘区，正式化归正式化批〕；**2026-09-18 结构修复批：删 off_guard → hero_defense 键**〔off_guard 换装 AC 轴不入池——hero_defense 池清空、池结构保留；hero_offense 乘区接线同步落地：主角攻击合计后 ×(100+clamp(hero_offense))/100 ×(100+clamp(enemy_defense))/100 两池串乘，attack_up 普通分量直乘旁路退役——上方"切片现状注记"销项〕） + effect_pool_map: Dictionary effect_id→pool {hero_offense|hero_defense|enemy_output|enemy_defense|flat_attach}（结构冻结——F2 效果语义映射，增益状态 Rule 7 载体；键 ⊆ StatusEffectTable 活行集、悬空加载期致命；新 effect_id 上线须顺带登记——2026-09-15 格面资源批随 sapped 行收编登记：sapped → hero_offense；**2026-09-16 护甲等级掷点批：删 defense_up → hero_defense 键**〔减伤百分比行退役，hero_defense 池现仅 off_guard 正向行〕；ac_up 为 AC 阈值轴效果、不入任何池；**2026-09-16 敌人技能池批：增 empower → enemy_output · fortify → enemy_defense**〔敌方防御池新词汇——硬化载体，消费面 = 主角攻击合计后 ×(100+clamp(enemy_defense))/100，四池对称：敌打主角 = hero_defense × enemy_output、主角打敌 = hero_offense × enemy_defense；切片现状注记：hero_offense 现行走普通分量 attack_up 直乘、未并入合计乘区，正式化归正式化批〕；**2026-09-18 结构修复批：删 off_guard → hero_defense 键**〔off_guard 换装 AC 轴不入池——hero_defense 池清空、池结构保留；hero_offense 乘区接线同步落地：主角攻击合计后 ×(100+clamp(hero_offense))/100 ×(100+clamp(enemy_defense))/100 两池串乘，attack_up 普通分量直乘旁路退役——上方"切片现状注记"销项〕） pool_clamp_lo: int pp（结构冻结 −100——percent 池地板域下界，乘数域随之 [0,2]；2026-09-10 统一八字段口径） pool_clamp_hi: int pp（结构冻结 +100——percent 池地板域上界；原"七字段 pool_clamp_lo_hi"措辞作废，数据配置 GDD 行按收编先例以本条为准） round_direction: enum {floor}（结构冻结——单一取整规则） - armor_effectiveness: Dictionary 攻击类型×护甲→克制修正点数（加法 delta，域 [−3,+3]，缺项回退 0 中性；键集结构冻结 {normal, pierce, magic} × {light, ward, heavy}；现行九格读数不列于本 registry——读 data/tables/settlement.tres（**2026-09-18 加法核换装批：量纲由百分比改整数点数，三档 克制 +1/中性 0/被克 −1，五档百分比读数随批退役**）；**2026-09-15 命名统一批：改为语义键，原 {base, dmg_a, dmg_b} × {none, a, b} 位置键作废**；数值 provisional 归 难度曲线与Boss） + armor_effectiveness: Dictionary 攻击类型×护甲→克制修正点数（加法 delta，域 [−3,+3]，缺项回退 0 中性；键集结构冻结 {normal, pierce, magic} × {light, ward, heavy}；现行九格读数不列于本 registry——读 data/tables/settlement.tres（**2026-09-18 加法核换装批：量纲由百分比改整数点数，三档 克制 +1/中性 0/被克 −1，五档百分比读数顺带退役**）；**2026-09-15 命名统一批：改为语义键，原 {base, dmg_a, dmg_b} × {none, a, b} 位置键作废**；数值 provisional 归 难度曲线与Boss） ac_roll: 护甲等级掷点（**2026-09-16 护甲等级掷点批定稿，数字即规范**——骰面 roll_faces=20、nat 最大面 crit_roll=20、暴击倍率 crit_multiplier=200、攻击加成 attack_bonus=0〔结构位，元进度/武器附魔未来投值〕、伤害下限 damage_floor=1、流名 armor_roll_stream="armor_roll"；判定式：掷 1d20，掷点 ≥ 防守方护甲等级 + 攻击加成 → 全额、低掷按缺口查档〔见 ac_discount_tiers〕，nat20 暴击该基础攻击分量 ×2 且恒全额〔双方同规〕；任何攻击落地伤害 ≥ damage_floor〔**2026-09-20 伤害下限全来源批（用户拍板）**：语义扩为任何来源的伤害落地——攻击双方/棋盘克制直伤/爆裂/地形变异/负向反噬全部收进闸内，伤害取值域 [1, +∞) 不设上限；全局 max(1,·)——零值伤害行语义退役，重档折扣行文本记"被压制"〕；吃掷点分量 = 主角先手攻击普通分量 / 敌方技能基础伤害分量〔= 攻击基线 × 技能伤害倍率——2026-09-16 敌人技能池批改述，原"敌方攻击拍与重击拍基线伤害"退役；无伤害分量的增益技不掷不折〕，棋盘来源伤害〔爆裂 / 清障炸药 / 奖励即时——2026-09-19 充能退役后无充能分量；伏击附加项随 2026-09-20 八型批伏击退役移除〕必中全额不掷；回合内随机、消费 armor_roll 封闭流逐次掷逐次取号，可逐位回放） ac_discount_tiers: Dictionary 缺口档边界→档位值 percent（**2026-09-16 定稿**——roll_tier_bounds=[3,7] · roll_tier_discounts=[75,50,25]，档数 = 边界数 + 1；缺口 1-3 → ×0.75 · 4-7 → ×0.5 · 8+ → ×0.25，档位不设零档〔非归零〕，取整沿全局 floor；EV 参考数〔按判定式复算〕= AC10 期望减免 21.25% / AC11 25% / AC12 28.75%；微调旋钮 = 边界与档位值，不动 AC 值；难度曲线与Boss 生存链区间带宽补扫含暴击档与折扣档、"零红档"验收保留） validation: segment_order 违例致命 · effect_pool_map 悬空致命 · p_perfect 域 {100,200}（2026-09-10 载体域——100 = "完美必须 ≥ 不加倍"机制语义下界，200 = 双份交付）——战斗结算 冒烟三行致命 manifest（segorder_violation / poolmap_dangling / pperfect_oob） - mechanics: 结算段序骨架唯一权威载体（授予→增益/减益→战斗→衰减→判定——2026-09-15 格面资源批五段，item_window/item 两段随可选类删除下线）· **随机口径（2026-09-15 护甲等级批修订）**：结算换算层引入回合内随机（ac_roll 护甲等级掷点——必中非归零、低掷按 ac_discount_tiers 档位折扣），掷点流归属未定〔rng_service 流封闭清单 board_gen/reward_roll/encounter 不含结算内消费——新增流须改代码+P1 支柱评审、复用 encounter 则改"实例化期恰一 scope"绑定，登记 战斗结算「待办」，rng_service 条目随定稿批修订〕· 可回放契约 = **封闭随机流可回放**（同 master_seed 同意图序列 ⇒ 步骤流逐位复现——数据配置 AC-15 落点，原"结算路径零随机 / 步骤流逐行相同"口径随批作废；开战掷区间 / 装板摇号属初始化随机维持不变）· 段内伤害序（案C 2026-10-06 用户裁）= 主角先手→逐敌还手→地图伤害账殿后（授予段伤害形态单据暂存、战斗段末按事件序补提交统一结账；主角倒下暂存单整体不兑逐单留「未生效」行）· 调用序钉死 按摇定技能行兑现→apply_damage→commit_action（2026-09-16 技能池批改型——原 query_attack→apply_damage→advance 随行为环退役；行型 10 类同批改型：蓄力行 charge → 施放行 cast〔增益技 0 伤害施放、具名技能、不掷不折——原"不兑伏击"语义随 2026-09-20 八型批伏击退役改述〕）· 衰减恒执行含末轮 · 高光双落载体（perfect_sweep P_perfect——2026-09-10 修订为真实双份兑付载体 / 标中旗 highlight 标记）· 流水行协议字段分层（公共 7 字段 + 行类型特有 target/effect_id/pool_value/聚合计数——2026-09-10 评审批修订；行类型封闭枚举 9 类（2026-09-20 伏击上限删除批下线溢出未生效行 overflow）——2026-09-15 格面资源批由 15 类收拢：删道具行 / 已消耗未生效行 / 使用被拒行 / 窗口打开锚行 window_open / 窗口跳过锚行 window_skip 五类随可选类删除下线〔2026-09-15 窗口锚行批曾由 13 扩为 15，同日回撤〕；行来源断言两层豁免集合同批修订 = 行型豁免 {decay, verdict} × 来源类别豁免 {hero_attack, enemy_action, clear_reward}，豁免不等于免检——豁免行仍受公共字段与各自语义约束，清单改动须同步 战斗结算 明细流水一节与 battle_log_view 格式化）· **类型化克制结算规格 = 战斗结算 GDD F6（W3 补全，2026-09-14 重算批；2026-09-15 命名统一批；2026-09-19 充能退役批——挖掘期充能/战斗段消费半边废止，加法核点数修正）**——逐分量 armor_effectiveness 查表（奖励直伤道具消费方保留） + mechanics: 结算段序骨架唯一权威载体（授予→增益/减益→战斗→衰减→判定——2026-09-15 格面资源批五段，item_window/item 两段随可选类删除下线）· **随机口径（2026-09-15 护甲等级批修订）**：结算换算层引入回合内随机（ac_roll 护甲等级掷点——必中非归零、低掷按 ac_discount_tiers 档位折扣），掷点流归属未定〔rng_service 流封闭清单 board_gen/reward_roll/encounter 不含结算内消费——新增流须改代码+P1 支柱评审、复用 encounter 则改"实例化期恰一 scope"绑定，登记 战斗结算「待办」，rng_service 条目随定稿批修订〕· 可回放契约 = **封闭随机流可回放**（同 master_seed 同意图序列 ⇒ 步骤流逐位复现——数据配置 AC-15 落点，原"结算路径零随机 / 步骤流逐行相同"口径顺带作废；开战掷区间 / 装板摇号属初始化随机维持不变）· 段内伤害序（案C 2026-10-06 用户裁）= 主角先手→逐敌还手→地图伤害账殿后（授予段伤害形态单据暂存、战斗段末按事件序补提交统一结账；主角倒下暂存单整体不兑逐单留「未生效」行）· 调用序钉死 按摇定技能行兑现→apply_damage→commit_action（2026-09-16 技能池批改型——原 query_attack→apply_damage→advance 随行为环退役；行型 10 类同批改型：蓄力行 charge → 施放行 cast〔增益技 0 伤害施放、具名技能、不掷不折——原"不兑伏击"语义随 2026-09-20 八型批伏击退役改述〕）· 衰减恒执行含末轮 · 高光双落载体（perfect_sweep P_perfect——2026-09-10 修订为真实双份兑付载体 / 标中旗 highlight 标记）· 流水行协议字段分层（公共 7 字段 + 行类型特有 target/effect_id/pool_value/聚合计数——2026-09-10 评审批修订；行类型封闭枚举 9 类（2026-09-20 伏击上限删除批下线溢出未生效行 overflow）——2026-09-15 格面资源批由 15 类收拢：删道具行 / 已消耗未生效行 / 使用被拒行 / 窗口打开锚行 window_open / 窗口跳过锚行 window_skip 五类随可选类删除下线〔2026-09-15 窗口锚行批曾由 13 扩为 15，同日回撤〕；行来源断言两层豁免集合同批修订 = 行型豁免 {decay, verdict} × 来源类别豁免 {hero_attack, enemy_action, clear_reward}，豁免不等于免检——豁免行仍受公共字段与各自语义约束，清单改动须同步 战斗结算 明细流水一节与 battle_log_view 格式化）· **类型化克制结算规格 = 战斗结算 GDD F6（W3 补全，2026-09-14 重算批；2026-09-15 命名统一批；2026-09-19 充能退役批——挖掘期充能/战斗段消费半边废止，加法核点数修正）**——逐分量 armor_effectiveness 查表（奖励直伤道具消费方保留） closure_receipt: 行动经济 F1 条款①②③⑤闭合 owner = 战斗结算（2026-09-10 F0–F5 首版验算完成——F0 瞬时当量口径 + m_w 值域裁决见 status_effect.anchor_warning；条款③ clause3_supply 闭合回执；条款⑤ clause5_dominance 条目；actuals p10 交付后强制重跑） referenced_by: [HUD框架, 战斗表现, 音频, 教学引导, 难度曲线与Boss] @@ -411,7 +411,7 @@ entities: variables: [cap, m_amb, unit_count, k_r, L_r]（2026-09-20 八型批：m_amb/k_r/L_r 随伏击退役悬空，条目待曲线调参批重立后重登记） output_range: 单结算结构上界 ∈ [0, unit_count×min(AP, cap)×m_amb]（式随 2026-09-20 八型批伏击退役作废、留档历史）（满配语境 3×min(8,4)×3=36；cap≥8 时真可达上界 72 而非 144；默认行值 unit_count=1 下 12） account_input: 对账输入 = 棋盘生成 actuals p10（F4 报告 C）非 target 参数（棋盘生成 登记口径）；闭合 owner = 战斗结算 单一签字人；左臂（安全格 buff 当量）载体 = **地图战斗资源 F6 当量供给**（2026-09-09 地图战斗资源 定稿——部分缓解非闭合：窗口使用次数是战斗轨迹量，敌人系统 OQ3 扩项保持；2026-09-11 起基础攻击恒在为左臂提供恒定伤害基底，原"当前内容态结构性不可通关"事实退役——敌人系统 Overview 2026-09-11 改写） - direction_precheck: cap=4 下右臂 ≈7.7；左臂按条款 2 最低档锚（+50pp）计 = 0.36×50 = 18——裕度 ≈2.3×（1:1 百分点代理，provisional；2026-09-09 敌人系统 full 评审更正原 4.7×——该值按 +100 两层叠满取值、与"最低档下界"语言矛盾）；量级注记：atk=4 时 attack 拍 L≥2 伏击分量过半（heavy 拍过半点后移、按拍别读取；常态支配修正入口 = 难度曲线与Boss atk 曲线 / 地图战斗资源·战斗结算 m_amb 锚，敌人系统 权限外）。**参照迁移注记（2026-09-09 地图战斗资源 评审；2026-09-11 回迁）**：左臂参照对象曾迁 defense_up 当量（地图战斗资源 F4）——**2026-09-11 用户裁决"基础攻击恒存在"后 attack_up 复活，参照对象回迁 attack_up 当量**（上式 +50pp 系 attack_up 口径，迁移期结束；复算义务随 战斗结算 对照表落定，见 status_effect.anchor_warning 回迁注记）。**闭合回执（2026-09-10 战斗结算 GDD F4——条款③闭合完成；同日评审批双口径更正）**：统一 HP 当量 + 边际配对重算 → 默认 unit_count=1 下 L1 裕度 ≈2.0× / L2 ≈2.6× **通过**（锚行口径；**跨行期望口径 ≈1.2×/1.5× 同向通过——双口径登记，难度曲线与Boss 不得以锚行读数放行 unit_count=2**）；**满配语境（unit_count=3）最坏盲点破线 → 难度曲线与Boss 调参约束登记**（unit_count 轴 + 密度×可推理率轴——unit_count>1 行须降密度或降 m_amb）；本条 pp 代理预检（2.3×）退役为历史记录（量纲混用 + 右臂聚合上界与单格决策单位错配）。**重算回执（2026-09-14 战斗结算 重算批——按现行三输入重推：duration=1 × m_d=−30 × 难度曲线与Boss v3 曲线 d0.25/t0.88）**：L1 裕度 ≈0.48× / L2 ≈0.47× **破线**（锚行口径；跨行期望口径 E_dig=4.5 → ≈0.60×/0.58× 同向破线——双口径登记）；满配语境（unit_count=3）≈0.16× 深度破线；**破线升格为默认曲线级约束——V_safe 侧杠杆（m_d/duration/D_ref）× 板形侧杠杆（密度×ι 联动对）× m_amb 全处"禁独立调参"联动网络（m_w↔D_ref↔m_d↔duration_d），修正方向须 难度曲线与Boss 提案 + 战斗结算 闭合对账共裁**；上段 ≈2.0×/2.6× 读数系 duration=2 × m_d=−50 × v1 曲线旧值链产物，退役为历史记录；actuals p10 交付后强制重跑（战斗结算 AC-39；ι 判式面保守代理 = 行 target 代，总暴露面无效）。**换代收口（2026-10-05 判式换代批——clause3_inequality 重立承接）**：本条伏击口径悬空变量（m_amb/k_r/L_r）的重立义务由 clause3_inequality 承接销项；本条 unit_count 满配语境约束（unit_count>1 行须降密度或降 m_amb）由 β 带逐 u 检算（u=1/2/3）接替看护，留档历史 + direction_precheck: cap=4 下右臂 ≈7.7；左臂按条款 2 最低档锚（+50pp）计 = 0.36×50 = 18——裕度 ≈2.3×（1:1 百分点代理，provisional；2026-09-09 敌人系统 full 评审更正原 4.7×——该值按 +100 两层叠满取值、与"最低档下界"语言矛盾）；量级注记：atk=4 时 attack 拍 L≥2 伏击分量过半（heavy 拍过半点后移、按拍别读取；常态支配修正入口 = 难度曲线与Boss atk 曲线 / 地图战斗资源·战斗结算 m_amb 锚，敌人系统 权限外）。**参照迁移注记（2026-09-09 地图战斗资源 评审；2026-09-11 回迁）**：左臂参照对象曾迁 defense_up 当量（地图战斗资源 F4）——**2026-09-11 用户裁决"基础攻击恒存在"后 attack_up 复活，参照对象回迁 attack_up 当量**（上式 +50pp 系 attack_up 口径，迁移期结束；复算义务随 战斗结算 对照表落定，见 status_effect.anchor_warning 回迁注记）。**闭合回执（2026-09-10 战斗结算 GDD F4——条款③闭合完成；同日评审批双口径更正）**：统一 HP 当量 + 边际配对重算 → 默认 unit_count=1 下 L1 裕度 ≈2.0× / L2 ≈2.6× **通过**（锚行口径；**跨行期望口径 ≈1.2×/1.5× 同向通过——双口径登记，难度曲线与Boss 禁止以锚行读数放行 unit_count=2**）；**满配语境（unit_count=3）最坏盲点破线 → 难度曲线与Boss 调参约束登记**（unit_count 轴 + 密度×可推理率轴——unit_count>1 行须降密度或降 m_amb）；本条 pp 代理预检（2.3×）退役为历史记录（量纲混用 + 右臂聚合上界与单格决策单位错配）。**重算回执（2026-09-14 战斗结算 重算批——按现行三输入重推：duration=1 × m_d=−30 × 难度曲线与Boss v3 曲线 d0.25/t0.88）**：L1 裕度 ≈0.48× / L2 ≈0.47× **破线**（锚行口径；跨行期望口径 E_dig=4.5 → ≈0.60×/0.58× 同向破线——双口径登记）；满配语境（unit_count=3）≈0.16× 深度破线；**破线升格为默认曲线级约束——V_safe 侧杠杆（m_d/duration/D_ref）× 板形侧杠杆（密度×ι 联动对）× m_amb 全处"禁独立调参"联动网络（m_w↔D_ref↔m_d↔duration_d），修正方向须 难度曲线与Boss 提案 + 战斗结算 闭合对账共裁**；上段 ≈2.0×/2.6× 读数系 duration=2 × m_d=−50 × v1 曲线旧值链产物，退役为历史记录；actuals p10 交付后强制重跑（战斗结算 AC-39；ι 判式面保守代理 = 行 target 代，总暴露面无效）。**换代完成（2026-10-05 判式换代批——clause3_inequality 重立承接）**：本条伏击口径悬空变量（m_amb/k_r/L_r）的重立义务由 clause3_inequality 承接销项；本条 unit_count 满配语境约束（unit_count>1 行须降密度或降 m_amb）由 β 带逐 u 检算（u=1/2/3）接替看护，留档历史 referenced_by: [战斗结算] - name: clause3_inequality @@ -420,8 +420,8 @@ entities: attributes: rule: （2026-10-05 判式换代批重立——迭代14②号卡 T3，2026-10-04 用户两轮拍板+grill 七问全裁，设计权威=方案报告 §九（已退役，git 1da9a41））行动经济 F1 条款3 三层口径并行立——**条款3 聚合健康式**：(1−ρ̂)·E_dig(u) − ρ̂·V_mine(u) ≥ 0 对全部参考板形 × u ∈ {1,2,3}（下限 0 唯一保留，上限 U_band 删〔grill Q3〕由 β_hi 独家承载）；**旗边际引理**（同池结构定理）：EV_flag−EV_blind = (q+ρ̂−1)(E_dig+V_mine)，旗优于盲挖 ⇔ q > 1−ρ̂，与全部当量表值无关；旗对已知安全格边际恒 ≤ 0（L2 结构破线层）；**条件二旗溢价式**：E[标中兑付] ≥ (1+δ)·E_dig(u)，δ=0.25 provisional（形态 a 兑付溢价 settlement.flag_hit_premium=125 percent 域；形态 b 专属池不启——雷安同池冻结）；**β 比值带**：β(u)=V_mine(u)÷E_dig(u) ∈ [1.2, 2.5]（2026-10-04 用户裁 P4）；**η 读数**（非判式）：η=flag_hit÷flag_placed，分母=全部插旗数〔grill Q5〕，标空率次读数——承载=MC runsum 五字段（flag_placed/flag_hit/flag_miss/flag_hit_gain/flag_miss_penalty，2026-10-05 T1 落码） mechanism_carrier: settlement.tres flag_hit_premium = 125（percent 域 provisional，2026-10-05 T4 落地）——标中旗正向兑付按同型正向 ×(1+δ)：flat 行乘 power、percent 行乘幅度（apply_effect magnitude_override 通道）、gp 行乘 power；取整=四舍五入（与伤害管线 round_direction=floor **分域**——溢价系兑付构造非伤害管线取整，登记注记）；标空/挖格/清图兑付不乘溢价；DamageController 零改、雷安同池冻结不动、直伤雷 6/8/8 与 p_perfect 不动（契约红线） - prechange_snapshot: **改前静态锚（2026-10-05 T0，audit 工具常量刷新后跑出，改后判读的基准）**——池 77 权重（attack14/defense11/blast16/heal4/weaken8/pierce8/magic8/action6/gp2，clear_blast 不入格池）：E_dig(1/2/3)=1.442/1.948/2.455，V_mine(1/2/3)=2.460/2.670/2.881（九型负向字典口径乙=唯一口径，伏击口径甲退役删除），β=1.71/1.37/1.17（u=1/2 带内、u=3 微破下限=登记态点名不强制回滚），盲挖净期望（名义ρ）=+0.47/+0.79/+1.12 恒正（条款3 聚合健康式现行即绿），逐型净期望破线残留=pierce −1.25 / magic −0.50 / heal 0 踩线（名义ρ；实测ρ̂ 10×10 下 pierce −0.16 唯一实测也破、magic/heal 转正），条件二改前恒假（E[标中]=E_dig < 1.25·E_dig——登记已知破，T4 机制闭合）；改前行为锚=MC n400 种子窗 76000 系+verifier 双窗（T2，读数随批出口报告） - p7_corrections: **P7 口径修正注记（2026-10-04 用户裁随批登记）**：①d70f6c3 §二（迭代8 卡⑧全量复算）池 76 系历史混计——clear_blast（清图槽对象）不该入格池，现行口径=77；②同读数直伤雷 4/5/5 已时效化——2026-10-01 数值修复批 6/8/8 + 2026-10-03 带换代转正，现行单雷期望直伤 ≈1.97 HP（×2.2）；heal 权重 2→4（Package B 第 2 轮）同链时效 + prechange_snapshot: **改前静态锚（2026-10-05 T0，audit 工具常量刷新后跑出，改后判读的基准）**——池 77 权重（attack14/defense11/blast16/heal4/weaken8/pierce8/magic8/action6/gp2，clear_blast 不入格池）：E_dig(1/2/3)=1.442/1.948/2.455，V_mine(1/2/3)=2.460/2.670/2.881（九型负向字典口径乙=唯一口径，伏击口径甲退役删除），β=1.71/1.37/1.17（u=1/2 带内、u=3 微破下限=登记态点名不强制回滚），盲挖净期望（名义ρ）=+0.47/+0.79/+1.12 恒正（条款3 聚合健康式现行即绿），逐型净期望破线残留=pierce −1.25 / magic −0.50 / heal 0 踩线（名义ρ；实测ρ̂ 10×10 下 pierce −0.16 唯一实测也破、magic/heal 转正），条件二改前恒假（E[标中]=E_dig < 1.25·E_dig——登记已知破，T4 机制闭合）；改前行为锚=MC n400 种子窗 76000 系+verifier 双窗（T2，读数顺带出口报告） + p7_corrections: **P7 口径修正注记（2026-10-04 用户裁顺带登记）**：①d70f6c3 §二（迭代8 卡⑧全量复算）池 76 系历史混计——clear_blast（清图槽对象）不该入格池，现行口径=77；②同读数直伤雷 4/5/5 已时效化——2026-10-01 数值修复批 6/8/8 + 2026-10-03 带换代转正，现行单雷期望直伤 ≈1.97 HP（×2.2）；heal 权重 2→4（Package B 第 2 轮）同链时效 rerun_obligation: 难度曲线与Boss 每次调参逐 u 检算落 β 带（常设重跑入口 tools/clear_dominance_audit.py，2026-10-05 已刷新=池77/直伤6-8-8/heal2/清图24-40/AP8/off_guard −1/伏击退役/β+逐型输出）；直伤雷/ρ 提案逐档检算落带（grill Q3 裁）；δ 敏感度判据 ≥5pp（grill Q4），行为无效 δ 仍保留+登记「行为无感」 referenced_by: [行动经济, 战斗结算, 难度曲线与Boss] @@ -431,7 +431,7 @@ entities: attributes: rule: 行动经济 F1 条款⑤清图 vs 弃图支配性闭合（战斗结算 单一闭合 owner，战斗结算 GDD F5；**2026-09-10 评审批模型修订：挖穿残余池计价**——E[踩雷] = |M|×n_s/(n_s+1) 均匀交错模型、Δr = ⌈(n_s+E[踩雷])÷AP_r⌉；旧模型按每格独立赌 P(雷) 漏计全池挖掘量、系统性偏乐观）——主判式 Δ_clear = [R_res + C_eff] − [X_res + Δr × s_ref] ≥ 0；E_dig = 默认根加权 7.2 HP（刀 40%/治疗 25%/defense_up 35%）；C_eff = C ×（perfect ? P_perfect÷100 : 1）（×2 = 真实双份交付）；s_ref = D_ref；**停手侧 RAP 机会收益按零计价（显式假设登记——零价假设下 verdict 已为负，为 RAP 计价只会更负）**；域守卫 n_s < 1 ⇒ 主判式不评估、信息端平凡腿接管 first_pass: **条款⑤未闭合（2026-09-10 模型修订重推——旧"两态通过"读数作废）**：L1 −5.3 / L2 −10.1（完美双份 +2.7/−2.1）；满配语境 unit_count=3 深度为负（−49.6/−97.5，与 clause3_supply 破线同向联动）；实现率折减口径（E_dig×0.6）更差（−18.5/−39.5）；保守地板需求 L1 ≥ 46.1 / L2 ≥ 91.8（vs C=8/完美 16——缺口 −38.1/−75.8）。**难度曲线与Boss/地图战斗资源 约束包**：① C 量级上调整向（护栏 B 口径联动复核）② 或裁"清图非严格支配"为设计态（如裁设计态须同步声明 行动经济 条款⑤ P1 对冲弱化 + 地图战斗资源 预警加权监控）——①②二选一归 难度曲线与Boss 裁；③ 多敌放行判据 = 条款③⑤在全部登记行组合下同时成立。判据函数角色 = 调参约束生成器（AC-40 断言输出与约束包一致） - c3_ruling: **约束包②采信（非支配设计态）+ 计价基元换位重推（2026-09-14 难度曲线与Boss 修订批）**——clear_default 槽由 clear_knife（入库刀 C=8/完美 16）换位为 clear_blast（instant_aoe 当场兑付全体存活敌，**2026-09-17 数值压缩批后 C = power_min/power_max 区间 [8,18]、中点 13**）：保守地板需求缺口重推 = 46.1−13 = 33.0（L1）/ 91.8−13 = 78.8（L2）（**压缩批前后读数对比——原 6.1/51.8 系 C=40 口径、压缩批后按新区间中点 13 重推**）；C 量级不上调 ✓；P1 对冲弱化同步声明（② 条件）+ 弃图率加权监控随 OQ4 持续；本条 first_pass 旧读数（C=8/16 口径）留作模型演进记录；**区间批义务（2026-09-14 登记 + 2026-09-17 压缩批修订）**：C 语义改区间〔压缩批前 [25,55] 中点 40 / 压缩批后 [8,18] 中点 13——期望口径按压缩批后中点 13 读〕；保守地板口径（min=8）缺口重推 = 38.1/83.8——战斗结算 修订批对齐条款⑤措辞。**重算回执（2026-09-14 战斗结算 重算批——v3 曲线 d0.25/t0.88 × E_dig=4.5 重推，参考板形换锚 难度曲线与Boss MVP 行值总表）**：主判式 L1 −28.7/+11.3（完美翻正）、L2 −67.4/−27.4、满配 −153.2/−113.2 与 −257.1/−217.1；保守地板需求 L1 ≥ 110.3 / L2 ≥ 166.8（缺口 70.3/126.8，对 clear_blast——**2026-09-17 压缩批后按 C=13 重推为 ≥ 56.1 / ≥ 112.6，缺口按新中点重核**）；上段 46.1/91.8 需求系 v1 曲线旧值链产物退役；**难度曲线与Boss 裁决②非支配设计态维持**（qualitative 结构不变——非完美态负、完美态 L1 翻正、L2 全负）；护栏 A 方向性复核 ≈−1.1 越下界（E_dig 修正）/ 护栏 B C=40 越线——W2 复核三选一裁决随 难度曲线与Boss 收口批；actuals 交付后按 clear_blast 语义强制重跑（战斗结算 AC-40 同批口径） + c3_ruling: **约束包②采信（非支配设计态）+ 计价基元换位重推（2026-09-14 难度曲线与Boss 修订批）**——clear_default 槽由 clear_knife（入库刀 C=8/完美 16）换位为 clear_blast（instant_aoe 当场兑付全体存活敌，**2026-09-17 数值压缩批后 C = power_min/power_max 区间 [8,18]、中点 13**）：保守地板需求缺口重推 = 46.1−13 = 33.0（L1）/ 91.8−13 = 78.8（L2）（**压缩批前后读数对比——原 6.1/51.8 系 C=40 口径、压缩批后按新区间中点 13 重推**）；C 量级不上调 ✓；P1 对冲弱化同步声明（② 条件）+ 弃图率加权监控随 OQ4 持续；本条 first_pass 旧读数（C=8/16 口径）留作模型演进记录；**区间批义务（2026-09-14 登记 + 2026-09-17 压缩批修订）**：C 语义改区间〔压缩批前 [25,55] 中点 40 / 压缩批后 [8,18] 中点 13——期望口径按压缩批后中点 13 读〕；保守地板口径（min=8）缺口重推 = 38.1/83.8——战斗结算 修订批对齐条款⑤措辞。**重算回执（2026-09-14 战斗结算 重算批——v3 曲线 d0.25/t0.88 × E_dig=4.5 重推，参考板形换锚 难度曲线与Boss MVP 行值总表）**：主判式 L1 −28.7/+11.3（完美翻正）、L2 −67.4/−27.4、满配 −153.2/−113.2 与 −257.1/−217.1；保守地板需求 L1 ≥ 110.3 / L2 ≥ 166.8（缺口 70.3/126.8，对 clear_blast——**2026-09-17 压缩批后按 C=13 重推为 ≥ 56.1 / ≥ 112.6，缺口按新中点重核**）；上段 46.1/91.8 需求系 v1 曲线旧值链产物退役；**难度曲线与Boss 裁决②非支配设计态维持**（qualitative 结构不变——非完美态负、完美态 L1 翻正、L2 全负）；护栏 A 方向性复核 ≈−1.1 越下界（E_dig 修正）/ 护栏 B C=40 越线——W2 复核三选一裁决随 难度曲线与Boss 完成批；actuals 交付后按 clear_blast 语义强制重跑（战斗结算 AC-40 同批口径） guardrails: 护栏 B 防钓鱼（**2026-09-10 输入登记更正 + 双读数**：|S|_min = 棋盘生成 行级 knob 禁写死；|R₀|_max 无登记供给方——登记 棋盘生成 产出义务〔R₀ 规模分布上界，报告 C 扩列〕；s_ref=D_ref=12 比真实敌方 DPS 期望松 2.5–3×→ D_ref 口径上界 24〔C_eff=16 ✓〕/ DPS 严格读数 ≈8〔C_eff=16 越〕——两读数裁决归 难度曲线与Boss，与约束包①联动；结构承载 = 棋盘生成 min_safe_count + 布雷数下限 + 排雷玩法 R₀≠S 三闸的对账复核，非运行期校验） rerun_2026_09_19: **对账重跑回执（用户指令提前执行 06 待办「清图支配性保守地板缺口」的对账义务——设计权威回执 git 提交 2ca3e20，重算器 tools/clear_dominance_audit.py〔判式全参数可配=调参批常设重跑入口〕）**：①现行值链重推（D_ref 4 / C [8,18] 中点 13 / AP_r 6 / 伏击 1 / 七型 67 权重池重推 E_dig=(54+39u)÷67 ≈1.388〔u=1〕）——**定性结构不变，裁决②维持**：非完美态 18 语境全负（L1 前段实测 −4.7 ~ L2 名义 −44.3），完美态 L1 前段实测板形翻正 +8.3（名义 −9.8）、12×12 全负；②**V_mine 双口径登记**——注册公式 V_mine=u×m_amb 成文于"所有雷→固定伏击"旧世界，极性矩阵批后踩雷惩罚按格型路由（伏击仅 blast 型负向），新增口径乙 = 负向字典 67 权重加权 (42+50.4u)÷67 ≈1.379〔u=1，主读数〕，口径甲留作旧账连续对比；③**板形双口径**——"先布后删"使实测幸存雷（10×10 ≈12.9 / 12×12 ≈22.4，board_stat_probe.gd 200 样本）远低于名义初布（23/34），E[踩雷] 近乎减半；④**保守地板缺口主读数收窄**——L1 前段 ≈24.2 / L2 ≈44.9（u=1·对 C_min=8；完美双份对照 16.2/36.9），较压缩批注记 38.1/83.8 显著收窄；⑤**护栏 B 连带越线披露（2026-09-17 压缩批未登记面）**——D_ref=4 后防钓鱼上界 ⌈(|S|min−|R₀|max)/AP_r⌉×D_ref÷2 = 10〔|S|min=50〕/14〔60〕，C=13 越 1.3×、完美 26 越 1.9–2.6×——三选一（上界改判/接受+强化监控/回调 C）归 难度曲线与Boss 调参批；⑥模拟实证同向（双画像配对 1200 局：刷新流通关率全面 ≥ 推到底流，L1 基线档 87% vs 73%；实测盲挖踩雷 0.30–0.87/局 远低于判式保守计价 E[踩雷]≈12–21/板——保守地板系构造性上界；刷新策略实测 0.03–0.23 次/局几乎不发生）；06 待办条目随本回执销项（解决即移除），常设重跑义务以本条 rerun_obligation 为准 rerun_obligation: actuals p10 交付后强制重跑（战斗结算 AC-40）；难度曲线与Boss 每次调参重跑（D_ref/P_pf/C 联动——重跑入口 tools/clear_dominance_audit.py + 实测板形 smoke/board_stat_probe.gd 重取样） @@ -508,7 +508,7 @@ entities: type: convention owner: design/gdd/systems/表现与支撑/HUD框架.md attributes: - kind: 呈现面契约（读图接口清单 + 订阅纪律 + 命令式刷新面 + 载荷 schema 索引——封装收口批〔session-state entry 39/40〕切片事实的 GDD 转正） + kind: 呈现面契约（读图接口清单 + 订阅纪律 + 命令式刷新面 + 载荷 schema 索引——封装完成批〔session-state entry 39/40〕切片事实的 GDD 转正） read_map: 排雷玩法 current_board()/reveal_record()/compute_move_path() · 行动经济 getter-only phase/ap/rap/last_round_end · 战斗结算 presentation_snapshot()/is_battle_live()/stock_count()/query_reward_identity() + 步骤流信号 · 敌人系统 hero_unit()/all_enemies() · **增益状态/地图战斗资源 零直读**（经 战斗结算 呈现面与流水投影）· runner（节点链/当前节点/HP 携带） write_paths: settle_batch（stop 亦经此，禁直调 行动经济）/ submit_window_selection(窗口条目位置序，非库存句柄) / 刷新意图 → 战斗结算 refresh_board 编排 / runner 推进——**全部唯一发生在组合根** subscription_discipline: 呈现层永不直接订阅 排雷玩法/行动经济——只订 战斗结算 步骤流/快照与 runner 信号；接线全部在组合根 @@ -516,7 +516,7 @@ entities: payload_schema_index: HUD框架 GDD Core Rule 17 表 13 项——排雷玩法 三事件/战斗结算 流水行协议/地图战斗资源 窗口载荷等均为引用既有 schema；HUD框架 自有成文 = ux 遥测六行（ux_round_input_ratio/ux_round_exit/ux_refresh_attempt/ux_window_choice/ux_reject/ux_hint_shown）+ hint_id 封闭枚举 {chord, no_adjacent} lifetime_visibility_rule: 销毁前捕获（终局/死亡数据 despawn 前已入流水与快照）/ 载荷自包含（行协议自带来源/值/目标，禁按行序反推）/ 禁回读核心生命周期态（唯一观测口 = is_battle_live() 与 phase 投影）——切片缺陷②教训转正 naming_unification: 正式名 request_refresh（行动经济）/ refresh_cap_per_round（结构位默认 2）——切片 provisional 名 request_refresh_active/can_request_refresh/refresh_max_per_round/during_round 退役（AC grep 断言零残留） - drift_registrations: ① 行动经济 只读观测量缺轮内已用刷新次数（刷新按钮"本轮剩 N 次"读数缺口——行动经济 修订批补）② 切片 settlement_snapshot 信号 战斗结算 GDD 未登记契约（HUD框架 现行消费 = 步骤流判定行 + presentation_snapshot()，独立信号须回 战斗结算 补登记）③ 极性提案实施批 HUD框架 义务条目（未开格类型图标/极性视觉语言/负向文案族——随批入 systems-index HUD框架 台账） + drift_registrations: ① 行动经济 只读观测量缺轮内已用刷新次数（刷新按钮"本轮剩 N 次"读数缺口——行动经济 修订批补）② 切片 settlement_snapshot 信号 战斗结算 GDD 未登记契约（HUD框架 现行消费 = 步骤流判定行 + presentation_snapshot()，独立信号须回 战斗结算 补登记）③ 极性提案实施批 HUD框架 义务条目（未开格类型图标/极性视觉语言/负向文案族——顺带入 systems-index HUD框架 状态记录） referenced_by: [战斗表现, 音频, 教学引导, 秘宝, 设置与本地化] - name: aux_items @@ -539,11 +539,11 @@ entities: api: 封闭枚举 8 入口（provisional，实现期定名）——add_item(item_id, source) / query_inventory（枚举序 = 受理序，Used 保留只读，逐件含 usable 板级零信息可用性预判）/ validate_use(handle, target?) → 效果投影（只读不消耗；目标校验谓词 = 越板/点击级零信息拒绝 + 边缘窗口裁剪 resolved_target = 窗口 ∩ 板内格）/ apply_overlay(kind, target, mag)（战斗结算 逐 kind 调用）/ consume(handle)（Used 不可逆 + 快照回执）/ query_overlays（三集只读投影）/ retire_overlays（战斗结算 编排——与 地图战斗资源 retire_mapping 同点）/ clear_inventory（关卡末幂等）；负空间 = 无自动使用入口/无重掷/无事件订阅/无 RNG 直连/无 排雷玩法/地图战斗资源 写入口 use_orchestration: 战斗结算 use_aux 规范序（唯一调用权）= 相位 gate（Active——行动经济 phase getter）→ validate_use（目标校验读 排雷玩法 只读面——使用目标校验谓词表见 秘宝 GDD）→ 逐 kind 应用（顺序钉死：空间先、ap_grant 后——effect_kinds 列表序非运行时语义）→ consume——序即原子（validate 拦下全部可失败输入；apply/grant 域内无失败路径 → consume 恒达） formulas: F1 aux 渗透供给（E[N_aux/板] = |U|×Σw_aux/W_total，默认根 ≈1.7 件/板、稀有 ≈0.17；|U| 分布缺口待 棋盘生成 actuals——地图战斗资源 预检 11 同批重跑）· F2 维度覆盖谓词 coverage(d) · F3 信息价值方向预检（显影 ι↑ → 残余盲猜端 n_s = (1−ι)|S| 收缩 → 盲赌暴露下降 → 期望踩雷↓——P(雷) = |M|/(|M|+n_s) 对 ι 递增，单赌命中率上行属正常，收益在"少赌"非"单赌更安全"；与 战斗结算 F4 同式 + n_s<1 适用域守卫；2026-09-14 评审修正原"P(雷)↓"方向误写；定量当量归 战斗结算 条款①对照表扩列——战斗结算×④注记，MVP 不入对照表） - obligations: 21 项跨 GDD 义务清单（秘宝 GDD Dependencies 全文，对侧修订批逐项核对、缺项即 blocking）——战斗结算×①②③（use_aux 编排/生命周期/授予路由，缺项即 blocking）+ 战斗结算×④（对照表扩列注记）· 地图战斗资源×①…⑤（category 扩值 aux_item/effect_id 双表校验+夹具 reward_dangling_aux/use_timing 扩 during_dig/默认根六行+池总权重算/OQ2 收口注记）· 行动经济×①（grant_ap 第 9 API 接口漂移预授权——Active 受理、无上限域、零随机）· 地形变异×①②③（counter_item_ids 首引回填随未来变异行建行批/悬空校验激活+夹具 aux_dangling_counter/未来变异随批配 ≥1 反制——原雾行绑定随移除悬空，显影尘效果待重定）· HUD框架×①…④（库存条/使用交互/叠加层三集呈现/清空反馈）· 数据配置×①②（AuxItemTable 登记/两处表值回填+校验激活）· 教学引导×①（教学候选，非 blocking）· art-bible×①（§4.6 键扩容：item_id 六键+叠加层标记三族） + obligations: 21 项跨 GDD 义务清单（秘宝 GDD Dependencies 全文，对侧修订批逐项核对、缺项即 blocking）——战斗结算×①②③（use_aux 编排/生命周期/授予路由，缺项即 blocking）+ 战斗结算×④（对照表扩列注记）· 地图战斗资源×①…⑤（category 扩值 aux_item/effect_id 双表校验+夹具 reward_dangling_aux/use_timing 扩 during_dig/默认根六行+池总权重算/OQ2 完成注记）· 行动经济×①（grant_ap 第 9 API 接口漂移预授权——Active 受理、无上限域、零随机）· 地形变异×①②③（counter_item_ids 首引回填随未来变异行建行批/悬空校验激活+夹具 aux_dangling_counter/未来变异顺带配 ≥1 反制——原雾行绑定随移除悬空，显影尘效果待重定）· HUD框架×①…④（库存条/使用交互/叠加层三集呈现/清空反馈）· 数据配置×①②（AuxItemTable 登记/两处表值回填+校验激活）· 教学引导×①（教学候选，非 blocking）· art-bible×①（§4.6 键扩容：item_id 六键+叠加层标记三族） ux_flag: 有 UI 贡献（库存条/使用交互/叠加层呈现）——Phase 4 前置 /ux-design；asset-spec 候选（art-bible 样张批后） - closures: 地图战斗资源 OQ2 秘宝 侧收口（呈现深度 = 道具驱动预读；未预读格不呈现、自动寻路不做——终态与否 OQ6）· 创意风险 #1 道具侧兑现（plan 维度预读——结构闭环最后一块，呈现归 HUD框架）· 显影语义（原为雾格显影 = fog_reveal）随雾格移除失义、载体待重定（随秘宝整体重设计归 Alpha，2026-09-20 用户拍板） + closures: 地图战斗资源 OQ2 秘宝 侧完成（呈现深度 = 道具驱动预读；未预读格不呈现、自动寻路不做——终态与否 OQ6）· 创意风险 #1 道具侧兑现（plan 维度预读——结构闭环最后一块，呈现归 HUD框架）· 显影语义（原为雾格显影 = fog_reveal）随雾格移除失义、载体待重定（随秘宝整体重设计归 Alpha，2026-09-20 用户拍板） warnings: 预警①…④ playtest 预注册归 难度曲线与Boss（道具依赖度/预读覆盖率/AP 转存联动/稀有感知） - attunement_refactor: 迭代 11 第①批 同调实施批 T1（2026-10-03）——表扩列 {form ∈ {"", passive, active_charged}（空=切片过渡形态行）, charges_per_adventure, slot_cost（同调行恒 1 校验）, unlock_requires 谓词行〔空=首批全解锁合法态，底稿 §2.2 用户裁〕, effective_rounds（P4 甲表值化）, charge_n} + effect_kinds 扩 {venom_rider, flag_burst, mine_hit_halve, reflect_damage, ap_rounds_front, ap_charge_safe, cell_removal, reward_weight_bias, bonus_refresh}（mine_reveal/ap_grant 语义不变）+ 🔴 零裸 flat 结构护栏 = 行键白名单封闭（KEY_WHITELIST 外键=加载致命——机制轴禁无条件属性加项的结构承载）；七件同调行入表（venom_edge 淬毒刃纹/flag_burst 标中殉爆/nest_counter 惊巢反制/dawn_order 工兵晨令〔effective_rounds=3〕/dig_charge 掘进蓄能〔charges=2·charge_n=3〕/luck_coin 偏运硬币/pick_refresh 三选一刷新件〔X=1〕——值全 provisional）+ 取数口径三分（attunement_rows/transitional_rows/active_rows——同调行永不入过渡渠道）；nest_pendulum/blast_kit 维持过渡行 T7 原位换装，sapper_order/probe_dust/catacomb_scroll/loot_compass T7 逐件销账（底稿 §3）；维度词表收缩形态 = 开放拍板点（需求卡片 P1-P8 未覆盖，底稿 §1.1 明挂——T10 追认单随批，行标签 provisional） + attunement_refactor: 迭代 11 第①批 同调实施批 T1（2026-10-03）——表扩列 {form ∈ {"", passive, active_charged}（空=切片过渡形态行）, charges_per_adventure, slot_cost（同调行恒 1 校验）, unlock_requires 谓词行〔空=首批全解锁合法态，底稿 §2.2 用户裁〕, effective_rounds（P4 甲表值化）, charge_n} + effect_kinds 扩 {venom_rider, flag_burst, mine_hit_halve, reflect_damage, ap_rounds_front, ap_charge_safe, cell_removal, reward_weight_bias, bonus_refresh}（mine_reveal/ap_grant 语义不变）+ 🔴 零裸 flat 结构护栏 = 行键白名单封闭（KEY_WHITELIST 外键=加载致命——机制轴禁无条件属性加项的结构承载）；七件同调行入表（venom_edge 淬毒刃纹/flag_burst 标中殉爆/nest_counter 惊巢反制/dawn_order 工兵晨令〔effective_rounds=3〕/dig_charge 掘进蓄能〔charges=2·charge_n=3〕/luck_coin 偏运硬币/pick_refresh 三选一刷新件〔X=1〕——值全 provisional）+ 取数口径三分（attunement_rows/transitional_rows/active_rows——同调行永不入过渡渠道）；nest_pendulum/blast_kit 维持过渡行 T7 原位换装，sapper_order/probe_dust/catacomb_scroll/loot_compass T7 逐件注销（底稿 §3）；维度词表收缩形态 = 开放拍板点（需求卡片 P1-P8 未覆盖，底稿 §1.1 明挂——T10 追认单顺带，行标签 provisional） iteration22_refactor: 迭代 22 秘宝体系实现重构落地批（2026-10-12，T1-T3）——**新目录 12 行全量换代**（设计权威=秘宝.md「目录（重设计 v1）」：晨操令/阔视野带/试炼镐/刷新练习/储备罐/巢穴预告/线香/双管装填/远程镐/刷新执照/天眼/信标网络；旧 12 行删除——venom_edge/flag_burst 已随迭代 20 专长批迁出）+ 三档 tier ∈ {common,excellent,rare}（7/3/2，传说空集合法；TIER_RANK=装配档位校验取数源：件档 rank ≤ 装入位序）+ 解锁混合制行内单源（钥石购买 unlock_keystone_cost / 条件 unlock_requires 谓词——计数键 UNLOCK_COUNTER_KEYS 换代 {adventure_cleared〔C6 通关口径=打通整局〕, boss_kill_count, vision_used〔真视类工具累计使用——save v6 补零新域，受理成功计数、收束聚合入档〕}，购买价与谓词互斥 schema 强制）+ 充能重置周期 charge_reset ∈ {adventure,battle,level}（battle=编排器每战回满/level=每关首战回满，骑库存差额补注入；charges=0=积点制合法态〔试炼镐——use_attune_convert 积点受理口，零骑库存〕）+ 常时参数面 kind 六型（light_radius_bonus/rap_transfer_mult/dig_range_bonus/flag_range_free/refresh_stock_grant/shop_refresh_bonus——无订阅行，注入面按装配集 kind 分发）+ 主动分发 safe_dig（天眼=fx_reveal 通道复用全额兑付）与 mine_count_preview（巢穴预告，board_installed 事件 T3 扩签）+ target 扩 cell（线香单格）+ 替换子交互整体拆除（装配不可变契约 1——CURIO_KINDS 除名后不可达死通道：treasure_replace_presented 链/bonus_aux_carry 断点键/grant_treasure_item/替换呈现三态全清）· 工坊解锁渠道面退役（meta.tres workshop_items 行族与 MetaProgression 工坊三函数删除，秘宝匣柜台投影=treasure_shop_status） referenced_by: [战斗结算, 地图战斗资源, 地形变异, 行动经济, HUD框架, 数据配置, 教学引导, art-bible] @@ -585,7 +585,7 @@ entities: owner: design/gdd/systems/冒险循环/难度曲线与Boss.md attributes: kind: 调参目标带（F5）+ 承伤估算（F4）+ 供给平衡式（F6）——设计期工具式，运行时零新增公式（难度曲线与Boss 定位声明） - clear_rate_target: ⚠ 口径退役待重锚（2026-09-23 用户拍板单关直入口口径退役——逐关读数改冒险条件口径派生〔balance_verifier 冒险段〕，带值重锚归曲线调参批，重锚前只测不判；带史 = 2026-09-20 分带批 L1 [35,55]/L2 [25,45] 锚定直入口单关读数〔已随口径退役不可比〕，更早 L1 10-25/L2 20-40 系乱点画像口径亦作废；区间位移机制承载：atk 翻倍 ≈ K 减半 → 绿档；2026-09-18 起永久强化经换算率表按带平移接入，见 meta_progression_conversion_table；**2026-09-30 改带〔迭代 5 返工出口收口批，用户拍板〕：冒险条件口径普通档 L2 [25,45]→[10,15]——原带设定有误裁，返工终态读数 10.6/13.6% 落带、批点丙追认**；成文见难度曲线与Boss 判读口径节） + clear_rate_target: ⚠ 口径退役待重锚（2026-09-23 用户拍板单关直入口口径退役——逐关读数改冒险条件口径派生〔balance_verifier 冒险段〕，带值重锚归曲线调参批，重锚前只测不判；带史 = 2026-09-20 分带批 L1 [35,55]/L2 [25,45] 锚定直入口单关读数〔已随口径退役不可比〕，更早 L1 10-25/L2 20-40 系乱点画像口径亦作废；区间位移机制承载：atk 翻倍 ≈ K 减半 → 绿档；2026-09-18 起永久强化经换算率表按带平移接入，见 meta_progression_conversion_table；**2026-09-30 改带〔迭代 5 返工出口完成批，用户拍板〕：冒险条件口径普通档 L2 [25,45]→[10,15]——原带设定有误裁，返工终态读数 10.6/13.6% 落带、批点丙追认**；成文见难度曲线与Boss 判读口径节） supply_balance_band: "**关级供给带 [1.1,2.0] 退役（2026-09-14——其验算 0.54 与实测 60% 通关矛盾）**——由生存链区间模型替代：每战 S/K 区间三档判定（绿 S_min>K_max / 黄 E[S]≥E[K]+1 / 红 S_max≤K_min 禁止入表）+ 关级恒等式（atk×ΣR_survive + Σ奖励输出 ≈ Σ敌hp期望×(1+缓冲)，actuals 逐项审计闭合）+ 输出占比带 [15%,40%] + 通关余量带（p90≤13 & p10≥3——'通关只剩一点血'量化）" tool_carrier: balance_verifier.py 冒险段（逐关条件通关率/止步归因/营地循环——2026-09-23 起难度读数主载体）/ adventure_monte_carlo.gd / reward_expectation.gd（原 level_monte_carlo.gd 随单关直入口口径退役删除 2026-09-23；棋盘生成 F4 排期倒挂解除载体） calibration_gap: 真人修正系数待 playtest 标定（OQ3——**方向已由试玩批次 1 反向确认：真人显著强于模拟者**〔v2 真人 100% vs 模拟 80%〕；旧"真人预期低于模拟"方向声明由本条替代；带按模拟口径定义，真人系数批次 2 定量） @@ -622,11 +622,11 @@ entities: definition: 一次冒险之内通过各渠道给予玩家的增益总称——奖励节点给的、商店买的、打赢关底 Boss 给的，都是奇物。装的是"这一局你捞到了什么"，不管从哪个渠道来 channel_constraint_layers: 渠道约束分三层——一层 分类白名单（分类轴决定渠道）；二层 可计算谓词（渠道与奇物的结构性关系，如「计价物不自售」：X 是渠道 C 的计价物 → X 不进 C；新渠道/新奇物自动判定，不用改表）；三层 显式例外清单（人为设计选择，只能逐条加，每条须写理由）。要害不是有没有例外，而是例外能不能被算出来——结构性原因写成谓词，设计性原因进清单。在册约束两条：①金币不进商店（二层·谓词）②专长在非 Boss 渠道只给门票（一层·分类形态）。**注意**：属性值提升/资源不出现在 Boss 渠道**不是约束**——那是渠道轴的定位（Boss 是专长独占渠道），不属默认原则管辖。**「计价物不自售」形式上确是在白名单外加的一道过滤（用户质疑成立），与死特判的区别在于把枚举例外变成计算谓词** axes: 两根互不决定的轴——**分类轴**（给的是什么）与**渠道轴**（从哪来）。一个奇物属于哪个分类不决定它从哪个渠道来；交叉关系由 design/gdd/systems/冒险循环/奇物.md 第 2 节开关表定死 - categories: 封闭三类 {专长 Feat, 属性值提升 ASI, 资源}（v2.7 定名，**去「类」字后缀**——此前为描述式叫法「机制类 / 属性提升类 / 资源类」，非专名；用户 v1.1 原话即「属性提升（ASI）」与「专长」，v1.1 落文时被加后缀而退化。v2.0 起为三类、v1.1 曾用两类、v1.0 曾用 {rule, stat}，均已作废）。 + categories: 封闭三类 {专长 Feat, 属性值提升 ASI, 资源}（v2.7 定名，**去「类」字后缀**——此前为描述式叫法「机制类 / 属性提升类 / 资源类」，非专名；用户 v1.1 原话即「属性提升（ASI）」与「专长」，v1.1 写入文档时被加后缀而退化。v2.0 起为三类、v1.1 曾用两类、v1.0 曾用 {rule, stat}，均已作废）。 hierarchy: 玩家可见的三层（用户 2026-10-05 拍板）——一层总称「奇物」／二层三个分类／三层具体单件（如 奥术余烬、贯穿射击）。**命名与呈现是两件事**：分类各有一个正式专名，文档、代码词族、帮百科/成就名/效果描述的指代一律用它；但卡面与详情页只写单件名与效果、不附带分类（呈现面归 battle.md / node-reward.md 裁决，本条目不预断）专长（Feat）——在结算管线某个挂点上给自己加一条规则，同标签持有项数达阈值时质变，事实源 feats.tres；属性值提升（ASI）——抬高生命上限 / AC / 攻击三轴基础值，进冒险加算区，事实源 adventure.tres；资源——给"可用的量"，不抬高战斗属性也不改规则：行动点上限 / 刷新次数 / 金币 / 回复，不进加算区、多数不进持有集，事实源 adventure.tres scope: 作用对象 = 角色本人与其参与的结算（不改敌人、不改棋盘生成、不改关卡内容）；**例外**——刷新次数作用在三选一界面而非角色身上，不进加算区；时间范围 = 整局冒险，专长与属性值提升跨关携带、关间不清零，金币与回复即时兑付；归属范围 = 不进账号永久进度，不带到下一次冒险 lifecycle: 候选池构建（冒险开局一次）→ 在渠道上出现（三选一形式）→ 选定（自池中剔除不再复现；选到「专长获取」时立刻再开一次专长 N 选一）→ 持有生效或即时兑付 → 冒险以任一结局收束时整集清零；断点记录持有集与剩余候选池 - acquisition: 三条渠道的**目标分工（交叉开关，v2.2 收口）**——专长：主渠道＝**关底 Boss 击败＝通过这一关**（**唯一直接给的渠道**；不新增节点类型、挂 Boss 节点兑付面；末关的 Boss 击败后不给——无后续关卡可消费）。**兑付频率**：奇物不是打一场战斗给一份，关内普通战斗节点不给任何奇物，一关之内只兑付一次（奖励节点与商店同理，各节点各自兑付），奖励节点与商店**只给「专长获取」门票**——**拿到即开、不可囤积**，不进持有集（选中/买下同一时刻开专长三选一；可囤积会让玩家无限推迟关键决策，且把持有物语义从后门放回）。门票归专长（给的是一件以前不会的事，只是把选择推迟）。罕见**只在概率不在价格**，一局限购一次，**计步保底**：连续 5 次三选一展示未出现→第 6 次必出（计数＝展示次数、刷新重展计入、奖励节点与商店共享、触发清零、限购用满后不再触发）；属性值提升：奖励节点 + 商店（口径「训练」）；资源：奖励节点 + 商店（**金币除外、回复在内**）；后两类均不出现在 Boss 渠道。形状＝「一块独占 + 两块并行」，专长靠打赢、其余靠抽取与购买。**默认原则**：除已登记的特殊规则外，分类内的东西都要在它该出现的渠道池子里——任何不出现都须登记理由**现行实现三渠道共用同一候选池、三类混编**，分工尚未实施，登记于 06-待办清单 BD 分层条目 + acquisition: 三条渠道的**目标分工（交叉开关，v2.2 完成）**——专长：主渠道＝**关底 Boss 击败＝通过这一关**（**唯一直接给的渠道**；不新增节点类型、挂 Boss 节点兑付面；末关的 Boss 击败后不给——无后续关卡可消费）。**兑付频率**：奇物不是打一场战斗给一份，关内普通战斗节点不给任何奇物，一关之内只兑付一次（奖励节点与商店同理，各节点各自兑付），奖励节点与商店**只给「专长获取」门票**——**拿到即开、不可囤积**，不进持有集（选中/买下同一时刻开专长三选一；可囤积会让玩家无限推迟关键决策，且把持有物语义从后门放回）。门票归专长（给的是一件以前不会的事，只是把选择推迟）。罕见**只在概率不在价格**，一局限购一次，**计步保底**：连续 5 次三选一展示未出现→第 6 次必出（计数＝展示次数、刷新重展计入、奖励节点与商店共享、触发清零、限购用满后不再触发）；属性值提升：奖励节点 + 商店（口径「训练」）；资源：奖励节点 + 商店（**金币除外、回复在内**）；后两类均不出现在 Boss 渠道。形状＝「一块独占 + 两块并行」，专长靠打赢、其余靠抽取与购买。**默认原则**：除已登记的特殊规则外，分类内的东西都要在它该出现的渠道池子里——任何不出现都须登记理由**现行实现三渠道共用同一候选池、三类混编**，分工尚未实施，登记于 06-待办清单 BD 分层条目 boundary: 判据走生命周期——**一次冒险内获得、冒险收束即清零的是奇物；跨冒险跟着你走的是秘宝**。奇物永不进同调位，秘宝永不进当局随机渠道；与元进度天赋树两层互不代位 data_sources: feats.tres（专长定义行——效果声明=triggers 订阅行〔订阅哪个事件 on / 什么条件 when / 什么效果 do〕，旧挂点+效果字典形态 2026-10-06 内容数据驱动扩展批退役）/ adventure.tres（属性值提升与资源的种类配额与值）/ shop.tres（货架取舍） effect_declaration: **效果行为=事件订阅（2026-10-06 内容数据驱动扩展批换代）**——事件/效果类型/条件事实/算子四词表封闭于效果引擎 `game/core/effect_engine.gd`（事件 16 发射点 / 效果类型 24 / 条件事实 9 / 算子封闭；四词表出域=加载期校验致命）；组合规则六族（加法/乘法/任意真/按序改写/按序消耗/即时执行）为效果类型必填属性；遍历序=数据表声明序写死保种子复放；订阅重建=每战开始从持有集/装备集重建（中途获得下一战生效） @@ -650,12 +650,12 @@ entities: curio_value_attack_common / curio_value_max_hp_common / curio_value_armor_common: int [0,999]（三选一属性值提升奇物兑付值——加算区攻击/生命上限/护甲轴累加，经覆盖值通道；值锚与上调约束归 难度曲线与Boss） curio_value_gp_common: int [0,999]（GP 袋件定额入钱包）；curio_value_ap_rarest: int [0,10]（AP 件每场战斗首轮行动点基线增量）；bonus_aux_item_count: int [1,9]（秘宝件授予件数） ~~bonus_weight_*（E-S 加权洗牌权重族）~~ / ~~bonus_cap_*（种类次数上限族）~~：**v2.2 令牌池换代退役（迭代 12 TP0——2026-10-03 追认 b 实施批；洗牌改令牌 Fisher-Yates、池消耗即上限）** - curio_quota_{kind}_{tier}: int [0,99]（**TP0 令牌配额族**——kind×tier 计数：attack 18/5 · max_hp 17/5 · armor 17/5 · gp 18/5 · heal 0/5 · ap 0/0/3〔common/rare/rarest〕；未列组合=0；档位结构锚 70/25/3=98 张入 schema validate 硬断言〔罕见档原列「道具件 2」随 aux_item 池种退役收窄——台账自决披露项〕） - curio_value_attack_rare / curio_value_max_hp_rare / curio_value_armor_rare / curio_value_gp_rare: int [0,999]（稀有档大数值对——+2/+10/+2/50）；curio_value_heal_rare: int [0,999]（恢复件 +6 当即回血——新入池种类 rare 档）；MC 策略 316-f（autoplay 1 级最稀有/2 级最左）随批落地 + curio_quota_{kind}_{tier}: int [0,99]（**TP0 令牌配额族**——kind×tier 计数：attack 18/5 · max_hp 17/5 · armor 17/5 · gp 18/5 · heal 0/5 · ap 0/0/3〔common/rare/rarest〕；未列组合=0；档位结构锚 70/25/3=98 张入 schema validate 硬断言〔罕见档原列「道具件 2」随 aux_item 池种退役收窄——状态记录自决披露项〕） + curio_value_attack_rare / curio_value_max_hp_rare / curio_value_armor_rare / curio_value_gp_rare: int [0,999]（稀有档大数值对——+2/+10/+2/50）；curio_value_heal_rare: int [0,999]（恢复件 +6 当即回血——新入池种类 rare 档）；MC 策略 316-f（autoplay 1 级最稀有/2 级最左）顺带落地 **迭代 20 换代（2026-10-11 专长实装批 T2/T4）**：TIERS 四级 common/excellent/rare/legendary（档名映射承袭——旧 rare→excellent、旧 rarest→rare，物理字段改名）；TIER_QUOTAS 70/25/9/0=104（T2 直映射 98+T4 凭证投放 6——rap 2/attune_battery 1/time_sand 2/perfect_insurance 1，provisional 归调参批）；CURIO_KINDS 7→11；curio_cap_* 每成员已拿上限字段（案②概率上限解耦——99=无上限占位）；boss_feat_weight Boss 三选一按档配比权重（100/45/15/5 provisional）；新旧字段映射注释随 schema 头注 transitional_sync_slots: int [0,9]（同调位过渡读数源，默认 1——道具持有上限；正主 = attunement_growth.tres 里程碑谓词表，同调实施批落地后切换读数源） mvp_content: 单行全局默认值即 MVP 行（provisional 归 曲线调参批——迭代 10 扩列批注） - extension_reserve: 大奖励形态扩列位已消费（迭代 10 奖励重构批落地三选一/攻击型——本键使命完成退役；冒险结构 OQ2 收口） + extension_reserve: 大奖励形态扩列位已消费（迭代 10 奖励重构批落地三选一/攻击型——本键使命完成退役；冒险结构 OQ2 完成） referenced_by: [冒险结构, 元进度, 行动经济, 数据配置] - name: shop_table @@ -664,7 +664,7 @@ entities: attributes: table: ShopTable（数据配置 承载；**2026-09-20 GP+商店房批新建，2026-10-03 迭代 11 第②批扩列**——商店房商品与 GP 经济的行集；冒险结构 回填 owner，公式语义归其 GP 冒险账本节（共享池账本段 v0.13），数值所有权归 难度曲线与Boss 曲线调参批） fields: gp_drops 三行（键 = 战斗节点身份 {normal, elite, boss}——普通 均值 3 区间 [2,4] / 精英 均值 5 区间 [4,6] 预留行 / Boss 均值 8 区间 [6,10]，掷定 + 均值方差口径）· level_gp_bonus（逐关——L1 0 / L2 1 / L3 2）· **pool_shelf 四行（迭代 11 第②批 T1——kind_id 词表封闭 {attack, max_hp, armor, ap}=四切边后种〔GP 袋负交易切边/机制件三轴切边〕：attack 基价 4 / max_hp 4 / armor 4 / ap 5 provisional；库存=上限即库存，账本在 AdventureRunner._bonus_taken 单点共享，行族不记库存）· price_a=1.8 / price_b=1.1（乘法价格因子 provisional，后置追认）** · products 三行（atk_up +1 首价 4 / hp_up +3 首价 2 / armor_up +1 首价 4，步长均 2——legacy 对照模式承载，退役归 off 锚换代批）· price_level_bonus（逐关——L1 0 / L2 2 / L3 4，legacy 同上） - formulas: 每战 GP 掉落 = 掷定 + 关级掉落加值 + 战斗内缓冲（战斗完成随 battle_finished.gp_dropped 统一入钱包——冒险结构 GP 冒险账本三收口）；**货架现价（pool 现行）= ceil(基价 × b^(关序−1) × A^(本次进店已购次数))**；商品价格（legacy 对照）= 基价 + 关级价格加成 + 步长 × 已购档数；定价锚 = 「正常运气可购档数 / 运气极好可购档数」两读数的数学期望（期望账进表批注） + formulas: 每战 GP 掉落 = 掷定 + 关级掉落加值 + 战斗内缓冲（战斗完成随 battle_finished.gp_dropped 统一入钱包——冒险结构 GP 冒险账本三完成）；**货架现价（pool 现行）= ceil(基价 × b^(关序−1) × A^(本次进店已购次数))**；商品价格（legacy 对照）= 基价 + 关级价格加成 + 步长 × 已购档数；定价锚 = 「正常运气可购档数 / 运气极好可购档数」两读数的数学期望（期望账进表批注） value_status: 全部行值 provisional-pending-曲线调参批（用户 2026-09-20 拍板「骨架先行、数值整体后置」；A/b 投值 1.8/1.1 系迭代 11 第②批零人工令改 provisional+后置追认）——shop=off/on 分层 MC（off=legacy 对照 off_n60 逐位 / on=共享池首锚 N=60 双策略）、shop=on 带平移、换算率登记全部随曲线调参批执行（难度曲线与Boss v0.22 商店与 GP 经济杠杆节） rule4_status: 进度成长表（数值随关卡与商品档变化，无 Rule 4 豁免） referenced_by: [冒险结构, 关卡节点地图, 难度曲线与Boss, 战斗结算, 数据配置] @@ -675,14 +675,14 @@ entities: attributes: kind: 呈现只读面战斗结束信号（战斗结算 呈现只读面表登记的对外契约——销毁前捕获，字段增删走战斗结算 GDD 修订） payload: 胜负结果 · 主角余量生命 · gp_dropped（本战 GP 掉落合计 = 掉落掷定 + 关级加值 + 战斗内缓冲——**2026-09-20 GP+商店房批新增**；钱包入账归 冒险结构 GP 冒险账本，战斗域零钱包状态） - consumers: 呈现层（核心对象销毁后读状态的时序防护）/ 行进器钱包入账（战斗完成收口——关卡节点地图）/ 试玩日志 battle_end 行（gp_dropped 列，验收取数面） + consumers: 呈现层（核心对象销毁后读状态的时序防护）/ 行进器钱包入账（战斗完成完成——关卡节点地图）/ 试玩日志 battle_end 行（gp_dropped 列，验收取数面） referenced_by: [冒险结构, 关卡节点地图, HUD框架] - name: hero_override_parameter_passing type: convention owner: design/gdd/systems/战斗循环/战斗结算.md attributes: - kind: 主角战斗入参覆盖值通道（begin_battle 显式参数传递——切片 E4 封装收口批实现，registry 登记缺口由 冒险结构 定稿批补登） + kind: 主角战斗入参覆盖值通道（begin_battle 显式参数传递——切片 E4 封装完成批实现，registry 登记缺口由 冒险结构 定稿批补登） contract: begin_battle 增 hero_hp / hero_atk / hero_max_hp 显式入参 → 敌人系统.spawn 增 atk_override / max_hp_override 参数；-1 = 表值兜底（不覆盖）；hero 表运行期不可变（数据配置 单一事实源机制化——表写通道全删） consumers: HP 账本（冒险结构——跨战斗 HP 持久性 + 大奖励上限提升的传入面）/ 元进度加成（元进度实现批 2026-09-21 接通——MetaProgression.hero_override() 现算 flat 三档，AdventureRunner.start_adventure params.hero_override 显式传入 → LevelRunner base_override 共享；叠加序 = 表值 + 永久强化 flat + 加算区 flat × TunePanel pct）/ 切片 TunePanel（调试通道） status: 候选——正式侧 战斗结算/敌人系统 GDD 修订随正式化批；冒险结构 GDD 规则 3/4 为 冒险结构 半边（HP 账本供值）的正式定义源 @@ -692,11 +692,11 @@ entities: type: schema_data owner: design/gdd/systems/跨局循环/元进度.md attributes: - table: 永久强化换算率表（数据配置 承载；键结构 元进度定稿批 2026-09-18 登记，数值行读 `data/tables/meta.tres` conversion 行族。**已标定投值**：三行 生命 6 / 攻击 9 / 护甲 1 点每级——换算率标定批 2026-09-23，OFAT 冒险注入档与白板同种子配对的逐关条件通关率差实测（每级带平移 +6.0±0.7 / +8.8±0.8 / +1.2±0.4 点取整；冒险条件口径 + 当日 L2 收紧/大奖励 10→5 后现行数值包——直入口口径同日退役使首轮直入口面读数作废），护甲行强条目重测随批履行并暴露修复护甲断链（begin_battle hero_armor_class 参数零消费→_defender_ac 接线）；判定端 balance_verifier.py 表值驱动消费（带重锚后随平移判）；读数报告 production/qa/conversion-calibration/calibration.raw.md） + table: 永久强化换算率表（数据配置 承载；键结构 元进度定稿批 2026-09-18 登记，数值行读 `data/tables/meta.tres` conversion 行族。**已标定投值**：三行 生命 6 / 攻击 9 / 护甲 1 点每级——换算率标定批 2026-09-23，OFAT 冒险注入档与白板同种子配对的逐关条件通关率差实测（每级带平移 +6.0±0.7 / +8.8±0.8 / +1.2±0.4 点取整；冒险条件口径 + 当日 L2 收紧/大奖励 10→5 后现行数值包——直入口口径同日退役使首轮直入口面读数作废），护甲行强条目重测顺带履行并暴露修复护甲断链（begin_battle hero_armor_class 参数零消费→_defender_ac 接线）；判定端 balance_verifier.py 表值驱动消费（带重锚后随平移判）；读数报告 production/qa/conversion-calibration/calibration.raw.md） kind: 区间平移换算率（2026-09-18 用户拍板启用）——永久强化对难度的影响不直接改难度判据，按统一换算率折算为通关率带平移量后套用（完美档 gate 与 normal 目标带判读口径不变，带随解锁等级平移） key: (conversion_row_id)——一行一柜台商品类型 first_version_rows: 首版登记三个属性维度（表内即三行条目；用户拍板 2026-09-18，"维度"为拍板用语、"行"为表内同义术语）：生命上限强化 / 基础攻击强化 / 护甲等级强化——后续商品上架（秘宝匣钥石价、奖励格图鉴）逐条补登记，每次上架伴随一行换算登记（逐行归因纪律） - strong_row_discipline: 护甲等级行为**强条目**——护甲等级牵动命中判定全链（AC 换装 / 掷点带宽），验收读数必须按解锁后参数重测、不得沿用基线读数外推 + strong_row_discipline: 护甲等级行为**强条目**——护甲等级牵动命中判定全链（AC 换装 / 掷点带宽），验收读数必须按解锁后参数重测、禁止沿用基线读数外推 value_semantics: 每行折算值 = 每级强化对应的通关率带平移量（pp）；营地定价从对应行换算率推（几何递增曲线，起步价与公比随设计批） related_save_domains: 钥石余额 / 永久强化等级表 / 关卡通关次数表 / Boss 首杀标记位（域级契约登记方式随 存档序列化「存档契约条目的登记方式」联合裁决） referenced_by: [元进度, 难度曲线与Boss, 数据配置, 存档序列化, 地图战斗资源] @@ -757,7 +757,7 @@ entities: # 2026-09-14 辅助道具 定稿回填（owner=辅助道具，solo 模式一次会话定稿、出稿待人工复核）： # 新增 aux_items 条目（AuxItemTable 七字段 + MVP 六行【四常规单维 + 两稀有多维，值 provisional 归 难度曲线与Boss】+ # 真视窄域护栏承重规则 + 叠加层三集语义 + 8 API 面 + use_orchestration 规范序 + F1–F3 + 21 项跨 GDD 义务清单 -# + 地形变异 EC6/OQ2 与 奖励道具经济 OQ2 收口）；variation_table.mvp_content.counter_item_ids 回填 [probe_dust]（地形变异 预授权 +# + 地形变异 EC6/OQ2 与 奖励道具经济 OQ2 完成）；variation_table.mvp_content.counter_item_ids 回填 [probe_dust]（地形变异 预授权 # "辅助道具 期回填"兑现——数据配置 表值与悬空校验激活随 数据配置/辅助道具 修订批同批落地）+ dangling_ref_policy 首引兑现改写； # terminology 增四词条（叠加层/真视窄域护栏/渗透率 + referenced_by 增 辅助道具）。 # 生效前提：奖励道具经济×①…⑤（category 扩值 aux_item/use_timing 扩 during_dig/默认根六行等）与 数据配置×①② 修订批—— @@ -806,7 +806,7 @@ entities: # 字段对（同型两行；正向行参与摇号 = 类型频次，负向行纯字典）、pool_tag {safe_cell, active_inject} → {cell}、mvp_content 十行（含负向直伤 heal flat p4、ambush+2 # stacks=2、sapped 行）；direction_precheck 旧刀供给预检失义退役；settlement_obligations 六→四、hud_obligations 五→三、high_glow H3 失义下线。 # reward_config 整条删除（RewardConfigTable 随可选类删除下线，切片 reward_config.tres 随代码批删除）。 -# 2026-09-17 数值压缩批（用户拍板——绝对值轴 ÷3，按比例缩放保持比例关系）：reward.tres flat 行 power = 4 → 1（spark_aoe、heal_backlash）；heal_minor 区间 [2,6] → [1,1] 定值（区间掷点失义）+ 权重 15 → 3（频率 ÷4）；clear_blast 区间 [25,55] → [8,18] 中点 13（区间掷点保留、期望不漂移）；type 频次合计 79 → 67（heal 权重 ÷4）；status_effects.tres ambush magnitude +3 → +1 flat（量纲未变）；enemy.tres 全 12 行 hp/atk ÷3（24/7 → 8/2、Boss 150/9 → 50/3、drider 175/8 → 58/3）。**文档同步（同步批 v0.7 配对——同批登记 doc-conventions.md §5 数值纪律·强制收口条款）**：reward_table / status_effect / enemy_table 三条目 mvp_content 数值列改指路存根，GDD 表格同步；现行值读 data/tables/，详见对应 .tres 文件注释（注释段登记"压缩前→压缩后"轨迹）。 +# 2026-09-17 数值压缩批（用户拍板——绝对值轴 ÷3，按比例缩放保持比例关系）：reward.tres flat 行 power = 4 → 1（spark_aoe、heal_backlash）；heal_minor 区间 [2,6] → [1,1] 定值（区间掷点失义）+ 权重 15 → 3（频率 ÷4）；clear_blast 区间 [25,55] → [8,18] 中点 13（区间掷点保留、期望不漂移）；type 频次合计 79 → 67（heal 权重 ÷4）；status_effects.tres ambush magnitude +3 → +1 flat（量纲未变）；enemy.tres 全 12 行 hp/atk ÷3（24/7 → 8/2、Boss 150/9 → 50/3、drider 175/8 → 58/3）。**文档同步（同步批 v0.7 配对——同批登记 doc-conventions.md §5 数值纪律·强制完成条款）**：reward_table / status_effect / enemy_table 三条目 mvp_content 数值列改指路存根，GDD 表格同步；现行值读 data/tables/，详见对应 .tres 文件注释（注释段登记"压缩前→压缩后"轨迹）。 # settlement_table：segment_order 七段→五段 [grant, buff_debuff, combat, decay, verdict]（item_window/item 下线）、 # source_label_map 删"道具"扩展键、effect_pool_map 收编 sapped→hero_offense、mechanics 行型封闭 15→10 类 + 两层豁免集合修订。 # status_effect：mvp_content 六行→七行（新增 sapped——weaken 型负向）、enrage/off_guard 兑付语义注记改为类型化负向。 @@ -816,14 +816,14 @@ entities: # 增益状态（正文行表对齐七行）、行动经济（条款②③⑤锚对象按类型化负向重议）、难度曲线与Boss（F4/F5/对账重推）、数据配置（RewardTable schema 重写）、 # 00-游戏概念/01-核心循环/03-内容规模/05-不做清单（旧固定兑付措辞）、UX 文档。历史留痕保留各批原文，现行口径以上方条目为准。 # -# 2026-09-15 验收/收口批（owner=战斗结算，代用户修订；零数值零机制改动；**不改 v0.7 文件**）——v0.5/v0.6 两批（命名统一 + 抽象分离） -# 验收核对全绿后收口。范围纪律：战斗结算.md / 奖励道具经济.md 属 v0.7 格面资源批所有者文件、口径仍在移动，本批一律不动； -# ③ 收口项登记于此（registry）+ README + active.md，GDD 侧只报告、待 v0.7 批整体收口后回填： +# 2026-09-15 验收/完成批（owner=战斗结算，代用户修订；零数值零机制改动；**不改 v0.7 文件**）——v0.5/v0.6 两批（命名统一 + 抽象分离） +# 验收核对全绿后完成。范围纪律：战斗结算.md / 奖励道具经济.md 属 v0.7 格面资源批所有者文件、口径仍在移动，本批一律不动； +# ③ 完成项登记于此（registry）+ README + active.md，GDD 侧只报告、待 v0.7 批整体完成后回填： # ① 收益对照表充能当量覆盖缺口：现行 flat/percent/完美乘数三式未覆盖「充能类」；候选口径 = 充能当量 = # Σ各桶点数 × 当轮目标护甲平均甲效倍率 ÷ 100（与直伤同类 1 伤害 = 1 当量，守 行动经济 条款①单一当量）——补式 / 登记待拍板二选一待回填批裁定。 # ② 两处已知落差：a) charge_grants 触发源可扩展 vs 切片仅 safe_cell/flag_hit 两处计数埋点（新增源须加埋点）； # b) safe_cell/flag_hit 来源标识跨命名空间同名（结算明细行 source_class / charge_grants 键；RewardTable.pool_tag 已随格面资源批改 cell）。 -# 2026-09-19 充能退役批：settlement_table.charge_grants 字段删除（主角攻击回归单分量——克制策略归冒险前配置）；上方 ①「充能当量覆盖缺口」与 ②a「触发源扩展 vs 计数埋点」两条充能相关注记随批废止；DamageMath.charge_component 改名 counter_component（奖励直伤唯一消费方）。 +# 2026-09-19 充能退役批：settlement_table.charge_grants 字段删除（主角攻击回归单分量——克制策略归冒险前配置）；上方 ①「充能当量覆盖缺口」与 ②a「触发源扩展 vs 计数埋点」两条充能相关注记顺带废止；DamageMath.charge_component 改名 counter_component（奖励直伤唯一消费方）。 # 验收读数：冒烟 201 项 0 失败 · 四探针 exit=0 无 FAIL（切片侧仍为 pre-v0.7 实现，代码同步随格面资源批新会话执行）。 # # 2026-09-15 护甲等级批（用户拍板登记，只改 GDD 与 registry、不动代码；owner=战斗结算 v0.8 / 敌人系统 v0.3 / 难度曲线与Boss v0.4 / registry 侧 3 条）： @@ -832,7 +832,7 @@ entities: # settlement_table.mechanics 随机口径修订——结算换算层首次引入回合内随机（护甲等级掷点），可回放契约从"结算路径零随机" # 修订为"封闭随机流可回放"（同种子同输入逐位复现）；掷点流归属未定（新增封闭流 vs 复用 encounter）登记 战斗结算「待拍板」， # rng_service 条目本批不动（流清单变更须改代码 + P1 支柱评审，随定稿批执行）。 -# 护甲等级（数值轴 armor_class）与护甲类型（克制属性轴 armor_type light/ward/heavy）命名区分成文——文档、表字段与代码键不得混用。 +# 护甲等级（数值轴 armor_class）与护甲类型（克制属性轴 armor_type light/ward/heavy）命名区分成文——文档、表字段与代码键禁止混用。 # EV 中性引入：期望伤害对齐现行表值，现行数值不重调；难度曲线与Boss 生存链区间补记掷点带宽口径（定稿前扫描维持全额口径），"零红档"验收保留。 # 拍板口径：必中、非归零（低掷按减伤档位折扣，无 miss 无零收益白回合）；只对基础攻击掷（主角普通分量 / 敌方攻击拍与重击拍基线）； # 棋盘来源一律无视护甲等级——与"奖励/惩罚必中"同构。 @@ -889,11 +889,11 @@ entities: # 内容承载）；同场多敌种行集多行 → 敌人表行集多行批（战斗侧，排技能池实施批后， # 06 清单单点登记）；board_gen_table 第三轴约定 OQ6 重审兑现注记；difficulty_table OQ5/OQ6 兑现注记； # ⑤ 06-待办清单：「精英与 Boss 编码位」「多敌数量的消费面」（地图战斗资源节「功能道具的正式渠道」同日） -# 三条已解决留痕；敌人系统「同深度第二敌种与精英 / Boss 编码位」部分收口改归属；新增「切片行进代码与 +# 三条已解决留痕；敌人系统「同深度第二敌种与精英 / Boss 编码位」部分完成改归属；新增「切片行进代码与 # 定稿的接口漂移」（八条漂移清单）与「图版措辞对齐」（跨文档残留单点清单）两待办。 # 2026-09-17 代币→钥石统一拍板（用户裁决，06 清单「代币与钥石的资源关系」关闭）：冒险结构关卡大奖励 # 「代币记账 +10/关」即钥石入账——同一资源、两渠道（关卡大奖励 +10/关 provisional 与关底 Boss 掉落）； -# 「代币」措辞全仓退役（冒险结构 v0.3 / 元进度 v0.2 / 数据配置 v0.3 / architecture.md 随批清偿）； +# 「代币」措辞全仓退役（冒险结构 v0.3 / 元进度 v0.2 / 数据配置 v0.3 / architecture.md 顺带清偿）； # adventure_table 字段键改 keystone_per_level（原 token_per_level，AdventureTable 未建表零代码影响）； # 钥石产出细则与解锁定价仍归元进度定稿批（关联待办「钥石的重复获取」继续）。 # 2026-09-17 分支节点图批（L2 幽暗地域内容批——关卡节点地图 v1.0 P1 实现批，用户拍板；与切片代码 / @@ -911,14 +911,14 @@ entities: # provisional 锚、专属池 普攻 6/重击 2/毒爆 2）× 编号 8。跨表精确行校验随 ConfigDB 既有通道强制。 # ④ board_gen_table L2 七行（12×12 d0.25 t0.88——与 L1 高档同值，差异化留给调参批）。 # ⑤ L2 首遇位绿档冒烟断言落地（基线 0 加成完美档 12 种子首遇战全胜且零踩雷）；L2 整关通关率读数 -# 随批实测记录于切片汇报（基线裸值 0% / hp+100 档 35–80%，N=20——精调归加难杠杆扫描批）。 -# 2026-09-18 元进度定稿批（用户拍板六件收口；与 元进度 v1.0 / 06-待办清单 / 难度曲线与Boss v0.10 同批）： +# 顺带实测记录于切片汇报（基线裸值 0% / hp+100 档 35–80%，N=20——精调归加难杠杆扫描批）。 +# 2026-09-18 元进度定稿批（用户拍板六件完成；与 元进度 v1.0 / 06-待办清单 / 难度曲线与Boss v0.10 同批）： # ① terminology 增「永久强化」词条（系统族名元进度保留；营地=界面壳；「天赋树」退役——无树形结构， # 柜台条目线性清单）；② 新增 meta_progression_conversion_table 条目（区间平移换算率启用，首版三行 # 生命/攻击/护甲——护甲行强条目；数值行零登记读 data/tables）；③ difficulty_expectation_table # clear_rate_target L1 带改 10-25%（2026-09-17 拍板补登 registry——旧 30-50% 作废，旧扫描读数 60% 失效）； -# ④ 06 清单收口：元进度六条（换算率启用形态/三方向清单定价/钥石重复获取/天赋树去留/注入口径/界面交互 -# 全部已裁决或部分收口）+ 数据配置「元进度表键结构未定」已解决 + 难度曲线「基线通关率越带」现状校正； +# ④ 06 清单完成：元进度六条（换算率启用形态/三方向清单定价/钥石重复获取/天赋树去留/注入口径/界面交互 +# 全部已裁决或部分完成）+ 数据配置「元进度表键结构未定」已解决 + 难度曲线「基线通关率越带」现状校正； # 剩余面 = 三柜台铺量与定价数字、Boss 两档产出数值、换算率三行折算数值（归元进度设计批配读数）。 # 2026-09-18 战斗数值结构修复批（2026-09-18 战斗数值盘问会话用户拍板；与 战斗结算 v0.14 / 增益状态 v0.9 / # 地图战斗资源 v0.11 / 06-待办清单 / 切片代码同批；数值全部临时值 provisional 归 状态层重设计批）： @@ -927,7 +927,7 @@ entities: # 旧正值实际 ×2 翻倍系符号 bug）；weaken 叠层改续时（stack→refresh · duration 1→2——同名重复授予 # 只刷新剩余结算数、层数恒 1，结构性消饱和）； # ② settlement_table.effect_pool_map 删 off_guard → hero_defense 键（hero_defense 池清空、结构保留）； -# ③ 顺手收口 fields 漏登（2026-09-16 换装批遗留）：unit 枚举补 ac 量纲； +# ③ 顺手完成 fields 漏登（2026-09-16 换装批遗留）：unit 枚举补 ac 量纲； # ④ 切片代码同批：battle_orchestrator.gd 主角攻击段 hero_offense 池接线（pool_damage 首参 0 → # _clamped_pool("hero_offense")）+ attack_up 普通分量直乘旁路退役（增伤/乏力覆盖面 = 三份分量合计）； # 冒烟护栏三组新断言（削弱续时 / 乘区接线 ×1.5·×0.75 / 硬化折半方向），旧"削弱×2 池触底"采样通道退役。 @@ -938,7 +938,7 @@ entities: # 改五档（克制/弱克制/中性/弱被克/被克），键集 3×3 满格结构冻结不动； # ② enemy.armor_type 与 hero.armor_type 两行注记同步（矩阵档值注记改五档读表；hero 轴休眠归因改述为 # 结构性——敌方攻击不查矩阵，与数值无关）； -# ③ 冒烟随批改形：矩阵三行断言改五档读数 + 乘区接线穿刺分量 3→2（3 点 ×80% 取整）——冒烟 300 项 0 失败 +# ③ 冒烟顺带改形：矩阵三行断言改五档读数 + 乘区接线穿刺分量 3→2（3 点 ×80% 取整）——冒烟 300 项 0 失败 # + 四探针 PASS；击杀区间复算义务随档值变更触发（难度曲线与Boss 联动表义务面扩写），L2 Boss 战 # 新读数：基础攻击/穿刺弹 ×120、魔法矢 ×50 不变；重甲档现行无消费敌种（零消费格）。 # 2026-09-18 数值语言拍板批 + 甲效矩阵加法核换装（用户拍板——与 01-核心循环 数值语言条款 / 元进度 / 难度曲线与Boss / 06-待办清单 / 切片代码同批）： @@ -971,10 +971,10 @@ entities: # 「连续 30 种子×头部 scope 窗口×40 局复用」把裸派生种子的面值彩票放大 40 倍进聚合统计（18 点 +57%）， # 混淆使任何窄种子窗表现如随机抽样（改版后同窗 χ²=13.9 达标）；黄金向量 8 常量全量重登记（Python 参考 # 实现逐位交叉验证）、R2 旧向量作废；逐 scope 复放语义/计数器契约/存档快照契约不变；冒烟 316 项 0 失败 -# （含 1 条条件断言因新序列不再触发，317→316 良性）；同种子历史坐标随批作废（重测义务=验收批阶段一重跑）。 +# （含 1 条条件断言因新序列不再触发，317→316 良性）；同种子历史坐标顺带作废（重测义务=验收批阶段一重跑）。 # 2026-09-23 换算率标定批（用户指令「现在标定」；与 meta.tres conversion 投值 / 元进度 v1.4 / # 06-待办清单删条 / 判定端 balance_verifier.py ④ 段 / 切片代码同批）： -# ① meta_progression_conversion_table 投值收口：三行 生命 6 / 攻击 9 / 护甲 1 点每级 +# ① meta_progression_conversion_table 投值完成：三行 生命 6 / 攻击 9 / 护甲 1 点每级 # （OFAT 冒险注入档×双画像×na=100 与白板同种子流配对，逐关条件通关率差实测每级带平移 # +6.0±0.7 / +8.8±0.8 / +1.2±0.4 点配对 bootstrap 合并取整；读数报告 # production/qa/conversion-calibration/calibration.raw.md。测量面两换：首轮直入口面读数