game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
902 Commits 23 Branches 0 Tags
d77a245bcced5794496a3839d090e8a052aa056a
Commit Graph
902 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
DKChan d77a245bcc ui-struct-probe mini-loop T0-T6 全落（探针全屏零红+负向验证红+probe_gate 注册段全绿+冒烟772/0+run_all 14/15基线红+doc三闸零新增）——①M2双列叠放修复：ui_assembler.gd 右列挂回 HBox 第二列（原 pad.add_child(right) 误挂 MarginContainer 与左列同矩形叠放=实机目检抓到的根因；start_box/start_right 命名锚）②按钮宽度纪律：ui_kit.button(text,min_w=216) 全站最小宽度基准+SIZE_FILL（VBox 列内等宽拉满/HBox 行内不抢余宽——EXPAND_FILL 撑爆营地底条 1616px 实证教训注释在案）；行板/角标/图标钮豁免9处（camp 5+shop 2+ap_bar 2+调试角标/诊断转储 2）③新增 ui_struct_probe（全 UI 屏结构断言：按钮互压/同容器等宽/出屏/零尺寸/标题屏双列五族；菜单簇真驱动+冒险簇真流+兑付屏 open 面合成喂入；ScrollContainer 内容豁免；modal 屏 queue_sort 手法坑在册）④probe_gate.sh 注册默认必跑段⑤07 改排：§⑪改排注记+§⑮分工注记+新增§⑯复验项⑥出口报告（代裁追认单 P1-P4+六轮 red-green 实录）=design/qa/ui-struct-probe-exit-report-2026-10-05.md 2026-10-05 18:00:32 +08:00
DKChan 8944dca0d3 merge: 秘宝代码词族对齐批T0-T10全落（迭代15③号卡；冒烟772/0+run_all 15套唯reward_overlay既有红+探针绿+存档键六键普查零差异+doc三闸零新增） 2026-10-05 15:54:40 +08:00
DKChan 36508697e0 秘宝批出口报告补§八并行协调与合并实录（两轮master并入+07编号顺延⑬→⑭→⑮） 2026-10-05 15:51:57 +08:00
DKChan a9a2e25a0a merge master(d3fa887 技能池④+⑤提灯)入分支：07清单⑭双登冲突解（技能池⑭保留+秘宝目检改⑮）；四文件auto-merge带旧词族零带入（全查仅存档键合法例外） 2026-10-05 15:47:33 +08:00
DKChan d3fa887f43 merge: 技能池执行批T0-T6+⑤提灯接线（迭代14④+⑤；冒烟772/0+run_all 15套+探针绿+doc三闸零新增） 2026-10-05 14:11:13 +08:00
DKChan a07a32a788 roadmap④+⑤✅落地标注（技能池执行批+提灯接线——S/T 摘要随批） 2026-10-05 09:27:52 +08:00
DKChan 97b8589a4c 技能池执行批T0-T6+⑤提灯（迭代14④+⑤）：T0表盘点零漂移（19行池+9技能行+Boss三行对照报告§2）；T1敌人系统.md v0.13五件（池构成表8敌种/护甲列读表口径/三代错峰/半血解锁弹出规格）；T2 skills有效倍率表批注（D4整数基线半点矩阵）+enemy EV锚整数口径重登记+巨蜘蛛1.11消歧+registry enemy/skill换代；T3-T4机制件=unlock_hp_pct可选键（schema域校验缺省无=无门槛）+容器check_skill_unlocks单向闩（零随机）+rollable/special双面过滤（保底不逼锁定）+编排归因行「XX解锁了YY」（type=highlight高光键skill_unlock零行型新增）+row_pacer一次性技能名toast（排除perfect_sweep误触）；T5三Boss解锁技落表（震地怒击×2.5/CD4·遏毒×2.0/CD3·岩崩×2.5/CD4案甲provisional+池尾weight2/unlock50）+断言基线换代3处（技能表12行/池模板/酋长EV锚重锚1.10-1.30实测1.1948）；T6单测skill_unlock_test22断言（run_all注册15套）+smoke+5集成（半血→次轮解锁行恰一次/文本/行型零新增）；⑤提灯+2接线=board_view.set_fog_lantern公共面+case⑮接线断言+HUD框架注记（载体道具归信息件批=接缝就绪态）；T7读数后置挂07；闸=冒烟772/0+run_all15套+探针绿+doc三闸零新增；出口报告design/qa/m4iter14-skillpool-exit-report-2026-10-05.md 2026-10-05 09:26:25 +08:00
DKChan c7173889c0 merge master(85dc9af 收窄批)入分支：07清单⑬双登冲突解（收窄⑬保留+秘宝目检改⑭）；smoke_all/roadmap auto-merge 2026-10-05 08:55:37 +08:00
DKChan d2ab5073d7 秘宝批T9-T10收口：出口报告落design/qa+07清单⑬两条人工项（秘宝UI目检+渲染五闸补跑挂账）+roadmap卡③✅落地标注 2026-10-05 08:53:07 +08:00
DKChan 8c272130fb 秘宝批T8：tests文档两处魔法道具→秘宝清零（game/README.md:538按§4.4禁改项保留作例外登记）；组C补修奇物.md:22/273换名断链；批末全量闸电池认证 2026-10-05 08:49:24 +08:00
DKChan cd73e62346 秘宝批T7组E-2：内部标识符全族换词（inventory/unlocked/replace/overlays/slot/settlement use_aux等60+token）+存档键零触碰专项核通过（37文件六键普查零差异，点号访问零存在）+行为探针四件全绿+任务书§1.2基线回填（755/0实测） 2026-10-05 08:46:51 +08:00
DKChan 85dc9afe7d merge: 初始展开收窄批T0-T8全落（迭代14①号卡；S1停机呈报用户裁方案A；冒烟767/0） 2026-10-05 08:41:43 +08:00
DKChan 09e714f12a 初始展开收窄批T7收口（迭代14①）：roadmap①卡✅落地标注（S1方案A实录+改后读数+T6后置挂07）+②卡台账笔误354→356修正 2026-10-05 08:37:21 +08:00
DKChan 74678d80bc Merge branch 'master' into m4iter14-narrow-20261005 2026-10-05 08:36:32 +08:00
DKChan e1beb2555a 初始展开收窄批T5/T7/T8（迭代14①）：改后结构读数（calibrate 200板/行：R₀均值39.7/37.9/42.8/46.6——10×10收窄42%自68.6、12×12收窄54%自83.2；尾部被闸精确截断r0_max==cap全行；雷密度19.2-21.6%<25%相变线；闸触发22%/42%/42%/24%全<S1线；inf 0.939/0.881/0.929/0.921全达标）+registry initial_expansion_narrowing条（S1方案A裁定+改前锚只测不判声明）+棋盘生成.md v0.5（反退化规则表换代+R₀≤cap行+调参表两行+验收两条）+07⑬四信号组观察项；06视野条目已于745b92ea清账批退役（收窄立项即正主）——T7的06收口面空记入台账 2026-10-05 08:36:27 +08:00
DKChan f8c6db49c6 秘宝批T6组E-1：三测试文件改名（treasure_items/treasure_target_violation/reward_dangling_treasure）+run_all登记+test_kit注释同步（run_all 14/15对照主区基线零新增，唯一红reward_overlay系②批遗留） 2026-10-05 08:36:21 +08:00
DKChan 7e5b6d99b4 秘宝批T5组B-2：ConfigDB注册键treasure_items/持有变量/五访问器全族+调用方+桩表+loaded取键同步（冒烟755/0；run_all对照基线零新增——reward_overlay_test红系②批遗留基线红,treasure_items_test由红转绿系本批修复T4桩回退行漏改） 2026-10-05 08:34:57 +08:00
DKChan 2532c8fceb 秘宝批T4组B-1：aux_items.gd/aux_item_table.gd/aux_items.tres/aux_interact_controller.gd 四文件+类名→treasure词族（.uid稳定/.tres ext_resource同步/--import重刷，冒烟755/0） 2026-10-05 08:29:32 +08:00
DKChan 5294b12efa 秘宝批T3组F：aux_item域串16处→treasure_item+TREASURE_ITEM_TYPE常量族+reward_dangling_treasure诊断码（任务书漏计的常量消费方4处自查补齐，冒烟755/0） 2026-10-05 08:27:16 +08:00
DKChan dfd5fdd4df 秘宝批T2组C：architecture.md 两处既有断链清偿（../../design/gdd→../../gdd） 2026-10-05 08:27:11 +08:00
DKChan b4b8bb37e0 秘宝批T1组A+D：玩家可见文案5处+注释层「魔法道具」→「秘宝」全清（敌方语汇/道具工坊分色保全，冒烟755/0） 2026-10-05 08:27:04 +08:00
DKChan 30cabbdf52 初始展开收窄批T0-T4（迭代14①）：甲=剃雷域收窄（切比雪夫≤1+r 参数化 shave_ring_radius，r=1→5×5=25格，全域flood剃雷退役——零RNG消费变化同种子布雷逐位一致）+乙=R₀重掷闸（合法性闸序列 r0_cap_exceeded+同流重试+耗尽走三分出口accept_worst诚实降级+metrics r0_cap_rejected）+参数面（schema两列域校验[0,2]/[9,半板]加载期致命+19行投值）+calibrate扩r0方差/分位/闸触发列+参数透传；S1停机呈报已裁（用户方案A：10×10 cap 30→45——r=1自然R₀均值39>30锚结构性倒挂94%拒绝常态非法板，P1预案字面上调；12×12/13×13 43/51健康侧维持）；断言面=+12（R₀≤cap结构/r0_cap_rejected在位/ring_removed≤剃雷域候选/cap压线9诚实降级/确定性两遍逐位）+夹具复核3处（relic候选身份kind|tier|relic_id按TP0 v2.2、商店购买笔数推导防GP流漂移）；闸=冒烟767/0（755+12） 2026-10-05 08:19:41 +08:00
DKChan 9047fb0fde merge: 退役批——12份已完成中间文档删除（cf799b3，用户令2026-10-05）：五任务书+全局变异任务书+挖掘方案+ux-review+perfect-l1+三提案 git rm；指路句13文件全数git留痕（秘宝提案八拍板→57da58c/A3→a404a65/playnote题二→12e934b）；reward_expectation注释核正九型77；死链闸6=基线零新增 2026-10-05 08:07:55 +08:00
DKChan cf799b32a3 退役批：12份已完成中间文档删除（用户令2026-10-05）——git rm 五任务书（视野迷雾/GP商店房重构/魔法道具同调/双层BD/美术圣经v3.5）+全局作用域变异任务书+挖掘风险不等式方案+ux-review+perfect-l1+三提案（秘宝底稿/A3奖励格差异/playnote机制）；指路句改写13文件全数git留痕（roadmap六处/06/行动经济/entities三处/art-bible三处/地形变异改指调研§7/秘宝两处改指57da58c/冒险结构/关卡节点地图/元进度/clear_dominance_audit）+reward_expectation旧基准注释核正（七型79→九型77按reward.tres实证）+死亡清单四行勾销+执行注记⑤；死链闸6=基线同款零新增；秘宝提案八拍板/A3否决/playnote题二均git号留痕（57da58c/a404a65/12e934b） 2026-10-05 08:07:28 +08:00
DKChan 3c4291dbd9 任务书 v1.2：全改保一致（C1/C2 裁决关闭，待裁点归零） 
用户 2026-10-05 裁决：「只要是我们相关的概念对象/变量，全部统一修改，
保证一致性」。两条待裁点据此关闭。

**改名总原则（§4.0 新增）**：凡属本作「秘宝」概念对象的标识符——文件、
类、变量、方法、枚举值、字符串字面量、注册表键——全部换词。判据一句话：
该标识符是否指向「秘宝」这个概念？三类例外穷举：①敌方语汇（magic 格面族
/ magic_bolt / ward 魔法护甲 / arch_names）②玩家可见既有柜台名「道具工坊」
③跨局存档历史键。

**C1 裁决落地（§4.3，实测连锁面比预估小得多）**：`"aux_item"` 域串照改。
- `reward.tres` 已零 aux_item 数据行（池种随迭代 11 T7 退役）→ 原估的
  「改数据文件」连锁项**消失**
- 全仓 16 处字面量全在代码内闭合，**无跨局存档依赖** → 可彻底改
- 唯一保留连锁项 = `smoke_all.gd:3932-3933` 断言须同步
- 新增**组 F**（分派语汇与域串 16 处：adventure_runner 8 处 / reward_table
  枚举与常量 / battle_narrator / bonus_interact_controller / smoke_all 三处
  / reward_dangling_aux_test 夹具）

**C2 裁决落地（§4.2）**：`aux_items` 一名两义**拆分**——
- ✅ 改：ConfigDB 持有变量 `var aux_items` + 表注册键 `"aux_items"`
  （纯进程内，加载期取，不落盘）
- 🔴 禁改：断点存档键 `adventure_runner.gd:976/844` + 冒烟夹具
  `smoke_all.gd:4473/4495`（夹具构造的就是存档键，改则与真存档脱节）
- **关键认知：「键名禁改」与「变量名禁改」是两回事**——禁改的只是落盘的
  键名字面量，进程内变量名照改不误。这就把一处危险同名拆成
  「两可改 + 两禁改」的清晰边界。
- ⚠️ 与 registry 条目键 `aux_items`（`design/registry/entities.yaml`）
  区分：registry 条目键禁改（数据契约），ConfigDB 表注册键可改

**§4.1 存档键禁改清单成表**：六个键 12 处引用逐条列出写入点与性质，
要求代码旁加显式禁改注释；T7 卡增设 diff 专项核（逐字节比对，防破档）。

**任务卡 T0-T9 → T0-T10**（新增 T3 组 F），估时 5.0→5.5 日（超软盒 3 日
已知情预挂，T8 后 L3 呈报切点）。§7 标题改为「冲突面裁决记录（C1/C2/C3
已全部关闭）」，roadmap 迭代15③ 门改为「裁点已全决·可开工」。

现状补充：② 奇物批已收口落库（c571af2），C3 撞批消解，本批为迭代 15 唯一
在途需求。T0 须重取基线（判式换代 T5 读数 750/0；§1.2 的 747 为②前旧数
禁沿用）。
 2026-10-05 07:43:57 +08:00
DKChan cde68006b2 秘宝代码词族对齐批任务书 v1.1（C3 消解 + 事实表复核 + 编入 roadmap 迭代15③） 
前提：奇物批（迭代15②）已于 2026-10-05 收口落库（合并 c571af2），
本会话前一轮的 UU 冲突态解除，可安全编辑迭代序列。

任务书修订（v1.0 → v1.1）：
- §7 C3 撞批面**已消解**：② 已落库，本批为迭代 15 唯一在途需求，可独立开工。
  残留义务三条：T0 重取基线（判式换代 T5 读数 750/0、②又动数据层，§1.2 的 747
  为②前旧数禁沿用）/ T0 复核全部事实表 / 查清②"存档键正式迁移"待裁点状态。
- §2 事实表按②落库后复核修订三处：
  F1 文件数 35→**36**（`hero_info_panel_view.gd` 被②带入引用），处数 358 不变
  F3 玩家可见文案 3→**5 处**——**补入两处初查遗漏的真实玩家可见字符串**：
    `hero_info_panel_view.gd:56` `UiKit.label("魔法道具", 16, true)` 槽位标题
    `hero_info_panel_view.gd:178` `slot.tooltip_text = "魔法道具槽（空）"` tooltip
    （教训：`grep "魔法道具"` 命中 60+ 行但绝大多数是注释，字符串字面量需逐行核）
  F5 存档键引用 28→**34 处**（增量来自②带入的调用点；**②未迁移任何键名**，
    已核 `git show c571af2 -- game/core/adventure_runner.gd` 无键名改动）
- §3 组 A 补入上述两处 UI 文案，并加目检提示（C 区槽位标题与 tooltip 是玩家
  唯一会看到的「秘宝」二字）
- §1.2 判定 2 判据同步为 5 处基线

roadmap 新增迭代 15 需求③ 行（①调试整合已落籍 / ②奇物已落籍 / ③本批待开工），
标注 T0 重取基线义务与两个待用户裁点（C1 `"aux_item"` 域串是否随全族改 /
C2 `aux_items` 一名两义拆分）。

待用户裁点由 3 项降为 2 项（C3 已消解）。C1/C2 未决前不开工。
 2026-10-05 07:31:56 +08:00
DKChan c571af226f merge: 奇物概念收口与词族对齐（迭代15②号卡·文档与数据层） 
概念层由用户逐轮裁定定稿（《奇物》v1.0→v2.7），本批只做落地对齐。

主要内容：
- 新建 design/gdd/systems/冒险循环/奇物.md v2.7（本概念唯一定义文档）
- 新建 design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md
  （loop engineering 八件成文 + 12 条批末验收断言 + 11 条设计契约含 6 条停机级）
- 代码词族对齐：feature_* → FEATURE_KINDS/feature_quota_*/feature_value_*
  （adventure_table.gd 24 字段 + 方法 + 常量，adventure.tres 21 键，值零变更）
- 三个 schema 补概念指路注释；relic_table.gd / adventure_table.gd 概念注释指向奇物.md
- ux/battle.md、level-map.md、HUD框架.md、06-待办清单.md、02-系统清单.md、
  registry/entities.yaml 同步称谓与元信息

六处冲突解法：
- 02-系统清单.md：版本历史整段重编（master v0.1-v1.3 原号复原，奇物系列从 v1.4 起）
- ux/battle.md：取分支侧新称谓，但「魔法道具槽」须写「秘宝槽」（master v1.3 已更名）
- adventure_table.gd：合成并集（取本批改名 + 保留 master SR-1 商店刷新三字段）
- level_map_screen.gd：块1 取 master M5 底栏结构，块2 取本批配色与称谓
- registry/entities.yaml：7 处三方混战，块1-5/7 取 master，块6 取本批
- roadmap.md：迭代 15 两卡并存（①调试 已落籍 / ②奇物 待开工）

合并后自查修正：
- 批量替换误伤 70 处（清图奖励/安全格奖励/关卡大奖励/奖励身份预读 等
  属地图战斗资源域；「奖励道具经济」旧文件名与「迭代 10 奖励重构」属历史留痕）→ 全部回退
- battle.md 历史修订行误改 → 恢复 master 原文
- 奇物.md 5 处死链（../ux/ 少一层、魔法道具.md 已更名）→ 修
- registry 条目 markdown 链接 → 改纯路径（同文件惯例）
- 奇物.md R1 散文段 656 字 → 拆段，现在零结构性告警

验证读数（合并后主区全量复跑）：
- 冒烟 755 项 / 0 失败，三闸全过
- ui_input_probe 十六断言全绿
- ui_layout_probe 四区尺寸逐位吻合 battle.md 规格
- doc_link 死链 0；doc_term 与基线同；gdd_lint 零新增
- 旧标识符残留全 0；_status_box 未成死代码，四个投喂键齐全
 2026-10-05 07:24:15 +08:00
DKChan 3e2c564b59 merge: 判式换代批T0-T5全落（迭代14②号卡；冒烟750/0+run_all 15套+探针绿+doc三闸零新增） 2026-10-05 07:00:42 +08:00
DKChan b73e65f64c 主区脏件提交留痕（2026-10-05 用户裁「提交留痕」——卡②合并停机点三选一）：battle_orchestrator.gd 续行注释空格→tab 编辑器噪音，零语义零行为（字节级复刻主区在飞脏件）；主区 stash 同步作废 2026-10-05 06:57:01 +08:00
DKChan 06e94b7ff0 补记旧文件删除：魔法道具.md（重命名对的后一半） 
上一提交 430419c 因分两次 git add，git mv 的重命名对被拆开：
新文件以 A 入账、旧文件的删除未入账，导致工作区残留 D 状态。
本提交补齐删除记录，使 重命名(魔法道具.md → 秘宝.md) 在历史中完整成立。
内容零变更。
 2026-10-05 06:51:24 +08:00
DKChan 12428e56d7 判式换代批T5出口（迭代14②）：改后锚跑（MC n400同窗+verifier双窗重跑exit0——首跑campaign段互踩静默死亡在册）+判读三件（β带u=1/2带内u=3登记态/δ敏感度行为无感保留+登记/条件二等号压线转绿·整数量级u=3微欠-1.1%登记面）+audit条件二面板升级机制同式实算（w_flag_hit四舍五入跟随GDScript）+出口报告（provisional追认单8项含damage_probe A1改前既有红灯在册）+roadmap✅落地标注；锚换代=runsum_m4iter14mineq_post_n200_20261005现行 2026-10-05 06:51:17 +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 a4491f47f0 merge: 文档对齐批（9446302——README/CI/配置说明与现行实现对齐：调试浮窗换代/冒烟752/十探针/十五套件/三层收敛失效路径修正/历史锚清点，纯文档零代码零跑闸） 2026-10-05 06:49:11 +08:00
DKChan aafaa0c6c1 roadmap 迭代 15 行改写为双卡：①调试整合卡（已落籍）+ ②奇物批（本批待开工） 
迭代 15 已被调试功能整合批占用（master 8642c2d / 76cad66 已落籍），
用户拍板并入而非改号。按 loop 规范「一迭代 = 一句目标 + 3-8 任务卡」，
两批各作一张卡：卡①已落籍（0.5d），卡②T0-T8≈4.5d。

同时同步本批 v2.7 的子节点定名：分类改用专名「专长 / 属性值提升 / 资源」，
事实源版本 v2.6→v2.7。
 2026-10-05 06:47:03 +08:00
DKChan 9446302e9f 文档对齐批：README/CI/配置说明与现行实现对齐（纯文档零代码零跑闸）——①game/README 运行节：数值调整板→调试浮窗（迭代14.5整合批48c0b34/d0a3c6b，main.gd debug_overlay实证）、冒烟55项→752项（fdd32fe批末闸读数）+60.55s实测引用、九探针→十探针补t17_defer_probe（smoke/ roster清点）、supply_scan退役注记（2026-09-15格面资源批已删）②game/tests/README+unit/README：628+→752+断言、九→十探针、七→十五套件（run_all.gd _suites清点）、production/qa→design/qa、docs/→design/dev/（7f24b640三层收敛失效路径修正）③.github/workflows/tests.yml：根tests/路径→game/tests/+--path game（7f24b640后CI路径失效修正）、git未初始化陈述换代④static_scan.sh头注docs/路径同修正⑤sim-data/README历史锚8份→23份（M-4迭代11a/11b/12/14各批锚入库后清点）⑥CLAUDE.md探针行调整板→调试浮窗。均系可从代码/提交记录直接确认项，历史批条目未动 2026-10-05 06:47:01 +08:00
DKChan b6b43ebc2f 奇物 v2.7：三个子节点正式定名（专长 / 属性值提升 / 资源） 
用户指出缺口：父节点有专名，子节点只有描述没有专名。理由站得住——帮助 /
百科 / 成就页一定会把分类露给玩家（「首次集齐 4 件专长」「三件属性值提升」），
效果描述里的指代也需要名字；卡面不带分类是**呈现面规则**，与命名是两件事。

定名：**专长（Feat）/ 属性值提升（ASI）/ 资源**——去掉「类」字后缀。
- 前两个是 DND 官方中文，且与用户 v1.1 原话一致（当时原话就是
  「属性提升（ASI）」与「专长」，v1.1 落文时被加了后缀而退化成描述）
- 「机制类」这个叫法另有硬伤：28 个成员里没一件是"机制"，实际是
  "在结算挂点上改一条规则"，读者会误解为游戏机制
- 「资源」虽偏泛，但 1.3 已有判据句托底，且是用户自己的裁定

新增 1.6 节「三层结构与命名」——用户拍板的玩家可见三层：
  一层 奇物（总称）／二层 专长·属性值提升·资源／三层 具体单件
明确写成规矩：**命名归本节，呈现归 battle.md / node-reward.md 裁决**，
并记明代码侧四套词族对应（curio_* / feat_* / asi_* / res_*）。

连带修掉批量替换撞出的七处自撞（专长（专长）、专长 = 专长、资源（资源））、
1.1 节标题的「专长：专长」、1.5 节残留的「命名待定」与旧括注、
02-系统清单文档树行的重嵌套。另把五处「这一类/这类」改为专名指代——
专名定下后仍用「这一类」指代会让读者不知道在说哪个。

同步：entities.yaml（categories 补专名与定名依据、新增 hierarchy 字段、
naming_note 记 v2.7）、06-待办清单、02-系统清单 v1.9、任务书 T3 词族目标
（顶层 curio_* 与内层 feat_* 分属两套词族）、两个 schema 概念指路注释。

数据层零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 06:42:48 +08:00
DKChan 483cf2a39b 奇物批任务书 + 编入 roadmap 迭代 15 
用户令：概念层裁定已完成，代码与配置改动不做，整理成任务书编入迭代 15
作为该迭代的一个需求。任务书须满足 loop engineering 要求。

新增：design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md
按 roadmap §批次 loop 规范八件成文（缺件不开工）：
① 目标与完成定义（7 条可验）② 现状事实（代码级，T0 复核）
③ 设计契约（11 条，6 条 🔴 停机级）④ 范围边界（含"收到即停"清单）
⑤ 任务卡 T0-T8（逐卡估时 ≈4.5d，两段切分预案，切分点=T3 出口）
⑥ 验证闸（轻闸/重闸 + **12 条批末专属验收断言** A1-A12）
⑦ 异常分级（含本批预判的 3 个 L3 高风险点）
⑧ 代拍板白名单 5 项
外加：待用户裁点 4 项（不占本批自裁范围）+ 附录**设计裁定链 v1.0→v2.6**
（把 6 轮用户裁定的要点列全，供执行者回溯，不用回头翻 9 次提交）

三批内容：①三套旧词族对齐（feature_*→curio_* 103处/relic_*→feat_* 162处/
运行层 bonus_*→curio_* 160处；**硬约束 reward_* 已被占用不可用**）
②三条渠道按分类分离（现共用 98 张池、三类混编）③两个新种类入池
（刷新次数 + 专长门票四口径）附带 shop.tres 补回复与 charge 补至 ≥4 件。

roadmap 新增迭代 15 行（M-4 里程碑表内），标注：
- 与在途 M-4 各批（判式换代/全局变异/配比预设）**撞同一批文件**
  （adventure_table.gd / level_runner.gd / adventure.tres），
  **开工门 = 须确认不并行或用户明示插队**——这是本批最实际的调度约束
- 门 = 迭代 14 出口；估时 T0-T8≈4.5d 可两段切分

🔴 红线里最要紧的两条（都是本会话教训固化）：
- 兑付频率：奇物不是打一场战斗给一份，关底 Boss 击败＝通过这一关是
  同一个时刻；专长不得挂在"战斗结算后"（v2.6 用户纠错）
- 两条轴互不决定：禁止"因为要进商店所以另立分类"这种反向推导
 2026-10-05 06:15:01 +08:00
DKChan 8642c2d0bc merge: 迭代15改编登记（76cad66——调试功能整合卡自14.5临时卡改编入册迭代15行，落地事实零变化） 2026-10-05 06:05:27 +08:00
DKChan 76cad6645e 迭代15改编登记批：调试功能整合卡入册roadmap迭代15行（2026-10-05用户令——原14.5临时卡不再独立存在，改编入迭代15，落地事实/验证读数/遗留项零变化只改编号归属；行内✅已落籍标注引用台账352提交链48c0b34/46dadbb/d0a3c6b/10c301b+实机目检遗留；门列注记=本卡先于迭代14出口落籍不构成追溯闸）。纯文档零代码零跑闸（两入口铁规：非loop批且用户未点名） 2026-10-05 06:05:09 +08:00
DKChan 3c5515aec4 奇物 v2.6：修正核心循环图——奇物不是打一场战斗给一份 
用户纠错：原图把「关内 排雷推理 → 战斗结算 → 通关 → 得到一份奇物」
画成一条链，读起来就是每场战斗通关都给一份。

**错在哪**：把关内普通战斗的"打完"与关底 Boss 的"击败"混为一谈。
按 [冒险结构](冒险结构.md) 的定义，**通关一关 = 该关关底 Boss 被击杀**
——所以"击败 Boss"与"通过这一关"是**同一个时刻，不是一条链上的两步**。
用户原话点得准："击败 boss 之后通过关卡，这跟打败 boss 是一个渠道。"

改法（五处，链条口径与渠道名一并统一）：

1. **图改分支结构**：普通战斗节点 → 打完不给、往下走；奖励节点 / 商店
   各自兑付；关底 Boss 击败 ═ 一次专长三选一 + 通关回血 → 进下一关
2. **显式口径"一关只兑付一次，不是一场战斗给一份"**——写在图下方
3. **2.1 节渠道名**：「终局前 Boss 击败后」→「关底 Boss 击败（即通过这一关）」，
   并写明触发点就是关卡推进本身那一刻，不是"战斗结算之后再奖一次"
4. **文首引言加"兑付频率"条**（标为三条渠道的共同前提，先看那条）；
   交叉表渠道名、registry 的 acquisition 字段同步
5. 06-待办清单新增"兑付频率（用户纠错后写死）"条目，注明勿再改回链式

连带修掉一处 v2.4 遗留污染：2.1 节节点类型封闭枚举五种里的"奖励"
曾被批量替换误伤成"奇物"（节点类型里没有奇物这一类），已复原为
「战斗 / Boss / 奖励 / 恢复 / 商店」。

术语微调：「终局 Boss 不给」→「末关的 Boss 击败后不给」——前者读起来
像在讲一个叫"终局 Boss"的实体，实际是"最后一关的那个 Boss"。

数据层零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 06:02:21 +08:00
DKChan 128078780f 奇物 v2.5：第三类定名「资源类」+ 回复归属定案 
父节点定为「奇物」后，Q6（第三类命名）解锁，本批收口。

一、第三类定名「资源类」（用户拍板）
四个成员——行动点上限 / 刷新次数 / 金币 / 回复——都是可以调动、可以
花掉的余量，故名资源类。「资源」偏泛（能力资源、财富资源都叫资源），
因此在两处写死判据句，这是把泛用词收回本类定义的唯一凭据：
- 1.3 节新增专属判据：**给的是可以调动、可以花掉的余量，不是角色基础
  属性的永久抬升**。拿不准时问一句：它会不会进角色自己的属性数值？
  会进的归属性提升类，不会进、变成手里多出的次数或钱的，归资源类
- 1.5 命名出处节记明该偏泛性并指回 1.3 的判据句
（1.4 是三分类总判据，1.3 是资源类专属判据，层次不同不重复）

二、回复归属定案：留在资源类，不拆第四类
理由是它与金币同为**即时兑付**、都给的是可花掉的余量，判据完全同源。
拆出去之后第四类只剩两项，且与资源类的判据重合——分类的价值在于判据
能一刀切得开，拆一个判据同源的类只会让读者多查一张表。

三、附带修掉两处结构问题
- **1.5 段末与「### 2. 渠道轴」标题粘连**（缺换行，导致第 2 节标题被
  吞进 1.5 段落里，目录层级失真）
- entities.yaml open_questions 编号跳号（缺②、含两条已解决项③⑦），
  重排为五项：类内异质性登记 / 门票四参数无事实源 / 档二不可达延后复裁 /
  charge 仅 3 件数据缺陷 / 断点存档键换名待裁
- entities.yaml naming_note 笔误：「v2.0 曾名「奇物」」→ 修正为
  「v2.0 改名为「奖励」，v2.4 定名为「奇物」」

同步：06-待办清单（条目标题、交叉表行、待拍板项由三项减为两项、现状
描述）、02-系统清单（文档树行 + v1.8）、两个 schema 概念指路注释。
全文「资源与机会类」零残留（仅 02-系统清单 v1.5 版本历史行保留原名，
按规范版本历史不改写）。

数据层数值与表结构零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 05:46:54 +08:00
DKChan a2ce5d7e01 奇物 v2.4：顶层定名 Wondrous Item（奇物） 
顶层概念由「奖励」改名为「奇物」（Wondrous Item）。

定名依据：DND 魔法物品九分类中的 Wondrous Item，官方中文译名即「奇物」，
是专装"不好归类但有奇效之物"的兜底杂类。选它的理由——本概念下三个分类
（规则 / 数字 / 余量）本来就没有共同点，能把它们拢在一起的只有一个
"不好归类但有用"的名字，而奇物天生就是干这个的。

落选者（都登记在 06 备查）：
- Treasure（宝物）：DMG 第 7 章正式术语，定义含 coins/gems/art objects/
  magic items，四条筛选全中，但偏"财物"，装不下专长这种
  "你会了件以前不会的事"
- Relic：roguelike 品类惯例（杀戮尖塔 / Soulbound / 铲子骑士 Pocket Dungeon /
  Die in the Dungeon，后两个明确"局内可买可捡、run 结束清零"，与本作同构），
  但用户已否决「遗物」
- 全部自造词（进益 / 造化 / 机缘 / 遇获）：用户否决

**代码词族定为 curio_* / ADVENTURE_CURIO，不用 reward_***——
reward_pick（rng 封闭流 scope）/ reward_node（grant_aux_item context）/
reward_preview（道具 kind）已占用 reward 词族，照 reward_* 对齐会撞车。
06 里原「feature_* → reward_* 对齐」待办据此改写为 → curio_*。

改名范围（文档名 奖励.md → 奇物.md）：
- 全文称谓、判据句（当局清零的是奇物，跨局带走的是魔法道具）
- 1.5 命名出处节重写（补 Wondrous Item 出处与落选理由）
- 02-系统清单：文档树行改名、ADVENTURE_REWARD → ADVENTURE_CURIO、v1.7/v1.8
- 06-待办清单：链接与称谓、三层约束表、命名统一后续条目（目标词族改 curio_*）、
  「顶层命名待定」条目改为已定
- entities.yaml：reward → curio、owner 路径、正文称谓（保护「奖励节点」）
- battle.md / level-map.md：奇物列表；HUD框架.md：奇物段先例
- 两个 schema 概念指路注释

**保护未动**：「奖励节点」（渠道名）、格面奖励 / 清图奖励 / 大奖励 /
节点奖励 / 奖励重构等历史与他概念用词——全部逐条核对未误伤。

数据层数值零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 05:25:28 +08:00
DKChan fdc43ef538 判式换代批T4（迭代14②）：标中兑付溢价机制——settlement新键flag_hit_premium=125（percent域[100,999]域校验，100=无溢价直通零扰动）+grant单点乘溢价（_grant_routed只挂flag_hit正向：flat power乘后入单据/治疗/排队，percent幅度经premium_pct贯穿_apply_percent_row应用与呈现同乘+容器magnitude_override同快照）；取整四舍五入与伤害管线floor分域（registry登记）；标空/挖格/清图不乘；DamageController零改/雷安同池冻结/直伤6-8-8与p_perfect不动；冒烟断言+3（配置在位/标中行逐型=同型正向×125/100九型全确定/标空负向直伤零溢价）；max路径存储种子42→43重采（δ换代战局位移=断言注释既定程序）；闸=冒烟750/0 2026-10-05 04:35:03 +08:00
DKChan eaf1ae9184 奖励 v2.3：门票机制细化 + 默认原则表述修正 
一、门票机制四条（用户 2026-10-05 定）
- **拿到即开、不可囤积**：不进持有集，选中/买下同一时刻开专长三选一。
  可囤积会让玩家把关键决策无限推迟，且把持有物语义从后门放回来；
  "道具"只是卡面表现，不是持有物
- **罕见只在概率，不在价格**：货架价与其他商品相当，不靠高价劝退
- **一局限购一次**（现行口径）
- **计步保底**：连续 5 次三选一展示未出现 → 第 6 次展示必定出现。
  计数对象＝**展示次数**（刷新后的重新展示计入，用户明定含刷新——
  若刷新不计入，保底与刷新两套机制会打架，玩家可用刷新绕开计数语义）；
  计数范围＝奖励节点与商店**共享**；触发后清零；**限购用满后不再触发**

二、修正 v2.2 的误读（用户指出）
v2.2 把"分类在某渠道不出现"当成需理由的缺格，这是错的。
**渠道出哪些分类，是渠道轴自己的定位决定，不是例外**——Boss 只出专长，
另两类"不出现"是它的同义表述。默认原则**只管分类内部**：一个渠道一旦
确定要出某分类，该分类的成员就都要在池子里。两句话管辖范围不同，
已在文档与 registry 分开写死。

三、档位问题按用户决定延后，但两块都登记
- 专长总量 vs 档位阈值（≥2 档一 / ≥4 档二）：三关下确定性 2 次 + 门票
  最多 3 次，**档二几乎不可达**。用户定"先不调整"（后续有第四关），
  复裁触发＝第四关内容批落地后实测。登记防忘。
- **charge 标签仅 3 件**（relics.tres），永远达不到 4 件档二——
  数据层缺陷，与渠道结构无关，单独登记勿被上条盖掉。

四、顶层命名待定（用户否决了「奖励」与「收益」，要自造词）
新增待办，并记一条硬约束：**代码 reward 词族已被占用**——
reward_pick（rng 封闭流 scope）/ reward_node（grant_aux_item context）/
reward_preview（道具 kind）。因此 06 里「feature_* → reward_* 对齐」
那条待办**不能照做**，会撞车。候选词：进益 / 造化 / 机缘 / 遇获。

同步 06-待办清单、entities.yaml；验收标准补 11/12 条。数据层零变更。
 2026-10-05 04:25:54 +08:00
DKChan 93e225564b merge: SR-1改名（MC-1→SR-1 商店刷新批，消除MC黑话撞车） 2026-10-05 03:53:43 +08:00
DKChan c884969d4b SR-1改名：落码计划/06 的商店刷新批代号 MC-1 更名 SR-1（消除与蒙特卡罗MC黑话撞车——用户误解案例 2026-10-04） 2026-10-05 03:53:02 +08:00
DKChan fdd32fe2eb merge: MC-1 商店独立刷新机制（落码收官核心批；冒烟752/0+探针全绿+layout 0） 2026-10-05 03:51:31 +08:00
DKChan ac3cee7daa MC-1 商店独立刷新机制（UI落码第三波收官核心批）——level_runner新增shop_refresh/free_left/cost三面(GP扣费+货架整架重抽shop_draw同签+付费计数进离清零)+adventure_table三旋钮(免费0/基价20/曲线1.8 provisional)+shop_overlay刷新钮转正(set_refresh_display投喂面)+presenter on_shop_refresh+main接线+冒烟5断言(752/0)+关卡节点地图v1.6换代+冒险结构v0.15回写。机制=P-C2+Q2裁(基础免费0/天赋增益位预留/GP ceil(20×1.8^n)/池源同源)。闸=冒烟752/0+probe_gate全绿+layout 0 2026-10-05 03:51:10 +08:00
DKChan 26374accb3 判式换代批T0-T3（迭代14②）：audit常量刷新（池77/直伤6-8-8/heal2/清图24-40/AP8/off_guard-1/伏击退役/九型字典/β带+逐型输出——改前静态锚判值与方案报告§四逐位吻合）+runsum五字段落码（flag_placed/hit/miss/gain/penalty——行侧判据考证=授予行专带highlight，状态复发行排除，实测87行==87插旗1:1）+F1条款3重立三层口径（聚合健康式只留下限0/旗边际引理/条件二旗溢价δ=0.25登记已知破）+β带[1.2,2.5]判读入文+η读数入文+战斗结算gp/ap当量注记+验收条款3对账+难度联动表+6行+P1改判读回执+registry clause3_inequality重立条（改前锚+P7两点修正）+06破线条收口+07⑫旗溢价目检项；闸=冒烟747/0+doc三闸对基线零新增（worktree死链+2系gitignored路径环境性） 2026-10-05 03:43:42 +08:00
DKChan d6c13809a5 奖励 v2.2：门票形态 + 约束分层 + 默认原则 
一、非 Boss 渠道给「专长获取」门票（用户明确）
奖励节点与商店不直接给专长，而是给一个道具——拿到后开专长三选一。
交叉表机制类在两渠道由"不出现"改为"**门票形式**"。
- 门票归**机制类**不归资源与机会类：它给的是"一件你以前不会的事"，
  只是把选择推迟到一次三选一（按 1.4 判据）
- 为什么只给门票：若商店能直接买到指定专长，玩家能用金币把构筑买出来，
  Boss 渠道"打赢才拿到"就失去意义；门票保留惊喜（三选一不是指定），
  但不让钱定点购买

二、用户质疑「计价物不自售」本质是特判——质疑成立，重构为三层
诚实结论：**形式上它确实是特判**（在分类白名单之外加的一道过滤，
不是从分类推出来的）。与死特判的实质区别在于：
  死特判 = "GP 不进商店"（一条记录，每多一个例外加一条，靠记忆维护）
  可计算谓词 = "X 是渠道 C 的计价物 → X 不进 C"（一个函数，自动判定）
即：没有消除"白名单外加过滤"，但把**枚举例外变成计算谓词**。
渠道约束改写为三层：
  一层 分类白名单（分类轴决定渠道）
  二层 可计算谓词（结构性关系，新渠道/新奖励自动判定，不用改表）
  三层 显式例外清单（人为设计选择，只能逐条加，**每条须写理由**）
判据：结构性原因（计价物/即时兑付/先决条件）写成谓词；设计性原因进清单。
**要害不是有没有例外，而是例外能不能被算出来。**
三方案代价并列摆出不藏折中：甲 GP 单独立类（例外 0 但两轴缠回）／
乙 谓词（现行，1 条）／丙 死特判（靠记忆维护）。
在册约束就两条：①金币不进商店（二层·谓词）②机制类非 Boss 渠道只给门票（一层）。

三、立默认原则（用户定）：除已登记的特殊规则外，分类内的东西都要在
它该出现的渠道池子里——任何"不出现"都要登记理由，没理由的缺格是缺陷。
据此**回复应在商店内**（回复不是计价物，套不上计价物不自售）。现行
shop.tres 货架只有 attack/max_hp/armor/ap 四项，缺回复＝现状与表格
不对齐，须在实施批补上。

同步：06-待办清单（交叉表改门票 + 三层约束表 + 待拍板项增为三项）、
entities.yaml（acquisition 收口、channel_rule → channel_constraint_layers、
open_questions 更新）、02-系统清单 v1.7。验收标准补第 10 条（默认原则）。
专长门票尚未入表（出现概率/配额/全局限量无事实源）已登记。

数据层数值零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 03:34:26 +08:00