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] =?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` 开工） +**状态**：待文档设计＋待美术设计