Commit Graph
17 Commits
Author SHA1 Message Date
DKChan 0341bdc2a9 docs(营地场景图口径回写): 帐篷与木围墙口径落地 design/
依据=reports/提案-营地场景图美术生成方案-2026-10-22.md §12 分层元素描述表/§11 修订清单第 2·4·7·9 条,
以及 reports/提案-营地色彩与氛围脚本-2026-10-23.md(色彩与氛围依据,色值为候选未拍板):

- art-bible §2.8:承载元素中景改木围墙(密排竖木桩/桩顶削尖/不透缝无横木),承载件由床铺换为帐篷
- art-bible §6.2:场景构成补「中景带自底部往上约 2/3 处起」+「近景可覆盖围墙、门洞必须留空」;交付形态承载件改帐篷;
  新增「色彩与氛围依据」指路(指 reports 脚本,本节不复述色值)与「待裁」三项(环境子板色值/门扇门洞高宽比/帐篷落地尺寸)
- art-bible §7.5:七物件名与「近景可覆盖中景、门洞除外」口径同步
- asset-path-map §3:scene_camp_bed → scene_camp_tent
- art-assets-checklist §3.5:承载件素材名同步改 tent
- camp.md(design/gdd/ux/):v2.1,物件表与纵深段按帐篷/木围墙口径重写,画法与尺寸口径回指 art-bible §6.2

术语表 43/56、02-系统清单 82、08-Alpha 106/200、art-status-checklist 32 五处经核对已在前批落地,本次零改动。
文档域闸 tools/run_all_gates.sh --docs 全绿。
2026-10-24 07:04:18 +08:00
agent 291f5122fc docs(营地美术设计段): 营地场景图定稿条款落文 + 旧「三柜台」说法全面换代
- art-bible: §2 明度禁令缩窄至情绪域(状态表达不再受限)、§2.8 承载元素换七物件场景图、
  §4.1 新增色板分层(语义/UI token 48 + 每屏环境子板 ≤32)、§6.2 营地场景整条重写、
  §7.5 营地界面整条重写、§7.6 禁用态加注(场景物件另按 §6.2)
- camp.md 整份重写为「可点击场景图 + 七物件点选」
- asset-path-map 增 scene/ 子目录; 资产清单 §3.5 重写; 状态清单营地行换代
- GDD 侧「柜台」用词换代: 术语表(顺带消除三/四柜台自相矛盾)、系统清单、Alpha 标准、
  不做清单、核心循环、内容规模、level-clear、元进度、HUD框架
- 待办清单: 新增「营地五界面窗口化批」(优先级=绝对, 强依赖卡④); 卡④条 P1 同步为已裁=B
- reports/提案-营地场景图美术生成方案-2026-10-22.md (本轮讨论裁定与修订清单 §11)
2026-10-23 02:50:36 +08:00
DKChan 1864f157b4 docs(迭代33反哺写入+收尾批): 16 项反哺点按 2026-10-22 用户裁决全部落文+三卡与四件产出物退役+账面换代
- 存档序列化.md:三存档位承载段(#1)+负责表/读写时机图换代+无激活拒写(#2)+P2 多存档槽位后置条注销(#3)+旧单档一次性迁移段(#4)+消费面纪律补窥视读器返回结构与 has_file 口径(#10)
- 生涯.md v1.1:信息架构三入口结构树+定位改营地平级(#7/#11);camp.md v1.6:营地入口改「进入存档→选档→进档/新档」+双入口框架句同步(#12)
- 08-Alpha版本标准.md v1.13:「三 · 界面」增选档界面行(#8)+主菜单行换代与入口拓扑注记(#13)——两条均 2026-10-22 用户裁批准;营地交互重做五卡行按实态同步(部分实装)
- art-bible.md v3.18:§7.4 豁免清单 excision「主菜单分组 overline×2」两片段、余清单不动(#15)
- 体验验证清单:新增 ㉛ 迭代 33 实机目检总清单五项+⑯/⑲ 旧入口引述按三钮换代(#14)
- 账面:待办清单增「迭代 33 反哺点写入」专条(状态=已写入)+营地五卡条推进(①②③ 落地、④⑤ 未编排,去「已编迭代 33」段)(#5/#9/#16);roadmap 迭代 33 行「已完成(2026-10-22)」+卡片/报告列退役保留字+当前位三行换代(#6)
- 退役七件(吸收即死+证据只留最新,引用面已改写):iter33 实现报告/反哺点清单/验收审计/代拍板追认单+三张需求卡片;代拍板 12 项随专条备案(veto 窗口开放至用户明示)
〔迭代 33 收口登记:卡① ebf40947/卡③ 5c2a7bcf/卡② 508f190b/总收口 6e8f72b2〕
2026-10-22 23:34:13 +08:00
DKChan 7aee5eb71a docs(流程文档迁出GDD批): 待办清单与体验验证清单移到仓库根并去掉编号前缀
两文件是流水线流程件而非游戏描述件,此前住在 design/gdd/ 造成三处不适配:
gdd_lint 必须为它们逐条关掉体裁规则、格式权威却写在 doc-conventions §12、
与同族的 roadmap(在仓库根)分居两处。迁到根后按 roadmap.md 的无编号风格改名。

- 迁出:design/gdd/06-待办清单.md → 待办清单.md;07-体验验证清单.md → 体验验证清单.md
- 指向改写 53 个文件:GDD 各系统文档指路存根、四份规约、02 根索引、README/roadmap/AGENTS
- 两份清单自身 74 处出站链接按新基址重指(../art → design/art、systems → design/gdd/systems)
- gdd_lint:待办/体验验证两文件的 R1/R3/R5/R7 豁免行随迁删除(已脱离扫描面),后门表清零
- pipeline_gate 默认路径、log_analysis/render_gate 称谓、repo_structure_audit 根文件白名单同步
- 保护面补写:两份清单列入实现批禁写清单(AGENTS 两类批条 / process-conventions §12 / 架构文档域表),
  条目状态只由流水线各段推进
- 范围外未动(用户令「全不碰」):reports/ 与 design/research/ 的 22 处历史指向、game/ 两处注释
2026-10-21 00:09:40 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设+三工具去豁免+48 文档删节+game/README 流水段删+代码注释 900 余行轨迹标签清偿(约束句保留)+规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
DKChan 1460cf9077 docs(收尾): 定名传导批补漏——22 文档版本历史行+06 登记遗留三项
补 42d64ec2/17ef0180 两笔漏掉的两件执行层:

一、版本历史行(22 个文档各一行,doc-conventions R4 与项目惯例要求每批改动落行)
  00 v1.4/01 v1.10/02 v1.28/03 v1.4/05 v1.5/08 v1.11/关卡节点地图 v1.9/
  冒险结构 v0.23/难度曲线 v0.30/战斗结算 v0.30/排雷玩法 v0.7/行动经济 v0.14/
  存档序列化 v1.10/教学引导 v0.6/元进度 v1.22/天赋树 v0.12/秘宝 v2.5/
  锻造工坊 v0.11/camp v1.6/settlement-summary v1.4/shop v1.2/术语表 v1.14
  (奇物.md 已于前批加 v3.20,不重复)

二、06 新建两条(pipeline_gate PASS:06 条目 63)
  「定名传导遗留二项」(来源=会话提及,设计面=文档轨):
    ①增益状态.md 用「账」指战斗内状态容器——经用户确认与「系统资源」不是同一个
      东西,仅用词冲突;改名与否(候选:容器/状态池)与连带范围待用户裁
    ②art/ 两处+entities.yaml 三处 GP 更名已在分支 gpsweep-20261019 改完但未合回
      master,合并归用户另会话,本批不代做
  「代码注释旧称二处」(来源=会话提及,设计面=工程直入,状态=待写卡):
    adventure_table.gd:21/:24 注释仍写「资源类」;kind 字面是账名不是分类名,
    数据零改动,只改注释两处;按用户令等建需求卡片

坑:06 状态行写「金币分支」触发 doc_term(「金币」退役 2026-10-18,该行无日期
白名单信号)→ 改「GP 更名分支」;06 现状段引述退役词带日期信号,合规放行。

闸:worktree 内 run_all_gates.sh --docs 验收通过,对基线零新增红。
2026-10-19 19:41:47 +08:00
DKChan 17ef0180af docs(术语): 系统资源定名向各系统文档传导——复述改指路+旧称换代(22 文件)
承接 42d64ec2(定义源定稿)。按 concept-conventions §2「单点定义+引用不转述」:
不做全库换词,只处理两类——**复述概念定义处改成「规范名+指路 01-核心循环」**、
**用旧称处换成规范名**。共 141 处,22 文件 129+/129−。

  行动经济:定义句「这本账」→ 行动点这一笔系统资源;表行「行动点账本」→
    行动点(当前池);「AP 分两本账」→ 行动点分两笔;扣费入口表述统一
  秘宝:「存量账+临时账两本账」→ 存量+临时两笔;三处表头「写哪本账」→
    「写哪笔系统资源」;「各周期账本独立」→ 系统资源独立
  冒险结构:「生命账本/GP 冒险账本」表行与节标题 →「生命/GP」;GP 节标题
    改「### GP:…」,全库指路「GP 冒险账本」节同步改「GP」节(元进度/战斗结算/
    难度曲线/shop.md/01-核心循环)
  元进度:「独立资源口径…两条平行独立资源」→「系统资源口径…两条平行独立的
    系统资源」;钥石表行改「钥石(存档级)」
  排雷玩法/战斗结算/存档序列化/难度曲线/天赋树/关卡节点地图/锻造工坊/
    教学引导/ux(camp,shop,settlement-summary)/00/03/05/08:同上两类处理
  术语表+奇物.md:「时沙挂账」→「时沙暂记」(与 01 定义用词一致)

显式不动(有依据):
  「入账/不进账/到账」=写入动作义(用户 2026-10-19 明示不改);
  「结账时机双模式/地图账」=战斗结算自有结构概念(2026-10-06 用户裁);
  「同调段账本/充能账」=秘宝内部计数器;「随机账」=关卡节点图生成的工程比喻;
  「资源不足/资源面/点阵资源显示」=UI pattern 既有名(resource_face,牵动探针断言);
  「账号」非账本;地图战斗资源/格面资源语义;06/07 登记处(用户定不改);
  art 域「金币」(用户另会话处理,分支 gpsweep-20261019);版本历史行一律不改字面。

信息守恒:7 文件关键属性抽查全在位(守恒检查 5/5、6/6、5/5、4/4、4/4、4/4、3/4——
shop 的「不算价」系检查项笔误,原文为「不算账」已改为「不作计算」)。
闸:worktree 内 run_all_gates.sh --docs 验收通过,对基线零新增红。
2026-10-19 19:11:19 +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 b01253245e docs(改名补漏): camp.md状态面板两处正文换代——原改名批漏扫本文件(grep路径误写design/ux/不存在=假阴性零命中,用户质询发现);版本历史行旧名按记载保留+版本行v1.4 2026-10-13 06:20:30 +08:00
DKChan f22b2036a0 迭代22裁决落文批: A单十五条裁决收口+B单七条反哺全落文+⑤改自动兑付代码批——追认单(①②③⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮追认/④追认+积点账裁战斗级/⑤推翻改自动兑付)收口; ⑤代码=满charge_n=8自动当轮grant_ap无玩家入口(_on_cell_revealed揭示缓冲点兑付=cell_revealed批先于本格扣费故AP归零恰逢满点先兑再扣轮不结束/授予段积点段迁除/use_attune_convert受理口消解/attune_convert_state改造进度读数口+item_id键/use_treasure的ap_charge_safe死分支与_usable_now死条件删/tres试炼镐desc换代+counter_spend受理闸删)——HUD兑换钮整链退役(ap_bar convert信号+钮/board_zone转发/main接线与_sync_convert_button/_on_convert_pressed)+C区秘宝槽悬停浮窗进度(controller投影note字段/hero_info_panel tooltip拼接/main _refresh_presentations加refresh_slots重查); 单测④段重写自动兑付断言(7格零兑付/第8格AP+1/读数口/未装配反例); B落文=秘宝.md v3.0(目录三表实态三列+试炼镐自动兑付换代+代价轴转化获取行含战斗级重置与兑付时序+解锁条件实录钥石10/25四条件件三计数键+实装批落地前句全换代+退役指针补代码旧行已删)/元进度.md v1.17/camp.md v1.3(柜台呈现细则节+暂停层12行)/存档序列化.md v1.6(vision_used域+断点随件+bonus_aux_carry退役+v6扩列不升版)/行动经济.md v0.12(finish_round_stop转存率参数化)+术语表v1.2(自动兑付/真视使用计数两词条)+07㉑观测点随⑤换代; 报告修正=⑮提交号勘正(master实际T5=73db171,原记7095505系amend前被弃旧提交——merge-base实证)+十五条裁决标注+反哺七条已落文标注; 06收口=状态行换代+裁决小节。冒烟898/0+单测22套+probe_gate --click --full全绿(worktree拷.godot/字体与图标边车/art素材后) 2026-10-12 23:23:01 +08:00
DKChan 081027c579 docs(fix): 文档一致性修复批(定时检查呈报项①②:死链7处+lint三文件清零;纯文档零测试)
①死链修复7处:秘宝.md 10-10目录归位批漏网5处改指 systems/跨局循环/秘宝.md(01-核心循环v1.6行/02-系统清单v1.3行/奇物.md v3.5行〔连反斜杠路径一并改正〕/地形变异.md负责表+依赖表两行)+camp.md树面板行两处补../systems/前缀(天赋树/HUD框架);数据配置.md:221存量挂账维持(iter19基线在册)
②gdd_lint三文件清零:01-核心循环 R10版本历史v1.5同号顺延(10-10分界尺行→v1.7)+R5「生命周期轴(五档)」节补五档嵌套字符画〔报错原文误记「死了之后」系工具prev/cur错位——tools/gdd_lint.py R5报错节名一行修正〕+「死了之后」节顺带补死亡重开环字符画;02-系统清单 R6术语表行多余版本列摘除+R3三行状态格改写现行白话句并换代(天赋树v0.4换代定稿29节点/武器锻造v0.2/奇物27件扩容后)+版本v1.21;03-内容规模 R1超长段拆两段+目录计数换代15→12件(普通7/优秀3/稀有2——回能器删/换装券撤/第四只手删三轮漏网面)+版本v1.3
闸:gdd_lint 9文件2不通过(=06/07基线存量,01/02/03转绿)/doc_link死链2(=06:505 worktree环境假象待主区复验+数据配置221存量)/熵增PASS;版本行01 v1.8/02 v1.21/03 v1.3
2026-10-11 16:14:08 +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 9ae7c60c9c docs(sync): 天赋树裁定跨文档同步——锻造工坊解锁门登记+06重构批条+「道具工坊」改名「秘宝匣」九文件扫改(2026-10-10 用户令)
- A 武器锻造.md v0.2:柜台承载节补树侧解锁门(本柜台前置=树「锻造工坊」免费节点,攻/甲淬炼累计各≥2)
- B 06:新登「天赋树结构重构批」实装待办条(meta_tree 33→31/v4→v5 迁移重做/schema 等级阈值前置/柜台解锁门/秘宝匣改名连带面/地脉共鸣/同调位1)+武器锻造实装批条补关联句
- C 九文件现行正文「道具工坊→秘宝匣」扫改+各记版本行(版本历史行零触碰):元进度 v1.13/秘宝 v1.8/HUD框架 v0.16/camp v1.2/art-bible v3.13/03 v1.2/07 v0.5/README 新节/art-assets-checklist 补建版本表;registry 术语条「秘宝匣」(别名「道具工坊」保留检索)
- 红线:天赋树.md 与 game/ 代码数据表零触碰;design/research 与 design/qa 零触碰
- active.md:快照条+工作日志 431 随批
2026-10-10 06:48:08 +08:00
DKChan bb371cabc3 docs(tree): 天赋树欠账三分流——已建未接面记 06+registry 过期词条换代+camp.md 补树面板(2026-10-09 用户三令)
- 06 新条「天赋树已建未接面两件——设计定案、实现缺失」:同调位 2/3 槽位收编+命中线 flat 注入(设计正主《整合定稿》git 8e02dcf 取证定性质=实现缺失非设计缺口;处置=实装批+数值批,冻结待排期)
- registry entities.yaml「永久强化」词条:「『天赋树』同日退役——本作无树形结构」过期句按最新口径换代(树迭代 12 在役+正主指路+新旧概念划界);L870 批注行系历史留痕不动
- camp.md 补树面板结构位行(图鉴柜台下段程序占位;呈现终稿归 HUD框架;两信号名)——树侧跨文档欠账清偿
- 设计灰色地带(刷新升级节点/树四线×武器锻造叠加关系)不入本批=用户另会话设计讨论,prompt 已交付 chat
- worktree g-plan2-wforge 分支 tree-debt-gdd 基点 e39a4d6;纯文档零测试
2026-10-09 23:36:17 +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 899bd33672 docfix-b: 第五循环目录搬家批(拍板点11甲执行)——元进度.md 自冒险循环迁入跨局循环(git mv)+全仓27处指向链接改写+同目录裸链接跨目录修复9处+02-系统清单立跨局循环组与命名对照表同步+registry两owner路径同步 2026-09-30 19:51:32 +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