Commit Graph
28 Commits
Author SHA1 Message Date
DKChan 6376356539 docs(通关口径统一): 「通关」全库退役——主体明确短语族替代歧义单义词:单关=关卡完成、整局=冒险成功、终结统称=冒险落幕(2026-10-26 用户裁)
改写范围:design/gdd 18+ 文件约 130 行非豁免正文+「冒险终结→冒险落幕」13 行+根件(体验验证清单/待办清单正文/AGENTS)。三类豁免不动:带日期历史行、待办条目标题(冻结登记元数据)、「」UI 引语(生涯页「通关局数」等玩家字样另按对外命名纪律单独裁)。术语表:「通关」「通过第 N 关」两行退役,新立关卡完成/冒险成功/冒险落幕三行,三选一行随改;退役词对照收通关/冒险终结。闸词表:doc_term_audit 收两词+通关的引语语境豁免,此后正文误用即机检拦截。特判三处:棋盘生成「可通关」=棋盘第三义改「可清图」;地形变异「双关同型」改「两关同型」;00-游戏概念 minesweeper 双关系 pun 义保留。计数器键名(adventure_cleared/level_clear_counts)与测量数据键零触碰。「通关口径混用」条目(2026-10-18 登记)完成即删。--docs 域闸全绿(退役词疑似现行 0)
2026-10-26 06:05:20 +08:00
DKChan 6c761e1369 docs(批后收尾): 迭代 35 结项——反哺点十七条落文+代拍板两单整单追认+中间文档十二份退役+账面换代
反哺点落文(用户 2026-10-25 逐条裁「全部照此落文」):卡①① 多终点深度互异改「互异节点深度」并补深度算法(最长路径、多入口取最长、不取最短的理由);卡①⑦ 增「支路互异上限=出口数 3」摆放约束;卡①②/卡②① 地图深度定义改最长路径、三处「节点编号」换「节点深度」;卡①③/卡②② 冒险结构覆盖义务换代为敌侧带命中+板侧解析命中+深度域 L1 0–6/L2 0–9/L3 0–13,删「旧模板池随实现批清数据」;卡①④/卡②④ level-map 登记生成图随动——入口停点候选数=入口个数、节点数字=图内句柄 id、L3 深度域超出冻结画布约 10 层屏预算(等比缩放/滚动视口两案未裁,只登记缺口);卡②③ 核对无用语漂移。版本:生成 v1.3、地图 v2.3、level-map Last Updated 2026-10-25。

代拍板:卡① 六条+白名单外两件、卡② 六条+超清单五件,按用户令整单追认(推翻项零)。

中间文档退役十二份(吸收即死):两张需求卡片、两卡实现报告/代拍板/反哺点/验收审计共八份、两份停机呈报;引用面已改写(待办证据指路改 git 提交 5499eb9c)。目检四条迁体验验证清单 ㉝。

账面换代:roadmap 迭代 35 行改「已完成(2026-10-25)」、卡片与实现报告列填退役保留字,顶部当前位三行换代;待办清单 06「关卡节点图重构」条目整条删除(完成即删),新增三条代码件待办(验证集清单重生成、测试宿主改名、level.tres 表尾叙事订正),图包络条目同步 v1.3 引用与实测越界事实。

本批为文档批:零 game/ 改动、零测试执行、零 MC。
2026-10-25 01:28:36 +08:00
DKChan 53f5d9cd69 docs(批后收尾): 迭代 34 结项——反哺点十条落文+代拍板十三项追认+中间文档九份退役+账面换代
落文(反哺点 ①②③⑤⑥⑦⑧⑨⑭⑮,经用户逐条裁决):
- 敌人系统.md:寻址词族「同坐标/坐标行集」改「同带键/带键行集」五处,大地精行示例改寻址键 (1, battle, 3)
- 关卡节点地图.md v2.1→v2.2:Boss 描边改紫赤+深墨环(依视觉定稿 level-map);补实现语义三句(层距=BFS 层差/Boss 与候选节点双豁免恒显类型/可见性只算当前圈不累积记忆);递出物改关卡序号+节点深度;info_visible_layers 已落数据表现行值 2
- 关卡节点图生成.md v1.1→v1.2:产出约束五条→六条,新增「多终点深度互异」;岔路取舍补候选集豁免类型可见性已兑现;调参表补图包络行(≤屏预算,超预算只限参数档)
- level-map.md:信息层级第一层补类型可见性指针;画布公式记数订正(宽 70+层深×122+44.5、高 52+槽位×58+25+24,下限 620×256)——定稿语义不动
- 术语表.md:新增「关卡与地图」节,收「信息迷雾」(与视野迷雾区分,标识符禁 fog_ 前缀)
- test-conventions.md §9.4:补「判据绑可观测提交面」一条,来源=迭代 34 探针首版假绿的教训(吸收原卡片 T2 描述项)
⑬ 超预算图策略无设计落点 → 待办清单新登记条目(设计面=文档轨,状态=待文档设计)
⑯ 卡片 T2 接口描述订正 → 判由 ⑭ 吸收,卡片随批退役不改

代拍板:迭代 34 两份代拍板单十三项(卡③ 六项+卡④ 七项,含卡④第 7 项白名单外甲案返工)用户全部追认,异议窗口关闭。

退役(吸收即死):reports/ 下迭代 34 产出物七份(实现报告/代拍板/反哺点清单/验收审计四份)+两份需求卡片。引用面已改写,doc_link 死链检查绿。

账面:roadmap 迭代 34 行改「已完成(2026-10-22)」、卡片列与实现报告列填「已退役(git 历史可考)」;顶部当前位迭代位与下一步换代。待办清单删迭代 34 两卡行、关卡节点图重构条设计定稿版本升 v1.2/v2.2、新登超预算图条目。体验验证清单登记 ㉜ 迭代 34 实机目检四项(不阻塞)。

域判定:diff 全部落在 design/+reports/+两份根流程清单+roadmap.md,纯文档域,故取 --docs 回执。零游戏测试执行(测试两入口铁规),结论均为静态核对。

已知缺口(不在本批修):待办清单从未设迭代 34 反哺点专条,落文凭据无处登记;roadmap 迭代 35/36 行仍写「待开工」与实际不符(35 卡①已合回、卡②停机;36 三卡已合回并收尾),留待用户发令订正。
2026-10-24 23:58:03 +08:00
DKChan 4d03c3457c docs(关卡节点图重构): 关卡节点图生成 v1.0 落定+关卡节点地图 v2.0 多终点换代——产出规格唯一陈述处/五旋钮参数档/深度带配池/每终点前一店,文档域闸全绿(回执 domain=docs) 2026-10-21 04:42:51 +08:00
DKChan f100e19275 docs(gdd): 删除「关卡节点图生成」旧版文档(用户令 2026-10-21)——出度≤2/层宽≤4 旧规随档退场;引用面八处改指路文本(02 索引行/08 行/关卡节点地图/冒险结构/level-map/待办清单两处/Alpha梳理);归档副本落主区 archive/,随关卡节点图重构批重写 2026-10-21 00:53:42 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设+三工具去豁免+48 文档删节+game/README 流水段删+代码注释 900 余行轨迹标签清偿(约束句保留)+规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
DKChan 04014c0164 docs(术语): 术语刷新补扫批——组一定性条目+组二正文漏网+组三批名全换代(2026-10-18 用户三裁)
- 组一定性条目八处:registry「封印」条由「插旗的呈现名/纯呈现层命名」改判正式动作名(全库统一)、「金币(GP)」条键名更名 GP+删「玩家侧显示名『金币』」、battle.md:128 呈现术语注记同判(占位字形目标改「封」、注明现行代码旧字形随代码批换代)、显示名「金币」四处(关卡节点地图/难度曲线/元进度/秘宝 GP 付费档)+level-map 金币图标+05:13 旗做道具行(与 08:186 同条目两半的一致性补齐)
- 组二正文漏网约 110 行/21 文件:旗生命周期节正文与结局表、行动经济价目表封印行/资格条款/条款2 封印标中锚/δ 系数/η 分母、战斗结算极性矩阵句/四情况标题/标中资格段/完美排雷句/事件面/验收清单、增益状态标空封印行与来源列、地图战斗资源九型字典 gp 行(gloss 金币→财货,随 art-bible 既有口径)、奇物跨族桥/凭证件表、07 各观测条、06 两条现状行、battle 布局/输入映射/演出/光标语义、entities.yaml 约 30 行现行条目(flag_rules/标中旗→封印标中/连锁不越封印条键/display_name/链不越封印等)+正文雷格五处补扫(#注释留痕保留)
- 组三批名全换代:插旗不可逆批/插旗不可逆四情况→封印不可逆(全库含 07/行动经济/结算/排雷玩法/地形变异/教学/entities,122/126 不一致抹平)、标中旗锚→封印标中锚、拔旗动作退役→移除动作退役
- 有意保留:术语表对照行、06:546 裁定引文、用户原话引举(07:80「不能挖旗格」/07:28 旧预期列)、更名记载(排雷玩法:10)、原「口袋旗」「拔旗重插」对照引用、旗朱色彩沿革链(2026-09-28 人设脱钩裁定的在役概念,组四用户裁保留)、battle:402/403 历史落稿留痕清单、entities # 注释留痕两处、代码键名(flag_* 归代码批);美术(design/art/)零触碰
- 自检:doc_term_audit --strict 零疑似现行(378 命中全留档类);gdd_lint 10 文件零不通过;doc_link 死链 0;正文残留终审仅余上述有意保留项
2026-10-18 23:55:15 +08:00
DKChan bbd49abfb0 docs(术语): 设计文档术语刷新批全量入库——2026-10-18 用户裁定(金币/插旗/旗/雷格/惩罚格 五词)design/+tools/ 域落文
- 术语表 v1.13:GP 唯一正式命名(删「局内金币」别名)+旗/控制词条更名封印/控制+封印定性由「插旗的对外表达」更正为正式动作名(全库统一、非比喻)+禁用字面从对外命名扩为全库+删「机制文档内部用语不受限」条款+退役词对照表补三行(金币→GP/插旗→封印/旗→封印印记)+危险格词条「被旗控制」→「被封印控制」+B3 豁免例举去旗
- 机检扩容 tools/doc_term_audit.py:RETIRED_TERMS 新增 金币→GP、插旗|标旗→封印 两行(DEFAULT_DIRS 不变,game/ 扫描归代码批);拔旗|撤旗行继任措辞随批换代(插旗不可逆→封印不可逆)
- GDD 全域正文换代约 200 行/31 文件:金币→GP(金币袋→GP 袋)、插旗/标旗→封印、雷格/惩罚格→危险格(2026-10-11 退役批存量补扫)、旗概念→封印印记(旗判定→封印判定/标中旗→封印标中/标错旗→标错封印/旗格→封印格/旗位→封印位等复合词系);00-游戏概念「封印降级为类型风味词」定性翻转;修订记录/版本历史/禁令引举/更名记载等留档行零动
- registry/entities.yaml(信标网络可达性/事件序/回执驱动三处)+art 五件(art-bible 封印印记六处/comfyui 背旗→背负封印印记/两清单)+dev 七件(architecture 旗集→封印集/code-conventions-cases/test-conventions/架构图 html json 四件)随批换代
- tools 四脚本注释与图内标注换代(clear_dominance_audit/render_sample_sheet×2/analyze_playtest;代码标识符零动归代码批)
- design/qa/代码术语审计报告-2026-10-18.md 随批入库(本批参考素材,06:578 引用闭合 doc_link 死链)
- 06-待办清单/术语表两在途脏件(代码术语批 06 登记+A 表头「不用→禁用」)随批一并入库

自检:doc_term_audit --strict 零疑似现行(45 文件 434 命中全留档类);文档域六闸验收通过无新增红(gdd_lint R3 对 00 正文修订注记一次打回已去注记化改写;doc_link 死链经报告入库闭合);正文残留仅 06:73「拔旗」一处(件派生动词白名单豁免语境、机检同款豁免,设计意图记录不动)
2026-10-18 06:15:38 +08:00
DKChan 86169065af docs(用语): A 表全量词面换代批(2026-10-16 用户令第一步)——design 四域 36 文件机械替换约 371 处:随批→顺带 123、收口→完成 114、落文→写入文档 76、不得→禁止 53、台账→状态记录 35、对拍→逐项比对 12、销号/销账→注销 12、在飞→正在执行中 3、不报错→不返回错误 1;豁免面零触碰——版本历史既有行、对照性替换记载句(「X」→「Y」)、术语表与 doc-conventions 条文自身、engine-reference 留档区、美术审计会话存档、buff/debuff 代码标识符、「不得不」惯用语;难度曲线与Boss「随批次扩展」改「随后续批次扩展」避词面误中;三闸全绿(gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0 含 --strict 复核);闸门升级(--strict 入钩子+豁免基线清单)按用户令留待后续讨论 2026-10-16 02:17:00 +08:00
DKChan 4d3f8d6653 merge: master 二次吸收(ADR 体系废除批+布局闸入库)
# Conflicts:
#	design/gdd/02-系统清单.md
#	design/gdd/systems/冒险循环/冒险结构.md
#	design/gdd/systems/表现与支撑/数据配置.md
#	design/gdd/ux/battle.md
2026-10-16 00:08:01 +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 83c88c4566 docs(gdd): 用语规范批 W3——表现与支撑 16 处+ux 55 处词面换代(收口 19/台账 17/随批 11/不得 12/buff 1 等按 A 表)+死链终清(config_fatal_probe 迭代19退役去向双证并入数据配置 v0.4 行注)+camp 文头 v1.5/level-clear Last Updated 失同步补齐。伏击者留痕与验收口径子串误报按豁免保留 2026-10-15 23:11:18 +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 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 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 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 33fcac79e8 奖励 v2.0:顶层改名 + 重构为两根轴(分类轴 × 渠道轴)
顶层概念「特性」改名为「奖励(Reward)」。改名动因:这个筐里既装
"角色自身的变化"也装金币这类一次性兑付物,用"自身提升 vs 持有物"
已经切不开——边界判据改由生命周期承担:
  一次冒险内获得、冒险收束即清零的是奖励;跨冒险跟着你走的是魔法道具。

分类由两类扩为三个枚举(分类轴 = 给的是什么):
- 机制类(专长 Feat)      → relics.tres
- 属性提升类(ASI,生命/AC/攻击三轴)→ adventure.tres
- 资源与机会类(命名待定:行动点上限/刷新次数/金币/回复)→ adventure.tres
  类内异质性显式登记:金币与回复是即时兑付,不进持有集、不持续生效,
  与行动点上限/刷新次数生命周期不同。

新增第 2 节「渠道轴 × 分类轴」交叉开关表:机制类主渠道=关底 Boss
击败后(不新增节点类型),罕见旁路=奖励节点/商店的「专长获取」;
属性提升类与资源与机会类=奖励节点 + 商店。两根轴互不决定。

gp/heal 不再当作"该移出去的脏东西"(用户 2026-10-05 选暂不处置=
不做结构性迁移、不动配额),改为安置在资源与机会类里并登记异质性。

同步:02-系统清单(文档树改名 + ADVENTURE_FEATURE → ADVENTURE_REWARD +
v1.5)、06-待办清单(BD 分层条目改写 + 新立「两个新种类入池」条目 +
「命名统一后续」补 feature_* → reward_* 对齐项)、entities.yaml
(feature 条目 → reward,新增 axes / 三类 categories / open_questions)、
两个 schema 的概念指路注释、battle.md / level-map.md / HUD框架.md 称谓。

未动:数据层数值与表结构(值零变更);feature_* 标识符尚未换到
reward_*(属临时态,已登记待办,须在可跑冒烟批次收口);game/ 下
运行层称谓换名同批。本会话按测试执行两入口铁规零测试。
2026-10-05 03:01:13 +08:00
DKChan 5cf7f4b6ae 立《特性》概念:局内加强物品统一命名为「特性」,两种形态收敛为枚举值 + 文档/称谓/数据层标识符统一
- 新增 design/gdd/systems/冒险循环/特性.md(概念唯一定义文档)
  定义=一次冒险内角色自身得到的提升(不是持有物);作用范围、生命周期、
  获取途径(战场奖励/商店·训练)、关联与边界五要素齐全;数值一律指路表不入正文
- 02-系统清单:冒险循环补行 + 命名对照表补 ADVENTURE_FEATURE
- registry entities.yaml:新增 feature 概念条目(owner/referenced_by)+ adventure_table 字段名同步
- 数据层标识符 112 处换名(值零变更):BONUS_IDS→FEATURE_KINDS、bonus_token_count→feature_quota、
  bonus_value→feature_value、token_*/bonus_*_flat→feature_quota_*/feature_value_*
- 称谓统一 94 处:旧称「流派件/数值件/本关强化」→ 特性 + 形态修饰语(规则改写型/属性加成型)
- 两张 schema 顶部加概念指路注释,代码可直接查到定义文档
- 06-待办清单:BD 分层条目现状改写 + 新增「命名统一后续」条目(relic 词族与类名对齐待实施)

未动:类名与文件名(Godot .uid/.tscn 引用需跑测试自证)、断点存档键(兼容)
2026-10-05 01:46:35 +08:00
DKChan a6833b6ac3 docs: 中间产物死亡清单 A/B 桶执行批——git rm 83 件(A1跟踪12+A2全部8+B1跟踪19+B2全部9含playtests/conversion-calibration/t5预览两目录)+指路句改写13文件37处改结论内联或git提交号(art-bible/level-map/07/魔法道具/HUD框架/难度曲线/关卡节点地图/元进度/entities/06/roadmap+三render脚本);删前核三过一留(alpha-acceptance-battle-screen系Alpha验收销项底单留待裁);在飞域四件挂债未碰;死亡清单补执行记录节(部分执行不自删);闸=死链4环境差+术语1既有+熵增PASS全回基线;依2026-10-01吸收即死铁律与doc-conventions§11 2026-10-02 05:39:51 +08:00
DKChan 5dde454b54 docfix-a: 文档卫生批(拍板点10甲执行)——GDD审计口径冲突逐项回写21文件:6/9/1勘误/三关序列/难度带现行口径+判读口径行重建/库存已随迭代7落地/封印黑现行/载体退役留档/SCHEMA_VERSION=2/图上点击唯一通道/敌型四型/refresh_cap表值口径等+八文版本史数值升序重排 2026-09-30 19:38:53 +08:00
DKChan dfd2eac0f2 rulings-4a-4b-5: 三裁决执行——①4A=乙+元进度配套:新建 ux/camp.md v1.0(存档级呈现面:三柜台/钥石徽/退役封存件状态语义)+元进度解锁双入口节更新(spec指路+9A终稿已落)+node-reward:22悬空指认修复;②4B=甲+乙:新建 ux/shop.md v1.0+关卡节点地图商店覆盖层呈现编排小节+level-map不覆盖清单对齐;③拍板点5=三分工原则(GDD概念/ArtBible美术/UX设计)裁甲:HUD框架立「可挖域指示(接触带微光)」节(五要素,生命周期按代码实态set_dig_glow_enabled=挖掘期门控)与类型微光成对;④新增拍板点11呈报=元进度树位结构性问题(用户立项,三案:甲第五循环目录/乙域声明/丙仅索引;分析三实据)⑤02索引补camp/shop+报告4A/4B/5收口记录+孤儿清零+流程义务段更新;doc死链闸=新文档零死链 2026-09-30 16:38:41 +08:00
DKChan cf5d8a0974 settle-fix: 拍板点2闭环补齐批——①命名变体全量收口:战斗结算画面(battle:113-114/关卡节点地图:86:166/level-map:140)+战斗胜利总结结算四字变体(level-clear三处)+摘要结算画面(冒险结构两处)全改正名并指路spec;②载体实态修正:冒险总结结算=同一battle_end_overlay双形态(末关通关=open_victory金蜡封+GP行/倒下放弃=open_defeat),无独立冒险终局面板实体;③spec口径节变体清单扩至五项+06体例豁免注记;④报告总清单1.5行改已落地+B类①行标已裁;doc死链闸=新文档零死链(3处均既有基线) 2026-09-30 15:47:52 +08:00
DKChan 9d69c7ef4b docs(art-bible): v3.0 中修批(案B 用户拍板)——明度分层/色牌降级/语义色域限定/装饰解禁/舞台正面目标/整屏样张闸/全局对比度/字号字重/档位方向;连带六文档+06三挂账 2026-09-29 17:59:03 +08:00
DKChan 70deba153c docs(ux): T5 文档回填——level-map OQ4 视觉终稿收口+art-bible v2.14 冻结落文+M-2 出口闸检查单 2026-09-28 14:01:25 +08:00
DKChan 30002f85fd docs(ux): T1 level-map 形态升格独立屏批——规格先行(M-2 迭代 3 首卡)
用户裁决落规格:独立屏=最终形态,覆盖层实现定性=测试阶段形态。level-map.md:Status/覆盖范围/到达方式/Navigation Position「模态覆盖层形态(暗幕 0.6 底层透出)」全量改写「独立屏独占呈现(战斗屏宿主整体隐藏零透出)」+Layout 屏底(BG_ROOT+石纹底噪=M-1 框材件)+Transitions 独立屏淡入 200ms(alpha 非明度——§2)+AC「模态纪律」改「独立性断言」(激活期战斗屏隐藏/战斗节点提交后恢复/兑付覆盖层关闭后本屏恢复)+节点商店覆盖层本屏域内弹出语义明确+实现锚改名 level_map_screen.gd+修订记录。interaction-patterns pattern 6 When-NOT-to-Use 补独立屏退出注记(node/shop 域内弹出仍属);battle.md 三处「选路覆盖层常驻形态」措辞随改;level-clear.md 核对零改(其覆盖层措辞指自身形态)。战后回图/零自动推进语义零改动——改的只是呈现形态。
2026-09-28 06:20:23 +08:00
DKChan 754df5c13d docs(ux): 关卡画面三拍板收口——底栏=状态展示(生命/属性/本关已选加成三组常读,布局决策4)+图上点击为唯一选路通道(候选按钮退役,布局决策2)+放弃二次确认定稿(布局决策3);信息层级六层/组件/States/交互/数据锚/AC/线框随改;06 拍板点条目解决移除(doc_link 死链 0/已知 0;gdd_lint 8 文件=基线;term 215+1 既有;熵增闸 PASS) 2026-09-27 16:28:30 +08:00
DKChan 5c8c3f5d98 docs(ux): 关卡画面 UX spec 建档——ux/level-map.md 占位升格版(信息层级五层/三停点布局/组件清单/GP 常驻徽章/交互映射/AC)+三项设计提案挂 06 待拍板(HP 常驻读数/图上点击选路/放弃二次确认);停点标题措辞修正清偿台账 143 遗留;HUD框架 屏级权威按屏分治+义务清单挂指针;02 入册 v1.1;battle/level-clear 导航行互链(doc_link 死链 0/已知 0;gdd_lint 失败集=基线 8 文件零新增;term 疑似 1 既有) 2026-09-27 15:36:21 +08:00