Merge branch 'master' into assert-pin-sweep-20261028

This commit is contained in:
DKChan committed 2026-10-28 06:48:47 +08:00
commit ed5f19414e
6 files changed
+129 -122

No files matched your search

+1 -1
View File
@@ -12,7 +12,7 @@
### 1.1 禁止上帝对象
一个类只承载一个职责。场景主脚本(main)= **组合根**:模式流转、信号接线、核心写调用的唯一出口;渲染、文案拼装、状态装配一律拆分为独立视图/装配器类。单文件超过 ~400 行即触发审视。
拆分判据(硬纪律):重构类需求卡片必须写明——禁止为迎合机检消息文本(含计数)而保留或新增无效成员/别名;机检键与卡片契约互斥时,实现段一律停卡呈报,不得自造第三条路。
拆分判据(硬纪律):拆分/收敛/重构类需求卡片与实现段一律写明并遵守——①拆分边界沿职责轴、不沿阈值轴:每个拆出单元(私有函数族/新件/段件/状态件/参数束)须有可陈述的职责语句与单一变化原因;②拆出单元须有集体身份:成员共同表达一个可命名的领域概念,命不出名字、只能说「剩下的成员」的打包=凑计数袋,禁;③「过阈值」只许作为发现信号,作为拆分或收拢的动机即违规;④按上述纪律拆不出内聚单元 → 停卡呈报走豁免/还债通道,禁硬拆凑绿;⑤禁止为迎合机检消息文本(含计数)而保留或新增无效成员/别名;机检键与卡片契约互斥时,实现段一律停卡呈报,不得自造第三条路。①–④=拆分边界纪律(2026-10-28 用户裁:任何拆分满足领域驱动设计〔DDD〕的职责切分与类的高内聚)。
### 1.2 一切功能以类封装,禁止裸函数堆
设计稿与实现同尺度:功能 = 类(状态 + 行为 + 信号),类是封装的最小交付单位。工具性纯函数只允许挂在明确的宿主类下(静态装配器/工厂),不允许无主散落。
+4 -4
View File
@@ -2,7 +2,7 @@
> **一句话定位**:本文定义这个项目的 **Alpha 版本包含哪些东西**——它是里程碑 M3 的完成标准,也是判断"还差什么"的对照表。
> **本文只列条目,不写内容**:每样东西是什么、规则怎么走,一律归各自的权威文档,本文只给指路链接。想知道某样东西的定义,请点链接,不要在本文里找解释。
> **状态**:**已定稿(v1.17)**——2026-10-13 用户令定稿,历次升版明细见 git 提交史。Alpha 的内容范围自此冻结:增删条目一律须经用户裁决。
> **状态**:**已定稿(v1.18)**——2026-10-13 用户令定稿,历次升版明细见 git 提交史。Alpha 的内容范围自此冻结:增删条目一律须经用户裁决。
> **成文**:2026-10-13。
## 本文怎么用
@@ -46,9 +46,9 @@ Alpha 内以玩法循环本身的内容与表现为主(棋盘、关卡、战
| 条目 | 事实源 | 现状 |
|---|---|---|
| 冒险结构 | [冒险结构](systems/冒险循环/冒险结构.md) | 在役 |
| 关卡节点地图 | [关卡节点地图](systems/冒险循环/关卡节点地图.md) | 在役(待重构,见下一条;信息迷雾类型可见性已随迭代 34 卡④ 实装,2026-10-22) |
| 关卡节点图重构(增加可选节点) | [关卡节点地图](systems/冒险循环/关卡节点地图.md)+[关卡节点图生成](systems/冒险循环/关卡节点图生成.md) | 待做(文档设计已闭合;四张需求卡片已写——卡③敌人表深度带换代、卡④信息迷雾可见性已随迭代 34 合回(2026-10-22),卡①生成器核心、卡②消费侧换代已编迭代 35、待开工;出口判据见两份文档的验收标准,另加旧模板清理与真人目检选路有取舍) |
| 关卡节点图生成 | [关卡节点图生成](systems/冒险循环/关卡节点图生成.md)(参数化长图:产出规格与生成参数) | 待做(规格 v1.1 已定稿;生成器核心批已写卡、已编迭代 35,待开工) |
| 关卡节点地图 | [关卡节点地图](systems/冒险循环/关卡节点地图.md) | 在役(信息迷雾类型可见性已随迭代 34 卡④ 实装,2026-10-22) |
| 关卡节点图重构(增加可选节点) | [关卡节点地图](systems/冒险循环/关卡节点地图.md)+[关卡节点图生成](systems/冒险循环/关卡节点图生成.md) | 在役(2026-10-25 迭代 35 卡①② 合回:图源切为参数档×种子生成图、模板链路退役;真人目检选路项已登记体验验证清单,登记不阻塞) |
| 关卡节点图生成 | [关卡节点图生成](systems/冒险循环/关卡节点图生成.md)(参数化长图:产出规格与生成参数) | 在役(2026-10-24 迭代 35 卡① 生成器核心合回;enemy.tres 与 board_gen.tres 已覆盖到第三关深度 13) |
| 难度曲线与 Boss | [难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md) | 在役 |
| 奇物 | [奇物](systems/冒险循环/奇物.md) | 在役 |
@@ -0,0 +1,86 @@
# 数值标定窗口挂账汇总
> **性质**:中间文档(过程件,吸收即死)——九条数值类待办的统一挂账清单,也是未来数值标定窗口的开工底稿。窗口批把各条内容全部落进需求卡片与 owner 文档后,本件随之退役。
> **接收方**:待办清单「数值标定窗口总挂账——原九条数值类条目合并」条目(2026-10-28 登记)。
> **背景**:M4 数值批卡已随 2026-10-16 删卡令退役;2026-10-18 用户裁=各条留待办清单、未设计未启动、不另行归属,未来数值标定窗口重开时重走设计段再写卡。2026-10-28 用户令九条合并为待办清单一条,全部内容迁入本件(原条目删除,git 历史可考)。
> **执行约束**:MC/模拟档位硬闸见 sim-data/README「MC 采集档位表」——一档只能由用户发起;无数值改动零跑。窗口开工=用户发令。
## 统一执行形态(建议序,窗口开工时逐条裁决后可调整)
1. 设计段:按 §1–§9 逐条过裁决,结论落各 owner 文档(调参表取值域与规则句)。有交叉的条目同场共裁:§2② 与 §8 同属通关率带,§5 与 §7 同属 GP/商店经济。
2. 写卡段:按域拆卡(战斗结算类/经济类/元进度类),零待裁点后编迭代。
3. 实现批:表值进 game/data/tables/*.tres,与 schema 校验域、GDD 表格正文、待办清单现状三处同步(doc-conventions §5 双写同步禁令)。
4. 测量批:一次 MC 批量覆盖全部对比需求——全冒险期望(res://sim/adventure_monte_carlo.gd)+奖励期望(res://sim/reward_expectation.gd)+对拍锚按新行为重锚(tools/parity_anchor.py freeze/check);§8 另需真人批 k 系数到账后才定正式扫描。
---
## §1 削弱档位的最终数值(原条目 2026-09-18 登记,来源=会话提及)
**挂账内容**:削弱取值域 [60,85] 与投值 −65 来自旧体系裁决;「封印标中必须比随便挖一格更值」的当量终值由 design/gdd/systems/战斗循环/战斗结算.md 与 design/gdd/systems/战斗循环/地图战斗资源.md 共裁。**语义侧已定案**(2026-09-18 盘问会话,结构修复批落地):削弱叠层改续时——同名重复授予只刷新剩余结算数、层数恒 1(结构性消饱和);现行表值为临时值(provisional)。
**已入已废 M4 卡的方案底稿**(卡 git 版本可考):duration 终值投定+当量锚复算落文;含 β 带 [1.2,2.5] 可行子区间推算、flag_hit_premium=125 纳入同窗检算、tools/clear_dominance_audit.py 的 WEAKEN_PCT 常量随投值同步。2026-10-05 裁点已全裁并经同日联审二裁修订(P1甲/P2甲/P3甲/P4甲),跑批待 U0 用户发令、发起前须用户批准。
## §2 迭代 10 奖励重构联动欠账(原条目 2026-10-01 登记,来源=批次移交)
奖励重构批落地面产生三条后续义务:
1. **钥石产出重标**:渠道改「Boss/精英击杀掉落」(大奖励 keystone_per_level 退役、boss_keystone 重锚 provisional),现行元进度产出结构作废,标定义务重开。
2. **通关率带重扫**:通关回血 20%(血回满→部分回血,难度上压方向)+三选一件值/权重/次数上限 knob(AP 件=每场战斗首轮 +1 AP 强度敏感轴)。
3. **同调位读数源切换**——已清偿(2026-10-03 迭代 11 第①批 T7:过渡键表/schema/断言三处退役,读取点归零,现行事实源=Attunement.slots 谓词表实时求值)。
①②已入已废 M4 卡件③(F7/F8;通关率带重扫与 T6 四带复算并账、一次跑批双认账)。跑批待 U0 用户发令、发起前须用户批准。
## §3 调参批数值点评登记(原条目 2026-10-01 登记,来源=批次移交)
格面资源八型批后顺带登记的数值点评六条:
1. 增伤型奖励/惩罚幅度 50/25 不对称是否有意;
2. 削弱型 65/25 同问(且 percent 套个位数取整偏粗);
3. 回血奖励过薄(值 1、权重全池最低 2);
4. 警觉/行动点修正两新词数值全部 provisional;
5. 行动经济「满停一轮=一刷」节拍在 AP±1 修正下的对账——①-⑤已入已废 M4 卡件②(F5,逐条裁决落文);
6. **格面资源正负兑付倍率差回调**(2026-10-07 用户裁)——2026-10-01「踩雷必须痛」抬档(heal +2/−6、pierce/magic +2/−8 等,负向 3-4 倍于正向)系错误的加难杠杆:难度提升应走怪物性能路线而非抬地图惩罚;标错/开雷同档同罚维持不动(同批裁)。
里程碑立规(2026-10-09):M4=Beta 阶段、M3 未由用户明令关闭前不排期。
## §4 三方向各自的解锁清单与定价(原条目 2026-09-21 登记,来源=审计发现)
**挂账内容**:三方向(属性、遭遇、道具池)各自的解锁清单与定价——多少钥石换什么,各自怎么铺。部分完成:三柜台结构与 provisional 定价已落地(属性锻造三档血+3/攻+1/甲+1、Boss 两档、工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 game/data/tables/meta.tres);换算率三行已投值 6/9/1(冒险条件口径实测,护甲行强条目重测履行)。
**剩余面**:定价数字与 Boss 两档终值——已入已废 M4 卡件④(F11/F12;含两句死文本全刷义务:「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〕,判据按两句全刷执行)。
## §5 GP 经济换算失衡(原条目 2026-10-07 登记,来源=审计发现)
**发现**:小 GP 袋 20 ≈ 商店两三次首购(首购基价 4-5、A 链爬升前)≈ +2~4 点属性,而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算,且 GP 袋是池内最大户(23/98 张)进一步放大倾向。用户判「太离谱」。
**复查范围**=GP 袋面值(20/50)× 商店基价(4/4/4/5)× 价格曲线(A=1.8 / b=1.1)× 战斗 GP 掉落(普通 3 / 精英 5 / Boss 8,关级加值 0/1/2)四处联动;目标=钱与属性件的换算效率回到设计意图(拿钱 vs 拿数值的取舍成立;GP 袋最大户地位要么有理由要么让位)。
**连带前提**:L1 无商店节点使 GP 在第一关无消费口——「L1 商店编排」不另立条目、归本条复查范围(按 L1 是否补商店分两种情形各算一遍)。
## §6 天赋树实装批登记欠账余两件(原条目 2026-10-12 登记,来源=批次移交)
1. **AP 上限 clamp 缺位(缺陷)**——树「开局姿态」(每关首轮 AP+1)、AP 件、时沙同走 action_economy.gd `:239 _pending_ap_delta` 排队,轮始兑现仅下限钳制(`:254 maxi(0, …)`,无上限);**用户裁暂不设上限**——provisional 天花板亦不投,随窗口连同全部 AP 数值统一标定。
2. **三选一刷新软上限(设计问)**——停点内 GP 付费刷新倍率增长(×1.8/次曲线)×停点间基础价随进度递增,全程无软上限;**定性确认=设计问非缺陷,用户裁维持现状**,归窗口处理,不提前单开讨论。
3. (已结案存档)**Y(_attune_refresh_y)不入断点存档(可利用漏洞)**——2026-10-13 用户令提前单独开修完毕(断点快照扩列 `attune_refresh_y`+续玩 `resume_adventure` 优先读断点〔缺键回退参数面=旧档行为零变化〕+单测两断言;冒烟 938/0+单测 24 套全绿)。
相关文档:① design/gdd/systems/排雷循环/行动经济.md;② 行动经济+三选一/商店刷新经济;③ design/gdd/systems/表现与支撑/存档序列化.md(断点域)+ design/gdd/systems/冒险循环/冒险结构.md(续玩参数面)。
## §7 商店独立刷新机制——两参数待调参+机制文档回写(原条目 2026-10-04 登记,来源=会话提及)
**机制已落码部分**:2026-10-04 用户裁决(P-C2+Q2 二次裁)推翻关卡节点地图 v1.5「无独立刷新、重抽绑购买」口径,定案=基础免费 0 次+GP 刷新(ceil(20×1.8^已付费刷) provisional)+池源同源(共享池,与三选一同一账本);SR-1 随 UI 落码批收官(2026-10-04/05)。三选一同款付费刷新已落码(2026-10-06 用户令「三选一对齐商店,得有刷新」:免费双源〔刷新件 X/冒险池 Y〕用尽后 GP 付费刷新,同旋钮同曲线同钱包;机制登记归 design/gdd/systems/跨局循环/秘宝.md「三选一刷新双源」节)。
**剩余面**:① 调参——shop_refresh_free 与曲线两参数 provisional,归窗口;② 天赋增益形态与数值(设计未定;天赋/营地侧「刷新次数」增益=用户既有意向〔口头裁决,曾因未写入文档丢失——Q2 追认〕,后续由用户调整添加,实现面预留 free_count=天赋增益位)——设计+数值混合,窗口设计段一并裁;③ 机制文档回写核对(冒险结构共享池账本节/关卡节点地图商店行 v1.6 已记,完成时核对三处同步)。
## §8 基线通关率越带,加难杠杆扫描未执行(原条目 2026-09-18 登记,来源=审计发现)
**现状**:目标带两度换代(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% 挂账废止,归 design/gdd/systems/冒险循环/难度曲线与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。
相关文档:design/gdd/systems/冒险循环/难度曲线与Boss.md 调参批;扫描执行与 design/gdd/systems/排雷循环/棋盘生成.md 工具交付联动。
## §9 成长系数与关卡怪物难度提升的节奏(原条目 2026-10-16 登记,来源=playnote)
**来源**=playnote 用户反馈「一开始不能让角色的成长系数太高。比如在没经过升级之前,你的成长系数是跟不上关卡怪物难度提升的;但是后续能力解锁之后,成长系数才能匹配得上」。语义两读(甲=节奏缺陷呈报/乙=设计哲学陈述)已随 2026-10-16 用户定性消解:**数值校准类**,无论现行节奏好坏,调它都是数值校准面的事。不进 design/gdd/08-Alpha版本标准.md(数值调优义务 2026-10-16 v1.6 起不入版本标准);按里程碑立规属 **Beta 阶段**面,Alpha 不排期;2026-10-18 用户裁=不另行归属。
相关文档:design/gdd/systems/冒险循环/难度曲线与Boss.md + design/gdd/systems/跨局循环/元进度.md(成长系数语义面)。
@@ -1,6 +1,6 @@
# 需求卡片:呈现层结构收敛批(gdstyle 存量债清偿·波 6+波 8 呈现侧——视图内部拆私有函数+工厂/参数面收敛+类变量全清)
- 版本:**v1.1**(v1.0 自审六查+grilling 一轮记录见 §12;v1.1 = 2026-10-27 用户裁决四条款折入——全清口径取代残留申报+print 删除落死+main/await 两键架构豁免,自审与 grilling 二轮记录同 §12 末段)
- 版本:**v1.2**(v1.1 = 2026-10-27 用户裁决四条款折入——全清口径取代残留申报+print 删除落死+main/await 两键架构豁免;v1.2 = 2026-10-28 用户裁「拆分边界纪律(DDD/高内聚)」落卡——新增契约 9+u1 子域拆件改法+状态件职责语句义务+审计⑨+L3 增款+读数锚重锚〔基线 216→168、恶化 2→1,随波 0 刷新 d219dd3d 与迭代 40 归绿〕;自审与 grilling 记录见 §12)
- 来源:[待办清单](../待办清单.md)「gdstyle 存量债全量清偿——216 键按病根分波整改」条目(2026-10-26 登记,P0,状态=文档设计已闭合+待写卡)——**需求性工程条目,证据指认形态**(唯一事实源:[审计-gdstyle存量债清点与清偿方案-2026-10-26.md](审计-gdstyle存量债清点与清偿方案-2026-10-26.md) §六第 3 条〔波 6 视图内部拆私有函数、不拆构建步件〕+第 7 条〔归并裁定:本卡=波 6(54 键/17 文件)+波 8 呈现侧 8 文件(17 键)=71 键〕);设计段裁定=纯代码内部收敛、**零设计改动**
- 归属:`game/presentation/` 25 文件(波 6 十七件+波 8 呈现侧八件)+消费面随动改址(§7 结构图注记;v1.1 增 board_view 写入行随动,见 §0);treasure_interact_controller 已移卡 1(B1 战斗域拆件批),不在本卡
- 排期:未编入(迭代批卡片;估时 ≈5.0–5.5 个工作日,估 ≈5.3d)
@@ -21,10 +21,10 @@
| # | 单元(文件) | 现行键(值/阈值) | 改法 |
|---|---|---|---|
| u1 | camp_overlay_view.gd | 类变量 19/15;循环内 new×7;_init 149 行 28 局部(:42);_rebuild_tree 61 行 21 局部(:222);_rebuild_forge 72 行 20 局部(:301);refresh_camp 61 行 17 局部(:386) | _init 拆四柜台构建私有族;_rebuild_*/refresh_camp 拆行板构建私有族;循环体提行板构建私有函数;**类变量收拢(v1.1)**:探针冻结 5 成员(S17)保持宿主,其余 14 个(_tree_holder/_forge_lock_l/_forge_workbench/_forge_zone_weapon/_forge_zone_armor/_forge_rows/_ws_scroll/_ws_lock_l/_attune_header_l/_attune_btns/_attune_nodes/_refresh_l/_refresh_btn/_recent_list)收进内部状态件 → 宿主 6 |
| u2 | level_map_screen.gd | **类变量 22/15(基线登记 21——iter38 恶化债 c4c69701,本卡归绿义务)**;_init 135 行 21 局部(:58);_draw_graph 78 行 9 分支 27 局部(:423) | _init 拆构建私有族;_draw_graph 拆绘制私有族(节点/通道/底栏);**类变量收拢(v1.1)**:探针冻结 6 成员(S17:_cand_ids/_hover_id/_content_size/_layout_cache/abandon_btn/status_badge)保持宿主,其余 16 个收进内部状态件(_node_icons/_noise_rect/_tint_level 三件在状态件内持 `_layer_decor` 域字典,装饰域归并形态随迁)→ 宿主 7;恶化债归绿被 ≤15 吸收(键消失) |
| u3 | board_cell_unit.gd | 类变量 31/15;_draw 147 行 29 分支 19 局部(:135) | _draw 拆绘制私有族(底面/接触带/数字徽标/封印/高亮/点迹各域);**类变量收拢(v1.1)**:探针直读 4 成员(glyph/fog_state/plate/glyph_color)保持宿主,board_view 直写 26 成员收进内部状态件、board_view 写入行随动改址(约 40 行 `u.X =` → `u.st.X =`,机械改址零语义——S17 实查:31 成员中 30 个被 board_view 直写 47 行,本件为被动绘制壳,全清唯一路径=写入行随动)→ 宿主 6(4 冻结+_glow_layer+状态件) |
| u4 | standee_body.gd | 类变量 29/15;循环内 new×2(:268/:296);_draw 84 行 26 局部(:414) | _draw 拆绘制私有族(立绘/血条/意图/护甲徽标/顺位徽标);循环体提私有构建函数;**类变量收拢(v1.1)**:外部直访 4 成员(box/font/slot_row/has_world_hp_bar——battle_stage_view 直写 :122/:180/:214/:268、fx_probe/ui_probe 直读,S17)保持宿主,其余 25 个收进内部状态件(含 _death_shards/_hit_sparks/_flash_count 三探针出口计数——经 fx_probe() 方法出口,随迁方法读点)→ 宿主 5 |
| u1 | camp_overlay_view.gd | 类变量 19/15;循环内 new×7;_init 149 行 28 局部(:42);_rebuild_tree 61 行 21 局部(:222);_rebuild_forge 72 行 20 局部(:301);refresh_camp 61 行 17 局部(:386) | _init 拆四柜台构建私有族;_rebuild_*/refresh_camp 拆行板构建私有族;循环体提行板构建私有函数;**类变量收拢(v1.2 改法=按柜台子域拆件,禁四柜台混装一袋)**:探针冻结 5 成员(S17)保持宿主,其余 14 个按子域分组各成状态件——树域(_tree_holder)/锻造域(_forge_lock_l/_forge_workbench/_forge_zone_weapon/_forge_zone_armor/_forge_rows/_ws_scroll/_ws_lock_l)/同调域(_attune_header_l/_attune_btns/_attune_nodes)/刷新与最近域(_refresh_l/_refresh_btn/_recent_list),每件一句职责语句(分组微调属代拍板白名单,契约 9)→ 宿主=冻结 5+子域件 4=9(键照清) |
| u2 | level_map_screen.gd | **类变量 22/15(基线登记 21——iter38 恶化债 c4c69701,本卡归绿义务)**;_init 135 行 21 局部(:58);_draw_graph 78 行 9 分支 27 局部(:423) | _init 拆构建私有族;_draw_graph 拆绘制私有族(节点/通道/底栏);**类变量收拢(v1.1)**:探针冻结 6 成员(S17:_cand_ids/_hover_id/_content_size/_layout_cache/abandon_btn/status_badge)保持宿主,其余 16 个收进内部状态件(_node_icons/_noise_rect/_tint_level 三件在状态件内持 `_layer_decor` 域字典,装饰域归并形态随迁)→ 宿主 7;恶化债归绿被 ≤15 吸收(键消失);状态件须有职责语句、装饰域与图状态跨子域不混装(契约 9) |
| u3 | board_cell_unit.gd | 类变量 31/15;_draw 147 行 29 分支 19 局部(:135) | _draw 拆绘制私有族(底面/接触带/数字徽标/封印/高亮/点迹各域);**类变量收拢(v1.1)**:探针直读 4 成员(glyph/fog_state/plate/glyph_color)保持宿主,board_view 直写 26 成员收进内部状态件、board_view 写入行随动改址(约 40 行 `u.X =` → `u.st.X =`,机械改址零语义——S17 实查:31 成员中 30 个被 board_view 直写 47 行,本件为被动绘制壳,全清唯一路径=写入行随动;状态件职责语句=「单格绘制输入集」——被动绘制壳的全部绘制入参,单一变化原因成立〔契约 9 预检〕)→ 宿主 6(4 冻结+_glow_layer+状态件) |
| u4 | standee_body.gd | 类变量 29/15;循环内 new×2(:268/:296);_draw 84 行 26 局部(:414) | _draw 拆绘制私有族(立绘/血条/意图/护甲徽标/顺位徽标);循环体提私有构建函数;**类变量收拢(v1.1)**:外部直访 4 成员(box/font/slot_row/has_world_hp_bar——battle_stage_view 直写 :122/:180/:214/:268、fx_probe/ui_probe 直读,S17)保持宿主,其余 25 个收进内部状态件(含 _death_shards/_hit_sparks/_flash_count 三探针出口计数——经 fx_probe() 方法出口,随迁方法读点)——演出计数与装配态可分则按子域分组,整件收拢须给「站桩演出状态」职责语句并核单一变化原因(契约 9)→ 宿主 5 |
| u5 | hero_info_panel_view.gd | 循环内 new×2(:55/:189);_init 74 行(:24);set_treasure_inventory 57 行 13 局部(:162) | _init 拆段构建私有族;槽位循环体提私有构建函数 |
| u6 | battle_end_overlay.gd | 类变量 20/15;循环内 new×4(:222/:251/:271/:303);_init 81 行(:31);open_victory 参数 8/5(:116) | _init 拆行板构建私有族;循环体提私有构建函数;open_victory 可选尾参收拢 opts 字典(4 参);**类变量收拢(v1.1)**:探针直读 4 成员(_btn/_gp_name/_gp_row/_gp_val,S17)保持宿主,其余 16 个收进内部状态件 → 宿主 5 |
| u7 | debug_overlay.gd | 类变量 17/15;_build 124 行 22 局部(:153) | _build 拆五区块构建私有族(探针直引公开面逐字保留);**类变量收拢(v1.1)**:探针直读 3 成员(seed_edit/_sim_btn/_dbg_btn,S17)保持宿主,其余 14 个收进内部状态件(_run_data/_run_labels 经 run_data_probe()/update_run_data() 方法出口,随迁方法读点)→ 宿主 4 |
@@ -48,7 +48,7 @@
| u25 | main.gd | 类变量 49/15 | **架构豁免(v1.1)**:组合根类变量面=探针契约面(约 46 句柄被探针挂载假设钉死),v1.19「呈现层装配与会话生命周期」节 S13 豁免登记在册——**键永久基线内、禁再恶化;禁收拢 main 句柄、禁为清键改写探针挂载契约**。卡内任务=核对注记在位(v1.19 :183)+实现报告申报豁免状态(依据指针 v1.19);死成员清点删除任务随豁免取消(类变量面冻结) |
**完成定义**:
1. u1–u25 落地;`python tools/gdstyle_gate.py` 读数:**基线外新违规(NEW)=0**;**恶化(WORSENED)=1 条且仅为 battle_orchestrator 行数(卡 1 义务,不归本卡)**;**71 键=69 键清零+2 键豁免**(main 类变量、tune_sim 循环内 await——v1.19 两处豁免登记段在册,键永久基线内;§8.4 账目)。
1. u1–u25 落地;`python tools/gdstyle_gate.py` 读数:**基线外新违规(NEW)=0**;**恶化(WORSENED)=0**(开工时点唯一在册红 level_map_screen 类变量由 u2 归绿吸收;battle_orchestrator 行数已随迭代 40 归绿——v1.2 重锚);**71 键=69 键清零+2 键豁免**(main 类变量、tune_sim 循环内 await——v1.19 两处豁免登记段在册,键永久基线内;§8.4 账目)。
2. 呈现逐像素零变化:§7 T0 建锚面(甲/乙/丙三组)改后对拍全 0.00%。
3. 现役全套断言面绿:探针面(含源码锚字面量契约)与单元/集成套件零红、零删改(契约 5)。
4. 撤销证明逐行落地(§8 对照表末列);三份产出物写齐(T5,含豁免两键申报件);独立验收审计过。
@@ -66,7 +66,7 @@
## 3. 现状事实(2026-10-27 写卡会话实测于 master 8b146321;开工日 T0 复核行号)
**S13 读数**(`python tools/gdstyle_gate.py`):命中 216 条/基线内 216/基线外新违规 0/恶化 2(battle_orchestrator 文件行数 1314>1302=卡 1 义务;level_map_screen 类变量 22>21=**本卡还债义务**,iter38 卡① _layout_cache 缓存成员特批带红挂账 c4c69701)。25 文件逐文件读数见 §1 改动单元清单(gdstyle v0.4.0 实测,与清点报告 §五 2026-10-26 读数逐条吻合、行号为本次实测)。
**S13 读数**(v1.2 重锚——波 0 刷新 git d219dd3d 后基线 168 键):基线外新违规 0/恶化 1(level_map_screen 类变量 22>21=**本卡还债义务**,iter38 卡① _layout_cache 缓存成员特批带红挂账 c4c69701;battle_orchestrator 行数红已随迭代 40 卡①还债归绿——实测 1037=登记 1037)。25 文件逐文件读数见 §1 改动单元清单(gdstyle v0.4.0 实测,与清点报告 §五 2026-10-26 读数逐条吻合、行号为本次实测)。
**探针与测试直引面**(重构冻结面,逐条实测;v1.1 补全收拢件冻结成员——S17):
@@ -108,6 +108,8 @@
🔴 **契约 8 · 豁免键零重构**:tune_sim 测速循环(:65 逐帧 await)**禁重构**(D6——wall-clock 步进承载语义,重构即测量口径漂移);main 句柄面禁收拢(契约 3)。豁免键在实现报告各申报一行(键值/依据指针 v1.19 段名/禁再恶化注记)。
🔴 **契约 9 · 拆分边界纪律(DDD/高内聚,2026-10-28 用户裁)**:一切拆分(私有函数族/内部状态件/参数束)的边界沿职责轴、不沿阈值轴——①每个拆出单元须有可陈述的职责语句(实现报告逐件一行)与单一变化原因;②内部状态件须有集体身份:成员共同表达一个可命名的领域概念,**禁跨子域混装**(u1 四柜台子域为硬例——树/锻造/同调/刷新各成状态件);「探针直读之外剩下的成员」打包=凑计数袋,禁;③「过阈值」只许作为发现信号,作为收拢动机即违规;④某视图按本条拆不出内聚单元 → 该键不强清:停卡呈报走豁免/还债通道(main.gd 同款架构豁免登记),禁硬拆凑绿;⑤私有函数族边界沿绘制/构建域(底面/徽标/封印等既判分组为准),无域可循的长函数拆分停卡呈报。code-conventions §1.1 为上位规约。
## 5. 范围边界
**做**:u1–u25;消费面随动改址(§7 结构图注记行;含 board_view 写入行机械随动——u3 全清必要执行面);T0 锚面采集;撤销证明;产出物(含豁免申报件)。
@@ -178,7 +180,7 @@
**内部状态件形态(v1.1 收拢件统一形,u1/u2/u3/u4/u6/u7 取用)**:
```gdscript
# 宿主文件内嵌套声明(零新文件——契约 6);探针/外部直访冻结成员(S17)住宿主,不进状态件
# 宿主文件内嵌套声明(零新文件——契约 6);探针/外部直访冻结成员(S17)住宿主,不进状态件;状态件须有职责语句+单一子域(契约 9,跨子域混装禁)
class _DrawState extends RefCounted:
var glyph_col := UiKit.INK # 纯状态数据成员逐个迁入(命名随宿主原成员)
# 宿主侧:
@@ -254,7 +256,7 @@ func _init(db_ref, views: Dictionary, getters: Dictionary, flow: Dictionary) ->
### T1 营地与地图面拆分(≈1.6d)
- [ ] u1 camp_overlay_view:_init 拆四柜台构建私有族、_rebuild_tree/_rebuild_forge/refresh_camp 拆行板构建私有族、七处循环体提私有构建函数;**类变量收拢**——冻结 5 成员保持(S17 ①),其余 14 个迁 `_CampState` inner class、宿主读点改 st.X;源码锚句(S2 两组)整行原样保留。可核查结果:gdstyle 单文件复扫该文件键全清(类变量 6/15 键消失);ui_struct camp 源扫描绿;theme camp 三锚绿;camp 乙组帧对拍 0.00%。
- [ ] u1 camp_overlay_view:_init 拆四柜台构建私有族、_rebuild_tree/_rebuild_forge/refresh_camp 拆行板构建私有族、七处循环体提私有构建函数;**类变量收拢**——冻结 5 成员保持(S17 ①),其余 14 个迁 `_CampState` inner class、宿主读点改 st.X;源码锚句(S2 两组)整行原样保留。可核查结果:gdstyle 单文件复扫该文件键全清(类变量 9/15 键消失——子域件形 v1.2);ui_struct camp 源扫描绿;theme camp 三锚绿;camp 乙组帧对拍 0.00%。
- [ ] u2 level_map_screen:_init/_draw_graph 拆私有族;**类变量收拢**——冻结 6 成员+状态件保持(S17 ②),其余 16 个迁 `_MapState`(_node_icons/_noise_rect/_tint_level 在状态件内持 `_layer_decor` 域字典);S16 冻结成员与 layout_probe/display_probe 行为逐字不变。可核查结果:单文件复扫类变量 ≤15(键消失,恶化债归绿被吸收);level_map_info_fog_test 全绿(V1/V2 缓存断言继承);level_map golden 对拍 0.00%。
- [ ] u3 board_cell_unit:_draw 拆绘制私有族;**类变量收拢**——探针直读 4 成员+_glow_layer+状态件保持(S17 ③),board_view 直写 26 成员迁 `_CellPaintState`、board_view 写入行机械改址约 40 行(`u.X =` → `u.st.X =`,逐行对照 T0 直写清单,等价形禁改语义)。可核查结果:单文件复扫类变量 6/15 键消失+函数级键全清;board_view 随动行 grep 对账(改址行数=清单行数);棋盘三图 golden 0.00%(甲组);ui_input/player_copy 直读面回归绿。
- [ ] u4 standee_body:_draw 拆绘制私有族、循环体提私有构建函数;**类变量收拢**——外部直访 4 成员保持(S17 ④),其余 25 个迁 `_StandeeState`(fx 出口三计数随迁,fx_probe() 方法体读点改 st.X、返回键名零变化);standee 源锚四句(S6)逐字保留。可核查结果:单文件复扫键全清(类变量 5/15 键消失);standee_fx_sweep_test+fx_probe+theme 源锚段绿。
@@ -285,11 +287,11 @@ func _init(db_ref, views: Dictionary, getters: Dictionary, flow: Dictionary) ->
### T5 撤销证明+产出物落位卡(≈0.45d,末卡)
- [ ] 逐 wr 行撤销证明(§8.1 末列——读数对拍类:回退该文件 hunk→对照 T0 读数表该文件键读数回升=红→还原复绿;消费面迁移类:回退生产 hunk→随动消费方调用断红=更强证明;print 类:回退→源码 grep 命中=红;随动改址类〔board_view〕:回退改址 hunk→board_view 写入行对迁出成员断红)。记录进实现报告。
- [ ] S13 批末读数对拍:gate 输出 NEW=0、WORSENED 仅 battle_orchestrator 一条、**71 键账目对账(§8.4)逐键核对=69 键消失+2 键豁免在册**(main 49/15、tune_sim await——两申报行落位)。可核查结果:读数对拍表+豁免申报对账进实现报告。
- [ ] S13 批末读数对拍:gate 输出 NEW=0、WORSENED=0(开工时唯一在册红 level_map_screen 类变量由 u2 归绿吸收——v1.2 重锚)、**71 键账目对账(§8.4)逐键核对=69 键消失+2 键豁免在册**(main 49/15、tune_sim await——两申报行落位)。可核查结果:读数对拍表+豁免申报对账进实现报告。
- [ ] 写齐三份产出物(实现报告〔各卡状态+读数对照+豁免两键申报行+实机目检总清单——乙组三屏与丙组四态实机开合目检登记(登记不阻塞)〕/代拍板追认单/反哺点清单〔§6 逐条落点〕);临时抓帧脚本与丙组过程帧按中间产物纪律退役。
- [ ] 合并前置:独立验收审计(§8.3)逐行「通过」。
**估时合计 ≈5.3d**(区间 5.0–5.5;v1.0 ≈4.0d 上调 ≈1.3d——收拢增量明细:u1/u2/u4 各 ≈0.15d+u3 收拢与 board_view 随动改址 ≈0.25d+u6/u7 各 ≈0.12d+u13 束注入改址 ≈0.2d+print 删除与豁免申报 ≈0.1d;超软盒预挂=iter39 先行合回致行号重定位面扩大时 T0 +0.2d)。
**估时合计 ≈5.3d**(区间 5.0–5.5;v1.2 子域拆件增量 ≈+0.1d 已含区间内;v1.0 ≈4.0d 上调 ≈1.3d——收拢增量明细:u1/u2/u4 各 ≈0.15d+u3 收拢与 board_view 随动改址 ≈0.25d+u6/u7 各 ≈0.12d+u13 束注入改址 ≈0.2d+print 删除与豁免申报 ≈0.1d;超软盒预挂=iter39 先行合回致行号重定位面扩大时 T0 +0.2d)。
## 8. 验证闸
@@ -332,7 +334,7 @@ func _init(db_ref, views: Dictionary, getters: Dictionary, flow: Dictionary) ->
### 8.3 独立验收审计
入口=未参与实现的会话或子代理;报告落 `reports/iter<N>-验收审计-<日期>.md`;抽查重点=①T0 时点铁序(锚面采集先于码改——git 提交序核)②golden 对拍读数复现(抽 3 锚直跑)③S13 读数对拍表逐键复核+基线文件 git diff 零变化+**71=69 清+2 豁免账目复核(豁免两键依据指针 v1.19 段名在册)**④源码锚字面量契约抽检(S2/S6/S7/S9)⑤撤销证明抽两条复现⑥探针直引 46 名+S17 冻结成员零迁移抽检⑦**board_view 随动改址抽 5 行复核(等价机械形、零语义漂移)**⑧main.gd git diff 为空+await 行零触碰复核。未过不得合并。
入口=未参与实现的会话或子代理;报告落 `reports/iter<N>-验收审计-<日期>.md`;抽查重点=①T0 时点铁序(锚面采集先于码改——git 提交序核)②golden 对拍读数复现(抽 3 锚直跑)③S13 读数对拍表逐键复核+基线文件 git diff 零变化+**71=69 清+2 豁免账目复核(豁免两键依据指针 v1.19 段名在册)**④源码锚字面量契约抽检(S2/S6/S7/S9)⑤撤销证明抽两条复现⑥探针直引 46 名+S17 冻结成员零迁移抽检⑦**board_view 随动改址抽 5 行复核(等价机械形、零语义漂移)**⑧main.gd git diff 为空+await 行零触碰复核⑨拆分边界抽检(契约 9:各状态件/私有函数族职责语句逐件在案、u1 子域分组核对,跨子域混装或凑计数袋即红)。未过不得合并。
### 8.4 S13 账目(71 键=69 清+2 豁免,v1.1 全清口径)
@@ -346,7 +348,7 @@ func _init(db_ref, views: Dictionary, getters: Dictionary, flow: Dictionary) ->
- **L1(自救)**:行号漂移(T0 复核自吸收);私有函数命名、inner class 状态件命名与注释措辞;对拍帧采集的等价实现形态(探针帧直拷 vs 临时脚本)。
- **L2(记录继续)**:乙组 battle 帧跨跑次非 0.00% 降级丙组(判定记录写明);消费面随动改址的单行等价写法(含 board_view 写入行 `u.st.X =` 等价形);读数改善幅度与预估偏差(非清键义务单元);u4 fx 出口计数随迁后 fx_probe() 返回键序变化(键名零变化前提下)。
- **L3(停机呈报)**:任何 golden 对拍差异非零(契约 1);探针直引面/源码锚契约与拆分或收拢互斥(契约 2——S17 冻结成员被误迁状态件即属此);board_view 改址遇非机械点(写入行与读取交织/条件内联——契约 7);main 句柄面出现任何改动企图、测速循环重构企图(契约 3/8);机检键与契约互斥(契约 4);拆分或收拢产生基线外新违规且不可在阈值内消化(契约 4);发现收编清单外同病根新键(禁扩面——呈报由用户裁);**逐文件实查发现触碰 owner 契约/GDD 陈述**(D5——停笔呈报,禁内联求裁);豁免注记(v1.19 两段)缺位或段名漂移(T0 核对不通过)。
- **L3(停机呈报)**:任何 golden 对拍差异非零(契约 1);探针直引面/源码锚契约与拆分或收拢互斥(契约 2——S17 冻结成员被误迁状态件即属此);board_view 改址遇非机械点(写入行与读取交织/条件内联——契约 7);main 句柄面出现任何改动企图、测速循环重构企图(契约 3/8);机检键与契约互斥(契约 4);拆分或收拢产生基线外新违规且不可在阈值内消化(契约 4);发现收编清单外同病根新键(禁扩面——呈报由用户裁);**逐文件实查发现触碰 owner 契约/GDD 陈述**(D5——停笔呈报,禁内联求裁);豁免注记(v1.19 两段)缺位或段名漂移(T0 核对不通过);拆分边界无职责语句可陈述/状态件跨子域混装/凑计数袋(契约 9——停卡呈报走豁免/还债通道)。
## 10. 代拍板白名单(超清单必呈报)
@@ -1,6 +1,6 @@
# 需求卡片:核心数据面结构收敛批(gdstyle 存量债清偿·卡 2——数据校验族/生成器族/效果引擎/core-data 散条 86 键)
- 版本:**v1.1**(写卡段修订成文——2026-10-27 用户全清裁决四项折入+拆件面实查补全;自审六查与 grilling 自检一轮记录见 §12)
- 版本:**v1.2**(v1.1=2026-10-27 用户全清裁决四项折入+拆件面实查补全;v1.2=2026-10-28 用户裁「拆分边界纪律(DDD/高内聚)」落卡——新增契约 7+审计⑪+L3 增款+基线读数锚重锚〔216→168 键,随波 0 刷新 d219dd3d〕;自审六查与 grilling 自检记录见 §12)
- 来源:[待办清单](../待办清单.md)「gdstyle 存量债全量清偿——216 键按病根分波整改」条目(2026-10-26 登记,P0,状态=文档设计已闭合+已写卡)(唯一事实源:清点报告 [审计-gdstyle存量债清点与清偿方案-2026-10-26](审计-gdstyle存量债清点与清偿方案-2026-10-26.md) §六第 2/3/4/7 条裁定——证据指认形态,见 §2)
- 归并账目(清点报告 §六第 7 条):本卡收编=**波 2(40 键/13 文件)+波 4(17 键/2 文件)+effect_engine(8 键)+波 8 core/data 侧 10 文件(21 键)=86 键/26 文件**;与卡 1(B1 战斗域拆件批 45 键)、卡 3(呈现层结构收敛批 71 键)账目闭合 45+86+71=202+三宿主规避 14=216。**2026-10-27 用户全清裁决:86 键全部清零**——v1.19 在册豁免仅两处(组合根 main 句柄面/测量面 tune_sim await),均不在本卡文件集,本卡零豁免零残留
- 归属:`game/data/schemas/` 12 文件+`game/core/` 14 文件+`game/data/tables/adventure.tres`(等值迁移)+**新件 8**(`game/core/config_domain_combat.gd`/`config_domain_run.gd`/`config_domain_crossrun.gd`/`slot_store.gd`/`meta_state_store.gd`+`game/data/schemas/adventure_quota_segment.gd`/`adventure_value_segment.gd`/`adventure_cap_segment.gd`)+消费方改址(`game/core/`、`game/presentation/`、`game/tests/`、`game/probe/`、`game/sim/` 约 60 文件,实查合计 ≈1330 处——§3.5 分面计数)
@@ -24,7 +24,7 @@
**清偿账目**:86 键全清——校验族 40+生成器族 17+效果引擎 8=65 键由文件内私有拆分清偿(gdstyle 直扫键消失,闸读数下降自然绿);波 8 core/data 侧 21 键由结构收敛清偿:config_db 44+25 两键=归位+容器(44→8/25→9)、save_manager 52=拆件(52→7)、meta_progression 31=瘦身(31→20)、adventure_table 44=拆段(44→12)、action_economy 18=删并(18→15)、unit_container spawn 参数=束化(10→1)、save_manager `_peek_summary_at`/load_from_disk 返回键与 meta_progression tree_can_buy 返回键=留置函数原位拆分清偿。新件 8 封闭面全部在阈(§7 预检逐件核验),零基线外 NEW。
**完成定义**:
1. §7 结构图全部行落地(含 8 新件);`tools/gdstyle_gate.py` 改前改后读数对拍:**基线外 NEW=0(含新件)、恶化=0、在案键计数较 216 下降 86**(86 键消失清单+新件键账表进实现报告);
1. §7 结构图全部行落地(含 8 新件);`tools/gdstyle_gate.py` 改前改后读数对拍:**基线外 NEW=0(含新件)、恶化=0、在案键计数较 T0 实测基线(波 0 刷新后 168 键,git d219dd3d)下降 86**(86 键消失清单+新件键账表进实现报告);
2. 行为等价证据齐:数据校验族断言面(data_config 八套件+core 直引 12 文件)全绿;生成器同种子逐位一致(现役 determinism 断言继承);效果引擎现役四套件全绿;**存档读写逐位等价**(save 现役断言面改址保持全绿——原子写/兜底/拒读/迁移链语义零变化);
3. 撤销证明逐 wr 行落地(§8.1 末列);三份产出物写齐(T10);独立验收审计过。
@@ -102,7 +102,7 @@
🔴 **契约 2 · 断言面逐字保留**:现有 validate 系单测(data_config 八套件+core 直引 12 文件)、生成器断言面(board_generator_test/node_map_generator_test/node_map_determinism_test 等)与 save/meta 断言面(save_manager_domain/save_slot_isolation/save_slot_summary/save_boot_no_activate/breakpoint_resume/meta_progression_forge/tree_requires_level 等)**禁删禁改判据**;确需改判据=测试削弱申报节逐条列明理由。测量面改址(§7-K 列明的调用点换址)=访问路径改写,断言语义与判据逐条保持。
🔴 **契约 3 · S13 纪律**:`tools/gdstyle_baseline.txt` 禁改禁 refresh;还债=数值下降自然绿;**在案键的函数禁搬移文件**(基线函数级键逐一核对:save_manager 两函数键与 meta_progression tree_can_buy 返回键全部原位留置——本卡搬移面均为无键方法,§3.5 已核对);新件封闭面按 §3.5 预演值落地、禁超阈;机检键与卡片契约互斥时停卡呈报。
🔴 **契约 3 · S13 纪律**:`tools/gdstyle_baseline.txt` 禁改禁 refresh(波 0 已于 2026-10-28 批外刷新至 168 键,批内禁改口径不变);还债=数值下降自然绿;**在案键的函数禁搬移文件**(基线函数级键逐一核对:save_manager 两函数键与 meta_progression tree_can_buy 返回键全部原位留置——本卡搬移面均为无键方法,§3.5 已核对);新件封闭面按 §3.5 预演值落地、禁超阈;机检键与卡片契约互斥时停卡呈报。
🔴 **契约 4 · 禁为机检文本保留无效成员**(req-card 第 13 条,本卡属重构类):禁为迎合机检消息文本(含计数)保留或新增无效成员/别名/死存储/**转发壳**(action_economy `_next_round_mode` 删除即本契约的执行例;K1′ 删除的两访问器禁以兼容名留转发、K3′ 退役的两纯转发禁在 meta_progression 留同名委托);机检键与本卡契约互斥时实现段一律停卡呈报,不得自造第三条路。
@@ -110,6 +110,8 @@
🔴 **契约 6 · 核心层纪律不破**:Core 层零 UI 依赖(拆分后完整战斗仍可 `--headless --script` 跑通);数值单一事实源(adventure_table 拆段后玩法数值仍只存 `data/tables/*.tres` 经 ConfigDB 单点读取——口径按架构 v1.19 :88:「经 ConfigDB 单点读取」=经其持有的表对象,访问器语义不变);RNG 单点(零新增随机);**新件零 autoload**(SlotStore/MetaStateStore 由 save_manager 组装持有、经 `save.slots`/`save.meta_state` 直连——组合根句柄面与 autoload 链零新增,架构 :89/:90 消费依赖单向)。
🔴 **契约 7 · 拆分边界纪律(DDD/高内聚,2026-10-28 用户裁)**:一切拆分(私有函数族/新件/段件/容器)的边界沿职责轴、不沿阈值轴——①每个拆出单元须有可陈述的职责语句(「X 域归 Y 件,因为 Z」,实现报告逐件一行)与单一变化原因;②单元须有集体身份:成员共同表达一个可命名的领域概念——命不出名字、只能说「剩下的成员」的打包=凑计数袋,禁;③成员被互不相干调用方分别消费=边界切错,按消费域重切;④「过阈值」只许作为发现信号,作为拆分动机即违规;⑤职责上不可分且拆不出内聚单元 → 停卡呈报走豁免/还债通道(architecture「S13 豁免登记」同款),禁硬拆凑绿。code-conventions §1.1(高内聚低耦合/禁为机检保留无效成员)为本条上位规约。**v1.2 审查预检结论**:本卡 T1–T9 拆分族与新件 8 逐项核对均有职责语句与集体身份(校验域/装载域/管线阶段/槽位文件域/存档内元进度数据域/三域容器/列族段),无凑计数形态——本条对卡 2 为确认性纪律,无改法变更。
## 5. 范围边界
**做**:§3 所列 26 文件的结构拆分与 §7-K1′–K6′ 公开面收敛(含 8 新件建件与 ≈1330 处消费方改址);adventure.tres 等值迁移;撤销证明;产出物。
@@ -317,13 +319,13 @@
### 8.3 独立验收审计
入口=未参与实现的会话或子代理;报告落 `reports/iter<N>-验收审计-<日期>.md`;抽查重点=①错误清单逐字等价(任选三 schema 改前改后坏表对拍读数)②生成器同种子逐位一致记录③效果引擎装载序与词表零 diff(git diff 查 EVENTS/EFFECT_KINDS/FACTS/OPS 四常量)④归位映射抽检(每容器 ≥3 处行数据逐字+K1′ 溶解/迁移/委托三形态各 ≥2 处)⑤拆件抽检(save roundtrip 逐位读数+激活回退四态断言+纯转发零残留 grep 复跑)⑥拆段表值逐字(全组合读数对拍)⑦新件键账零 NEW(gdstyle 直扫 8 新件)⑧S13 基线未改(git diff 查 `tools/gdstyle_baseline.txt` 零变化)⑨改址抽检(五组各 ≥3 处断言语义等价)⑩撤销证明复现。未过不得合并。
入口=未参与实现的会话或子代理;报告落 `reports/iter<N>-验收审计-<日期>.md`;抽查重点=①错误清单逐字等价(任选三 schema 改前改后坏表对拍读数)②生成器同种子逐位一致记录③效果引擎装载序与词表零 diff(git diff 查 EVENTS/EFFECT_KINDS/FACTS/OPS 四常量)④归位映射抽检(每容器 ≥3 处行数据逐字+K1′ 溶解/迁移/委托三形态各 ≥2 处)⑤拆件抽检(save roundtrip 逐位读数+激活回退四态断言+纯转发零残留 grep 复跑)⑥拆段表值逐字(全组合读数对拍)⑦新件键账零 NEW(gdstyle 直扫 8 新件)⑧S13 基线未改(git diff 查 `tools/gdstyle_baseline.txt` 零变化)⑨改址抽检(五组各 ≥3 处断言语义等价)⑩撤销证明复现⑪拆分边界抽检(契约 7:新件/段件/拆分族职责语句逐件在案,抽 3 件核「单一变化原因+集体身份」两判据,凑计数袋形态即红)。未过不得合并。
## 9. 异常分级
- **L1(自救)**:行号漂移(T0 重锚自核);私有 helper 与投影内部实现的命名与注释措辞(投影键构成与公开签名不属此列);拆分域边界微调(各件 ≤阈值前提下)。
- **L2(记录继续)**:五组改址中发现清单外调用点(同法改址+计数记录进实现报告);束键解包的等价实现细节;段件/容器成员的 @export 形态细节(类型化成员语义不变前提下)。
- **L3(停机呈报)**:任何断言红且非测试问题;拆分后错误清单与改前不等价;RNG 取号序失配;存档读写逐位不等价或原子性语义漂移;归位后表读取语义漂移(空表护栏/缺省兜底);发现触碰 GDD/owner 契约的病根(停卡呈报,禁内联求裁);新件或留置面超阈(封闭面破坏——契约 3);K 清单外须动公开面的场景(实现段零裁断——退回上游)。
- **L3(停机呈报)**:任何断言红且非测试问题;拆分后错误清单与改前不等价;RNG 取号序失配;存档读写逐位不等价或原子性语义漂移;归位后表读取语义漂移(空表护栏/缺省兜底);发现触碰 GDD/owner 契约的病根(停卡呈报,禁内联求裁);新件或留置面超阈(封闭面破坏——契约 3);K 清单外须动公开面的场景(实现段零裁断——退回上游);拆分边界无职责语句可陈述或凑计数袋形态(契约 7——停卡呈报走豁免/还债通道)。
## 10. 代拍板白名单(超清单必呈报)
+16 -99
View File
@@ -18,8 +18,8 @@
- 清点报告 reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md(2026-10-26,216 键全量清单+波次方案+纪律+设计段裁定记录 §六含整合裁定第 7 条)
- 设计定稿 design/engineering/architecture/architecture.md v1.19(2026-10-27:波 1 拆件定稿 v1.18 节+全清设计补课——ConfigDB 访问器归位与域容器持有+SlotStore/MetaStateStore 两新件行+组合根句柄面/测量面两处 S13 豁免登记)
- 需求卡片 B1 战斗域拆件批卡(2026-10-27 v1.1 全清口径修订后编入;已随迭代 40 实现批合回退役,git 历史可考——合并提交 514457d1)
- 需求卡片 reports/需求卡片-核心数据面结构收敛批-2026-10-27.md(2026-10-27 v1.1 全清口径修订:config_db 访问器归位+三域容器+SlotStore/MetaStateStore 拆件+adventure_table 拆段+spawn 束化;估时 ≈7.9d;零待裁点)
- 需求卡片 reports/需求卡片-呈现层结构收敛批-2026-10-27.md(2026-10-27 v1.1 全清口径修订:print 删除+七件绘制态内部收拢+main/await 两键按 v1.19 豁免申报;估时 ≈5.3d;零待裁点)
- 需求卡片 reports/需求卡片-核心数据面结构收敛批-2026-10-27.md(v1.2=v1.1 全清口径修订〔2026-10-27〕+拆分边界纪律契约 7 落卡〔2026-10-28 用户裁 DDD/高内聚〕;config_db 访问器归位+三域容器+SlotStore/MetaStateStore 拆件+adventure_table 拆段+spawn 束化;估时 ≈7.9d;零待裁点)
- 需求卡片 reports/需求卡片-呈现层结构收敛批-2026-10-27.md(v1.2=v1.1 全清口径修订〔2026-10-27〕+拆分边界纪律契约 9 与 u1 子域拆件改法落卡〔2026-10-28 用户裁 DDD/高内聚〕;print 删除+七件绘制态内部收拢+main/await 两键按 v1.19 豁免申报;估时 ≈5.3d;零待裁点)
- 三宿主主副卡(已随迭代 39 实现批合回退役,git 历史可考——合并提交 ffb0ac15;原「规避指向:本事项禁触三宿主」随三宿主债清偿完成历史使命,残留归尾波)
- 需求卡片 结构小件定点修批卡(波 7 现成卡:iter38 卡②停卡退回上游后经 v1.3→v1.4 修订定稿编入;已随迭代 40 实现批合回退役,git 历史可考——合并提交 514457d1)
@@ -27,6 +27,20 @@
**状态**:文档设计已闭合+已写卡+已编迭代 41
#### 数值标定窗口总挂账——原九条数值类条目合并(2026-10-28 登记,来源=会话提及)
**实况**:2026-10-28 用户令把九条数值类挂账合并为一条:削弱档位的最终数值/迭代 10 奖励重构联动欠账/调参批数值点评登记/三方向各自的解锁清单与定价/GP 经济换算失衡/天赋树实装批登记欠账余两件/商店独立刷新机制两参数/基线通关率越带加难杠杆扫描/成长系数节奏——原九条同步删除,内容全量迁入汇总文档,git 历史可考(本提交)。共同背景:M4 数值批卡已随 2026-10-16 删卡令退役;2026-10-18 用户裁=各条留待办清单、未设计未启动、不另行归属,未来数值标定窗口重开时重走设计段再写卡——本条沿用该裁定,重启条件=用户发令开窗口。合并动机=九条共享同一重启条件与同一执行形态(窗口内一次 MC 批量统一覆盖各条对比需求:全冒险期望+奖励期望+对拍锚重锚),分散登记徒增维护面。逐条挂账明细、裁定史与相关文档见汇总文档。
关联文档清单:
- 汇总文档 reports/汇总-数值标定窗口挂账-2026-10-28.md(2026-10-28,九条全量内容+统一执行形态建议序:设计段逐条裁决→按域拆卡→实现批三处同步→测量批一次跑批)
- MC 采集档位表 sim-data/README.md(档位硬闸与执行约束:一档只能由用户发起、无数值改动零跑)
**缺口**:数值标定窗口未重开(用户发令触发);窗口设计段逐条裁决写入文档后方可写卡;其中原「基线通关率越带」条另等真人批 k 系数到账。
**改动面**:文档+游戏代码
**状态**:待文档设计
#### 战斗域结构深拆批——效果发射端口+宿主瘦身+掷格/受理分件(2026-10-27 登记,来源=批次移交)
**实况**:三条同病根的结构债,需先一次设计讨论定端口形态,再谈切卡;`RewardEconomy` 的最小缝拆样本已由迭代 40 卡② 落卡。
@@ -118,17 +132,6 @@
**状态**:待文档设计(备选)
#### 天赋树实装批登记欠账余两件——AP 上限 clamp 与三选一刷新软上限(2026-10-12 登记,来源=批次移交)
**实况**:迭代 21 天赋树实装批顺带入册欠账三条,2026-10-13 三件终态:① **AP 上限 clamp 缺位(缺陷)**——树「开局姿态」(每关首轮 AP+1)、AP 件、时沙同走 `action_economy.gd:239 _pending_ap_delta` 排队,轮始兑现仅下限钳制(`:254 maxi(0, …)`,无上限);**用户裁暂不设上限**——provisional 天花板亦不投,随未来数值标定窗口连同全部 AP 数值统一标定(M4 数值批已废)。② **三选一刷新软上限(设计问)**——停点内 GP 付费刷新倍率增长(×1.8/次曲线)×停点间基础价随进度递增,全程无软上限;**定性确认=设计问非缺陷,用户裁维持现状**,归未来数值标定窗口处理,不提前单开讨论。③ **Y(_attune_refresh_y)不入断点存档(可利用漏洞)**——已修复注销(2026-10-13 用户令提前单独开修:断点快照扩列 `attune_refresh_y`+续玩 `resume_adventure` 优先读断点〔缺键回退参数面=旧档行为零变化〕+单测两断言;冒烟 938/0+单测 24 套全绿)。①②留待办清单待未来数值标定窗口(M4 数值批已废;2026-10-18 用户裁=不另行归属、未设计未启动)。
**缺口**:还差未来数值标定窗口的标定执行(M4 数值批已废;2026-10-18 用户裁=本条留待办清单、未设计未启动、不另行归属)。
- 相关文档:① [行动经济](design/gdd/systems/排雷循环/行动经济.md);② 行动经济+三选一/商店刷新经济(数值归未来数值标定窗口——M4 数值批已废);③ [存档序列化](design/gdd/systems/表现与支撑/存档序列化.md)(断点域)+ [冒险结构](design/gdd/systems/冒险循环/冒险结构.md)(续玩参数面)——③已修复注销
**改动面**:文档
**状态**:待文档设计
#### 棋盘战斗键盘/手柄输入(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 开卡)。
@@ -173,16 +176,6 @@
**状态**:待文档设计
#### 削弱档位的最终数值(2026-09-18 登记,来源=会话提及)
**实况**:削弱取值域 [60,85] 与投值 −65 来自旧体系裁决;"封印标中必须比随便挖一格更值"的当量终值由[战斗结算](design/gdd/systems/战斗循环/战斗结算.md)与[地图战斗资源](design/gdd/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 用户发令、发起前须用户批准。
**缺口**:M4 数值批卡片已随 2026-10-16 删卡令退役;2026-10-18 用户裁=本条留待办清单、未设计未启动、不另行归属,未来数值标定窗口重开时重走设计段再写卡。
**改动面**:文档+游戏代码
**状态**:待文档设计
#### 单体寻址的接口扩展位(2026-10-18 登记,来源=会话提及)
**实况**:扩展位语义已裁定并落文(2026-10-26 设计讨论闭合)——目标记在状态实例上(按生成序寻址)、单体与否由授予方在授予时定、共享与单体实例并存独立结算、目标死亡即移除、呈现挂目标立绘血条下;实现随首个单体效果的内容批进游戏,真实入口验收随该批闭合。设计定稿=design/gdd/systems/战斗循环/增益状态.md v1.1(2026-10-26,核心规则新增〈单体寻址扩展位〉节)+design/gdd/systems/战斗循环/敌人系统.md v1.1(2026-10-26,敌方效果规则行与 P1 行指向更新)。
@@ -210,49 +203,6 @@
**状态**:文档设计已闭合+已写卡(备选)
#### GP 经济换算失衡——GP 袋面值与商店价格的换算关系复查(2026-10-07 登记,来源=审计发现)
**实况**:道具三层审查的换算发现——小 GP 袋 20 ≈ 商店两三次首购(首购基价 4-5、A 链爬升前)≈ +2~4 点属性,而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算,且 GP 袋是池内最大户(23/98 张)进一步放大倾向。用户判「太离谱」。复查范围=GP 袋面值(20/50)× 商店基价(4/4/4/5)× 价格曲线(A=1.8 / b=1.1)× 战斗 GP 掉落(普通 3 / 精英 5 / Boss 8,关级加值 0/1/2)四处联动;目标=钱与属性件的换算效率回到设计意图(拿钱 vs 拿数值的取舍成立;GP 袋最大户地位要么有理由要么让位)。连带前提:L1 无商店节点使 GP 在第一关无消费口——「L1 商店编排」不另立条目、归本条复查范围(按 L1 是否补商店分两种情形各算一遍)。留待办清单待未来数值标定窗口(M4 数值批已废;2026-10-18 用户裁=不另行归属、未设计未启动)。
**缺口**:还差四处联动的换算复查设计(含 L1 商店编排两种情形)——随未来数值标定窗口执行(M4 数值批已废,留待办清单未设计未启动)。
- 相关文档:[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)调参批(未来数值标定窗口)+ 奇物池结构顺带
**改动面**:文档+游戏代码
**状态**:待文档设计
#### 迭代 10 奖励重构联动欠账(2026-10-01 登记,来源=批次移交)
**实况**:迭代 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 用户发令、发起前须用户批准。
**缺口**:M4 数值批卡片已随 2026-10-16 删卡令退役;2026-10-18 用户裁=本条留待办清单、未设计未启动、不另行归属,未来数值标定窗口重开时重走设计段再写卡。
**改动面**:文档
**状态**:待文档设计
#### 调参批数值点评登记(2026-10-01 登记,来源=批次移交)
**实况**:格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 50/25 不对称是否有意;② 削弱型 65/25 同问(且 percent 套个位数取整偏粗);③ 回血奖励过薄(值 1、权重全池最低 2);④ 警觉/行动点修正两新词数值全部 provisional;⑤ 行动经济"满停一轮=一刷"节拍在 AP±1 修正下的对账——①-⑤五条已入 M4 数值批卡 v1.2 件②(F5,逐条裁决落文);⑥ **格面资源正负兑付倍率差回调(2026-10-07 用户裁)**——2026-10-01「踩雷必须痛」抬档(heal +2/−6、pierce/magic +2/−8 等,负向 3-4 倍于正向)系错误的加难杠杆:难度提升应走怪物性能路线而非抬地图惩罚,回调归未来数值标定窗口(M4 数值批已废),标错/开雷同档同罚维持不动(同批裁);⑥连同本条整体留待办清单未设计未启动(2026-10-18 用户裁)。里程碑立规(2026-10-09):M4=Beta 阶段、M3 未由用户明令关闭前不排期。
**缺口**:M4 数值批卡片已随 2026-10-16 删卡令退役;2026-10-18 用户裁=本条留待办清单、未设计未启动、不另行归属,未来数值标定窗口重开时重走设计段再写卡。
- 相关文档:[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)难度曲线调参批
**改动面**:文档
**状态**:待文档设计
#### 成长系数与关卡怪物难度提升的节奏(2026-10-16 登记,来源=playnote)
**实况**:来源=playnote 用户反馈「一开始不能让角色的成长系数太高。比如在没经过升级之前,你的成长系数是跟不上关卡怪物难度提升的;但是后续能力解锁之后,成长系数才能匹配得上」。语义两读:**读法甲=节奏缺陷呈报**(前期成长跟不上怪物难度提升=要修的数值节奏问题,归属难度曲线与Boss+元进度解锁节奏的数值面);**读法乙=设计哲学陈述**(前期成长刻意克制、后期靠能力解锁追平=既定设计,应反哺难度曲线的设计语义)。2026-10-16 用户定性=数值校准类、与数值欠账同类任务,甲/乙两读随定性消解(无论现行节奏好坏,调它都是数值校准面的事);不进 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)(数值调优义务 2026-10-16 v1.6 起不入版本标准);按里程碑立规属 Beta 阶段面,Alpha 不排期;留待办清单数值欠账组,未设计未启动(2026-10-18 用户裁=不另行归属)。
**缺口**:还差并入数值欠账组的归属落位(Beta 阶段数值校准窗口处理)。
- 相关文档:[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md) + [元进度](design/gdd/systems/跨局循环/元进度.md)(成长系数语义面)
**改动面**:文档
**状态**:待文档设计
#### 「封锁-蓄力」combo 设计素材(2026-10-07 登记,来源=会话提及)
**实况**:用户想法(暂不立件,素材登记)——两件套:件一=抬高刷新雷图代价(储备池 RAP 成本飙高)+ 刷新时解锁所有格子(全板开);件二=本回合留着 AP 没有刷新 → 获得减伤。联动=抬价逼留 AP、留 AP 给减伤、憋够一发全板解锁。我方补充登记五点:①形态骨架=「封锁-蓄力」combo 结构(抬高某动作代价封路 + 不做给补偿 + 憋到后的爆发);②件一=风险契约句式的扫雷侧版——碰撞点待裁:刷新开全板与清图判定/清图奖励/连锁展开的关系(算不算清图、发不发清图奖励);③件二词表可承载(on round_end when 本轮未刷新且余 AP≥X → 减伤/护盾),「本轮未刷新」事实=扩签候选;④归层按判定尺逐件裁(两件偏机制改写→专长域;但「刷新代价」是扫雷侧经济参数→秘宝域亦可);⑤防躺赢注记:憋的收益须小于正常挖格期望(否则最优解=永远不挖,玩法塌缩)。
@@ -284,27 +234,6 @@
**状态**:待文档设计
#### 基线通关率越带,加难杠杆扫描未执行(2026-09-18 登记,来源=审计发现)
**实况**:原登记=现行扫描读数 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调参批,扫描执行与[棋盘生成](design/gdd/systems/排雷循环/棋盘生成.md)工具交付联动
**改动面**:文档
**状态**:待文档设计(备选)
#### 三方向各自的解锁清单与定价(2026-09-21 登记,来源=审计发现)
**实况**:三方向(属性、遭遇、道具池)各自的解锁清单与定价:多少钥石换什么,各自怎么铺。来源=元进度 待设计问题清单第 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;含待办清单死文本两句全刷义务:「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 判据按两句全刷执行)。
**缺口**:M4 数值批卡片已随 2026-10-16 删卡令退役;2026-10-18 用户裁=本条留待办清单、未设计未启动、不另行归属,未来数值标定窗口重开时重走设计段再写卡。
**改动面**:文档
**状态**:待文档设计
#### 第二 / 三关棋盘观感——亮度与对比度(2026-10-13 登记,来源=playnote)
**实况**:来源=playnote 用户试玩记录「UI 优化,第二第三关的棋盘看着太累了;不知道是因为亮度还是对比度的原因,看着非常费劲,非常不舒服」。2026-10-13 用户裁定:**这是需要做的**,且本就属版本标准的覆盖范围——[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「五 · 表现」已新增「棋盘观感(第二 / 三关亮度与对比度)」行,标待做。**开工前须先定性(沿用既有裁决)**:是**素材轴**问题(棋盘瓦片与格面图标本身的明度与色相),还是 **UI 轴**问题(舞台底色与叠加层的对比关系)——两轴修法完全不同,定性错了等于白改一轮;该定性要求(原备忘 (e) 项)是本条的开工前置。2026-10-16 曾编入迭代 30 卡③(UI 呈现三卡批序位③),2026-10-17 用户裁定剔除回待设计(自身挂「素材轴/UI 轴」定性人闸+甲/乙〔recolor/远程生图重产〕素材裁点;若裁乙,其瓦片规格依赖战斗一屏样张批的目标规格清单产出)。v1.4 旧卡留 reports/需求卡片-二三关棋盘观感批-2026-10-16.md 作素材,非已写卡状态。与已完成注销的「呈现层残余 <4.5:1 文字位」分工:本条管**棋盘区域整体的观感**(亮度/对比度/费劲感,体感问题),彼条管**具体文字位的对比度读数**(机检可判硬指标),两条不同面不互相替代。Alpha 出口裁决:Alpha 必须,先做素材轴/UI 轴对照定性;出口=用户实机目检不再判「看着费劲」。
@@ -455,18 +384,6 @@
**状态**:待文档设计(备选)
### 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 付费刷新,同旋钮同曲线同钱包;机制登记归[秘宝](design/gdd/systems/跨局循环/秘宝.md)「三选一刷新双源」节)。剩余待办:①调参(shop_refresh_free/曲线两参数 provisional,归未来数值标定窗口顺带——M4 数值批已废);②天赋增益形态与数值(设计未定);③机制文档回写核对(冒险结构共享池账本节/关卡节点地图商店行 v1.6 已记,本条完成时核对三处同步)。
**缺口**:还差天赋增益形态与数值的设计讨论(用户调整时裁)与 M4 窗口的两参数标定;③回写核对随完成时点履行。
**改动面**:文档+游戏代码
**状态**:待文档设计
### 文档与结构
#### qa/ 实现报告收尾·孤儿遗留七项余二项(2026-10-14 登记,来源=批次移交)