gplan-2/待办清单.md

# 待办清单

本清单是流水线的唯一登记处：以后才做的事在此登记一条，随流水线段推进改状态，做完整条删除（条目记进度，不是各段的开工前置）；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。

#### 数值标定窗口总挂账——原九条数值类条目合并（2026-10-28 登记，来源=会话提及）

**实况**：九条数值类挂账合并一条（削弱档位终值／迭代 10 奖励重构联动／调参点评登记／三方向解锁清单与定价／GP 经济换算失衡／天赋树欠账余两件／商店刷新两参数／基线通关率越带杠杆扫描／成长系数节奏），逐条明细与统一执行形态（窗口内一次 MC 批量覆盖全冒险期望＋奖励期望）全载 reports/汇总-数值标定窗口挂账-2026-10-28.md。共同裁定：未设计不启动，重启条件＝用户发令开数值标定窗口。MC 档位硬闸见 sim-data/README.md「MC 采集档位表」。

**缺口**：数值标定窗口未重开（用户发令触发）；窗口设计段逐条裁决写入文档后方可写卡；其中原「基线通关率越带」条另等真人批 k 系数到账。

**改动面**：文档＋游戏代码

**状态**：待文档设计

#### 结算明细文案入表——玩家可见明细文案归属改数据表承载（2026-11-06 登记，来源=批次移交）

**实况**：迭代 53 反哺点 4 归属裁决在案＝文案入数据表行（2026-11-06 用户裁）；规范句已落 [战斗结算](design/gdd/systems/战斗循环/战斗结算.md) v1.8 明细流水节（显示名等玩家可见文案＝数据面字段，代码读表拼行、禁代码写死文案字串）；现行代码硬编码面＝结算明细扩展行标签文案（如减半标签，reward_grant.gd:226 一族）。

**缺口**：还差表结构设计讨论——承载表与字段形态、基础行文案是否同批入表、读表拼行接线面。

**改动面**：文档＋游戏代码

**状态**：待文档设计

#### UI 贴图重构批——元进度件仍是程序化占位（2026-10-13 登记，来源=审计发现）

**实况**：元进度图标目前仍是程序化画出来的占位形态，没有上贴图（原登记见 [美术资产清单](design/art/art-assets-checklist.md)）。规格已定——烛光黄 `#F6C667` 配木色 `#8A5A34`（见 [美术圣经](design/art/art-bible.md) §4.4），素材来源允许走"通用图标改色复用"低成本渠道。营地柜台贴图义务已随营地场景图形态终结（见 [camp](design/gdd/ux/camp.md)）；九宫格切片错位归「UI 氛围层与九宫格切片观感修」条。本条余元进度件贴图终稿，排 Beta。

**缺口**：还差一次「自己画 vs 找 CC0 素材改色」的美术裁决（见 [美术资产清单](design/art/art-assets-checklist.md) §0 的复用渠道闸），裁决后才能定素材工单写卡。

**改动面**：美术素材＋游戏代码

**状态**：待美术设计（备选）

#### UI 氛围层与九宫格切片观感修——光柱硬边与面板切片错位（2026-10-13 登记，来源=审计发现）

**实况**：原两处，一处已修一处存续。①光柱硬边**已修**（`ui_kit.gd` 光柱贴片改带内 alpha 0→0.05→0 三角过渡＋纵向衰减上亮下暗的连续渐变方案）。②九宫格切片错位**存续**——结算屏与图例屏的面板边缘可见错位小方块，成因是九宫格切片参数与素材尺寸不匹配（仪式石框 258 字节小图按 12 像素切片、石板亮面板 314 字节按 16 像素切片，铺到四百多像素宽面板中段拉出错位），须先核素材尺寸能否撑住新切片值（border_stone/panel_stone 均 48×48），可能要重出素材，归「UI 贴图重构批」后续贴图批次。

**缺口**：还差「UI 贴图重构批」里的素材尺寸核对与「是否重出素材」裁决，才能定切片修法。

**改动面**：美术素材＋游戏代码

**状态**：待美术设计

#### 扩展节点类型——危险/精英节点与特殊地形节点（2026-10-21 登记，来源=会话提及）

**实况**：用户定方向：Alpha 版只留现行四类（战斗/奖励/恢复/商店），以下两类留到以后再做——①危险/精英节点（怪物与普通战斗不同、奖励肥）；②特殊地形节点（效果修饰：地图战斗资源、敌我伤害、金币比例等）。内容未设计。

关联文档清单：
- 相关文档 design/gdd/systems/冒险循环/关卡节点图生成.md v1.1（2026-10-21，扩展节点类型位概念）

**缺口**：两类扩展节点的机制形态与数值未设计（用户明示暂不进 Alpha）。

**改动面**：文档

**状态**：待文档设计（备选）

#### 棋盘战斗键盘/手柄输入（2026-10-04 登记，来源=会话提及）

**实况**：战斗棋盘现行唯一输入＝鼠标；键盘/手柄作第二输入前端可做（可行性已核）——分发接缝现成，board_view `action_requested(cell, kind)` 唯一出口，规则引擎合法性校验零改动，Godot InputMap 原生支持与鼠标并存。用户期望形态：十字方向逐格移动、挖掘/封印各一独立键、8 向选定挖掘或封印目标；排期 Beta（立项时按 roadmap 开卡）。

**缺口**：还差 Beta 立项时的输入方案设计讨论——四个连带裁决点先裁再开卡：①键盘模式屏上光标格承载悬停反馈；②键盘与手柄键位映射（暂停层 Esc 快捷通道并入本条）；③弹层焦点导航是否同批；④键位自定义是否进设置面。
- 相关文档：[排雷玩法](design/gdd/systems/排雷循环/排雷玩法.md)（动作语义与 8 向目标规则主责）+ [HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md)（键盘光标与合法性反馈呈现）+ [设置与本地化](design/gdd/systems/表现与支撑/设置与本地化.md)（键位自定义，可选面）

**改动面**：文档

**状态**：待文档设计

#### 个体化变体池（2026-10-18 登记，来源=会话提及）

**实况**：A 型好斗/ B 型守势、精英专属池（技能池共识点 A 的 A2 案）；现行同敌种同池模板，实例分歧只来自摇号涌现。

**缺口**：还差敌人系统的变体池设计讨论——A2 案的池构成方案与精英专属池边界。
- 相关文档：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P1）

**改动面**：文档

**状态**：待文档设计

#### 全局特殊间隔旋钮（2026-10-18 登记，来源=会话提及）

**实况**：异名特殊技背靠背现行概率低（是变化不是失控）；若实测仍嫌，备用闸＝全局「特殊技后至少隔 N 拍」——登记备用，未实测不启用。

**缺口**：还差备用闸的条款设计（N 值与作用域）——仅当实测读数支持时才启动讨论。
- 相关文档：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md) 与[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)（P1）

**改动面**：文档

**状态**：待文档设计（备选）

#### 敌方技能图鉴 / 学习呈现（2026-10-18 登记，来源=会话提及）

**实况**：池与权重不公开（D4/D5）口径下的进阶信息面——玩家侧技能知识系统（见过 → 认得 → 记谱）；首发三池学习成本低，后置（P2）。营地侧入口已落＝场景图布告板命中（codex 占位壳挂起态——占位锁文锚定、零激活禁行）；本条呈现设计义务不变。

**缺口**：还差玩家侧技能知识系统的呈现设计讨论（HUD 承载形态与记谱口径），P2 后置面。
- 相关文档：[HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md) 与[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P2）

**改动面**：文档

**状态**：待文档设计

#### 冒险前资源配比预设（构筑提案）（2026-09-18 登记，来源=会话提及）

**实况**：设计闭合机制＝[元进度](design/gdd/systems/跨局循环/元进度.md)「冒险开始参数面与覆盖值通道」（零新机制）；八项裁决 2026-10-04 全裁，2026-10-05 起挂起，重启须用户另行发令。关联文档：[元进度](design/gdd/systems/跨局循环/元进度.md) v1.0（闭合凭据；现行 v1.25 已复核在役）；立项提案与需求卡片已退役（2026-11-04 用户令删除，八项裁决与全案依据随件入 git 历史可考）。
- 相关文档：[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)修订批（基础配比的权重覆盖语义 + GDD 修订）与[元进度](design/gdd/systems/跨局循环/元进度.md)（解锁容量与注入生产者）共裁；呈现面归[HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md)与[教学引导](design/gdd/systems/表现与支撑/教学引导.md)顺带。

**改动面**：文档

**状态**：文档设计已闭合＋待写卡（备选）〔用户特批 2026-11-04 退役卡片与提案回退待写卡〕〔用户特批 2026-11-05 后置 Beta——Alpha 阶段不排期〕

#### 袋装摇号（格面资源池结构备选——保底型增多后的重构方向）（2026-10-07 登记，来源=会话提及）

**实况**：地图战斗资源池保底结构（四档概率 + 按型保底 + 档位保底上限，现行事实源＝[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)候选集合节）以「摇完整板校验补签」的补丁式实现起步——简单够用。备选正规形态＝**袋装摇号**：装板时按各档配额数好牌再洗开发放，保底天然成立、分布精确；代价＝摇号结构重写 + 偏运硬币/board_skew 两路权重投影须改为袋面投影。启用条件＝保底登记型增多、补签逻辑复杂化时。来源＝地图层讨论，用户裁「先挂在待办清单」。

**缺口**：还差启用条件触发后的摇号结构重写设计讨论（含两路权重投影改袋面投影的方案）。

**改动面**：文档

**状态**：待文档设计（备选）

#### 战斗节点地图类型差异化——更多地图主题（2026-10-13 登记，来源=playnote）

**实况**：来源＝playnote 用户试玩记录「修改地图的奖励类型：战斗节点增加不同的地图类型，比如有些图踩雷受到更多的伤害，有些图标雷可以造成更多的伤害，有些图伤害会减半需要凑更多清图奖励（这些都是暂时的设定）」。**已实装的部分**：首发形态整图变异「贫矿脉」（现行屏蔽状态，Boss 图回落 region 变异）——本条剩余面不变：在此之上再做**更多地图主题**（踩雷伤害更高/标雷伤害更高/伤害减半需凑更多清图奖励）。**排 Beta 版本，Alpha 不做**——已移入 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「六 · Alpha 不含」节。

**缺口**：还差 Beta 立项时的地图主题设计讨论——按本条原始想法重新评估（用户标注「这些都是暂时的设定」，到时需重订而非照抄）。
- 相关文档：[棋盘生成](design/gdd/systems/排雷循环/棋盘生成.md)（board_biome 图主题词表）+ [地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)（图主题差异化插槽）+ [地形变异](design/gdd/systems/排雷循环/地形变异.md)（整图变异承载面）

**改动面**：文档

**状态**：待文档设计

#### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 登记，来源=playnote）

**实况**：来源＝playnote 试玩记录「第二第三关棋盘看着费劲」；用户裁定要做，[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「五 · 表现」已立行标待做。旧卡 reports/需求卡片-二三关棋盘观感批-2026-10-16.md（v1.4）在册但非已写卡状态，重启须重新立卡。分工：本条管棋盘区域整体观感（亮度/对比度/费劲感，体感问题），与已注销的「呈现层残余 <4.5:1 文字位」条（机检硬指标）不同面不互代。Alpha 出口＝用户实机目检不再判「看着费劲」。

**缺口**：还差「素材轴 / UI 轴」定性设计讨论与甲（recolor 现瓦片）／乙（远程生图重产）素材裁点裁决——定性是既有条款的开工前置；素材轴若走重产，依赖战斗一屏样张批目标规格清单（已随 art-bible v3.22 落定）。
- 相关文档：[HUD框架](design/gdd/systems/表现与支撑/HUD框架.md)（UI 轴：舞台底与叠加层）+ [美术圣经](design/art/art-bible.md)（素材轴：瓦片与格面图标的明度色相）——定性前两方共裁

**改动面**：美术素材＋游戏代码

**状态**：待文档设计＋待美术设计

#### 站桩帧动画——Alpha 定版闸前完成（2026-10-06 登记，来源=审计发现）

**实况**：定稿立绘零帧动画；现行动画全部程序化（死亡碎裂/受击闪白/意图徽标弹入＝程序 tween，非帧资产）。用户裁定改排 Beta：Alpha 定版不再以本条为闸，路线三案与前置管线依赖原样留到 Beta 立项再裁（标题「Alpha 定版闸前完成」系登记元数据原文，禁改）。三路线备选：①**拆件驱动**（推荐：定稿立绘切部件〔头/躯干/臂/腿/武器〕+ 节点层级 tween 驱动——零身份漂移、帧数无限、内存小；项目已有先例＝shovel_swing 三帧 + 程序化死亡碎裂）②AI 关键姿势 + 人工修 + 程序补帧 ③全 AI 逐帧（不推荐：身份漂移/像素抖动）。前置依赖＝「立绘→派生形态」管线（原稿像素化后入包、禁再降采样 + 降色 ≤32 + 脚底基线对齐 + 命名合规；显示缩放走 art-bible §8.2 乙类口径＝档高÷源高、NEAREST、允许非整数倍）。

**缺口**：还差 Beta 立项批的路线正式拍板（预选拆件驱动）——拍板后立帧数规格与资产工单。
- 相关文档：[art-bible](design/art/art-bible.md) §8.4 帧数规格 · 战斗表现批

**改动面**：美术素材

**状态**：待美术设计（备选）

#### 主角描边素材侧复核（2026-10-06 登记，来源=会话提及）

**实况**：待决项 B 已按用户拍板走**文档例外条款**（character-design.md §5.1 v1.9：主角四态硬描边＝深褐 `(40,19,13)` 显式例外，浅砖面对比更高；**素材不顺带修改**）。本条仅为复核钩子：样张批（圣经 §1.4）终审时若发现深描边例外不成立（对比优势不实/与敌方同屏割裂感可感），素材侧修订（描边统一暖白族）**须先经本条重启**再开工，禁止直接动图。

**缺口**：还差样张批终审触发的深描边例外复核——复核成立即注销，不成立则重启素材修订设计。
- 相关文档：[character-design](design/art/character-design.md) §5.1 · 样张批

**改动面**：美术素材

**状态**：待美术设计（备选）

#### 教学形态未定（2026-10-04 登记，来源=审计发现）

**实况**：教学的具体形态未定：线性开局教程，还是全部走情景触发式提示？来源＝待设计问题清单第 1 条。2026-10-04 用户拍板本节整体改排 Beta（Alpha 不做教学）；同日五问讨论初裁＝丙1 混合（见本节头注记），定稿归 Beta 批。

**缺口**：还差 Beta 立项后的教学形态定稿讨论（初裁丙1 混合待定稿，见本节头注记）。

**改动面**：文档

**状态**：待文档设计

#### 因果教学顺序（2026-10-04 登记，来源=审计发现）

**实况**：因果教学顺序未定：先教扫雷操作，还是先教读结算明细？两者如何衔接？来源＝待设计问题清单第 2 条。2026-10-04 五问讨论初裁＝**该问题注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容）；教学引导.md 旧前提随 Beta 批文档定稿清除。

**缺口**：还差 Beta 批文档定稿时对初裁结论的写入文档清算（教学引导.md 旧前提清除）。

**改动面**：文档

**状态**：待文档设计

#### 图例面板的条目全集与分组方式（2026-10-04 登记，来源=审计发现）

**实况**：图例面板的条目全集与分组方式待定。来源＝待设计问题清单第 3 条。2026-10-04 五问讨论初裁＝图例面板按循环段落分组、无结算段（见本节头注记）；图例面板与帮助手册的内容分工属未裁三疑点之一（Beta 立项时先裁）。

**缺口**：还差 Beta 立项后的图例面板定稿讨论（分组初裁待定稿＋与帮助手册内容分工裁决）。

**改动面**：文档

**状态**：待文档设计

#### 教学文案定稿权与本地化流程的分工（2026-10-04 登记，来源=审计发现）

**实况**：教学文案的定稿权归属，以及与本地化流程的分工——两边共担，裁决时须对齐（设置与本地化原登记「文案定稿权与翻译流程的分工」；教学引导「待设计问题清单」第 4 条同事项，合并于此）。来源＝待设计问题清单 + 设置与本地化原登记。2026-10-04 五问讨论初裁＝教学文案内容权归设置与本地化，两文档负责表对齐随 Beta 批（见本节头注记）。

**缺口**：还差 Beta 批的两文档负责表对齐定稿。
- 相关文档：教学引导与[设置与本地化](design/gdd/systems/表现与支撑/设置与本地化.md)共裁

**改动面**：文档

**状态**：待文档设计

#### "再教一次"入口与图例面板兼任手册（2026-10-04 登记，来源=审计发现）

**实况**：是否提供"再教一次"的入口（图例面板是否兼任手册）待定。来源＝待设计问题清单第 5 条。2026-10-04 五问讨论初裁＝不做「再教一次」，改走独立「帮助」手册面（全部内容放一个文档；见本节头注记）；帮助入口位置属未裁三疑点之一（设置面为推荐，Beta 立项时先裁）。

**缺口**：还差 Beta 立项后的帮助手册面定稿讨论（初裁待定稿＋帮助入口位置裁决）。

**改动面**：文档

**状态**：待文档设计

### 生涯（跨局汇总与历史回看承接面）

#### 「生涯」界面——冒险中数据回看的唯一承接处（2026-10-04 登记，来源=会话提及）

**实况**：用户裁决（UI 落码计划 P-C7）——冒险中不给数据回看，历史战报/结算明细查看去向＝新「生涯」界面；settlement_review_overlay 与「明细回看」钮在冒险中退役，战报带只留单行「上轮」。设计提纲已成文并全裁：[systems/跨局循环/生涯.md](design/gdd/systems/跨局循环/生涯.md) v0.1（P0–P5 六裁点已写入文档）。期一已落地（六类九项＋主菜单入口＋终身计数域存档 v6）。遗留件：settlement_review_overlay.gd 未接线全仓零引用，处置两途＝①随期二按 P5 甲复活承接／②确认不需要则退役删除，归生涯实装批/用户裁。

**缺口**：还差提纲用户评审收尾与 P6 营地最近冒险条带去留裁决——裁完才能立期二/期三实装卡（期一已交付）；本条排 Beta，Alpha 只保留期一。

**改动面**：文档

**状态**：待文档设计（备选）

### 文档与结构

#### 效果通道与事件词的零现役普查（2026-11-05 登记，来源=审计发现）

**实况**：普查报告 reports/普查-效果通道与事件词零现役-2026-11-06.md——结论＝内容层零孤儿、四词表＋秘宝表 schema 旧词层全部属预留埋点（词面全保留零清退项；架构原则＝词表先行内容后接）。叙述脱节 5 处已按「预留、未设计入表」口径订正（2026-11-06 用户令直改，冒烟 15 项 0 失败三闸全过）。唯一遗留待裁＝秘宝表 schema 旧词面 9 个「迁移完成」收尾（做不做、何时做），待用户裁。

**改动面**：游戏代码

**状态**：待执行

#### 测试面真输入化分期与存量断言逐条精锚（2026-11-05 登记，来源=批次移交）

**实况**：证据＝test-conventions §8.3「判据出处行锚」「真实入口判定口径」两条文＋§2「UI 驱动断言须走真输入管线」条文（批1补，qa-harness 分支 2cbd2ca9）；链式锚机检已在闸（capability_audit 链断 0，80 套件全承接）。已承接＝两探针 52 处 emit 站点（51 转真输入管线＋1 置灰穿透标〔接线断言〕）。剩余面＝①视图层测试方法面（press_candidate／press_continue／press_card／press_confirm／press_refresh_for_probe 等探针消费口，非 emit 站点）②存量 996 条断言的判据出处逐条精锚（链式锚已保可核，精锚提升出处粒度）。

**改动面**：游戏代码

**状态**：待执行

#### QA harness 三批缺陷与覆盖遗漏收口（2026-11-06 登记，来源=批次移交，优先级=P0）

**实况**：证据＝reports/QA-harness三批-缺陷与覆盖遗漏报告-2026-11-06.md（八类逐条带文件行号与登记处指针：产品缺陷 2＝A1 开局被开始层盖住/A2 终局关闭路径引擎报错噪声；测试覆盖遗漏 6＝B1 停手钮零真输入/B2 视图方法面/B3 精锚/B4 本体缺口 212 条/B5 控件零命中缺口/B6 判据收紧轮）；来源批次＝合并 d3c85390（三批读数在案）。处置分流：A1 随营地交互修复批合回即消；A2/B1/B2 走需求性工程写卡通道；B3/B6 归衔接条目与复核轮；B4/B5 人工复核后分流（真缺口立事项/假缺口豁免清单核销）。

**改动面**：游戏代码

**状态**：待写卡

#### 闸机超时守卫缺陷修复——gate_run_timeout 标志文件恒真（2026-11-06 登记，来源=批次移交）

**实况**：tools/gate_platform.sh 的 gate_run_timeout 用 mktemp 预建超时标志文件，判据 `[ -f ]` 建时即真、超时态无法与正常完成区分（Windows Git Bash 实测直接调用 4 秒返回 124；远端各闸以工件锚定未受影响）。连带 tools/golden_baseline_refresh.sh 的 guard 子Shell sleep 420 未被 kill 短路（重采集等待 7 分钟症状）。修法＝kf 先赋路径＋rm -f 后置守卫（probe_gate.sh:97 run_suite 同款正确写法）。证据＝tools/gate_platform.sh:37/:48＋迭代53实现报告遗留呈报 1（git 历史可考）。

**改动面**：工具代码

**状态**：待执行

#### 关卡视口两 Shot 基线 mac 侧冻结（2026-11-06 登记，来源=批次移交）

**实况**：golden/windows/ 已锚 lmap_entry/lmap_boss（提交 6394abf7）；mac 子目录无该两 Shot——渲染闸对 mac 缺基线记 SKIP 不判红，两平台同盯缺一。义务＝Mac 侧跑 tools/golden_baseline_refresh.sh --lmap 冻结 mac 基线并呈报确定性读数。证据＝game/tests/golden/README.md 现持清单行与时效判定纪律行＋迭代53实现报告遗留 2（git 历史可考）。

**改动面**：游戏代码

**状态**：待执行

#### 美术圣经去数值化——定值改由机检件与数据表承载（2026-11-06 登记，来源=会话提及）

**实况**：本条立文档分层规矩——美术圣经与 GDD 同级属 Meta 层，只写概念与方向（可写「两者存在相对亮度关系」），不写具体数值约束；阈值与准入判定归执行件，执行件登记面＝[art-pipeline-tools](design/art/art-pipeline-tools.md)（三关色板互辨抽测件本批已入册）。
- 相关文档：纪律出处＝[doc-conventions §5 禁实现内容行](design/engineering/doc-conventions.md)；同款先例＝[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md) 二节「面值一律不在此抄录，以数据表为准」

**缺口**：还差一次清点与归属设计讨论——圣经全部定值逐条定落点（机检件／代码常量／数据表／golden 基线）、定文档侧指针句式、核下游反向引用面（ux 文档、需求卡片、探针注引圣经定值之处）。

**改动面**：文档＋工具代码

**状态**：待文档设计