game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,553 Commits 23 Branches 0 Tags
bbd49abfb012102cb288fa4031fee6ed83d78da2
Commit Graph
8 Commits
Author SHA1 Message Date
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 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 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 54ab330beb feat(feats): 迭代20 T3 专长 27+2 件换代（专长实装批 B段一） 
feats.tres 整表换代：旧 27 件删除（素材库表二退役面），重设计 29 行重建（基础 27+迁入
淬毒刃纹/封印爆裂——卡文 §10.4 推荐案件数口径）；订阅行 on/when/do=效果引擎封闭词表；
rarity 四级直映射令牌档（普通 12/优秀 9/稀有 8/传说 0）；cap 已拿上限字段（案②解耦）；
desc 禁「雷/插旗」字面（契约 6——封印/陷阱风味系）；dispatch 预评估口径「每第 N 次」按
N-1 落值（mod_eq ref/eq 阈值-1——effect_words_t1_test 钉住）。

feat_table schema 换代：RARITIES 四级；ROW_KEYS 摘 archetype 增 cap；流派扫雷铁律校验
随流派框架退役摘除（奇物.md v1「不设流派标签、不设档位机制」）。

battle_orchestrator：FeatsEngine 档位求值与 rider_tier 注入摘除（V14 旧实现删除覆盖——
散件单体效果=唯一形态）；FACTS 补 pct（处刑台血量阈值沿）。

smoke 特性段整段换代：牌库构成 29 件四级断言（V2）/契约静态钉扎（V18 牌库 kind 全集/
V19 零棋盘改写订阅/V21 禁字初筛/V22 结构锚形态机检半）/临时表新 schema 注入/门票与
relic 兑付断点主语换代/V3 附表 A 逐件三列断言 29 件（命中面 dispatch 直测+counter 落账
施加面同构 helper）；同调测试两处主语 venom_edge/flag_burst→nest_counter/dawn_order
（V14 换桩——T9 迁出 treasure_items 前置）。冒烟 863/0+run_all 20 套全绿。
 2026-10-11 23:58:48 +08:00
DKChan 03c4b4c933 docs: 文档正确性审查批+去毒+命名统一+天赋树成文等十一批落籍（2026-10-09 用户令） 
一、里程碑语义立规：M3=Alpha 完整实现/M4=Beta 完整实现，未明令关闭 M3 前只排 M3 需求（roadmap M-4 节头立规注+M-3 节头口径指针+迭代 21+ 行注+06 倍率差条注）；迭代 20/21/22 规划冻结（roadmap 迭代 20 行注——先解决眼前问题，重启=用户直接发令）
二、文档正确性审查批三波：全 GDD 29 份过审——状态记录按代码证据订正/里程碑删前缀（M-x+迭代N→迭代N，裸 M-4→Beta 阶段（未排期））/退役词退役件当现役清零/在役旧实现节加隔离横幅；重件=秘宝.md v1.7 老正文深层清算（横幅重写消「过渡形态已退役」误读/沿革节换代/六件旧件登记摘除/验收与 charges 矛盾订正）+奇物 v3.8+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线与Boss v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+00 v1.3+02 v1.16+03 v1.1+ux 八份（battle 23 处/camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map）
三、去毒批：奇物 v3.7（魔法道具→秘宝/档名三档→四级/门票与刷新「尚未入表」假话订正/验收第 3 条改令牌口径/资源成员指路凭证件表）+秘宝 v1.6（速览旧目录退役标注/退役件示例换现役）
四、道具退役素材库新建（design/research/道具退役素材库.md，案乙已追认）：秘宝退役 9 件含去向+专长退役 27 件名单+待核 4 行；魔法提灯（fog_lantern）裁退役（06 条目已裁+秘宝.md 注记换代+素材库迁表一；拆线归实装批）
五、B2/B3/B4 裁决落文：元进度.md 道具工坊行删旧写新（v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级）；奇物.md P1「两项合成高阶项」注销（v3.9——用户定性脏信息）；§3 刷新句按最新口径换代（刷新券替代、不进持有集）
六、天赋树独立成文（B1 裁决）：新建 design/gdd/systems/跨局循环/天赋树.md v0.1（33 节点机制全按 meta_tree.tres 实态+迭代 12 落籍裁决+被删底稿 git 取证——脊柱行门槛/钥石单币/Fork A/B 面/存档 v5 域/注入双通道）+元进度.md 定名节换代（v1.11）+02-系统清单跨局循环区加行（v1.17）
七、A 类卫生包：版本历史表理排四份（秘宝/奇物含 v2.7 断裂行修复/敌人系统/图生成，只调行序）+缺号注记三处（增益状态 v0.6 未考/冒险结构 v0.15/关卡节点地图 v1.6=MC-1 批）+node-reward v2.2 双号改 a/b+07 补建版本历史表+06 删「设置与本地化」空节+「文档/结构闸存量欠账」块挪文末「文档与结构」节+「L1 商店编排」两悬空指针改指 GP 换算失衡条+难度曲线两处过期指向核销注记（v0.27）+B5「现役 UI/文案两处自相冲突」登记 06 待办（battle_narrator.gd:160 旧话/hero_info_panel 两段同标「特性」——随后续迭代修）
八、命名统一（用户令「任务书」全库改「需求卡片」）：167 文件约 800 处（design/ 全部文档+roadmap+CLAUDE.md+active.md+entities.yaml+game/ 注释与数据批注）；两文件改名（需求卡片-M4数值批/需求卡片-冒险前资源配比预设批）；残留=自造短语全量清单（黑话证据文档故意跳过）
九、CLAUDE.md：批次工作流标准清单收口段新增第 12 条「文档同步闸」（需求卡片必列关联文档同步面、合并前同步完毕方算收口，原 12/13 顺延）；呈报六问铁规适用范围补立（前序批随批落籍）
十、active.md 快照节+工作日志 414-421（并行会话 416 黑话清扫条目按共享工作日志惯例一并入库）；06 中并行会话「active.md 定性与裁剪」条目未提交，按零吞并纪律留在工作区未入库

零测试（文档批两入口铁规）；主区前序脏件（.gitignore/.zcode/config.json/playnote/project.godot/.zcodeignore/美术审计报告 html 等）未带
 2026-10-09 19:12:46 +08:00
DKChan e28a6cb3c4 专长迁移完成：27 行 triggers 订阅形态全量生效+旧 23 挂点枚举消亡+消费点拆除+断言面随迁（T3——内容数据驱动扩展批） 
接手前任中断的 T3 半成品（脏文件三件：battle_orchestrator/effects engine/feats.tres），方向核实无误后续做收口；
承接修正四处随本提交留痕：①perfect_defense 的 when 用了 fact 封闭 9 项外的 flags_hit_all（装载校验必红）——
改 flags_count gte 1 保守判定，全中闸=flag_settle 发射点施加面承载（载荷字段仅供观测）；②has 算子语义与行
不匹配（数组包含对 String 恒假）——落非空在场判定（value 缺省）+数组包含（value 给定），查询面落法=代拍板
白名单；③前任漏写 _harmful_adjacent 助手（flag_hit 发射点调用必炸）；④counter_add set 键语义 bool() 吞 0
（清零行 set:0 被当 false 走加零通道）——改 has(set) 置值模式，四处施加点同修。

本提交主干（专长族全量迁移——任务书 §六 T3）：
- damage_controller：feat_flags 旗面整体退役，五事件施加面接线——attack_commit 命中随单据 context 携带
  （发射点=开单入口，任务书 §3.1 定稿位；主角攻击单恒段内首单，开单现场=结账现场），rider/改写/加值/
  段数/状态五族按迁移前算序施加（重锤两拍/专注/spike 恒全额/猎弱移档/魔网湛蓝猎手克制直调/整备每层
  +1/厚积满层倍乘/奥术+猎巢+执拗 rider 合计后档位暴击）；armor_roll 免掷恒折扣、clamp_check 双面
  （hero+board_typed）delta 窗口、kill 溢出弹射（landed×value%）、damage_taken shield 加法族合计。
  _feat_clamp_bonus/13 处旗消费点拆除。
- battle_orchestrator：_combat_segment 换代（dig_streak/charge_layers 注伤害控制器运行态；连珠矢段数
  施加位紧随主角攻击单开立=迁移前开单位，flush 兑现序逐位一致）；round_start 发射位前移至行动经济轮
  切换前（树规则 grant_ap queue 当轮入队当轮兑现——先手压制首轮语义锚）；深挖快照滚动拆除（计数器
  reset_at 声明承载）；熔火/连击旧计数变量退役。
- action_economy：feat_ap_carry/feat_dig_extra/deep_paid_count 旧注入旗拆除；dig_paid 施加面落地
  （counter_spend 对价：AP 富余付全价积计数、不足 fallback 只付基础 1——2026-10-04 降级口径逐位保留）。
- feat_table schema：HOOKS 23 挂点枚举/MINE_HOOKS/EFFECT_KEYS/hook+effects 双形态校验全删——triggers
  订阅形态唯一合法行形（行键白名单收口 feat_id/display_name/rarity/archetype/triggers/desc/note）。
- feats_engine：hooks_for 挂点投影退役（订阅装载序=feats 表序，由效果引擎 rebuild 承载）。
- battle_narrator：专长卡片文案表值化（summaries 硬编码映射拆除，读行 desc——27 件措辞逐字迁移）。
- smoke 断言面随迁（任务书 v1.1 补列项）：构造表 5 行换代 triggers 形态；挂点投影断言换代订阅装载面；
  ④-⑧ 求值断言（_feat_flags_for 直呼+旗读数）全量改写为 rebuild+dispatch 命中面（27 件逐事件覆盖）；
  深挖钻头付费开掘回归闸改 counter_spend 计数器面；特性卡 desc 直读断言新增。

映射表对拍注记（行为等价优先，.tres 尾注同步留痕）：猎巢人/矿工的执拗映射表标 modify_ticket/attack_bonus，
现行为必中附加通道（hero_rider 后置于乘区与下限）——落 add_ticket_rider（per 取数载荷）；整备军备现行为
双效果（轮末转蓄力+每层首段攻 +1）——两行订阅；深挖钻头 per-round 计数器对（paid/given）复刻旧 v2
跨轮不对称语义（given 不随轮重置）。

验证：冒烟 800 项 0 失败（三闸过）· 单元 17 套全绿 · S1 魔法流对拍预检=MC formed/off 两态与 T0 pre 锚
（83000 种子段）同种子逐位一致（2×5 局，三档只测不判）——14 件迁移行实战斗承载零分岔。

设计权威：design/research/研究-内容数据驱动扩展架构-2026-10-06.md（案乙）。
任务书：design/research/任务书-内容数据驱动扩展批-2026-10-06.md §六 T3、§五映射表、§七契约 2/4。
 2026-10-06 23:20:05 +08:00
DKChan 225765f3f7 词汇表落码：feats/treasure 两表 trigger 订阅形态 schema 换代+护栏迁移（T2——内容数据驱动扩展批） 
schema 校验换代，数据行迁移前共存过渡（旧 hook/effect_kinds 校验保留，行为零变——冒烟 783 项 0 失败）：

FeatTable：
- 行字段换代目标 hook/effects → triggers:[{on,when,do}]（订阅哪个事件/什么条件/什么效果）
- triggers 校验收口 EffectEngine.validate_trigger_row 静态方法（单一事实源——事件/效果/fact/算子
  四词表全引用 EffectEngine 闭集常量，禁本表复抄）
- 行键白名单扩 triggers/desc（文案表值化预留）
- 悬空引用校验：do.value_from/delta_from/mult_from/cap_from 引用的行字段不存在=加载致命
- 🔴 流派扫雷触发铁律新形态：每流派 ≥1 行订阅扫雷侧事件（MINE_EVENTS=dig_reveal/dig_paid/
  flag_hit/mine_hit/flag_settle/round_end/reward_roll）或旧形态 hook∈MINE_HOOKS——流派级聚合判定
- triggers 与 hook 禁并存（换代单形态）；缺两者=行错误

TreasureItemTable：
- 行键白名单扩 triggers/desc；passive 行 triggers 与 effect_kinds 禁并存
- 主动件 kind 词族换代挂账：新词 reveal_tiles/preview/grant_ap/remove_mines/refresh_pick
  （效果引擎 ACTIVE_KINDS 同名闭集）入 EFFECT_KINDS 与旧词共存至 T4 迁移完成

EffectEngine 补 validate_trigger_row 静态校验面（schema 共用）。

fact 条件词汇 9 项封闭落码核对：迁移设计全部现状条件可装入 9 项（matchup/is_first_dig_of_battle/
terrain_kind/target_armor_class/flags_count/charge_layers/nest_count/round_index/counter）——
未触发闭集缺口停机点。
 2026-10-06 21:44:01 +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