From b4671802aa15653fab4e418e6add388d84d3df98 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 18 Oct 2026 04:56:18 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(06):=20=E5=BE=85=E5=8A=9E=E6=B8=85?= =?UTF-8?q?=E5=8D=95=E5=AD=98=E9=87=8F=E6=9D=A1=E7=9B=AE=E5=85=A8=E9=87=8F?= =?UTF-8?q?=E5=9B=9E=E5=A1=AB=20=C2=A712.1=20=E6=96=B0=E6=A0=BC=E5=BC=8F?= =?UTF-8?q?=E2=80=94=E2=80=9473=20=E6=9D=A1=E9=80=90=E4=B8=80=E5=A4=84?= =?UTF-8?q?=E7=BD=AE=EF=BC=9A=E6=94=B9=E5=86=99=2051=20=E6=9D=A1=EF=BC=88?= =?UTF-8?q?=E6=A0=87=E9=A2=98=3D=E7=99=BB=E8=AE=B0=E6=97=A5=E6=9C=9F?= =?UTF-8?q?=EF=BC=8B=E6=9D=A5=E6=BA=90=E5=9B=9B=E9=80=89=E4=B8=80=EF=BC=8B?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E9=9D=A2=E4=BA=94=E9=80=89=E4=B8=80=EF=BC=8C?= =?UTF-8?q?=E6=AD=A3=E6=96=87=3D=E7=8E=B0=E7=8A=B6/=E7=BC=BA=E5=8F=A3/?= =?UTF-8?q?=E5=BD=92=E5=B1=9E/=E7=8A=B6=E6=80=81=E5=9B=9B=E5=B1=9E?= =?UTF-8?q?=E6=80=A7=EF=BC=9BM4=20=E6=95=B0=E5=80=BC=E6=89=B9=E4=BA=94?= =?UTF-8?q?=E6=9D=A1=E7=BB=9F=E4=B8=80=E3=80=8C=E6=96=87=E6=A1=A3=E8=AE=BE?= =?UTF-8?q?=E8=AE=A1=E5=B7=B2=E9=97=AD=E5=90=88=EF=BC=88=E5=8D=A1=20v1.2?= =?UTF-8?q?=EF=BC=89=EF=BC=8B=E5=B7=B2=E5=86=99=E5=8D=A1=E3=80=8D=E7=B4=AF?= =?UTF-8?q?=E7=A7=AF=E6=80=81=EF=BC=8C=E9=85=8D=E6=AF=94=E9=A2=84=E8=AE=BE?= =?UTF-8?q?=E5=86=BB=E7=BB=93=E6=8C=82=E8=B5=B7=E8=AE=B0=E5=B7=B2=E5=86=99?= =?UTF-8?q?=E5=8D=A1=EF=BC=88=E5=A4=87=E9=80=89=EF=BC=89=EF=BC=8C=E5=B7=A5?= =?UTF-8?q?=E7=A8=8B=E7=9B=B4=E5=85=A5=E7=B1=BB=E8=AE=B0=E5=BE=85=E5=86=99?= =?UTF-8?q?=E5=8D=A1=EF=BC=8C=E5=A4=87=E9=80=89/=E8=A7=A6=E5=8F=91?= =?UTF-8?q?=E6=9D=A1=E4=BB=B6=E7=B1=BB=E5=8A=A0=EF=BC=88=E5=A4=87=E9=80=89?= =?UTF-8?q?=EF=BC=89=E5=90=8E=E7=BC=80=EF=BC=8C=E4=BA=8C=E4=B8=89=E5=85=B3?= =?UTF-8?q?=E6=A3=8B=E7=9B=98=E8=A7=82=E6=84=9F/=E7=BE=8E=E6=9C=AF?= =?UTF-8?q?=E9=93=BE=E8=B7=AF=20P0/=E8=BF=AD=E4=BB=A3=2030=20=E5=89=94?= =?UTF-8?q?=E9=99=A4=E7=99=BB=E8=AE=B0=E7=94=A8=E5=8F=8C=E8=BD=A8=E5=B9=B6?= =?UTF-8?q?=E5=88=97=E6=AE=B5=EF=BC=8C=E6=95=99=E5=AD=A6=E4=BA=94=E6=9D=A1?= =?UTF-8?q?=E4=B8=8E=E6=95=8C=E4=BA=BA=E7=B3=BB=E7=BB=9F=E5=9B=9B=E6=9D=A1?= =?UTF-8?q?=E8=A1=A5=E7=BC=BA=E5=8F=A3=E5=B1=9E=E6=80=A7=EF=BC=9B=E5=85=AD?= =?UTF-8?q?=E6=9D=A1=E6=97=A0=E6=97=A5=E6=9C=9F=E6=9D=A1=E7=9B=AE=E6=8C=89?= =?UTF-8?q?=E5=8F=AF=E8=80=83=E6=97=A5=E6=9C=9F=E6=88=96=202026-10-18=20?= =?UTF-8?q?=E8=A1=A5=E7=99=BB=EF=BC=89=EF=BC=9B=E5=88=A0=E9=99=A4=2022=20?= =?UTF-8?q?=E6=9D=A1=EF=BC=8813=20=E6=9D=A1=E6=89=B9=E6=AC=A1=E5=B7=B2?= =?UTF-8?q?=E5=AE=8C=E6=88=90=EF=BC=8B6=20=E6=9D=A1=E5=8F=8D=E5=93=BA?= =?UTF-8?q?=E7=82=B9=E5=B7=B2=E5=86=99=E5=85=A5=EF=BC=8B=E8=A7=A3=E9=94=81?= =?UTF-8?q?=E7=95=8C=E9=9D=A2=E6=AE=8B=E4=BD=99/=E9=97=B8=E5=88=86?= =?UTF-8?q?=E5=9F=9F=E4=BB=A3=E6=8B=8D=E6=9D=BF/=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E9=97=B8=E6=AC=A0=E8=B4=A6=203=20=E6=9D=A1=E4=B9=89=E5=8A=A1?= =?UTF-8?q?=E5=B7=B2=E6=B8=85=E2=80=94=E2=80=94=E8=90=BD=E7=82=B9=E9=80=90?= =?UTF-8?q?=E6=9D=A1=E6=A0=B8=E5=AE=9E=EF=BC=9Aart-bible=20v3.14=20=C2=A74?= =?UTF-8?q?.1/=C2=A77.6/=C2=A78.2=E3=80=81=E9=94=BB=E9=80=A0=E5=B7=A5?= =?UTF-8?q?=E5=9D=8A=20v0.5-v0.7=E3=80=81=E5=85=83=E8=BF=9B=E5=BA=A6=20v1.?= =?UTF-8?q?18=E3=80=81=E6=95=8C=E4=BA=BA=E7=B3=BB=E7=BB=9F=20v0.18?= =?UTF-8?q?=E3=80=81=E9=9A=BE=E5=BA=A6=E6=9B=B2=E7=BA=BF=E4=B8=8EBoss=20v0?= =?UTF-8?q?.29=E3=80=81registry=20=E7=A5=9D=E7=A6=8F=E6=9D=A1=E7=9B=AE?= =?UTF-8?q?=E3=80=81architecture=20=E8=A3=85=E9=85=8D=E5=90=88=E5=90=8C?= =?UTF-8?q?=E4=B8=8E=E5=AD=98=E6=B4=BB=E6=80=A7=E7=9F=A9=E9=98=B5=E8=8A=82?= =?UTF-8?q?=E3=80=81code-conventions=20=C2=A74=20=E7=AC=AC=209-11=20?= =?UTF-8?q?=E6=9D=A1=E3=80=81test-conventions=20=C2=A77-=C2=A78=E3=80=8107?= =?UTF-8?q?=20=E3=89=94-=E3=89=98=E3=80=81reports/=20=E4=B8=89=E4=BB=BD?= =?UTF-8?q?=E5=AE=9E=E7=8E=B0=E6=8A=A5=E5=91=8A=E3=80=81gdd=5Flint=20?= =?UTF-8?q?=E4=B8=89=E4=BB=B6=20PASS=20=E4=B8=8E=20doc=5Flink=20=E9=9B=B6?= =?UTF-8?q?=E6=AD=BB=E9=93=BE=E5=A4=8D=E8=B7=91=EF=BC=89=EF=BC=9B=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E5=A4=B4=E5=BC=95=E8=A8=80=E6=94=B9=E4=B8=A4=E5=8F=A5?= =?UTF-8?q?=EF=BC=88=E7=99=BB=E8=AE=B0=E5=A4=84=E5=AE=9A=E6=80=A7=EF=BC=8B?= =?UTF-8?q?doc-conventions=20=C2=A712.1=20=E6=9D=83=E5=A8=81=E6=8C=87?= =?UTF-8?q?=E9=92=88=EF=BC=8C=C2=A75=20=E5=8D=95=E4=B8=80=E4=BA=8B?= =?UTF-8?q?=E5=AE=9E=E6=BA=90=EF=BC=89=EF=BC=9B=E5=88=86=E7=BB=84=E5=88=86?= =?UTF-8?q?=E8=8A=82=E4=B8=8E=E6=9D=A1=E7=9B=AE=E9=A1=BA=E5=BA=8F=E9=9B=B6?= =?UTF-8?q?=E5=8F=98=E5=8A=A8=EF=BC=9B=E6=B5=81=E6=B0=B4=E7=BA=BF=E9=97=B8?= =?UTF-8?q?=2006=20=E9=83=A8=E5=88=86=E9=9B=B6=E7=BA=A2=EF=BC=88PASS?= =?UTF-8?q?=EF=BC=9A06=20=E6=9D=A1=E7=9B=AE=2051=EF=BC=9Broadmap=20?= =?UTF-8?q?=E6=97=A7=E6=A0=BC=E5=BC=8F=E7=BA=A2=E5=B1=9E=E4=B8=8B=E4=B8=80?= =?UTF-8?q?=E6=89=B9=E6=95=B4=E6=94=B9=E9=9D=A2=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/06-待办清单.md | 714 +++++++++++++------------------------- 1 file changed, 246 insertions(+), 468 deletions(-) diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index a0a49cab..d355e333 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -1,746 +1,527 @@ # 06-待办清单 -本清单是全项目待办事项的**唯一登记处**：各系统文档不再自建「待办」条目节，只留一行指路存根；新增待办事项一律直接登记本清单。条目按四个循环分组，组内按系统分节；每条事项一个四级标题，其下用粗体属性名成段——**现状**（现状与失义原因，自各系统文档原样搬运、措辞不改；跨文档重复条目合并为一条，登记在建议归属主责方名下，其余来源在现状中注明出处；相关但不同面的条目各自保留，现状末尾互相指认；搬运时仅将原文中的「本文 / 本系统」替换为对应系统名，并把相对链接改写为本文件位置可用的路径）、**归属**、**状态**。事项解决后**从本清单移除**（2026-09-18 用户拍板改口径，原"改状态留痕"废止）：去向与依据登记当批状态记录与 active.md 快照，git 历史即留痕。 +本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据，正文＝现状/缺口/归属/状态四属性）与状态机以 [doc-conventions §12.1](../dev/doc-conventions.md) 为权威。 -#### UI 按钮状态矩阵缺档——悬停没有反馈、危险钮按下没有反馈、键盘焦点全站空白（2026-10-13 登记，UI 美化三层诊断 · 第一层） +#### UI 贴图重构批——营地与元进度件仍是程序化占位（2026-10-13 登记，来源=审计发现，设计面=美术轨） -**现状**：按钮至少应当具备常态 / 悬停 / 按下 / 禁用 / 键盘焦点五种状态，目前全站五种状态的覆盖数量很不齐（`ui_kit.gd` 里常态四处、悬停四处、按下三处、禁用一处、**键盘焦点零处**），具体三处缺档：①普通按钮的贴皮函数（第 541 到 555 行）把悬停态填的是**常态那张图**，等于鼠标移上去外观纹丝不动，同时它把悬停文字色也填成了同常态一样的墨色，两个通道一起失效；②危险钮（第 591 行起）只填了常态与悬停，**没有按下态也没有禁用态**，按下去没有下沉反馈；③全站没有任何键盘焦点样式，走的是引擎默认的灰色描边——这一点正好卡在本清单「棋盘战斗键盘/手柄输入」那条 Beta 待办的连带裁决点③（弹层界面的焦点导航要不要同批做）前面，**焦点态是它的前置件**。**影响**：这些不是纸面问题，玩家在实机上会直接感觉到"点了没反应"。 +**现状**：营地的柜台场景贴图目前是程序化画出来的临时形态，没有上贴图。这条债原先只写在美术侧的资产清单里（[美术资产清单](../art/art-assets-checklist.md) 第 134 行与第 175 行，原文注明"营地现为程序化占位，状态记录 121⑧ 口径，排期归 UI 贴图重构批"），2026-10-13 由 UI 美化三层诊断转立本清单专条。规格其实已经定了——烛光黄 `#F6C667` 配木色 `#8A5A34`（见 [美术圣经](../art/art-bible.md) §4.4），素材来源允许走"通用图标改色复用"这条低成本渠道。 -**归属**：呈现层表现批（纯工程；素材已有按钮常态与按下两张图） - -**状态**：**已完成（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 美化三层诊断 · 第一层） - -**现状**：`game/project.godot` 里没有设置全局的画布纹理过滤方式，引擎默认是线性插值（会把像素图的硬边算成模糊过渡）。像素美术的游戏应当全局设为邻近采样。现行做法是逐个位置手工写死——`ui_kit.gd` 的石纹底噪与图标容器、以及 `standee_body.gd` 第 222 行的站桩立绘都各自手写了邻近采样，其余位置则没有。这种"想起来才设一个"的写法容易漏，凡是漏掉的像素图在非整数倍缩放下都会糊。 - -**归属**：呈现层表现批（一行渲染设置） - -**状态**：**已完成（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），素材来源允许走"通用图标改色复用"这条低成本渠道。 +**缺口**：还差一次「自己画 vs 找 CC0 素材改色」的美术裁决（见 [美术资产清单](../art/art-assets-checklist.md) §0 的复用渠道闸），裁决后才能定素材工单写卡。 **归属**：UI 贴图重构批（美术线；须先裁决是自己画还是找 CC0 素材改色，两条备选见 [美术资产清单](../art/art-assets-checklist.md) §0 的复用渠道闸） -**状态**：待办（**Alpha 阶段需完成**）——本条自美术资产清单转立，是为了避免在两处各写一份内容；**素材的状态视图仍以 [美术素材状态清单](../art/art-status-checklist.md) 为准，本条只承载排期决定**。 +**状态**：待美术设计 -#### UI 字体补完——缺拉丁像素字专件、且全局只有一个字重（2026-10-13 登记，UI 美化三层诊断 · 第二层） +#### UI 字体补完——缺拉丁像素字专件、且全局只有一个字重（2026-10-13 登记，来源=审计发现，设计面=美术轨） **现状**：现在全局只有一套字（`ui_font_fusion_pixel_zh_hans.ttf`，缝合像素字体，中文覆盖好、授权干净，2026-09-27 用户拍板）。但 [美术圣经](../art/art-bible.md) §7.4 定的口径其实是**两套搭配**：拉丁用 Kenney 的像素字、中文用 Fusion Pixel。更要紧的是字重纪律——该条款允许"字号档差 + 墨色深浅 + 字重两档"三个手段一起做信息层级，现在只有单字重，等于层级只能靠字号档差这一个手段，这就是实机上"屏标题看起来不够重、标题跟正文拉不开"的根因（[美术素材状态清单](../art/art-status-checklist.md) 把字体标为占位在役，也是这个意思）。 +**缺口**：还差一次「补不补拉丁专件、要不要上第二个字重」的美术裁决，裁决后才能定字体素材工单与 §7.4 的落地口径。 + **归属**：呈现层表现批 + 美术线（须先裁决：补不补拉丁专件、要不要上第二个字重） -**状态**：待办（**Alpha 阶段需完成**） +**状态**：待美术设计 -#### 战斗一屏样张 P0 未开工——界面成品是否过审的那把尺子还没建（2026-10-13 登记，UI 美化三层诊断 · 第二层） +#### 战斗一屏样张 P0 未开工——界面成品是否过审的那把尺子还没建（2026-10-13 登记，来源=审计发现，设计面=美术轨） -**现状**：[美术圣经](../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) 把「战斗一屏样张」这件最高优先级的素材标的是**未开始**——也就是说，**判定界面美术算不算过关的那把尺子到现在还没造出来**。2026-10-16 曾编入迭代 30 卡②（UI 呈现三卡批序位②），2026-10-17 用户裁定不满足「迭代＝代码实现批」的开发条件、剔除回待设计（理由＝样张交付物本身就是设计规格，正式字体与素材均未定稿；同日样张批开工已被用户终止）。v1.4 旧卡留 design/research/需求卡片-战斗一屏样张批-2026-10-16.md 作素材，非已写卡状态，重启不得直接开工。 + +**缺口**：还差「设计讨论→需求澄清→美术定稿」一轮设计（样张即设计目标图，产出尺寸档/色板/明度档清单反向给素材批），定稿后重新立卡方可开发。 **归属**：美术线（战斗一屏样张的验收标准归 [战斗表现](systems/战斗循环/战斗表现.md) 与 [美术圣经](../art/art-bible.md) §5.1 共裁） -**状态**：待办（**Alpha 阶段需完成**）——**意义提示**：按圣经条款，占位态禁止跨里程碑，本条只要不做，界面美术就始终处于未定稿状态，上面所有呈现层改动做完也缺少验收依据。**2026-10-16 用户令编入迭代 30**（UI 呈现三卡批序位②，需求卡片=[战斗一屏样张批](../research/需求卡片-战斗一屏样张批-2026-10-16.md) v1.2 裁点已留痕；开工门=U0 `/iter` 发令）。 +**状态**：待美术设计 -#### UI 氛围层与九宫格切片观感修——光柱硬边与面板切片错位（2026-10-13 登记，UI 美化三层诊断 · 第三层） +#### UI 氛围层与九宫格切片观感修——光柱硬边与面板切片错位（2026-10-13 登记，来源=审计发现，设计面=美术轨） -**现状**：两处画法在实机上能直接看出瑕疵，成因同属"图表与参数没调到位"，此前未在任何登记处在册：①背景斜光带的做法是生成一张 560×560 的贴片（`ui_kit.gd` 第 263 行起），贴片里只有一条宽 100 像素、**边缘没有任何过渡**的斜向亮带，透明度整条一样是 0.05，再平铺满全屏——铺开后就是等距的三块硬边梯形，看着像"屏幕上贴了三块白色补丁"而不是光。正常的光带应当横向有渐变、纵向有上亮下暗的衰减。②结算屏与图例屏的面板边缘能看到错位的小方块，这是九宫格切片参数与素材尺寸不匹配造成的拉伸接缝——仪式石框（258 字节的小图）按 12 像素切片、石板亮面板（314 字节）按 16 像素切片，铺到四百多像素宽的面板上时中段就会被拉出可见错位。 +**现状**：原两处，一处已修一处存续。①光柱硬边**已修**（2026-10-14 迭代 26 T4：`ui_kit.gd` 第 263 行起的光柱贴片改带内 alpha 0→0.05→0 三角过渡＋纵向衰减上亮下暗，grilling Q7 裁连续 alpha 方案；LINEAR 白名单已随反哺入册 art-bible v3.14 §8.2）。②九宫格切片错位**存续**——结算屏与图例屏的面板边缘可见错位小方块，成因是九宫格切片参数与素材尺寸不匹配（仪式石框 258 字节小图按 12 像素切片、石板亮面板 314 字节按 16 像素切片，铺到四百多像素宽面板中段拉出错位），须先核素材尺寸能否撑住新切片值（border_stone/panel_stone 均 48×48），可能要重出素材，归「UI 贴图重构批」后续贴图批次。 -**归属**：呈现层表现批（光柱纯改代码；九宫格切片需连带核对素材尺寸能否撑住新切片值，可能要重出素材，属美术线连带面） +**缺口**：还差「UI 贴图重构批」里的素材尺寸核对与「是否重出素材」裁决，才能定切片修法。 -**状态**：**半完成（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 美化三层诊断 · 第三层） +**状态**：待美术设计 -**现状**：四处细节都是实机上的可见问题，均已核查确认未在任何登记处在册：①设置面的音量滑轨，"已填的那一段"和"没填的那一段"是同一个深棕色，玩家看不出当前值在哪——这条其实触犯了 [美术圣经](../art/art-bible.md) §7.2 的可读性硬条款；②商店与三选一的卡片上，图标一律垫一块颜色很深的方形底色块，在米色卡面上像硬贴上去的一块补丁；③留白失衡——商店三张卡片只占屏幕上半部分、下面近一半空着，三选一同款，营地三栏不等高（第一栏比旁边两栏矮一截）；④主菜单及各屏左下角常驻一个"诊断转储"按钮（开发调试件），玩家看得见——2026-09-29 那轮界面重设计的对比报告里就已经把它列成"开发占位外泄、应从玩家画面移除"，至今未处理。 +#### 状态面板瘦身——局内面板去跨关解锁内容、只留本局信息（2026-10-16 登记，来源=playnote，设计面=工程直入） -> **⚠ 措辞订正（2026-10-14，迭代 25 反哺②落文——用户裁「全部按呈报落文」）**：本条①原诊断描述「两段是同一个深棕色」与代码面不符——实为暖石 #B8A582 / 深棕 #7A5232（2.84:1，低于 3:1 图形参考线）。「偏难辨」成立、「同色」不成立；修复按「两段对比不足」定性走（迭代 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，代拍板白名单八项，反哺点三条。 - -**指针**：`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 同步面已注销或改写；实现报告已退役（git 历史可考）；反哺点四条见下条，已于 2026-10-14 用户裁决写入 - -#### 迭代 26 UI 交互与观感批——GDD 反哺点四条（2026-10-14 顺带登记，待用户逐点裁决另批写入文档） - -**来源**：迭代 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（裁决后另批写入文档） - -**状态**：✅ **已写入（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-16 playnote 用户反馈，同日令写进 08 与 06） - -**现状**：来源 = playnote 用户反馈「关卡界面中的"状态"界面不需要有具体的解锁内容……只显示跟当前冒险有关的内容，不需要有跨关的这种解锁信息；比如带的秘宝、获取的专长、当前的属性、现有的 GP、总共的钥石」。现行实态（status_panel.gd 实查）＝局内状态面板（2026-10-13 由「暂停层」改名）现为跨局进度镜像：钥石余额徽＋「道具工坊 · 解锁态」段（实为秘宝匣 12 行解锁态概览，迭代 22 T2 换代，解锁文案与营地柜台同口径）＋「天赋树 · 已购概览」段——恰为用户要去掉的跨关解锁内容。 - -**范围（用户原话五件套，零待裁点）**：面板只留本局信息——带的秘宝 / 已获专长 / 当前属性 / 现有 GP / 钥石总量；秘宝匣解锁态 12 行概览与天赋树已购概览两段退役（跨局解锁概览由营地 / 生涯承载，局内不再镜像）；面板标题与提示行文案随新定位换代（现行「查看本局钥石与永久强化进度」语义失效）。 +**现状**：playnote 用户反馈：关卡界面中的"状态"面板不需要跨关解锁内容，只显示跟当前冒险有关的信息。现行实态（status_panel.gd 实查）＝局内状态面板（2026-10-13 由「暂停层」改名）现为跨局进度镜像：钥石余额徽＋「道具工坊 · 解锁态」段（实为秘宝匣 12 行解锁态概览）＋「天赋树 · 已购概览」段——恰为用户要去掉的跨关解锁内容。范围＝用户原话五件套，零待裁点：面板只留带的秘宝/已获专长/当前属性/现有 GP/钥石总量；秘宝匣解锁态 12 行概览与天赋树已购概览两段退役（跨局解锁概览由营地/生涯承载，局内不再镜像）；面板标题与提示行文案随新定位换代（现行「查看本局钥石与永久强化进度」语义失效）。2026-10-16 用户令「不需要讨论的写进 08 并同步 06」——[08-Alpha版本标准](08-Alpha版本标准.md)「三 · 界面」状态面板行已换代（v1.8 起部分在役）；元进度「解锁双入口框架」节与 camp 双入口框架句为设计权威文档反哺点待用户另批裁决。未排期，开工＝用户发令或随 UI 批编入。 **归属**：status_panel.gd（呈现层承载）+ [元进度](systems/跨局循环/元进度.md)「解锁双入口框架」节与 [camp](ux/camp.md) 双入口框架句（局内只读入口语义随瘦身穿改——设计权威文档反哺点，待用户裁决另批）+ [08-Alpha版本标准](08-Alpha版本标准.md)「三 · 界面」状态面板行（v1.8 起部分在役） -**状态**：待办（**Alpha 阶段需完成**）——零待裁点（五件套为用户原话清单；2026-10-16 用户令「不需要讨论的写进 08 并同步 06」）；未排期，开工 = 用户发令或随 UI 批编入。 +**状态**：待写卡 -#### 旧行为 MC 行为锚全数作废——重锚归数值批（2026-10-06 登记） +#### 旧行为 MC 行为锚全数作废——重锚归数值批（2026-10-06 登记，来源=批次移交，设计面=文档轨） -**现状**：案C 地图伤害账殿后批（git 7ef18ac，状态记录 371）改变每轮结算行为序——授予段不再兑付任何伤害（伤害形态单据暂存至战斗段末，段内序=主角先手→逐敌还手→地图账），主角死亡短路语义随之换代（「授予段伤害致死短路先手」路径消失）。既有全部 MC 行为锚与基线逐项比对锚所锚行为已不存在，**全数作废**；新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则（无数值调整禁重跑），重锚不在改动批执行。 +**现状**：案C 地图伤害账殿后批（git 7ef18ac，状态记录 371）改变每轮结算行为序——授予段不再兑付任何伤害（伤害形态单据暂存至战斗段末，段内序＝主角先手→逐敌还手→地图账），既有全部 MC 行为锚与基线逐项比对锚所锚行为已不存在，**全数作废**；新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则（无数值调整禁重跑），重锚不在改动批执行；重锚前一切 MC 旧读数只作历史存档，禁止与新行为逐项比对。M4 数值批卡 v1.2 已收该义务（F19：对拍锚按案C 新序重推导、T6 四带复算按新行为首采立新锚）。 **归属**：M-4 数值批（用户 2026-10-06 确认此为影响数值难度的重要变量）。 -**状态**：待数值批触发时重采；重锚前一切 MC 旧读数只作历史存档，禁止与新行为逐项比对。——**已增补进 Alpha 收官 M4 数值批〔未排期，2026-10-07 用户令移出迭代 18 暂不启动〕〔2026-10-06 用户令自迭代 17 卡②移出——不影响 17 正在执行中的开发〕需求卡片 v1.1（2026-10-06：T0 推算稿第五件+T6 四带复算按案C 新行为首采；design/research/需求卡片-M4数值批-2026-10-05.md）** +**状态**：文档设计已闭合（design/research/需求卡片-M4数值批-2026-10-05.md v1.2）＋已写卡（design/research/需求卡片-M4数值批-2026-10-05.md） -#### 双层 BD 延期与备选内容总登记（2026-10-03 立项——需求卡片退役保险） +#### 双层 BD 延期与备选内容总登记（2026-10-03 登记，来源=批次移交，设计面=文档轨） -**目的**：需求卡片/整合定稿系中间文档，落地完成后按吸收即死退役——用户令「只删除已完成落地的内容」，本条自承载全部**未落地**内容防丢失（每项自包含，不依赖指针）。 +**现状**：需求卡片/整合定稿系中间文档，落地完成后按吸收即死退役——用户令「只删除已完成落地的内容」，本条自承载全部**未落地**内容防丢失（每项自包含，不依赖指针）。 -**二期件组**（触发=迭代 12 出口读数+用户点名立项；各件机制形态已定，数值 provisional）： +**二期件组**（触发＝迭代 12 出口读数+用户点名立项；各件机制形态已定，数值 provisional）： - **战斗→扫雷跨阶段回流**（穿刺流）：击杀轻甲敌人返还 1 AP——战斗收益反哺开格动机；AP 经济新管道，谨慎件（威胁红线③边缘，立项须专项论证） - **穿甲锥**（穿刺×标旗协同桥）：对被控制危险格的敌人穿刺伤害再提升 - **孤注一掷**（普攻流二期锚点件）：每轮攻击次数减至 1、该次伤害大幅倍增——攻击频率规则改写 - **悬浮魔法球**（魔法流二期）：轮末召唤物环绕，每轮自动对最强敌人造成魔法伤害——需战斗单位系统新增实体类型（召唤物/持续伤害源） - **商店置换服务「符文重铸」**：攻击类型族后期流派转换（花 GP 重掷攻击类型相关件）——商店新交互 -- **件派生动词白名单（非信息类）**：拔旗回收返 AP/定向熄灭伤害型地形格/重掷 RAP 等第三盘面动作——**触发条件=件池 ≥30 种后玩家仍反馈操作重复且定位在操作层（非决策层）**；信息类派生动词维持全禁（R4 甲，见下备选组） +- **件派生动词白名单（非信息类）**：拔旗回收返 AP/定向熄灭伤害型地形格/重掷 RAP 等第三盘面动作——**触发条件＝件池 ≥30 种后玩家仍反馈操作重复且定位在操作层（非决策层）**；信息类派生动词维持全禁（R4 甲，见下备选组） - **三期：合成进化**：两件同名/同标签件合成升品（Ball x Pit 式）——池深不足时的解药，三期再议 -**淘金流立派缓议**（定位=支撑引擎非胜利条件；触发=先作件族挂配套池观察、数据支持后再立派）：吝啬鬼账本/金脉共鸣（每持有 ~N GP 攻击 +~X——GP 进伤害公式新缩放源）/贪婪契约（商店折扣+金币掉落增税，正负双修）/消费回馈（商店购买附赠同类临时增益）/战利品鉴定（三选一必含 1 件高稀有度）。 +**淘金流立派缓议**（定位＝支撑引擎非胜利条件；触发＝先作件族挂配套池观察、数据支持后再立派）：吝啬鬼账本/金脉共鸣（每持有 ~N GP 攻击 +~X——GP 进伤害公式新缩放源）/贪婪契约（商店折扣+金币掉落增税，正负双修）/消费回馈（商店购买附赠同类临时增益）/战利品鉴定（三选一必含 1 件高稀有度）。 -**R4 乙备选案（2026-10-03 用户裁甲=信息型永不对冲，本组冻结）**： +**R4 乙备选案（2026-10-03 用户裁甲＝信息型永不对冲，本组冻结）**： - 信息型清除工具件族（「除尘风箱」类：限价限量清除藤蔓/烬覆/矿尘遮蔽、恢复数字） -- 深挖钻头原案（开出深层资源、代价=「危险格位置信息 −1」主动吃信息税——现行已改设计为非信息税形态：代价候选=额外 ~1 AP 或踩雷惩罚加重） +- 深挖钻头原案（开出深层资源、代价＝「危险格位置信息 −1」主动吃信息税——现行已改设计为非信息税形态：代价候选＝额外 ~1 AP 或踩雷惩罚加重） - 「概率收窄」类派生动词（花 AP 把某格是雷的概率收窄，非确定信息） -- **重启条件=R4 复查闸读数支持（信息型挫败信号，T10 呈报）+用户显式放宽红线①边界**——本组重启属红线变更，须用户发起 +- **重启条件＝R4 复查闸读数支持（信息型挫败信号，T10 呈报）+用户显式放宽红线①边界**——本组重启属红线变更，须用户发起 -**设计知识存续口径**：七流派完整件表/逐项反例条件表/天赋树后备语言（哈迪斯 2 预算制扩容/邻接树改型/GP 价格通胀防线）存整合定稿，随实施批文档吸收迁入各 GDD 权威文档（元进度/node-reward/战斗结算/地形变异/行动经济/秘宝边界句/商店 spec）——**吸收完成前定稿不删**；喂雷流待办见上条遗留登记。 +**设计知识存续口径**：七流派完整件表/逐项反例条件表/天赋树后备语言（哈迪斯 2 预算制扩容/邻接树改型/GP 价格通胀防线）存整合定稿，随实施批文档吸收迁入各 GDD 权威文档（元进度/node-reward/战斗结算/地形变异/行动经济/秘宝边界句/商店 spec）——**吸收完成前定稿不删**；喂雷流待办见「旧行为 MC 行为锚」条所在批次的历史登记。 -#### 关卡节点图重构——可选节点太少（2026-10-13 用户定性为重构，须先做文档设计） +**缺口**：全组为备选库：各件启用须用户发令立项，届时按件走设计讨论定机制形态与数值（二期件组机制形态已定、数值 provisional；R4 乙组重启属红线变更须用户发起）。 -**现状**：来源 = playnote 用户试玩记录「关卡节点图展示得有问题，希望可以优化一下。可以参考哥布林弹珠的那种方式去移动」。2026-10-13 用户明确定性：**这是当前关卡节点图的重构，不是呈现优化**——理由是**现在的可选节点太少**（用户原话），所以不是换一种画法或移动方式就能解决的事。 +**归属**：备选库总登记（本条自承载；组内各件启用时按内容归专长重设计扩充批／秘宝内容批／商店 spec／战斗结算等对应批） -**现行实态**（`level.tres` 实查，三关各 5 张模板）：**第一关五张模板全是单链排列变体**——7 个节点 = 战斗 ×4 + 奖励 + 休整 + Boss，战斗深度序单调保难度坡，**变化面只有奖励与休整两位的先后次序**，全链零分叉，玩家在选路上**没有任何选择**；第二 / 三关是网状图（10 节点，带 `next` 分支，最大层宽 4–5），有分叉，但用户仍判选择量不足。参考方向 = Peglin（哥布林弹珠）的节点图移动与选路方式。 +**状态**：待文档设计（备选） -**范围（重构面，非呈现面）**：节点数量、分叉度、选路自由度。连带三面——① [关卡节点图生成](systems/冒险循环/关卡节点图生成.md)（模板池与抽签机制，现行 15 张骨架 = 3 关 × 5 需重生成）；② [level-map](ux/level-map.md)（选路枢纽三停点布局定稿版，图结构改则屏面随之改）；③ [敌人系统](systems/战斗循环/敌人系统.md)（遭遇表按 `enemy.tres` 的 (level_index, node_depth) 坐标索引，节点数与编号一改，行集坐标与首遇教学位断言面全部随动）。 +#### 关卡节点图重构——可选节点太少（2026-10-13 登记，来源=playnote，设计面=文档轨） + +**现状**：来源＝playnote 用户试玩记录「关卡节点图展示得有问题，希望可以优化一下。可以参考哥布林弹珠的那种方式去移动」。2026-10-13 用户明确定性：**这是当前关卡节点图的重构，不是呈现优化**——理由是**现在的可选节点太少**（用户原话），所以不是换一种画法或移动方式就能解决的事。 + +**现行实态**（`level.tres` 实查，三关各 5 张模板）：**第一关五张模板全是单链排列变体**——7 个节点＝战斗 ×4 + 奖励 + 休整 + Boss，战斗深度序单调保难度坡，**变化面只有奖励与休整两位的先后次序**，全链零分叉，玩家在选路上**没有任何选择**；第二/三关是网状图（10 节点，带 `next` 分支，最大层宽 4–5），有分叉，但用户仍判选择量不足。参考方向＝Peglin（哥布林弹珠）的节点图移动与选路方式。 + +**范围（重构面，非呈现面）**：节点数量、分叉度、选路自由度。连带三面——① [关卡节点图生成](systems/冒险循环/关卡节点图生成.md)（模板池与抽签机制，现行 15 张骨架＝3 关 ×5 需重生成）；② [level-map](ux/level-map.md)（选路枢纽三停点布局定稿版，图结构改则屏面随之改）；③ [敌人系统](systems/战斗循环/敌人系统.md)（遭遇表按 `enemy.tres` 的 (level_index, node_depth) 坐标索引，节点数与编号一改，行集坐标与首遇教学位断言面全部随动）。 **量化要求补登（2026-10-16 playnote 用户补写）**：「需要统计一下第 123 关 path 的路径长度，路径长度需要递增，并且后续关卡的节点数增幅应该更大」（第 123 关＝第 1/2/3 关）——重构设计讨论的验收方向两条：先实测三关路径长度基线，再定递增曲线与后续关增幅尺度。 -**前置（用户 2026-10-13 裁）**：**须先做文档设计讨论，不可直接开发**——方案与参考调研先行、过人闸后才可开卡。与下方「奇物呈现优化探讨备忘两孤儿点」(f)「关卡节点图展示改版先出参考调研+方案人闸」同源，两处互相指认，不重复立项。 +**前置（用户 2026-10-13 裁）**：**须先做文档设计讨论，不可直接开发**——方案与参考调研先行、过人闸后才可开卡。与「奇物呈现优化探讨备忘两孤儿点」(f) 同源，两处互相指认，不重复立项。版本标准侧已登记为 Alpha 待做项，见 [08-Alpha版本标准](08-Alpha版本标准.md)「一 · 系统 · 冒险循环」。 + +**缺口**：还差参考调研＋重构方案的设计讨论（含路径长度基线实测与递增曲线两条验收方向），过人闸后才能开卡。 **归属**：[关卡节点地图](systems/冒险循环/关卡节点地图.md)（图结构与节点语义，主责）+ [关卡节点图生成](systems/冒险循环/关卡节点图生成.md)（模板池与抽签）+ [level-map](ux/level-map.md)（选路呈现）+ [敌人系统](systems/战斗循环/敌人系统.md)（遭遇行集坐标连带）；版本标准侧已登记为 Alpha 待做项，见 [08-Alpha版本标准](08-Alpha版本标准.md)「一 · 系统 · 冒险循环」 -**状态**：待办（**Alpha 阶段需完成**）——**设计讨论先行**：2026-10-13 用户裁：此事复杂，须先走文档设计讨论，不是可以直接开发的批次；未排期、不开卡，重启 = 用户发令。版本标准侧已列为 Alpha 待做项，见 [08-Alpha版本标准](08-Alpha版本标准.md)「一 · 系统 · 冒险循环」 +**状态**：待文档设计 -#### 武器锻造系统——攻击/护甲成长差异化提案（2026-10-06 playnote 用户提案，同日令入迭代 18） +#### 天赋树实装批登记欠账余两件——AP 上限 clamp 与三选一刷新软上限（2026-10-12 登记，来源=批次移交，设计面=文档轨） -**现状**：用户提案（playnote 2026-10-06）：攻击力提升改造为「武器锻造」系统——① 剑（普通攻击）：锻造升级增加攻击力，最高等级附带额外效果；② 长枪/法杖：后续新增武器，攻击类型分别变为穿刺/魔法，同样满级带特殊效果——实现武器间差异化；③ 护甲同理：初始只有轻甲（升级只提 AC），最高等级后可解锁重甲/魔法护甲——基础 AC 各不相同、可继续升级、各带不同额外效果。 +**现状**：迭代 21 天赋树实装批顺带入册欠账三条，2026-10-13 三件终态：① **AP 上限 clamp 缺位（缺陷）**——树「开局姿态」（每关首轮 AP+1）、AP 件、时沙同走 `action_economy.gd:239 _pending_ap_delta` 排队，轮始兑现仅下限钳制（`:254 maxi(0, …)`，无上限）；**用户裁暂不设上限**——provisional 天花板亦不投，随 Alpha 收官 M4 数值批连同全部 AP 数值统一标定。② **三选一刷新软上限（设计问）**——停点内 GP 付费刷新倍率增长（×1.8/次曲线）×停点间基础价随进度递增，全程无软上限；**定性确认＝设计问非缺陷，用户裁维持现状**，归 M4 数值批调参窗口处理，不提前单开讨论。③ **Y（_attune_refresh_y）不入断点存档（可利用漏洞）**——已修复注销（2026-10-13 用户令提前单独开修：断点快照扩列 `attune_refresh_y`＋续玩 `resume_adventure` 优先读断点〔缺键回退参数面＝旧档行为零变化〕＋单测两断言；冒烟 938/0+单测 24 套全绿）。①②成裁晚于 M4 卡 v1.2（2026-10-06 定稿），尚未入卡范围，跑批前须并入或随批呈报。 -**归属**：[锻造工坊](systems/跨局循环/锻造工坊.md)（设计权威文档，v0.1〔时名「武器锻造」〕起自本专条独立成文；2026-10-11 用户令系统更名锻造工坊） +**缺口**：还差 M4 数值批跑批窗口的标定执行——①②尚未入 M4 卡 v1.2 范围，跑批前须并入卡片或随批呈报。 -**状态**：**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 数值批〔未排期〕。实装待办见下条。 +**归属**：① [行动经济](systems/排雷循环/行动经济.md)；② 行动经济+三选一/商店刷新经济（数值归 Alpha 收官 M4 数值批）；③ [存档序列化](systems/表现与支撑/存档序列化.md)（断点域）+ [冒险结构](systems/冒险循环/冒险结构.md)（续玩参数面）——③已修复注销 -#### 锻造工坊实装批 — 待办（冻结：迭代规划冻结中，重启=用户发令）（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 / 解锁价上的取值）；本批只按统一伤害轴落结构与字段。 +#### 现役 UI/文案两处自相冲突（2026-10-09 登记，来源=审计发现，设计面=工程直入） -**归属**：[锻造工坊](systems/跨局循环/锻造工坊.md) 实装（跨 meta/hero/feats/存档/战斗开场参数五面） +**现状**：①battle_narrator.gd:160 文案「与通关三选一同池同权重同上限」与现役实现不符——通关渠道自迭代15② 起＝纯专长，该句系落码前旧话（玩家可见错话）；②hero_info_panel_view.gd _curio_section 与 _feat_section 两段同标「特性」——现役界面文案重复。两处均系「现役码 vs 现役码」冲突，非新设计未实装的预期偏差。2026-10-09 审查批呈报 B5，用户裁「记录待办、后续迭代解决」；体量均小，随后续迭代安排修复。 -**状态**：✅ **已入库（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/存档域键名词条）——本条义务全清。** +**归属**：①战斗叙述呈现（battle_narrator.gd，战斗表现/HUD 呈现面）；②英雄信息面板（hero_info_panel_view.gd，HUD 框架） -#### 玩家向显示名改名小批（局内三轴 + 临时 AC 状态）——跨循环名称冲突清偿（2026-10-12 用户逐裁，锻造工坊裁决会话续 8a 连带） +**状态**：待写卡 -**背景**：锻造工坊 v0.5 8a 命名讨论中用户指出——局内商店货架标着"攻击锻升 / 生命锻升 / 护甲锻升"的三行，实为奇物「属性值提升」三轴（攻击 / 生命上限 / AC）的**货架前台标签**（`shop.tres` pool_shelf 的 `kind_id` 指向 `adventure.tres` CURIO_KINDS），进冒险加算区、冒险结束清零，**既不是武器也不是护甲**。它与营地锻造（账号层永久）唯一的联系是名字里那个"锻"字——这是两 Loop 混读的唯一来源（结构层从未冲突）。用户裁决：按「属性 + 后缀」改名，后缀 = **祝福**；并顺带裁定临时叠层状态不该叫"护甲"。 +#### 棋盘战斗键盘/手柄输入（2026-10-04 登记，来源=会话提及，设计面=文档轨） -**内容（全部 = 纯字符串替换，零逻辑改动）**： +**现状**：战斗棋盘操作现行唯一输入＝鼠标——左键已开格＝移动/未开格＝挖掘，右键＝封印（旗一次性承诺，无拔旗），悬停承载合法性反馈（可挖域微光 + BFS 路径点迹）；全仓无 InputEventKey/JoypadButton 处理，project.godot 无自定义 InputMap 动作。**可行性已核（2026-10-04）：可做**——分发接缝现成，board_view `action_requested(cell, kind)`（kind ∈ {dig, move, flag_place, flag_pull}）是唯一出口，键盘/手柄作第二输入前端产出同款信号即可，规则引擎合法性校验零改动；Godot InputMap 原生支持键盘与手柄绑定同一动作，与鼠标并存不冲突。用户期望操作形态：十字方向移动；挖掘/封印各一独立键；方向控制选定 8 向挖掘或封印目标（8 向恰与现行可挖域同集，十字移动与立绘 4 向既有裁决一致）；键盘移动语义＝逐格步进。连带设计点四条（实施批先裁）：① 键盘模式需屏上光标格承载现行悬停反馈；② 键盘默认键位与手柄键位映射待定；③ 弹层界面（结算/三选一/商店/设置等）现行全鼠标，手柄全覆盖需焦点导航——是否同批待裁（2026-10-06 增补：暂停层〔现状态面板〕Esc 快捷通道并入本条随键盘批统一实施，弹层清单 +1 项）；④ 键位自定义是否进设置面待裁。排期 Beta（2026-10-04 登记；可行性已核毕，立项时按 roadmap 开卡）。 -【C】局内商店货架三行（现役行族 + 遗留行族同名，两处都改） -| 位置 | 旧 | 新 | -|---|---|---| -| `game/data/tables/shop.tres:70`（pool_shelf 现役） | 攻击锻升 | **攻击祝福** | -| `game/data/tables/shop.tres:74`（pool_shelf 现役） | 生命锻升 | **生命祝福** | -| `game/data/tables/shop.tres:78`（pool_shelf 现役） | 护甲锻升 | **护甲祝福** | -| `game/data/tables/shop.tres:38`（products 遗留行族，只在对照模式承载） | 攻击锻升 | **攻击祝福** | -| `game/data/tables/shop.tres:45` | 生命锻升 | **生命祝福** | -| `game/data/tables/shop.tres:52` | 护甲锻升 | **护甲祝福** | -> C 侧**零代码零测试连带**：全库 `锻升` 命中恰为上述 6 行，`display_name` 非查找键（货架以 `kind_id` 为键，`config_db.gd:328`）；唯一 UI 断言 `smoke_all.gd:4415` 是"标签文本 == 表值"的自洽式断言，改表自动跟随。 -> **【C 已执行（2026-10-12）】**——六行全部替换完毕，全库"锻升"命中归零，`shop.tres` 行数与括号结构零变化。**执行路径**：worktree 分支 `rename-blessing-20261012`（用户令"实现类改动走 worktree 分支"）→ 冒烟 864 项检查 0 项失败 → 合入 master `0c93a71`。C 侧本身零代码零测试连带（`display_name` 非查找键，货架以 `kind_id` 为键），但与 D 同批执行——D 需改 `.gd` 断言，用户追加授权（"可以简单地修改，你这次一并改完吧。但是注意我们的合入规则，避免合入失败了"）。 - -【D】临时 AC 状态 / 棋盘格 defense 正向行（同一 effects 的两端，两处同名同改） -| 位置 | 旧 | 新 | -|---|---|---| -| `game/data/tables/reward.tres:22` | 护甲强化 | **盾牌加护** | -| `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` 保险丝给的是护盾层，与本状态是两种东西。 -> **【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 新增「攻击祝福/生命祝福/护甲祝福」词条（旧名保留检索别名）与「石肤（近义词占用）」备忘词条。 - -**归属**：独立改名小批（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 原批条目随入库注销拆出） - -**现状**：迭代 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 套全绿。本件注销。 - -**归属**：① [行动经济](systems/排雷循环/行动经济.md)；② 行动经济+三选一/商店刷新经济（数值归 Alpha 收官 M4 数值批）；③ [存档序列化](systems/表现与支撑/存档序列化.md)（断点域）+ [冒险结构](systems/冒险循环/冒险结构.md)（续玩参数面）——三件均系缺陷修批/调参批输入，未排批 - -**状态**：**三件终态（2026-10-13）**：① 暂不设上限随 M4 数值批／② 维持现状归 M4 数值批（两件批内零动作，数值统一标定归 M4）；③ ✅ 同日缺陷修批已修复注销（用户令提前单独开修）——本条转为记账条，无待裁点 - -#### 现役 UI/文案两处自相冲突（2026-10-09 登记——审查批呈报 B5，用户裁「记录待办、后续迭代解决」） - -**现状**：①battle_narrator.gd:160 文案「与通关三选一同池同权重同上限」与现役实现不符——通关渠道自迭代15② 起=纯专长，该句系落码前旧话（玩家可见错话）；②hero_info_panel_view.gd _curio_section 与 _feat_section 两段同标「特性」——现役界面文案重复。两处均系「现役码 vs 现役码」冲突，非新设计未实装的预期偏差。 - -**状态**：待办（随后续迭代安排修复；体量均小） - -#### 棋盘战斗键盘/手柄输入（2026-10-04 用户提问登记，排期 Beta） - -**现状**：战斗棋盘操作现行唯一输入 = 鼠标——左键已开格 = 移动 / 未开格 = 挖掘，右键 = 封印（旗一次性承诺，无拔旗），悬停承载合法性反馈（可挖域微光 + BFS 路径点迹）；全仓无 InputEventKey/JoypadButton 处理，project.godot 无自定义 InputMap 动作。**可行性已核（2026-10-04）：可做**——分发接缝现成，board_view `action_requested(cell, kind)`（kind ∈ {dig, move, flag_place, flag_pull}）是唯一出口，键盘/手柄作第二输入前端产出同款信号即可，规则引擎合法性校验零改动（非法目标两条路径同拦）；Godot InputMap 原生支持键盘与手柄（十字键/摇杆）绑定同一动作，与鼠标并存不冲突。用户期望操作形态：十字方向移动；挖掘/封印各一独立键；方向控制选定 8 向挖掘或封印目标（斜向 = 双方向键组合）——8 向恰与现行可挖域（8 向相邻未开格）同集，十字移动与立绘 4 向既有裁决一致；键盘移动语义 = 逐格步进（现行点击 = 任意已开格 BFS 全程，逐格为等价交互变体）。连带设计点（实施批先裁）：① 键盘模式需屏上光标格承载现行悬停反馈（无鼠标 hover，合法性指示改挂光标）；② 键盘默认键位与手柄键位映射待定；③ 弹层界面（结算/三选一/商店/设置等）现行全鼠标，手柄全覆盖需焦点导航——本条范围 = 棋盘战斗操作，界面焦点导航是否同批待裁；④ 键位自定义是否进设置面待裁。 +**缺口**：还差 Beta 立项时的输入方案设计讨论——四个连带裁决点（光标反馈承载/键位映射/弹层焦点导航范围/键位自定义）先裁再开卡。 **归属**：[排雷玩法](systems/排雷循环/排雷玩法.md)（动作语义与 8 向目标规则主责）+ [HUD 框架](systems/表现与支撑/HUD框架.md)（键盘光标与合法性反馈呈现）+ [设置与本地化](systems/表现与支撑/设置与本地化.md)（键位自定义，可选面） -**状态**：待办——排期 **Beta 阶段**（2026-10-04 登记；可行性已核毕，立项时按 roadmap 开卡）。**2026-10-06 增补登记**：暂停层 Esc 快捷通道并入本条随键盘批统一实施（迭代 17 卡③暂停层批 P1 裁决=常驻角标本批落码、Esc 键不单独开通道；批出全屏弹层后本条③「弹层界面现行全鼠标」清单 +1 项=暂停层） +**状态**：待文档设计 -#### 技能池情境条件触发器 +#### 技能池情境条件触发器（2026-10-18 登记，来源=会话提及，设计面=文档轨） -**现状**：低血触发防御、玩家停手时的偷袭技等情境出招——载体 = 技能行触发条件字段（P1 字段位已预留）；启用是敌人系统修订，不是调参 +**现状**：低血触发防御、玩家停手时的偷袭技等情境出招——载体＝技能行触发条件字段（P1 字段位已预留）；启用是敌人系统修订，不是调参。（原条目无登记日期，按本批格式整改补登 2026-10-18。） + +**缺口**：还差敌人系统修订的设计讨论——情境触发器的条件形态、字段语义与首批触发器清单。 **归属**：[敌人系统](systems/战斗循环/敌人系统.md)（P1） -**状态**：待办 +**状态**：待文档设计 -#### 个体化变体池 +#### 个体化变体池（2026-10-18 登记，来源=会话提及，设计面=文档轨） -**现状**：A 型好斗 / B 型守势、精英专属池（技能池共识点 A 的 A2 案）；现行同敌种同池模板，实例分歧只来自摇号涌现 +**现状**：A 型好斗/ B 型守势、精英专属池（技能池共识点 A 的 A2 案）；现行同敌种同池模板，实例分歧只来自摇号涌现。（原条目无登记日期，按本批格式整改补登 2026-10-18。） + +**缺口**：还差敌人系统的变体池设计讨论——A2 案的池构成方案与精英专属池边界。 **归属**：[敌人系统](systems/战斗循环/敌人系统.md)（P1） -**状态**：待办 +**状态**：待文档设计 -#### 全局特殊间隔旋钮 +#### 全局特殊间隔旋钮（2026-10-18 登记，来源=会话提及，设计面=文档轨） -**现状**：异名特殊技背靠背现行概率低（是变化不是失控）；若实测仍嫌，备用闸 = 全局"特殊技后至少隔 N 拍"——登记备用，未实测不启用 +**现状**：异名特殊技背靠背现行概率低（是变化不是失控）；若实测仍嫌，备用闸＝全局「特殊技后至少隔 N 拍」——登记备用，未实测不启用。（原条目无登记日期，按本批格式整改补登 2026-10-18。） + +**缺口**：还差备用闸的条款设计（N 值与作用域）——仅当实测读数支持时才启动讨论。 **归属**：[敌人系统](systems/战斗循环/敌人系统.md) 与[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)（P1） -**状态**：待办 +**状态**：待文档设计（备选） -#### 第二关技能池与投放 +#### 敌方技能图鉴 / 学习呈现（2026-10-18 登记，来源=会话提及，设计面=文档轨） -**现状**：第二关生效前提 = 深度轴行值填齐（该前提已于 2026-09-17 分支节点图批满足——L2 图版行集落地）；池内容（新技能/新敌种池）随投放批定，投放节奏归难度曲线 +**现状**：池与权重不公开（D4/D5）口径下的进阶信息面——玩家侧技能知识系统（见过 → 认得 → 记谱）；首发三池学习成本低，后置（P2）。（原条目无登记日期，按本批格式整改补登 2026-10-18。） -**归属**：[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)（P1） - -**状态**：**已完成（2026-10-13，迭代 24 卡① N2）**——`skills.tres` 12→14 行：`venom_spit` 毒吐 ×1.6/CD2 挂 (2,5)/(2,6)/(2,7) 巨蜘蛛族、`shield_bash` 盾击 ×1.7/CD3 挂 (3,0)/(3,5)/(3,7) 灰矮人族（均无 rider、池权重 2；首遇教学位 (2,4) 池不动）；「独占技随关错峰只做在 Boss 侧」缺口补齐为两轨。`expect_pools` 六键契约同步、冒烟 949/0；难度带位移=改前改后同种子配对读数（perfect L2 通关 8→13/20 · 全通 6→10/20，方向符合预期、量级低于二档配对判读带，详见迭代 24 实现报告）；倍率 provisional 归 M4 数值批 - -#### 敌方技能图鉴 / 学习呈现 - -**现状**：池与权重不公开（D4/D5）口径下的进阶信息面——玩家侧技能知识系统（见过 → 认得 → 记谱）；首发三池学习成本低，后置 +**缺口**：还差玩家侧技能知识系统的呈现设计讨论（HUD 承载形态与记谱口径），P2 后置面。 **归属**：[HUD 框架](systems/表现与支撑/HUD框架.md) 与[敌人系统](systems/战斗循环/敌人系统.md)（P2） -**状态**：待办 +**状态**：待文档设计 -#### 第一关遭遇表数值异常——难度曲线倒挂与敌种疑似填错（2026-10-13 实查登记，Alpha 阶段需完成） +#### 削弱档位的最终数值（2026-09-18 登记，来源=会话提及，设计面=文档轨） -**现状**：来源 = playnote 用户试玩记录「第一关的第二个节点数值有问题」。2026-10-13 实查 `enemy.tres`（按 `(level_index, node_depth)` 索引），第一关五行如下： +**现状**：削弱取值域 [60,85] 与投值 −65 来自旧体系裁决；"标中旗必须比随便挖一格更值"的当量终值由[战斗结算](systems/战斗循环/战斗结算.md)与[地图战斗资源](systems/战斗循环/地图战斗资源.md)共裁。**语义侧已定案（2026-09-18 盘问会话，结构修复批落地）**：削弱叠层改续时——同名重复授予只刷新剩余结算数、层数恒 1（结构性消饱和）；现行表值为临时值（provisional）。已入 M4 数值批卡 v1.2 件①（duration 终值投定＋当量锚复算落文；含 β 带 [1.2,2.5] 可行子区间推算、flag_hit_premium=125 纳入同窗检算、`clear_dominance_audit.py` WEAKEN_PCT 常量随投值同步）；2026-10-05 裁点已全裁并经同日联审二裁修订（P1甲/P2甲/P3甲/P4甲），跑批待 U0 用户发令、发起前须用户批准。 -| 坐标 | 敌种 | hp | atk | 数量 | -|---|---|---|---|---| -| (1,0) | 地精 | 8 | 1 | 1–2 | -| (1,1) | 地精一伙 | 4 | 1 | 2–3 | -| (1,2) | 熊地精 | 50 | 1 | 1 | -| (1,3) | 大地精 | 14 | 1 | 2–3 | -| (1,4) | 食人魔酋长（关底 Boss） | 72 | 1 | 1 | +**归属**：战斗结算与地图战斗资源共裁（数值终值归状态层重设计批）——执行载体＝M4 数值批件① -三处异常：① **难度倒挂**——(1,1) 血量 4 低于前一节点 (1,0) 的 8；② **曲线不单调**——(1,2) 熊地精血量 50，是前一节点的 12.5 倍、下一节点大地精（14）的 3.6 倍、逼近关底 Boss（72）的七成，而 (1,3) 又跌回 14；③ **敌种疑似填错**——熊地精的正式位置是第二关的 (2,5) 混编遭遇行，出现在第一关第三个节点不合常理。 +**状态**：文档设计已闭合（design/research/需求卡片-M4数值批-2026-10-05.md v1.2）＋已写卡（design/research/需求卡片-M4数值批-2026-10-05.md） -**与 M4 数值批的区别（用户 2026-10-13 就此提问）**：M4 是「形状对、调大小」的全局数值统一标定；本条是**形状本身不对**，属配置错误级别，不是标定问题。等 M4 一并处理会让第一关的崩坏长期挂在 Alpha 里——玩家第一局就会撞上。 +#### 单体寻址的接口扩展位（2026-10-18 登记，来源=会话提及，设计面=文档轨） -**归属**：[敌人系统](systems/战斗循环/敌人系统.md)（遭遇表行值与敌种归属）+ [难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)（难度曲线单调性） +**现状**：对敌效果现行一律全体存活敌人共享一份层数；将来若要"只削弱其中一个"，需要给实例加目标寻址字段——扩展位已预留，首个单体效果上线时补列，并随之裁决归集与呈现语义。（原条目无登记日期，按本批格式整改补登 2026-10-18。） -**状态**：**已完成（2026-10-13，迭代 24 卡① N1）**——按需求卡片 Q1-Q3 裁定执行：取 **(1,2)**（实查确证的客观崩坏=总量 10→50 的 5 倍墙；「第二个节点」字面指向 (1,1) 的偏差按上文注记处置，(1,1) 不动）、定性换代为「2026-09-24 阶名化解方案实机未达预期，按 2026-10-13 体验反馈重裁」（非配置错误）、修法=**保留 bugbear 只降档** hp 50→22 · armor_class 3→2（其余字段零动；hobgoblin 无立绘故改敌种案否决）。曲线 12/10/22/35/72 相邻比最大 2.2（护栏断言入冒烟 V1，≤2.5）；修复方式甲（即时修，不依赖 M4）已兑现——其余行高低归 M4 数值批 - -**⚠ 措辞更正（2026-10-13 grilling 复核查证，随需求卡片成立一并订正，实现批执行）**：本条现状的**三处异常**中两处须改——①「敌种疑似填错」**定性作废**：`enemy.tres:594-600` 注释载明 (1,2) 的 bugbear 50 血是 **2026-09-24 用户裁决**保留的设计（当时解法=把 (1,3) 改名低一阶的「大地精」，用 DND 阶名化解同族血量倒挂的观感），不是配置错误，本批定性改为「该阶名化解方案在 2026-10-13 实机验证下未达预期，按体验反馈重裁」；②「难度倒挂」一条**撤回**：(1,1) 地精一伙 hp4 按总量算（4×2.5=10）与 (1,0)（8×1.5=12）持平，属群怪「单只薄、数量补」的正常设计。③「第二个节点」字面指向的登记偏差：[playnote](../research/playnote.md):9 原文「第一关的第二个节点数值有问题」，而 `level.tres` 注释明载 L1 前三位恒为纯战斗，按字面计数第二个战斗节点 = **(1,1)** 而非本条登记的 (1,2)；本条按实查确证的客观崩坏取 (1,2)（总量 10→50 的 5 倍墙），(1,1) 不动——若原意确为 (1,1) 需重裁。 - -#### 敌人表内容修批（三关）—— 需求卡片登记（2026-10-13，防遗忘） - -**卡片名**：敌人表内容修批（三关）；**文件指针**：[需求卡片-敌人表内容修批-2026-10-13](../research/需求卡片-敌人表内容修批-2026-10-13.md)（v1.1，Q1–Q9 已全裁，零待裁点，开工门＝U0） - -**内容**：三件事合一——① **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 反哺点五条（下条，待用户裁决另批写入文档） - - -#### 迭代 24 敌人表内容修批——GDD 反哺点五条（2026-10-13 顺带登记，待用户逐点裁决另批写入文档） - -**来源**：迭代 24 实现报告 §六（已退役，git 历史可考；设计权威文档零触碰——2026-10-10 立规：文档更新必须经用户同意）。 - -| # | 文档 | 反哺点 | -|---|---|---| -| ① | [敌人系统](systems/战斗循环/敌人系统.md) | 调参表敌人表字段集需增 `attack_type`（枚举域 {normal, pierce, magic}/缺省 normal/消费面=敌方技兑付查矩阵） | -| ② | [敌人系统](systems/战斗循环/敌人系统.md) | 技能池节「三代错峰」口径需扩为「Boss 独占技 + 普通敌错峰」两轨（N2 已补齐普通敌轨） | -| ③ | [敌人系统](systems/战斗循环/敌人系统.md) | 敌种表技能池构成列随 N2 变动（巨蜘蛛族+毒吐、灰矮人族+盾击） | -| ④ | [敌人系统](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）。报告 §六已逐条标注落点 - -#### 迭代 25 UI 全局主题批——GDD 反哺点（2026-10-14 补登——前序批次漏登；iter24/26 同款专条模式，待用户逐点裁决另批写入文档） - -**来源**：迭代 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」不存在）——卡片已退役归档不修订，订正只随实现报告留痕，**无写入文档动作**。 -- **反哺点④（主题色值双处存在）**：`.tres` 字面量与 ui_kit 常量双源（卡片立项时已知代价，README 溯源表缓解）——长期是否将主题色值收敛回代码单点（程序化 Theme 生成）待裁。 -- 〔附〕反哺点⑤=专项观察点二（滑轨柄 CANDLE 抢焦点/滚动条槽可见性）归用户目检，已登记 07 ㉔，非写入文档项。 - -**归属**：[美术圣经](../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 ㉔ 目检（已核销） - -#### 削弱档位的最终数值 - -**现状**：削弱取值域 [60,85] 与投值 −65 来自旧体系裁决；"标中旗必须比随便挖一格更值"的当量终值由[战斗结算](systems/战斗循环/战斗结算.md)与[地图战斗资源](systems/战斗循环/地图战斗资源.md)共裁，尚未闭合。**语义侧已定案（2026-09-18 盘问会话，结构修复批落地）**：削弱叠层改续时——同名重复授予只刷新剩余结算数、层数恒 1（结构性消饱和，×2 叠满池触底 ×0 的免伤轮从根杜绝）；现行表值为临时值（provisional），duration 终值与当量锚复算归状态层重设计批 - -**归属**：战斗结算与地图战斗资源共裁（数值终值归状态层重设计批） - -**状态**：待办（语义已定案，数值未闭合）——**已编入 Alpha 收官 M4 数值批〔未排期，2026-10-07 用户令移出迭代 18 暂不启动〕〔2026-10-06 用户令自迭代 17 卡②移出——不影响 17 正在执行中的开发〕（2026-10-05——裁点已全裁并经同日联审二裁修订：P1甲〔带内落定随出口追认〕/P2甲/P3甲〔转正顺延至重扫读数到账且带内〕/P4甲〕待 U0：design/research/需求卡片-M4数值批-2026-10-05.md〔v1.2〕；duration 终值与当量锚复算 = 件①，跑批发起前须用户批准）** - -#### 单体寻址的接口扩展位 - -**现状**：对敌效果现行一律全体存活敌人共享一份层数；将来若要"只削弱其中一个"，需要给实例加目标寻址字段——扩展位已预留，首个单体效果上线时补列，并随之裁决归集与呈现语义 +**缺口**：还差首个单体效果上线时的归集与呈现语义设计讨论与字段补列方案。 **归属**：增益状态（首个单体效果上线时顺带） -**状态**：待办 +**状态**：待文档设计（备选） -#### 空刷新的可见性 +#### 空刷新的可见性（2026-10-18 登记，来源=会话提及，设计面=文档轨） -**现状**：刷新类策略在剩余次数已满时再授予是合法空操作（返回成功、无任何变化），与"溢出不静默吞"的诚实原则存在张力；MVP 无刷新类内容行，首批刷新行上线时顺带裁决 +**现状**：刷新类策略在剩余次数已满时再授予是合法空操作（返回成功、无任何变化），与"溢出不静默吞"的诚实原则存在张力；MVP 无刷新类内容行，首批刷新行上线时顺带裁决。（原条目无登记日期，按本批格式整改补登 2026-10-18。） + +**缺口**：还差首批刷新行上线时的空刷新语义裁决（提示形态与诚实原则的平衡）。 **归属**：增益状态（首批刷新行上线时顺带） -**状态**：待办 +**状态**：待文档设计（备选） -#### 冒险前资源配比预设（构筑提案） +#### 冒险前资源配比预设（构筑提案）（2026-09-18 登记，来源=会话提及，设计面=文档轨） -**现状**：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)——相邻：预读类道具读取身份查询面，配比改变分布先验后「资源预读与推理的边界」读感联动，不做机制耦合。 -- 战斗循环：[地图战斗资源](systems/战斗循环/地图战斗资源.md)——主战场：候选集合权重来源从纯表值扩为「表值 × 玩家覆盖」；基础配比是整体平移分布，「危险格与安全格同池」（同池同分布）语义不破，不动结构冻结；[战斗结算](systems/战斗循环/战斗结算.md)——唯一调用方：摇号入口需受理开局注入的权重覆盖，兑付编排零改动；[增益状态](systems/战斗循环/增益状态.md)——零改动（percent 行效果引用不变，配比只改触发频率不改状态语义）；[敌人系统](systems/战斗循环/敌人系统.md)——间接：各关敌种构成是配比预测的对象，混编遭遇行集的走向影响配比博弈读数。 -- 冒险循环：[元进度](systems/跨局循环/元进度.md)——配比能力的家：可用类型 / 预算点数 / 预设槽位走营地柜台解锁，配比预设 = 覆盖值通道的又一生产者；[冒险结构](systems/冒险循环/冒险结构.md)——冒险开始参数面扩容，配比覆盖域的字段语义待裁；[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)——杠杆主权转移：设计者从「定权重」改为「定预算包络、玩家在包络内分配」，通关率验收带随配比漂移，切片与验收期必须锁默认权重；[关卡节点地图](systems/冒险循环/关卡节点地图.md)——关卡特殊资源与节点奖励（功能道具渠道）的分工须一次说清：特殊资源走图内格面池差异化，功能道具走节点奖励，两渠道不混。 -- 表现与支撑：[HUD 框架](systems/表现与支撑/HUD框架.md)——新增构筑界面（冒险前的配比设置面）与配比效果的局内可读呈现；[教学引导](systems/表现与支撑/教学引导.md)——新增「读敌配比」教学口径；[数据配置](systems/表现与支撑/数据配置.md)——配比预设存档域与预算参数表建账，registry 新条目；[存档序列化](systems/表现与支撑/存档序列化.md)——预设档契约域顺带登记（与元进度存档四件同批）。 - -**依赖（本提案依赖谁）**：① 冒险开始参数面 + 覆盖值通道（[元进度](systems/跨局循环/元进度.md) v1.0 已定稿口径，现成）；② 八型候选集合与权重语义（[地图战斗资源](systems/战斗循环/地图战斗资源.md) v0.14 现行结构）；③ board_biome 词表定稿（[棋盘生成](systems/排雷循环/棋盘生成.md)，关卡特殊资源的前置）；④ 数据配置表承载与存档域（预设持久化）；⑤ 元进度解锁状态（可用配比容量）。 - -**被依赖（谁会依赖本提案）**：HUD 构筑界面呈现；教学新口径；难度曲线与Boss 验收判读口径（配比包络下的通关率带复算，换算率表强条目纪律同类）；行动经济对账窗口；registry 与架构概念图的结构登记（新节点落地时 archify 图须重交付）。 - -**开放问题（立项前裁决）**〔五问已全裁（2026-10-04 用户令「拍板点全部使用推荐」），裁决结论见状态行与提案-冒险前资源配比预设-2026-10-04.md §九；下文为裁决前登记留痕〕：① **预算机制**——自由滑条必出支配策略（全拉穿刺 + 魔法〔必中克制直伤〕大概率唯一解，构筑空间反死），候选 = 点数总预算 / 每型上限 / 配比槽位本身当解锁内容——最大设计题；② **杠杆主权切分**——切片与验收期锁默认权重（测量保护），正式期「设计者定包络、玩家分配」的参数归属；③ **与永久强化的分工**——配比容量（可用类型/点数/槽位）映射到营地三柜台哪几个；④ **基础配比的注入语义**——权重覆盖走数值覆盖还是集合操作（追加/替换），参数面字段裁决；⑤ **关卡特殊资源与功能道具渠道的边界**——图内格面池差异化与节点奖励不混池的口径。 - -**前置**：① 验收批读数重测与真人试玩先跑——配比博弈的核心未知数（玩家配比是否收敛到唯一解、分布先验怎么被利用）只有真人数据能回答；② 当前批序列走完：本批审批 → 验收重测 → 曲线调参 → 秘宝内容批。〔原前置③「立项时与差异化批合并评估——同一冻结面一批做省一次修订流程」随差异化批否决退役（2026-10-04）——配比预设转独立立项评估〕 +**现状**：2026-09-18 用户提案，方向评估通过，登记在案。核心想法＝玩家在**开始冒险前**预设地图战斗资源的类型配比——预设的是**分布**（九型格面池的正向权重占比；2026-10-04 立项裁决批口径 gp 型入池成九型，正向权重合计 77），不是落位：装板摇号仍按专属随机流摇出各格类型身份，玩家定分布、摇号定落位（与既定随机性立场相容）。两分法：① **基础资源配比**——正向行权重经覆盖值通道在开局注入；② **关卡特殊资源**——不同关卡（board_biome 图主题）携带配比池之外的特殊资源与差异化分布。设计红利＝危险格与安全格同池＋极性矩阵使配比自带代价轴（调高某型权重，安全格正向与危险格负向同步变多），不是免费午餐；注入通道＝[元进度](systems/跨局循环/元进度.md) v1.0 已定稿的「冒险开始参数面与覆盖值通道」，零新机制；②正是[棋盘生成](systems/排雷循环/棋盘生成.md) board_biome 上下文与[地图战斗资源](systems/战斗循环/地图战斗资源.md)差异化插槽的启用场景。**八项裁决已全裁（2026-10-04 用户令「拍板点全部使用推荐」）**：①预算＝组合制（总量挪点为骨架〔总和恒 77〕＋每型上下限包络＋容量随营地解锁渐进〔gp 首发不可调/预设档 3 套/下限 >0〕）；②主权＝设计者定包络与默认、玩家包络内分配（验收＝默认分布锚＋极端构筑护栏带）；③容量柜台＝奖励格图鉴承接；④注入语义＝差值向量（存相对默认偏移 ΣΔ=0，集合操作保留在解锁层作辅语义）；⑤渠道边界＝清图槽差异化先行＋三句不混池口径；盘问轮四裁随落（合成序＝表值→玩家配比差值→包络钳制→图级变异偏斜→同调硬币偏置；图鉴柜台逐型商品；冒险开始锁档；包络宽度随容量分级放宽）。全案与淘汰依据原载提案 §八/§九/§十（该提案文件已随吸收即死退役，git 历史可考；需求卡片冻结在档）。影响面/依赖/被依赖清单原载本条（排雷/战斗/冒险/表现四循环十余文档指针），重启时自 git 历史取全文本。**挂起（2026-10-05 用户令）**：移出 roadmap 迭代 14（⑥号卡撤销）——暂不做，本条保留为挂起待办；八项裁决与需求卡片全部冻结保留（需求卡片文件头已挂冻结横幅）；重启须用户另行发令。 **归属**：[地图战斗资源](systems/战斗循环/地图战斗资源.md)修订批（基础配比的权重覆盖语义 + GDD 修订）与[元进度](systems/跨局循环/元进度.md)（解锁容量与注入生产者）共裁；呈现面归[HUD 框架](systems/表现与支撑/HUD框架.md)与[教学引导](systems/表现与支撑/教学引导.md)顺带。 -**状态**：已裁待实施（2026-10-04 立项提案五拍板点全按推荐落定〔用户令「拍板点全部使用推荐」〕——①预算机制 = 组合制：总量挪点为骨架〔九型正向权重总和恒 77，拉高某型必以压低别型为代价，全押穿刺+魔法算术不可达〕+每型上下限包络+容量随营地解锁渐进〔三子裁随裁：gp 首发不可调〔包络 (2,2) 恒定〕/预设档位 3 套/下限 >0〕；②主权切分 = 设计者定包络与默认、玩家包络内分配，验收 = 默认分布锚〔现行四带权威读数不动〕+新增极端构筑护栏带；③容量柜台 = 奖励格图鉴承接〔随 A3 否决空置的柜台得正业〕；④注入语义 = 差值向量〔存相对默认偏移 ΣΔ=0，与偏运硬币同一摇号前权重合成层，关态逐位零扰动〕，集合操作保留在解锁层〔可调型集扩容〕作辅语义；⑤渠道边界 = 清图槽差异化先行 + 三句不混池口径〔板图分工/配比域封闭/格型无差——不按危险格安全格分的 A3 红线沿用〕。全案与淘汰依据 = design/research/提案-冒险前资源配比预设-2026-10-04.md §八备选全列 + §九裁决记录 + §十盘问轮四裁。盘问轮四裁随落（2026-10-04 全按推荐：合成序 = 表值→玩家配比差值→包络钳制→图级变异偏斜→同调硬币偏置〔包络只管玩家差值，提案 §6.3 原草图废止〕/图鉴柜台逐型商品/冒险开始锁档〔关间换档后置评估〕/包络宽度随容量分级放宽）。**已编入 roadmap 迭代 14 ⑥号卡（2026-10-04 用户令）**，需求卡片=design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md（T0-T8≈6.0d 两段切分；开工门=②③号卡出口；零新拍板点，provisional 归出口追认）——序位在②③后（合成序扩参与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点）；包络数值 provisional 起步，待真人读数与②号新当量账双锚校准；需求卡片待起草（估时随需求卡片）。原「实施窗口 = Alpha」随编卡改迭代 14。原「与差异化批合并立项」随差异化批否决退役〔2026-10-04〕）。**挂起（2026-10-05 用户令）**：移出 roadmap 迭代 14（⑥号卡撤销）——暂不做，本条目在 06 保留为挂起待办；八项裁决与需求卡片全部冻结保留（需求卡片=design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md，文件头已挂冻结横幅）；原开工门「②③号卡出口」随挂起冻结——重启须用户另行发令，届时若②判式换代与③全局变异已合并进 master 则开工门自然解（合成序与包络数值锚仍依赖两者的摇号投影点） +**状态**：文档设计已闭合（八裁全落零拍板点，机制依赖面=元进度.md v1.0「冒险开始参数面与覆盖值通道」）＋已写卡（design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md）（备选） -#### GP 经济换算失衡——GP 袋面值与商店价格的换算关系复查（2026-10-07 登记） +#### GP 经济换算失衡——GP 袋面值与商店价格的换算关系复查（2026-10-07 登记，来源=审计发现，设计面=文档轨） -**现状**：道具三层审查的换算发现——小 GP 袋 20 ≈ 商店两三次首购（首购基价 4-5、A 链爬升前）≈ +2~4 点属性，而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算，且 GP 袋是池内最大户（23/98 张）进一步放大倾向。用户判「太离谱」。复查范围 = GP 袋面值（20/50）× 商店基价（4/4/4/5）× 价格曲线（A=1.8 / b=1.1）× 战斗 GP 掉落（普通 3 / 精英 5 / Boss 8，关级加值 0/1/2）四处联动；目标 = 钱与属性件的换算效率回到设计意图（拿钱 vs 拿数值的取舍成立；GP 袋最大户地位要么有理由要么让位）。连带前提：L1 无商店节点使 GP 在第一关无消费口（「L1 商店编排」不另立条目、归本条〔GP 经济换算失衡〕复查范围）——复查时按 L1 是否补商店分两种情形各算一遍。 +**现状**：道具三层审查的换算发现——小 GP 袋 20 ≈ 商店两三次首购（首购基价 4-5、A 链爬升前）≈ +2~4 点属性，而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算，且 GP 袋是池内最大户（23/98 张）进一步放大倾向。用户判「太离谱」。复查范围＝GP 袋面值（20/50）× 商店基价（4/4/4/5）× 价格曲线（A=1.8 / b=1.1）× 战斗 GP 掉落（普通 3 / 精英 5 / Boss 8，关级加值 0/1/2）四处联动；目标＝钱与属性件的换算效率回到设计意图（拿钱 vs 拿数值的取舍成立；GP 袋最大户地位要么有理由要么让位）。连带前提：L1 无商店节点使 GP 在第一关无消费口——「L1 商店编排」不另立条目、归本条复查范围（按 L1 是否补商店分两种情形各算一遍）。随 M4 数值批一并裁决；本条登记（2026-10-07）晚于 M4 卡 v1.2 定稿（2026-10-06），尚未入卡范围，跑批前须并入或随批呈报。 + +**缺口**：还差四处联动的换算复查设计（含 L1 商店编排两种情形）——随 M4 数值批窗口执行，尚未入卡。 **归属**：[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)调参批（M4 数值批）+ 奇物池结构顺带 -**状态**：待办（随 M4 数值批一并裁决；「L1 商店编排」不另立条目、其情形复查并入本条〔GP 经济换算失衡〕，无外部前置） +**状态**：待文档设计 -#### 迭代 10 奖励重构联动欠账（2026-10-01 登记） +#### 迭代 10 奖励重构联动欠账（2026-10-01 登记，来源=批次移交，设计面=文档轨） -**现状**：迭代 10 奖励重构批（worktree 分支 m3-iter10-20261001，不合入 master、渲染层验证冻结，待用户批准合并）落地面产生三条后续义务——①钥石产出重标：渠道改「Boss/精英击杀掉落」（大奖励 keystone_per_level 退役、boss_keystone 重锚首杀 3/复杀 2 provisional），现行元进度产出结构作废，标定义务重开；②通关率带重扫：通关回血 20%（血回满→部分回血，难度上压方向）+ 三选一件值/权重/次数上限 knob（AP 件 = 每场战斗首轮 +1 AP 强度敏感轴）——难度曲线与Boss P1 行已登记；③同调位读数源切换：本批挂过渡键 transitional_sync_slots（provisional 1），同调实施批落地后切换为 attunement_growth.tres 谓词表实时求值，切换注记随该批。〔③已清偿（2026-10-03 迭代 11 第①批 T7：过渡键表/schema/断言三处退役，读取点归零，呈现与求值现行事实源=Attunement.slots 谓词表实时求值）；①②仍开放〕 +**现状**：迭代 10 奖励重构批（worktree 分支 m3-iter10-20261001）落地面产生三条后续义务——①钥石产出重标：渠道改「Boss/精英击杀掉落」（大奖励 keystone_per_level 退役、boss_keystone 重锚 provisional），现行元进度产出结构作废，标定义务重开；②通关率带重扫：通关回血 20%（血回满→部分回血，难度上压方向）+ 三选一件值/权重/次数上限 knob（AP 件＝每场战斗首轮 +1 AP 强度敏感轴）；③同调位读数源切换——**已清偿（2026-10-03 迭代 11 第①批 T7**：过渡键表/schema/断言三处退役，读取点归零，现行事实源＝Attunement.slots 谓词表实时求值）。①②已入 M4 数值批卡 v1.2 件③（F7/F8；通关率带重扫与 T6 四带复算并账、一次跑批双认账），跑批待 U0 用户发令、发起前须用户批准。 -**归属**：①元进度设计批 + 曲线调参批 ②曲线调参批（现行窗） ③~~秘宝同调实施批~~（已清偿 2026-10-03） +**归属**：①元进度设计批 + 曲线调参批 ②曲线调参批（现行窗） ③秘宝同调实施批（已清偿 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；钥石产出重标 + 通关率带重扫 = 件③，跑批发起前须用户批准）** +**状态**：文档设计已闭合（design/research/需求卡片-M4数值批-2026-10-05.md v1.2）＋已写卡（design/research/需求卡片-M4数值批-2026-10-05.md） -#### 调参批数值点评登记（八型批顺带登记） +#### 调参批数值点评登记（2026-10-01 登记，来源=批次移交，设计面=文档轨） -**现状**：格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 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 未由用户明令关闭前不排期——原「下一迭代数值批」表述作废）；标错/开雷同档同罚维持不动（同批裁）。 +**现状**：格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 50/25 不对称是否有意；② 削弱型 65/25 同问（且 percent 套个位数取整偏粗）；③ 回血奖励过薄（值 1、权重全池最低 2）；④ 警觉/行动点修正两新词数值全部 provisional；⑤ 行动经济"满停一轮＝一刷"节拍在 AP±1 修正下的对账——①-⑤五条已入 M4 数值批卡 v1.2 件②（F5，逐条裁决落文）；⑥ **格面资源正负兑付倍率差回调（2026-10-07 用户裁）**——2026-10-01「踩雷必须痛」抬档（heal +2/−6、pierce/magic +2/−8 等，负向 3-4 倍于正向）系错误的加难杠杆：难度提升应走怪物性能路线而非抬地图惩罚，回调归 M4 数值批，标错/开雷同档同罚维持不动（同批裁）——⑥成裁晚于卡 v1.2，尚未入卡，跑批前须并入或随批呈报。里程碑立规（2026-10-09）：M4＝Beta 阶段、M3 未由用户明令关闭前不排期。 **归属**：[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)难度曲线调参批 -**状态**：待办（随调参批一并裁决）——**已编入 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；六条点评逐条裁决 = 件②）** +**状态**：文档设计已闭合（design/research/需求卡片-M4数值批-2026-10-05.md v1.2）＋已写卡（design/research/需求卡片-M4数值批-2026-10-05.md） -#### 成长系数与关卡怪物难度提升的节奏（2026-10-16 playnote 登记；同日用户定性＝数值校准类） +#### 成长系数与关卡怪物难度提升的节奏（2026-10-16 登记，来源=playnote，设计面=文档轨） -**现状**：来源 = playnote 用户反馈「一开始不能让角色的成长系数太高。比如在没经过升级之前，你的成长系数是跟不上关卡怪物难度提升的；但是后续能力解锁之后，成长系数才能匹配得上」。语义两读，去向不同：**读法甲＝节奏缺陷呈报**——前期成长跟不上怪物难度提升＝要修的数值节奏问题，归属 [难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md) ＋元进度解锁节奏的数值面，M4 数值批已废后并入数值欠账组重新归属待裁；**读法乙＝设计哲学陈述**——前期成长刻意克制、后期靠能力解锁追平＝既定设计，应反哺难度曲线与 Boss 的设计语义，无需数值批。 +**现状**：来源＝playnote 用户反馈「一开始不能让角色的成长系数太高。比如在没经过升级之前，你的成长系数是跟不上关卡怪物难度提升的；但是后续能力解锁之后，成长系数才能匹配得上」。语义两读：**读法甲＝节奏缺陷呈报**（前期成长跟不上怪物难度提升＝要修的数值节奏问题，归属难度曲线与Boss＋元进度解锁节奏的数值面）；**读法乙＝设计哲学陈述**（前期成长刻意克制、后期靠能力解锁追平＝既定设计，应反哺难度曲线的设计语义）。2026-10-16 用户定性＝数值校准类、与数值欠账同类任务，甲/乙两读随定性消解（无论现行节奏好坏，调它都是数值校准面的事）；不进 [08-Alpha版本标准](08-Alpha版本标准.md)（数值调优义务 2026-10-16 v1.6 起不入版本标准）；按里程碑立规属 Beta 阶段面，Alpha 不排期；并入数值欠账组随组重新归属（M4 卡 v1.2 未收此件）。 + +**缺口**：还差并入数值欠账组的归属落位（Beta 阶段数值校准窗口处理）。 **归属**：[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md) + [元进度](systems/跨局循环/元进度.md)（成长系数语义面） -**状态**：已定性（2026-10-16 用户口径：与数值欠账同类任务）——并入数值欠账组随组重新归属（按里程碑立规属 Beta 阶段面，Alpha 不排期）；甲 / 乙两读随定性消解（无论现行节奏好坏，调它都是数值校准面的事），不进 [08-Alpha版本标准](08-Alpha版本标准.md)——数值调优义务 2026-10-16 v1.6 起不入版本标准 +**状态**：待文档设计 -#### 「封锁-蓄力」combo 设计素材（2026-10-07 用户想法登记） +#### 「封锁-蓄力」combo 设计素材（2026-10-07 登记，来源=会话提及，设计面=文档轨） -**现状**：用户想法（暂不立件，素材登记）——两件套：件一=抬高刷新雷图代价（储备池 RAP 成本飙高）+ 刷新时解锁所有格子（全板开）；件二=本回合留着 AP 没有刷新 → 获得减伤。联动 = 抬价逼留 AP、留 AP 给减伤、憋够一发全板解锁。我方补充登记五点：①形态骨架=「封锁-蓄力」combo 结构（抬高某动作代价封路 + 不做给补偿 + 憋到后的爆发）；②件一=风险契约句式的扫雷侧版——碰撞点待裁：刷新开全板与清图判定/清图奖励/连锁展开的关系（算不算清图、发不发清图奖励）；③件二词表可承载（on round_end when 本轮未刷新且余 AP≥X → 减伤/护盾），「本轮未刷新」事实=扩签候选；④归层按判定尺逐件裁（两件偏机制改写→专长域；但「刷新代价」是扫雷侧经济参数→秘宝域亦可）；⑤防躺赢注记：憋的收益须小于正常挖格期望（否则最优解=永远不挖，玩法塌缩）。 +**现状**：用户想法（暂不立件，素材登记）——两件套：件一＝抬高刷新雷图代价（储备池 RAP 成本飙高）+ 刷新时解锁所有格子（全板开）；件二＝本回合留着 AP 没有刷新 → 获得减伤。联动＝抬价逼留 AP、留 AP 给减伤、憋够一发全板解锁。我方补充登记五点：①形态骨架＝「封锁-蓄力」combo 结构（抬高某动作代价封路 + 不做给补偿 + 憋到后的爆发）；②件一＝风险契约句式的扫雷侧版——碰撞点待裁：刷新开全板与清图判定/清图奖励/连锁展开的关系（算不算清图、发不发清图奖励）；③件二词表可承载（on round_end when 本轮未刷新且余 AP≥X → 减伤/护盾），「本轮未刷新」事实＝扩签候选；④归层按判定尺逐件裁（两件偏机制改写→专长域；但「刷新代价」是扫雷侧经济参数→秘宝域亦可）；⑤防躺赢注记：憋的收益须小于正常挖格期望（否则最优解＝永远不挖，玩法塌缩）。 + +**缺口**：还差立项裁决（暂不立件）——若立项，先裁碰撞点与归层，再走机制设计讨论。 **归属**：专长重设计扩充批 / 秘宝内容批（归层顺带裁） -**状态**：待办（设计素材登记，不立项） +**状态**：待文档设计（备选） -#### 袋装摇号（格面资源池结构备选——保底型增多后的重构方向）（2026-10-07 登记） +#### 袋装摇号（格面资源池结构备选——保底型增多后的重构方向）（2026-10-07 登记，来源=会话提及，设计面=文档轨） -**现状**：地图战斗资源池保底结构（四档概率 + 按型保底 + 档位保底上限，现行事实源=[地图战斗资源](systems/战斗循环/地图战斗资源.md)候选集合节）以「摇完整板校验补签」的补丁式实现起步——简单够用。备选正规形态 = **袋装摇号**：装板时按各档配额数好牌再洗开发放，保底天然成立、分布精确；代价 = 摇号结构重写 + 偏运硬币/board_skew 两路权重投影须改为袋面投影。启用条件 = 保底登记型增多、补签逻辑复杂化时。来源 = 2026-10-07 地图层题四讨论，用户裁「先挂在 06」。 +**现状**：地图战斗资源池保底结构（四档概率 + 按型保底 + 档位保底上限，现行事实源＝[地图战斗资源](systems/战斗循环/地图战斗资源.md)候选集合节）以「摇完整板校验补签」的补丁式实现起步——简单够用。备选正规形态＝**袋装摇号**：装板时按各档配额数好牌再洗开发放，保底天然成立、分布精确；代价＝摇号结构重写 + 偏运硬币/board_skew 两路权重投影须改为袋面投影。启用条件＝保底登记型增多、补签逻辑复杂化时。来源＝2026-10-07 地图层题四讨论，用户裁「先挂在 06」。 + +**缺口**：还差启用条件触发后的摇号结构重写设计讨论（含两路权重投影改袋面投影的方案）。 **归属**：[地图战斗资源](systems/战斗循环/地图战斗资源.md)（重评归该层内容批或数值批窗口） -**状态**：待办（挂号备查，未排期） +**状态**：待文档设计（备选） -#### 战斗节点地图类型差异化（更多地图主题）——排 Beta（2026-10-13 用户裁定） +#### 战斗节点地图类型差异化——更多地图主题（2026-10-13 登记，来源=playnote，设计面=文档轨） -**现状**：来源 = playnote 用户试玩记录「修改地图的奖励类型：战斗节点增加不同的地图类型，比如有些图踩雷受到更多的伤害，有些图标雷可以造成更多的伤害，有些图伤害会减半需要凑更多清图奖励（这些都是暂时的设定）」。 +**现状**：来源＝playnote 用户试玩记录「修改地图的奖励类型：战斗节点增加不同的地图类型，比如有些图踩雷受到更多的伤害，有些图标雷可以造成更多的伤害，有些图伤害会减半需要凑更多清图奖励（这些都是暂时的设定）」。**已实装的部分**：首发形态整图变异「贫矿脉」已于 2026-10-16 用户令屏蔽删行（Boss 图回落 region 变异，原 07⑪ 目检项随之转记失效）——本条剩余面不变：在此之上再做**更多地图主题**（踩雷伤害更高/标雷伤害更高/伤害减半需凑更多清图奖励）。**2026-10-13 用户裁定：排 Beta 版本，Alpha 不做**——已移入 [08-Alpha版本标准](08-Alpha版本标准.md)「六 · Alpha 不含」节。 -**已实装的部分**：首发形态整图变异「贫矿脉」（回复与护甲资源减少、攻击资源增多）**已于 2026-10-16 用户令屏蔽删行**（Boss 图回落 region 变异，原 07 ⑪ 目检项随之转记失效）——本条剩余面不变：在此之上再做**更多地图主题**（踩雷伤害更高 / 标雷伤害更高 / 伤害减半需凑更多清图奖励）。 - -**2026-10-13 用户裁定**：**排 Beta 版本，Alpha 不做**——已移入 [08-Alpha版本标准](08-Alpha版本标准.md)「六 · Alpha 不含」节。 +**缺口**：还差 Beta 立项时的地图主题设计讨论——按本条原始想法重新评估（用户标注「这些都是暂时的设定」，到时需重订而非照抄）。 **归属**：[棋盘生成](systems/排雷循环/棋盘生成.md)（board_biome 图主题词表）+ [地图战斗资源](systems/战斗循环/地图战斗资源.md)（图主题差异化插槽）+ [地形变异](systems/排雷循环/地形变异.md)（整图变异承载面） -**状态**：待办（**Beta 阶段**，Alpha 不做）——重启 = Beta 立项时按本条原始想法重新评估（用户标注「这些都是暂时的设定」，到时需重订而非照抄） +**状态**：待文档设计 -#### 基线通关率越带，加难杠杆扫描未执行 +#### 基线通关率越带，加难杠杆扫描未执行（2026-09-18 登记，来源=审计发现，设计面=文档轨） -**现状**：现行扫描读数 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-17 带 [10,25]；2026-09-20 重投基线批后分带修正为 L1 [35,55] / L2 [25,45]，旧带失锚作废）——**新带下普通档双关落带、完美档 56%/40% 亦落带，加难紧迫性解除**。C1 终态已落表（2026-09-29 返工批：占比回退 5+plb 0+岩浆 1；U2 裁断 b 项推翻 C3 四件组合裁 **C1 两刀**〔岩浆 effect_value 2→1+逐层变异基数 2→0；变异占比维持 5%、卓尔血维持 130〕，a 项甲＝新杠杆授权〔完美 L1 89% 挂账废止，归难度曲线与Boss.md 带换代节承接〕；U2 裁断全录见 git 提交 f9c1a8a）。剩余面＝调参批的行值 provisional→正式扫描义务（门＝真人批 k 系数）；新增调参杠杆位＝变异 effect_value（荆棘丛 1 / 岩浆 2）与 percent_of_cells（5%）/ per_level_bonus（+2/关），扫描时与既有三类杠杆（血量锚走廊 r_boss [1.1, 1.35]〔2026-09-17 注：数值压缩批后 Boss 生命已 ÷3 缩水，180–207 为压缩前基线锚，复算随调参批〕、群战上探、注入衰减 0.5 → 0.6）合并比较；落带前全部现行行值维持 provisional-pending-scan。 + +**缺口**：还差真人批 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 +**状态**：待文档设计（备选） -#### 三方向各自的解锁清单与定价 +#### 三方向各自的解锁清单与定价（2026-09-21 登记，来源=审计发现，设计面=文档轨） -**现状**：三方向各自的解锁清单与定价：多少钥石换什么，属性、遭遇、道具池各自怎么铺。来源：元进度 待设计问题清单第 2 条 +**现状**：三方向（属性、遭遇、道具池）各自的解锁清单与定价：多少钥石换什么，各自怎么铺。来源＝元进度 待设计问题清单第 2 条。部分完成（2026-09-21 元进度实现批再收窄；2026-09-23 换算率标定批再收窄）——**三柜台结构与 provisional 定价已落地**（属性锻造三档血+3/攻+1/甲+1、Boss 两档、工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`）；换算率三行已投值 6/9/1（冒险条件口径实测，护甲行强条目重测履行）。剩余面＝定价数字与 Boss 两档终值——已入 M4 数值批卡 v1.2 件④（F11/F12；含 06 死文本两句全刷义务：「base 10 公比 150」滞后〔meta.tres 现行 forge base_price=20，2026-09-22 数值设计批对齿〕与「Boss 两档 L1 5/1·L2 8/2·L3 12/3」死数字句〔现值首杀 3/3/3 · 复杀 2/2/3〕，T4 判据按两句全刷执行）。 **归属**：元进度设计批 -**状态**：部分完成（2026-09-21 元进度实现批再收窄；2026-09-23 换算率标定批再收窄）——**三柜台结构与 provisional 定价已落地**（属性锻造三档血+3/攻+1/甲+1、base 10 公比 150；Boss 两档 L1 5/1·L2 8/2·L3 12/3；工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`）；换算率三行已投值 6/9/1（同批，冒险条件口径实测，护甲行强条目重测履行）；剩余面 = 定价数字与 Boss 两档——**已编入 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；定价数字与 Boss 两档终值 = 件④。注：本条「base 10 公比 150」文本滞后——meta.tres 现行 forge base_price=20（2026-09-22 数值设计批对齿 10→20），随件④完成时刷新）** +**状态**：文档设计已闭合（design/research/需求卡片-M4数值批-2026-10-05.md v1.2）＋已写卡（design/research/需求卡片-M4数值批-2026-10-05.md） -#### 解锁界面与钥石呈现的交互形态（残余：状态面板〔原暂停层〕只读入口） +#### 卡顶色带与格面微光两带统一（2026-10-17 登记，来源=批次移交，设计面=工程直入） -**现状**：视觉终稿半已兑现——营地界面视觉终稿随 M-3 迭代 9 卡⑭落码（石纹全屏底+顶栏铭牌/钥石徽+三柜台列，前置样张闸过审）；功能界面（营地入口/CampOverlay 三柜台/A 区顶栏钥石余额常驻/结算屏入账明细）2026-09-21 已落地。**剩余面=局内状态面板只读入口（已随改名批换代——2026-10-13 用户令「暂停层/暂停角标」更名「状态面板/状态角标」，全标识符与文案换代、行为零变化）**：局内可只读查看钥石与解锁态的入口已交付，待实机目检。 - -**归属**：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-09-18 方向已拍板，2026-10-17 迭代 30 卡①实装入库） - -**现状**：2026-09-18 用户拍板方向——未开格常显奖励类型微光（周围 8 格泛光：魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄），让玩家能针对敌人护甲类型规划优先开哪些格。设计依据：护甲克制轴已落地（穿刺弹/魔法矢），玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新（T1 裁决：采纳彩色常显微光）**：原五色与圣经语义色条款三方冲突（紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方），经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤)，见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」（五组色相 = 样张 v2 冻结既裁值，依据 art-bible :66/:551；明度档 provisional 值登记见 art-bible 版本历史 v3.15，复核转正归战斗一屏样张批）；圣经 §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框架共裁 - -**状态**：✅ **已完成**（2026-10-17 迭代 30 卡①未开格类型徽章批入库，合并 `7ffd1dc0`——shader 主路径五组微光实装：归组/色板/开关/生命周期全落；冒烟 1151/0〔新增八相 24 项〕＋单测 34 套件〔type_glow_test 51 检查〕＋探针 case⑰＋渲染双帧取证全绿；实机目检人闸五项登记 07 ㉘、待用户过目）。**2026-10-05 注**：类型色五族已由迭代 16「UI 设计对齐批」§3-N4c 立项 `TG_*` 常量（当日实查 `ui_kit.gd` 无 tg 常量、五族以裸 `Color8` 内联于 `bonus_pick_overlay.gd:96-102` / `shop_overlay_view.gd:189`，且缺第五族 aoe `#E25676`——**2026-10-17 读数刷新：该实查系立项当日时点值，现行 `TG_*` 五族在役 `ui_kit.gd:49-53`〔含第五族 aoe `#E25676`〕，消费面经 `tg_band()` 单点取色〔`curio_pick_overlay.gd:97`——原 `bonus_pick_overlay.gd` 已改名／`shop_overlay_view.gd:209`〕，裸 `Color8` 内联读数作废**）；本条（**格面**未开格类型徽章）与卡顶色带同族不同落点。**2026-10-07 注**：呈现规格简化为组粒度——组间五色相、组内不细分（通用增益组五族不再承诺组内分型；art-bible v3.12）；实施批按组粒度执行。**2026-10-16 用户令编入迭代 30**（UI 呈现三卡批序位①，需求卡片=[未开格类型徽章批](../research/需求卡片-未开格类型徽章批-2026-10-16.md) v1.4；开工门 U0 `/iter` 发令已于 2026-10-17 执行完毕）。 - -#### 卡顶色带与格面微光两带统一（2026-10-17 迭代 30 卡① Q3 甲案登记——原 T3 条件卡不并入该批） - -**现状**：类型色现有两套并存——**卡顶色带** `TG_*` 五族（三选一卡面/商店货架消费，`ui_kit.gd:49-53`，`tg_band()` 按 id 小写子串判定）与**格面未开格微光** `TG_GLOW_*` 五组（`ui_kit.gd:87-95`，`glow_group_for_cell_type()` 按 cell_type 精确值判定）。分工口径：卡顶带管货架卡面的类型标识，格面微光管未开格的类型先读，两套禁互为引用。统一面（原 T3 条件卡内容）：`TG_*` 取值改圣经五组冻结值、归组输入改 cell_type 精确值、E5 回滚注记清偿——影响面 = 三选一与商店货架观感变化＋既有断言改写（触碰「只增不减」契约，须按异常分级 L3 先呈报）。 +**现状**：类型色现有两套并存——**卡顶色带** `TG_*` 五族（三选一卡面/商店货架消费，`ui_kit.gd:49-53`，`tg_band()` 按 id 小写子串判定）与**格面未开格微光** `TG_GLOW_*` 五组（`ui_kit.gd:87-95`，`glow_group_for_cell_type()` 按 cell_type 精确值判定）。分工口径：卡顶带管货架卡面的类型标识，格面微光管未开格的类型先读，两套禁互为引用。统一面（原迭代 30 卡① Q3 甲案的 T3 条件卡内容，不并入该批）：`TG_*` 取值改圣经五组冻结值、归组输入改 cell_type 精确值、E5 回滚注记清偿——影响面＝三选一与商店货架观感变化＋既有断言改写（触碰「只增不减」契约，须按异常分级 L3 先呈报）。与战斗一屏样张批〔迭代 30 序位②，已剔除回待设计〕的明度档复核转正无互踩——本统一改的是卡顶带取值，不动格面微光五组 provisional 值。 **归属**：UI 呈现线后续批（用户点名开工） -**状态**：待办（2026-10-17 登记。与战斗一屏样张批〔迭代 30 序位②〕的明度档复核转正无互踩——本统一改的是卡顶带取值，不动格面微光五组 provisional 值） +**状态**：待写卡 -#### 呈现层残余 <4.5:1 文字位（迭代 16 批外邻接发现，2026-10-06 登记） +#### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 登记，来源=playnote，设计面=双轨） -**现状**：迭代 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。 +**现状**：来源＝playnote 用户试玩记录「UI 优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」。2026-10-13 用户裁定：**这是需要做的**，且本就属版本标准的覆盖范围——[08-Alpha版本标准](08-Alpha版本标准.md)「五 · 表现」已新增「棋盘观感（第二 / 三关亮度与对比度）」行，标待做。**开工前须先定性（沿用既有裁决）**：是**素材轴**问题（棋盘瓦片与格面图标本身的明度与色相），还是 **UI 轴**问题（舞台底色与叠加层的对比关系）——两轴修法完全不同，定性错了等于白改一轮；该定性要求原登记于「奇物呈现优化探讨备忘两孤儿点」(e)，本条承接并转为正式待办。2026-10-16 曾编入迭代 30 卡③（UI 呈现三卡批序位③），2026-10-17 用户裁定剔除回待设计（自身挂「素材轴/UI 轴」定性人闸＋甲/乙〔recolor/远程生图重产〕素材裁点；若裁乙，其瓦片规格依赖战斗一屏样张批的目标规格清单产出）。v1.4 旧卡留 design/research/需求卡片-二三关棋盘观感批-2026-10-16.md 作素材，非已写卡状态。与已完成注销的「呈现层残余 <4.5:1 文字位」分工：本条管**棋盘区域整体的观感**（亮度/对比度/费劲感，体感问题），彼条管**具体文字位的对比度读数**（机检可判硬指标），两条不同面不互相替代。 -**归属**：呈现优化后续批（或 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-13 用户裁定，Alpha 阶段需完成） - -**现状**：来源 = playnote 用户试玩记录「UI 优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」。2026-10-13 用户裁定：**这是需要做的**，且本就属版本标准的覆盖范围——[08-Alpha版本标准](08-Alpha版本标准.md)「五 · 表现」已新增「棋盘观感（第二 / 三关亮度与对比度）」行，标待做（此前是隐式覆盖，现显式化，免得被当成已完成）。 - -**开工前须先定性（沿用既有裁决）**：是**素材轴**问题（棋盘瓦片与格面图标本身的明度与色相），还是 **UI 轴**问题（舞台底色与叠加层的对比关系）——两轴修法完全不同，定性错了等于白改一轮。该定性要求原登记于下方「奇物呈现优化探讨备忘两孤儿点」(e)，本条承接并转为正式待办。 - -**与相邻条目的分工**：① 本条管**棋盘区域整体的观感**（亮度 / 对比度 / 费劲感），是体感问题；② 上方「呈现层残余 <4.5:1 文字位」管**具体文字位的对比度读数不达标**（B 区站桩名行 / 敌顺位徽标 / RAP 反馈行三处），是机检可判的硬指标。两条不同面，不互相替代，各自保留。 +**缺口**：还差「素材轴 / UI 轴」定性设计讨论与甲/乙素材裁点裁决；素材轴若走重产，还依赖战斗一屏样张批的目标规格清单产出。 **归属**：[HUD框架](systems/表现与支撑/HUD框架.md)（UI 轴：舞台底与叠加层）+ [美术圣经](../art/art-bible.md)（素材轴：瓦片与格面图标的明度色相）——定性前两方共裁 -**状态**：待办（**Alpha 阶段需完成**）——开工前先过「素材轴 / UI 轴」定性人闸。**2026-10-16 用户令编入迭代 30**（UI 呈现三卡批序位③，需求卡片=[二三关棋盘观感批](../research/需求卡片-二三关棋盘观感批-2026-10-16.md) v1.2；素材轴甲/乙案裁点挂 T1 出口呈报；开工门=U0 `/iter` 发令）。 +**状态**：待文档设计＋待美术设计 -#### 棋盘格边长三方取值不一致——待扩板定档处置（2026-10-06 登记） +#### 棋盘格边长三方取值不一致——待扩板定档处置（2026-10-06 登记，来源=批次移交，设计面=文档轨） -**现状**：迭代 16「UI 设计对齐批」P2 已裁「棋盘格边长零改动」（本次不动棋盘游戏画面），由此三方取值不一致作为**已知偏差**登记：①代码 = `board_view.gd:251` 动态公式 `clampi(cell, 26, 46)` + `:114` 默认 46.0；②art-bible §8.1(:433) 冻结锚点 = 45px（10×10）/ 36px（12×12）；③demo 原型 = 44px（`src/ui-prototype.html:288`）；另有 HUD框架:72 装板校验区间 [30,45]。**当前未被任何断言触发**（属潜在不一致，不是缺陷）。按需求卡片契约 R7「禁单侧改完留漂移」，本批**代码与文档均不改**；处置时机 = 扩板（13×13/14×14）定档时随格边长专项一并处理（§8.1 亦注明扩板换算值未定稿）。来源=`UI对齐批需求卡片（已退役，git 历史可查）` §2.1「已知偏差」行。 +**现状**：迭代 16「UI 设计对齐批」P2 已裁「棋盘格边长零改动」（本次不动棋盘游戏画面），由此三方取值不一致作为**已知偏差**登记：①代码＝`board_view.gd:251` 动态公式 `clampi(cell, 26, 46)` + `:114` 默认 46.0；②art-bible §8.1(:433) 冻结锚点＝45px（10×10）/ 36px（12×12）；③demo 原型＝44px（`src/ui-prototype.html:288`）；另有 HUD框架:72 装板校验区间 [30,45]。**当前未被任何断言触发**（属潜在不一致，不是缺陷）。按需求卡片契约 R7「禁单侧改完留漂移」，本批**代码与文档均不改**；处置时机＝扩板（13×13/14×14）定档时随格边长专项一并处理（§8.1 亦注明扩板换算值未定稿）。来源＝UI对齐批需求卡片（已退役，git 历史可查）§2.1「已知偏差」行。 -**归属**：格边长专项（或 UI 设计对齐批后续专项）；开工 = 用户点名 +**缺口**：还差扩板定档时的格边长专项裁决（三方取值归一＋§8.1 扩板换算值定稿）。 -**状态**：待办 +**归属**：格边长专项（或 UI 设计对齐批后续专项）；开工＝用户点名 -#### 资产升档重产批（art-bible v3.0 中修挂账③，2026-09-29 登记） +**状态**：待文档设计（备选） -**现状**：v3.0 §8.2 档位上调方向候选——主角立绘 48×72→64×96 档、敌立绘三档 48/64/96→64/96/128 档评估；返工面 = 主角三态 + 八敌种（fixer 像素化管线已实战）。**v3.0 代拍板③：本批只立方向不重产资产**（**2026-09-29 已追认**）；评估与终值归整屏样张闸。连带：character-design.md 提灯点亮解禁候选（v3.0 明度分层允许空间光照）同归本批重议。 +#### 资产升档重产批（art-bible v3.0 中修挂账③，2026-09-29 登记，来源=批次移交，设计面=美术轨） + +**现状**：v3.0 §8.2 档位上调方向候选（主角立绘 48×72→64×96 档、敌立绘三档上调评估）**已实质完成**——2026-10-06 art-bible v3.7 八敌逐键定档（源档 36–94、显示 ×2 整数；派生管线＝pixel-1 紧裁→等比缩至档高→dom_block_resize）取代 64/96/128 升档路线；存在感问题改经方案二（B 区 270 / 立绘显示上限 188 / 血条状态落底排）解决，不再走升档路线。裁决史：2026-09-30 迭代 9 三裁决案乙（本迭代不升档，先收 Alpha 真人读数再定；A4 尺寸基线冻结〔立绘 46×48/小人源 32×32〕维持有效）；2026-10-04 用户令暂不做、先忽略；2026-10-06 用户令优先级再降（维持挂起；同日 playnote 立绘批评已由「立绘逐键定档批」承接兑现）。**剩余挂起项＝提灯点亮解禁候选**（character-design 提灯，v3.0 明度分层允许空间光照），重启＝用户点名或 M-4 升档批。 + +**缺口**：还差提灯点亮解禁候选的重议设计（升档批或用户点名触发时一并裁）。 **归属**：[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-10-13 用户裁定归美术线，Alpha 阶段需完成） +#### 立绘清晰度回退评估——是否改用高清图（2026-10-13 登记，来源=playnote，设计面=美术轨） -**现状**：来源 = playnote 用户试玩记录「现在的立绘太丑了，像素化的粒度太低了，导致根本看不清立绘；看是否可以改回用较为高清的图片？还有一个问题是大小的问题……现在地精的图片看起来比熊地精还要大，这并不合理」。2026-10-13 用户裁定：与「第二 / 三关棋盘观感」同属**美术线更新**。 +**现状**：来源＝playnote 用户试玩记录「现在的立绘太丑了，像素化的粒度太低了，导致根本看不清立绘；看是否可以改回用较为高清的图片？还有一个问题是大小的问题……现在地精的图片看起来比熊地精还要大，这并不合理」。2026-10-13 用户裁定：与「第二 / 三关棋盘观感」同属**美术线更新**。**两个子问题现状不同**：子问题一＝怪物大小比例不合理——**已兑现**（体量语义改生物体型〔character-design §5.2，弃强度线性映射〕＋八敌逐键定档〔art-bible §8.2〕），剩余面＝用户是否复核验收；子问题二＝像素粒度过低/是否改回高清图——**方向已裁（2026-10-14 用户裁）**：「还是像素风格立绘，但是不需要像现在太过于像素」，定性为**精细手绘像素**（不是插画、不是 HD-2D、不回退高清图；裁决录＝[美术审计-cursor会话存档](../art/美术审计-cursor会话存档-2026-10-14.md) §2.2；权威面 art-bible/character-design 口径节反哺另批），粒度问题已改派生管线（八敌源档 36–94 全过可读门槛：24 糊/32 可读/48 清楚）。[08-Alpha版本标准](08-Alpha版本标准.md) 未决项已随裁删除（2026-10-16 状态刷新批）。 -**两个子问题现状不同，勿混为一谈**： -- **子问题一 = 怪物大小比例不合理**：**已兑现**——体量语义改生物体型（character-design §5.2，弃强度线性映射）+ 八敌逐键定档（art-bible §8.2）。剩余面 = 用户是否复核验收。 -- **子问题二 = 像素粒度过低看不清 / 是否改回高清图**：**方向已裁（2026-10-14 用户裁）**——「还是像素风格立绘，但是不需要像现在太过于像素」，定性为**精细手绘像素**（不是插画、不是 HD-2D、不回退高清图），整屏方向稿与地面/立绘密度同批锁（裁决录=[美术审计-cursor会话存档](../art/美术审计-cursor会话存档-2026-10-14.md) §2.2；权威面 art-bible/character-design 口径节反哺另批）。粒度问题已改派生管线（八敌源档 36–94 全过可读门槛：24 糊 / 32 可读 / 48 清楚）。 +**缺口**：还差立绘按「精细手绘像素」新口径重产的设计——整屏方向稿与地面/立绘密度同批锁（与战斗一屏样张批联动）后才可出重产工单。 **归属**：[角色设计](../art/character-design.md)（立绘规格与体量语义）+ [美术圣经](../art/art-bible.md)（像素管线与档位） -**状态**：待办（**Alpha 阶段需完成**）——**方向已裁（2026-10-14 用户裁：维持像素风、升级精细手绘像素，不回退高清图**，裁决录见上）；[08-Alpha版本标准](08-Alpha版本标准.md) 未决项已随裁删除（2026-10-16 状态刷新批）；余=立绘按新口径重产（美术线，与战斗一屏样张/整屏方向稿同批锁密度）＋子问题一（大小比例）待用户复核验收 +**状态**：待美术设计 -#### 站桩帧动画——Alpha 定版闸前完成（2026-10-06 P0-3 延后登记，用户拍板） +#### 站桩帧动画——Alpha 定版闸前完成（2026-10-06 登记，来源=审计发现，设计面=美术轨） -**现状**：审计报告 P0-3——定稿立绘零帧动画；现行动画全部程序化（死亡碎裂/受击闪白/意图徽标弹入 = 程序 tween，非帧资产），用户裁定**动画是较往后的优化，Alpha 版本定版时间点之前完成即可**——当前 Alpha 开发期达成「看上去可游玩」即可。路线未拍板，审计报告三路线供重启时裁决：①**拆件驱动**（报告推荐：定稿立绘切部件〔头/躯干/臂/腿/武器〕+ 节点层级 tween 驱动——零身份漂移、帧数无限、内存小；项目已有先例 = shovel_swing 三帧 + 程序化死亡碎裂）②AI 关键姿势 + 人工修 + 程序补帧 ③全 AI 逐帧（不推荐：身份漂移/像素抖动）。前置依赖 = 「立绘→派生形态」管线（等比整数缩放 + 降色 ≤32 + 脚底基线对齐 + 命名合规）——该管线同时是棋盘小人重出与八敌档位重算的前提。 +**现状**：审计报告 P0-3——定稿立绘零帧动画；现行动画全部程序化（死亡碎裂/受击闪白/意图徽标弹入＝程序 tween，非帧资产）。用户裁定**动画是较往后的优化，Alpha 版本定版时间点之前完成即可**——当前 Alpha 开发期达成「看上去可游玩」即可。路线未拍板，审计报告三路线供重启时裁决：①**拆件驱动**（报告推荐：定稿立绘切部件〔头/躯干/臂/腿/武器〕+ 节点层级 tween 驱动——零身份漂移、帧数无限、内存小；项目已有先例＝shovel_swing 三帧 + 程序化死亡碎裂）②AI 关键姿势 + 人工修 + 程序补帧 ③全 AI 逐帧（不推荐：身份漂移/像素抖动）。前置依赖＝「立绘→派生形态」管线（等比整数缩放 + 降色 ≤32 + 脚底基线对齐 + 命名合规）——该管线同时是棋盘小人重出与八敌档位重算的前提。 + +**缺口**：还差重启时（重启闸＝Alpha 定版批）的路线拍板——先拍三路线之一，再立帧数规格与资产工单。 **归属**：[art-bible](../art/art-bible.md) §8.4 帧数规格 · 战斗表现批 -**状态**：延后（**重启闸 = Alpha 定版批**；重启时先拍路线，再立规格与资产工单） +**状态**：待美术设计（备选） -#### 主角描边素材侧复核（2026-10-06 待决项 B 登记注记） +#### 主角描边素材侧复核（2026-10-06 登记，来源=会话提及，设计面=美术轨） -**现状**：待决项 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 · 样张批 -**状态**：登记备查（重启 = 样张批终审触发） +**状态**：待美术设计（备选） -#### 在途草稿整理批——3349 个失管草稿（2026-10-06 审计 P2-1 登记） +#### 在途草稿整理批——3349 个失管草稿（2026-10-06 登记，来源=审计发现，设计面=工程直入） -**现状**：审计 P2-1——`artwork/ui-reuse-2026-09-23/` 独占 3043 个草稿（91%），vN 命名率 0%，冗余 41 文件，残留非素材文件（.url ×8 / .ogg ×6 / .ai ×2 / .swf ×1）；根因 = 脚本链覆盖「生成→验证」但**缺「草稿整理」段**。整理涉及**批量文件移动/删除**，按用户惯例须先 dry-run 呈报清单、经确认再分批执行。 +**现状**：审计 P2-1——`artwork/ui-reuse-2026-09-23/` 独占 3043 个草稿（91%），vN 命名率 0%，冗余 41 文件，残留非素材文件（.url ×8 / .ogg ×6 / .ai ×2 / .swf ×1）；根因＝脚本链覆盖「生成→验证」但**缺「草稿整理」段**。整理涉及**批量文件移动/删除**，按用户惯例须先 dry-run 呈报清单、经确认再分批执行。执行窗口随实现批；开工＝用户点名。 **归属**：[art-bible](../art/art-bible.md) §8.3 归档纪律（原则已写入）· 资产管线批（工具+文件操作） -**状态**：待办（执行窗口随实现批；开工 = 用户点名，先 dry-run） +**状态**：待写卡 -#### 圣经口号型条款机检化批（2026-10-06 审计 P2-4 登记） +#### 圣经口号型条款机检化批（2026-10-06 登记，来源=审计发现，设计面=文档轨） -**现状**：审计 P2-4——圣经约 55% 条款属口号型（如「暖倾向无压抑」「同一圆角率」无值），与可机检条款混排。目标 = 逐条审查标注「可机检/目检/口号」三档分行，口号型逐步改写为带值或带判据条款。工程量 = 全文级（541 行逐条），非一轮能毕。**2026-10-06 三档标注格式已拍板**（←机检/←目检/←方向性，规范见 art-bible 头注「条款验收标注纪律」；数值类推荐「待定现用」态）——本批执行 = 按此格式分章补标，每章交付用户抽验。 +**现状**：审计 P2-4——圣经约 55% 条款属口号型（如「暖倾向无压抑」「同一圆角率」无值），与可机检条款混排。目标＝逐条审查标注「可机检/目检/口号」三档分行，口号型逐步改写为带值或带判据条款。工程量＝全文级（541 行逐条），非一轮能毕。**2026-10-06 三档标注格式已拍板**（←机检/←目检/←方向性，规范见 art-bible 头注「条款验收标注纪律」；数值类推荐「待定现用」态）——本批执行＝按此格式分章补标，每章交付用户抽验。挂账：随整屏样张闸前整备批启动，分章推进。 + +**缺口**：还差整屏样张闸前整备批的启动——格式已定，差启动时点与分章执行。 **归属**：[art-bible](../art/art-bible.md) 全文 · 样张批前置整备 -**状态**：挂账（随整屏样张闸前整备批启动；分章推进，每章一个章节，格式已定） +**状态**：待文档设计（备选） -#### 战斗区背景图替换——B 区舞台插画 + 临时光柱退役（2026-10-07 用户点名登记） +#### 战斗区背景图替换——B 区舞台插画 + 临时光柱退役（2026-10-07 登记，来源=会话提及，设计面=美术轨） -**现状**：B 区舞台现行 = 程序化平色底（`UiKit.STAGE_BG`，`battle_stage_view.gd:47`）+ **顶光柱氛围层**（`:55-63` 四柱，x 基准 110/900/1055/1210@1280，60 段叠层矩形自顶向下渐宽窄渐隐〔顶 α26→0〕，层序 = bg < 光柱 < 世界）——二者均系 §6.1 方向稿的**临时占位**，用户口径「光柱只是临时方案，换正式战斗背景后效果更好」。正式件已立资产契约：`stage/stage_bg.png`（源 1280×270，B 区全高含明细带底；三关换挡走 §4.3 `wall_ambient` tint 槽，不按板出三张），属审计 P1-2 查得的「B 区舞台背景插画 0 张」缺口。**光柱在背景到位后顺带退役或吸收进背景绘制**（不再作为独立程序层）。**与立绘探顶解耦**：大体档「允许向上溢出盒顶 N px」的判定（2026-10-07 用户裁甲案）**不依赖光柱是否存在**，换背景零返工。 +**现状**：B 区舞台现行＝程序化平色底（`UiKit.STAGE_BG`，`battle_stage_view.gd:47`）+ **顶光柱氛围层**（`:55-63` 四柱，x 基准 110/900/1055/1210@1280，60 段叠层矩形自顶向下渐宽窄渐隐〔顶 α26→0〕，层序＝bg < 光柱 < 世界）——二者均系 §6.1 方向稿的**临时占位**，用户口径「光柱只是临时方案，换正式战斗背景后效果更好」。正式件已立资产契约：`stage/stage_bg.png`（源 1280×270，B 区全高含明细带底；三关换挡走 §4.3 `wall_ambient` tint 槽，不按板出三张），属审计 P1-2 查得的「B 区舞台背景插画 0 张」缺口。**光柱在背景到位后顺带退役或吸收进背景绘制**（不再作为独立程序层）。**与立绘探顶解耦**：大体档「允许向上溢出盒顶 N px」的判定（2026-10-07 用户裁甲案）**不依赖光柱是否存在**，换背景零返工。 + +**缺口**：还差出图前置条件的达成——立绘定档与站桩重排实装批的 **C0 盒高账定案后再出图**（避免 B 区高度/构图二次返工）；开工＝用户点名。 **归属**：[art-bible](../art/art-bible.md) §6.1（资产契约）+ §8.3 归档纪律 · 资产管线批；出图工单归 [art-assets-checklist](../art/art-assets-checklist.md) / 实装批任务书 -**状态**：待办（**开工 = 用户点名**；**前置建议** = 立绘定档与站桩重排实装批的 **C0 盒高账定案后再出图**，避免 B 区高度/构图二次返工；交付后 art-status-checklist 顺带更新 ✅） +**状态**：待美术设计 ### 教学引导 -> **节头注记（2026-10-04 用户拍板）**：教学引导定稿批整体改排 **Beta 阶段**——当前 Alpha 版不做教学相关工作，本节五条全部随之改排（2026-09-19 的 Alpha 排期拍板被本拍板取代）。同日五问讨论已形成初裁与设计提案，提案已归档 `archive/` 目录（磁盘留存、不入 git，Beta 批立项底稿，引用以其「归档状态与初裁记录」节为准）。初裁摘要：①教学形态=丙1 混合（首次冒险编排式首遇提示〔挂 first_script 锚、不锁操作〕+其余全程情景触发）；②「因果教学顺序」问题**注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容；展示层每行带来源标注已自带归因；教学引导.md 旧前提〔设计目的句/P0 候选归因提示/验收第 2 条〕随 Beta 批文档定稿清除）；③图例面板按循环段落分组、无结算段；④不做「再教一次」——改走独立「帮助」手册面（全部内容放一个文档）；⑤教学文案内容权归设置与本地化（两文档负责表对齐随 Beta 批）。**未裁三疑点**（Beta 立项时先裁）：增益叠层节奏条目去留／帮助入口位置（设置面为推荐）／图例面板与帮助手册的内容分工。 +> **节头注记（2026-10-04 用户拍板）**：教学引导定稿批整体改排 **Beta 阶段**——当前 Alpha 版不做教学相关工作，本节五条全部随之改排（2026-09-19 的 Alpha 排期拍板被本拍板取代）。同日五问讨论已形成初裁与设计提案，提案已归档 `archive/` 目录（磁盘留存、不入 git，Beta 批立项底稿，引用以其「归档状态与初裁记录」节为准）。初裁摘要：①教学形态＝丙1 混合（首次冒险编排式首遇提示〔挂 first_script 锚、不锁操作〕+其余全程情景触发）；②「因果教学顺序」问题**注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容；展示层每行带来源标注已自带归因；教学引导.md 旧前提〔设计目的句/P0 候选归因提示/验收第 2 条〕随 Beta 批文档定稿清除）；③图例面板按循环段落分组、无结算段；④不做「再教一次」——改走独立「帮助」手册面（全部内容放一个文档）；⑤教学文案内容权归设置与本地化（两文档负责表对齐随 Beta 批）。**未裁三疑点**（Beta 立项时先裁）：增益叠层节奏条目去留／帮助入口位置（设置面为推荐）／图例面板与帮助手册的内容分工。 -#### 教学形态未定 +#### 教学形态未定（2026-10-04 登记，来源=审计发现，设计面=文档轨） -**现状**：教学的具体形态未定：线性开局教程，还是全部走情景触发式提示？来源：待设计问题清单第 1 条 +**现状**：教学的具体形态未定：线性开局教程，还是全部走情景触发式提示？来源＝待设计问题清单第 1 条。2026-10-04 用户拍板本节整体改排 Beta（Alpha 不做教学）；同日五问讨论初裁＝丙1 混合（见本节头注记），定稿归 Beta 批。 + +**缺口**：还差 Beta 立项后的教学形态定稿讨论（初裁丙1 混合待定稿，见本节头注记）。 **归属**：教学引导定稿批 -**状态**：待办（**Beta 阶段**——2026-10-04 用户拍板改排：当前 Alpha 版不做教学相关工作，见本节头注记） +**状态**：待文档设计 -#### 因果教学顺序 +#### 因果教学顺序（2026-10-04 登记，来源=审计发现，设计面=文档轨） -**现状**：因果教学顺序未定：先教扫雷操作，还是先教读结算明细？两者如何衔接？来源：待设计问题清单第 2 条 +**现状**：因果教学顺序未定：先教扫雷操作，还是先教读结算明细？两者如何衔接？来源＝待设计问题清单第 2 条。2026-10-04 五问讨论初裁＝**该问题注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容）；教学引导.md 旧前提随 Beta 批文档定稿清除。 + +**缺口**：还差 Beta 批文档定稿时对初裁结论的落文清算（教学引导.md 旧前提清除）。 **归属**：教学引导定稿批 -**状态**：待办（**Beta 阶段**——2026-10-04 用户拍板改排：当前 Alpha 版不做教学相关工作，见本节头注记） +**状态**：待文档设计 -#### 图例面板的条目全集与分组方式 +#### 图例面板的条目全集与分组方式（2026-10-04 登记，来源=审计发现，设计面=文档轨） -**现状**：图例面板的条目全集与分组方式待定。来源：待设计问题清单第 3 条 +**现状**：图例面板的条目全集与分组方式待定。来源＝待设计问题清单第 3 条。2026-10-04 五问讨论初裁＝图例面板按循环段落分组、无结算段（见本节头注记）；图例面板与帮助手册的内容分工属未裁三疑点之一（Beta 立项时先裁）。 + +**缺口**：还差 Beta 立项后的图例面板定稿讨论（分组初裁待定稿＋与帮助手册内容分工裁决）。 **归属**：教学引导定稿批 -**状态**：待办（**Beta 阶段**——2026-10-04 用户拍板改排：当前 Alpha 版不做教学相关工作，见本节头注记） +**状态**：待文档设计 -#### 教学文案定稿权与本地化流程的分工 +#### 教学文案定稿权与本地化流程的分工（2026-10-04 登记，来源=审计发现，设计面=文档轨） -**现状**：教学文案的定稿权归属，以及与本地化流程的分工——两边共担，裁决时须对齐（设置与本地化原登记「文案定稿权与翻译流程的分工」；教学引导「待设计问题清单」第 4 条同事项，合并于此）。来源：待设计问题清单 + 设置与本地化原登记 +**现状**：教学文案的定稿权归属，以及与本地化流程的分工——两边共担，裁决时须对齐（设置与本地化原登记「文案定稿权与翻译流程的分工」；教学引导「待设计问题清单」第 4 条同事项，合并于此）。来源＝待设计问题清单 + 设置与本地化原登记。2026-10-04 五问讨论初裁＝教学文案内容权归设置与本地化，两文档负责表对齐随 Beta 批（见本节头注记）。 + +**缺口**：还差 Beta 批的两文档负责表对齐定稿。 **归属**：教学引导与[设置与本地化](systems/表现与支撑/设置与本地化.md)共裁 -**状态**：待办（**Beta 阶段**——2026-10-04 用户拍板改排：当前 Alpha 版不做教学相关工作，见本节头注记） +**状态**：待文档设计 -#### "再教一次"入口与图例面板兼任手册 +#### "再教一次"入口与图例面板兼任手册（2026-10-04 登记，来源=审计发现，设计面=文档轨） -**现状**：是否提供"再教一次"的入口（图例面板是否兼任手册）待定。来源：待设计问题清单第 5 条 +**现状**：是否提供"再教一次"的入口（图例面板是否兼任手册）待定。来源＝待设计问题清单第 5 条。2026-10-04 五问讨论初裁＝不做「再教一次」，改走独立「帮助」手册面（全部内容放一个文档；见本节头注记）；帮助入口位置属未裁三疑点之一（设置面为推荐，Beta 立项时先裁）。 + +**缺口**：还差 Beta 立项后的帮助手册面定稿讨论（初裁待定稿＋帮助入口位置裁决）。 **归属**：教学引导定稿批（待教学形态定稿后评估） -**状态**：待办（**Beta 阶段**——2026-10-04 用户拍板改排：当前 Alpha 版不做教学相关工作，见本节头注记） +**状态**：待文档设计 ### 生涯（跨局汇总与历史回看承接面） -#### 「生涯」界面——冒险中数据回看的唯一承接处 +#### 「生涯」界面——冒险中数据回看的唯一承接处（2026-10-04 登记，来源=会话提及，设计面=文档轨） -**现状**：2026-10-04 用户裁决（UI 落码计划 P-C7）——冒险中不给数据回看：settlement_review_overlay（结算明细回看）与结算框「明细回看」钮在冒险中退役，战报带只留单行「上轮」；历史战报/结算明细的查看去向=新「生涯」界面（跨局汇总/历史冒险回看/图鉴承接），**尚未设计未实装**。来源=UI 重设计原型 v2 落码计划裁决记录（UI落码差异对照（已退役，git 历史可查） §七） +**现状**：2026-10-04 用户裁决（UI 落码计划 P-C7）——冒险中不给数据回看：settlement_review_overlay（结算明细回看）与结算框「明细回看」钮在冒险中退役，战报带只留单行「上轮」；历史战报/结算明细的查看去向＝新「生涯」界面（跨局汇总/历史冒险回看/图鉴承接）。来源＝UI 重设计原型 v2 落码计划裁决记录（已退役，git 历史可查 §七）。**设计提纲已成文**：[systems/跨局循环/生涯.md](systems/跨局循环/生涯.md) v0.1 范围草案五节成文〔信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点〕，P0-P5 六裁点已全裁并写入文档〔P0甲 提纲落现行事实源 / P1甲 主菜单一级入口 / P2甲 每局一行摘要+cap 扩容 N+补用时埋点 / P3甲 敌人图鉴优先 / P4甲 局内不放入口+生涯零跳转 / P5甲 settlement_review 复活承接〕。**期一已落地**（2026-10-07 迭代 18 卡④实装批：生涯页六类九项+主菜单入口+终身计数域存档 v6，批末重闸全绿；实机人闸＝07⑲ 生涯页目检节）。剩余面＝期二（历史回看/图鉴）与期三实装＋P6 营地最近冒险条带去留（新发现待裁点，随提纲评审一并裁）。**迭代 19 卡②遗留件（2026-10-08 登记）**：settlement_review_overlay.gd 现态考证＝未接线遗留件（全仓零引用，M9 结算框改版「明细回看」钮退役后遗留）——处置两途：①随生涯实装批按 P5 甲复活承接（重接线入生涯）；②确认不再需要则正式退役删除文件；二选一归生涯实装批/用户裁。 + +**缺口**：还差提纲用户评审收尾与 P6 营地最近冒险条带去留裁决——裁完才能立期二/期三实装卡（期一已交付，期二/三未预占排期）。 **归属**：新界面立项（用户发令后排批）；退役落码随 UI 落码批 M8/M9 -**状态**：待办（生涯未做前，冒险中无任何历史回看入口——已知代价，用户知情裁决）——**设计提纲已成文待评审**（2026-10-06 迭代 17 卡④设计批完成：提纲 = [systems/跨局循环/生涯.md](systems/跨局循环/生涯.md) v0.1 范围草案，五节成文〔信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点〕，现状描述经代码级复核；P0-P5 六裁点已全裁并写入文档〔P0甲 提纲落现行事实源 / P1甲 主菜单一级入口 / P2甲 每局一行摘要+cap 扩容 N+补用时埋点 / P3甲 敌人图鉴优先 / P4甲 局内不放入口+生涯零跳转 / P5甲 settlement_review 复活承接〕，新发现待裁点 P6 营地最近冒险条带去留随评审一并裁。**人闸 = 用户评审提纲**；实装批另行立项，期一/二/三均未预占排期）——**实装批已编入 roadmap 迭代 18 卡④生涯界面实装批（2026-10-06 用户令；门=本提纲用户评审+设计定稿）**——**期一已落地（2026-10-07 迭代 18 卡④实装批：生涯页六类九项+主菜单入口+终身计数域存档 v6，批末重闸全绿；实机人闸挂账待用户——目检项=07⑲；出口报告 design/qa/iter18-career-exit-report-2026-10-07.md）**；剩余面=期二（历史回看/图鉴）与期三实装+P6 营地最近冒险条带去留 - -**迭代 19 卡②遗留件登记（2026-10-08）**：settlement_review_overlay.gd 现态考证=未接线遗留件（全仓零引用，M9 结算框改版「明细回看」钮退役后遗留——迭代 19 卡②需求卡片普查表「出批归退役处置另议」落位本条）。处置两途：①随生涯实装批按 P5 甲复活承接（重接线入生涯）；②确认不再需要则正式退役删除文件。二选一归生涯实装批/用户裁；卡②批红线（旧屏零 diff）该文件零触碰。 +**状态**：待文档设计 ### GP 经济 -#### 商店独立刷新机制——两参数待调参 + 机制文档回写 +#### 商店独立刷新机制——两参数待调参 + 机制文档回写（2026-10-04 登记，来源=会话提及，设计面=文档轨） -**现状**：2026-10-04 用户裁决（P-C2+Q2 二次裁）推翻关卡节点地图 v1.5「无独立刷新、重抽绑购买」口径，定案=**基础免费 0 次 + GP 刷新（ceil(20×1.8^已付费刷) provisional）+ 池源同源（共享池，与三选一同一账本）**；**天赋/营地侧「刷新次数」增益=用户既有意向（口头裁决，曾因未写入文档丢失——Q2 追认），后续由用户调整添加，实现面预留 free_count=天赋增益位**。未定：天赋增益的具体形态与数值。**机制已落码（SR-1 随 UI 落码批收官，2026-10-04/05）**。**三选一同款付费刷新（2026-10-06 用户令——「三选一对齐商店，得有刷新」）已落码**：免费双源（刷新件 X/冒险池 Y）用尽后 GP 付费刷新，同旋钮同曲线同钱包，钮常驻选择态、两源皆穷=禁用；机制登记归[秘宝](systems/跨局循环/秘宝.md)「三选一刷新双源」节。剩余待办=①调参（shop_refresh_free/曲线两参数 provisional）；②天赋增益形态与数值；③机制文档回写（冒险结构共享池账本节/关卡节点地图商店行 v1.6 已记，本条完成时核对三处同步）。来源=同上 §七 +**现状**：2026-10-04 用户裁决（P-C2+Q2 二次裁）推翻关卡节点地图 v1.5「无独立刷新、重抽绑购买」口径，定案＝**基础免费 0 次 + GP 刷新（ceil(20×1.8^已付费刷) provisional）+ 池源同源（共享池，与三选一同一账本）**；**天赋/营地侧「刷新次数」增益＝用户既有意向（口头裁决，曾因未写入文档丢失——Q2 追认），后续由用户调整添加，实现面预留 free_count=天赋增益位**。未定：天赋增益的具体形态与数值。**机制已落码**（SR-1 随 UI 落码批收官，2026-10-04/05）；**三选一同款付费刷新已落码**（2026-10-06 用户令——「三选一对齐商店，得有刷新」：免费双源〔刷新件 X/冒险池 Y〕用尽后 GP 付费刷新，同旋钮同曲线同钱包；机制登记归[秘宝](systems/跨局循环/秘宝.md)「三选一刷新双源」节）。剩余待办：①调参（shop_refresh_free/曲线两参数 provisional，归 M4 数值批顺带）；②天赋增益形态与数值（设计未定）；③机制文档回写核对（冒险结构共享池账本节/关卡节点地图商店行 v1.6 已记，本条完成时核对三处同步）。 + +**缺口**：还差天赋增益形态与数值的设计讨论（用户调整时裁）与 M4 窗口的两参数标定；③回写核对随完成时点履行。 **归属**：M4 数值批（调参两参数顺带）；天赋增益随天赋侧内容批 -**状态**：待办（机制已落码；调参、天赋增益与文档回写未落） +**状态**：待文档设计 ### 文档与结构 -#### 闸按改动域分跑批的两处代拍板 + 旧实现报告迁位欠账（2026-10-17 登记，闸分域批） +#### qa/ 实现报告收尾·孤儿遗留七项（2026-10-14 登记，来源=批次移交，设计面=工程直入） -**现状**：用户裁定「改代码的批只跑代码闸、改文档的批只跑文档闸」与「迭代批禁写 `design/`」两条，落地时撞上一处既有规则没覆盖的缝隙，本批按推荐方案先做并登记待追认：① **active.md 记账例外**——§3.12 要求每批更新 active.md 快照与状态记录，而合回闸钩子本就对 active.md 放行（它被定为「会话状态唯一源」而非文档产出物）；本批把禁写面落在 `design/` 与根规则文件（`CLAUDE.md`/`roadmap.md`），**active.md 实现批照写**，读法若不符请推翻。② **`reports/` 新顶层目录**——熵增闸「新增顶层目录须同批改 CLAUDE.md Project Layout + 脚本白名单两处」，本批已同批改齐（`repo_structure_audit.py` TOP_DIRS + CLAUDE.md 第 36 行 + `reports/README.md` 立目）。③ **旧实现报告未迁位**——`reports/iter27-实现报告-2026-10-14.md`、`iter28-实现报告-2026-10-15.md` 两份现行报告仍在 `design/qa/`，且 active.md 第 32 行待追认指针指向该路径；新口径要求实现批产出物归 `reports/`。本批未搬（搬动会改动两份历史报告的落位与引用面，属文档动作，不属闸改造）。 +**现状**：qa 收尾批核查 iter19 系列出口报告遗留移交项时发现**不在 06 在册**的七项（acceptance-package §三.2/card0 §5.3/followup §七.3/uibackfill §6.2-4/verify §6.1/3/7）。已结案的（tree_rules 受理闭环、X/Y 双源、S1 七项违例修复、提灯目检项、tests.yml 休眠等）已在各报告标注结案证据，不入本条。七项均为挂号备查/顺路件，无排期承诺： -**归属**：①②已追认（2026-10-17 用户令「追认单的所有我都是同意的」，本批已生效）；③归下一次文档批 - -**状态**：待办——①②已追认清零；③**已清（2026-10-17 文档批：三份 iter27/28/29 实现报告已 `git mv` 往 `reports/`，全库引用同批改指新路径，死链检查复验零死链；active.md 待追认行指针就地同步）** - -#### 文档/结构闸存量欠账（2026-10-08 迭代 19 总完成批登记） - -新重闸口径首次全闸套跑翻出；经 T0 基点 9160942 复测确认为存量/外部批旧债，非本迭代新增。 -- gdd_lint 表格占比 3 件：01-核心循环（35%）/06-待办清单（0%）/07-体验验证清单（6%）——T0 基点已 2 件存量在案，第 3 件疑外部道具批 80 行散文写入稀释占比 -- doc_link 死链 2 件：奇物.md:245 → ../ux/battle.md 与 ../ux/node-reward.md（奇物 v2.7 b6b43eb 旧债）——**已清偿（2026-10-09 独立复核批：路径层级 ../ux/→../../ux/ 修正，doc_link 复验零死链）** -- doc_term 退役术语旗 1 件：06「拔旗回收返 AP」备选条目文字引用（该条目自身裁决时顺手处置） - -**归属**：文档体检批/对应来源批 - -**状态**：待办（已呈报登记；处置不阻塞迭代 19 完成） -#### qa/ 实现报告收尾·孤儿遗留七项（2026-10-14 补登——用户裁「全部补登 06」） - -**来源**：qa 收尾批核查 iter19 系列出口报告遗留移交项时发现**不在 06 在册**的七项（acceptance-package §三.2/card0 §5.3/followup §七.3/uibackfill §6.2-4/verify §6.1/3/7）。已结案的（tree_rules 受理闭环、X/Y 双源、S1 七项违例修复、提灯目检项、tests.yml 休眠等）已在各报告标注结案证据，不入本条。 - -1. **design/diagrams 越界**（熵增闸存量红，archify 架构图批 00712d5 旧债）：脚本自文「新分类先过用户拍板再改两处白名单」。修案二选一——甲=用户拍板 `design/diagrams` 入 DESIGN_SUBDIRS 白名单（archify 总图批产物归位）；乙=迁出 design/ 归位合法区。**归属**：熵增闸白名单（CLAUDE.md Project Layout+脚本白名单两处） -2. **开场行后缀认加算区**（iter19 卡⓪遗留）：现口径=「局外加成存在才带」后缀（需求卡片字面执行）；局内有加算区 flat 但无局外加成时，开场行数字含加成却不带注记——是否扩展认加算区归设计批裁定。**归属**：冒险结构/战斗开场参数面 +1. **design/diagrams 越界**（熵增闸存量红，archify 架构图批 00712d5 旧债）：脚本自文「新分类先过用户拍板再改两处白名单」。修案二选一——甲＝用户拍板 `design/diagrams` 入 DESIGN_SUBDIRS 白名单（archify 总图批产物归位）；乙＝迁出 design/ 归位合法区。**归属**：熵增闸白名单（CLAUDE.md Project Layout+脚本白名单两处） +2. **开场行后缀认加算区**（iter19 卡⓪遗留）：现口径＝「局外加成存在才带」后缀（需求卡片字面执行）；局内有加算区 flat 但无局外加成时，开场行数字含加成却不带注记——是否扩展认加算区归设计批裁定。**归属**：冒险结构/战斗开场参数面 3. **camp STONE 文字位外溢**（iter19 尾裁微批遗留）：camp_overlay_view.gd:116/:403/:414 等既有 STONE 文字位对现役牌色实测 3.59-4.02:1 区间（非在册违例、机检不拦）；全站收敛 STONE→STONE_DEEP 另立裁点。**归属**：呈现优化批（对比度残余位） -4. **迷雾对三关扩对**（iter19 卡②遗留）：素材不入 git 致三关逐关 floor avg 实查受限，ui_contrast 迷雾测点现按在册单值 #453020；素材入库或授权读素材后，以 tools 脚本算三关逐关 avg→最亮者核合成（最坏情况判据契约 7 完整化）。**归属**：对比度探针面（前置=素材可读授权） +4. **迷雾对三关扩对**（iter19 卡②遗留）：素材不入 git 致三关逐关 floor avg 实查受限，ui_contrast 迷雾测点现按在册单值 #453020；素材入库或授权读素材后，以 tools 脚本算三关逐关 avg→最亮者核合成（最坏情况判据契约 7 完整化）。**归属**：对比度探针面（前置＝素材可读授权） 5. **字面量墨收测前置**（iter19 卡②遗留）：bcard 属性描述/类型脚注/✓章/primary_button 字四处内联 Color8 无常量形态，收测需先在 ui_kit 立常量（呈现批顺路件，改 ui_kit 越当批面）。**归属**：呈现优化批（ui_kit 常量面） 6. **TG_* 装饰带非文字判据**（iter19 卡②遗留）：卡顶类型色带为 8px Bayer 抖动装饰带（DitherBand），非文字；如需机检化（WCAG 1.4.11 非文字 3:1）另立探针段裁决。**归属**：对比度探针扩展段 -7. **数据配置.md:223 历史行死指 + 商店房截图纳屏**（iter19 卡①遗留）：前者=v0.4 版本史行 backtick 指已退役探针（doc_link advisory 级不 FAIL，历史行不改写原则下留观，如需清零可下批 prose 化+补退役行）；后者=商店房截图纳屏留后续呈现批（考证结论在 shot_probe 头注）。**归属**：文档卫生批/呈现批 +7. **数据配置.md:223 历史行死指 + 商店房截图纳屏**（iter19 卡①遗留）：前者＝v0.4 版本史行 backtick 指已退役探针（doc_link advisory 级不 FAIL，历史行不改写原则下留观，如需清零可下批 prose 化+补退役行）；后者＝商店房截图纳屏留后续呈现批（考证结论在 shot_probe 头注）。**归属**：文档卫生批/呈现批 -**状态**：待办（登记不阻塞——七项均为挂号备查/顺路件，无排期承诺；①须用户拍板后才动白名单） +**归属**：①熵增闸白名单 ②冒险结构/战斗开场参数面 ③⑤呈现优化批 ④⑥对比度探针面/扩展段 ⑦文档卫生批/呈现批——逐项见现状清单 -#### 美术资产链路审计两项 P0 — 待用户裁决（2026-10-09 自 active.md 413 号条目迁入） +**状态**：待写卡（备选） -**P0①**：`design/art/art-bible.md` 第 68/527 行与 art-status-checklist 第 13 行至今仍引用已丢失的冻结样张 sample-batch-v3-final-2026-09-30.png（磁盘实测零命中），死指涉待修复。**P0②**：主角棋盘小人未走像素管线（插值糊图），重产事项未在任何登记处在册。审计报告唯一留档=design/art/美术资产链路审计报告-2026-10-06.html（无人指路）。裁=修复死指涉+登记重产，或判过期随旧管线退役。 +#### 美术资产链路审计两项 P0 — 待用户裁决（2026-10-09 登记，来源=审计发现，设计面=双轨） + +**现状**：**P0①（文档面）**：`design/art/art-bible.md` 第 68/527 行与 art-status-checklist 第 13 行至今仍引用已丢失的冻结样张 sample-batch-v3-final-2026-09-30.png（磁盘实测零命中），死指涉待修复。**P0②（美术面）**：主角棋盘小人未走像素管线（插值糊图），重产事项未在任何登记处在册。审计报告唯一留档＝design/art/美术资产链路审计报告-2026-10-06.html（无人指路）。裁＝修复死指涉+登记重产，或判过期随旧管线退役。2026-10-13 用户令随「UI 美化三层诊断」登记：本条属第三层「观感提升」，Alpha 阶段需完成。 + +**缺口**：还差用户的路线裁决（修复死指涉＋登记重产，还是判过期随旧管线退役）——裁决后文档面修复与美术重产登记各按轨推进。 **归属**：art（art-bible/美术管线） -**状态**：待办（待用户裁决；**Alpha 阶段需完成**——2026-10-13 用户令随「UI 美化三层诊断」登记：本条属第三层「观感提升」） +**状态**：待文档设计＋待美术设计 --- -#### 奇物呈现优化探讨备忘两孤儿点 — 低置信防遗忘（2026-10-09 自 active.md 381 号条目迁入） +#### 奇物呈现优化探讨备忘两孤儿点 — 低置信防遗忘（2026-10-09 登记，来源=会话提及，设计面=文档轨） -迭代 18 卡②（呈现优化六件）2026-10-07 经用户令整体撤回探讨阶段，六件中四件已登记或删除，唯两点全仓仅 active.md 381 号条目有载：(e) L2L3 棋盘观感开工前先定性素材轴 vs UI 轴；(f) 关卡节点图展示改版先出参考调研+方案人闸。整卡系用户主动撤回，本条仅防遗忘，不构成排期承诺；呈现优化批若重启再议。 +**现状**：迭代 18 卡②（呈现优化六件）2026-10-07 经用户令整体撤回探讨阶段，六件中四件已登记或删除，唯两点全仓仅 active.md 381 号条目有载，迁本条防遗忘：(e) L2/L3 棋盘观感开工前先定性素材轴 vs UI 轴——**已由「第二 / 三关棋盘观感」条承接为正式待办**；(f) 关卡节点图展示改版先出参考调研+方案人闸——**与「关卡节点图重构」条同源，两处互相指认**。两点现均有正式条目承接，本条仅存防遗忘与互相指认义务，不构成排期承诺；呈现优化批若重启再议。 + +**缺口**：本条无独立设计缺口——(e)(f) 两点分别随「第二 / 三关棋盘观感」「关卡节点图重构」两条件的设计讨论推进；两条件处置完毕后本条随之注销。 **归属**：探讨备忘（奇物呈现） -**状态**：备忘（不阻塞，不排期） - +**状态**：待文档设计（备选） --- -#### 技术债观察登记——长函数余量与 lambda 连接防回归（2026-10-15 迭代 27 卡片义务补登） +#### 技术债观察登记——长函数余量与 lambda 连接防回归（2026-10-15 登记，来源=批次移交，设计面=工程直入） -**现状**：迭代 27 需求卡片两项「登记 06 观察」义务批内漏登，卡片核对时补登——①**长函数 17 个**中非结算段的装配/校验函数（`level_map_screen.gd` 选路装配 155 行/`camp_overlay_view.gd` 152 行/`debug_overlay.gd` 114 行/`treasure_item_table.gd` schema 校验群等；`main._build_ui` 已随场景拆分自然解体、`_settle`/`_resolve_hero_attack` 已随波二拆段=17 中 3 件已消解，余 14 件）；②**lambda 连接 76 处**（presentation 6/smoke 62/tests 8——实读无泄漏，登记防回归）。 +**现状**：迭代 27 需求卡片两项「登记 06 观察」义务批内漏登，卡片核对时补登——①**长函数 17 个**中非结算段的装配/校验函数（`level_map_screen.gd` 选路装配 155 行/`camp_overlay_view.gd` 152 行/`debug_overlay.gd` 114 行/`treasure_item_table.gd` schema 校验群等；`main._build_ui` 已随场景拆分自然解体、`_settle`/`_resolve_hero_attack` 已随波二拆段＝17 中 3 件已消解，余 14 件）；②**lambda 连接 76 处**（presentation 6/smoke 62/tests 8——实读无泄漏，登记防回归）。长函数拆分无独立需求驱动不动；lambda 连接数若有审计工具化需求归类型闸后续。 **归属**：工程债观察备忘（不阻塞，不排期；新增此类代码沿现役规范评审盯） -**状态**：备忘（长函数拆分无独立需求驱动不动；lambda 连接数若有审计工具化需求归类型闸后续） - -#### 迭代 27 代码架构技术债修复批——GDD 反哺点两条（2026-10-14 顺带登记；2026-10-17 用户逐点裁决，已写入） - -**现状**：五波全量入库（单会话交付；逐位一致逐项比对三变体五跑全同；实现报告=reports/iter27-实现报告-2026-10-14.md）。实现与设计权威文档的差异/缺口如下，经裁决后另批写入文档——**机械面已顺带改动的只有本条与 07/roadmap**。 - -**归属**：工程债/重构批完成反哺（不阻塞，不排期） - -| # | 文档 | 反哺点 | -|---|---|---| -| 1 | design/dev/architecture/architecture.md | 场景分层（三屏壳+组合根句柄面）/会话生命周期（RunScope 物化）/结算五段 Segment（core/settlement/）/RunLedger 四账所有权/ModalFlow 模态编排层与互斥域 tags 协议——现行陈述滞后于实态 | -| 2 | design/dev/code-conventions.md | §4 语言纪律机器化（S9+audit_type_hints.py 三规则）；`:= {}` 推断形态豁免口径；`# type-hint: ignore` 行级白名单与 `# rng-seed-exempt` S1/S2 标记豁免通道；--script 模式禁裸 autoload 标识符纪律（新）；Variant 参数化口径与元素精化后续 | - -**状态**：✅ **已写入（2026-10-17，用户逐点裁按推荐案）——①入 architecture.md v1.8：新增「战斗域装配现状」（结算五段/RunLedger 四账）与「呈现层装配与会话生命周期」（三屏壳/装配合同/RunScope 九阶段×五引用面矩阵/ModalFlow tags）两节，呈现层 D1 行同步换代；②入 code-conventions.md §4 第 7–12 条（S9 三规则/`:= {}` 不算债/两豁免通道/禁裸 autoload/Variant 口径）。登记时「16 层」为现行 17 项（2026-10-16 追加 float 类）、「无收束函数」以 `_begin_session` 换会话实态为准。代拍板追认单十五项已追认（2026-10-17 用户令）；残留人闸=07 ㉖ 五件登记不阻塞** +**状态**：待写卡（备选） --- -#### 启动装配与生命周期验收补全批——需求卡片登记（2026-10-15 编入迭代 28） +#### 测试域遗留（2026-10-16 登记，来源=批次移交，设计面=工程直入） -**现状**：启动装配与生命周期三件坏事实代码级实查在案——①`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 零跑〔零数值零行为变更〕；实现报告=reports/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕）**。本批立新硬规则「验收函数无变异红记录不算验收成立」，已落 CLAUDE.md 第 9 条＋code-conventions.md §3.6（该内容现已独立成文于 test-conventions.md §6）＋req-card 技能 §7 三处；GDD 反哺点三条见下条，2026-10-17 用户逐点裁决已写入 - ---- - -#### 迭代 28 启动装配与生命周期验收补全批——GDD 反哺点三条（2026-10-15 顺带登记；2026-10-17 用户逐点裁决，已写入） - -**现状**：六任务全量入库（单会话交付；变异验证六次注入全见红并精确还原；实现报告=reports/iter28-实现报告-2026-10-15.md）。实现与设计权威文档的差异/缺口如下，经裁决后另批写入文档——**机械面已顺带改动的有 roadmap/本条/07/active.md/CLAUDE.md/code-conventions.md/req-card 技能（仓外）**。**与迭代 27 反哺点①的关系**：迭代 27 只登记了「场景分层/会话生命周期陈述滞后于实态」的方向性缺口，本批把其中「层序＝谁说了算」「boot 后置条件是什么」「会话引用面何时活何时死」三件做成了代码级事实与可执行断言，本条是其**具体化承接**——写入文档时可合并处理。 - -**归属**：工程债/测试基建批完成反哺（不阻塞，不排期） - -| # | 文档 | 反哺点 | -|---|---|---| -| 1 | design/dev/architecture/architecture.md | **视觉层装配合同**＝`main.gd` 的 `LAYER_CONTRACT` 常量（16 层：屏壳/模态/全屏态/非视觉节点，含 host 宿住层与 shell 屏壳占树位两类特例），树序＝登记序＝z 序同源派生，全仓唯一落位口 `_apply_layer_contract`（散落 `move_child` 由冒烟 V1d 源码断言判红）；现行架构文档无此条款（仅在 :124 提「组合根 main.gd」、:173 提「主场景装配视图单元」）——是否立条款、合同表是否随架构文档同步摘录待裁 | -| 2 | design/dev/architecture/architecture.md | **boot 链路后置条件**：本批以 `_smoke_boot_chain` 十断言把「启动后玩家该看到什么」成文（ConfigDB 就绪且表已载／系统设置已落引擎态／菜单层可见／续玩钮态＝断点在档态／闲时会话已在树／调试浮窗态＝DS_DEBUG 门控）；架构文档启动流程（:173）只有装配动作无后置条件——是否入册待裁 | -| 3 | design/dev/architecture/architecture.md | **RunScope 生命周期存活性矩阵**：九阶段（闲时/开局停点/战斗中/结算后/选路页/终局面/回菜单收束/各模态开合后/两连局+续玩）× 五引用面（run_scope 在树／adventure／runner／settlement／四处回调句柄同源）的活死表；架构文档 :124 只登记了 RunScope 的存在——矩阵是否入册、阶段划分是否认账待裁 | - -**状态**：✅ **已写入（2026-10-17，用户逐点裁按推荐案）——三条合并入 architecture.md v1.8「呈现层装配与会话生命周期」节：①装配合同立条款、合同表不摘录（唯一事实源=`main.gd` `LAYER_CONTRACT`，登记时 16 层现为 17 项含 float 类）；②启动后置条件六条入「初始化顺序」节（登记时「十断言」现为六组 11 条——2026-10-16 角标令 V2f 拆两条）；③九阶段×五引用面存活性矩阵认账入册。代拍板追认单十三项已追认（第 14 项 req-card 双副本取齐仍待裁）；残留人闸=07 ㉗ 启动态菜单目检，登记不阻塞** - ---- - -#### 迭代 29 测试分层与门禁语义修正批——GDD 反哺点三条＋一条建议（该批漏登本清单，2026-10-17 文档批补登记并已裁决写入） - -**现状**：反哺三条与一条建议原只载于 `reports/iter29-实现报告-2026-10-16.md` §六第 2/4 项（该批未在 06 登记专条——属漏登）。2026-10-17 用户逐条裁决（全按推荐案）后写入—— - -| # | 文档 | 裁决结果与落点 | -|---|---|---| -| 1 | design/dev/test-conventions.md | 「三硬闸」与「新写测试件全类型标注」升格为纪律——写入新增 §7（闸承载三闸齐备义务＋负面套件仅豁免错误扫描一闸＋类型标注写法纪律，暂不机器闸） | -| 2 | design/dev/test-conventions.md | 「判定可靠性优先于覆盖率」独立成节——写入新增 §8（绿≠能抓住；自证手段=变异验证/反例实证/零命中自检；覆盖率度量是否引入仍 06 在册待裁） | -| 3 | design/gdd/07-体验验证清单.md | ㉖① 全流程走查**保留不注销**——屏壳切换正确性半由 `screen_flow_probe` 机检承接（入轻闸必跑段），节首加机检承接注记，版本历史加 v1.4 行 | -| ＋ | design/dev/test-conventions.md | §六第 4 项建议（脚本错误静默中断所在函数剩余断言而套件仍报全绿，三处实证）——写入 §8 机制事实＋两条义务 | - -**归属**：工程债/测试基建批完成反哺（不阻塞，不排期） - -**状态**：✅ **已写入（2026-10-17，用户逐点裁按推荐案）——落点 test-conventions.md §7–§8、07 v1.4；本条为补登记，随本批留档不再待裁** - ---- - - -#### 测试域遗留（2026-10-16 迭代 29 测试分层与门禁语义修正批登记） - -**现状**：迭代 29 把验收语义从「跑一遍没崩＝通过」扭到「三层完备＋判定可靠」，三硬闸（退出码／脚本错误扫描／断言数下限）已落地，L2/L3 从零建起承载。本批未收的余量集中登记在此，均不阻塞、不排期。 +**现状**：迭代 29 把验收语义从「跑一遍没崩＝通过」扭到「三层完备＋判定可靠」，三硬闸（退出码／脚本错误扫描／断言数下限）已落地，L2/L3 从零建起承载。本批未收的余量集中登记在此，均不阻塞、不排期： | # | 事项 | 归属与要点 | |---|---|---| @@ -752,21 +533,18 @@ | 6 | **`smoke_all.gd` 拆分**（单文件承载 1127 项检查） | 工程债批。本批按契约只做入闸与改名裁点，不拆不重构；拆分登记在册 | | 7 | **parity 逐位一致比对的触面判定为粗粒度路径匹配** | 测试基建批。触面表含 `battle_orchestrator.gd`，改该文件即要求批准发起 MC；若嫌过重可精化到「是否改动取数/结算数值」的语义面 | -**归属**：测试基建批／工程债批（不阻塞，不排期） +**归属**：测试基建批／工程债批（不阻塞，不排期）——逐条见现状表 -**状态**：**在册待裁**（七条均为本批未收的余量；迭代 29 已交付的部分见实现报告与 architecture.md 测试与质量域节） +**状态**：待写卡（备选） --- -#### 迭代 30 剔除卡②③——战斗一屏样张＋第二/三关棋盘观感（2026-10-17 用户令移本清单·状态「待设计」） +#### 迭代 30 剔除卡②③——战斗一屏样张与第二/三关棋盘观感回待设计（2026-10-17 登记，来源=会话提及，设计面=双轨） -**现状**：两卡原编入迭代 30（2026-10-16 用户令「UI 呈现三卡批」，卡片均 v1.4 零待裁残留）。卡①（未开格类型徽章批）已入库交付；卡②③经 2026-10-17 用户裁定**不满足「迭代=代码实现批」的开发条件**——卡②（战斗一屏样张）交付物本身就是设计规格（样张即设计目标图，产出尺寸档/色板/明度档清单反向给素材批，正式字体与素材均未定稿）；卡③（二三关棋盘观感）自身挂「素材轴/UI 轴」定性人闸＋甲/乙（recolor/远程生图重产）素材裁点，且若裁乙其瓦片规格依赖卡②的目标规格清单产出。两卡同日样张批开工已被用户终止（理由=「设计未完全定下来，此前可直接开发结论错误」）。剔除后 roadmap 迭代 30 位只留卡①；两卡在 `design/research/` 的 v1.4 原稿保留，作后续设计讨论的输入素材（非现行需求，重启不得直接开工）。 +**现状**：两卡原编入迭代 30（2026-10-16 用户令「UI 呈现三卡批」，卡片均 v1.4 零待裁残留）。卡①（未开格类型徽章批）已入库交付（2026-10-17，合并 `7ffd1dc0`）；卡②③经 2026-10-17 用户裁定**不满足「迭代＝代码实现批」的开发条件**剔除：卡②（战斗一屏样张）交付物本身就是设计规格（样张即设计目标图，产出尺寸档/色板/明度档清单反向给素材批，正式字体与素材均未定稿）；卡③（二三关棋盘观感）自身挂「素材轴/UI 轴」定性人闸＋甲/乙（recolor/远程生图重产）素材裁点，且若裁乙其瓦片规格依赖卡②的目标规格清单产出。两卡同日样张批开工已被用户终止（理由＝「设计未完全定下来，此前可直接开发结论错误」）。剔除后 roadmap 迭代 30 位只留卡①；两卡在 `design/research/` 的 v1.4 原稿保留（需求卡片-战斗一屏样张批-2026-10-16.md／需求卡片-二三关棋盘观感批-2026-10-16.md），作后续设计讨论的输入素材——**非已写卡状态，重启不得直接开工**。两事项的正式待办分见上方「战斗一屏样张」「第二 / 三关棋盘观感」两条件，本条为剔除事件登记，随两条件处置后注销。 -| # | 事项 | 状态 | 前置条件 | -|---|---|---|---| -| 1 | **战斗一屏样张**（原迭代 30 卡②，卡片=`design/research/需求卡片-战斗一屏样张批-2026-10-16.md`） | **待设计** | 设计讨论→需求澄清→美术定稿；定稿后重新立卡方可开发 | -| 2 | **第二/三关棋盘观感**（原迭代 30 卡③，卡片=`design/research/需求卡片-二三关棋盘观感批-2026-10-16.md`；素材轴甲/乙裁点随设计讨论重开） | **待设计** | 同上；且素材规格依赖条 1 的目标规格清单产出 | +**缺口**：还差两卡各自的设计定稿——卡②走「设计讨论→需求澄清→美术定稿」；卡③走「素材轴/UI 轴」定性＋甲/乙素材裁点裁决；均定稿后重新立卡方可开发。 **归属**：设计讨论批（不阻塞，不排期；设计权威产出归 GDD/美术文档，走设计流程非迭代实现） -**状态**：**待设计**（2026-10-17 用户令自迭代 30 剔除移入本清单；禁止未过设计定稿直接 `/iter` 开工） +**状态**：待文档设计＋待美术设计 From 8f66ae1559ec581697641679af7495d81533db84 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 18 Oct 2026 05:15:32 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs(roadmap):=20roadmap=20=E5=8E=8B?= =?UTF-8?q?=E6=88=90=E3=80=8C=E9=87=8C=E7=A8=8B=E7=A2=91=E6=97=B6=E9=97=B4?= =?UTF-8?q?=E7=BA=BF=EF=BC=8B=E8=BF=AD=E4=BB=A3=E6=80=BB=E8=A1=A8=E3=80=8D?= =?UTF-8?q?=EF=BC=8B=E6=B5=81=E6=B0=B4=E7=BA=BF=E9=97=B8=E6=B3=A8=E5=86=8C?= =?UTF-8?q?=E4=B8=8A=E7=94=B5=2008c=E2=80=94=E2=80=94=E5=88=A0=E9=99=A4?= =?UTF-8?q?=E3=80=8C=E5=BD=93=E5=89=8D=E4=BD=8D=E7=BD=AE=E3=80=8D=E8=8A=82?= =?UTF-8?q?=E4=B8=8E=E4=B8=BB=E8=B7=AF=E7=BA=BF=E8=A1=A8=E5=85=A8=E9=83=A8?= =?UTF-8?q?=E5=B7=A8=E5=9E=8B=E8=A1=8C=EF=BC=88=E5=90=84=E8=BF=AD=E4=BB=A3?= =?UTF-8?q?=E8=BF=87=E7=A8=8B=E5=8F=99=E8=BF=B0/T=20=E6=AE=B5=E6=98=8E?= =?UTF-8?q?=E7=BB=86/=E8=AF=BB=E6=95=B0/=E9=97=B8=E6=95=B0=E5=AD=97/?= =?UTF-8?q?=E8=A3=81=E5=86=B3=E8=AE=B0=E5=BD=95=E9=80=80=E5=BD=B9=E5=BD=92?= =?UTF-8?q?=20git=20=E5=8F=B2=EF=BC=8C116=E2=86=9289=20=E8=A1=8C=EF=BC=89?= =?UTF-8?q?=EF=BC=8C=E6=96=B0=E5=BB=BA=E5=85=AD=E5=88=97=E8=BF=AD=E4=BB=A3?= =?UTF-8?q?=E6=80=BB=E8=A1=A8=2030=20=E8=A1=8C=E4=B8=80=E8=A1=8C=E4=B8=80?= =?UTF-8?q?=E8=BF=AD=E4=BB=A3=EF=BC=88=E7=8A=B6=E6=80=81=3D=E5=B7=B2?= =?UTF-8?q?=E5=AE=8C=E6=88=90=EF=BC=8B=E8=90=BD=E5=9C=B0=E6=97=A5=E6=9C=9F?= =?UTF-8?q?=E8=87=AA=E3=80=8C=E2=9C=85=20=E5=AE=8C=E6=88=90/=E5=B7=B2?= =?UTF-8?q?=E5=85=A5=E5=BA=93=E3=80=8D=E5=8F=A5=E6=8F=90=E5=8F=96=EF=BC=8C?= =?UTF-8?q?=E8=BF=AD=E4=BB=A3=2017=20=E4=BB=BB=E5=8A=A1=E4=B9=A6=E6=97=A5?= =?UTF-8?q?=E6=9C=9F=E4=B8=8E=E6=96=87=E6=9C=AC=E5=86=B2=E7=AA=81=E4=BB=8E?= =?UTF-8?q?=E6=96=87=E6=9C=AC=3D2026-10-07=EF=BC=9B=E9=9C=80=E6=B1=82?= =?UTF-8?q?=E5=8D=A1=E7=89=87=E5=88=97=20design/research=20=E5=AE=9E?= =?UTF-8?q?=E5=AD=98=E5=8D=81=E5=8D=A1=E5=86=99=E5=AE=9E=E8=B7=AF=E5=BE=84?= =?UTF-8?q?=E3=80=81=E5=8D=A1=E7=89=87=E5=B7=B2=E9=80=80=E5=BD=B9=E5=8D=81?= =?UTF-8?q?=E4=B8=80=E8=BF=AD=E4=BB=A3=E5=86=99=E4=BF=9D=E7=95=99=E5=AD=97?= =?UTF-8?q?=E3=80=81=E8=BF=AD=E4=BB=A3=201~8/10=20=E6=97=A0=E5=8D=A1?= =?UTF-8?q?=E7=89=87=E5=88=B6=E5=A1=AB=E3=80=8C=E2=80=94=E3=80=8D=EF=BC=9B?= =?UTF-8?q?=E7=BC=96=E5=85=A5=E6=97=B6=E9=97=B4=209~12/14~30=20=E4=BB=8E?= =?UTF-8?q?=E6=96=87=E6=9C=AC=E4=B8=8E=E7=BC=96=E5=85=A5=E6=8F=90=E4=BA=A4?= =?UTF-8?q?=E5=8F=AF=E8=80=83=E5=8F=96=E7=9C=9F=E3=80=81=E5=85=B6=E4=BD=99?= =?UTF-8?q?=E3=80=8C=E2=80=94=E3=80=8D=EF=BC=9B=E9=A2=84=E8=AE=A1=E5=91=A8?= =?UTF-8?q?=E6=9C=9F=E5=8E=86=E5=8F=B2=E8=A1=8C=E5=85=A8=E3=80=8C=E2=80=94?= =?UTF-8?q?=E3=80=8D=E4=B8=8D=E5=81=9A=20=E2=89=A42=20=E5=91=A8=E5=88=A4?= =?UTF-8?q?=EF=BC=9B=E5=AE=9E=E7=8E=B0=E6=8A=A5=E5=91=8A=20iter27/28/29/30?= =?UTF-8?q?=20=E5=86=99=20reports/=20=E5=AE=9E=E5=AD=98=E8=B7=AF=E5=BE=84?= =?UTF-8?q?=E3=80=81=E5=85=B6=E4=BD=99=E4=BA=8C=E5=8D=81=E5=85=AD=E8=BF=AD?= =?UTF-8?q?=E4=BB=A3=E5=86=99=E9=80=80=E5=BD=B9=E4=BF=9D=E7=95=99=E5=AD=97?= =?UTF-8?q?=EF=BC=89=EF=BC=8CM3/M4=20=E9=87=8C=E7=A8=8B=E7=A2=91=E8=AF=AD?= =?UTF-8?q?=E4=B9=89=E7=AB=8B=E8=A7=84=E6=B3=A8=EF=BC=882026-10-09=20?= =?UTF-8?q?=E7=94=A8=E6=88=B7=E7=AB=8B=E8=A7=84=EF=BC=89=E5=8E=8B=E7=BC=A9?= =?UTF-8?q?=E4=B8=89=E8=A1=8C=E5=90=8E=E7=BD=AE=E4=BA=8E=E9=87=8C=E7=A8=8B?= =?UTF-8?q?=E7=A2=91=E6=97=B6=E9=97=B4=E7=BA=BF=E8=A1=A8=E5=90=8E=E8=AF=AD?= =?UTF-8?q?=E4=B9=89=E5=85=A8=E4=BF=9D=E7=95=99=EF=BC=8C=E6=89=A7=E8=A1=8C?= =?UTF-8?q?=E7=BA=AA=E5=BE=8B/=E6=89=B9=E6=AC=A1=20loop=20=E8=A7=84?= =?UTF-8?q?=E8=8C=83/=E7=BB=B4=E6=8A=A4=E7=BA=AA=E5=BE=8B=E4=B8=89?= =?UTF-8?q?=E8=8A=82=E5=8E=9F=E6=A0=B7=E4=BF=9D=E7=95=99=EF=BC=88=E5=90=AB?= =?UTF-8?q?=E6=9C=AA=E8=BF=81=20process-conventions=20=E7=9A=84=E8=BF=AD?= =?UTF-8?q?=E4=BB=A3=E7=B2=92=E5=BA=A6=E7=95=8C=E5=AE=9A=E7=AD=89=E7=AB=8B?= =?UTF-8?q?=E8=A7=84=EF=BC=89=EF=BC=8C=E6=89=A7=E8=A1=8C=E7=BA=AA=E5=BE=8B?= =?UTF-8?q?=E7=AC=AC=203=20=E6=9D=A1=E3=80=8C=E5=BD=93=E5=89=8D=E4=BD=8D?= =?UTF-8?q?=E7=BD=AE=E6=8C=82=E8=B5=B7=E6=B8=85=E5=8D=95=E3=80=8D=E6=8C=87?= =?UTF-8?q?=E9=92=88=E9=9A=8F=E8=8A=82=E5=88=A0=E9=99=A4=E6=94=B9=E6=8C=87?= =?UTF-8?q?=20active.md=20=E6=9C=AA=E5=86=B3=E9=9D=A2=EF=BC=9Bpipeline=5Fg?= =?UTF-8?q?ate.py=20=E6=9C=BA=E6=A3=80=E6=89=A9=E5=AE=B9=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E6=96=B0=E8=A1=A8=EF=BC=88=E9=9C=80=E6=B1=82=E5=8D=A1=E7=89=87?= =?UTF-8?q?/=E7=BC=96=E5=85=A5=E6=97=B6=E9=97=B4/=E9=A2=84=E8=AE=A1?= =?UTF-8?q?=E5=91=A8=E6=9C=9F=E4=B8=89=E5=88=97=E3=80=8C=E2=80=94=E3=80=8D?= =?UTF-8?q?=E5=90=88=E6=B3=95=3D=E5=8E=86=E5=8F=B2=E8=A1=8C=E8=B1=81?= =?UTF-8?q?=E5=85=8D=EF=BC=8B=E5=AE=9E=E7=8E=B0=E6=8A=A5=E5=91=8A=E5=88=97?= =?UTF-8?q?=E5=B7=B2=E5=AE=8C=E6=88=90=3D=E5=AD=98=E5=9C=A8=E8=B7=AF?= =?UTF-8?q?=E5=BE=84=E6=88=96=E9=80=80=E5=BD=B9=E4=BF=9D=E7=95=99=E5=AD=97?= =?UTF-8?q?=E3=80=81=E5=AF=B9=E3=80=8C=E2=80=94=E3=80=8D=E7=BB=B4=E6=8C=81?= =?UTF-8?q?=E5=88=A4=E7=BA=A2=EF=BC=8C=E5=A4=B4=E6=B3=A8=E6=97=A7=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F=E5=A3=B0=E6=98=8E=E6=8D=A2=E4=BB=A3=EF=BC=89=EF=BC=8C?= =?UTF-8?q?doc-conventions=20=C2=A712.2=20=E5=9B=9B=E5=88=97=E8=A7=84?= =?UTF-8?q?=E5=88=99=E5=90=8C=E6=AD=A5=E8=A1=A5=E3=80=8C=E5=8E=86=E5=8F=B2?= =?UTF-8?q?=E8=BF=AD=E4=BB=A3=E4=B8=8D=E5=8F=AF=E8=80=83=E5=A1=AB=E2=80=94?= =?UTF-8?q?=E3=80=8D=E4=B8=8E=E5=B7=B2=E5=AE=8C=E6=88=90=E6=8A=A5=E5=91=8A?= =?UTF-8?q?=E5=88=97=E4=B8=A5=E6=A0=BC=E5=8F=A5=EF=BC=9Brun=5Fall=5Fgates.?= =?UTF-8?q?sh=20=E6=96=87=E6=A1=A3=E5=9F=9F=2008b=20=E4=B9=8B=E5=90=8E?= =?UTF-8?q?=E6=B3=A8=E5=86=8C=E3=80=8C08c=20=E6=B5=81=E6=B0=B4=E7=BA=BF?= =?UTF-8?q?=E9=97=B8=E3=80=8D=EF=BC=88=E7=85=A7=E6=8A=84=E7=9B=B8=E9=82=BB?= =?UTF-8?q?=E8=A1=8C=E5=BD=A2=E6=80=81=EF=BC=8C=E9=97=B8=E5=BA=8F=E5=85=B6?= =?UTF-8?q?=E4=BD=99=E9=9B=B6=E6=94=B9=E5=8A=A8=EF=BC=89=EF=BC=8B=E5=A4=B4?= =?UTF-8?q?=E6=B3=A8=20--docs=20=E9=97=B8=E6=B8=85=E5=8D=95=E8=A1=A5=2008c?= =?UTF-8?q?=EF=BC=8B=E5=9F=9F=E6=A8=AA=E5=B9=85=206=E2=80=938c=EF=BC=9Bbas?= =?UTF-8?q?eline.json=20=E6=89=8B=E5=B7=A5=E5=8A=A0=E5=85=A5=2008c=20?= =?UTF-8?q?=E7=BB=BF=E8=AE=B0=E5=BD=95=EF=BC=88=E6=96=B0=E9=97=B8=E4=BB=B6?= =?UTF-8?q?=E6=97=A0=E5=9F=BA=E7=BA=BF=E8=AE=B0=E5=BD=95=E5=BF=85=E5=88=A4?= =?UTF-8?q?=E9=97=B8=E5=86=B5=E5=8F=98=E5=8C=96=E6=8B=A6=E5=90=88=E5=9B=9E?= =?UTF-8?q?=E6=94=B6=E6=89=A7=EF=BC=8C=E5=85=B6=E4=BD=99=E6=9D=A1=E7=9B=AE?= =?UTF-8?q?=E5=8E=9F=E6=A0=B7=E4=BF=9D=E7=95=99=EF=BC=89=EF=BC=9B06=20?= =?UTF-8?q?=E4=BF=AE=E5=AD=98=E9=87=8F=E9=80=80=E5=BD=B9=E8=AF=8D=E5=9B=9B?= =?UTF-8?q?=E7=AC=94=E3=80=8C=E9=9A=8F=E6=89=B9=E5=91=88=E6=8A=A5=E2=86=92?= =?UTF-8?q?=E9=A1=BA=E5=B8=A6=E5=91=88=E6=8A=A5=E3=80=8D=EF=BC=88b4671802?= =?UTF-8?q?=20=E5=9B=9E=E5=A1=AB=E6=89=B9=E5=B8=A6=E5=85=A5=E3=80=81doc=5F?= =?UTF-8?q?term=20--strict=20=E9=A6=96=E6=AC=A1=E5=85=A8=E9=87=8F=E8=B7=91?= =?UTF-8?q?=E6=9A=B4=E9=9C=B2=EF=BC=8C=E9=9D=9E=E6=9C=AC=E6=89=B9=E5=BC=95?= =?UTF-8?q?=E5=85=A5=EF=BC=89=E3=80=82=E8=87=AA=E6=A3=80=EF=BC=9Apython=20?= =?UTF-8?q?tools/pipeline=5Fgate.py=3DPASS=EF=BC=8806=20=E6=9D=A1=E7=9B=AE?= =?UTF-8?q?=2051=C2=B7=E6=80=BB=E8=A1=A8=E6=95=B0=E6=8D=AE=E8=A1=8C=2030?= =?UTF-8?q?=C2=B7=E4=BA=A4=E5=8F=89=E6=A0=B8=200=20=E9=93=BE=E5=85=A8?= =?UTF-8?q?=E8=BF=87=EF=BC=89exit=200=EF=BC=9Bbash=20tools/run=5Fall=5Fgat?= =?UTF-8?q?es.sh=20--docs=3D=E5=85=AD=E9=97=B8=E5=85=A8=E7=BB=BF=E6=97=A0?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=E7=BA=A2=20exit=200?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/dev/doc-conventions.md | 8 +-- design/gdd/06-待办清单.md | 8 +-- game/tests/.gates/baseline.json | 6 +- roadmap.md | 104 ++++++++++++-------------------- tools/pipeline_gate.py | 33 +++++----- tools/run_all_gates.sh | 7 ++- 6 files changed, 75 insertions(+), 91 deletions(-) diff --git a/design/dev/doc-conventions.md b/design/dev/doc-conventions.md index f410f6d4..f39033f0 100644 --- a/design/dev/doc-conventions.md +++ b/design/dev/doc-conventions.md @@ -182,10 +182,10 @@ roadmap 由顶部里程碑表＋迭代总表组成，迭代总表一行一个迭 |---|---| | 迭代号 | 写「迭代 N」形态（N 为阿拉伯数字）；这是流水线闸交叉核匹配的依据 | | 状态 | 待开工 ／ 进行中 ／ 已完成（YYYY-MM-DD）／ 已终止（YYYY-MM-DD） | -| 需求卡片 | 只写文件路径；一格内一行一卡，格内排列顺序=执行顺序；已退役填保留字「已退役（git 历史可考）」 | -| 编入时间 | YYYY-MM-DD（该迭代最近一次编入卡片的日期） | -| 预计周期 | ≈N 周（0.5 步进，N ≤ 2）；超过 2 周须随带日期的用户特批标记（格式见 12.4），流水线闸见标记放行、无标记判红 | -| 实现报告 | `reports/iterN-实现报告-YYYY-MM-DD.md`；未完成=「—」；退役=「已退役（git 历史可考）」 | +| 需求卡片 | 只写文件路径；一格内一行一卡，格内排列顺序=执行顺序；已退役填保留字「已退役（git 历史可考）」；历史迭代不可考填「—」（早期无卡片制的迭代） | +| 编入时间 | YYYY-MM-DD（该迭代最近一次编入卡片的日期）；历史迭代不可考填「—」 | +| 预计周期 | ≈N 周（0.5 步进，N ≤ 2）；超过 2 周须随带日期的用户特批标记（格式见 12.4），流水线闸见标记放行、无标记判红；历史迭代不可考填「—」（不做 ≤2 周判） | +| 实现报告 | `reports/iterN-实现报告-YYYY-MM-DD.md`；未完成=「—」；退役=「已退役（git 历史可考）」；已完成迭代只许存在路径或退役保留字、禁「—」 | 迭代行禁入内容：事项说明、卡序叙述、T 段明细、读数、闸数字、裁点记录、门依赖。卡间依赖写在卡片自身，行内只放上表六列的事实。特批标记同样可用于 roadmap 格（须带日期，见 12.4）。 diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index d355e333..3e3de13f 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -107,9 +107,9 @@ #### 天赋树实装批登记欠账余两件——AP 上限 clamp 与三选一刷新软上限（2026-10-12 登记，来源=批次移交，设计面=文档轨） -**现状**：迭代 21 天赋树实装批顺带入册欠账三条，2026-10-13 三件终态：① **AP 上限 clamp 缺位（缺陷）**——树「开局姿态」（每关首轮 AP+1）、AP 件、时沙同走 `action_economy.gd:239 _pending_ap_delta` 排队，轮始兑现仅下限钳制（`:254 maxi(0, …)`，无上限）；**用户裁暂不设上限**——provisional 天花板亦不投，随 Alpha 收官 M4 数值批连同全部 AP 数值统一标定。② **三选一刷新软上限（设计问）**——停点内 GP 付费刷新倍率增长（×1.8/次曲线）×停点间基础价随进度递增，全程无软上限；**定性确认＝设计问非缺陷，用户裁维持现状**，归 M4 数值批调参窗口处理，不提前单开讨论。③ **Y（_attune_refresh_y）不入断点存档（可利用漏洞）**——已修复注销（2026-10-13 用户令提前单独开修：断点快照扩列 `attune_refresh_y`＋续玩 `resume_adventure` 优先读断点〔缺键回退参数面＝旧档行为零变化〕＋单测两断言；冒烟 938/0+单测 24 套全绿）。①②成裁晚于 M4 卡 v1.2（2026-10-06 定稿），尚未入卡范围，跑批前须并入或随批呈报。 +**现状**：迭代 21 天赋树实装批顺带入册欠账三条，2026-10-13 三件终态：① **AP 上限 clamp 缺位（缺陷）**——树「开局姿态」（每关首轮 AP+1）、AP 件、时沙同走 `action_economy.gd:239 _pending_ap_delta` 排队，轮始兑现仅下限钳制（`:254 maxi(0, …)`，无上限）；**用户裁暂不设上限**——provisional 天花板亦不投，随 Alpha 收官 M4 数值批连同全部 AP 数值统一标定。② **三选一刷新软上限（设计问）**——停点内 GP 付费刷新倍率增长（×1.8/次曲线）×停点间基础价随进度递增，全程无软上限；**定性确认＝设计问非缺陷，用户裁维持现状**，归 M4 数值批调参窗口处理，不提前单开讨论。③ **Y（_attune_refresh_y）不入断点存档（可利用漏洞）**——已修复注销（2026-10-13 用户令提前单独开修：断点快照扩列 `attune_refresh_y`＋续玩 `resume_adventure` 优先读断点〔缺键回退参数面＝旧档行为零变化〕＋单测两断言；冒烟 938/0+单测 24 套全绿）。①②成裁晚于 M4 卡 v1.2（2026-10-06 定稿），尚未入卡范围，跑批前须并入或顺带呈报。 -**缺口**：还差 M4 数值批跑批窗口的标定执行——①②尚未入 M4 卡 v1.2 范围，跑批前须并入卡片或随批呈报。 +**缺口**：还差 M4 数值批跑批窗口的标定执行——①②尚未入 M4 卡 v1.2 范围，跑批前须并入卡片或顺带呈报。 **归属**：① [行动经济](systems/排雷循环/行动经济.md)；② 行动经济+三选一/商店刷新经济（数值归 Alpha 收官 M4 数值批）；③ [存档序列化](systems/表现与支撑/存档序列化.md)（断点域）+ [冒险结构](systems/冒险循环/冒险结构.md)（续玩参数面）——③已修复注销 @@ -211,7 +211,7 @@ #### GP 经济换算失衡——GP 袋面值与商店价格的换算关系复查（2026-10-07 登记，来源=审计发现，设计面=文档轨） -**现状**：道具三层审查的换算发现——小 GP 袋 20 ≈ 商店两三次首购（首购基价 4-5、A 链爬升前）≈ +2~4 点属性，而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算，且 GP 袋是池内最大户（23/98 张）进一步放大倾向。用户判「太离谱」。复查范围＝GP 袋面值（20/50）× 商店基价（4/4/4/5）× 价格曲线（A=1.8 / b=1.1）× 战斗 GP 掉落（普通 3 / 精英 5 / Boss 8，关级加值 0/1/2）四处联动；目标＝钱与属性件的换算效率回到设计意图（拿钱 vs 拿数值的取舍成立；GP 袋最大户地位要么有理由要么让位）。连带前提：L1 无商店节点使 GP 在第一关无消费口——「L1 商店编排」不另立条目、归本条复查范围（按 L1 是否补商店分两种情形各算一遍）。随 M4 数值批一并裁决；本条登记（2026-10-07）晚于 M4 卡 v1.2 定稿（2026-10-06），尚未入卡范围，跑批前须并入或随批呈报。 +**现状**：道具三层审查的换算发现——小 GP 袋 20 ≈ 商店两三次首购（首购基价 4-5、A 链爬升前）≈ +2~4 点属性，而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算，且 GP 袋是池内最大户（23/98 张）进一步放大倾向。用户判「太离谱」。复查范围＝GP 袋面值（20/50）× 商店基价（4/4/4/5）× 价格曲线（A=1.8 / b=1.1）× 战斗 GP 掉落（普通 3 / 精英 5 / Boss 8，关级加值 0/1/2）四处联动；目标＝钱与属性件的换算效率回到设计意图（拿钱 vs 拿数值的取舍成立；GP 袋最大户地位要么有理由要么让位）。连带前提：L1 无商店节点使 GP 在第一关无消费口——「L1 商店编排」不另立条目、归本条复查范围（按 L1 是否补商店分两种情形各算一遍）。随 M4 数值批一并裁决；本条登记（2026-10-07）晚于 M4 卡 v1.2 定稿（2026-10-06），尚未入卡范围，跑批前须并入或顺带呈报。 **缺口**：还差四处联动的换算复查设计（含 L1 商店编排两种情形）——随 M4 数值批窗口执行，尚未入卡。 @@ -229,7 +229,7 @@ #### 调参批数值点评登记（2026-10-01 登记，来源=批次移交，设计面=文档轨） -**现状**：格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 50/25 不对称是否有意；② 削弱型 65/25 同问（且 percent 套个位数取整偏粗）；③ 回血奖励过薄（值 1、权重全池最低 2）；④ 警觉/行动点修正两新词数值全部 provisional；⑤ 行动经济"满停一轮＝一刷"节拍在 AP±1 修正下的对账——①-⑤五条已入 M4 数值批卡 v1.2 件②（F5，逐条裁决落文）；⑥ **格面资源正负兑付倍率差回调（2026-10-07 用户裁）**——2026-10-01「踩雷必须痛」抬档（heal +2/−6、pierce/magic +2/−8 等，负向 3-4 倍于正向）系错误的加难杠杆：难度提升应走怪物性能路线而非抬地图惩罚，回调归 M4 数值批，标错/开雷同档同罚维持不动（同批裁）——⑥成裁晚于卡 v1.2，尚未入卡，跑批前须并入或随批呈报。里程碑立规（2026-10-09）：M4＝Beta 阶段、M3 未由用户明令关闭前不排期。 +**现状**：格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 50/25 不对称是否有意；② 削弱型 65/25 同问（且 percent 套个位数取整偏粗）；③ 回血奖励过薄（值 1、权重全池最低 2）；④ 警觉/行动点修正两新词数值全部 provisional；⑤ 行动经济"满停一轮＝一刷"节拍在 AP±1 修正下的对账——①-⑤五条已入 M4 数值批卡 v1.2 件②（F5，逐条裁决落文）；⑥ **格面资源正负兑付倍率差回调（2026-10-07 用户裁）**——2026-10-01「踩雷必须痛」抬档（heal +2/−6、pierce/magic +2/−8 等，负向 3-4 倍于正向）系错误的加难杠杆：难度提升应走怪物性能路线而非抬地图惩罚，回调归 M4 数值批，标错/开雷同档同罚维持不动（同批裁）——⑥成裁晚于卡 v1.2，尚未入卡，跑批前须并入或顺带呈报。里程碑立规（2026-10-09）：M4＝Beta 阶段、M3 未由用户明令关闭前不排期。 **归属**：[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)难度曲线调参批 diff --git a/game/tests/.gates/baseline.json b/game/tests/.gates/baseline.json index 45a7a413..b78ea52f 100644 --- a/game/tests/.gates/baseline.json +++ b/game/tests/.gates/baseline.json @@ -1,5 +1,5 @@ { - "note": "存量基线·首次自动生成；闸况变化时本脚本会判红，需人工确认后重生成；2026-10-17 人工确认重生成 06 条目：af94ce97 把 gdd_lint 记为存量红（01 篇 R5），该红已由 fcb8c3f8 补流程图消除，实测 --docs 域 06 exit=0，故基线改回绿。", + "note": "存量基线·首次自动生成；闸况变化时本脚本会判红，需人工确认后重生成；2026-10-17 人工确认重生成 06 条目：af94ce97 把 gdd_lint 记为存量红（01 篇 R5），该红已由 fcb8c3f8 补流程图消除，实测 --docs 域 06 exit=0，故基线改回绿。2026-10-18 新增闸件 08c 流水线闸（tools/pipeline_gate.py 注册上电），手工加入绿记录（roadmap 压缩批实测 --docs 域 exit=0），其余条目原样保留。", "gates": { "01 冒烟全量": { "exit": "0", @@ -37,6 +37,10 @@ "exit": "0", "fp": "green" }, + "08c 流水线闸": { + "exit": "0", + "fp": "green" + }, "09 静态扫描": { "exit": "1", "fp": "4354b2aa72a7" diff --git a/roadmap.md b/roadmap.md index f4d46b8a..70b1001c 100644 --- a/roadmap.md +++ b/roadmap.md @@ -1,7 +1,6 @@ # 工程路线图（批次执行制：里程碑 + 批次序列 + loop 规范） > 一句话：项目级进度视图——走到哪了、接下来按什么顺序走、每个批怎么跑。**实时状态以仓库根 [active.md](active.md) 顶部「当前状态快照」节为准**（会话级、高频更新）；待办事项明细以 [06-待办清单](design/gdd/06-待办清单.md) 为唯一登记处（条目级）；本文件只管批级序列与门，里程碑移动才更新。 -> 成文 2026-09-17；**2026-09-27 重整为批次执行制**（用户立规：任务一律按本路线图批次统一执行、零散并行会话退场——冲突源与介入成本；同日二次修订：粒度对齐敏捷流程——里程碑=发布级目标、迭代=多任务增量交付单元，详见「执行纪律」与「迭代粒度界定」）；**2026-09-28 里程碑重排**（M-1 初步验收通过精简收档；**关卡画面独立化立项 M-2 高优先级**——用户裁决独立屏为最终形态；原数值/内容里程碑顺延为 M-3/M-4，迭代号随里程碑重排：原迭代 3/4 → 迭代 5/6）；**2026-09-29 迭代重排**（用户裁决：Alpha 验收=对「大部分游戏内容逻辑闭环」版本的验收，内容闭环前验收无意义——战斗演出前移迭代 6、魔法道具+元进度标定编入迭代 7、Alpha 验收后移迭代 8；M-3 更名「数值标定与 Alpha 创建」，M-4 转 Alpha 后深化）；**同日二批**（全流程闭环审计+四裁：审计六件归属落表——四件入迭代 6/两件原裁迭代 7；**冒险续玩断点立项**（用户裁「中断可续玩、退出即结算」两口径分离）→迭代 7 超 3-8 卡上限,拆出新迭代 8「续玩断点+设置面+打磨包」,设置面/打磨包随移,Alpha 验收顺延迭代 9；美术素材**不入 git 维持**（生产资产目录 game/assets/art 同样豁免,补 .gitignore 归迭代 6 T0）；营地 2D 画面缓 M-4 再议）。 ## 里程碑时间线 @@ -21,79 +20,54 @@ | 2026-09-28 | **M-2 关卡画面独立化完成（迭代 3+4 已入库，出口闸目检通过）**：独立屏 LevelMapScreen+独立性断言（状态记录 224）/关卡画面样张 v1 机检 11/11 冻结+节点图标组接线+终稿落码+换层挂点（art-bible v2.14，状态记录 225）；出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` 用户八项目检通过（状态记录 227） | | 2026-09-29 | **迭代重排（用户裁决「内容逻辑闭环先于验收」）**：M-3 更名「数值标定与 Alpha 创建」——战斗演出完善前移迭代 6、魔法道具+元进度标定编入迭代 7、Alpha 验收后移迭代 8；M-4 转 Alpha 后深化与内容扩展（本批，状态记录 242） | -## 当前位置（2026-10-16 刷新） +> **里程碑语义（2026-10-09 用户立规，现行口径）**：现行里程碑 = **M3「Alpha 版本的完整实现」**；M4 = Beta 版本的完整实现。用户未明令宣布 M3 完成前，项目停留在 M3 阶段——迭代规划只编排 M3（Alpha 完整实现）相关需求，M4 内容一律不排期、不进迭代，M4 的门 = 用户明令 M3 完成。2026-10-03「M-3 关闭、Alpha 到手」为验收史记录保留（旧口径 = Alpha 验收到手）；上表旧编号 M-1~M-4 保留作历史序列（M-3 旧名「数值标定与 Alpha 创建」，M-4 旧义「Alpha 后深化与内容扩展」），语义以本注为准。 -- **里程碑语义（2026-10-09 立规换代，详见下方里程碑表的换代注）**：现行里程碑 = **M3「Alpha 版本的完整实现」**——用户未明令宣布完成前停留 M3，迭代只排 M3 需求；M4=Beta 版本的完整实现，一律不排期。下文里程碑表的旧编号（M-3/M-4）保留作历史序列，语义以本节为准。 -- **迭代进度**：迭代 19 五卡全部已入库（2026-10-08）；**迭代 20=专长实装批 ✅ 已入库**（2026-10-11，出口闸全绿；残留人闸=实机目检五件+V20/V21/V22 人工核对半，07 在册）；**迭代 21=天赋树实装批 ✅ 已入库（2026-10-12 U0 开工单会话交付，T0-T7 全绿；残留人闸=实机目检四柜台）**；**迭代 22=秘宝体系实现重构落地批 ✅ 已入库（2026-10-12 单会话交付，T1-T7 全绿；残留人闸=实机目检秘宝解锁-装配流程）**；**迭代 23=锻造工坊实装批 ✅ 已入库（2026-10-12 单会话交付，T0-T7 全绿；残留人闸=实机目检工作间形态与购买交互）**；**迭代 24=敌人表内容修批（三关）✅ 已入库（2026-10-13 /goal+iter U0 开工单会话交付——N1 (1,2) 降档 hp22/ac2·N2 毒吐盾击两行六池·N3 敌方 attack_type 轴全填 normal+敌方结算克制消费点；冒烟 949/0+run_all 25 套+重闸全绿+MC 同种子配对 40 局×both 位移在带；实现报告已退役（git 历史可考）；残留人闸=实机目检三观测〔07 ㉓〕；代拍板追认单+GDD 反哺点五条待用户；**本迭代位仍预留后续追加卡——用户将把其他需求陆续编入本迭代**）；；**迭代 25=UI 全局主题批 ✅ 已入库**（2026-10-13 用户令编入，/goal+iter U0 单会话交付：全局主题资源 main_theme.tres 挂载+两处局部做法退役+冒烟 V1-V6 断言 38 条，冒烟 987/0+重闸全绿；实现报告已退役（git 历史可考）；残留人闸=实机目检全屏巡检〔07 ㉔〕）；**迭代 26=UI 交互与观感批已编入待开工**（2026-10-14 用户令；需求卡片 v1.2 零待裁点；开工门=U0——用户新会话 /iter 26 发令；本迭代位预留后续追加卡，同迭代 24 先例）；**迭代 27=代码架构技术债修复批 ✅ 已入库**（2026-10-14 /goal+iter U0 开工单会话交付：三屏场景化+会话物化+五段 Segment+RunLedger+ModalFlow+类型闸+卫生件五波全落；逐位一致对拍三变体五跑全同；实现报告=reports/iter27-实现报告-2026-10-14.md；残留人闸=实机目检五件〔07 ㉖〕；代拍板追认单十五项已追认（2026-10-17 用户令全同意）+GDD 反哺点两条已于 2026-10-17 用户逐条裁决写入）；**迭代 28=启动装配与生命周期验收补全批 ✅ 已入库**（2026-10-15 用户令编入并预批连做全批，单会话交付：T1 装配语义合同 `LAYER_CONTRACT` 单点化＋冒险屏先挂/菜单屏后挂的顺序修复＋V1a-d 断言重写／T2 `_smoke_boot_chain` boot 链路十断言／T3 `_smoke_lifecycle_matrix` 九阶段×五引用面／T4 渲染面三件（shot_probe 两自检＋shot_checker 墨色判据＋启动态菜单 golden）／T5 变异验证六次注入全见红并精确还原／T6 规范三处落文；冒烟 **1086/0→1125/0**（+39＝新增 42−退役裸下标断言 3）；实现报告=reports/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕；代拍板追认单十三项已追认（含四条白名单外，2026-10-17 用户令全同意；第 14 项「req-card 双副本是否取齐」仍待裁）＋GDD 反哺点三条已于 2026-10-17 用户逐条裁决写入）；**迭代 29=测试分层与门禁语义修正批 ✅ 已入库**（2026-10-16 /iter U0 开工单会话交付：T1 三硬闸〔退出码／脚本错误扫描／断言数下限，三反例改前判绿改后判红〕／T2 术语订正＋CI 残留 8 处清除／T3 `tests/integration/` 建承载＋parity 收编为重闸 11 号条件闸件／T4 `screen_flow_probe` 入轻闸／T5 新增六套单测〔27→33 套〕／T6 S3 路径修正＋零命中自检＋补 S5／T7 游离脚本台账＋golden 判有效／T8 架构事实源三张表回写＋06 登记遗留七条；冒烟 1127/0 持平、重闸全绿存量红零新增；实现报告=reports/iter29-实现报告-2026-10-16.md；**无用户目检项**；代拍板追认单十二项已追认（2026-10-17 用户令全同意）＋GDD 反哺点三条待用户裁决；**遗留：11 号闸 parity 对拍判为触面，需用户批准才发起**）；**迭代 30=UI 呈现批：卡①未开格类型徽章批 ✅ 已入库**（2026-10-17，7ffd1dc0；冒烟 1151/0、单测 34 套、渲染闸全绿、golden 0.10–0.14% 判有效；原卡②③已于 2026-10-17 用户令剔除——待设计归 06，见迭代 30 表行）；**迭代 31+ 位空·无批次**（原 M4 数值批已废——2026-10-16 用户删卡令「它就不是一个应该存在的东西」，禁止再以该名义立批/规划/引用已删卡；四项数值欠账归 06 在册、重新归属待用户裁）。 -- **近期主战场**：迭代 20/21/22/23/24/25/26 残留人闸（实机目检六批，07 在册）；**迭代 29 已入库；迭代 30 卡①已入库、卡②③已剔除归 06 待设计（2026-10-17 用户令）**（迭代 29 入库后遗留=11 号闸 parity 对拍待批准发起＋GDD 反哺三条已裁决写入（2026-10-17）；迭代 30=UI 呈现批，卡①未开格类型徽章批 2026-10-17 已入库 7ffd1dc0；卡②战斗一屏样张/③第二三关棋盘观感本质为设计澄清/美术定稿环节、不满足代码实现批开发条件，移 06 待设计，见迭代 30 表行）；各批 provisional 终值的统一标定义务随 M4 数值批废除归 06 在册、重新归属待裁；迭代 20~28 残留人闸八批 07 在册）。 -- **实时状态**：以根目录 [active.md](active.md) 顶部「当前状态快照」节为准（`stage.txt` 已定性为旧阶段开关，仅存档）。 +## 迭代总表 -## 主线路线（里程碑 × 迭代序列） +一行一个迭代，回答一个问题：这个迭代编入了哪些卡、做到哪一步。各列格式与判据见 doc-conventions §12.2，由流水线闸（`tools/pipeline_gate.py`）机检。 -> **提案序，开工逐迭代点名**；每个迭代 = 一个 loop（规范与粒度界定见下节）。迭代内任务卡的事实源 = 06-待办清单对应条目 + 各 UX spec 的 AC。 +| 迭代代号 | 状态 | 需求卡片 | 编入时间 | 预计周期 | 实现报告 | +|---|---|---|---|---|---| +| 迭代 1 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） | +| 迭代 2 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） | +| 迭代 3 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） | +| 迭代 4 | 已完成（2026-09-28） | — | — | — | 已退役（git 历史可考） | +| 迭代 5 | 已完成（2026-09-30） | — | — | — | 已退役（git 历史可考） | +| 迭代 6 | 已完成（2026-09-29） | — | — | — | 已退役（git 历史可考） | +| 迭代 7 | 已完成（2026-09-29） | — | — | — | 已退役（git 历史可考） | +| 迭代 8 | 已完成（2026-09-29） | — | — | — | 已退役（git 历史可考） | +| 迭代 9 | 已完成（2026-10-03） | 已退役（git 历史可考） | 2026-09-30 | — | 已退役（git 历史可考） | +| 迭代 10 | 已完成（2026-10-01） | — | 2026-09-30 | — | 已退役（git 历史可考） | +| 迭代 11 | 已完成（2026-10-03） | 已退役（git 历史可考） | 2026-10-03 | — | 已退役（git 历史可考） | +| 迭代 12 | 已完成（2026-10-04） | 已退役（git 历史可考） | 2026-10-03 | — | 已退役（git 历史可考） | +| 迭代 13 | 已完成（2026-10-04） | 已退役（git 历史可考） | — | — | 已退役（git 历史可考） | +| 迭代 14 | 已完成（2026-10-05） | 已退役（git 历史可考） | 2026-10-04 | — | 已退役（git 历史可考） | +| 迭代 15 | 已完成（2026-10-05） | 已退役（git 历史可考） | 2026-10-05 | — | 已退役（git 历史可考） | +| 迭代 16 | 已完成（2026-10-06） | 已退役（git 历史可考） | 2026-10-05 | — | 已退役（git 历史可考） | +| 迭代 17 | 已完成（2026-10-07） | 已退役（git 历史可考） | 2026-10-06 | — | 已退役（git 历史可考） | +| 迭代 18 | 已完成（2026-10-07） | 已退役（git 历史可考） | 2026-10-07 | — | 已退役（git 历史可考） | +| 迭代 19 | 已完成（2026-10-08） | 已退役（git 历史可考） | 2026-10-08 | — | 已退役（git 历史可考） | +| 迭代 20 | 已完成（2026-10-11） | design/research/需求卡片-专长实装批-2026-10-11.md | 2026-10-11 | — | 已退役（git 历史可考） | +| 迭代 21 | 已完成（2026-10-12） | design/research/需求卡片-天赋树实装批-2026-10-11.md | 2026-10-11 | — | 已退役（git 历史可考） | +| 迭代 22 | 已完成（2026-10-12） | design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md | 2026-10-11 | — | 已退役（git 历史可考） | +| 迭代 23 | 已完成（2026-10-12） | design/research/需求卡片-锻造工坊实装批-2026-10-12.md | 2026-10-12 | — | 已退役（git 历史可考） | +| 迭代 24 | 已完成（2026-10-13） | design/research/需求卡片-敌人表内容修批-2026-10-13.md | 2026-10-13 | — | 已退役（git 历史可考） | +| 迭代 25 | 已完成（2026-10-13） | design/research/需求卡片-UI全局主题批-2026-10-13.md | 2026-10-13 | — | 已退役（git 历史可考） | +| 迭代 26 | 已完成（2026-10-14） | design/research/需求卡片-UI交互与观感批-2026-10-13.md | 2026-10-14 | — | 已退役（git 历史可考） | +| 迭代 27 | 已完成（2026-10-14） | design/research/需求卡片-代码架构技术债修复批-2026-10-14.md | 2026-10-14 | — | reports/iter27-实现报告-2026-10-14.md | +| 迭代 28 | 已完成（2026-10-15） | 已退役（git 历史可考） | 2026-10-15 | — | reports/iter28-实现报告-2026-10-15.md | +| 迭代 29 | 已完成（2026-10-16） | design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md | 2026-10-16 | — | reports/iter29-实现报告-2026-10-16.md | +| 迭代 30 | 已完成（2026-10-17） | design/research/需求卡片-未开格类型徽章批-2026-10-16.md | 2026-10-16 | — | reports/iter30-实现报告-2026-10-17.md | -### M-1 切片表现收口（Release 1） - -**✅ 完成（2026-09-28 初步验收通过）**——迭代 1「测试兜底与表现先行」（六卡）+ 迭代 2「样张冻结与表现定稿」（五批次）已入库，出口检查真人目检过。明细归 git 历史 + 出口检查单 `design/qa/m1-exit-gate-checklist-2026-09-28.md` + active.md 状态记录 215-222。 - -### M-2 关卡画面独立化（Release 2） - -**✅ 完成（2026-09-28 出口闸通过）**——迭代 3「独立屏架构」（四批次）+ 迭代 4「关卡画面视觉终稿」（五批次）已入库，出口检查真人目检八项全过。明细归 git 历史 + 出口检查单 `design/qa/m2-exit-gate-checklist-2026-09-28.md` + active.md 状态记录 224-225。 - -### M-3 数值标定与 Alpha 创建（Release 3，**已关闭 2026-10-03——迭代 9 出口闸过、Alpha 到手**；2026-10-09 口径换代注：「已关闭」系旧口径=Alpha 验收到手，新口径 M3=Alpha 完整实现仍在进行——见 M-4 节头立规注） - -> **2026-09-29 用户重裁**：Alpha=大部分游戏内容逻辑闭环的可玩版本，验收只对该状态有意义——原迭代 6「Alpha 验收」排在战斗演出/魔法道具之前属倒置，后移为迭代 8；战斗演出完善前移迭代 6（原 M-4 迭代 7），魔法道具+元进度标定编入迭代 7。原「读数不被呈现改动扰动」的顾虑只约束模拟读数（走逻辑层，呈现改动本就不触），真人读数（目检/通关率/07 对账）必须等内容闭环后采集才有效。**同日二批补充**：审计追加卡落表后，续玩断点（新需求）使迭代 7 超 3-8 卡上限——拆出新迭代 8「冒险续玩断点+设置面+打磨包」（代排待追认），Alpha 验收顺延迭代 9。 - -| # | 迭代 | 门（进入条件） | 更改任务 | -|---|---|---|---| -| 迭代 5 | 读数重测与调参（原迭代 3） | M-2 出口闸；⑤号卡另需统一流裁决（已裁落地） | ——**✅ 完成（2026-09-28 五卡已入库）**：基线重测〔三越带初判〕+杠杆扫描〔C3 组合锁值：岩浆1/plb0/percent4/卓尔100〕+AC 投值〔Boss-only 台阶 8/9/12〕+节点图生成特性批〔15 骨架+node_map 扩签+首次冒险脚本，冒烟 557→576〕；读数挂账〔完美 L1 丙·普通 L2 17.1% AC〕归出口人闸追认；明细=迭代 5 状态记录 230-241+design/qa 三报告。**2026-09-29 返工批**（U2 人闸三推翻两追认+目检 15/15 不过，状态记录 246/247）：C1 两刀终态+AC v1 硬梯度重投+节点图池两规则重生成〔L1 前三位纯战斗/L2L3 层宽 4-5，模板 0 随重排〕——终态双窗读数〔普通 L1 ✓·普通 L2 10.6/13.6% ✗·完美 L1 84% 甲挂账→荆棘外延提案待批·完美 L2 22/32% ✗〕，缺口数字待批点丙追认；二轮目检=返工批出口人闸；**2026-09-30 出口三件全闭（收口批 fe520af/合并 3933723+补丁批，状态记录 290）**——①二轮目检 15/15 过（T-C 过闸）②普通 L2 带改 [10,15]+批点丙追认成立（10.6/13.6% 落带，组合基线转正；完美 L2 22/32% 越带用户整体表态知情接受、带不动）③荆棘外延提案否决→根因改判「战斗阶段数值问题」06 待讨论——**迭代 5 返工出口成立** | -| 迭代 6 | 战斗演出完善（原 M-4 迭代 7，2026-09-29 前移；2026-09-28 用户立项，收编历史登记「战斗表现批」——状态记录 106「真实立绘/动画密度终稿归战斗表现批」,前置 P0 样张已随 M-1 解除） | 迭代 5 出口（已解） | ①资产管线正式化：pixelfixer 网格段+封闭灰袋清除并入 `tools/pixelize_candidates.py`（--fixer）+九张 48px 站桩槽位档生成（8 敌种+主角 normal,底中锚/NEAREST）②敌种立绘落位：按 `ui_kit.gd` TEX_ENEMY_* 常量名入 `game/assets/art/character/`,字形「敌」回退退役,目检 ③主角 portrait 替换（新 normal 态）+attack/hit 两态素材入包（命名/路径随计划书定）④主角三态切换挂事件：攻击演出→attack 态/受击→hit 态/回 idle,槽位 2× 整数放大适配 ⑤命中特效密度终稿：命中瞬间打击特效（状态记录 106 动画密度欠账清偿）⑥受击白光/演出链复核：弹道→闪白→血条→灰化全链+flash_hit 强度时长 ⑦fx_probe 断言扩充+轻闸接线 ⑧用户实机目检清单（战斗演出专项,本迭代人闸）；**2026-09-29 全流程审计追加四件（用户裁定归本迭代,状态记录 243）**：⑨终局面板「明细回看」z 序修复（main.gd:361 绕模态栈直开,回看层登记序在终局层下、被全屏遮罩压死——改走 _open_modal+ui_click_probe 补终局入口断言）⑩GP 冒险收束呈现（adventure_runner.gd:231 清零前,冒险终局面板补「本局 GP 入账」行,兑现 ui_assembler.gd:52 双展示位承诺）⑪主角受击反馈+死亡演出（敌→主角伤害弹道 main.gd:505 直接 return、无白光——补弹道+flash_hit,死亡补专属演出,与敌方演出密度对等）⑫flat_damage 变异格视觉标记（tex_mutation 槽恒空、数字照常显示——接变异纹理或角标,可归因）。**T0 注（2026-09-29 裁定）**：美术素材不入 git 维持,`game/assets/art/` 目录补 .gitignore（现行素材在盘不入库,缺位走字形回退;素材移交方式=用户放盘,打包发布方案随 Alpha 前另议）；**2026-09-29 落地**：T0-T8 十轮全落（worktree m3-iter6-20260929,状态记录 247-255）——卡①-⑫全兑现+审计四件;重闸全绿（冒烟 576/0+五探针+doc 三闸/熵增零新增+素材机检 11/11+MC 对拍 400/400 逐位一致〔锚已重锚 HEAD,原迭代 5 锚过期〕）；**出口人闸=T9 目检进行中**（检查单+代拍板追认五项=git 提交 8e74483（检查单已按生命周期条款退役）,素材移交口径更新=八敌+主角三态已管线自产落盘用户无需放盘）；**已完成（2026-09-29 用户 U2 目检过闸，状态记录 256）**——迭代 6 出口成立，迭代 7 门解 | -| 迭代 7 | 魔法道具内容+元进度数值标定（原迭代 8+ 前两项编入） | 迭代 6 出口 | node-reward spec 随批出生+C 区道具槽接线+魔法道具内容（奖励节点空占位 node_overlay.gd:36 由本迭代兑现,营地工坊六件死解锁同批接局内效果）；换算率复核/柜台定价标定；批末复跑 verifier 关键带（新力量源入局读数漂移属预期，破带才回调）；**2026-09-29 落地**：T0-T8 八卡全落（worktree m3-iter7-20260929，状态记录 259-263）——八拍板点裁决落锁（①乙罗盘退役/②丙三选一/③甲解锁进投放池/④甲封存呈现/⑤甲两步交互/⑥甲三件 10/池 88/⑦⑧读数后裁与只测不判）；重闸=冒烟 577/0+五探针+单测 12 套（含 aux 三新套件）+doc 三闸/熵增零新增+素材机检 11/11+MC 剥 additive 字段 0/400 逐位（门控空集=夹具态零投放零扰动）；verifier 换算率复核读数出讫（生命 6→实测 1.7/攻击 9→4.1/护甲 1→0.0——U1 呈报待裁）；**已完成（2026-09-29 用户 U2 目检过闸——七项目检过+追认五项全认+T5-hotfix 实机复验；状态记录 267）**——迭代 7 出口成立，迭代 8 门解 | -| 迭代 8 | 冒险续玩断点+设置面+打磨包（2026-09-29 立项：用户裁「中断可续玩/退出即结算」两口径分离+审计 #5#6 随移；**同日二批：真人试玩反馈三件编入+排布与选型已追认**〔2026-09-29 用户拍板：雷当量甲·直伤当量抬升／胜利总结结算接线按既有拍板面／轮间节奏甲·演出层排播队列，三件全编本迭代——计划书 `.zcode/plans/m3-iter8-loop-plan-2026-09-29.md`〕） | 迭代 7 出口 | ①run 快照序列化：停点粒度断点（关卡序号/节点位/生命/本关加成区/GP 钱包/商店已购档/已抽模板），入 save.json 新域+schema 版本迁移；战斗中中断不存棋盘中局，续玩恢复至最近停点、当场战斗从头打 ②开始菜单「继续上局」按钮（存在断点才亮起；续玩与新冒险互斥确认）③中断/退出口径分离：中断=关游戏留断点可续；退出冒险=现行放弃流程（失败结算+清除断点）④最小设置面（音量/全屏/退出按钮/减动效开关从测试调整板转正+调试入口门控）⑤打磨包（RAP 与九徽章图例解码入 legend、封印旗纹理落位退役文字占位、放弃按钮文案收敛至 level-map 4 字上限、判定文案两处措辞统一）⑥**战斗胜利总结结算接线**（冒险模式普通战斗胜利挂 BattleEndOverlay 胜利形态：金蜡封+GP 增量+总量+判定行+「下一节点」——battle.md OQ14 已拍板面接线，Boss/失败分支不动；06「战斗胜利总结结算接线」条目）⑦**轮间结算节奏化**（演出层排播队列：结算行按段分组阶梯延迟进明细带+轮切换「第 N 轮」横幅驻留——核心层零 await 契约与 MC 对拍不破、减动效开=延迟归零横幅静态化，与卡④减动效开关联动；06「轮间结算节奏化」条目）⑧**危险格负向当量抬升**（直伤三行 power 抬档投值+挖掘风险不等式对账复跑+通关率双窗复测；前置=普通 L2 缺口数字批点丙追认；06「危险格负向当量抬升」条目）⑨冒烟/探针断言：断点写读往返、续玩幂等、退出清断点、无断点时按钮隐藏+卡⑥结算框呈现断言+卡⑦节奏断言（减动效双态）⑩实机目检人闸（中断重开续玩全流程+战后结算框+轮间节奏）；**2026-09-29 落地（T0-T10 全落，worktree m3-iter8-20260929 六批次，状态记录 274-277+280，合并 77cc727）**：断点域 save v2（七字段+附随件，续玩确定性 400 局对拍零扰动）+继续上局/互斥确认/退出口径分离+最小设置面（减动效转正/DS_DEBUG 门控）+打磨包三件一降级（旗纹理缺盘 06 债务）+战斗胜利总结结算框+轮间排播队列与轮横幅（核心层零 await 零触碰，pacing_queue_test 第 15 套）+雷当量 4/5/5 provisional（MC 完美档读数逐位不动=只打踩雷轴反证；**普通 L2 7.9% 缺口加深四选一待裁**）+人闸三件交付=git 提交 d70f6c3（检查单已按生命周期条款退役）；**已完成（2026-09-29 用户三轮目检过闸，状态记录 287）**——迭代 8 出口成立，迭代 9 门解（T7 数值四选一用户裁决挂起自行探讨，表值维持 4/5/5） | -| 迭代 9 | **视觉规格落码 + Alpha 验收**（2026-09-29 用户验收样张新 v3.5 并立项插入：美术圣经 v3.0 中修+方向稿收敛后的落码批为 Alpha 验收前置——验收对象应是视觉完整版本；需求卡片已退役（git 710f9b7 出口批）；**2026-09-30 用户扩编**：呈现欠账四件+样张闸同窗件全编入〔06 在册欠账清偿，状态记录 288〕） | 迭代 8 出口 | **前置卡组·视觉落码**（需求卡片批 A+批 B）：⓪批 A 机检冻结（断言定值+产物转正+圣经 v3.1 记录，人闸已由 2026-09-29 方向稿验收豁免）①棋盘渲染落码（E 格高墙 30%/连接无边框/地板归一 L0.10）②数字承载切换（亮墨三档直画+色牌后备）③ui_kit 对比度修复（现行 4 处不达标+字号 16/14）④B 区舞台（暗背景+地台落影+顶光柱）⑤整屏样张闸首跑（四屏断言；**随闸三裁决**=1920 档缩放策略对照/动画帧数规格/资产升档与否〔06「美术资产规格两项」「资产升档重产批」两欠账随闸呈，裁升档→主角三态+八敌种重产转加卡〕）⑥探针与冒烟重闸；**扩编卡组·呈现欠账**（2026-09-30 用户拍板第一/二档全编）：⑪关卡画面 GP 常驻徽章接线（level-map spec 顶栏徽章，纯呈现欠账——06「GP/钥石迁出展示面接线」剩余面）⑫C 区「本关强化列表」数据接线（壳已落，set_level_bonuses→runner 加算区投影）⑬封印旗纹理自产+tex_flag 接线（迭代 8 卡⑤降级债务清偿，程序槽位零改码）⑭营地界面视觉终稿（解锁界面剩余面，前置=本迭代样张闸过审）⑮分辨率档位与格边长落码+HUD 框架「两档定值 36/45px」条款修订（1280×800/1920×1080 已定案）⑯art-bible §8.2 缩放纪律分级修订落文（甲文本/乙角色两类，圣经 v3.0 入库窗口已开）⑰B 档视口截图像素断言试点+C 档黄金图基准建立（测试分级批同窗件，C 档后置于⑤冻结）；**Alpha 验收（原卡组不变）**：⑦draw calls 真机测量（270→<200）⑧真人目检清单总清 ⑨07-体验验证清单总对账 ⑩真人通关率标定（真人 k 补跑并入）。**代排待追认**：卡数超 8 卡上限，计划书按「视觉落码段（⓪-⑥+⑪-⑰）→ Alpha 验收段（⑦-⑩）」两段组织、一次合并，段排布随计划书 U0 追认；呈现/文档卡全不扰卡⑩真人读数（数值/内容面不编入本迭代，归 M-4）。**⚠ 2026-10-01 用户否决迭代 9 标完成（数值轴）**：真人实证推翻模拟尺（旧普通档=新手画像弱真人 20 倍/完美档非元游戏上界）——数值修复批已入库（数字可读甲案+模拟档位重构+数值三刀，报告 design/qa/numfix-newruler-readings-2026-10-01.md）后**迭代 9 维持未过闸，卡用户实机验收新数值+新带值拍板**；全旧带读数作废待新尺重锚；**✅ 完成（2026-10-03 出口闸过，状态记录 315）**：9B Alpha 验收段收口——T17 36 项全判（13✅/35 两处修复/32 环境限制）+T16 修复批 11 件全落（硬锁 v3.1/演播后排窗/出度≤2/掉落渠道退役等）+T19 真人批佐证级收口（有效局 2 用户裁+k=0.60 落 >0.5 带内）+带值四带甲案落现行事实源（A[0,10]/B[50,85]/C[30,60] 预立/D 响应曲线 ≤15pp·S 形，旧三带作废）+81000 锚（非数值验证——k 源+出度重建位移存档）+06 draw calls 销号（504→196）+stage.txt 换代；批末闸=冒烟 636/0+run_all 15 套+探针 4/5 绿（click_probe 已知红挂 06 专项）。**出口检查单=design/qa/m3-iter9-exit-checklist-2026-10-03.md**——**迭代 9 出口成立、M-3 关闭、Alpha 到手、M-4 门解** | -| 迭代 10 | **奖励结构重构——通关三选一 + 钥石掉落挪转 + 精英怪立项预留 + 通关部分回血**（2026-09-30 用户拍板案丙+P-A~P-E，计划书=`.zcode/plans/m3-iter10-loop-plan-2026-09-30.md`；**2026-10-01 用户提前开工拍板**：不合入 master、渲染层验证冻结——T0 开工门改规随批追认） | 迭代 9 出口（**改规注记**：Alpha 验收未过闸，用户拍板提前并行开工——并行安全性由「不合入」保证，master 读数面零污染） | **T0-T10+追加批全落**（worktree m3-iter10-20261001，10 提交 34dd8de→7f5caa3）：①大奖励三件套退役改三层框架——部分回血 20%（clear_heal_pct）+提升三选一（池六种加权洗牌 E-S 不放回/reward_pick 扩签/属性件上限 3·AP 件上限 2 达上限剔牌库/选择停点零自动推进可中断）②加算区四轴+行动点（AP 件每战首轮 +1，排队通道兑现；行动经济.md 失同步清偿 AP 6→8）③钥石退役出大奖励改 Boss/精英逐杀掉落（boss_keystone 重锚首杀 3/复杀 2/2/3——a 裁备选；末关照常入账；收束无二次派生）④同调位过渡承载（transitional_sync_slots=1；三选一面替换子交互两路/战斗内沉没；现行事实源归同调实施批）⑤**奖励节点共享池**（追加批用户拍板——与通关三选一同池同权重同上限，node-reward.md v2.1 掷定前置卡片直显具体道具）⑥断点 save v3（奖励选择态+件计数+aux_detail；v1/v2→v3 semver 兼容断言——g 裁）⑦BonusPickOverlay 共用面+目检修复批（候选一致降级为现状注记）；**裁决面**：七项代拍板全裁（a 用备选/b-f 认同/g semver）+e 白话追认；**实机目检一轮**：1/3/4/5/6/9/14 PASS（8 项根因=减动效开关遗留已翻回；2/12 延后同调批；逐行结算演出定性迭代 8 事项不追）；**合并 master 数值修复批**（bc737fb 解 2 冲突——autoplay 注释双留/smoke_all 取新断言+模拟档购血容差窗）后冒烟 628/0+run_all 15 套+五探针+三闸零新增（死链 4=存量；master 新引 1 条环境死链已修）+熵增 PASS；**MC 四代锚** 77000/78000/79000/80000 各 400 局（普通 L1 41.8%/L2 10.2% 带内、完美 L1 86.5%/L2 15.6%、钥石 1.38/3.01——报告 design/qa/m3-iter10-clear-rate-readings-2026-10-01.md）；**人工参与项入 07 清单⑩**；**已完成（2026-10-01 开发闭合）**——迭代 11 门解（M-3 内顺延），Alpha 总闸仍卡迭代 9 数值实机验收 | -### M-4 Alpha 后深化与内容扩展（Release 4） - -> **里程碑语义换代（2026-10-09 用户立规）**：**M3=Alpha 版本的完整实现；M4=Beta 版本的完整实现**。用户未明令宣布 M3 完成前，项目停留在 M3 阶段——迭代规划只编排 M3（Alpha 完整实现）相关需求，M4 内容一律不排期、不进迭代。按新口径：本节迭代 11 起各行皆属 M3（Alpha 完整实现面）；2026-10-03「M-3 关闭、Alpha 到手」为验收史记录保留；M4（Beta）未开启，门=用户明令 M3 完成；本节旧状态句「现行里程碑（2026-10-03 M-3 关闭升现行）」由本注取代。 - -| # | 迭代 | 门（进入条件） | 更改任务 | -|---|---|---|---| -| 迭代 11+ | **✅ 三批已入库（2026-10-03，状态记录 323-325）**：①魔法道具同调实施批 bc17b66（冒烟 645/0→671/0 基线演进）→ ②GP 商店房重构批 395b2ab（共享池账本+抽 3 买 1 全重抽+A=1.8/b=1.1 provisional+MC off 对拍逐位 PASS+on 新锚 N=60）→ ④视野迷雾实施批 e6260a5（菱形灯光区 R8+区外全黑+暗淡记忆态+探针 case⑮；纯呈现 MC 零跑）——各批合并后主区全量冒烟复跑全绿；**迭代 11 门=待出口人闸关闭（人闸材料包=design/qa/m4-iter11-exit-package-2026-10-03.md：三批检查单+追认清单 18 项+迷雾目检指引+读数报告）**。原登记：**2026-10-03 用户裁迭代 11 范围（三批，推荐序）**：①魔法道具同调实施批 → ②GP 商店房重构批 → ④视野迷雾实施批（各批独立出口闸；同调批先行——商店批共享池账本与通关率复测建在 aux 卡退役后的终局池上，读数只锚一次；迷雾批纯呈现不扰读数，序位可穿插）；**反制批移迭代 12**（前置=双层 BD 外部调研+仲裁后重新立项；2026-10-03 用户终裁=同调位反制道具层级错配失败设计废弃，「每变异≥1反制道具」契约作废——地形变异.md v0.6/魔法道具.md v0.8 同批落文（06 条目已收口移除））；**Beta 方向立项撤出本窗口**（待 Alpha 内容填充+试玩轮次后再议）；关卡内容扩展留讨论位（世界观设定待用户补权威定义——摩索不达城 repo 无载）。↓ 原登记：反制批 Alpha · **魔法道具同调实施批**（需求卡片 v1.1 全裁 P1-P8（需求卡片已退役，已入库=①bc17b66），2026-10-02 用户裁 P7 乙归本窗口，发令即开工——需求卡片含 T0-T10 可升 loop 计划书）· **GP 商店房重构批**（2026-10-02 用户裁三选一同构化：买一全重抽/重抽绑购买/价格=基价×b^(关序−1)×A^(进店已购次数)〔系数归 game-balancer 研究〕，取代 09-20 无刷新裁决——06「GP 商店房重构」条在册待立项）· 关卡内容扩展 · Beta 方向立项（原迭代 10+ 三主题顺延——迭代 10 位已由奖励结构重构批占用，2026-09-30 用户拍板 P-E；各批顺序按 Alpha 读数定；含营地 2D 画面议题——2026-09-29 裁缓至此再议） | M-3 出口闸（**已解**——2026-10-03 迭代 9 出口闸收官：M-3 关闭、Alpha 到手） | 立项时按「迭代粒度界定」拆任务卡 | -| 迭代 12 | **双层 BD 实施批（反制批位移承接——变异应对局内化在本批落地）**：**2026-10-03 用户五裁全落**=R1 甲（树形态融合案：主干脊柱 row-gating+三脉+彩蛋 ≤3+A/B 集中同调脉）/R2 乙（**两层全入本迭代**：批次一 T0-T7=机制件基建+七流派全量铺〔R3 乙〕+地形转化件+商店保底+MC 锚；批次二 T8-T10=天赋树+存档 v4+营地 UI 重构；超软时间盒切 12/12b，切分点=批次一出口）/R3 乙（七流派批次一全量铺）/R4 甲（**信息型永不对冲**+复查闸=T10 呈报信息型真人读数仅呈报不提案；净化工兵仅限伤害型、清除工具件族不做、深挖钻头改非信息税设计）/R5 甲（喂雷流不做，06 留正式待办+kill-switch 判据）。未落地备选内容已自包含迁 06「双层 BD 延期与备选内容总登记」。设计事实源=`design/research/双层BD体系-整合定稿-2026-10-03.md`（双模型并行调研仲裁版），需求卡片已退役（已入库=e780063）。**✅ 已全批入库（2026-10-04，状态记录 328-333）**：TP0 令牌池先行（normal 重锚）→批次一 T0-T7（27 件七流派+MC 成型锚 L1 5%→75% 分岔+红线自检①过）→批次二 T8-T10（天赋树 33 节点+存档 v5+营地树 UI+A/B 面 0.0pp）一次合并 e780063；试玩反馈四连修复（钻头 AP 锁死/v2 收益重投/流派件呈现双界面/清图奖励 toast）至 c43276d；批末冒烟 718/0+run_all 15+探针绿+doc 三闸基线同款+熵增 PASS；**出口人闸待用户**（人工检查清单=状态记录 328-333+design/qa/m4iter12 两报告）；前置=迭代 11 三批出口+M-4 数值批令牌池落地+商店批共享池 | 迭代 11 出口 | T0-T10 两段式（需求卡片 §四） | -| 迭代 13 | **工程债与测试基建批（含 D6 爆破工兵包实施）**：六条目=ui_click_probe 完整局适配（D1——分派链序修正+停点/锁期/重放三态断言）/探针只读出口（D2——六出口 26 直入清零）/ArmedTimer helper（D3——P4 乙三处计时收口缝零动）/main.gd 二期瘦身（D4——bonus_interact_controller+camp_shop_presenter 拆件 1370→1119，家族②契约3绑定面留置；~900±50 锚差=族级清单上限不自洽已归因）/aux 二期合并（T5 判不合收口）/杂项尾差四件（D5）/爆破工兵包中立移除危险格（D6——P1 甲邻接冻结/P2 甲退色降档，判定逻辑零改动，充能表驱动零新码）。**✅ 已入库（2026-10-04，状态记录 342）**：worktree m4iter13-debt-20261004 八提交 cd7d3ea…2402877 合并 eff8cb8；闸=冒烟 718/0（断言数持平基线）+run_all 15+click 三种子绿+全探针绿+doc 三闸零新增+熵增 PASS+MC 零跑（静态零漂移证明）；合并后主区全量复跑同绿 | 迭代 12 出口 | T0-T9 ≈4.8-5.3d（知情超限单批，实际单会话） | -| 迭代 14 | **初始展开收窄批（2026-10-04 用户拍板甲乙混合立项）**：甲=先布后删剃雷域收窄至出生 3×3∪外扩 r 环（参数化半径，现值 r=1——开阔地均值从板面 66.5% 根因性降至约三成）+乙=生成重掷闸 R₀≤cap（合法性门序列、cap=板面 30% 锚〔10×10=30/12×12=43/13×13=51〕、重试耗尽走既有三分出口）；**玩法侧零改动路线**（排雷玩法「初始展开恰等」验收原样为真，minesweeper_rules.gd 零 diff）；裸数字截断路否决退役（可见 0 格+未开邻居=扫雷不可能态）。可行性报告=`design/research/研究-初始展开收窄可行性-2026-10-04.md`，需求卡片=`design/research/需求卡片-初始展开收窄批-2026-10-04.md`（T0-T8≈5.25d，读数批 T5-T6 可切独立后批；拍板点 P1-P3 全读数后置；停机点 S1 相变警戒/S2 带越界回调）。**✅ 实施批落地（2026-10-05，worktree m4iter14-narrow-20261005 状态记录 357；S1 停机呈报已裁=用户方案A）**：T0-T4+T7+T8 全落（T5 结构读数随批出讫；T6 MC 四带复算读数批按切分预案后置，跑批待用户批准挂 07 现行义务）——甲=剃雷域收窄（shave_ring_radius 参数化，r=1→出生 5×5，全域 flood 剃雷退役，零 RNG 消费变化）+乙=R₀≤cap 重掷闸（合法性闸序列+同流重试+耗尽三分出口诚实降级+r0_cap_rejected 指标）+参数面两列（schema 域校验加载期致命+19 行投值）+断言面 +12（R₀≤cap/ring_removed 量级/cap 压线诚实降级/确定性逐位）+夹具复核 3 处（relic 候选身份按 TP0 v2.2=kind|tier|relic_id、商店购买笔数推导防 GP 流漂移、极性探针种子自愈）；**S1 停机实录**=r=1 自然 R₀ 均值 39>cap30 锚结构性倒挂（94% 拒绝/inf 0.976→0.719/常态非法板）→用户裁方案A「10×10 cap 30→45」〔P1 上调预案字面〕，12×12/13×13 健康侧维持；改后结构读数=R₀ 均值 39.7/37.9/42.8/46.6（收窄自 68.6/83.2——10×10 −42%、12×12 −54%）/尾部闸精确截断/雷密度 19.2-21.6%<25% 相变线/inf 全行达标；玩法侧零改动（minesweeper_rules.gd 零 diff、「初始展开恰等」验收原样为真）；闸=冒烟 767/0（+12）；registry initial_expansion_narrowing 条+棋盘生成.md v0.5+07⑬ 四信号组；06 视野条目已于 745b92ea 清账批退役（收窄立项即现行事实源）。**②挖掘风险不等式判式换代批（2026-10-04 用户裁编入本迭代，作为迭代内需求）**：判式三层换代（条款2 标中旗锚/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」/旗边际引理+条件二旗溢价）+β 比值带判读 [1.2,2.5]（u=3 登记态）+标中兑付溢价 δ=1.25（形态 a 兑付公式一处·危险格与安全格同池冻结不动）+runsum 旗行为五字段+audit 工具常量刷新（池 77/直伤 6-8-8/AP 8）；裁决全落零新拍板点（方案报告 §九（已退役，git 1da9a41）），需求卡片=`.zcode/plans/mine-inequality-revision-miniloop-plan-2026-10-04.md`（T0-T5≈2.5d；条件二 T3 落文按登记已知破·T4 机制转绿；契约红线=DamageController 零改/直伤雷 6-8-8 与 p_perfect 不动——iter8 缺口四选一解绑独立在案；开工门=U0）。**✅ 实施批落地（2026-10-05，worktree m4iter14-mineq-20261005 状态记录 356）**：T0-T5 全落——audit 工具常量刷新（改前静态锚与方案报告 §四 逐位吻合）+runsum 五字段（行侧判据考证=授予行专带 highlight，87行==87插旗1:1）+F1 条款3 重立三层口径（v0.8）+战斗结算 v0.25+难度联动表+6 行+registry clause3_inequality 重立条（改前锚+P7 修正注记）+06 破线条收口+**T4 标中兑付溢价机制**（settlement.flag_hit_premium=125 provisional，grant 单点只挂 flag_hit 正向·percent 幅度贯穿应用与呈现，标空/挖格不乘，DamageController 零改/同池冻结）+smoke 750/0（+3 断言；max 路径种子 42→43 重采）；判读三件=β 带 u=1/2 带内 u=3 登记态/δ 敏感度行为无感（η 位移 <1.4pp<5pp，保留+登记）/条件二判式口径等号压线转绿（整数量级实现 u=1/2 绿·u=3 微欠 −1.1% 登记面）；改后锚换代 runsum_m4iter14mineq_post_n200_20261005（perfect 冒险通关 65.3%→72.0% 增强向位移，四带判读归 M-4）；出口报告=design/qa/m4iter14-mineq-exit-report-2026-10-05.md（provisional 追认单 8 项+07⑫ 人工项）；damage_probe A1 红灯=改前既有非本批新增（在册）。**③全局作用域变异首发批（2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落，批内序位待排）**：L2/L3 Boss 图恒定一型 scope=global 变异，首发型=**案A 资源面·微贫向偏斜**（正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动；v1.0「沃土+雷密对冲」形勘误作废——雷数为生成器事实、布置段不可加，改生成端=踩结构面否决理由）；**替换制**（Boss 图不再布 region 片——L2 完美 Boss 承伤 55.8% 已越带不叠加；迭代 12 四件地形应对件在 Boss 图失效=知情代价，registry/调参日志随批登记）；L1 Boss 免疫（带B [50,85] 教学保护）；三层预告（开战横幅+HUD 常驻角标+帮助手册行）；带A 判读后置 M-4（落地 off/on 对拍只测不判；off 基线=替换制后零变异 Boss 图，与现行带 region 片 Boss 图语义不同须注明）；偏运硬币合成序=图级先件级后（代拍随批锚登记）。调研报告（事实源，v1.1 裁决落盘）=`design/research/调研-全局作用域变异设计空间-2026-10-04.md`，需求卡片已退役（git 01bfc15 批；裁决全录另见调研报告 §7）（T0-T8≈5.75d，读数批 T7 可切独立后批→主体≈5.25d；零新拍板点·provisional 追认单随批；停机点 S1 普通图逐位漂移/S2 读数越带只呈报/S3 互锁误伤；开工门=U0；**⑥A4 批开工门含本批出口——本批落地图级偏斜投影点为⑥合成链中段**〔2026-10-05 注：⑥已移出迭代 14 挂起，此依赖句冻结待其重启〕）。与①②互不撞（收窄=普通图初始展开轴/判式=不等式判读口径/全局变异=Boss 图资源面轴），出口读数各自分开归因。**✅ 实施批落地（2026-10-04，worktree m4iter14-gvar-20261004 状态记录 345）**：T1-T8 实施批全落（T7b MC 读数批按切分预案切独立后批，跑批待用户批准）——skewed_veins 贫矿脉行+互锁三条+effect_value [0,50]/门控第三维节点身份/替换制+兜底回落/装板序全局决议前置（数据依赖调和，出口报告在册）/资源面偏斜投影（整数最大余数守恒 77+合成序图级先件级后）/三层预告三层全接/七现行事实源落文+06 收口；闸=冒烟 747/0（+29）+run_all 15+golden 普通图逐位 12/12 全等+六探针+三闸熵增终录见批报告 design/qa/m4iter14-gvar-exit-report-2026-10-04.md（Q3 四件应对件知情代价登记+静态推演+provisional 追认单+人闸目检清单）；**③出口成立——⑥A4 开工门解一半**（另半=②出口）；off/on 双档读数待 T7b（带 A 判读归 M-4 只测不判）。**④技能池执行批（2026-10-04 用户点名入列——调研+四裁+需求卡片全齐，06 Alpha 验证条目随之收口）**：文档五件（敌人系统.md 池构成表补 L2/L3 五敌种行/护甲列改读表口径/Boss 三代错峰句/意图呈现节补解锁弹出规格/版本 v0.13+EV 锚整数口径重登记+enemy.tres 批注消歧）+**新机制一件=Boss 半血解锁新独占伤害技**（三 Boss 血量 ≤50%〔用户口径定死〕解锁：酋长「震地怒击」类 ×2.5/CD4·卓尔遏毒类 ×2.0/CD3·石君王「岩崩」类 ×2.5/CD4——参考档即工作值，命名 T5 定稿、倍率冷却 provisional 归调参；enemy.tres 池条目扩 unlock_hp_pct 键〔int [1,99] 缺省无=无门槛〕；未解锁条目双面过滤不进摇号与保底集合；解锁出一次归因明细行「XX 解锁了 YY」）；首拍加权取消（杂鱼纹理注销——巨蜘蛛 52% 读数已被 Package B 抬血自愈、地精两行终裁不加工）；呈现=明细行+既有类型级预告+解锁时技能名一次性弹出（零动画资产、不改演出）；裁决 D1-D8 零待裁；需求卡片=`design/research/需求卡片-技能池执行批-2026-10-04.md`（T0-T7≈4.25d，切分预案在册）——开工=用户发令升计划书。**✅ 实施批落地（2026-10-05，worktree m4iter14-skillpool-20261005 状态记录 358；goal 开工令 U0）**：T0-T6+⑤ 全落（T7 读数批后置挂 07 现行义务，跑批待用户批准）——T0 表盘点零漂移；T1 敌人系统.md v0.13 五件全落；T2 skills.tres 有效倍率表批注〔D4 整数基线半点矩阵〕+enemy.tres EV 锚整数口径重登记+巨蜘蛛 1.11 消歧〔=atk1 口径非混用〕+registry enemy/skill 条目换代；T3-T4 机制件=unlock_hp_pct〔1,99] 可选键（schema 域校验，缺省无=无门槛）+容器闩 check_skill_unlocks（单向闩零随机）+双面过滤（保底不逼锁定）+编排归因行「XX 解锁了 YY」〔type=highlight 高光键 skill_unlock 零行型新增〕+呈现一次性技能名 toast〔排除 perfect_sweep 误触〕；T5 三 Boss 解锁技落表（震地怒击 ×2.5/CD4·遏毒 ×2.0/CD3·岩崩 ×2.5/CD4 案甲 provisional+池尾 weight2/unlock50）+断言基线换代 3 处〔技能表 12 行/池模板+门控条目/酋长 EV 锚重锚 1.10-1.30 实测 1.1948〕；T6 单测 skill_unlock_test 22 断言（run_all 15 套）+smoke +5 集成（半血→次轮解锁行恰一次/文本/行型零新增）；闸=冒烟 772/0+run_all 15+探针绿+doc 三闸零新增（reward_overlay_test 红=master 既有在册）。**⑤✅ 提灯 +2 接线落地（同批顺路）**：board_view.set_fog_lantern 公共接线面（半径算式迷雾批已在位；载体道具仍归 Alpha 信息件重定批=接缝就绪态）+ui_input_probe case⑮ 接线断言+HUD框架 注记**⑤魔法提灯 +2 效果接线（小卡）**：零调研直入——2026-09-30 拍板④已裁（灯甲视野外扩 +2 格、类型微光不随视野扩），迷雾批已留常量 LIGHT_RADIUS_LANTERN_BONUS，纯接线+断言估 0.5d 内。原候选卡注记终态（2026-10-04）：敌人系统内容批=已具化为④；教学引导定稿批=用户裁改排 Beta（06 教学节头注记在案），移出本迭代候选。**⑥冒险前资源配比预设批——已移出本迭代（2026-10-05 用户令挂起：暂不做；条目保留 06-待办清单「冒险前资源配比预设（构筑提案）」〔已裁待实施→挂起〕，八项裁决全数有效、需求卡片冻结保留=design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md；重启须用户另行发令，届时开工门仍=②③号卡出口〔若②③已合并进 master 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已入库 2026-10-04 eff8cb8**，状态记录 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 |**③全局作用域变异首发批（2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落，批内序位待排）**：L2/L3 Boss 图恒定一型 scope=global 变异，首发型=**案A 资源面·微贫向偏斜**（正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动；v1.0「沃土+雷密对冲」形勘误作废——雷数为生成器事实、布置段不可加，改生成端=踩结构面否决理由）；**替换制**（Boss 图不再布 region 片——L2 完美 Boss 承伤 55.8% 已越带不叠加；迭代 12 四件地形应对件在 Boss 图失效=知情代价，registry/调参日志随批登记）；L1 Boss 免疫（带B [50,85] 教学保护）；三层预告（开战横幅+HUD 常驻角标+帮助手册行）；带A 判读后置 M-4（落地 off/on 对拍只测不判；off 基线=替换制后零变异 Boss 图，与现行带 region 片 Boss 图语义不同须注明）；偏运硬币合成序=图级先件级后（代拍随批锚登记）。调研报告（事实源，v1.1 裁决落盘）=`design/research/调研-全局作用域变异设计空间-2026-10-04.md`，需求卡片已退役（git 01bfc15 批；裁决全录另见调研报告 §7）（T0-T8≈5.75d，读数批 T7 可切独立后批→主体≈5.25d；零新拍板点·provisional 追认单随批；停机点 S1 普通图逐位漂移/S2 读数越带只呈报/S3 互锁误伤；开工门=U0；**⑥A4 批开工门含本批出口——本批落地图级偏斜投影点为⑥合成链中段**〔2026-10-05 注：⑥已移出迭代 14 挂起，此依赖句冻结待其重启〕）。与①②互不撞（收窄=普通图初始展开轴/判式=不等式判读口径/全局变异=Boss 图资源面轴），出口读数各自分开归因。**✅ 实施批落地（2026-10-04，worktree m4iter14-gvar-20261004 状态记录 345）**：T1-T8 实施批全落（T7b MC 读数批按切分预案切独立后批，跑批待用户批准）——skewed_veins 贫矿脉行+互锁三条+effect_value [0,50]/门控第三维节点身份/替换制+兜底回落/装板序全局决议前置（数据依赖调和，出口报告在册）/资源面偏斜投影（整数最大余数守恒 77+合成序图级先件级后）/三层预告三层全接/七现行事实源落文+06 收口；闸=冒烟 747/0（+29）+run_all 15+golden 普通图逐位 12/12 全等+六探针+三闸熵增终录见批报告 design/qa/m4iter14-gvar-exit-report-2026-10-04.md（Q3 四件应对件知情代价登记+静态推演+provisional 追认单+人闸目检清单）；**③出口成立——⑥A4 开工门解一半**（另半=②出口）；off/on 双档读数待 T7b（带 A 判读归 M-4 只测不判）。**④技能池执行批（2026-10-04 用户点名入列——调研+四裁+需求卡片全齐，06 Alpha 验证条目随之收口）**：文档五件（敌人系统.md 池构成表补 L2/L3 五敌种行/护甲列改读表口径/Boss 三代错峰句/意图呈现节补解锁弹出规格/版本 v0.13+EV 锚整数口径重登记+enemy.tres 批注消歧）+**新机制一件=Boss 半血解锁新独占伤害技**（三 Boss 血量 ≤50%〔用户口径定死〕解锁：酋长「震地怒击」类 ×2.5/CD4·卓尔遏毒类 ×2.0/CD3·石君王「岩崩」类 ×2.5/CD4——参考档即工作值，命名 T5 定稿、倍率冷却 provisional 归调参；enemy.tres 池条目扩 unlock_hp_pct 键〔int [1,99] 缺省无=无门槛〕；未解锁条目双面过滤不进摇号与保底集合；解锁出一次归因明细行「XX 解锁了 YY」）；首拍加权取消（杂鱼纹理注销——巨蜘蛛 52% 读数已被 Package B 抬血自愈、地精两行终裁不加工）；呈现=明细行+既有类型级预告+解锁时技能名一次性弹出（零动画资产、不改演出）；裁决 D1-D8 零待裁；需求卡片=`design/research/需求卡片-技能池执行批-2026-10-04.md`（T0-T7≈4.25d，切分预案在册）——开工=用户发令升计划书。**⑤魔法提灯 +2 效果接线（小卡）**：零调研直入——2026-09-30 拍板④已裁（灯甲视野外扩 +2 格、类型微光不随视野扩），迷雾批已留常量 LIGHT_RADIUS_LANTERN_BONUS，纯接线+断言估 0.5d 内。原候选卡注记终态（2026-10-04）：敌人系统内容批=已具化为④；教学引导定稿批=用户裁改排 Beta（06 教学节头注记在案），移出本迭代候选。**⑥冒险前资源配比预设批——已移出本迭代（2026-10-05 用户令挂起：暂不做；条目保留 06-待办清单「冒险前资源配比预设（构筑提案）」〔已裁待实施→挂起〕，八项裁决全数有效、需求卡片冻结保留=design/research/需求卡片-冒险前资源配比预设批-2026-10-04.md；重启须用户另行发令，届时开工门仍=②③号卡出口〔若②③已合并进 master 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已入库 2026-10-04 eff8cb8**，状态记录 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 | -| 迭代 15 | **①调试功能整合批（2026-10-05 用户令自「14.5」临时卡改编入册——原周期外 0.5 卡，落地事实与验证读数零变化，只改编号归属）**：主菜单三调试散件（随机种子输入框/角色数值调整板/两层调试入口）收一张调试浮窗 DebugOverlay——入口=开始覆盖层右下角「调试」角标（与主按钮组非平级，DS_DEBUG=1 环境变量门控沿用迭代 8 卡④口径）；浮窗=悬浮菜单之上 Dialog（不隐藏开始层，同确认弹窗形态；旧 TunePanel「与开始层互斥」形态与类整体吸收退役含 .uid）；可扩展滚动列表页四区块（随机种子/数值调整/批量模拟/两层调试入口——后续调试项往下追加滚轮下探）。四拍板全落（2026-10-04 用户裁）=P1 甲 DS_DEBUG 门控/P2 乙全摊平/P3 仅开始菜单可开·对局不可达（_show_debug_overlay 门禁护栏+对局发起随开随收）/P4 可扩展列表。**✅ 已全批入库（2026-10-05，worktree iter145-debug-hub 两提交 48c0b34/46dadbb，主区 merge --no-ff d0a3c6b/10c301b，状态记录 352）**：闸=冒烟 747/0+探针 ui_tune/ui_click/ui 三绿（worktree+主区双跑，主区跑前 --import 重刷类名缓存在册坑）；遗留=实机目检归用户（DS_DEBUG=1 启动→右下角角标→浮窗四区块→两层调试入口） | 卡①门：迭代 14 出口（注：本卡先于迭代 14 出口已入库——编入时点迭代 14 ③已闭/①②④⑤进行中/⑥挂起，门列仅记编入时点状态，不构成追溯闸） | 单批已落地（原估 0.5d，实际一次会话）；后续扩调试项=debug_overlay.gd _build() 列表区追加区块（P4 扩展口径） | -| 迭代 15 | **②奇物概念收口与词族对齐批（2026-10-05 用户令编入本迭代）**：概念层已由用户逐轮裁定定稿（《奇物》v1.0→v2.7，7 轮），本批只做**落地对齐**、不做二次设计。三批内容：**①三套旧词族全面对齐**（顶层已改名「奇物」而代码仍叫旧名＝用户最初抱怨的"文档与代码分开"）：`feature_*`→`curio_*`（103 处/7 文件）、`relic_*`→`feat_*`（162 处/12 文件）、运行层 `bonus_*`→`curio_*`（160 处/8 文件）。**硬约束：`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用，统一词族不得使用**；`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`（非文本层无法自证）。**②三条渠道按分类分离**（现行三渠道共用同一个 98 张池、三类混编）：关底 Boss 击败＝通过这一关→只出专长；奖励节点/商店→属性值提升+资源、专长在此**只以凭证形式**出现。**兑付频率红线**：奇物不是打一场战斗给一份，关内普通战斗节点打完不给任何奇物，一关之内只兑付一次（用户 2026-10-05 纠错）。**③两个新种类入池**＝刷新次数（须先与"商店独立刷新机制"划清边界）+ 专长获取凭证（拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底：连续 5 次三选一展示未出→第 6 次必出，刷新重展计入、奖励节点与商店共享计数）；附带 `shop.tres` 补回复（默认原则要求分类内成员都在该出现的渠道池里）与 charge 标签补至 ≥4 件（现仅 3 件，档二永远达不到——数据缺陷）。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7，需求卡片=`design/research/需求卡片-奇物词族对齐与渠道分离批-2026-10-05.md`（T0-T8≈4.5d，两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕，切分点=T3 出口；11 条设计契约含 6 条 🔴 停机级；12 条批末验收断言；代拍板白名单 5 项；待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/凭证四参数终值/存档键正式迁移〕）。**开工门**：与在途 M-4 各批（判式换代/全局变异/配比预设）撞同一批文件（`adventure_table.gd`/`level_runner.gd`/`adventure.tres`），须确认不并行或用户明示插队 | 卡②门：迭代 14 出口 | 卡①已入库（原估 0.5d）；卡② ✅ **已全批入库（2026-10-05，worktree curio-wordfamily 七提交 d4cde73..049aa62+master 同步 23547b5，主区 merge 见状态记录；出口报告=[iter15-2-curio-exit-report](design/qa/iter15-2-curio-exit-report-2026-10-05.md)）**：三套词族代码层全换（feature_→curio_ 93 处/bonus_ 运行层→curio_/relic_→feat_——feat_table.gd/feats.tres/feats_engine.gd 改名）；渠道白名单分离（总池-渠道子集多级缓存形=用户裁）；凭证入表（四参数 provisional 20%/2/1/5+拿到即开+计步保底+限购 1+节点商店共享计数）；refresh 入池（B 案 heal 5→3 挤占）+shop.tres 补 heal 行+凭证行；T2 裁点甲案=六存档键禁改（含需求卡片漏登记的 "relics" 键）；charge 缺陷登记不硬补；autoplay 凭证分支缺陷批内实测修复（MC timeout 形态）；闸=冒烟 782/0（+10）+run_all 16 套历史首次全绿（reward_overlay 红转绿=M7 bcard 成因修复）+五探针绿+doc 三闸零新增+MC n200 只测不判（normal 0.5%/perfect 77.5%）；遗留=07⑰ 目检归用户+C1 呈现批/C2 第四关批/C3 调参批/C4 存档批四移交。原估 T0-T8≈4.5d（实际一次会话）；迭代 15 三卡全已入库（①352/②本批/③8944dca 前身③批+本批） | -| 迭代 15 | **③秘宝代码词族对齐批（2026-10-05 用户令编入本迭代）**：设计侧已完成（消歧更名批 `430419c`+`06e94b7`，26 个设计文档「魔法道具」→「**秘宝**」，同调位机制名保留不变），本批只做**代码侧对齐**、不做二次设计。内容：`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**（重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13），分五组落：**A 玩家可见文案（P0，5 处）**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`（槽位标题 `UiKit.label`）+ `:178`（tooltip）· B schema 与数据表（`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改，**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑）· C 文档链接修复（含 `architecture.md` 两处既有断债顺带清偿）· D 中文注释层（**须分色**：`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动）· E 测试文件名+内部变量。**用户三项拍板**：全族彻底改（含数据表）· **断点存档键一律保留**（`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改，破档即进度丢失）· registry 条目键 `aux_items` 不改（数据契约键）。设计事实源=`design/gdd/systems/跨局循环/秘宝.md` v0.9，需求卡片=`design/research/需求卡片-秘宝代码词族对齐批-2026-10-05.md`（T0-T9≈5.0d，**超软盒 3 日上限·知情预挂**：T7 段末闸后 L3 呈报切点不擅切；**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕；5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕；代拍板白名单 5 项；**C1/C2 已裁关闭·全改保一致·待裁点 0 项**）。**撞批已消解**：② 奇物批 2026-10-05 收口落库（合并 `c571af2`），并行风险解除，本批为迭代 15 唯一在途需求；**T0 须重取基线**（判式换代批 T5 读数 750/0、② 又动数据层，§1.2 的 747 为②前旧数禁沿用）并复核事实表。**✅ 裁决（用户 2026-10-05「全改保一致」）**：C1 `"aux_item"` 域串**照改**（实测连锁面收窄——`reward.tres` 已零 aux_item 数据行，池种随迭代 11 T7 退役；16 处字面量全在代码内闭合无存档依赖；唯一连锁项=`smoke_all.gd:3932` 断言须同步）· C2 `aux_items` 一名两义**拆分**（ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**，禁改的只是落盘字面量）。新增**组 F**（分派语汇与域串 16 处），任务卡扩为 T0-T10≈5.5d。**开工门**：✅ 已无待裁点，可直接发 T0 | 卡③门：迭代 14 出口（**裁点已全决·可开工**） | 卡①已入库（原估 0.5d）；卡② ✅ 已全批入库（2026-10-05 merge 3c6f2c9，状态记录 362——c571af2 文档+数据层之上的实施段全量补完）；**卡③ ✅ 已全批入库（2026-10-05，worktree m4iter15-mibao 九提交 b4b8bb3..收口笔，主区 merge --no-ff 哈希见状态记录/active.md 快照行；出口报告=[iter15-3-mibao-exit-report](design/qa/iter15-3-mibao-exit-report-2026-10-05.md)）**：词族实数 364 处/36 文件全换尽（例外 43+2 处=存档键引号字面量+夹具，穷举在报告 §五）；闸=冒烟 755/0+run_all 14/15（唯一红=②批遗留基线红 reward_overlay，对照零新增）+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免（静态零漂移证明代）；渲染像素五闸屏蔽挂账 07⑮；遗留=实机目检归用户（07⑮）+reward_overlay 基线红归②批处置 | -| 迭代 16 | **UI 设计对齐批（2026-10-05 用户令：迭代 16 改编为 UI 优化需求实现，原四卡全数顺延迭代 17；美术线用户自理立规的例外面=本批只改 UI 设计代码、零美术资源改动）**：三路改进整合轴的代码侧落地——事实源=`design/research/UI预览demo三路改进整合对照-2026-10-04.md`（A 落码差异对照+OPT-A 机检+WB 变体三路整合，基线原型 v2.1）。**红线=不修改美术资源**：game/assets/art 与 artwork/ 均不动、不生新素材不重烘，只改 UI 设计代码（ui_kit 色板 token/字号档/布局纪律/对比度垫底/抖动呈现/panel_skinned 接线等）。无分歧可直接收项=对比度 7 处 FAIL 修法（血数 2.09→12.29 垫底等已复算）/站桩溢出 3.2px/4 处裸色收 ui_kit/status 图标 preload 违规/tg-* 类型色接线。**前置待裁=六分歧点**（①底色冷暖 ②棋盘格边长 32/44/45 ③字号档位 ④九宫格切片 ⑤圆角去留 ⑥图标尺寸解法，对照表 §三）+开放项（抖动范围/色板唯一来源，§五）。需求卡片=`design/research/需求卡片-UI设计对齐批-2026-10-05.md`（T0-T11≈7.25d，**超软盒 3d 预挂**，三段切分=段一 2.0d 无阻断〔T0-T4a〕/ 段二 4.0d 待裁〔T4b-T8〕/ 段三 1.0d 收口〔T9-T11〕；🔴 契约 7 条 R1-R7；无分歧收项 N1-N6 已逐处 file:line 考证；**待用户裁点 11 项**=六分歧 P1 底色冷暖/P2 棋盘格边长/P3 字号档位/P4 九宫格切片/P5 圆角去留/P6 图标尺寸解法 + 开放项 P7 色板唯一来源/P8 抖动范围/P9 §五 已决注销清单/P10 记忆态口径/P11 装饰 caption 豁免；**六分歧与开放项一律呈全备选案含淘汰依据**）。**事实校正（实查，2026-10-05）**：9 处色板漂移实测 4 已收 5 未收；`tg-*` 五族在 ui_kit 并不存在（以裸 Color8 内联于 bonus_pick_overlay/shop_overlay_view，缺第五族）；panel_skinned 消费面实测 8 处+工厂 1 处；棋盘格边长=动态公式 clamp[26,46] 与 §8.1 锚点 45/36 三方互不等；手绘图标十枚 20×20 已入库，真问题转为 64×64 柜台四枚显示倍率；站桩溢出实机存在 1px 余量同型写法（standee_body.gd:476）；demo 基线 md5 已再次漂移（实测 78ebbee0…）。状态=**需求卡片已起草（2026-10-05）+ 取向已定（2026-10-06）**：✅ P1=甲（维持暖化零改动）/ P2=丁（棋盘格边长零改动，46/45/44 不一致登记为已知偏差）；✅ **其余八项取向已定**（用户采纳推荐）——**跟 demo**：P4 九宫格切片 8→16 / P7 五处色板向 demo / P10 记忆态纹理灰罩；**按条款解**：P3 字号立 FS_* 档（demo 34 处<14、54 处<16 不可跟）/ P6 图标显示档（demo 自身 0.3125× 违规）/ P8 抖动只做卡顶色带（demo 渐变+blur 违反像素纪律）/ P11 装饰 caption 12px 豁免；P5 两路同结论。**「以 demo 为准」三层优先级栈=需求卡片 §8.3**（①用户终裁＞②冻结条款＞③demo）；三条结构级差异（卡片 232×352 / 商店全屏化 / 地图底栏合并）**不入本批、已登记 06 待立项**。估时 T0-T11≈**6.9d**（段一 2.15d 无阻断可发令 / 段二 3.75d / 段三 1.0d；三段同属一迭代、**只在段三末合并一次**）；**拷打轮一 9 问已全部落地**（Q1 `panel_skinned` content margin clamp / Q2 不走独立样张闸改并进 T10 目检 / Q3 柜台图标统一 32px / Q4 商店补类型分族 / Q5 血数 11px 与装饰 caption 合并写一条豁免 / Q6 槽两态不新增通道 / Q7 一次合并 / Q8 已知偏差已登记 06 / Q9 demo 取值抄录表为唯一引用源）。**✅ 已全批入库（2026-10-06 单会话，worktree g-plan2-iter16ui 分支 iter16-ui-20261005 十二提交 85ea024..T11 收口笔，主区 merge --no-ff 哈希见 active.md 快照行；出口报告=[iter16-ui-exit-report](design/qa/iter16-ui-exit-report-2026-10-06.md)）**：T0-T10 全落（T10 人闸材料包=[iter16-ui-human-gate-checklist](design/qa/iter16-ui-human-gate-checklist-2026-10-06.md)——实机目检+代拍板追认八项归用户）；闸=冒烟 782/0（断言数持平基线）+run_all 16 套全绿+探针五件全绿（新增 ui_contrast_probe 11 对测点+ui_struct⑥standee 断言族入默认段）+doc 三闸/熵增零新增+MC 零跑（纯呈现批——核心/数据层 diff=0 实证）+素材零触碰；T0 实机复算三处修法改向（意图徽标垫牌/槽位字深化/RAP 零改动——demo 口径在实机反向）+N4a 裸色实数 25 处/10 文件全收 ui_kit（需求卡片 5 处系漏记）+字号 107 位点归档 FS_* 六档；偏差八条在出口报告§汇总；遗留=06 新登记「呈现层残余 <4.5:1 文字位」一条（名行四墨/顺位徽标/RAP 反馈——批外邻接发现） | 迭代 15 出口 | 预算 T0-T11≈6.9d（三段切分）——**实际单会话一次跑完（2026-10-06）** | -| 迭代 17 | **⓪内容数据驱动扩展批（2026-10-06 用户令插队为头卡——①-④卡顺延，其需求卡片与裁点状态原样保留）**：把内容效果行为从结算代码硬编码搬进数据行「订阅事件（on）+条件（when）+效果类型（do）」，通用解释器 EffectEngine 统一执行——完成后加「已有效果类型」的新专长/秘宝=纯改 `.tres` 零代码。裁决八条全落（R1 发布订阅同步 emit 确定性优先/R2 仅一个改写窗口不做拦截器链/R3 一事件多订阅+组合规则封冲突面/R4 旧 23 挂点枚举删除·2 个退化条件行/R5 现有实现全改造+06 在册只登记〔curio_roll/shop_purchase/gp_settle 三事件登记不实施〕/R6 框架先行发射点不论有无订阅者全埋/R7 一个迭代四模块垂直切一次合并/R8 术语纪律：事件=发布订阅 topic、效果类型=订阅后逻辑、组合规则=叠加规则，禁 hook/合并律等自造词）。词汇表定稿=**实施 16 事件**+效果类型 19 行 23（v1.1 扩 damage_mult/open_ticket 两型装下减半/开单现状）+组合规则 6；存档零改动；文案表值化随批（现有实现判据）；luck_coin 经 reward_roll 迁移随批。需求卡片=`design/research/需求卡片-内容数据驱动扩展批-2026-10-06.md`（v1.1 2026-10-06 联审修订：level_clear 归登记不实施/对拍判据两套〔确定性复放与冒烟=逐位、MC 统计量=成型画像同带 m4iter12 口径〕/映射表五处语义修正/断言面随迁与订阅重建时机补列；T0-T7≈4.5d，零待裁点，🔴 契约 5 条含行为等价两套判据+护栏保留+确定性；停机点 S1 首流派对拍/S2 批末闸；开工门=U0） | 迭代 15 出口（已解） | T0-T7≈4.5d |**状态**：**已合并进 master e535436（2026-10-07 编排会话收口；worktree iter17-dd 分支 iter17-dd-20261006 五提交，六闸全绿+主区复跑全绿〔合并后冒烟 805/0〕）**——T1 效果引擎框架+16 发射点（7d157b3）/T2 词汇落码（225765f）/T3 专长 27 行迁移+旧挂点消亡（e28a6cb）/T4+T5 秘宝六件+令牌树收尾（a33ddaf）；六闸全绿（冒烟 800 项 0 失败/单元 17 套/探针含 click/MC 二档对拍 40 局同种子逐位一致）；出口报告 design/qa/iter17-datadrive-exit-report-2026-10-06.md，遗留人闸两项随报告 | -| 迭代 17 | **①敌人表行集多行批（2026-10-05 用户令编入本迭代，纯功能与数值轴四卡之一）**：放开敌人表「同一（关卡序号 × 节点深度）行集恰一敌种」加载期校验（enemy_table.gd:108-112 考证在册），允许同场遭遇混编多种敌人——生成（unit_container spawn 行集受理）/编排（battle_orchestrator/narrator）/断言面全链接通 + GDD 结构冻结面修订先行（敌人系统.md:75/:263）。事实源=06「同深度第二敌种与精英/Boss 编码位」条剩余面（前半已由关卡节点地图 v1.0 消解）；前置=技能池实施批已入库（d3fa887）开工门已解。需求卡片=`design/research/需求卡片-敌人表行集多行批-2026-10-05.md`（**v1.1 2026-10-06 联审修订**：F7 勘误 19 行 9 敌种/P1 补遭遇骰交互〔每行一骰·RNG 扩签先报批〕与实例总数≤4 消歧/P3 改裁丙撤投放/新增契约 R6 混编行行序纪律/expect_pools 断言换代入组 D；T0-T8≈3.75d〔T5 撤投后，超软盒预挂，T4 末切分点〕；🔴 契约 6 条；**✅ 裁点全裁（2026-10-06 用户令：P1甲〔Q8/Q9 二裁补全〕/P2甲/P3丙〔Q3 二裁撤投放——一裁乙与首遇教学位纪律三面冲突〕/P4乙 Boss 行亦放开·知情代价六面在册）；开工=U0**） | 迭代 15 出口 | **✅ 已全批落码入库（2026-10-07，主区 merge --no-ff 9cc4b8b，闸全绿+主区复跑全绿〔合并后冒烟 811/0〕，worktree g-plan2-iter17-enemy 分支 iter17-enemy-20261007 基点 e535436，批内提交 a0b06b4(L3 报告)/5b9cf59(甲案裁决)/18cdcb0(T0)/ab5ddad(T1)/8690230(T2)/bc73fa3(T3)/c583940(T4)+收口批；一次 L3 停机=卡⓪改前锚随 worktree 删除丢失不可恢复→用户裁甲案补采改前锚 40 局·总量 80 局明示批准；出口报告=[iter17-enemy-exit-report](design/qa/iter17-enemy-exit-report-2026-10-07.md)）**：行集构成纪律三条落码（同坐标多行混编放开含 Boss 行集 P4乙+行序相邻加载校验 R6+实例总数≤4 spawn 守卫 P1甲）+floor 版解析退役全仓统走 ceil 行集数组（P2 甲，状态记录 312 销号）+spawn 行集受理逐行实例化+遭遇骰逐行各掷（Q8——单行行集消费序/次数逐位一致=零内容期随机流零变化）+断言面换代（expect_pools 三元键/双表精确行集契约/L2L3 定点行集口径）+混编正反断言十一条（冒烟六+单测五）；文档=敌人系统 v0.15/难度曲线与Boss v0.24/registry/06 状态行；闸=冒烟 811/0（基线 805/0，+6 混编断言）+run_all 17 套+probe_gate 含 click 全绿+doc 三闸/熵增存量红零新增+MC 改前改后 40 局同种子全字段零差异（零漂移铁证；补采锚 L1 口径读数 off 4/20·formed 16/20 与卡⓪出口报告逐位同值=等价旁证）；**人闸=实机目检四项+代拍板追认九项**（design/qa/iter17-enemy-人闸材料-2026-10-07.md。原估 T0-T8≈3.75d） | -| 迭代 17 | **③暂停层只读入口批（2026-10-05 用户令编入本迭代）**：新增局内暂停层，承载钥石余额与解锁态（营地三柜台进度）只读查看——事实源=06「解锁界面与钥石呈现的交互形态（残余：暂停层只读入口）」条。考证在册：现行无暂停层；模态栈/设置面/调试浮窗三先例齐；UiKit 公共件（modal_shell/bcard/verb_button/徽章形制）与色板 token 单点现成；MetaProgression 只读访问器面齐全；战斗屏 GP/钥石已迁出=局内零查看入口正是本批由来。**美术红线：复用现行公共件与色板，零新素材零新色值（2026-10-05 用户立规）**。需求卡片=`design/research/需求卡片-暂停层只读入口批-2026-10-05.md`（T0-T5≈3.0d；🔴 契约 5 条含公共件单点/模态登记纪律；**✅ 裁点全裁（2026-10-06 用户令全按推荐：P1丁/P2甲/P3甲/P4甲）；开工=U0**） | 迭代 15 出口 | **✅ 已全批落码入库（2026-10-06/07，主区 merge --no-ff c8beaa2，闸全绿，worktree g-plan2-iter17-pause 分支 iter17-pause-20261006 两会话接力完成，提交 c08a901/fc9eb1e/d44fdd5+收口笔；出口报告=[iter17-pause-exit-report](design/qa/iter17-pause-exit-report-2026-10-06.md)）**：暂停层本体+badge 工厂件收编（Q10 甲，营地钥石徽同步迁移观感零变化）+两屏常驻角标入口与 has_open 守卫+四探针断言（结构/点击/输入锁 case⑯/只读巡检/零动效契约/对比度对）+冒烟投影一致性 5 断言；闸=冒烟 788/0（基线 783/0）+run_all 17 套+probe_gate --click 全绿+doc 三闸零新增+MC 零跑（纯呈现零数值）；存量移交=熵增闸 design/diagrams 越界（00712d5 总图批已入库漏步，主区同红）+06/07 gdd_lint 存量注记红（本批零触碰）；**人闸=用户实机目检**（design/qa/iter17-pause-human-gate-checklist-2026-10-06.md，重点含排播排空副作用确认项 D2。原估 T0-T5≈3.0d 贴软盒内） | -| 迭代 17 | **④生涯界面设计立项（2026-10-05 用户令编入本迭代；只做设计提纲不做实装）**：事实源=06「『生涯』界面——冒险中数据回看的唯一承接处」条（P-C7 裁：M9 已退役局内结算明细回看，历史数据现无承接面=用户知情裁决）。考证在册：回看退役已落码（battle_end_overlay/battle_log_view/ui_assembler 三处注记）+settlement_review_overlay.gd 遗留件在盘+跨局持久面=save v5 meta 域+recent_summaries 现役逐局留痕（cap=10，save_manager.gd SUMMARY_CAP——2026-10-06 联审勘误：原记「无历史冒险记录面」系事实错误；真实缺口=cap 扩容+用时埋点+总局数/通关局数 lifetime 计数域〔涉存档 schema〕+营地既有最近冒险清单的去留设计）。需求卡片形态=设计提纲版：信息架构+承载内容清单（跨局汇总/历史冒险回看/图鉴承接）+与既有界面关系+三期实装建议+待裁点，标注「实装批另行立项」。需求卡片=`design/research/需求卡片-生涯界面设计立项-2026-10-05.md`（**v1.1 2026-10-06 联审修订**：F4 改正 recent_summaries 现役/P2 甲口径重述=扩容+用时埋点/总局数通关局数标注涉 schema/营地清单去列入设计稿必答项/N 候选补「维持 10」；T0-T2≈1.25d 纯文档零测试；**✅ 裁点全裁（2026-10-06 用户令全按推荐：P0甲/P1甲/P2甲〔N 实装期定〕/P3甲/P4甲/P5甲）；开工=U0**） | 迭代 15 出口 | ✅ **设计提纲已成文待用户评审（2026-10-06 卡④设计批完成，worktree iter17-career-20261006，纯文档零代码零测试）**：提纲=design/gdd/systems/跨局循环/生涯.md v0.1（范围草案——信息架构/承载内容清单/界面关系/分期建议/待裁点五节，P0-P5 已裁结论落文，新发现待裁点 P6 营地最近冒险条带去留随评审一并裁）；02 根索引补行+06 状态行换代「设计提纲已成文待评审」。**人闸=用户评审提纲**；评审通过后期一/二/三实装批另行立项（不预占排期。原估 T0-T2≈1.25d 软盒内） | -| 迭代 18 | **③武器锻造系统设计提案批（2026-10-06 用户令入迭代 18；纯文档零代码——提案源=playnote 2026-10-06）**：用户提案=攻击力提升改造为「武器锻造」——剑（普攻）锻造升级加攻击、满级附带额外效果；后续增列长枪/法杖，攻击类型分别走穿刺/魔法；护甲由轻甲起级（先只提 AC）→解锁重甲/魔法甲（基础 AC 各异、可续升、满级各带额外效果）——武器/护甲差异化。产出=系统设计提案文档（与奇物属性值提升分类/护甲克制轴/营地柜台/锻造经济边界对齐，数值框架 provisional 终值归 Alpha 收官 M4 数值批统一调整〔未排期〕），裁点呈用户裁决；实装批另行立项。06 已登记专条。需求卡片=`design/research/需求卡片-武器锻造系统设计提案批-2026-10-07.md`（提纲版 v1.0——设计裁点在提案产物内全备选呈裁，需求卡片零待裁点；开工=U0） | 🔨 提案已成文交付（2026-10-07）待盘问裁决（异步不阻塞） | T0-T2≈1.5d（一轮呈裁基线，盘问轮次扩展另计） | -| 迭代 18 | **④生涯界面实装批（2026-10-06 用户令入迭代 18）**：按迭代 17 卡④设计提纲（design/gdd/systems/跨局循环/生涯.md v0.1，master 44328b1）实装「生涯」界面——跨局汇总/历史冒险回看/图鉴承接；提纲在册要点=recent_summaries 现役 cap10 扩容+用时埋点/总局数与通关局数（涉存档 schema）/营地最近冒险清单去留（P6 必答项随评审定）；分期建议随提纲。需求卡片=`design/research/需求卡片-生涯界面实装批-2026-10-07.md`（v1.0——范围=提纲期一〔汇总页+主菜单入口+终身计数域存档 v6〕，期二/期三零触碰；裁点 P1 通关局数口径/P2 汇总条目集/P3 模态登记序待裁；提纲评审若改期一范围则需求卡片升版） | **✅ 已落地（2026-10-07 worktree iter18-career：提纲期一追认+裁点全裁〔2026-10-07 用户令代解/全甲；P6 随期二〕后 T0-T5 全落——生涯页六类九项+主菜单入口+终身计数域存档 v6；批末重闸全绿=冒烟 834/0〔基线 814/0，+20〕+run_all 17 套+四探针+ui_contrast 15 对+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔⑲目检条目随 07〕；出口报告=[iter18-career-exit-report](design/qa/iter18-career-exit-report-2026-10-07.md)）** | T0-T5≈2.5d | -| 迭代 18 | **⑤混编遭遇首批投放批（2026-10-06 用户令入迭代 18；纯内容批——机制前置=迭代 17 卡①敌人表行集多行批）**：07「后续内容批义务」落地——首个混编遭遇行+Boss 多行内容投放（敌种候选与坐标=本批裁点）；首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）；难度带读数义务随批登记 07，MC 取证跑批**顺延 Alpha 收官 M4 数值批统一执行**〔未排期，届时另令——2026-10-06 用户令：数值统一调整殿后；投放本身不阻塞〕。需求卡片=`design/research/需求卡片-混编遭遇首批投放批-2026-10-07.md`（v1.0——纯内容批零代码，机制面全由卡①承载，机制缺口=L3 停机；裁点 P1 首批投放方案〔荐甲=L2 单点试水〕/P2 Boss 多行不入首批/P3 教学界保护待裁） | 迭代 17 卡①已入库（✅ 已满足 9cc4b8b）+**✅ 裁点全裁（P1-P4 甲，2026-10-07）**——开工=U0 | T0-T5≈1.75d（MC 取证顺延另计）——**✅ 已全批落表（2026-10-07，worktree g-plan2-iter18-mixenc 分支 iter18-mixenc 基点 adadf56，批内提交 ad36e35(T1 设计稿)/6272fc8(T3 落表)/43b1306(T4 断言)/⑤T5 收口批；出口报告=[iter18-mixenc-exit-report](design/qa/iter18-mixenc-exit-report-2026-10-07.md)）**：(2,5) 双行混编落表〔重击手+巨蜘蛛巢群（行值复制 (2,6)，P4 甲零数值新增），R6 行序=重击手在前〕；d5/d7 候选与行值来源全案留痕（d5 案选定）；断言面随迁（expect_pools 三元键新池模板+行集构成/行序/Σ≤4 断言）；首遇教学位 (2,4)/(3,0)/(3,1) 零触碰；07 ⑱ 目检与读数义务登记+:174 逐行骰措辞订正；闸=冒烟 814/0（基线 811/0，+3）+run_all+doc 三闸/熵增零新增（批末重闸数字见出口报告）；实机目检三项归用户（同场两敌种/行序/总数 ≤4）；MC 零跑（顺延 Alpha 收官 M4 数值批在案） | -| 迭代 18 | **⑦新冒险种子随机化+调试浮窗升级（2026-10-07 用户令入迭代 18，同日两裁点全裁+浮窗目标态已定）**：**(a) 种子随机化**——现状考证 main.gd:1210 `_seed_value()` 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现；改法=玩家界面入口（主菜单开新冒险）默认分支随机生成；**✅ 裁点全裁（2026-10-07 用户令）：①首次冒险维持固定种子（教学态可复现）/②测试脚本与调试接口维持显式指定种子（冒烟·MC·探针全链显式传种子零影响，锚零作废）/③种子不进玩家 UI**；断点续玩零影响（存档已载 master_seed 回填，main.gd:447 现役）；与⑥收官批零耦合、排序自由。**(b) 调试浮窗升级**（承载「调试浮窗可查当局数据」裁点=种子的唯一查看位；**本项修订迭代 15 卡① P3 甲「仅开始菜单可开·对局不可达」裁决**）——目标态三件：独立于整体界面的**最高层浮窗**（对局中也可开）/DS_DEBUG=1 调试态下**默认打开**/新增**当局数据只读区块**（当前局种子/关卡/节点/HP/GP/钥石等——玩家 UI 不展示、调试浮窗可查）。考证在册（2026-10-07 实查）：现行=开始覆盖层角标入口〔main.gd:292-293，DS_DEBUG=1 点亮〕+main.gd:1189 门禁「仅开始菜单可开」+Dialog 形态走 ModalStack 模态栈登记〔非最高层〕+visible=false 初始非默认开+五区块（胜利演出/种子输入/数值滑条/批量模拟/两层调试）无当局数据面。需求卡片待裁点：最高层与模态栈登记制的关系〔置顶/登记序末+move_child 或独立层〕/输入吞噬边界〔浮窗矩形外透传游戏输入〕/对局发起「随开随收」逻辑改向/ui_tune_probe 断言面换代/入口形态（角标宿主迁移或热键）。需求卡片=`design/research/需求卡片-种子随机化与调试浮窗升级批-2026-10-07.md`（v1.0——实装级裁点 P1 遮挡语义〔荐甲=维持登记制〕/P2 入口形态〔荐甲=角标迁宿主〕/P3 默认打开范围〔荐甲=启动即开〕/P4 当局数据字段集〔荐甲=六项〕/P5 首局种子值〔荐甲=沿用 42〕待裁；估时勘误 1d→2.0d 含探针换代与收口） | **✅ 已落地（2026-10-07 worktree iter18-seed：C1 种子三分+浮窗升级 P1-P6 甲全落；批末重闸全绿=冒烟 811/0+四探针+run_all 17 套+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔不阻塞已入库与后续卡④〕）** | T0-T5≈2.0d | -| 迭代 19 | **卡⓪主菜单开局缺陷修复批（原迭代 20 头卡A；2026-10-08 用户令并入本迭代、执行序第一）**：①**主菜单开新冒险+继续上局两入口补传同调三键**（attunement/attune_refresh_y/tree_rules——main.gd:510/:470，接收面 adventure_runner.gd:129-138/215-217 现成；静态考证缺陷成立：全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值）；②**关卡开场行攻血改传当前生效值**（main.gd:519-521 现传初始表值，与战斗面板不一致=用户确认缺陷；「含面板加成」后缀判断同步改为认局外加成）；③冒烟补主菜单入口传参断言；④顺手删 adventure_runner.gd:129-134 三行重复赋值（零行为变化）。范围外=被动同调件呈现（用户令不动）、Fork 规则归因行（呈现层）、X/Y 刷新双源语义倒置（实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X，见 adventure_runner.gd:658-659/:706-709；用户口径=X 持久·Y 每节点重置·先扣 Y；真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状，裁定落 GDD）。**卡①自动化验收补齐批（2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性，均自动化口径，不含人工目检〕的落地批）**：三件主内容——①**渲染闸自动化**：新增 `tools/render_gate.sh` 窗口化自动闸（shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证），棋盘 L1-L3 golden 逐像素基线入库 `game/tests/golden/`（测试资产入库先例，.gitignore 已核只挡 artwork/）；**probe_gate 头注释「渲染闸归真人目检」纪律句删除改写**（用户 2026-10-07 明示授权=历史偷懒标记），迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕；②**探针收编**：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针（实测 17.4s/49.6s/63.0s/21.9s 全绿）收进 probe_gate `--full` 段挂重闸，轻闸默认段零改；damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除（与 run_all 致命类单测重复）、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言；③**账务修正**：tests/README 套件数/断言数漂移（十五→17、752+→双口径说明）+integration 空目录处置（代拍板）。〔2026-10-07 范围改道：原「明示不收」的 B4/B5/B6 三缺口经用户令各立需求卡片并入本迭代，本卡改称卡①，新增卡②③④见后〕。需求卡片=`design/research/需求卡片-自动化验收补齐批-2026-10-07.md`（v1.1——**待裁点 0 项**，P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕；🔴 契约 6 条含运行时代码零 diff/轻闸零删减/并行避让；停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机；代拍板白名单四项）。**卡②旧界面呈现断言回补批（B5，2026-10-07 用户令立项）**：迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对（15 对现役全属 HUD/锚点/徽章/生涯）、专项契约仅 pause/career、legend/node 两屏从未过结构族；优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对；红线=只加断言零改旧屏、违例登记呈报不修（处置权归用户）；需求卡片=`design/research/需求卡片-旧界面呈现断言回补批-2026-10-07.md`（v1.1 grilling 三轮全裁——待裁点 0 项，WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死；停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕，T0-T4≈1.0d，worktree iter19-uibackfill）〔2026-10-08 施工已入库·**S1 停机态**——T1+T2 测点对 15→38 对（+23：battle_end 3/shop 5/camp 9/settings 2/curio 2/迷雾合成对 1，全 UiKit 常量实时求值）；**新对首跑暴露存量对比度违例 7 项**（结算 GP 账行 2.67:1/商店 legacy 行卡名 1.12:1/货架价签 1.46:1/营地铭牌副题 3.59:1/行价格 4.02:1/树分组头 2.67:1/工坊状态 3.00:1）——全量登记清单+修复建议案〔全现役常量换墨可落〕随出口报告呈用户裁，处置权归用户、批内零修（红线）；违例对在册=闸红登记存量形态，修复批落后自然转绿；T3 struct 13→15 根（legend/node 全真路径开合）首跑全绿 S2 未命中、WL 零新增；冒烟 840/0+run_all 17 套件持平；出口报告=`design/qa/iter19-uibackfill-exit-report-2026-10-08.md`；settlement_review 遗留件已在 06 登记落位〕。**卡③CI 预接线批（B6，2026-10-07 用户令立项）**：tests.yml 场景探针段解封——轻 CI 段=input/struct/contrast 三探针（示例引用的 ui_probe/ui_click 归 --full 重闸不进轻 CI）、Linux 独立命令形态（probe_gate.sh 系 Windows 专用）、窗口化四件禁入 headless CI；本地无远端端到端验证不可能=验收全静态核验，「首次 push 后人工盯首跑」入移交清单；远端仓库计划两文档零登记=待裁呈报项；需求卡片=`design/research/需求卡片-CI预接线批-2026-10-07.md`（v1.2——**触发分支死角已并入修正范围=tests.yml push/pull_request 两处 [main]→[master]**〔实查：实际分支 master、main 不存在，不修则远端建好后 CI 仍永不触发〕+冷检出导入步前置 smoke 步骤之前；裁点①远端仓库=✅ 2026-10-08 裁暂不建维持待命〔预接线待命=终态〕/裁点② ui_layout 入 CI 候卡①后裁；T0-T3≈0.25d，worktree iter19-ciwire）。**✅ 卡③已入库（2026-10-08，B6 闭环——出处=自动化验收补齐批 §一明示不收件，随本批销账）**：注释探针段解封=正式轻闸三探针段（input/struct/contrast，timeout 120s 外壳+退出码 124/137 超时判+PASS 串判定=probe_gate 判定逻辑 Linux 独立镜像，三探针全跑不短路汇总定红绿）+冷检出 `--import` 导入步 300s 前置冒烟之前（job 级基础设施步同覆盖冒烟与探针 .godot 依赖）+触发分支两处 [main]→[master] 修死角+头注释追加「远端仓库建好后无需改本文件即自动生效」；探针日志落 logs/probe_ci/ 顺现有 upload-artifact 段零改并入；验收全静态过（pyyaml 解析/CI 段 res:// 引用逐一实存/timeout 外壳清单齐/轻闸术语与 probe_gate 口径对齐/diff 面=tests.yml 单文件+roadmap 本行）；**⚠ S1 呈报项（该段冻结未代修，处置待用户裁）=tests.yml setup-godot 步 `nikeee/godot-actions/setup-godot@v2` 指向不存在仓库**（2026-10-08 实查：GitHub API 404+nikeee 全部 159 公共仓 grep godot 零命中+marketplace 同名件=Vitorgus/Setup-Godot v1 系 Godot3 旧件；现存活跃替代=chickensoft-games/setup-godot v2.4.3）——远端建好首跑前必须先裁此段，否则 smoke job 必红；首跑盯梢清单随需求卡片 §七 待远端立项之日激活。**卡④提灯载体道具批（B4，2026-10-07 用户令立项；原登记去向「Alpha 信息件重定批」就此改道入本迭代）**：board_view.set_fog_lantern 死接口（迭代 14⑤ 接线+case⑮ 断言在位，载体始终未造=完成度 0）补载体道具；备选案五件全列（案 A 秘宝同调位新行=原登记指向·推荐/案 B 专长新行·撞重设计冻结不推荐/案 C 商店货架·分类判据需新裁/案 D 显影尘行激活合并·与改道相逆/案 E 元进度树·破坏读数归因不推荐）+淘汰案六件各附依据，设计权全归用户；需求卡片=`design/research/需求卡片-提灯载体道具批-2026-10-07.md`（v1.2——**✅ 裁点全裁：2026-10-08 载体=案A秘宝同调位新行**〔行字段推荐值=执行中一次秒答，「按推荐」即全收〕；缺陷处置=卡⓪随同 goal 先行入库=本卡 T1 前置门〔缺陷实查定案影响全部开局入口；原记迭代 20 缺陷批，2026-10-08 并入本迭代为卡⓪〕；呈现桥=只读访问器/复原语义=begin_battle 显式重算/MC=静态论证/测试三形态等工程面全钉死，T0-T5≈2.5d，worktree iter19-lantern）。**✅ 卡④已入库（2026-10-08）**：T1=treasure_items.tres 表尾追加 fog_lantern「魔法提灯」行（行字段=用户「按推荐」全收——display_name 魔法提灯/desc 灯光区半径+2/id fog_lantern/slot_cost 1/稀有度不设字段/unlock_requires 键省略=已解锁；form=passive+triggers 显式空数组〔活行空 effect_kinds 豁免以 row.has(triggers) 为条件〕+effect_kinds=[]/target=none/magnitude=0/use_phase=active_dig/dimension_tags=[info]；表尾追加保 MC 自动档装配画像逐位不变=零漂移）；T2=接线生产路径贯通——orchestrator 装配集公共只读出口 attune_has（_attune_has 契约化）+组合根呈现桥 main._sync_fog_lantern 挂每战首轮装配链显式重算含否（round_started 首轮发射位在 begin_battle 尾 attunement 注入后=时序安全；board_changed 先发后注入故不挂）；T3=测试三形态（case⑮ 内载体级段不开新 case+smoke 现有套件加断言〔冒烟 840→844〕+存档回归 breakpoint Part 6+新单测 fog_lantern_wiring〔run_all 17→18 套〕，case⑮ 既有断言零删减）；T4=改道指路句实查六处全换代（board_view.gd :139/:145+art-bible.md:387〔顺手对齐常量实名 FOG_LANTERN_BONUS〕+HUD框架.md :168/:170〔:170 同句 2 处整段换代〕；qa 历史成文零触碰）+06 缺陷条已入库回写+秘宝.md 目录九件→十件（v1.1 行）；T5=重闸三件全绿（冒烟 844/0+probe_gate 含 --click 全绿+run_all 18 套，残留 Godot=0）；MC=静态论证零实跑（纯呈现层 off 态零生产路径变化）。出口报告=design/qa/iter19-lantern-exit-report-2026-10-08.md | 迭代 18 出口（✅ 已解——2026-10-07 四卡总收口已入库）——**开工=goal 一次跑完（2026-10-08 裁：卡⓪缺陷卡先行+卡①-④打包，全绿前禁停；subagent 并发 ≤3；唯一预期交互=卡④行字段推荐值秒答；卡⓪原迭代 20 头卡A 同日用户令并入本迭代）** | 卡⓪≈1.0-1.5d（随计划书定稿）+卡①T0-T6≈4.25d（超软盒预挂；天然切分点 T2 末——段一 T0-T2 渲染闸≈2.25d / 段二 T3-T6 收编退役账务≈2d，两段同属一迭代一次合并）+卡②T0-T4≈1.0d+卡③T0-T3≈0.25d+卡④T0-T5≈2.5-3.0d（切分点 S0：考证呈报 0.25d/实装收口 2.25-2.75d）——五卡合计≈9.0-10.0d | -| 迭代 20 | **专长实装批（奇物）**——需求卡片=design/research/需求卡片-专长实装批-2026-10-11.md（v1.1）。范围：T0-T10（效果引擎词表扩签/池结构案D 实装/专长 27 件换代/凭证五件/Boss 兑付换代〔已裁换代〕/状态账/断点扩容/MC 新基线/迁出行删除/空配置验收闸）。候选 B-F 留档不变。**✅ 已入库（2026-10-11 goal 会话 U0 开工——A/B/C 三段 T0-T10 全落 master：T1 词表扩签 a57489e/T2 案D 池 0640b0c/T3 29 行换代 54ab330/T4 凭证五件 1387aed/V4 补齐 5ebd05d/C 段收尾 3333187；冒烟 864/0+run_all 21 套+MC 同种子重放逐位复现；29 行件数口径+四级配额 104+疼痛记忆同战消费放宽+时沙/弃图兑换落法映射系代拍板追认单待用户）** | ✅ 已入库（出口闸全绿+实机目检归用户 07 在册） | T0-T10 ✅ | -| 迭代 21 | **天赋树实装批（2026-10-11 用户令编入——整卡不切分，迭代容量放宽容纳全卡）**：按 [天赋树](design/gdd/systems/跨局循环/天赋树.md) **v0.8** 设计权威文档实装——**33→12 节点**结构换代（三轮换代：攻防所有权切分 29→21〔树零攻防来源=红线，攻/AC 唯一入口=锻造工坊路线〕/一线一节点 21→15〔生命·命中淬炼各一节点×4 级、row 字段退役〕/Fork 一节点双态 15→12〔开局姿态·危险直觉·财富之道三组各一节点、购买解锁后 A/B 零币切换〕；schema=Fork 词表 4→3 组/规则键词表 2→6 键、「等级阈值前置」形态去留=R1 开放待裁点〔推荐裁撤，**不阻开工门**〕）+三组 Fork 真效果（开局姿态每关首轮窗/危险直觉与财富之道·限次计数随冒险持久按关重置）+营地统一案甲（树=营地主界面/属性升级唯一入口/工作间钥匙模型/图鉴常开/占位面板零副作用硬要求）+注入公式换代（基础值+树淬炼+锻造路线加值位预留+局内加算）+旧属性柜台退役+旧档废弃与旧逻辑删除（开发阶段无迁移，Q3 裁决）+同调位槽位判定源切树节点（旧条件删除随批清扫）+树上刷新升级接线（双入口并存写同账）。需求卡片=design/research/需求卡片-天赋树实装批-2026-10-11.md（**v1.7**——grilling 五裁+歧义扫描六裁+**2026-10-12 完备性/跨系统歧义审查十一裁**全落；零阻塞待裁点）；锻造工坊（原「武器锻造」）**17 裁点已清零**（2026-10-12 逐裁落文 v0.5，06 在册），Q5 排期前置已满足、默认本批先行；T0 的「标错机制存在性」与「boss_kill_count 消费面」两项**已预查结案**（标错机制查实存在且有代价，守侧 contingency 作废） | ✅ **已入库（2026-10-12，/goal+iter U0 开工令——T0-T7 全量交付；R1 按既定默认裁撤案执行；实现报告已退役（git 历史可考）；残留人闸=实机目检营地四柜台〔07 在册〕）** | T0-T7≈7.0-8.0d（整卡单迭代——实际 2026-10-12 单会话交付） | -| 迭代 22 | **秘宝体系实现重构落地批**——需求卡片=design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md（v1.3 C1-C6 全裁）；**2026-10-11 用户令编入**：新目录 12 件实装+解锁混合制（逐件分配锁定表在卡）+装配不可变（冒险中零更换）+旧数据行清理+效果引擎接入；槽位来源不在本批（树接口接缝——迭代 21 已实装树点亮数槽位源，本批直接消费）+装配档位格约束；估时 6d（区间 5-7d）——**✅ 已入库（2026-10-12，/goal+iter U0 开工单会话交付：T1 数据层 12 行换代+schema 扩签/T2 解锁服务+工坊面退役+档位格约束/T3 效果引擎接入+扩签+常时参数面+试炼镐积点口+充能周期/T4 呈现换代+呈现桥+试炼镐 HUD 入口/T5 替换子交互拆除+库存保留注记/T6 验收闸断言；冒烟 898/0+run_all 22 套+重闸全绿；实现报告已退役（git 历史可考）；残留人闸=实机目检秘宝解锁-装配正常流程〔07 ㉑〕）** -| 迭代 23+ | **M4 数值批（**原 22+；迭代 21 已编入天赋树实装批、迭代 22 已编入秘宝实装批，均 2026-10-11 用户令**——**Alpha 收官位·未排期**〔2026-10-09 语义换代：M4=Beta 阶段、非 Alpha 收官位，M3 未由用户明令关闭前不排期维持〕——2026-10-05 用户令编入迭代 17 卡②；2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡，2026-10-07 用户令撤回〕；**2026-10-07 用户令二次后移：后续新迭代（迭代 20 起）一律不先做 M4，除非用户明确要求启动 M4 批次**）**：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，需求卡片 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。**硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）**。需求卡片=`design/research/需求卡片-M4数值批-2026-10-05.md`（**v1.2 2026-10-06 案C 增补+联审修订**：v1.1 三事实与第五推算件照旧；联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d；案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采；T0-T8≈6.25d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；**✅ 裁点全裁（2026-10-06 用户令：P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内（Q4 二裁）/P4甲 不立直购价）；开工=U0**） | 迭代 18 全部内容卡（③④⑤⑦）出口+全部内容批行为变更落定+**用户发令（未排期）**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d（超软盒预挂，段一 T0-T4≈4.25d〔v1.2 勘误，原 4.5 系加总错误〕/段二 T5-T8≈2.0d）。**⚠ 2026-10-16 作废注：本行所载「M4 数值批」需求卡片已由用户删除、批次名义废除（四项数值欠账归 06 在册·重新归属待用户裁）——本行仅作排期史保留，不再是任何在途批次；现行空位记录见「迭代 31+」行** | -| 迭代 23 | **锻造工坊实装批（2026-10-12 用户令编入——设计面 v0.6 就绪）**：按 [锻造工坊](design/gdd/systems/跨局循环/锻造工坊.md) **v0.6** 设计权威文档实装——迁移面：①新建锻造路线行族（现役 `meta.tres` forge_products 已随迭代 21 T5 退役、无改造对象；钥石定价历史考古 20/150%、投值归 M4）②两根类型轴所有权移交（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档域+冒险开始参数面注入）③存档域 forge_routes（已预登记存档序列化.md v7 计划行）④满级特效本期不实装（只留扩展位）⑤敌方 attack_type 填值归敌人系统/战斗结算侧（非本批——敌方定义数据、与名字血量同时读写、无独立时序）⑥术语登记（v0.6 已做完：术语表+registry）⑦数值验证义务=改前/改后同种子配对读数。解锁通道=并联双通道；一次冒险=一武器类型+一甲型。**✅ 已全批入库（2026-10-12，/goal+iter U0 开工单会话交付——worktree g-plan2-iter23-forge 七提交；T1 行族+T2 两轴移交+T3 写口族+T5 存档 v7（序调先行）+T4 注入链+T6 工作间 UI+T7 收口；冒烟 938/0+run_all 24 套+probe click/full+render_gate+doc 三闸/熵增对基线零新增+MC 同种子配对零漂移；实现报告已退役（git 历史可考）；残留人闸=实机目检工作间形态与购买交互〔07 在册〕；代拍板追认单+GDD 反哺点待用户）** | ✅ 已入库（出口闸全绿+实机目检归用户 07 在册） | 估时随需求卡片立项（实际单会话） | -| 迭代 24 | **①敌人表内容修批（三关）（2026-10-13 用户令编入；**本迭代位预留后续追加卡**——用户将把其他需求陆续编入本迭代）**：需求卡片=`design/research/需求卡片-敌人表内容修批-2026-10-13.md`（**v1.1**——grilling 复核九问 Q1-Q9 已全裁、零待裁点、开工门=U0）。三件事合一：**N1** 第一关 (1,2) 降档（`enemy.tres:48` 改两值：`hp` 50→22、`armor_class` 3→2；**敌种 `bugbear` 不动**——`enemy.tres:594-600` 注释载明该行 50 血系 2026-09-24 用户裁决的设计而非填错，且 `hobgoblin` 无立绘，故「改敌种」案已否决；本批定性=阶名化解方案实机未达预期按 2026-10-13 体验反馈重裁）· **N2** 第二/三关普通敌技能投放（`skills.tres` 12→14 行：新增 `venom_spit` 毒吐 damage 1.6/CD2 挂 (2,5)/(2,6)/(2,7) 巨蜘蛛族、`shield_bash` 盾击 damage 1.7/CD3 挂 (3,0)/(3,5)/(3,7) 灰矮人族；**首遇教学位 (2,4) 池不动**，venom_spit 自 (2,5) 起投；两新行均不带 `rider_mult`——低 atk 下恒被 `damage_floor` 兜成 1 与 0.75 档等效）· **N3** 敌方 `attack_type` 加列并全填 `normal`（挂**敌种行**、20 行同值，不做差异化；`enemy_table.gd` 加枚举校验 + `unit_container.gd:119` 加单位快照 + `battle_orchestrator.gd:1406` 第 9 参由 `""` 改传值；全局平移=穿重甲受伤 −1 / 魔法护甲 +1 / 轻甲 0，使锻造甲路线首次具备战斗意义）。**契约要点**：池与敌种键属**契约级**，改必同步 `smoke_all.gd:3211` `expect_pools`（N1 因键值不变零改动、N2 同步 6 键）；节点图拓扑零触碰（A1 关卡节点图重构的地盘）；(1,1) 地精一伙不在本批范围（「第二个节点」字面偏差已登记 06）。**收口去向**：06「第一关遭遇表数值异常」「第二关技能池与投放」与锻造工坊条迁移面⑥ 三条一并销号；08「二·内容量」敌种池行注摘除 | ✅ 已入库（2026-10-13 单会话交付，出口闸全绿：冒烟 949/0+run_all 25 套〔485 批基线漂移 24→25 在案〕+探针 click/full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增+MC 配对三组读数；实现报告已退役（git 历史可考）；残留人闸=实机目检三观测 07 ㉓） | -| 迭代 25 | **①UI 全局主题批（引擎原生控件接管皮肤）（2026-10-13 用户令编入；UI 美化三层诊断 · 第一层第一条）**：**✅ 已全批入库（2026-10-13 /goal+iter U0 开工单会话交付，worktree g-plan2-iter25-theme 分支 iter25-theme-20261013）**——**T0 主题资源**：新建 `game/assets/theme/main_theme.tres` 挂 `project.godot` `gui/theme/custom`（15 类型全覆盖：V/HScrollBar·ScrollContainer·H/VSlider·TooltipPanel/Label·LineEdit·SpinBox·H/VSeparator + 预盖 CheckBox/CheckButton/OptionButton/PopupMenu 弹层；`default_font` 显式指向现役同字体文件=V6 中文字形防御；位图由 `tools/gen_theme_icons.py` 一次性生成落 `game/assets/art/ui/gen/`，色值溯源表落 `game/assets/theme/README.md`）· **T1 换代退役**：`ui_kit.gd` 的 `tooltip_theme()`/`_tip_theme` 与 `styled_slider()` 样式段、`ui_assembler.gd` 挂载行同批删除（禁新旧并存），settings_overlay 几何内联+debug_overlay `_slider_row` 双轨消隐· **T2 断言与文档同步闸**：冒烟新增 V1-V6 主题词条断言 38 条。**顺手销号**＝06 第三层「UI 元素细节修」之①（音量滑轨两段对比度重配＝已填充段 BG_ROOT #3A2E22 对暖石 #B8A582 实测 5.49:1）。**契约遵守**：🔴 Button 类型词条零接触（冒烟断言在闸）· 🔴 focus 族词条零定义（全主题扫描断言）· 🔴 零新增美术素材（位图=脚本生成纯色/几何）· 🔴 全局纹理过滤未动。**引擎事实订正（呈报追认）**：Godot 4.7.2 源码+默认主题链双查实证——①CheckButton 图标词条名与 CheckBox 同套 `checked`/`unchecked`（卡片 v1.2 注③「CheckButton 用 on/off」不成立，按引擎事实落位）②Slider 无 `grabber_pressed` 图标槽（冻结表「柄·按」值 GOLD_DEEP 留档未落位）③ScrollBar 柄是 StyleBox 非 Icon（无需位图）④4.7 导入参数已无逐贴图 filter 标志（位图原生尺寸消费无滤波伪影）。**闸**：冒烟 987/0（基线 949+本批 38 断言）+run_all 25 套+probe click/full+render_gate golden 0.00%+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）。**收口去向**：06「UI 全局主题资源缺失」条移除+「UI 元素细节修」①销号；08 升 v1.3（三·界面主题行→在役、五·表现细节修行注①销号）；07 ㉔ 全屏巡检登记；实现报告已退役（git 历史可考）。**待用户**：实机目检全屏巡检+专项观察点二（07 ㉔，登记不阻塞）+代拍板追认单（位图不入 git 政策口径/CheckButton 词条名订正等）+GDD 反哺点（组件规格是否立条款入 art-bible §7 等）。↓ 原任务登记：三件事合一——**T0** 新建 `game/assets/theme/main_theme.tres` 并挂 `project.godot` 的 `gui/theme/custom`，覆盖滚动条 / 滑轨 / 悬停气泡 / 输入件 / 分隔线等引擎原生控件，并预盖 CheckBox / CheckButton / OptionButton 及其弹层 PopupMenu（须在新主题内显式设 `default_font`＝现役同一字体文件；新增小位图落 `game/assets/art/ui/gen/`，色值溯源表落 `game/assets/theme/README.md`）· **T1** 退役 `ui_kit.gd` 的 `tooltip_theme()` 与 `styled_slider()` 两处局部做法、消 `debug_overlay._slider_row` 双轨（🔴 旧实现同批删除）· **T2** 断言与文档同步闸。契约要点：🔴 Button 类型词条零接触 · 🔴 focus 族词条零定义 · 🔴 不新增美术素材、不改美术圣经 §7 · 🔴 全局纹理过滤不动 | ✅ 已入库（出口闸全绿+实机目检归用户 07 ㉔ 在册） | T0-T2≈0.5–1d（实际单会话） | -| 迭代 26 | **①UI 交互与观感批（2026-10-14 用户令编入；UI 美化三层诊断 · 第一层第二/三条＋第三层四件；本迭代位预留后续追加卡，同迭代 24 先例）**：需求卡片=`design/research/需求卡片-UI交互与观感批-2026-10-13.md`（**v1.2**——grilling 两轮八裁全落、零待裁点、卡片成立）。六项：**T1 按钮五态矩阵**（悬停=乙案 modulate 提亮〔与 primary_button 现行 `CANDLE.lightened(0.06)` 同纪律〕/禁用=本族底+α0.45 幽灵化/焦点=INK 2px 内缩 1px/危险钮补本族 pressed；走逐实例 override，迭代 25 两条主题红线断言维持不换代）· **T2 全局纹理过滤**（`project.godot` `default_texture_filter=0`＋vignette/gradient_base/beams 显式 LINEAR 白名单＋翻转面全枚举）· **T3 <4.5:1 换墨**（站桩顺位/护甲徽标换同族亮档＋RAP 行 STONE_DEEP，机检断言锚定）· **T4 光柱连续 alpha 渐变**（0→0.05→0 横向＋纵向衰减）· **T5 元素细节余②③**（BCard 图标槽明度差降档/商店卡片区垂直居中/营地四栏等高）· **T5b 诊断转储钮移调试浮窗**（`dump_diagnosis` 功能保留）。🔴 契约 5 条（主题层零新增词条/零新美术素材/棋盘零触碰/对比度 ≥4.5:1/旧实现同批清理）；验证闸 V1-V7；代拍板白名单八项；反哺点四条；**渲染闸 golden 面处置**=T6 第 4 步（徽标换墨落 board golden 裁剪区：闸红→核热区限预期面→显式重制基线+呈报→复闸，超预期=L3）。**范围订正**（grilling 实查，iter25 滑轨条同款先例）：②垫块仅三选一 BCard（商店卡实为纯文字行卡）/③仅商店+营地（三选一已居中）/危险钮「无按下态」订正为「在但皮肤错配」。估时 T0-T6≈2–2.5d | **✅ 已全批入库（2026-10-14 /goal+iter U0 开工单会话交付，worktree g-plan2-iter26-ui 分支 iter26-ui-20261014 七提交）**——T0 基线+枚举（含卡片 §2.2 枚举漏项勘误）/T1 按钮五态（悬停 modulate 提亮/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px/危险钮本族按压态）/T2 全局 Nearest+平滑渐变件 LINEAR 白名单/T3 三处换墨（GOLD_BRIGHT/HERO_BLUE_BRIGHT/STONE_DEEP，6.47/5.88/5.98:1）/T4 光柱连续 alpha/T5 图标槽柔和档+商店居中+营地四栏等高/T5b 诊断钮迁调试浮窗；冒烟 987→1055/0（+68 断言）+run_all 25 套+probe click/full+render_gate golden 0.00%（登记即结未重制）+doc 三闸/熵增对基线零新增；MC 零跑（零数值零行为=纯呈现）；实现报告已退役（git 历史可考）；残留人闸=实机目检五项（07 ㉕）；待用户=代拍板追认单十三项+GDD 反哺点四条 | T0-T6≈2–2.5d（实际单会话） | -| 迭代 27 | **①代码架构技术债修复批（2026-10-14 用户令编入；来源=[代码架构与实现质量审计报告-2026-10-14](design/research/代码架构与实现质量审计报告-2026-10-14.md)，双席审计基线 97de02c，已逐条复核）**：需求卡片=`design/research/需求卡片-代码架构技术债修复批-2026-10-14.md`（**v1.2——三点全裁零待裁〔2026-10-14 用户三裁全按推荐案：①第三个 autoload／②单类持四账／③审计五段〕，卡片成立**）。五波：· **波一 场景拆分＋局生命周期物化（≈4-5d）**〔P0-1/P0-2：屏容器 .tscn 切分＝开始菜单根场景＋营地场景＋冒险场景〔内含 level_map/battle 两容器〕，视图代码原样搬、**40+ views 不转 .tscn**；SaveManager/MetaProgression 升格跨场景持有者；「一局」物化为可整体 `queue_free()` 的节点，`main.gd:647-657`/`:555-559` 手工清单消亡；13 个 smoke 探针挂载假设同批迁移〕· **波二 `_settle` 拆段（≈1.5d）**〔P1-1：五段 Segment 类 grant/aura/combat/decay/verdict，24 处 kind 分派随段归位，姊妹病灶 `damage_controller.gd:272` 148 行同批拆〕· **波三 账本收口（≈1.5d）**〔P1-4 共享四账 Ledger 类化＋P1-2 刷新双账删 main 副本＋P1-3 summary 增 `gp_final` 键、删 `gp_shadow_ledger.gd`〕· **波四 组合根可测化抽取＋模态协议内聚（≈1.5-2d）**〔P1-5/P2-7；**须在波一落地后重估抽取面再动**〕· **波五 类型闸收尾＋卫生件包（≈3d）**〔P1-6 拉闸＋存量 73 处收口，**须在其他重构全部落地后**；P2 七组顺手带〕。🔴 契约 6 条（**零行为变更·重构前后同种子完整局输出逐位一致**／只拆不重写／views 不转 .tscn／探针契约零破坏／信号纪律不变／执行顺序锁＋渲染零漂移）；**核心验收＝逐位一致对拍**（RngService 单盐流在役）；验证闸 V1-V9；代拍板白名单九项；反馈点两条（architecture／code-conventions）。 | **✅ 已全批入库（2026-10-14 /goal+iter U0 开工单会话交付，worktree g-plan2-iter27-techdebt 分支 iter27-techdebt-20261014 七提交）**——波一 三屏场景化+run_scope 会话物化+双 autoload（7a0d57d）/波二 _settle 五段 Segment+英雄攻击拆步（26301ba）/波三 RunLedger 单类四账+刷新双账删副本+gp_final 删影子账（6fd7d78）/波四 ModalFlow+互斥域 tags+双 context（8b9e556）/波五a 类型闸 368 参数化+审计器+warning 配置（b605022）/波五b 卫生件 13 死代码+FeatsEngine 退役+Callable 换装+状态机 enum 化+ConfigDB 归根+resolver 解耦（T6 笔）/T7 文档同步（本笔）。**闸**：逐位一致对拍三变体五跑全同（V1 核心验收）+冒烟 1055→1081/0（+V2 屏壳 11+V3 两连局 11+V4 段类 16+V6 模态 19+V5 快照 3+V7 2 断言）+run_all 25→27 套+probe click+render golden 0.00%+static_scan S1/S2/S4/S9 全绿（历史 cd 静默空转顺修）；MC 对拍=parity_anchor 三变体×40 局×RUNSUM+JSONL 双面（工具入库 tools/parity_anchor.py）；实现报告=reports/iter27-实现报告-2026-10-14.md（代拍板追认单十五项+GDD 反哺点两条）；残留人闸=实机目检五件（07 ㉖）；审计报告本体按退役规则 git rm | T0-T7≈12-14d（实际单会话） | -| 迭代 28 | **①启动装配与生命周期验收补全批（2026-10-15 用户令编入）**：需求卡片=design/research/需求卡片-启动装配与生命周期验收补全批-2026-10-15.md（v1.0——零待裁点，用户预批连做全批）。六任务：T1 装配语义合同单点化+装配顺序修复+V2 断言重写/T2 boot 链路时序后置条件（_smoke_boot_chain 六断言）/T3 生命周期存活性矩阵（_smoke_lifecycle_matrix 十阶段×五引用面）/T4 渲染面内容断言（shot_probe 两自检+shot_checker 墨色占比+启动态菜单 golden）/T5 变异验证（横切随批）/T6 规范落文+文档同步闸+收口；修复坏事实三件（main.gd:207-210 装配序错致 F5 见战斗界面、smoke_all.gd:176 V2 断言保护 bug、菜单截图无内容断言）。🔴 契约 7 条（零玩法行为变更/合同单点化/断言禁裸下标/测试先行/变异验证门槛/只加不重构/闸机轮次纪律） | ✅ 已入库（2026-10-15 单会话交付：T0-T6 全绿；冒烟 1125/0、run_all 全套、probe_gate --click/--full、render_gate 四闸全绿；变异验证六次注入全见红；实现报告=reports/iter28-实现报告-2026-10-15.md；残留人闸=实机目检启动态菜单〔07 ㉗〕） | 实耗≈1 会话（原估 T0-T6≈5.25d） | -| 迭代 29 | **①测试分层与门禁语义修正批（2026-10-16 用户令编入）**：把验收语义从「跑一遍没崩＝冒烟通过」扭转为「**三层完备＋判定可靠**」——兑现用户三条诉求（①最单元的逻辑代码有单元测试 ②整体模块有接口测试 ③整体系统有 UI 方面与场景切换相关的测试）且验收不止于冒烟。四件事：**①本地闸三硬闸**（退出码为唯一权威判据·PASS 串降级为日志；`SCRIPT ERROR`/`Parse Error` 扫描命中即红；断言数为零即红——`probe_gate.sh` 四探针判定改退出码优先、`test_kit.finish` 零断言判红、`run_all` 汇总校验实跑套件数，全部反例实证留档）；**②L2 接口层从零建承载**（建 `game/tests/integration/`＋`parity_anchor` 收编入闸表＋存档⇄RNG 快照往返首个集成用例）；**③L3 屏壳切换探针**（新建 `screen_flow_probe`：六步主流程＋三屏壳 `visible` 互斥＋放弃回退路径，入轻闸）；**④L1 补洞＋术语订正＋状态记录清理**（4 个 core 零指名模块＋呈现层风险前三补单测；「冒烟」唯一保留语义＝秒级存活检查；15 个游离脚本逐个定性、golden 基线时效判定、补 S5 扫描规则）。🔴 契约 7 条（零玩法行为变更／三硬闸不可绕过／现有断言面只增不减／不引入第三方测试框架／架构事实唯一源＝architecture.md／探针契约零破坏／测试执行两入口铁规）；验证闸 V1–V11；代拍板白名单 10 项；**无用户目检项（纯基建）**。需求卡片=`design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md`（**v2.0**——三轮复查定稿、零待裁点；§2 事实面改指针归 architecture.md「测试与质量域」节，T2 吸收 CI 残留 8 处，T6 收 S3 路径修正＋零命中自检，T5 补洞选面换 board_generator；T0–T8≈6.0–7.5d） | ✅ 已入库（2026-10-16 /iter U0 发令；worktree `g-plan2-iter29-testlayers`，分支 `iter29-testlayers-20261016`；重闸全绿、存量红零新增；**遗留＝11 号闸 parity 对拍待用户批准发起**） | 实耗≈1 会话（原估 T0–T8≈6.0–7.5d） | -| 迭代 30 | **①UI 呈现批（原「三卡批」——2026-10-17 用户令剔除卡②③：两卡本质是设计澄清/美术定稿环节、无现成素材可消费，不满足「迭代=代码实现批」的开发条件，移 06 待设计；重新立卡开发前须先走设计讨论→需求澄清→美术定稿）**：**①未开格类型徽章批**——类型微光实装：英雄周界 8 格内未开格、组粒度五组色相（色相系既裁=art-bible 样张 v2 定稿，本批只补从未定义的组间明度档 provisional 值、复核转正义务移交②）、渲染路线裁丙=每格 CanvasItem shader 接触带柔光为主+程序绘制兜底（T0 原型帧先行件前置；视觉调优走「出帧→目检→改参」迭代，不承诺轮数）、开关裁丙=默认开+组合根布尔+调试浮窗可切（off 态逐位一致断言承接基线保护）、静态态（§2.1 既裁合规）、两套色带不并入本批（统一另登 06 条·批次出口写入文档）。卡片=`design/research/需求卡片-未开格类型徽章批-2026-10-16.md`。验收=机检断言+用户目检（真人检测按 CLAUDE.md 既裁登记不阻塞、否决即回补）。〔卡②战斗一屏样张批／卡③第二三关棋盘观感批已于 2026-10-17 用户令剔除本迭代位，移 06「待设计」条，原 v1.4 卡片留 `design/research/` 作设计讨论素材〕 | 卡①已入库（2026-10-17，7ffd1dc0；卡②③已剔除→06 待设计） | 卡①单批 ≈4–5d，已交付 | -| 迭代 31+ | **（位空·无批次——原「M4 数值批」已废）**：2026-10-16 用户令删除需求卡片（原话「它就不是一个应该存在的东西」）⇒ **禁止再以「M4 数值批」名义立批、再规划、再引用已删卡片**。四件数值欠账本身仍在册——①削弱档位终值 ②调参批数值点评（06 条目现行五条）③钥石产出重标＋通关率带重扫（迭代 10 奖励重构联动欠账）④元进度定价剩余面（forge 定价·Boss 两档终值）——连同各批 provisional 终值标定义务，**一律归 `design/gdd/06-待办清单.md` 跟踪，重新归属待用户裁**；读数复算义务（迭代 14 两件后置）仍挂 07，damage_probe A1 既有红灯在册。M4=Beta 阶段口径不变（M3 未由用户明令关闭前不排期）；本迭代位留空待用户令编入 | 用户发令编入（未排期） | —— | +- 历史行的「—」= 该列事实不可考：迭代 1~8 早于需求卡片制；编排时点与预计周期不再回溯，细节查 git 提交史。 +- 「已退役（git 历史可考）」= 需求卡片或实现报告曾存在，已按「证据只留最新」退役；已完成迭代的实现报告列只填 reports/ 现存路径或本保留字，不填「—」。 +- 新迭代行的编排与各列判据见 doc-conventions §12.2 与 iter-plan 技能，由流水线闸（`tools/pipeline_gate.py`）机检。 ## 执行纪律（2026-09-27 用户立规） 1. **一迭代一 loop**：所有更改任务（功能/文档/数值/素材接线）一律进本路线图的迭代，每迭代先立计划书再开工，一个迭代一次合并登记——**零散并行会话退场**（多会话并行 = 冲突源+介入成本；2026-09-27 起单迭代串行执行）。状态记录记「批」= 本文件记「迭代」，同物异名。 2. **例外 = 零碎 bug**：单独会话 mini-loop 修复（修→轻闸→状态记录登记），不立计划书、不占迭代位；同屏同类 bug 攒够一笔可并入下一个迭代当任务卡。 -3. **用户输入闸显式化**：迭代门里所有需要用户表态的点（否决原因/裁决/试玩）在「当前位置」挂起清单可见，解一个开一个。 +3. **用户输入闸显式化**：迭代门里所有需要用户表态的点（否决原因/裁决/试玩）在 active.md「未决面」可见，解一个开一个。 ## 批次 loop 规范（loop engineering） diff --git a/tools/pipeline_gate.py b/tools/pipeline_gate.py index a4f58868..9388e2a6 100644 --- a/tools/pipeline_gate.py +++ b/tools/pipeline_gate.py @@ -3,11 +3,12 @@ r"""pipeline_gate.py — 工作流程流水线闸（06 条目状态机＋roadmap 迭代总表＋一次交叉核）。 职责：机检 06 条目（标题元数据/属性齐备/状态词白名单/条件凭据/状态段累积制在场约束/特批/ - 零命中）与 roadmap 迭代总表（六列/状态四形态/卡片与报告存在性/周期≤2 周可特批豁免/ - 单元格白名单/零命中）；「已编迭代↔已写卡段↔迭代行卡片列」交叉核只此一处。 + 零命中）与 roadmap 迭代总表（六列/状态四形态/卡片与报告存在性/编入时间与预计周期的 + 历史行「—」豁免/周期≤2 周可特批豁免/单元格白名单/零命中）；「已编迭代↔已写卡段↔迭代行 + 卡片列」交叉核只此一处。 约束：每红项一行「文件:行号 判据名 一句白话说明」，exit 0=全绿 / 1=有红 / 2=输入件缺失； - 卡片与报告存在性相对 --repo-root 解析（缺省=本文件上两级）；现行 06 与 roadmap 尚为旧格式， - 对其红属预期（第二批数据整改后才注册上闸）。 + 卡片与报告存在性相对 --repo-root 解析（缺省=本文件上两级）；06 与 roadmap 均已为新格式 + （2026-10-18 数据整改批），本闸已注册进 tools/run_all_gates.sh 文档域（08c 流水线闸）。 用法：python tools/pipeline_gate.py [--todo PATH] [--roadmap PATH] [--repo-root PATH] """ import argparse @@ -287,32 +288,34 @@ def check_iter_table(block, issues, where, root): if not STATUS_COL_RE.match(status_n): issues.append((where, ln, "总表状态列", "「%s」不在四形态（待开工/进行中/已完成（YYYY-MM-DD）/已终止（YYYY-MM-DD））" % status)) - if norm_parens(cards) != norm_parens(RESERVED_RETIRED): + # 需求卡片列：路径逐卡查存在性；退役保留字与历史行「—」（无卡片制时期）豁免 + if norm_parens(cards) not in (norm_parens(RESERVED_RETIRED), "—"): for part in CARD_SEP_RE.split(cards): part = part.strip() if part and not (root / part).is_file(): issues.append((where, ln, "卡片路径不存在", "需求卡片列 %s 相对仓库根不存在" % part)) - if not re.fullmatch(r"\d{4}-\d{2}-\d{2}", date): - issues.append((where, ln, "编入时间", "「%s」须为 YYYY-MM-DD" % date)) - # 预计周期：≈N 周（N≤2）；超 2 周须格内带日期特批标记（§12.2/§12.4） + if date != "—" and not re.fullmatch(r"\d{4}-\d{2}-\d{2}", date): + issues.append((where, ln, "编入时间", "「%s」须为 YYYY-MM-DD（历史迭代不可考填「—」）" % date)) + # 预计周期：≈N 周（N≤2）；超 2 周须格内带日期特批标记（§12.2/§12.4）；历史行「—」跳过 week_marks = APPROVAL_RE.findall(weeks) week_core = APPROVAL_RE.sub("", weeks).strip() - wm = WEEKS_RE.match(week_core) - if not wm: + wm = None if week_core == "—" else WEEKS_RE.match(week_core) + if week_core != "—" and wm is None: issues.append((where, ln, "预计周期", - "「%s」须为「≈N 周」形态（N≤2，允许 0.5 步进）" % weeks)) - elif float(wm.group(1)) > 2 and not any(DATE_RE.search(mk) for mk in week_marks): + "「%s」须为「≈N 周」形态（N≤2，允许 0.5 步进；历史迭代不可考填「—」）" % weeks)) + elif wm is not None and float(wm.group(1)) > 2 and not any(DATE_RE.search(mk) for mk in week_marks): issues.append((where, ln, "预计周期", "「%s」超 2 周且无带日期特批标记〔用户特批 YYYY-MM-DD …〕" % weeks)) + # 实现报告：已完成=存在路径或退役保留字（历史报告已按「证据只留最新」退役），禁「—」 done = status_n.startswith("已完成(") report_n = norm_parens(report) if report_n == "—": if done: - issues.append((where, ln, "实现报告", "状态已完成但实现报告为「—」（须为存在路径）")) + issues.append((where, ln, "实现报告", + "状态已完成但实现报告为「—」（须为存在路径或退役保留字）")) elif report_n == norm_parens(RESERVED_RETIRED): - if done: - issues.append((where, ln, "实现报告", "状态已完成但实现报告为退役保留字（须为存在路径）")) + pass # 退役保留字合法（含已完成的历史迭代） elif not (report.startswith("reports/") and (root / report).is_file()): issues.append((where, ln, "实现报告", "「%s」须为「—」/退役保留字/reports/ 下存在路径" % report)) diff --git a/tools/run_all_gates.sh b/tools/run_all_gates.sh index 8b1168f2..dd7eab51 100644 --- a/tools/run_all_gates.sh +++ b/tools/run_all_gates.sh @@ -9,7 +9,8 @@ # 用法：tools/run_all_gates.sh [--code|--docs|--quick] # --code 只跑代码域闸（01 冒烟／02 单元／03 探针 --click／04 探针 --full／05 渲染闸／09 静态扫描 # ／11 回放确定性对拍＋10 熵增闸）——本批改动触及 game/ 时用（游戏工程的唯一代码验收域）。 -# --docs 只跑文档域闸（06 gdd_lint／07 doc_link／08 doc_term／08b active.md 体量＋10 熵增闸） +# --docs 只跑文档域闸（06 gdd_lint／07 doc_link／08 doc_term／08b active.md 体量／08c 流水线闸 +# ＋10 熵增闸） # ——本批改动不触及 game/ 时用：design/、根规则文件、tools/ 工具脚本、.zcode/ 配置等 # 一切非 game 改动的本域验收。 # --quick 全量档的中段自检形态：跳过渲染闸（窗口化，需开显示器）与静态扫描；完成出库禁用。 @@ -175,7 +176,7 @@ else echo ""; echo "[gates] 05 渲染闸 → SKIP（--quick）" fi fi -# ══ 文档域（6–8b）══ +# ══ 文档域（6–8c）══ if in_domain docs; then # ── 6. 文档三闸 ── gate "06 gdd_lint" "gdd_lint.log" "$PY" "$REPO/tools/gdd_lint.py" @@ -183,6 +184,8 @@ gate "07 doc_link" "doc_link.log" "$PY" "$REPO/tools/doc_link_audit.py" --strict gate "08 doc_term" "doc_term.log" "$PY" "$REPO/tools/doc_term_audit.py" --strict # ── 6b. 状态文件体量闸（active.md 只记现在：条目数/快照行数/编号/死指针四条硬上限）── gate "08b active.md 体量" "active_state.log" "$PY" "$REPO/tools/audit_active_state.py" +# ── 8c. 流水线闸（06 条目状态机＋roadmap 迭代总表＋一次交叉核，判据=doc-conventions §12）── +gate "08c 流水线闸" "pipeline.log" "$PY" "$REPO/tools/pipeline_gate.py" fi # ── 6c. 回放确定性对拍（条件闸件——迭代 29 T3 收编；属代码域）── if in_domain code; then