game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,617 Commits 23 Branches 0 Tags
9c1fd6f1523ec7ae0bdc7dd90ce552391dacef21
Commit Graph
15 Commits
Author SHA1 Message Date
DKChan 32fdf957fd refactor(代码术语): 卡① flag→seal 全族换代＋game/ 禁用词清扫（迭代 31 卡①） 
标识符面：flag_*→seal_ 族（含 Godot 信号 flag_judged→seal_judged 与连接/回调同名、
FACTS 两键 flags_count→seals_count／dug_under_flag→dug_under_seal 全链、
.tres 键名与 schema .gd 同批同步）；显式豁免零改动=size_flags_*（Godot 布局属性）＋_fatal_flag。
中文面：金币→GP（金币袋→GP 袋）／插旗→封印／雷格→危险格／惩罚格→危险格／旗→封印·封印印记族，
game/ 内 *.gd/.tres/.md/.json 四类禁用词与 flag 双双零命中（V1/V4）。
守卫字面量不动（被检查的禁字不是使用）：smoke_all V21 零「雷/旗」检查面、
ui_font_asset_test 字形集攻/雷/旗/封 保持原断言逻辑。
代拍板：板面单字槽 glyph「旗」→「封」（禁字纪律＋单字位宽，消费面四处同名随动）。
素材换代（2026-10-18 用户裁案甲）：assets/art/board/flag_seal.png→seal_mark.png（素材不入 git，
盘上改名＋导入重刷），代码两处 res:// 字符串＋COL_FLAG/CURSOR_FLAG 常量同步，
闸件四处随批（run_all_gates.sh/render_gate.sh/golden_baseline_refresh.sh/path_check.py）。
anchor.json 键名手改，重锚与改前改后 diff 随本卡收口（同裁案甲）。

基线读数（改前，主区 ed2dfaf6）：冒烟 1151 检查 0 失败／单元 34 套全绿／探针 --click
存量红仅 screen_flow_probe（user:// 断点污染在册已知项）。
改后同批读数（本 worktree）：冒烟 1151 检查 0 失败／探针 --click 同一存量红、其余全绿。
 2026-10-19 02:52:38 +08:00
DKChan 9a72394652 chore(代码卫生): 头注存量清偿批——82 文件按两类白名单改写为 ## 文档注释载体 
按 code-conventions §1.4.1 第三轮定稿执行：core 22+schemas 18+presentation 根 14+views 28，全部头注 #→##、删日期/变更叙事/GDD 与架构反向链接/字段与域清单/机制描述，保留职责摘要+真实使用约束（防事故禁令/单一入口/信号契约每信号一行）。main.gd 31→5 行、save_manager 45→5 行、adventure_runner 37→5 行为最大单件。子代理分模块执行（波一 core+schemas、波二 presentation+views，并发≤2）。验收=tools/verify_comment_only_change.py 逐字节校验（82 文件头注区外逐行一致=零行为变更）+audit_file_headers 全绿；纯注释批免冒烟（先例 5843270）
 2026-10-16 23:28:07 +08:00
DKChan 6c2dbc37c1 docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档） 
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查）
- architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条
- CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源
- doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档
- registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步）
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
 2026-10-15 23:52:30 +08:00
DKChan 5f9d8e7b77 chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令） 
- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例）
- 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为
  现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行）
- 纯注释改动零行为变更，按用户令免测试免冒烟
 2026-10-15 04:08:38 +08:00
DKChan eea345882b feat(迭代27 T6+T7): 波五b 卫生件包+文档同步闸——对拍全同 
T6 卫生件（P2 组收口）:
- 死代码 13 函数删除（审计 16 处复核=ui_kit:486 实读现役不删，追认单#14）+FeatsEngine
  整文件退役（class_name 注销）
- 字符串 Callable×10 位→方法引用形态（编译期方法存在性校验；语法实证 METHOD_REF=true）
- 状态机 enum 化: adventure State（外部 String 契约 getter 词表逐位一致+外部纯读实证）/
  standee HeroState（register/set String 形参零变化+probe 面恒等）
- ConfigDB _fatal 退出归根（核心层去 quit/crash→_fatal_flag，决策归组合根 fail-fast 通道）
  +resolver 诊断/数据通道全面 Callable 化（ConfigDb↔Resolver 类型环断根）

T7 文档同步闸:
- 实现报告 design/qa/iter27-实现报告-2026-10-14.md（五波+闸表+追认单十五项+反哺点两条+目检五件）
- 06 迭代 27 条销号+GDD 反哺点两条新条；07 ㉖ 目检节+v1.0 版本行；roadmap ✅ 换代
- 审计报告本体按退役规则 git rm（吸收即死；修正计数由卡片承载）；卡片来源行改指路

闸: 对拍三变体全同（第五跑）+冒烟 1081/0+run_all 27 套+probe click+render golden+static_scan 全绿
 2026-10-15 01:41:37 +08:00
DKChan b605022001 feat(迭代27 T5): 波五a 类型闸拉起+存量收口——审计器 0 存量+warning 配置在位 
P1-6 类型闸（须 T1-T4 全落后——本波按执行顺序锁殿后）:
- tools/audit_type_hints.py 新机器闸（V7）: R1 无类型容器注解/R2 有值返回缺返回类型/
  R3 参数缺类型三规则+行级 # type-hint: ignore 显式白名单通道；产品码 core/data/presentation
- 存量收口: 368 处显式 Array/Dictionary 非参数化注解→机械参数化（Array[Variant]/
  Dictionary[Variant, Variant] 零行为面）；13 处参数真类型（SaveManagerCore/ConfigDb/
  BattleOrchestrator/MinesweeperRules/LevelRunner/SettingsStore 等）
- 白名单豁免四处: board_generator generate/_attempt/legality/_finalize 的 db 参——
  测量面 _BoardRowStub 冒烟夹具鸭子型注入（typed 参拒 stub）
- project.godot 拉起 gdscript/warnings/untyped_declaration=1（V7 源码断言在 smoke _smoke_type_gate）
- static_scan 新 S9 类型闸规则；顺修历史 cd 错位（9-24 布局迁移后 /.. 落 game/ 致守卫
  恒跳过静默空转——修复后 S1-S4/S9 首次实跑全绿）+S1/S2 增 ADR-0007-exempt 标记豁免通道
  （main _seed_value 引擎熵源=文档化豁免面）

验收: 冒烟 1081/0（+V7×2）+run_all 27 套+static_scan 全绿+probe click+render golden+对拍三变体全同
 2026-10-15 01:05:17 +08:00
DKChan 8b9e55673f refactor(迭代27 T4): 波四 ModalFlow 抽取+互斥域 tags 化+双 context——对拍全同 
P1-5/P2-7 组合根可测化+模态协议内聚（场景拆分后重估结论=抽取面收敛为模态编排域）:
- modal_flow.gd 新纯逻辑类: 依赖仅 ModalStack+查询 Callable（审计处方）——开合编排
  （挂起兜底/排播排空/遮挡记账/开合同步）/棋盘输入锁谓词（三例外注入）/双形制角标谓词；
  V6 modal_flow_test 19 断言直接 new() 进 run_all（26→27 套）——测试抓出并修正
  挂起兜底 divergent return 一处（原 main 语义=先结挂起后继续开本层不短路）
- ModalStack 互斥域随层登记: register(m, tags) + TAG_NON_LOCKING/TAG_SCREEN_STATE
  封闭词表 + has_open_excluding_tags 组查询；原 has_open_excluding/_any 调用点拼装退役
  （main 五处判据迁移）；main._modals=flow.stack（ui_struct _list 登记序断言缝保留）
- P1-5 控制器构造收拢 context: curio 16 参→CurioFlowContext/camp 13 参→CampFlowContext
  （字段逐一同名迁移，控制器可独立实例化）

验收: 对拍三变体全同；冒烟 1079/0+run_all 27 套+probe click+render golden 全绿
 2026-10-15 00:31:36 +08:00
DKChan 73db171cb4 T5(迭代22秘宝批): 存档面+死通道拆除——treasure_inventory保留注记(主动件骑库存承载在役:线香/天眼handle+断点aux_items快照+set_attune_charges差额注入全链保留); 替换子交互整体拆除(CURIO_KINDS除名后不可达死通道=装配不可变契约1实现面保证): adventure_runner六函数删(_pick_treasure_item/resolve_treasure_replace/_resolve_node_replace/_replace_in_transit/_draw_pending_treasure/resolve_curio_replace)+_bonus_treasure_carry跨关携带/_last_draw_treasure掷定链/_roll_from/_bonus_treasure_pool/bonus_aux_carry断点键; level_runner.grant_treasure_item/treasure_items.holding_records删; 呈现面=controller替换子态三函数+aux_detail卡片直显链/curio_pick_overlay replace状态机(信号+面板+open_replace)/main两接线/level_autoplay替换策略; smoke与ui_click_probe替换分支摘除+reward_overlay_test替换段摘除; 修正则贪吃误删=apply_node_curio普通兑付主体补回。冒烟895/0+run_all 22套+探针全绿〔秘宝批 V15/V16拆除路线/V13〕 2026-10-12 19:32:29 +08:00
DKChan a7bd4e4132 T2(迭代22秘宝批): 核心层解锁服务换代+槽位档位约束——工坊渠道面退役(_workshop_progress/workshop_status/refresh_workshop_unlocks/meta_workshop_items/WORKSHOP_ITEM_IDS/workshop_items行族全删)换解锁混合制(buy_treasure_unlock钥石购买=余额闸+重复购拒+条件件误购拒/refresh_treasure_unlocks条件刷新=AND谓词+幂等/treasure_shop_status柜台投影); 计数读数单点_treasure_unlock_progress(adventure_cleared/boss_kill_count/vision_used); save_manager新增vision_used生涯计数域(add_vision_used收束入账+缺键补零不升版本); toggle_attunement三重校验(未解锁拒+满位禁选+件档rank≤装入位序档位格——卸下恒可效果面只读装配集); pause/camp两视图秘宝匣呈现换代+UiKit计数键与档位标签单点; smoke工坊段换V3/V4/V5断言(独立档[11]防路径污染)+meta表段行族规模换代3/3/2。冒烟895/0+单元21套+探针全绿〔秘宝批 V3/V4/V5/V14/V19数据源〕 2026-10-12 15:52:04 +08:00
DKChan a33ddaf542 秘宝六件迁移+掘进蓄能受理闸数据化+令牌兑付 match 收敛进效果类型（T4+T5——内容数据驱动扩展批） 
T4 秘宝侧（六件按 id 硬编码全部拆除，行为与迁移前逐位一致）：
- 淬毒刃纹：begin_battle attune_venom 注入+伤害控制器特判分支拆除——行 triggers clamp_check
  modify(mode:clamp_bonus) 双订阅（pierce_vs_ward / magic_vs_heavy eq 行=旧「pierce|magic × 矩阵>0」
  的精确集；mode 路由=主角攻击面专享，棋盘克制窗只消费无模式 delta——棋盘不吃毒面保持）。
- 偏运硬币：reward_economy.luck_bias 注入拆除——行 triggers reward_roll bias_rewards 订阅，
  发射点命中合计经 _biased_cell_rows 入参（合成序「图级先件级后」不变）；冒烟偏斜段断言面随迁。
- 工兵晨令：编排器两处直调入队拆除——行 triggers round_start grant_ap(mode:queue) 订阅，
  when round_index ≤ effective_rounds（when value_from 行字段定影——新查询面，悬空校验同面补齐）。
- 惊巢反制：_grant_routed 按 id 减半特判拆除——mine_hit damage_mult(50) 订阅命中经 halve_pct
  入参（ceil(power×50%) 与旧 ceil(power/2) 逐位一致）+ open_ticket(channel:reflect) 订阅施加。
- 标中殉爆：flag_hit 按 id 开单特判拆除——行 triggers open_ticket(channel:blast, value_from
  magnitude) 订阅施加（施加位=迁移前开单位：殉爆→净化→图谱）。
- 掘进蓄能：use_treasure 按 id 受理闸特判拆除——treasure_used counter_spend 订阅施加（消耗成功
  才受理、积点不足拒绝零消耗，进度文案逐字保留）；积点账本迁效果引擎计数器 dig_charge_bank
  （模判定留编排器侧：「每 N 格积 1 点」在发射点施加架构下无法行内表达先增后判——when 于
  dispatch 预评估，逐位等价优先；词汇表边界注记留档，遗留观察项随出口报告呈报）。
- pick_refresh：adventure_runner 按 id 特判拆除——effect_kinds bonus_refresh kind 分发查询
  （装配集行 magnitude 合计；刷新件类加件零 id 分支）。
- 主动件 kind 词族换代（reveal_tiles/preview/grant_ap/remove_mines/refresh_pick）挂账保留：
  本批只要求 pick_refresh 合流；全词族 rename 波及库存/呈现/单测零行为收益，不随批（出口报告
  遗留人闸项呈报）。
- curio_interact_controller 秘宝卡片文案表值化：kind 硬编码映射拆除，读行 desc——13 件 desc
  补齐（措辞按现行卡片文本逐字迁移；掘进蓄能/失义件补实际摘要=文案微调呈报级）。
- schema 适配：triggers 与 effect_kinds 互斥校验收窄至 passive 行（active_charged 双形合法=
  effect_kinds 主动分发+triggers 受理闸）；trigger 行豁免「非 N 值 kind magnitude 应 0」与
  「非 ap_rounds_front 行 effective_rounds 应 0」两面（行字段=value_from 取数源）。

T5 令牌/树收尾：
- _apply_curio_pick match 收敛进效果类型：属性值提升四类（attack/max_hp/armor/ap）改
  adventure_table.CURIO_APPLY_ROUTES 声明路由（加算落点键，与效果引擎加法族同构）——加新加算类
  令牌=表行+配额/件值键零代码；gp/heal/refresh/relic 副作用通道面显式分支保留。
- meta_tree 规则键同面：先手压制/稳健拓荒两键已在 T3/T4 随 round_start/damage_taken 订阅行
  走效果引擎同面（rebuild 合成订阅+发射点施加），旧直调零残留。

验证：冒烟 800 项 0 失败（三闸过）· 单元 17 套全绿。

设计权威：design/research/研究-内容数据驱动扩展架构-2026-10-06.md（案乙）。
任务书：design/research/任务书-内容数据驱动扩展批-2026-10-06.md §六 T4/T5、§五映射表秘宝侧。
 2026-10-06 23:54:58 +08:00
DKChan 12807298eb feat: 三选一刷新对齐商店（2026-10-06 用户令）——免费双源 X/Y 用尽后 GP 付费档（同 shop_refresh_* 旋钮/同冒险钱包 spend_gp 单口/同 reward_pick 池重抽），付费刷计数每停点清零；CurioPickOverlay.set_refresh_display 与商店同构（钮常驻选择态/两源皆穷禁用/角标免费余量/价签行 GP 价）；通关停点刷新重发带 refreshed 标直落选择面不再重开胜利总结；店内门票专长三选一维持无刷新；单测 curio_refresh_paid_test+覆盖层刷新面断言；落文=秘宝.md 双源节 GP 付费档+冒险结构 v0.16+06 商店刷新条目换代（机制已落码态） 2026-10-06 07:03:57 +08:00
DKChan 059b545068 fix-curio-skip: 三选一空池降级（用户令 2026-10-06）——候选 0 件跳过环节不再死面卡死 
- core adventure_runner.skip_empty_curio():停点空候选消化出口——仅空候选放行,非空拒绝（零自动推进契约不破,正常消化仍只走 pick_curio/apply_node_curio 兑付）
- controller resume_if_pending():空候选不开选择面（空面无卡无钮=死面卡死成因）——消化停点后按上下文直落后续推进（level_clear=推进下一关/reward_node=回图选路/feat_ticket=关面回店,与 on_continue 分派同构）
- controller present_node_curio():奖励节点空池不开面不挂停点,兑付确认直落回图选路（auto-sim node_entered 内立即 continue_after_node 先例）
- controller on_presented() feat_ticket 分支末道防御（core _redeem_feat_ticket 空集守卫外）
- 候选 1-2 件少显路径既有零改动:_draw_curio_candidates 洗牌收集至池空为止（上限 curio_candidate_count=3）,卡片渲染按候选数遍历——本就是「有多少显多少」
 2026-10-06 04:37:22 +08:00
DKChan 95b66f0d60 奇物批T5+T6a：专长门票入表（schema四字段provisional 20%/2/1/5+域校验+runner保底/限购/出现三计数+节点与商店双注入(替换末位占一席,同scope取数零漂移)+拿到即开三入口分支(节点本地重绘/店内临时停点payload.context)+断点扩列两键向后兼容+shop.tres门票行base5+SHELF_KINDS扩+校验豁免+A5/A6断言7条）；T6a商店补回复heal行（默认原则：分类内成员都入该渠道池）+registry刷新边界写死（商店自身服务vs奇物授予重抽次数）；终局池读数断言4→6键适配（冒烟782/0） 2026-10-05 20:03:20 +08:00
DKChan 6812ebbb73 奇物批T3+T4：relic_*→feat_*词族全换（feat_table.gd/feats.tres/feats_engine.gd三文件改名+.uid+feat_flags/feat_id/feat_row等全token+config_db注册键feats两端+entities.yaml换代注记——kind值relic/身份前缀relic:/relics存档键/摘要键按数据契约保留）；T4渠道白名单过滤（_draw_curio_candidates(channel)：通关渠道只出专长/节点渠道零专长——过滤式不拆池，TIER_QUOTAS锚零改动，devour货架保底随渠道定位退役，迁移保feat_id，pick_curio测试feat_id透传；冒烟773/0+run_all 16全绿+断点往返PASS） 2026-10-05 19:28:20 +08:00
DKChan 8e2694de49 奇物批T2：运行层bonus_*→curio_*全族换词（_curio_pending/deck/taken/result/candidates+pick_curio/apply_node_curio/curio_choice_presented/curio_resolved等+两文件改名curio_interact_controller/curio_pick_overlay含.uid+CurioPickOverlay/CurioInteractController类名）；T2裁点甲案自裁=五存档键引号字面量禁改（全仓对拍六形态全等）；_bonus_treasure_carry按T0澄清剔除（秘宝语义）；非奇物bonus语义保全（加算区bonus/price_level_bonus/attack_bonus/bp_bonus等）；reward_overlay_test红转绿适配（M7 bcard换PanelContainer致c is Button恒0——改数_choice_box子节点数断言语义不变，run_all 16套全绿历史首次） 2026-10-05 18:44:51 +08:00