Commit Graph
17 Commits
Author SHA1 Message Date
DKChan 37007552fd 文档设计(迭代40反哺点落文): 13条全落+B3以撤销禁令为准换代——①architecture v1.22: A1 reward_economy消费依赖改注入Callable口径/A2 BattleFxHost补luck_bias_for查询口/A3接线款补注入Callable亦属接线面+battle_hooks三键回调束形态/A4补RunLedger退役后战斗域读面款/编排域拆件定稿节与battle_orchestrator行两处「实现批后」自挂钩兑现转现状(合并提交514457d1)/B2 S13豁免登记第三条battle_orchestrator类变量键(键账50→38,永久基线内禁再恶化);②test-conventions: B1 §5新增违约通道类需求点必须落独立负面套件显式条款(先例四件)/B3 §8.4全节改「真实入口断言(验收闭合的主判据)」——禁变异+禁撤销类取证两禁令入文、判据绑可观测提交面、绑不上=停卡呈报禁自造替代证明,§8.3对照表第六列改「判据绑定面」,§7/§8.6/§8.7同口径换代(撤销证明口径全撤);③AGENTS.md红线「验收闭合」换代(两禁令点名+停卡呈报出口);④req-card SKILL(.zcode/.qoder双份,本机件不入库)对照表第六列与口径bullet同步;⑤待办清单: C1 gdstyle条目波1+波7合回出账/C2深拆条目实测重锚(38/1036)+缝拆样本在库/C4挂死防护条目补124挂死实证(实现报告§三同源)/新登记undo_proof.py退役条目(禁令生效后死工具,同族evals残留与pipeline_gate短语级扫描随批裁);⑥roadmap迭代40行估时6.225→6.375(卡②v1.4缝拆增量)。D组四条随卡片退役消解(卡死期=合回即至,读数事实已由审计报告承载);反哺点清单文件留待batch-closure统一退役(实现报告引用面同批改写)。规约冲突消解说明: 挂死防护批当日写入§8.4的「合法手段只有真撤销+undo_proof.py」与用户2026-10-28撤销禁令相抵,本批按用户裁以禁令为准改写,undo_proof.py转退役条目 2026-10-28 05:11:10 +08:00
DKChan 145c18658b 文档(测试判据升级): 单元层写法判据落文——「测试直接调用被测函数」升为「从领域类对外方法进、断言钉对外可观测面(返回值/信号/查询接口/落盘内容)」,内部字段直查降受控例外(无公开可观测面可钉才允许、对照表注明理由;存量不回头清扫、被批次触碰时顺带换代);§8.7 审计三件事→四件事(增核受控例外申报);README 层级表单元行判什么对齐+集成节立集成旅程清单(现状五行:存档⇄RNG往返/旧档迁移续玩/断点附随件与事件日志/关卡图断点重生成同图/回放确定性parity闸11,登记批按git考据:两件出身断言迁移批2026-10-23);architecture v1.21 测试域三层承载表单元行同步;待办清单登记「测试判据升级」条目(批1落文+批2试点归位,2026-10-28 plan批准+草案过目后落笔) 2026-10-28 04:51:42 +08:00
DKChan 6139d2deb0 收尾(迭代39批后): 反哺点13条落文+产出物退役+账面换代(用户裁甲路线2026-10-28)——①落文九处: architecture v1.20(三新件已实装登记/RunLedger退役注记并删四账段/拆分定稿节转现状/unit_container补check_trigger_unlocks与facts参/effect_engine adventure桶改指应用层/CurioDeck bind_handlers句退役)+存档序列化 v1.1(断点各件自交片段+应用层唯一拼盘落盘口+gain_journal扩列28键+aux_items关卡完成停点同调行留存边界)+冒险结构 v1.1(获得日记键断点面口径:plain策略/旧档缺键汇总直载/在档推导比对不符拒载)+敌人系统 v1.3(trigger列与P1表已实装标注/半血收编句摘'归实装批'/两示范定名)+难度曲线与Boss v1.1(两示范投放登记读表口径+EV锚换带注记)+体验验证清单㊲(趁隙偷袭/孤注守势两目检项)+生涯(行号越界句改语义指认:收束受理_settle+主角账两件投影)+test-conventions(check_quiet静默通道不进extract_checks扫描面备案);#4秘宝核查无双轨描述记无需改、#6战斗结算核查无漂移闭环、#13备案随报告退役留痕git;无版本号文档(存档序列化/冒险结构)补立身份标记基线=修订前全部历史;②退役删十件: 四份产出物(实现报告§六收口口径/代拍板10条含超白名单#5#7随特批合并追认/反哺点清单/验收审计)+三张需求卡(死期=合回master)+素材八份JSON(证据只留最新,第8份split_B1未跟踪件直删不入库);③账面: roadmap迭代39行已完成(2026-10-27)+卡片报告列退役保留字+当前位三行换代+表下带红合并注记;待办清单两源条目整删+gdstyle条目卡指路句改git指认(三宿主债已清偿ffb0ac15)+迭代40卡①交接注记(卡面RunLedger引用须按现态改写)自报告§六迁入;闸红修复: roadmap当前位括号日期注记改逗号连接(R3)/体验验证清单退役词buff改增益(doc_term)/gdstyle条目已删卡路径改git指认(卡片存在性校验);遗留呈报: bp_baseline_dump.gd零引用可删但属代码面,留待用户裁worktree小批 2026-10-28 04:18:57 +08:00
DKChan 219af09a04 工程(撤销证明工具化): undo_proof 一条命令出「改前绿→真撤销复红→还原复绿」三连回执并自还原(支持新增文件型撤销与--repo 跨区)+变异禁令收编进 test-conventions §8.4(此前只活在 req-card 技能,执行侧空挂)——孤立验证通过/恒绿缺漏判红路径通过;断言配额维持现状(用户裁);条目完成即删 2026-10-28 04:04:01 +08:00
DKChan af0e28d655 收尾(迭代38批后): 账面换代+反哺点1-16落文+产出物退役(用户裁「反哺落文没有问题、代拍板全部追认、卡②状态可一并更新」)——①待办清单四条完成即整删(效果引擎校验文案计数错误/明细行扩展总型收敛批/奖励节点过时表述清扫批/调试入口写死行必须在发布前删除)+「结算明细日志行序重锚批」随卡④裁点甲出账删除+「闸与探针存量噪声两件」拆注改名(件①产品码类型错随卡⑥出账,保留件②闸壳挂死防护=工程直改待执行,改动面降为工具代码);卡②条目现态由并行会话登记「gdstyle存量债全量清偿」波7承接(原「结构审查未立项小件候审」条目已并入该条),本批不重复回退;②roadmap 迭代38行换代(状态已完成(2026-10-26)/需求卡片列与实现报告列填退役保留字)+顶部当前位迭代位与下一步两行换代+表下加带红合并〔用户特批 2026-10-26〕注记一行;③体验验证清单新增 ㊱ 迭代38 六卡目检总清单五项(含红灯信号与结论回流;卡② 无改动不登记)——反哺点17 前提证伪:根目录 体验验证清单.md 一直存在且被 git 跟踪(414 行、㉖–㟟 逐迭代节俱全),当时误判系 Windows 中文文件名编码显示问题,故两选一裁决作废、直接按既有格式落登记;④反哺落文六处:战斗结算「扩展行」节过渡句换代为单一扩展行型+effect_id 口径(v1.0→v1.1)、08-Alpha版本标准 三选一条目改两渠道均在役(v1.16→v1.17,02-系统清单 指针随动)、ux/battle 调试浮窗与调试变体两处改发布态恒隐+415 历史留痕加口径指引、生涯 调试浮窗两行换代、test-conventions 调试注入两层加发布态注记、code-architecture.json debug 节点副标 DS_DEBUG 门控→发布态恒隐;architecture.md §1.3 与 roadmap 重锚指路句按卡①预期零改动/随②出账;⑤退役删除十件:四份迭代38产出物(实现报告§八落笔清单已逐条出账、审计报告两项阻断均有处置记录、代拍板21条经用户追认、反哺点1-16已落文)+六张已完成需求卡片(levelmap/效果文案/明细收敛/奖励节点/结算行缓冲/调试入口);卡② 结构小件定点修卡与其 WIP 留存随波7 重裁保留在册,卡内对已删 levelmap 卡的链接改指 git 提交 b85b3b45/8ea7cfba;pipeline_gate 绿(51条目/39行/2链)、gdd_lint 绿、文档域闸绿(07 doc_link 基线红转绿) 2026-10-26 19:16:07 +08:00
DKChan ab79a71eb7 docs(规则修订): code-conventions/test-conventions 文首读触发前移——「写任何代码前必须通读本文件」改「定代码方案前必须通读本文件」、「写任何测试前必须通读本文」改「定测试方案前必须通读本文」(2026-10-25 用户裁两处一起改;与 d121d653 导航行前移口径对齐,测试侧实际时点更早——验收断言在写卡期设计;process-conventions 经呈报维持不改) 2026-10-26 02:38:22 +08:00
DKChan 9fdacdebeb docs(规则修订): 改动四类+卡片/迭代两层模型落规约(2026-10-25 用户裁定 12 项全执行)——AGENTS「两类批」改「改动四类」(需求改动=唯一走写卡+迭代;工程/文档设计/美术素材=无卡无迭代直改)+五段铁律限定需求改动并补两层口径;process-conventions §2 首句改造+两层口径+工程直入拆分+「低于5不得编」改「任何卡可编入、<5=冻结待凑批」;doc-conventions §12 状态机补待执行与直改类序列、通道表拆需求性/工程性、§12.2 补冻结待凑批与周期新规;test-conventions 头注补测试归属句;术语表术语替换;pipeline_gate 状态词表/状态五形态/周期校验同步(<5 未处冻结态才红);三张违形卡(S9/S13/节点图换代收尾批)删除、结论回写条目、五条目状态改待执行;退役词四处顺带换代。全量域闸绿(回执 full 档,07 doc_link 较基线改善);子代理审计过(四小修已落)。.zcode/.qoder 六技能(iter/iter-plan/req-card/batch-closure/doc-design/asset-ingest)同批换代,不入 git 2026-10-25 06:57:29 +08:00
DKChan e89f486aa9 merge(master)+禁令残留清扫:并回 master 新进提交(gdstyle 闸件批/S9 卡/iter36 收尾),冲突 test-conventions §8.4 保重编号版+吸收 master 新条款「判据绑可观测提交面」(措辞去变异化);随批清扫——待办清单 gdstyle/S9 两条目「变异验证义务」改撤销证明口径;S9 活卡全量改写(契约 3/T2/D2/D4/来源行/对照表列头/审计面/两轮 grilling 记录——旧「闸件豁免」定界标注经用户全项目禁令推翻,验证义务统一撤销证明,禁令条款原文保留) 2026-10-25 01:31:21 +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 53426fd073 docs(测试工具手册): game/tests/README.md 升级手册形态——头部三线分工声明(介绍=手册/规则与时机=test-conventions/闸清单=run_all_gates.sh 唯一落点)+工具速查表八件(判什么/结果谁判/什么时候用)+测量件发起规则指路;test-conventions.md 分工句原位扩一行指针(不推移行号);待办清单登记 gdstyle 引入条目(工程直入,2026-10-24 会话实测三件证据)。全量域闸绿(回执 full 档,07 doc_link 较基线改善)。gdstyle v0.4.0 兼容实测见待办清单条目现状节 2026-10-24 18:28:43 +08:00
DKChan b2583f75f5 chore(变异类测试全项目清除): 用户裁——变异验证/变异测试全项目禁用,验收一律只走撤销证明。AGENTS.md 红线行删除+导航行改词;test-conventions §6 整节退役(§7–§9 重编号为 §6–§8,对照表第六格改「撤销证明」,§8.4 新增行为证明改撤销式);process-conventions 批清单第 8 条删除(后续条目重编号)+闸件义务句改人工确认;code-conventions/roadmap 同步;pipeline_gate 对照表证明标记删「变异」+报错文案改;run_all_gates.sh 注释同步;游戏测试面 8 件测试语义改写(layout_probe/ui_struct_probe/save_manager/save_boot/level_gen_params/forge_table/save_manager.gd/4 件表值措辞)——玩法术语(地形变异/变异格/变异角标/变异池等)逐个甄别后全数保留;活卡「状态面板瘦身批」变异列全量改写为撤销证明口径。全库方法术语 grep 零残留;全量域闸验收通过(回执随本批重跑补齐) 2026-10-24 08:35:18 +08:00
DKChan 16c6f1362e refactor(波2 目录收尾): game/smoke/ 目录退役——44 件探针三件套迁 game/probe/、30 件测量/诊断/驱动件迁 game/sim/;全仓 100+ 处 res://smoke 与 game/smoke 引用改指(闸件/产品码 tune_sim_controller/宿主 preload/根规则/README/设计文档);熵增闸 RETIRED 收编 game/smoke 防回潮;AGENTS.md Project Layout 换代;static_scan 豁免理由换新宿主;波 2 施工件预计算表全部命中(8d 预扫零红灯);全量域闸验收通过零新增红 2026-10-24 02:09:27 +08:00
DKChan 3b8c6bc3e7 docs(规则): 测试术语与层级重构批 A 规则面——三查条删除+§3 重编号(9-15)+全仓 §3.N 指针改正(AGENTS.md §3.9);roadmap loop 规范 2/3/4 条按新频率规则重写(检出零测试/卡内只测自己改的东西/全量只有批末+合回);术语表退役词对照登记四级测试层废弃词(系统级断言套件/冒烟全量/单元套件/启动探针/L0–L3/轻闸/重闸/三查);AGENTS.md 单件直跑行换冒烟+系统测试双运行器;test-conventions §9.3 加验证集清单维护锚 2026-10-22 21:05:46 +08:00
DKChan feaf01454a docs(验收闭合): 测试规范新增 §9 改动级验收闭合——每个需求点与行为改动都要真实入口断言+撤销证明,合回前独立验收审计
病根=测试规范 §5.2 只要求「每条清单条目至少一个自动断言」,没要求断言从改动的真实入口进入:
裸 EffectEngine 断言可替 BattleOrchestrator 接线,报告写「V1 绿」而 V1 断言并不存在。

- test-conventions §9(9.1–9.8):验收单位=行为改动;四层与真实入口;改动—验收对照表六列
  双端对上(需求点正向、diff 反向、断言挂载测试侧);撤销证明(改既有行为回退变红、新增行为
  变异变红);禁削弱测试;明确不要求 TDD;合回前独立验收审计;旧卡不回头改、开工前补齐
- process-conventions §3:第 7 条挂对照表、第 9 条补撤销证明、第 10 条合回前审计、新增第 16 条
- AGENTS.md 硬性红线新增「验收闭合」,与变异验证并列
- pipeline_gate 新增 C3:卡片须有对照表节、五个必需列、至少一行、必填格非空、全文声明验收审计;
  只查结构不判语义(生效 2026-10-21,按卡片文件名日期追新)
- reports/README 与 batch-closure 同步验收审计报告的落点与退役判据
- 待办清单登记「验收闭合规则——下一次迭代实测评估」,按规则评估红线等真实迭代检验
2026-10-21 03:42:37 +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 811f988032 rules(规则审阅落地批): 十条评审意见落地——呈报四问/文件头缩窄/禁词表冻结/lean死条文退役/日期批注清除/AGENTS瘦身/分域闸口径/状态栏纯化
- AGENTS.md: 呈报六问改读后自检四问;文件头红线删行数上限与白名单;日期批注清除;回执五况细则挪 process-conventions §3.10;流水线闸过时状态句改事实句
- process-conventions: §1.2 非迭代批改按改动域跑闸;§3.10 承接五况;两处日期批注清除;§2 表格凭据落点改现状清单
- code-conventions: §1.4.1 重写(删 8 行上限/两类白名单/90 文件清偿义务);§2.1 联动;两处日期批注清除
- test-conventions: 三处日期批注清除(三处实证日期属证据保留)
- doc-conventions: §1 lean 死条文删除;§4 词表冻结条款;§12.1 重写(状态行只写状态词;现状=关联文档清单;删括号凭据全部条款);三处日期批注清除;§5 重复词修复
- 术语表: 用语规范节加词表冻结句
- 06-待办清单: 11 条带括号状态行迁移(括号证据移入现状关联文档清单;待裁决说明并入现状;每条状态行只留状态词)
- tools/audit_file_headers.py: 删 R1 行数上限(R0 载体/R2 日期/R3 变更叙事保留)
- tools/gdd_lint.py: R2 表格占比判据与 R2_EXEMPT 整体退役(lean 解读对象已亡,只产存量噪音)
- tools/doc_term_audit.py: 词表冻结注释
- tools/pipeline_gate.py: 状态栏括号凭据核对废止,新增状态行禁括号判据(点名病因短路);闭合证据改现状正文核对(卡片路径磁盘存在性+交叉核、文档路径+版本、art-bible+版本)
- game/tests/static_scan.sh: S10 注释同步

变异验证(test-conventions §6):pipeline_gate 注入括号→状态行含括号内容红 exit1;删正文卡片路径→正文缺卡片路径+交叉核红 exit1;audit_file_headers 注入变更叙事→R2/R3 红 exit1、头注 12 行纯说明→0 红(上限停用实证)。坑册新增:未提交工作区禁 git checkout 变异还原(会连带回滚在途改动),须备份文件法。

全批净变化 +155/−146(12 文件)。
2026-10-20 23:15:05 +08:00
DKChan f406002766 docs(dev目录正名·engineering): design/dev 更名 design/engineering——名实对齐(目录实存=架构+五规约+引擎参考的工程知识域)
- git mv 15 件本体;13 个引用文件 34 处路径同步+熵增闸 DESIGN_SUBDIRS 白名单同批改判
- 白名单漏改时熵增闸当场真红(子目录越界拦截能力实录验证),同步后全绿
- game/tests 三件套注释按用户特别授权批后主区直改(不入本批);reports/research 暂存档按吸收即死原则不改
- 文档域闸全绿:gdd_lint/doc_link/doc_term/流水线闸/熵增闸
2026-10-20 05:33:34 +08:00