game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,897 Commits 23 Branches 0 Tags
98c61d50c3c07f2e15b94de48d4fcb9ea3466f63
Commit Graph
23 Commits
Author SHA1 Message Date
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
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 7cac0dc1ab feat(迭代26 T3): 三处 <4.5:1 文字位换墨+机检锚定 
- 立新 token 两枚（代拍板4·Q6 裁后落值，语义岗冲撞走反哺点③）：GOLD_BRIGHT #E0B860（金族亮档，
  敌顺位徽标①②③+重甲徽标，对舞台底 6.47:1）；HERO_BLUE_BRIGHT #7EBAF0（小人蓝亮档，
  魔法护甲徽标，5.88:1）；GOLD_DEEP/HERO_BLUE 常量本尊不动（standee:199 意图判据等在役）
- ap_bar_view.gd:77 RAP 反馈行 STONE_FAINT→STONE_DEEP（对 PANEL_DATA 5.98:1，旧 2.9:1 越带）
- 冒烟新增 _smoke_contrast_inks() 9 断言（V4：三处对比≥4.5:1+消费点原位锚+语义岗不动+旧墨清零）；
  冒烟 1031→1037/0；probe --click 全绿残留 0
 2026-10-14 05:31:26 +08:00
DKChan e0fd7cb8d7 iter16ui T6：P3甲FS_*六档字号档位表立项（CAPTION12/HINT14/BODY16/SUB18/TITLE24/H1=34）+全库裸字号归档107位点（就近映射；4动态位点除外；settlement_fx两处span错位写入当场修复）+11px六处提FS_CAPTION并入P11豁免清单+art-bible §7.4档位表与豁免清单落文（条带内读数=血数一处；caption档逐处清单）；轻闸冒烟782/0+三探针+layout全绿 2026-10-06 03:38:51 +08:00
DKChan 4e7aa83367 iter16ui T3：N2站桩纵向余量纪律（STANDEE_FOOT_MARGIN=12具名常量·名行基线box.y-1.0→-13·底座矩形收_pedestal_rect单一来源+content_rect读数面）+ui_struct_probe⑥standee断言族（内容矩形⊆舞台+底缘距≥8px；首跑抓左右6px容器边距系断言语义过严改任务书口径⊆+底≥8）；轻闸冒烟782/0+三探针绿 2026-10-06 03:12:01 +08:00
DKChan b38ae07707 iter16ui T2：N1对比度七处落码（血数HP_BAR_BACK垫牌14.3:1/意图四墨垫PANEL_DATA牌·atk零换墨·buf换HERO_BLUE_DEEP#1E5A96·charge换GOLD_INK#74500B/槽两态STONE_DEEP#554D41+INK_LABEL/RAP显式INK_LABEL零改值）+art-bible §7.4合并豁免条款（P11 caption 12px+血数条带内读数）+新增ui_contrast_probe入probe_gate默认段（11对测点+裸Color8白名单25处/10文件过渡表+preload红线静态扫描） 2026-10-06 03:04:59 +08:00
DKChan 54ac8759c9 T7 死代码与残留清扫段: 16项零争议死代码直删（equivalence_supply/pool_layers/index_of/has_variant/rows_by_pool/SUB_REASONS/ui_kit死色板五常量/reset_requested/set_legend_enabled/is_level_mode/legend.toggle/set_idle×2/COL_PATH/COL_INK/rebuild死守卫/_normalize合并/FACADE并档——删前逐项全仓grep零调用核实，next_candidates有level_autoplay调用存活未删=审计误报纠正）+T17归因件撤除（choices_dbg三段+t17dump两段，T17_LOCK_DEBUG全仓归零）+延迟三件（has_unrevealed下沉/is_item_unlocked访问器/rap残链snapshot面）+文档十件（过期注释/错挂注释/4242文案/README现行化/critical-paths道具窗口退役改写）；闸=冲烟636/0+run_all 15套+八探针全绿 2026-10-02 09:25:23 +08:00
DKChan 5584feb6e5 T4 UiKit色彩骨架收口段: modal_shell/modal_dim收10处overlay骨架（dim色/min_size/panel参数化对照表在报告，探针私有件同名同层级保留）+label加color参收全层两行式+裸色收口（standee/camp/stage/level_map/board_world Color8→UiKit档13色+HEX_LOG_*/HEX_ROUTE/SEED 13档——值逐字节不变）+杂并七件（UiKit.scaled收双实现/到达拍块合并/点阵合并/画布常数单点/瓦片词表单点化/占位文案const/with_bar判据/bonus内联lambda改具名）；ArmedConfirm三处语义异构降级记06（不做了半套）；闸=冲烟636/0+run_all 15套+八探针全绿+熵增闸PASS 2026-10-02 09:07:06 +08:00
DKChan 1ecad0b580 iter9-T6: 卡④ B 区舞台（圣经 §6.1 正面目标批 B4）——世界底层暗背景 Color8(62,52,42)+PANEL_BORDER 描边（替换浅石板皮）+顶光柱氛围层（四柱@1280 基准 110/900/1055/1210，暖光 60 段渐窄渐隐，bg<光柱<世界层序）+站桩石板地台落影（椭圆落影 α0.27+板身/描边/顶缘受光线=方向稿取色 150,130,100/90,76,58/196,172,132）+暗底双色墨制随迁（轮次标签/演出区文案/敌名行/轻甲图标切暖白族）；轻闸=冒烟 596/0+ui_input 十四断言+fx 全链+click 问题=0+layout 退出 0（中途 SCRIPT ERROR=for 循环 Variant 推断 typed 修复——探针挂死 20 分钟教训：解析错误致 probe 等 never signal） 2026-09-30 06:03:36 +08:00
DKChan 6578b284b1 feat(t5): 主角受击+死亡演出——拆两处早退,演出密度与敌方对等 
①battle_stage_view.on_step_row_fx hero 早退拆除:受击态+弹道到达拍(0.33s)闪白+打击火花+击杀塌陷(killed 行)——与敌方路径同构同密度;树外守卫即时执行
②main._play_cross_zone_fx hero 早退拆除:敌→主角伤害行 ⚔ 危险红弹道飞向主角站桩;crit 只加重字号不加金(金=收益/胜利语义位,不用于敌方输出——代拍板待追认)
③standee_body flash_hit 增 _flash_count 探针计数;fx_probe 扩第六段=主角受击路由(闪白计数增量+火花)与击杀塌陷断言(BattleStageView 实体级路由测试)
轻闸=冒烟 576/0+三探针 PASS
 2026-09-29 04:16:40 +08:00
DKChan 8723d9d826 feat(t4): 命中特效终稿+敌方演出链复核——打击火花六枚+弹道到达拍对齐 
①standee_body.play_hit_impact:立绘盒中心六枚短火花放射(程序化色块,确定性方向 i*60°,亮金GOLD_LIT/暖白WARM 交替=物理打击语义不占 危险红=雷/奖励金=收益 位;0.12s 一拍即回收);fx_probe 增 hit_sparks 计数+第六断言段
②弹道到达拍对齐:on_step_row_fx 敌方路径 闪白/火花/击杀塌陷 延迟 0.33s≈弹道飞行(0.16+0.19)——呈现链序=弹道→闪白+火花→血条→灰化;突发多定时器互不干扰(flash 重启/死亡幂等),卡片释放 is_instance_valid 守卫,树外即时执行
③flash_hit 强度时长复核=维持现行(1.6,1.4,1.2)/0.08s+回0.2s——白光可读不糊,±30% 白名单内零调整;④伤害飘字子项代拍板=不做(血条已有「当前/最大」即时数字面,飘字=同一伤害第二呈现触 UI 禁重复展示铁律;审计备注项未立项)
 2026-09-29 04:12:42 +08:00
DKChan cabb6b07bf feat(t3): 主角三态切换——portrait 换装 new-normal+attack/hit 入包+挂事件切换+结算回 idle 
①48px 档生成器默认补 attack/hit 两档(hero-ref/edit 1x 源→character_hero_attack/hit.png;new-hit.pxo 09-27 已程序导出 hit_1x 在位,U1 手出预案不触发);机检 11/11 过
②ui_kit 增 TEX_HERO_ATTACK/TEX_HERO_HIT;TEX_HERO_PORTRAIT 注记改 normal 态(48px 档换装)
③standee_body 状态机:register_hero_state(组合点注册,缺位不注册=该态保持现纹理)/set_hero_state(短驻 0.35s 自回 idle;未注册态保持)/hero_state_probe;_revive 增态回 idle;set_hero 增死亡残位复活(hp>0——敌侧 set_data 同款)
④battle_stage_view:三态注册+_init;on_step_row_fx 主角攻击行→attack 态/受击行→hit 态(闪白弹道归 T5 拆早退);settle_hero_idle 显式收尾挂 main 两侧 battle_finished/adventure_finished
⑤fx_probe 扩第五段:三态切换+短驻自回+死亡复活断言
轻闸=冒烟 576/0+三探针 PASS(编辑器刷缓存后)
 2026-09-29 04:09:13 +08:00
DKChan ac43e1333d feat(t2): 敌种立绘落位——八张真图服役+字形回退退役为纯缺位兜底+站桩纹理非空断言 
①八张 character_enemy_<键>.png 服役（T1 产物原位=ui_kit 常量名,worktree 本地不入 git）;朝向核证=八敌像素源朝左/正面,flip=false 呈现朝主角——battle_stage_view 旧注记「基准朝右」措辞失真随手修
②standee_body._portrait_glyph 三档体量字形(▂/▆/█)退役,保留 人/✕/敌 纯缺位兜底(C7 回退链保持);相对体量语义由 48px 档统一比例承载;新增 portrait_probe() 探针出口
③ui_probe 扩两断言(只增):敌站桩+主角站桩 portrait_probe().has_tex 全真
轻闸=冒烟 576/0+三探针 PASS(新 png --editor --quit 刷导入缓存后过)
 2026-09-29 04:02:59 +08:00
DKChan d458e393de feat(art): T3 演出密度终稿批——演出四项落码+fx_probe 新探针 
死亡碎裂(standee mark_dead 增五碎块抛物线弹飞 0.45s——§4.6.4 灰化+碎裂禁瞬间消失+§8.4 冻结值);意图三档动画终稿(§4.6.4:档①普通攻击零表示不变/档②特殊准备=弹入+二次弹跳高举/档③重击蓄力=缓推 1.22+定格微顿+回落——三档运动签名互异灰度可辨);胜利纹章(battle_end open_victory 蜡封落定后十碎砖自四周拼纹章环,驻留至 close——§2.4);失败掸灰(open_defeat 八尘絮飘落——§2.5)+既有旗光收回挂探针;结算轮光带终稿(加 2px 亮金前导缘线——§2.2 逐行横扫方向可读)。全部程序化 tween 零新帧资产,确定性散布禁全局随机,时长全走 UiKit.motion 减动效包装。
新探针 smoke/fx_probe.tscn+gd:死亡碎裂5/意图三档+零表示/纹章10/掸灰8+旗光8/光带+缘线 五断言全 PASS。
连带:图例旗条目名回退『旗』(click_probe 图例基线精确匹配;T1 曾改旗（封印印记）——封印语义移描述列,色 #000000 保留)。轻闸=冒烟 557/0+五探针(ui_input/ui_probe/click/tune/fx)全 PASS。
 2026-09-28 04:34:51 +08:00
DKChan e440360ea5 feat(art): 封印黑批(用户拍板 2026-09-28)——封印色 封印紫 #7C3AA8→封印黑 #000000(紫与微光蓝族色相冲突,黑无色相天然合规):UiKit.SEAL_PURPLE→SEAL_BLACK+board_view/board_fx_view 换色+胜利彩带紫位改亮金(紫赤 Boss 独占不入装饰)+样张脚本同步(旗面/图例/UIKIT 键)+字体素材路径随迁目录收敛(artwork/ui-reuse);文档七文件现行规则改封印黑(圣经 §4.1 条目重写+v2.11 行/character-design/comfyui/远程单 purple→black 十六进制重锁/清单/battle.md),历史注记与 v2.10 行按 ADR 纪律留痕不改;冒烟 557/0+ui_probe/ui_input_probe PASS+样张机检 12/12+doc 三闸零新增 2026-09-28 02:57:26 +08:00
DKChan 20c131c1a7 feat(art): seal purple batch -- flag color C63D22 -> 7C3AA8 (hue 267, ban-band safe); code 8-way split (seal items -> purple, attack/warn reds -> danger family, boss border -> boss purple) + docs 5 files + sample script sync + ledger 185 2026-09-27 02:12:12 +08:00
DKChan 9a4a900f9e fix(presentation): 错位修复+入场演出批——StandeeBody 字形/意图双重偏移修复(实机敌人立绘空白真因,截图复验)+BoardView 入场演出补实装(淡入 200ms+R0 涟漪,battle.md Transitions 欠账)+06 登记表现收口七项+台账 181 2026-09-26 19:46:09 +08:00
DKChan 9e6f06804e fix(presentation): 界面补数批——血量数字「当前/最大」落条（HUD框架 验收「血量数字可读」欠账+用户点名,白字深描边居中条带）+小人脚浮修正（素材透明留白致视觉脚悬空 12.75px,offset -16→-8.5 坐标推导留档）+台账 178 2026-09-26 16:47:23 +08:00
DKChan afeb6cacd2 feat(presentation): 站桩本体 Node2D 化（Phase B T3）——StandeeBody 世界精灵新件+StandeeView 退役删除+行为面 17 方法契约保持+伴随件壳层化（enemy_box 语义改写）+world_to_shell 单点同步+ui_probe 断言等价改写+台账 171 2026-09-26 05:07:36 +08:00