From 442cd511a030f9ca9b362ef1effcfc6f8c9acd88 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Fri, 9 Oct 2026 03:29:09 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D:=20design/=E7=BB=93=E6=9E=84?= =?UTF-8?q?=E6=89=B9=E2=80=94=E2=80=94diagrams=20=E8=BF=81=E5=85=A5=20dev/?= =?UTF-8?q?architecture=EF=BC=88=E6=A1=88=E7=94=B2=EF=BC=8C=E7=86=B5?= =?UTF-8?q?=E5=A2=9E=E9=97=B8=E7=BA=A2=E7=81=AF=E6=B8=85=E9=9B=B6=EF=BC=89?= =?UTF-8?q?+=E6=97=A7=E6=A1=A3=20GDD=20=E5=BC=95=E7=94=A8=E5=85=A8?= =?UTF-8?q?=E9=87=8F=E6=91=98=E9=99=A4=EF=BC=8831=E5=A4=84/29=E6=96=87?= =?UTF-8?q?=E6=A1=A3+code/schema=E5=A4=B4=E6=B3=A813=E6=96=87=E4=BB=B6+reg?= =?UTF-8?q?istry=205=E8=A1=8C=EF=BC=89+doc=E5=8F=8C=E5=B7=A5=E5=85=B7?= =?UTF-8?q?=E6=91=98design/ux=E6=AD=BB=E8=B7=AF=E5=BE=84=EF=BC=88=E5=B7=A5?= =?UTF-8?q?=E4=BD=9C=E6=97=A5=E5=BF=97=20412=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 3 +-- active.md | 2 ++ .../architecture}/gdd-architecture.html | 0 .../architecture}/gdd-architecture.json | 2 +- design/dev/code-conventions.md | 2 +- design/dev/doc-conventions.md | 2 +- design/gdd/00-游戏概念.md | 2 -- design/gdd/01-核心循环.md | 2 -- design/gdd/02-系统清单.md | 5 ++--- design/gdd/03-内容规模.md | 2 -- design/gdd/04-美术音频方向.md | 2 -- design/gdd/05-不做清单.md | 2 -- design/gdd/06-待办清单.md | 3 +-- design/gdd/systems/冒险循环/关卡节点地图.md | 1 - design/gdd/systems/冒险循环/冒险结构.md | 1 - design/gdd/systems/冒险循环/难度曲线与Boss.md | 1 - design/gdd/systems/战斗循环/地图战斗资源.md | 1 - design/gdd/systems/战斗循环/增益状态.md | 1 - design/gdd/systems/战斗循环/战斗结算.md | 1 - design/gdd/systems/战斗循环/战斗表现.md | 1 - design/gdd/systems/战斗循环/敌人系统.md | 1 - design/gdd/systems/排雷循环/地形变异.md | 1 - design/gdd/systems/排雷循环/排雷玩法.md | 1 - design/gdd/systems/排雷循环/棋盘生成.md | 1 - design/gdd/systems/排雷循环/秘宝.md | 1 - design/gdd/systems/排雷循环/行动经济.md | 1 - design/gdd/systems/表现与支撑/HUD框架.md | 1 - design/gdd/systems/表现与支撑/存档序列化.md | 1 - design/gdd/systems/表现与支撑/教学引导.md | 1 - design/gdd/systems/表现与支撑/数据配置.md | 1 - design/gdd/systems/表现与支撑/设置与本地化.md | 1 - design/gdd/systems/表现与支撑/音频.md | 1 - design/gdd/systems/跨局循环/元进度.md | 1 - design/registry/entities.yaml | 10 +++++----- game/core/action_economy.gd | 2 +- game/core/board_data.gd | 2 +- game/core/board_generator.gd | 2 +- game/core/config_db.gd | 2 +- game/core/config_db_cross_validator.gd | 2 +- game/core/config_db_resolver.gd | 2 +- game/core/damage_math.gd | 2 +- game/core/minesweeper_rules.gd | 2 +- game/core/rng_service.gd | 2 +- game/core/status_container.gd | 2 +- game/data/schemas/action_economy_table.gd | 2 +- game/data/schemas/board_gen_table.gd | 2 +- game/data/schemas/status_effect_table.gd | 2 +- tools/doc_link_audit.py | 6 +++--- tools/doc_term_audit.py | 4 ++-- 49 files changed, 32 insertions(+), 63 deletions(-) rename design/{diagrams => dev/architecture}/gdd-architecture.html (100%) rename design/{diagrams => dev/architecture}/gdd-architecture.json (98%) diff --git a/CLAUDE.md b/CLAUDE.md index f00cbd70..1ff53ce9 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,7 +1,7 @@ # Dungeon Sweeper（扫雷 × 自动战斗 闯关 Roguelike） 扫雷推理层 + 自动战斗结算的两段式回合 Roguelike。个人开发，MVP 优先管线。 -设计入口：`design/gdd/02-系统清单.md`（根索引）· 概念：`design/gdd/00-游戏概念.md` · 旧版 GDD 归档（只读参考）：`design/archive/gdd-2026-09-14/` +设计入口：`design/gdd/02-系统清单.md`（根索引）· 概念：`design/gdd/00-游戏概念.md` > 本文件只保留全局元信息与硬性红线；一切领域细则在子文档，动手前先查「规范导航」。 @@ -28,7 +28,6 @@ ## Project Layout - `design/gdd/` — 现行设计文档树（根索引 `02-系统清单.md`；文档增删必须同步它；`gdd/ux/` 战斗画面与交互规格） -- `design/archive/gdd-2026-09-14/` — 旧版 GDD 归档（只读参考，不作事实引用） - `design/registry/` — 跨系统事实登记（entities.yaml 术语与已锁数值、architecture.yaml 架构登记） - `design/art/` — 美术**纯文档**：定稿规范 md（圣经/清单/提示词卡）+ `references/` 参考池；评估/调研 md 一律 `design/research/`；**不放任何图片** - `design/dev/` — 工程规范：code-conventions / doc-conventions / architecture(ADR) / engine-reference diff --git a/active.md b/active.md index a46f361e..a8ecd1a2 100644 --- a/active.md +++ b/active.md @@ -11,6 +11,7 @@ - **工程路线图**：`production/roadmap.md`（2026-09-17 建——里程碑时间线 + 路线图；实时状态看下方快照节） ## 当前状态快照（收口批先更新本节，再追加台账；≤10 行） +- **更新于**：2026-10-09（**design/ 结构问题三连修落籍 master**，用户三令直批——主区直接批纯文档+doc 工具扫描列表，零测试〔非 loop 批未点名〕，工作日志 412）：①案甲 design/diagrams 消灭——gdd-architecture.html/json 迁 design/dev/architecture/（json 自引用随迁改正），熵增闸子目录越界红灯清零、白名单零改动；②旧档 GDD 引用全量摘除——design/archive/gdd-2026-09-14/（9f1507dc 已删）指涉 31 处/29 文件+代码头注与 schema 头注 13 文件+registry 评审日志死指路 5 处清零（「旧版参考」死链行 25 文件/CLAUDE.md 两处/02 旧代号句改写+旧骨架索引行摘〔版本行 v1.15〕/doc-conventions §9 列项删〔v12〕/code-conventions §1.4 头注示例换代/code+schema 头注十三文件同步换代/entities.yaml 五行历史注记化）；③doc_link/doc_term_audit 扫描列表摘 design/ux 死路径（7f24b640 搬迁残留）。闸=熵增闸转绿+doc 三闸基线零新增；纯删行文件不加版本行（断链修复先例，本行即记录）；并行未提交落文零吞并（选择性暂存）。 - **更新于**：2026-10-07（**天赋树货币甲案修复+卡③提案S2纠偏批落籍 master 3b86c9b**，worktree g-plan2-iter18-treefix 三提交 d7a6406/30154e5/129c21c+主区 merge --no-ff 零冲突，工作日志 396；零行为变更静态批）：树全钥石单币落定（2026-10-07 用户裁「按甲方案修复完」——meta_tree.tres 脊柱 16 行 gp→keystone+schema 枚举 {keystone,free}+tree_buy 直走 spend_keystone+购买钮「购买 N 钥石」+meta.tres 陈旧注释订正，T8 双币骨架披露销账）；卡③提案 v1.1 货币前提全案订正（5b/5c 换代钥石口径+修订记录）；主区落籍闸=冒烟 834/0+probe_gate --click 全绿；MC 零跑静态论证 - **更新于**：2026-10-07（**迭代 18 四卡全部落籍+总收口**，goal 编排会话：③ de067ae〔台账 391〕/⑤ 0dbe3c3〔392〕/⑦ b91b973〔393〕/④ b98ea83〔394〕+总条 395；Wave 1 三卡并行+④ 硬等⑦落籍后串行；主区终态=冒烟 834/0〔本迭代 811→834〕+probe_gate 全绿+layout/tune exit0）：**待用户三件**=①卡③ 提案 17 裁点盘问裁决（异步；design/qa/iter18-forge-exit-report-2026-10-07.md §四）②实机目检总清单（design/qa/迭代18-实机目检总清单-2026-10-07.md：⑤四项/⑦八项/④六项）③卡⑦代拍板追认六项+卡④追认十一项；卡⑤ MC 取证顺延 Alpha 收官 M4 数值批届时另令，M4 保持 Alpha 收官位未排期待发令 - **更新于**：2026-10-07（**迭代18卡⑦种子随机化与调试浮窗升级批落籍 master b91b973**，worktree g-plan2-iter18-seed 六提交（含 b159d77 分支并入 master 解 roadmap 相邻行冲突）+主区 merge --no-ff，工作日志 393）：种子三分单点（显式优先/首局恒 42/空框随机）+浮窗升级四件（DS_DEBUG 启动即开/角标迁宿主两屏/登记制维持/当局数据六项只读）+输入锁死防护；主区落籍闸=冒烟 814/0+probe_gate --click 全绿+layout exit0+tune 专闸 exit0。四卡进度=③⑤⑦✅落籍/④Wave 2 开工（④⑦同 main.gd 串行门已解） @@ -915,3 +916,4 @@ 406. **迭代 19 五卡 goal 总收口（2026-10-08，编排会话）**：五卡+尾裁微批全部落籍 master（卡⓪ 9160942/卡③ 568101b/卡② rebase 后合并/卡④ stash 避让合并/卡① rebase+CLAUDE.md stash 避让合并/微批 4a35046）；六项用户裁决全落（卡④行字段按推荐全收/卡②甲修复批/卡①甲清障续跑/卡⓪甲 resume 受理/卡③甲 chickensoft/裁点②甲 ui_layout 入 CI=总收口批接线）；新重闸口径主区首跑全量=冒烟 846/0 三闸过+probe_gate 默认/--click/--full 七探针全绿残留 0+render_gate 全绿（shot_checker A-D 过+fx 7 帧+board L1-L3+golden 0.00%×3）+run_all 18 套全绿；doc 三闸/熵增首跑翻出存量欠账 7 件〔gdd_lint 比例 3+熵增 diagrams+奇物双死链+拔旗术语旗；经 T0 基点复测确认非本迭代新增，仅数据配置 v0.4 历史行死链系卡①删件连带=已入 doc_link_known.txt 登记〕全部登记 06 交后续批；交付=design/qa/iter19-acceptance-package-2026-10-08.md（实机目检总清单+代拍板追认单八项）；stage.txt 换代 M-4 Iteration 19 Closed；worktree 卡⓪①②③④+微批全部清场；并行会话共存记录=道具批 6e05446 与秘宝.md/CLAUDE.md 在飞 WIP 经三次 stash 避让零丢失。 411. **06-待办清单存量条目清理批（2026-10-09，用户令=「已完成的东西未从待办清单删除→删除修正完」〔本会话答复制证后当场授权〕；纯文档零代码零测试；.zcode 补丁法主区落盘未提交）**：按 06 头部「事项解决后从本清单移除（2026-09-18 口径，git 历史即留痕）」删已解决未移除条目九条——①render_gate 首跑 S1 存量红三件（用户 2026-10-08 裁甲清障 a623ec3 落籍+render_gate 转绿 golden 三连跑 0.00%，条目状态行未随批换代=本批清理成因）②内容数据驱动扩展批·迭代17头卡（e535436 已并 master，状态行「待合并」滞后；遗留两项去向=dig_charge 积点模判定边界随道具退役批删行消解+主动件 kind 词族改名呈报级存 exit report 与提交说明 a33ddaf）③菜单开局未传同调装配与局外树规则（✅9160942 落籍+遗留 resume tree_rules 随尾裁微批 768e366 闭环，双重完成）④关卡开场行攻血初始表值（卡⓪②随 9160942 已落「开场行改传生效值」，状态行「待开工」滞后）⑤奇物命名统一后续（未完四件全闭=⓪curio_* 已换代 adventure.tres curio_quota_* 实测/①relic→feat 随 6812ebb/②运行层 bonus_*→curio_* 随 8e2694d/③存档键按数据契约保留系 iter15③ 在册裁决）⑥挖掘风险不等式对账破线（条目自记 2026-10-05 正式收口，残留三面已迁 registry clause3_inequality+难度曲线联动表+6 行+δ 判读随 mineq exit report）⑦同深度第二敌种与精英/Boss 编码位（iter17 卡①已实施完成；遗留首批混编已随迭代18卡⑤落表+Boss 多行第二批义务登记 07「后续内容批义务」节）⑧UI 原型 demo 结构级差异三项（自记已全部落地 2026-10-06 UI 对齐批 2ca6288 链）⑨全屏 UI 审计差距清单（自记六项已闭环+遗留已判定归各自在册条目）。去向依据=各批台账与出口报告（git 历史留痕）。**保留面披露**：呈现层残余<4.5:1 文字位维持待办（其清单系 B 区站桩名行/敌顺位徽标/RAP 反馈行等 ui_contrast 测点对面外邻接位，非尾裁微批所修 7 项）；生涯界面（期二/期三+P6 待点名）/武器锻造提案（17 裁点待人盘问）/解锁界面交互形态（待人闸目检）等待裁待人条目全数保留。本笔=台账 411。 +412. **design/ 结构问题三连修（2026-10-09，用户三令：①diagrams 案甲 ②旧档引用摘除 ③ux 工具路径清理；主区直接批——worktree 合并被共同脏文件阻塞，改选择性暂存只落本批改动，并行未提交落文零吞并；台账号顺延 410/411 并行占用）**：①design/diagrams/ 消灭——gdd-architecture.html/json 两件 git mv 入 design/dev/architecture/（图像白名单既有合法区），json 内部自引用路径随迁改正，熵增闸「design/ 子目录越界」存量红灯清零、两处白名单零改动；②design/archive/gdd-2026-09-14/ 引用全量摘除（目录本体 9f1507dc 已删；引用面 31 处/29 文档+代码头注 10 文件+schema 头注 3 文件+entities.yaml 5 行）：「旧版参考」blockquote 死链行 25 文件整行摘、CLAUDE.md 设计入口子句+Project Layout 行两处摘、02-系统清单「旧代号」句去归档指涉+旧骨架索引参考行整行摘（版本行 v1.15）、doc-conventions §9 归档列项删（版本行 v12）、code-conventions §1.4 头注示例 design/archive/... 换代 design/gdd/systems/ 现行路径、game/core+data/schemas 十三文件头注路径同步换代（a1/a2/a3/b1/b3/d2 六映射，注释层零行为）、entities.yaml 五行评审日志死指路改历史注记；③doc_link_audit.py/doc_term_audit.py DEFAULT_DIRS 摘 design/ux 死路径（7f24b640 design/ux→gdd/ux 搬迁残留，rglob 对不存在路径静默空扫）+docstring 口径句同步。**验证**=熵增闸 1 红→0；doc_link/doc_term/gdd_lint 对基线零新增。06「文档/结构闸存量欠账」节熵增 diagrams 条销号+归属句去 diagrams 尾巴；dev/architecture 旧 concept-map 8 件与 research/qa 存量超期=审计已呈报、用户示下次再议（未动））。 diff --git a/design/diagrams/gdd-architecture.html b/design/dev/architecture/gdd-architecture.html similarity index 100% rename from design/diagrams/gdd-architecture.html rename to design/dev/architecture/gdd-architecture.html diff --git a/design/diagrams/gdd-architecture.json b/design/dev/architecture/gdd-architecture.json similarity index 98% rename from design/diagrams/gdd-architecture.json rename to design/dev/architecture/gdd-architecture.json index 2e08d3ce..b165f26e 100644 --- a/design/diagrams/gdd-architecture.json +++ b/design/dev/architecture/gdd-architecture.json @@ -3,7 +3,7 @@ "diagram_type": "architecture", "meta": { "title": "Dungeon Sweeper 系统架构总图", - "output": "design/diagrams/gdd-architecture.html", + "output": "design/dev/architecture/gdd-architecture.html", "quality_profile": "showcase", "locale": "zh-CN" }, diff --git a/design/dev/code-conventions.md b/design/dev/code-conventions.md index 835d158e..73cfb628 100644 --- a/design/dev/code-conventions.md +++ b/design/dev/code-conventions.md @@ -34,7 +34,7 @@ ### 1.4 命名 = 领域命名，禁止系统 ID 前缀 文件名与类名禁止 `a1_`/`b1_`/`c1_` 等系统 ID 前缀（`a1_board_generator.gd` → `board_generator.gd`）。 设计追溯不靠前缀：每个核心实现文件头注必须带一行 -`# 实现 GDD：design/archive/gdd-2026-09-14/-.md（系统 ID Xn）`（2026-09-14 起旧 GDD 体系封存于归档，头注指归档路径；对应新 systems 文档定稿后再改指 `design/gdd/systems/` 新文档）；系统 ID 只作为文档与 registry 的追溯锚。 +`# 实现 GDD：design/gdd/systems/<循环>/<系统文档>.md（系统 ID Xn）`；系统 ID 只作为文档与 registry 的追溯锚。 豁免：D2 schema 类与 autoload（本就领域命名）；文档/夹具登记名（如 b4_golden）属文档层。 > **反面案例（2026-09-11，用户："是没有代码规范吗"）**：ID 前缀是跟随 GDD 文档名的事实约定， diff --git a/design/dev/doc-conventions.md b/design/dev/doc-conventions.md index baff6545..4afa56de 100644 --- a/design/dev/doc-conventions.md +++ b/design/dev/doc-conventions.md @@ -156,7 +156,6 @@ ## 9. 归档与事实源 -- `design/archive/gdd-2026-09-14/` 是旧版 GDD 体系的只读归档：不维护、不修改，**禁止作为事实引用**。 - 旧文档里的概念写进现行文档时，必须翻译成现行术语与现行决策口径（例：雾格已从设计中移除，不得作为现行机制引用）。 - registry 中 owner 仍指向旧 GDD 路径的条目，在对应新系统文档定稿后逐条改指新路径。 @@ -198,3 +197,4 @@ | v9 | 2026-10-02 | **文档生命周期条款（2026-10-01 用户立规「吸收即死」落文）**：新增第 11 节——中间文档寿命=迭代寿命，结论吸收进正主即删、未决先迁再死、永不入库、引用面口径、台账记结论不记指针、sim-data 白名单、迭代出口清理项、design/research 与 design/qa 为暂存地非档案库；第 10 节补台账记结论口径；文首地位/适用范围两处过期路径修正（`docs/`→`design/dev/`、`production/` 会话记录→根 `active.md`） | | v10 | 2026-10-04 | **台账去压缩条款（用户立规）**：第 10 节废除「每条 ≤3 行」——能看懂比字数少更重要；条目改用完整白话句子写结论，长度服从可读性；第 4 节黑话禁令对台账同等生效。起因：2026-10-04 黑话审计证实 ≤3 行压缩压力迫使台账条目使用自造缩略语（收口/落籍/在飞等约 15 个流程动词、530 条自造短语），并渗入正式文档；CLAUDE.md 规范导航表「会话进度记录」行同步改写 | | v11 | 2026-10-04 | **第 4 节补强：自造词三形态禁令（用户令，黑话审计后）**：新增自造词三种固定形态禁令表（工作包代号 / 机制造词 / 流程造词，各带本仓真实反例与正确写法）+ 通行检验标准（读者 = 业内人但没读过项目历史，需要作者解释的词即不合格，展开才算改）+ 写后自查动作；同批 CLAUDE.md 硬性红线新增「用语红线」一行。起因：原第 4 节禁令过于抽象、执行失效（全仓 530 条自造短语），且未明确覆盖对话输出与工作日志命名 | +| v12 | 2026-10-09 | §9 摘除 design/archive/gdd-2026-09-14/ 归档列项（目录已删，2026-10-09 用户令旧档引用全量摘除）；旧概念翻译与 registry 改指两条维持 | diff --git a/design/gdd/00-游戏概念.md b/design/gdd/00-游戏概念.md index 23fb317e..de3004cb 100644 --- a/design/gdd/00-游戏概念.md +++ b/design/gdd/00-游戏概念.md @@ -61,8 +61,6 @@ 另：元进度资源定名**钥石**——每一层关底 Boss 看守他那块区域的钥石，击杀即取走，用于在存档内解锁永久提升（属性 / 怪物遭遇 / 道具池）。2026-09-14 用户拍板，registry 术语登记随元进度设计批补登。 -> 旧版参考：../archive/gdd-2026-09-14/game-concept.md - ## 版本历史 | 版本 | 日期 | 改动 | diff --git a/design/gdd/01-核心循环.md b/design/gdd/01-核心循环.md index c7090665..9df91b06 100644 --- a/design/gdd/01-核心循环.md +++ b/design/gdd/01-核心循环.md @@ -123,8 +123,6 @@ **专长 rarity 语义约束**：Boss 三选一候选按档配比或加权抽取，使罕见度对出现率生效（字段双脱钩修复——此前 rarity 不影响抽选也不稳代表幅度）；具体配比归调参批。 -> 旧版参考：../archive/gdd-2026-09-14/gdd.md - ## 版本历史 | 版本 | 日期 | 改动 | diff --git a/design/gdd/02-系统清单.md b/design/gdd/02-系统清单.md index 8a52a374..ed90a48d 100644 --- a/design/gdd/02-系统清单.md +++ b/design/gdd/02-系统清单.md @@ -80,7 +80,7 @@ ## 子系统命名对照表（中文规范名 ↔ 英文代号） -现行文档、评审与沟通一律使用中文规范名；英文代号（大写）供代码标识符、工具链与提交信息使用，语义与中文名一一对应；「旧代号」仅用于解读 `design/archive/gdd-2026-09-14/` 只读归档与 2026-09-14 之前的历史记录，禁止在新文档中作为系统名称使用。 +现行文档、评审与沟通一律使用中文规范名；英文代号（大写）供代码标识符、工具链与提交信息使用，语义与中文名一一对应；「旧代号」仅用于解读 2026-09-14 之前的历史记录，禁止在新文档中作为系统名称使用。 | 循环 | 中文规范名 | 英文代号 | 旧代号 | |---|---|---|---| @@ -114,8 +114,6 @@ > 四个循环本身的英文代号为 `MINESWEEPER_CYCLE`（排雷循环）、`COMBAT_CYCLE`（战斗循环）、`ADVENTURE_CYCLE`（冒险循环）、`PRESENTATION_SUPPORT`（表现与支撑）。 -> 旧版参考：旧骨架系统索引 systems-index.md（gdd-2026-09-14 快照，已封存；封存归档目录待归位——2026-09-20 链接审计发现 design/archive 目录缺失，不再作路径引用） - ## 版本历史 | v0.1 | 2026-09-15 | 根索引随新骨架建立：循环 × 子系统总表 + 子系统命名对照表 | @@ -142,3 +140,4 @@ | v1.12 | 2026-10-06 | 生涯设计立项批（迭代 17 卡④，纯文档）：新建 `systems/跨局循环/生涯.md` 设计提纲 v0.1（信息架构 / 承载内容清单 / 与既有界面关系 / 分期实装建议 / 待裁点五节；状态=范围草案待评审——P0-P5 已裁结论落文，新发现待裁点 P6 营地最近冒险条带去留）。文档树跨局循环补行 + 命名对照表补 `CAREER` 行（无代码实现面，代号随实装批对齐） | | v1.13 | 2026-10-07 | 道具三层职责分界批随批（用户裁——规则正主=[核心循环](01-核心循环.md)「道具三层职责与分界」节 v1.4）：秘宝行概要由「扫雷侧秘宝（显影、探测类）」（同调形态起已滞后）换代为「营地装配、整局冒险生效的角色机能件」；状态列随去迁移注记 | | v1.14 | 2026-10-07 | 奇物层重设计落地随批（正主=[奇物](systems/冒险循环/奇物.md)版本历史 v2.9-v3.4——专长体系推倒重建+资源转换源+池结构案D+跨层档位框架）：奇物行概要与状态同步——概要补「专长=触发器句式的机制件/资源=转换源凭证」，状态改「已实现·2026-10-07 专长体系重设计落地（18 件基础框架+池结构案D）」 | +| v1.15 | 2026-10-09 | 旧档引用摘除批（用户令——旧版 GDD 归档 design/archive/gdd-2026-09-14/ 已删，全部指涉摘除）：「旧代号」句不再指涉归档路径（仅解读 2026-09-14 之前历史记录）；旧骨架索引参考行整行摘除。语义零变更 | diff --git a/design/gdd/03-内容规模.md b/design/gdd/03-内容规模.md index f3998a5e..867d6e26 100644 --- a/design/gdd/03-内容规模.md +++ b/design/gdd/03-内容规模.md @@ -70,8 +70,6 @@ MVP 不加新状态；扩容走 status_effects.tres 加行 + registry 登记。 - 新敌种、新棋盘档位、更高密度、同深度多敌种混搭 - 秘宝清单之外的新件、状态表之外的新状态 -> 旧版参考：../archive/gdd-2026-09-14/gdd.md - ## 版本历史 | 版本 | 日期 | 改动 | diff --git a/design/gdd/04-美术音频方向.md b/design/gdd/04-美术音频方向.md index 3c51b44e..82d772f2 100644 --- a/design/gdd/04-美术音频方向.md +++ b/design/gdd/04-美术音频方向.md @@ -14,8 +14,6 @@ 美术细则（色板、形状语言、图标契约、验收标准）见 `design/art/art-bible.md`（含参考与反参考，见其 §9）。 -> 旧版参考：../archive/gdd-2026-09-14/game-concept.md - ## 版本历史 | 版本 | 日期 | 改动 | diff --git a/design/gdd/05-不做清单.md b/design/gdd/05-不做清单.md index cdee068c..2755a594 100644 --- a/design/gdd/05-不做清单.md +++ b/design/gdd/05-不做清单.md @@ -24,8 +24,6 @@ - **正式音频、教学引导、战斗动画演出、设置与本地化**：MVP 内的打磨项，一律排后。先验证核心循环，再谈好听好看。 - **连刷 / 换图资金跨战斗携带**：现行规则是每场战斗清零，防滚雪球。是否解禁连刷策略，等实测数据说话。 -> 旧版参考：../archive/gdd-2026-09-14/gdd.md - ## 版本历史 | 版本 | 日期 | 改动 | diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index aaadbe41..2bb482d1 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -411,10 +411,9 @@ **文档/结构闸存量欠账（2026-10-08 迭代 19 总收口批登记——新重闸口径首次全闸套跑翻出；经 T0 基点 9160942 复测确认为存量/外部批旧债，非本迭代新增）** - gdd_lint 表格占比 3 件：01-核心循环（35%）/06-待办清单（0%）/07-体验验证清单（6%）——T0 基点已 2 件存量在案，第 3 件疑外部道具批 80 行散文落文稀释占比 -- 熵增闸 design/diagrams 越界：GDD 系统架构图批（00712d5）旧债——白名单扩充须用户拍板后同批改 CLAUDE.md Project Layout+脚本白名单两处 - doc_link 死链 2 件：奇物.md:245 → ../ux/battle.md 与 ../ux/node-reward.md（奇物 v2.7 b6b43eb 旧债） - doc_term 退役术语旗 1 件：06「拔旗回收返 AP」备选条目文字引用（该条目自身裁决时顺手处置） -**归属**：文档体检批/对应来源批；diagrams 白名单与逐件处置权归用户 +**归属**：文档体检批/对应来源批 **状态**：待办（已呈报登记；处置不阻塞迭代 19 收口） diff --git a/design/gdd/systems/冒险循环/关卡节点地图.md b/design/gdd/systems/冒险循环/关卡节点地图.md index e65ea100..9bde0213 100644 --- a/design/gdd/systems/冒险循环/关卡节点地图.md +++ b/design/gdd/systems/冒险循环/关卡节点地图.md @@ -2,7 +2,6 @@ > 一句话：单关内的节点图选路与推进 > 状态：已定稿 -> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引） ## 设计目的 diff --git a/design/gdd/systems/冒险循环/冒险结构.md b/design/gdd/systems/冒险循环/冒险结构.md index d00d19c0..1b076683 100644 --- a/design/gdd/systems/冒险循环/冒险结构.md +++ b/design/gdd/systems/冒险循环/冒险结构.md @@ -2,7 +2,6 @@ > 一句话：整局冒险的关卡序列、失败与大奖励 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/c2-adventure-structure.md ## 设计目的 diff --git a/design/gdd/systems/冒险循环/难度曲线与Boss.md b/design/gdd/systems/冒险循环/难度曲线与Boss.md index e6054519..2d50f862 100644 --- a/design/gdd/systems/冒险循环/难度曲线与Boss.md +++ b/design/gdd/systems/冒险循环/难度曲线与Boss.md @@ -2,7 +2,6 @@ > 一句话：难度曲线、期望值带与 Boss 设计 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/c3-difficulty-curve.md ## 设计目的 diff --git a/design/gdd/systems/战斗循环/地图战斗资源.md b/design/gdd/systems/战斗循环/地图战斗资源.md index 8d0f8d3a..45505b77 100644 --- a/design/gdd/systems/战斗循环/地图战斗资源.md +++ b/design/gdd/systems/战斗循环/地图战斗资源.md @@ -2,7 +2,6 @@ > 一句话：格面资源的产出、极性字典与清图奖励封装 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/b4-reward-item-economy.md ## 设计目的 diff --git a/design/gdd/systems/战斗循环/增益状态.md b/design/gdd/systems/战斗循环/增益状态.md index 4a6c869a..d35c0942 100644 --- a/design/gdd/systems/战斗循环/增益状态.md +++ b/design/gdd/systems/战斗循环/增益状态.md @@ -2,7 +2,6 @@ > 一句话：增益/减益状态的容器、叠层与衰减 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/b3-status-effect.md ## 设计目的 diff --git a/design/gdd/systems/战斗循环/战斗结算.md b/design/gdd/systems/战斗循环/战斗结算.md index 2dab5bdd..f8d847df 100644 --- a/design/gdd/systems/战斗循环/战斗结算.md +++ b/design/gdd/systems/战斗循环/战斗结算.md @@ -2,7 +2,6 @@ > 一句话：轮末结算的编排与逐行兑现 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/b1-settlement.md ## 设计目的 diff --git a/design/gdd/systems/战斗循环/战斗表现.md b/design/gdd/systems/战斗循环/战斗表现.md index 0ff8ffae..02cc4a7e 100644 --- a/design/gdd/systems/战斗循环/战斗表现.md +++ b/design/gdd/systems/战斗循环/战斗表现.md @@ -2,7 +2,6 @@ > 一句话：战斗动画与演出（旧体系未单独成文） > 状态：范围草案（待设计） -> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引） ## 设计目的 diff --git a/design/gdd/systems/战斗循环/敌人系统.md b/design/gdd/systems/战斗循环/敌人系统.md index 40fe1264..c704fa1c 100644 --- a/design/gdd/systems/战斗循环/敌人系统.md +++ b/design/gdd/systems/战斗循环/敌人系统.md @@ -2,7 +2,6 @@ > 一句话：敌人数据、技能池出招、意图呈现 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/b2-enemy-system.md ## 设计目的 diff --git a/design/gdd/systems/排雷循环/地形变异.md b/design/gdd/systems/排雷循环/地形变异.md index 9e2cec3b..6601579e 100644 --- a/design/gdd/systems/排雷循环/地形变异.md +++ b/design/gdd/systems/排雷循环/地形变异.md @@ -2,7 +2,6 @@ > 一句话：格子的非雾变异（荆棘丛/藤蔓缠绕/岩浆/烬覆/落石/矿尘）与 Boss 图整图变异（贫矿脉），挖掘中可遭遇的地貌偏离 > 状态：已定稿（首批类型随 2026-09-19 定稿批落地，第三关一对随 2026-09-20 第三关内容批落地；首个整图变异随 2026-10-04 全局作用域变异首发批落地） -> 旧版参考：../../../archive/gdd-2026-09-14/a4-terrain-variation.md ## 设计目的 diff --git a/design/gdd/systems/排雷循环/排雷玩法.md b/design/gdd/systems/排雷循环/排雷玩法.md index 20e90eef..28589fe4 100644 --- a/design/gdd/systems/排雷循环/排雷玩法.md +++ b/design/gdd/systems/排雷循环/排雷玩法.md @@ -2,7 +2,6 @@ > 一句话：挖格、插旗、连锁展开等扫雷规则本体 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/a2-minesweeper-rules.md ## 设计目的 diff --git a/design/gdd/systems/排雷循环/棋盘生成.md b/design/gdd/systems/排雷循环/棋盘生成.md index f05e786d..914d17b8 100644 --- a/design/gdd/systems/排雷循环/棋盘生成.md +++ b/design/gdd/systems/排雷循环/棋盘生成.md @@ -2,7 +2,6 @@ > 一句话：棋盘怎么生成、怎么保证可推理可通关 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/a1-board-generation.md ## 设计目的 diff --git a/design/gdd/systems/排雷循环/秘宝.md b/design/gdd/systems/排雷循环/秘宝.md index e41db81c..34688d79 100644 --- a/design/gdd/systems/排雷循环/秘宝.md +++ b/design/gdd/systems/排雷循环/秘宝.md @@ -3,7 +3,6 @@ > 一句话：营地装配、整局冒险生效的角色机能件——操作包络加强（视野/行动点/刷新/挖掘距离等），不出裸属性值、不改战斗结算机制（分界规则归[核心循环](../../01-核心循环.md)「道具三层职责与分界」节） > 状态：已定稿（2026-10-03 迭代 11 第①批同调实施批——终局形态落籍，过渡形态退役） > 形态沿革：~~过渡形态~~已退役（2026-10-03）；现行=局外同调件——见下节「定位与形态沿革」 -> 旧版参考：../../../archive/gdd-2026-09-14/a5-minesweeper-aux-items.md ## 定位与形态沿革（2026-09-30 用户裁决甲；2026-10-03 同调实施批落籍终局形态） diff --git a/design/gdd/systems/排雷循环/行动经济.md b/design/gdd/systems/排雷循环/行动经济.md index 02629bd8..c7626589 100644 --- a/design/gdd/systems/排雷循环/行动经济.md +++ b/design/gdd/systems/排雷循环/行动经济.md @@ -2,7 +2,6 @@ > 一句话：每轮行动点怎么花、停手与刷新的代价 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/a3-action-economy.md ## 设计目的 diff --git a/design/gdd/systems/表现与支撑/HUD框架.md b/design/gdd/systems/表现与支撑/HUD框架.md index feea3584..81359d4b 100644 --- a/design/gdd/systems/表现与支撑/HUD框架.md +++ b/design/gdd/systems/表现与支撑/HUD框架.md @@ -2,7 +2,6 @@ > 一句话：界面布局与呈现层契约 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/d1-hud-framework.md ## 设计目的 diff --git a/design/gdd/systems/表现与支撑/存档序列化.md b/design/gdd/systems/表现与支撑/存档序列化.md index 45941a36..67b9d8d6 100644 --- a/design/gdd/systems/表现与支撑/存档序列化.md +++ b/design/gdd/systems/表现与支撑/存档序列化.md @@ -2,7 +2,6 @@ > 一句话：存档契约与版本迁移 > 状态：已定稿（2026-09-21 存档序列化批落地） -> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引） ## 设计目的 diff --git a/design/gdd/systems/表现与支撑/教学引导.md b/design/gdd/systems/表现与支撑/教学引导.md index 0083653b..b73eeb9b 100644 --- a/design/gdd/systems/表现与支撑/教学引导.md +++ b/design/gdd/systems/表现与支撑/教学引导.md @@ -2,7 +2,6 @@ > 一句话：新手教学与提示 > 状态：范围草案（待设计） -> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引） ## 设计目的 diff --git a/design/gdd/systems/表现与支撑/数据配置.md b/design/gdd/systems/表现与支撑/数据配置.md index b0e0c259..2f4f298f 100644 --- a/design/gdd/systems/表现与支撑/数据配置.md +++ b/design/gdd/systems/表现与支撑/数据配置.md @@ -2,7 +2,6 @@ > 一句话：数值表与单一事实源管线 > 状态：已定稿（自旧体系迁移） -> 旧版参考：../../../archive/gdd-2026-09-14/d2-data-config.md ## 设计目的 diff --git a/design/gdd/systems/表现与支撑/设置与本地化.md b/design/gdd/systems/表现与支撑/设置与本地化.md index d10cf204..32c30190 100644 --- a/design/gdd/systems/表现与支撑/设置与本地化.md +++ b/design/gdd/systems/表现与支撑/设置与本地化.md @@ -2,7 +2,6 @@ > 一句话：设置项与多语言 > 状态：范围草案·最小设置面已兑现（2026-09-29 迭代 8 卡④） -> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引） ## 设计目的 diff --git a/design/gdd/systems/表现与支撑/音频.md b/design/gdd/systems/表现与支撑/音频.md index 565546b9..4541df6d 100644 --- a/design/gdd/systems/表现与支撑/音频.md +++ b/design/gdd/systems/表现与支撑/音频.md @@ -2,7 +2,6 @@ > 一句话：音乐音效方向与实现 > 状态：范围草案（待设计） -> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引） ## 设计目的 diff --git a/design/gdd/systems/跨局循环/元进度.md b/design/gdd/systems/跨局循环/元进度.md index 4da33ab4..7fcfb459 100644 --- a/design/gdd/systems/跨局循环/元进度.md +++ b/design/gdd/systems/跨局循环/元进度.md @@ -2,7 +2,6 @@ > 一句话：跨局成长——钥石在营地换成永久强化，存档随冒险变厚 > 状态：已定稿（2026-09-18 元进度定稿批，用户拍板收口） -> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引） ## 设计目的 diff --git a/design/registry/entities.yaml b/design/registry/entities.yaml index f6282379..59560d98 100644 --- a/design/registry/entities.yaml +++ b/design/registry/entities.yaml @@ -430,7 +430,7 @@ entities: # 2026-09-08 地形变异 full 评审修订（owner=地形变异，NEEDS REVISION 8 阻塞同日核销）： # variation_table.load_bearing_rule 增结构推论（厚度≤2/f≤8d）· fog_ap_note 改写（全价→链不可达两态； # 条款 5"消解"→三腿入账两态验算）· variant_pool_gate 增 board_biome 域校验归属与 15 项验收门禁登记—— -# 详见 design/archive/gdd-2026-09-14/reviews/a4-terrain-variation-review-log.md 阻塞→修复对照表。 +# 评审日志存于旧版 GDD 体系（gdd-2026-09-14 归档，已删） 阻塞→修复对照表。 # 2026-09-08 地形变异 re-review 修订（owner=地形变异，NEEDS REVISION #2 6 阻塞同日核销）： # variation_table 增 cross_field_validation（hide_numbers⇒safe_nonzero 致命）与 pricing_constraints（奖励道具经济 三 # 硬约束）· counter_item_ids 修正为非 knob · mvp_content 的 knob 活值标注 · referenced_by 补 战斗结算/奖励道具经济 · @@ -450,7 +450,7 @@ entities: # 2026-09-09 排雷玩法 full 评审修订（owner=排雷玩法，NEEDS REVISION 6 blocking 同日核销）： # minesweeper_event_surface.api_surface 增 ActionOutcome.sub_reason 封闭枚举（UX-1，批前免费窗口）· HUD框架×1→HUD框架×6； # minesweeper_initial_expansion 增诊断类别封闭枚举 + 链不越旗红线（GD-1——连锁传播集 ∖ G，G=∅ 域与 棋盘生成 算子①同构不变）； -# 新增 terminology 术语条目（用语纪律登记通道）。详见 design/archive/gdd-2026-09-14/reviews/a2-minesweeper-rules-review-log.md。 +# 新增 terminology 术语条目（用语纪律登记通道）。评审日志存于旧版 GDD 体系（gdd-2026-09-14 归档，已删）。 # 2026-09-09 敌人系统 定稿回填（owner=敌人系统）：新增 enemy / hero / clause3_supply 三条目（EnemyTable 八字段 + # 双敌种行 + 每行集恰一敌种校验；HeroTable 单行全局两字段 + atk=0 机制开关〔该口径 2026-09-11 作废，见下〕；条款 3 单结算自然边界供给口径〔用户定稿〕）· # status_effect.single_enemy_assumption 回验改写（定多敌，side-wide 兼容 + target_ref 扩展位）· @@ -471,7 +471,7 @@ entities: # enemy.settlement_obligations ① 增调用序成文（query_attack→apply_damage→advance）与敌单位专属口径 · hud_obligations # ① 增预告时序/强度档位、② 改全局恒定 · rowset_rule 增精英/Boss 编码位预登记（敌人系统 OQ7）· clause3_supply # 结构上界改 min(AP, cap) 形（cap 腿松弛收紧）· direction_precheck 裕度 4.7×→2.3× 更正（最低档锚口径）· -# account_input 增胜利路径声明注记。详见 design/archive/gdd-2026-09-14/reviews/b2-enemy-system-review-log.md。 +# account_input 增胜利路径声明注记。评审日志存于旧版 GDD 体系（gdd-2026-09-14 归档，已删）。 # 2026-09-09 奖励道具经济 定稿回填（owner=奖励道具经济）：新增 reward_table 条目（schema 八字段 + 跨字段 # 校验族 + 机制/API 面 + 战斗结算×6/HUD框架×3 义务清单 + 地形变异 三约束承接 + 高光节点条目化）；接口漂移改写三处—— # rng_service.scope_event_binding 的 reward_roll 语义（每次奖励结算 → 每次 board install 批）、 @@ -690,7 +690,7 @@ entities: # + 重复受理幂等语义 + 战斗结算×6/HUD框架×3→HUD框架×5 义务清单同步；锚参照迁移传播三处（本条 anchor_warning 迁移注记 / # clause3_supply.direction_precheck 迁移注记 / systems-index 行动经济 OQ5 注记——attack_up 口径历史值与 defense_up # 数值巧合全等、迁移后预检未重跑事实同批登记）；terminology 增 奖励道具经济 六词条（刀/批尾/死行/档位序检查/预推进/烧刀烧包）。 -# 详见 design/archive/gdd-2026-09-14/reviews/b4-reward-item-economy-review-log.md。 +# 评审日志存于旧版 GDD 体系（gdd-2026-09-14 归档，已删）。 # 2026-09-10 战斗结算 定稿回填（owner=战斗结算）：新增 settlement_table / clause5_dominance 两条件目 # （SettlementTable 七字段 + 三行致命 manifest + 段序骨架/可回放/高光双落载体；条款⑤主判式 + 保守地板缺口 + # 两护栏 + 三腿入账）· 接口漂移回写四处——status_effect.mvp_content.weaken magnitude −25→−65（F0 裁决， @@ -704,7 +704,7 @@ entities: # 数据配置 GDD 行按收编先例以本条为准）、source_label_map 键集补 enemy_action/flag_miss、mechanics 补行协议字段分层； # clause5_dominance——模型修订重登（挖穿残余池计价、条款⑤未闭合 + 难度曲线与Boss/奖励道具经济 约束包 + 护栏 B 双读数 + RAP 零价假设）； # clause3_supply——闭合回执双口径更正（锚行 ≈2.0×/2.6× / 期望 ≈1.2×/1.5×、破线约束两轴）。 -# 详见 design/archive/gdd-2026-09-14/reviews/b1-settlement-review-log.md。 +# 评审日志存于旧版 GDD 体系（gdd-2026-09-14 归档，已删）。 # 2026-09-13 HUD框架 定稿回填（owner=HUD框架）：新增 hud_presentation_surface 条目（呈现面契约—— # 读图接口清单/订阅纪律/命令式刷新面/载荷 schema 索引/生命周期可见性规则/命名统一/接口漂移登记 ×3）； # terminology 增两词条（命令式回执驱动/程序化占位）+ referenced_by 增 HUD框架。solo 模式出稿待人工复核。 diff --git a/game/core/action_economy.gd b/game/core/action_economy.gd index 5b00fc60..00f2655e 100644 --- a/game/core/action_economy.gd +++ b/game/core/action_economy.gd @@ -3,7 +3,7 @@ # Date: 2026-09-10 # 行动经济：被动账本（AP 硬重置 / 统一价目 / 三路径结束仲裁 cleared > stopped > ap_exhausted / # RAP 池战斗域 / 双发射源之 stopped 直发）。相位域 = {Idle, Active, Waiting}。 -# 实现 GDD：design/archive/gdd-2026-09-14/a3-action-economy.md（系统 ID A3·行动经济——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/排雷循环/行动经济.md（系统 ID A3·行动经济——registry 追溯锚，命名规范见 CLAUDE.md） class_name ActionEconomy extends RefCounted diff --git a/game/core/board_data.gd b/game/core/board_data.gd index 9160f6b6..9402b9ae 100644 --- a/game/core/board_data.gd +++ b/game/core/board_data.gd @@ -2,7 +2,7 @@ # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2） # Date: 2026-09-10 # 棋盘产物数据契约（排雷玩法消费；生成后不可变——排雷玩法持快照即持活引用，生成器不再触碰）。 -# 实现 GDD：design/archive/gdd-2026-09-14/a1-board-generation.md（系统 ID A1·棋盘生成——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/排雷循环/棋盘生成.md（系统 ID A1·棋盘生成——registry 追溯锚，命名规范见 CLAUDE.md） class_name BoardData extends RefCounted diff --git a/game/core/board_generator.gd b/game/core/board_generator.gd index d571b5c6..ee8a7c11 100644 --- a/game/core/board_generator.gd +++ b/game/core/board_generator.gd @@ -4,7 +4,7 @@ # 确定性棋盘生成器：五阶段管线（参数→布雷→变异布置→生成-验证→产出）+ F1 可推理率度量 # （single_subset 求解器）+ F5 验收算子（达标即出/接受最优/接受最不坏）。 # 切片裁剪登记：黄金向量回归套件与 F4 批量工具不做（难度曲线与Boss 调参期工具域）。 -# 实现 GDD：design/archive/gdd-2026-09-14/a1-board-generation.md（系统 ID A1·棋盘生成——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/排雷循环/棋盘生成.md（系统 ID A1·棋盘生成——registry 追溯锚，命名规范见 CLAUDE.md） class_name BoardGenerator extends RefCounted diff --git a/game/core/config_db.gd b/game/core/config_db.gd index b6ace23c..27062768 100644 --- a/game/core/config_db.gd +++ b/game/core/config_db.gd @@ -2,7 +2,7 @@ # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2） # Date: 2026-09-10 # ConfigDB autoload（数据配置）——数值表单点访问入口（Rule 2）+ 校验双通道（Rule 6）+ R1 行解析。 -# 实现 GDD：design/archive/gdd-2026-09-14/d2-data-config.md（系统 ID D2·数据配置——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/表现与支撑/数据配置.md（系统 ID D2·数据配置——registry 追溯锚，命名规范见 CLAUDE.md） # 切片注：headless --script 模式下由冒烟脚本显式实例化（数据配置 AC 前言）；玩法代码禁止绕过本单点自建 load()。 class_name ConfigDb extends Node diff --git a/game/core/config_db_cross_validator.gd b/game/core/config_db_cross_validator.gd index ce7a6fd8..5af597f8 100644 --- a/game/core/config_db_cross_validator.gd +++ b/game/core/config_db_cross_validator.gd @@ -7,7 +7,7 @@ # 本类零 ConfigDb 依赖（无状态纯校验器，装载序上先于成员赋值执行的前提保持）。 # 迁移注记：validate_skill_pool_links 的 status_table 显式入参纪律照抄（装载通道传 loaded 表， # 冒烟直验传门面 status_effects；null 时 side 守卫跳过）——返回错误列表不进诊断通道，消费面归调用方。 -# 实现 GDD：design/archive/gdd-2026-09-14/d2-data-config.md（系统 ID D2·数据配置——registry 追溯锚） +# 实现 GDD：design/gdd/systems/表现与支撑/数据配置.md（系统 ID D2·数据配置——registry 追溯锚） class_name ConfigDbCrossValidator extends RefCounted diff --git a/game/core/config_db_resolver.gd b/game/core/config_db_resolver.gd index 3ae06969..73becc2a 100644 --- a/game/core/config_db_resolver.gd +++ b/game/core/config_db_resolver.gd @@ -7,7 +7,7 @@ # 行为与拆分前逐位一致，含越域 Fatal 退出语义）。 # 迁移注记：_warn_dedup 去重注册表随解析逻辑同迁（唯一消费方 = _resolve_progress）—— # 门面 load_tables / reset_diagnostics 经 reset_warn_dedup() 同步清空，清空时点零变化。 -# 实现 GDD：design/archive/gdd-2026-09-14/d2-data-config.md（系统 ID D2·数据配置——registry 追溯锚） +# 实现 GDD：design/gdd/systems/表现与支撑/数据配置.md（系统 ID D2·数据配置——registry 追溯锚） class_name ConfigDbResolver extends RefCounted diff --git a/game/core/damage_math.gd b/game/core/damage_math.gd index bdbf27e5..9f61f36d 100644 --- a/game/core/damage_math.gd +++ b/game/core/damage_math.gd @@ -1,6 +1,6 @@ # VERTICAL SLICE - NOT FOR PRODUCTION # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2） -# 实现 GDD：design/archive/gdd-2026-09-14/b1-settlement.md（系统 ID B1·战斗结算——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/战斗循环/战斗结算.md（系统 ID B1·战斗结算——registry 追溯锚，命名规范见 CLAUDE.md） # 战斗结算·战斗段伤害公式族（零状态纯算术宿主——规范 1.2「工具性纯函数挂明确宿主类」； # 自 battle_orchestrator 拆出 2026-09-13，封装审查 O3）。池读取与表值读取仍归 战斗结算，本类只做算术。 # 护甲等级掷点批（2026-09-16）：掷点查档与吃掷点分量算术收编本类（判定式参数化——表值零字面量纪律不变）。 diff --git a/game/core/minesweeper_rules.gd b/game/core/minesweeper_rules.gd index b7b4e736..b1af1103 100644 --- a/game/core/minesweeper_rules.gd +++ b/game/core/minesweeper_rules.gd @@ -5,7 +5,7 @@ # 核心契约：install 四不变式 · 初始展开 = R₀ 恰等 · 连锁不越旗 · 批次语义序仲裁（cleared > stop > 其余）。 # 旗语义（插旗不可逆批 2026-09-19 用户拍板全套落地）：旗 = 一次性承诺——挖旗格放行（本格旗事务内 # 隐式退役、轮末不判），拔旗动作退役（flag_pull 出目录）。 -# 实现 GDD：design/archive/gdd-2026-09-14/a2-minesweeper-rules.md（系统 ID A2·排雷玩法——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/排雷循环/排雷玩法.md（系统 ID A2·排雷玩法——registry 追溯锚，命名规范见 CLAUDE.md） class_name MinesweeperRules extends RefCounted diff --git a/game/core/rng_service.gd b/game/core/rng_service.gd index 8a0b9016..7c35870b 100644 --- a/game/core/rng_service.gd +++ b/game/core/rng_service.gd @@ -3,7 +3,7 @@ # Date: 2026-09-10 # RngService autoload（数据配置）——统一随机流单点（Rule 5；ADR-0007 裁丙 2026-09-27：七流并一+全事件日志）。 # 玩法代码禁止 randomize()/自建 RandomNumberGenerator。 -# 实现 GDD：design/archive/gdd-2026-09-14/d2-data-config.md（系统 ID D2·数据配置——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/表现与支撑/数据配置.md（系统 ID D2·数据配置——registry 追溯锚，命名规范见 CLAUDE.md） # 统一流口径：唯一主种子 + 唯一派生（单盐）+ 唯一全局取数计数器；open_stream 参数降格为「用途标签」—— # 不参与派生，只进事件日志（并流前七条流名全部保留为合法标签）。号位语义（ADR-0007 后果，用户裁决承接）： # 全局 scope 只回答「全局第 N 次取数」，不再回答「第 N 次某类事件」——路线依赖为已知代价，单点定位能力由事件日志承载。 diff --git a/game/core/status_container.gd b/game/core/status_container.gd index 63d8732e..5e9159e9 100644 --- a/game/core/status_container.gd +++ b/game/core/status_container.gd @@ -4,7 +4,7 @@ # 增益状态·统一状态容器：三向效果同构实例 · 单一时限量纲 remaining_settlements（先兑付后衰减）· # 按行叠层（stack 授予不触碰 R）· 授予时数值快照抗热重载 · 零随机零信号。 # 注：MVP 单敌假设经 敌人系统 回验不成立（定多敌）——enemy 侧 side-wide 语义按 registry 改写执行。 -# 实现 GDD：design/archive/gdd-2026-09-14/b3-status-effect.md（系统 ID B3·增益状态——registry 追溯锚，命名规范见 CLAUDE.md） +# 实现 GDD：design/gdd/systems/战斗循环/增益状态.md（系统 ID B3·增益状态——registry 追溯锚，命名规范见 CLAUDE.md） class_name StatusContainer extends RefCounted diff --git a/game/data/schemas/action_economy_table.gd b/game/data/schemas/action_economy_table.gd index 6c1c8003..aecf9bed 100644 --- a/game/data/schemas/action_economy_table.gd +++ b/game/data/schemas/action_economy_table.gd @@ -2,7 +2,7 @@ # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2） # Date: 2026-09-10 # 数据配置 ActionEconomyTable schema（行动经济 回填值，单行全局；Rule 4 豁免）。 -# 数值域与跨字段校验依据 design/archive/gdd-2026-09-14/a3-action-economy.md "ActionEconomyTable Schema 定稿"。 +# 数值域与跨字段校验依据 design/gdd/systems/排雷循环/行动经济.md "ActionEconomyTable Schema 定稿"。 class_name ActionEconomyTable extends Resource diff --git a/game/data/schemas/board_gen_table.gd b/game/data/schemas/board_gen_table.gd index d178bbff..e9ed1886 100644 --- a/game/data/schemas/board_gen_table.gd +++ b/game/data/schemas/board_gen_table.gd @@ -2,7 +2,7 @@ # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2） # Date: 2026-09-10 # 数据配置 BoardGenTable schema（棋盘生成 回填值；键 (level_index, node_depth)——首个进度键表）。 -# 依据 design/archive/gdd-2026-09-14/a1-board-generation.md "BoardGenTable Schema 定稿" + F2/F2b/F2c 谓词。 +# 依据 design/gdd/systems/排雷循环/棋盘生成.md "BoardGenTable Schema 定稿" + F2/F2b/F2c 谓词。 class_name BoardGenTable extends Resource diff --git a/game/data/schemas/status_effect_table.gd b/game/data/schemas/status_effect_table.gd index e939afea..8e807ba8 100644 --- a/game/data/schemas/status_effect_table.gd +++ b/game/data/schemas/status_effect_table.gd @@ -2,7 +2,7 @@ # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2） # Date: 2026-09-10 # 数据配置 StatusEffectTable schema（增益状态 回填值；行 = Dictionary，键 effect_id；Rule 4 豁免）。 -# 依据 design/archive/gdd-2026-09-14/b3-status-effect.md "StatusEffectTable Schema 定稿"。 +# 依据 design/gdd/systems/战斗循环/增益状态.md "StatusEffectTable Schema 定稿"。 class_name StatusEffectTable extends Resource diff --git a/tools/doc_link_audit.py b/tools/doc_link_audit.py index ba6c74dd..e8b9a0e7 100644 --- a/tools/doc_link_audit.py +++ b/tools/doc_link_audit.py @@ -1,7 +1,7 @@ #!/usr/bin/env python3 r"""doc_link_audit.py — design 文档链接健康检查 -扫 design/gdd/、design/registry/、design/ux/ 下的 .md 与 .yaml，校验两类引用： +扫 design/gdd/、design/registry/ 下的 .md 与 .yaml，校验两类引用： (a) markdown 链接 [文字](路径[#锚点]) —— 一律相对"链接所在文件自身目录"解析（标准 markdown 语义），跨目录用 ../。排除图片 ![...]；目标里混入全角标点（偶发把全角括号 写进目标）时在首个全角标点处截断再校验。 @@ -23,7 +23,7 @@ r"""doc_link_audit.py — design 文档链接健康检查 python tools/doc_link_audit.py ... # 只扫指定文件 python tools/doc_link_audit.py --json # 机器可读 -口径：只扫 design/gdd/ design/registry/ design/ux/——design/art、design/research +口径：只扫 design/gdd/ design/registry/——design/art、design/research （历史素材/提案）不在扫描域，但作为链接目标被校验。排除 ``` 围栏代码块与 ; 开头注释行。 """ import argparse @@ -32,7 +32,7 @@ import re import sys from pathlib import Path -DEFAULT_DIRS = ["design/gdd", "design/registry", "design/ux"] +DEFAULT_DIRS = ["design/gdd", "design/registry"] PROTO_PREFIX = "game" ALLOWED_EXTS = ("md", "yaml", "yml", "tres", "gd", "py", "json", "csv") diff --git a/tools/doc_term_audit.py b/tools/doc_term_audit.py index 53bead1a..d30652c2 100644 --- a/tools/doc_term_audit.py +++ b/tools/doc_term_audit.py @@ -13,7 +13,7 @@ r"""doc_term_audit.py — GDD 退役术语扫描（半自动） python tools/doc_term_audit.py ... # 只扫指定文件 python tools/doc_term_audit.py --json # 机器可读 -口径：只扫 design/gdd/ design/registry/ design/ux/——design/archive、design/research +口径：只扫 design/gdd/ design/registry/——design/research （历史提案）、docs/（样例）与 production/ 不在扫描域；词表扩充 = 改 RETIRED_TERMS。 """ import argparse @@ -45,7 +45,7 @@ RETIRED_TERMS = [ ("兄弟精", "2026-09-26", "L2 熊地精（bugbear 复用）", "变体名未经批准退役批——用户质问查证后全仓清除"), ] -DEFAULT_DIRS = ["design/gdd", "design/registry", "design/ux"] +DEFAULT_DIRS = ["design/gdd", "design/registry"] # 行级白名单信号：命中任一即归"留档类" WHITELIST_RE = re.compile(