From f1e47e643621c36f90138139a146aeac51a06cdb Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 18 Oct 2026 07:26:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(06):=20=E4=B9=9D=E6=9D=A1=E5=AD=98?= =?UTF-8?q?=E7=96=91=E8=A3=81=E5=86=B3=E8=90=BD=E6=96=87=E4=BB=B6=E2=80=94?= =?UTF-8?q?=E2=80=94=E5=88=A0=E8=BF=AD=E4=BB=A3=2030=20=E5=89=94=E9=99=A4?= =?UTF-8?q?=E7=99=BB=E8=AE=B0=E6=9D=A1=EF=BC=88=E4=B8=89=E4=BB=BD=E9=87=8D?= =?UTF-8?q?=E5=A4=8D=E5=89=94=E4=B8=80=E9=83=A8=EF=BC=89=EF=BC=8B=E5=88=A0?= =?UTF-8?q?=E5=A5=87=E7=89=A9=E5=91=88=E7=8E=B0=E5=A4=87=E5=BF=98=E4=B8=A4?= =?UTF-8?q?=E5=AD=A4=E5=84=BF=E7=82=B9=EF=BC=88=E4=B8=A4=E7=82=B9=E5=9D=87?= =?UTF-8?q?=E5=B7=B2=E8=A2=AB=E6=AD=A3=E5=BC=8F=E6=9D=A1=E7=9B=AE=E6=89=BF?= =?UTF-8?q?=E6=8E=A5=EF=BC=8C=E6=8C=87=E8=AE=A4=E5=8F=A5=E4=B8=A4=E5=A4=84?= =?UTF-8?q?=E6=B8=85=E5=81=BF=EF=BC=89=EF=BC=9B=E5=85=B6=E4=BD=99=E4=B8=83?= =?UTF-8?q?=E6=9D=A1=E7=BB=B4=E6=8C=81=E7=8E=B0=E8=A1=8C=E5=88=A4=E6=B3=95?= =?UTF-8?q?=EF=BC=882026-10-18=20=E7=94=A8=E6=88=B7=E9=80=90=E6=9D=A1?= =?UTF-8?q?=E8=A3=81=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/06-待办清单.md | 36 ++---------------------------------- 1 file changed, 2 insertions(+), 34 deletions(-) diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index f7d1f2a4..53be8f54 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -99,7 +99,7 @@ **量化要求补登（2026-10-16 playnote 用户补写）**：「需要统计一下第 123 关 path 的路径长度，路径长度需要递增，并且后续关卡的节点数增幅应该更大」（第 123 关＝第 1/2/3 关）——重构设计讨论的验收方向两条：先实测三关路径长度基线，再定递增曲线与后续关增幅尺度。 -**前置（用户 2026-10-13 裁）**：**须先做文档设计讨论，不可直接开发**——方案与参考调研先行、过人闸后才可开卡。与「奇物呈现优化探讨备忘两孤儿点」(f) 同源，两处互相指认，不重复立项。版本标准侧已登记为 Alpha 待做项，见 [08-Alpha版本标准](08-Alpha版本标准.md)「一 · 系统 · 冒险循环」。 +**前置（用户 2026-10-13 裁）**：**须先做文档设计讨论，不可直接开发**——参考调研＋重构方案先行、过人闸后才可开卡。版本标准侧已登记为 Alpha 待做项，见 [08-Alpha版本标准](08-Alpha版本标准.md)「一 · 系统 · 冒险循环」。 **缺口**：还差参考调研＋重构方案的设计讨论（含路径长度基线实测与递增曲线两条验收方向），过人闸后才能开卡。 @@ -313,7 +313,7 @@ #### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 登记，来源=playnote，设计面=双轨） -**现状**：来源＝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 文字位」分工：本条管**棋盘区域整体的观感**（亮度/对比度/费劲感，体感问题），彼条管**具体文字位的对比度读数**（机检可判硬指标），两条不同面不互相替代。 +**现状**：来源＝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 轴」定性设计讨论与甲/乙素材裁点裁决；素材轴若走重产，还依赖战斗一屏样张批的目标规格清单产出。 @@ -505,20 +505,6 @@ **状态**：待文档设计＋待美术设计 ---- - -#### 奇物呈现优化探讨备忘两孤儿点 — 低置信防遗忘（2026-10-09 登记，来源=会话提及，设计面=文档轨） - -**现状**：迭代 18 卡②（呈现优化六件）2026-10-07 经用户令整体撤回探讨阶段，六件中四件已登记或删除，唯两点全仓仅 active.md 381 号条目有载，迁本条防遗忘：(e) L2/L3 棋盘观感开工前先定性素材轴 vs UI 轴——**已由「第二 / 三关棋盘观感」条承接为正式待办**；(f) 关卡节点图展示改版先出参考调研+方案人闸——**与「关卡节点图重构」条同源，两处互相指认**。两点现均有正式条目承接，本条仅存防遗忘与互相指认义务，不构成排期承诺；呈现优化批若重启再议。 - -**缺口**：本条无独立设计缺口——(e)(f) 两点分别随「第二 / 三关棋盘观感」「关卡节点图重构」两条件的设计讨论推进；两条件处置完毕后本条随之注销。 - -**归属**：探讨备忘（奇物呈现） - -**状态**：待文档设计（备选） - ---- - #### 技术债观察登记——长函数余量与 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——实读无泄漏，登记防回归）。长函数拆分无独立需求驱动不动；lambda 连接数若有审计工具化需求归类型闸后续。 @@ -527,8 +513,6 @@ **状态**：待写卡（备选） ---- - #### 测试域遗留（2026-10-16 登记，来源=批次移交，设计面=工程直入） **现状**：迭代 29 把验收语义从「跑一遍没崩＝通过」扭到「三层完备＋判定可靠」，三硬闸（退出码／脚本错误扫描／断言数下限）已落地，L2/L3 从零建起承载。本批未收的余量集中登记在此，均不阻塞、不排期： @@ -547,20 +531,6 @@ **状态**：待写卡（备选） ---- - -#### 迭代 30 剔除卡②③——战斗一屏样张与第二/三关棋盘观感回待设计（2026-10-17 登记，来源=会话提及，设计面=双轨） - -**现状**：两卡原编入迭代 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），作后续设计讨论的输入素材——**非已写卡状态，重启不得直接开工**。两事项的正式待办分见上方「战斗一屏样张」「第二 / 三关棋盘观感」两条件，本条为剔除事件登记，随两条件处置后注销。 - -**缺口**：还差两卡各自的设计定稿——卡②走「设计讨论→需求澄清→美术定稿」；卡③走「素材轴/UI 轴」定性＋甲/乙素材裁点裁决；均定稿后重新立卡方可开发。 - -**归属**：设计讨论批（不阻塞，不排期；设计权威产出归 GDD/美术文档，走设计流程非迭代实现） - -**状态**：待文档设计＋待美术设计 - ---- - #### 营地交互重做·五张需求卡片（2026-10-18 登记，来源=会话提及，设计面=文档轨） **现状**：2026-10-17~18 需求讨论澄清会话产出结论文档 `design/research/需求澄清-营地交互重做-2026-10-18.md` v1.0（目标体验原话／目标结构树＋纵深稿／10 条交互裁决／验收口径／切批原则／遗留待裁），用户令按工作内容维度拆卡、卡片不预占迭代号。五卡已写（顺序＝执行顺序，估时附后）：①存档制数据层改造批（隐式单档→3 存档位，≈4.5–5.5d）②主菜单三入口化批（6 钮→3 钮，≈2.5–4d）③选档界面新建批（≈4.5–5.5d）④营地场景图新建批（最大件，≈9–12d）⑤Esc 浮窗与营地顶栏批（≈3–4.5d）。三道复核：grilling 子 Agent 对抗审查（五卡各一）→v1.1；用户裁定「事项按推荐的来」→v1.2；用户两次订正（**卡④留在批内不踢出**；前置由谁解决／何时解决由用户定，美术／设计线＝用户自立批〔铁律 2〕，Agent 不代跑不代产——曾越权起草的点选反馈设计稿 v0.1 已撤回删除）→卡④ v2.2。①②③⑤ 零待裁点可编工程波次：②③ 硬耦合同波（「进入存档」钮落点＝选档界面），① 是 ③ 前置；⑤ 随 ④ 代码波同行。 @@ -571,8 +541,6 @@ **状态**：文档设计已闭合（design/research/需求澄清-营地交互重做-2026-10-18.md v1.0）＋待美术设计＋已写卡（design/research/需求卡片-存档制数据层改造批-2026-10-18.md）＋已写卡（design/research/需求卡片-主菜单三入口化批-2026-10-18.md）＋已写卡（design/research/需求卡片-选档界面新建批-2026-10-18.md）＋已写卡（design/research/需求卡片-营地场景图新建批-2026-10-18.md）＋已写卡（design/research/需求卡片-ESC浮窗与营地顶栏批-2026-10-18.md） ---- - #### 代码术语刷新批——禁用词全库清扫＋flag→seal 标识符重命名（2026-10-18 登记，来源=会话提及，设计面=工程直入） **现状**：2026-10-18 用户裁定三组术语刷新（记忆 `project-terminology-rulings-20261018.md`）：①GP 是唯一正式命名，「金币」系 AI 噪音全库禁用；②「插旗」全库禁用，正式动作名=封印，「旗」概念不存在；③代码英文标识符 flag_* 全换 seal_*。另「雷格」「惩罚格」2026-10-11 已裁退役→危险格，代码域尚未执行。审计报告（`design/qa/代码术语审计报告-2026-10-18.md`）实查：game/ 目录命中约 757 处（flag_ 标识符 314 处/29 个 .gd＋4 个 .tres；中文禁用词 金币 116 处/插旗 210 处/雷格 109 处），涉及核心逻辑（minesweeper_rules.gd、battle_orchestrator.gd、grant_segment.gd）、数据表（feats.tres、settlement.tres、action_economy.tres、reward.tres）、呈现层（board_view.gd、shop_overlay_view.gd、legend_overlay.gd）与冒烟测试（smoke_all.gd 单文件 105 处 flag_）。文档面（design/）由另批处理，本条只覆盖 game/ 代码域。