game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,347 Commits 23 Branches 0 Tags
5fd36a0db0eeb464d4b4b65c690881497bd8fdda
Commit Graph
24 Commits
Author SHA1 Message Date
DKChan c5a09fd90c refactor(改名批): 暂停层/暂停角标→状态面板/状态角标——用户令全量改名(文案4处+标识符全套PauseOverlay→StatusPanel/pause_overlay.gd→status_panel.gd/成员方法族+探针快照键+注释与探针消息86处清零;行为契约四件零动——只读R4/模态遮罩P2甲/输入锁R3/零动效P4甲)+render_gate截图键shot_pause→shot_status同步+文档六面(元进度v1.19/07/生涯/06条/architecture json+html;camp零命中;08-Alpha版本标准untracked禁碰留置)——冒烟938/0+run_all24套+probe --click/--full+render_gate全绿;rg 暂停|pause game/归零 2026-10-13 05:41:59 +08:00
DKChan 5d254f7e11 merge: master 并入分支（并行十八笔——active 清理批/改名批/奇物呈现批；冲突=active 快照与记录块手工融合，469 弃用上游清档口径、收口条顺延 476） 2026-10-12 14:28:50 +08:00
DKChan 74f97231fd docs(dev+gdd): 测试函数落码规范落 code-conventions §3.5 + 术语表开发流程两词条（逻辑验收方法论批，2026-10-11 用户裁） 2026-10-11 18:42:01 +08:00
DKChan ac19754374 docs(glossary): 退役词对照表全库强制清扫——正主→现行事实源130行+落籍→已入库79行（39文件194行，语境微调=权威文档/权威定义节/拼表制主选/入库注记等；对照性文本豁免保留）+五词终验零真残留+术语表v1.3+active 446（2026-10-11 用户令收尾） 2026-10-11 05:46:49 +08:00
DKChan 6951632d25 docs(glossary): 术语表建立+全库术语统一批——危险格/整图/专长凭证（2026-10-11 用户四裁）+秘宝.md v2.5 可读性审查批 
- 新建 design/gdd/术语表.md v1.0（四节术语+退役词对照；02 清单登记；用户令查表阅读）
- 全库更名：雷格/惩罚格→危险格（113 处）、雷安→危险格与安全格（39）、板级→整图（29）、门票→专长凭证（88）、雷位→危险格位置（5）；排雷玩法定义句换代+版本行
- 秘宝.md v2.5 可读性批：术语指路+黑话清扫（正主/落籍/P1甲死指针/charges/结构闸等）+承重契约白话化+验收分层白话化+两处过时事实修正（战斗道具窗口 2026-09-15 已下线/21 项义务死指针）+版本行序修复
 2026-10-11 03:56:12 +08:00
DKChan 933e1a9421 docs(conventions): 用语纪律落正面总则「见名知意，所见即所得」（2026-10-10 用户立规） 
正文三处：§4 标题补八字总则；开篇新增正面总则段（见名知意管名字、所见即所得管句子，注明管语义透明不与第 8 节指路存根冲突）；版本历史 v16 行。随批：active.md 状态记录 437 号。
 2026-10-10 18:33:48 +08:00
DKChan c848cefe9a docs(rules): 「工作日志」废止全仓改「状态记录」+会话状态清除新规+秘宝实装待办登记（2026-10-10 用户令） 
- 五文件 105 处「工作日志」→「状态记录」（active.md 31/doc-conventions 13/CLAUDE.md 5/06 10/roadmap 46；残留 2 处系更名动作引述保留）
- doc-conventions §10 章程：定性补「状态记录，不是工作日志——旧叫法废止」+退役规则首句落新规「用户确认任务完成时清除当前会话写过的状态条目——状态清除即任务完成证明」
- 06 新条「秘宝体系实现重构落地批」（冻结待发令）：新 15 件实装+旧数据行清理（deferred 清零）+27 专长行删除+空配置验收闸+池选型三案+效果引擎扩签核实+两疑似漏项 T0
 2026-10-10 15:17:08 +08:00
DKChan fa430f2584 docs(rules): 三段开发流程立规+文档同步闸v2——设计/写卡/实现三段出入口（2026-10-10 用户令） 
- CLAUDE.md 新增「三段开发流程」节：设计（用户点头心智模型一致才落文档+裁点清零才算完成）→写需求卡片（grilling 多轮复核零待裁+入库必登记 06）→实现（迭代号 U0+设计正主文档批内一律不更新）；批次工作流清单引言同步改指
- CLAUDE.md 批次工作流第 12 条改 v2：机械面文档（roadmap 行/registry/active.md/README/工具注）合并前随批同步不变；GDD/art-bible 等设计正主改走迭代实现报告反哺制——收口出迭代级实现报告（design/qa/iter<N>-实现报告-<日期>.md，含各卡状态+代拍板追认单+GDD 反哺点节），反哺点收口时登记 06，用户逐点裁决后另批落文
- doc-conventions §11 新增「迭代实现报告」行+「证据只留最新」措辞换代+版本历史 v15：实现报告属中间文档，替代原每卡出口报告

背景：武器锻造取证确认「迭代」曾被当作一切批次容器（迭代18卡③设计提案混进迭代通道）致「迭代完成了但游戏里没有」口径错位；用户立规依据=文档与用户想法等同对等，文档修改必须经用户同意，只出报告、同意后再更新。纯文档批零代码零测试（两入口铁规）
 2026-10-10 02:08:16 +08:00
DKChan bbc849eac5 docs(audit): 文档正确性审查·独立复核批（worktree docaudit-2026-10-09，基点 03c4b4c——18 文件语义级清漏，主区零触碰） 
R1 状态与证据对齐（全部代码实证）：
- 存档序列化 v2→v6 换代（save_manager.gd SAVE_FORMAT_VERSION=6 实证）：数据模型 JSON+域清单补 v4 同调三域/v5 树域/v6 生涯两域逐行 owner、版本与迁移节五件迁移链、调参表常量 6；v3-v6 四次升版当时均未回写本文，本批一次清偿（v1.4）
- 数据配置表清单四处失同步：变异表六行→七行（variation.tres 实测 7 行含贫矿脉）/RewardConfigTable 行删除（reward_config.tres 与类名全仓零命中）/AuxItemTable→TreasureItemTable（treasure_items.tres）/MetaTable 四行族→五行族（+attune_refresh_upgrade）+HeroTable 补 armor_class（v0.6）
- node-reward 令牌池六种→七种（adventure_table.gd CURIO_KINDS 实测七类含 refresh，curio_quota_refresh_rare=2 在役；v2.5 修订漏登，v2.6）
- interaction-patterns #19 inventory_panel_view.gd『已实现』系失实登记（git 全史零记录，从未入库）→占位失效
- level-clear『加权洗牌掷 3』漏网旧口径→令牌池洗牌不放回（与冒险结构 v0.14 对齐）
- 奇物依赖表 relics.tres→feats.tres（表文件已换代）+§1.3 异质性账清单对齐凭证件表（AP 上限摘除）（v3.10）

R3/R4 退役残留清漏：
- 行动经济依赖表『挖/插/拔』拔旗残留（v0.4 批漏网，v0.11）
- 地图战斗资源依赖表『秘宝的背包』同调形态残留（v0.22）
- 冒险结构『秘宝件受同调位约束』替换交互无现役触发面补注+『06 在册』悬空指针清偿（v0.19）
- HUD框架秘宝义务行『库存条常读』→装配件与充能常读（v0.15）
- 教学引导/P0 闭环/战斗结算/level-clear 等六处『秘宝背包/关卡末清库』补机械惰性承载注（treasure_inventory 代码实证在役但投放渠道全退役恒空、拆线归实装批——battle.md『无关卡域清库面』表述精确化）

R2 里程碑/批次口径：
- level-map 四处 M-1/M-2 前缀删（迭代 2 框材组=git 9abf5ff 实证；迭代 4 三处）
- 07『难度修正批』全替『数值批（Beta 阶段，未排期）』（v0.4）
- 教学引导『里程碑定位 Alpha』两处→Beta 阶段（2026-10-04 用户拍板漏同步，v0.5）
- HUD框架 P1『秘宝内容重定批』过期批次名→node-reward v2.5 在役

指路断链：
- 06 archive 死链改写（不入库目录表述）+两条『用户令删除』死条目整条移除（git 留痕）
- 07 三处伪死链去链接语法
- 奇物 §1.6 两处 ../ux/→../../ux/（v2.7 旧债，doc_link 复验清零）+06 欠账条目同步清偿注

规范两份：
- doc-conventions §1『现行文档不跑 lint』与现实对齐（gdd_lint=机检三闸之一在役，v14）
- code-conventions active.md 旧路径迁根目录+版本表补建（v2）

doc 三闸终验：doc_link 死链 4→1（剩 1=版本历史行内历史引文按纪律保留）；gdd_lint 5 不通过/doc_term 6 旗均与基线持平零新增
 2026-10-09 21:25:40 +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 7974e4a074 docs(architecture): 代码实现架构图 archify 交付——code-architecture HTML+可编辑 JSON 两件（showcase 9/9 闸 0错0警+三视口无溢出+视觉判官四轮收敛后 4/4 pass；节点=场景/autoload/视图/逻辑层 36 件全部实读自 game/ 工程，逻辑层 21 件仅列名；七条动作边含翻开·插旗·和弦→组合根→战斗编排器→结算回流主链；smoke 探针 13 场景不入图；单例层以裸节点+卡片承载语义） 2026-10-09 06:50:24 +08:00
DKChan 8e02dcf05b 清理: design/存量超期批——删86件（dev四组11+qa证据39=只留最新规首跑+research 34）+引用改写17处/15文件+doc-conventions §11新增证据只留最新（v13）+美术审计报告留置呈报（工作日志 413） 2026-10-09 03:58:50 +08:00
DKChan 442cd511a0 修复: design/结构批——diagrams 迁入 dev/architecture（案甲，熵增闸红灯清零）+旧档 GDD 引用全量摘除（31处/29文档+code/schema头注13文件+registry 5行）+doc双工具摘design/ux死路径（工作日志 412） 2026-10-09 03:29:09 +08:00
DKChan ffb0e36bcd docs: 另账修正批——悬空指路句13处+architecture旧API三处+06登记MC重锚（用户令『文档修改现在就修正』）——①docs/proposal-*两提案悬空引用13处（敌人系统4/战斗结算2/增益状态1/registry2/README2/unit_container/enemy_table/skill_table/smoke_all注释4处）改指路句〔提案已吸收退役git a6833b6a——事实源=敌人系统.md〕，系7f24b640三层收敛搬迁+a6833b6a死亡清单批漏改的登记遗留（7f24b640提交信息『余7条全为搬前幽灵链』）；②architecture.md活契约面三处旧API换代——:190调用序query_attack→apply_damage→advance改按摇定技能行兑现→apply_damage→commit_action+案C段内序、:152图示行stock/advance退役改伤害单据submit、:176 clear_inventory随库存轴下线退役改通关结算指路（:105/:222/:252系历史记录/已自带注记不动）；③06-待办清单新登记『旧行为MC行为锚全数作废——重锚归数值批』（用户确认系影响数值难度重要变量；归属M-4）；gdd_lint对基线零新增（8文件2存量） 2026-10-06 09:43:37 +08:00
DKChan dfd5fdd4df 秘宝批T2组C：architecture.md 两处既有断链清偿（../../design/gdd→../../gdd） 2026-10-05 08:27:11 +08:00
DKChan 430419cf01 消歧更名批：魔法道具 → 秘宝（仅文档层，代码零改动） 
用户拍板 2026-10-05。命名理由：「魔法」一词在本作已被征用为敌方侧
伤害/护甲语汇（magic_bolt 魔法矢 / magic_recoil 魔法反噬 / magic 魔法族
格面微光 / ward 魔法护甲），「魔法道具」易被读成"魔法属性的道具"；
「秘宝」取"神秘·强大·稀有"义，与九件内容气质（工兵/工程/手艺向）契合，
且与局内道具（奇物）不冲突。**同调位机制名保留不变**（attunement 仍为
DND 词，机制血统不受更名影响）。

改动面（26 个文件，仅 design/ 目录）：
- 正主重命名 systems/排雷循环/魔法道具.md → 秘宝.md，正文 17 处 + v0.9 版本行
- 称谓权威源 02-系统清单：文档树行 + 命名对照表 a5 行；英文代号
  AUXILIARY_ITEMS 沿用不变（代码标识符口径，另批对齐）
- registry/entities.yaml 30 处（referenced_by 九处 / owner 路径三处 /
  存档域注释 / 承重规则段）；文件头新增 2026-10-05 注记并还原
  2026-09-16 段旧名原文
- GDD 现行文档 16 个 + 美术 2 个 + 架构 1 个
- 历史定稿加名称已变更横幅（正文不改）：同调提案底稿（现行形态设计权威）、
  同调实施批任务书
- 修复 research 内 2 处指向旧文件名的活链接（历史文档不改称谓但链接须可达）

刻意保留旧名：8 处版本历史行 + 自造短语全量清单 16 处（出口即删的
中间审计底稿，改称谓会令统计失真）。

代码层零改动（用户明令），遗留欠债 4 项待可跑冒烟批次收口：
1. 代码标识符仍为 aux_* / AUXILIARY_ITEMS（auxiliary 词根为过渡形态遗留）
2. battle_narrator.gd:117-118 仍输出"魔法道具"，且与同文件 139 行
   arch_names["magic"]="魔法" 同屏两义共现——"魔法道具"进入玩家视野的
   唯一残余通道
3. bonus_interact_controller.gd:76 清空 toast 仍写"魔法道具"
4. Godot 类名与文件名（AuxItemTable 等）改需同步 .uid 与 .tscn 引用

校验：registry 键集合前后一致（214 键零丢失零新增，仅增 7 行注记）；
改动文件正文类零残留（残留 8 处全在版本历史/换名说明内）；owner 路径
全部可达；链接检查除 2 处既有欠债（architecture.md 的 ../../design/ 多一层，
改动前即存在）外零断链。

注：局内道具名「奇物」全仓 md 零命中，本批未碰，避免两个换名批纠缠。
 2026-10-05 06:50:44 +08:00
DKChan d8dc9b42a1 全局作用域变异首发批 T6 文档七正主（迭代14③号卡）：地形变异.md v0.7（类型清单+贫矿脉行/§全局作用域型语义节〔板级承载·替换制·兜底回落·恒定制·资源面偏斜·三层预告〕/「每图一型」板级推广/候选池门控第三维/布置段全局决议前置注记/调参表+验收/P1P2表Alpha行换代=撤2026-09-19留Alpha挂起/版本史+Q3知情代价注记）；难度曲线与Boss.md（P2全局投放计划行升级现行+调参表 resource_face 行=带A注册M-4禁独立调参）；registry=architecture.md variation 行换代（7行+三维门控+决议访问器）；HUD框架.md v0.13（义务来源清单+地形变异行三层预告+验收线）；教学引导.md v0.4（+Boss图整图变异说明行条目）；行动经济.md（P2地形成本修饰价目钩子=案D留位不启用注记）；06「全局作用域变异」条解决移除（去向=本批台账+git历史） 2026-10-04 17:52:50 +08:00
DKChan cc7952ce29 用语红线补强：自造词三形态禁令落文（2026-10-04用户令，黑话审计后——doc-conventions §4新增三种固定形态禁令表〔工作包代号/机制造词/流程造词，各带本仓反例与正确写法〕+通行检验标准+写后自查+v11版本历史；CLAUDE.md硬性红线新增用语红线一行） 2026-10-04 07:01:51 +08:00
DKChan 631b1dfe99 台账去压缩：废除active.md每条≤3行约束（2026-10-04用户立规「能看懂比字数少更重要」——doc-conventions §10改白话句子口径+第4节黑话禁令对台账同等生效+v10版本历史；CLAUDE.md会话进度记录行同步；起因=黑话审计证实≤3行压缩压力系自造缩略语繁殖地） 2026-10-04 06:56:08 +08:00
DKChan bd63a70754 docs: doc-conventions v9 新增§11文档生命周期吸收即死(2026-10-01用户立规)+CLAUDE.md硬性红线同款条目——中间文档寿命=迭代寿命/结论吸收进正主即删/未决先迁06与roadmap再死/永不入库/引用面口径/台账记结论/sim-data白名单/迭代出口清理项；顺手修文首与§10两处过期路径(docs/、production/)；三闸=基线零新增(死链增量3处系gitignored目标在fresh worktree不存在的环境差,06清单本批零改动) 2026-10-02 05:20:48 +08:00
DKChan 12e934be01 rulings: 试玩反馈两题裁决落文+doc-conventions 两条款成文——题一拍案甲视野迷雾（暗淡记忆态/半径8格同圈/提灯灯甲+微光不随扩/收窄后置）HUD框架「视野迷雾」正主节+v0.13；题二拍「不动」各案不采用留档；doc-conventions v8 增落位五要素+无正主不下定义+口径携带纪律 2026-09-30 06:59:44 +08:00
DKChan 24123616d8 feat(rng): 统一随机流批落地(ADR-0007 裁丙)——rng_service 七流并一+全事件日志:单盐单全局计数器+用途标签 open_stream(purpose) 不参与派生+derive_at(scope) 单参+事件日志会话制 rng_log_<seed>.jsonl;七消费点迁移+behavior_roll 子流派生向量退役(单敌轨迹独立复放面随退)+armor_roll_stream 降格纯标签;统一向量 8 常量重登记(scope0-3 与旧 board_gen 逐位连续);测试重锚(nat20/极性路由/L2max 改行为面扫描+ui_input_probe 移位扩边前置);冒烟 557/0+四探针全绿+MC20 局+日志落盘;数据配置 v0.5/registry 两实体/冒险结构 v0.10/节点图生成 v0.4 前置解除/ADR-0007 裁决落档+落地记录/CLAUDE.md 红线措辞/06 架构批条目解决移除 2026-09-27 20:01:29 +08:00
DKChan 137902fe92 design(node-map-gen): v0.3 ②③终裁落文+ADR-0007 评估书交付——②统一用一个流(两轮复裁终选,rng 架构批先行/特性排队,P0 补前置) ③特性内机制先行骨架随后;ADR-0007 核心发现=七流系同一主种子盐值分栏、字面目标现行已满足,待裁决=甲维持分栏/乙物理并流/丙并流+全事件日志(消费点七处+连带改动面清单在册);06 新立架构批条目 2026-09-27 17:23:05 +08:00
DKChan 7f24b640ea refactor: production 解散+docs 并入 design+tests 归 game 三层收敛——active.md/roadmap/stage/review-mode 升根目录;qa 报告→design/qa(gate-checks/alpha 验收/任务书→research);docs/→design/dev+registry 并档+散提案→research;tests/→game/tests(空架子 README+示例,真测试在 game/smoke);game/tools→tools+样例输出→sim-data;qa-data→sim-data;design/ux→gdd/ux;删 loop-dashboard.html(可再生成)+route_overlay_preview(零引用);钩子三件+loop_dashboard/balance_verifier/render_sample_sheet 路径随迁;断链修复 12 文件,余 7 条全为搬前幽灵链 2026-09-27 04:56:27 +08:00