Commit Graph
23 Commits
Author SHA1 Message Date
DKChan 7beb9bfdd5 iter41-卡2:呈现层结构收敛批:67清+2豁免+2展平改善——拆私有族+六状态件+ui_kit收敛+束收拢+print删;含u14补做、并master并案与收尾产出物 2026-10-29 00:14:52 +08:00
DKChan bc75dab615 iter41-卡1:核心数据面结构收敛批:85键全清——三族拆域+config_db归位容器+存档拆件+meta瘦身+adventure拆段+spawn束化;行为零变化,8新件在阈 2026-10-29 00:14:51 +08:00
DKChan cb3f6f353c 文档(P0① 死路径销号): art-bible §1.4 冻结记录与 art-status-checklist P0 样张行删除已丢失的冻结样张路径(artwork/mockups/sample-batch-v3-final-2026-09-30.png),按用户 2026-10-28 裁乙改留「产物原件已丢失、未入 git」、不给指路,机检报告凭据(git 提交 7a847c7)保留;待办清单「美术资产链路审计两项 P0」条目收窄为 P0② 主角棋盘小人像素管线重产(美术面,归美术设计段),改动面与状态同步收窄 2026-10-28 07:19:43 +08:00
DKChan dd99884e12 文档(代拍板追认单退役): 取消批后追认环节——独立产出物 iter<N>-代拍板-<日期>.md 废止,超白名单/超卡片明列范围事项改记实现报告「实现决定记录」节(逐条记决了什么/为什么/代价/撤销方式,全按卡执行只写一行零拍板)——2026-10-28 用户裁:追认环节自设立起未被逐条行使、实现面全权委托,备案记录并档实现报告;三道前置闸不动(卡片代拍板白名单预授权/实现段零裁断/验收有效性事件当场停机呈报);修订面=process-conventions(五段表完成人闸+§2零裁断段+§3第11条产出物)+doc-conventions §11载体表+AGENTS.md reports行+reports/README产出物表+repo_structure_audit头注,iter/req-card/batch-closure三技能随批直写(.zcode不入git);登记与完成同会话坍缩故条目免落(待办清单正被iter40收尾会话编辑,避抢写;现存两份代拍板单已由该会话按退役判据暂存删除,不追溯) 2026-10-28 05:31:04 +08:00
DKChan d47a55345b 工程(一卡一提交上岸套件): reshape_cards 重塑工具+合回闸数卡三判据+回执 tree 对齐+批末顺序加重塑步(process-conventions §1.2+iter 技能同语)——守卫实测拦 iter40 十八笔未归卡出重塑指令;工具孤立验证两卡+收尾全路径通过;条目完成即删 2026-10-28 04:00:15 +08:00
DKChan 8bfd249402 工程(user目录隔离): 每个代码面 worktree 独立 Godot user 目录+系统测试 V3d 缺帧修正
- 机制: tools/setup_worktree_userdir.sh 在建区后生成 game/override.cfg(use_custom_user_dir + 唯一名 DungeonSweeper_<区名>_<绝对路径 sha1 前 8>), 主工作区 no-op 保持真实档原位; .gitignore 收 game/override.cfg
- 闸壳: run_all_gates.sh 参数解析后先自检/自愈本区隔离, 建不起来 exit 1(fail-closed)——并行批共用一套夹具/日志/截图目录会互相踩盘, 是假红的根源
- 读取面: 新增 tools/godot_user_dir.py 统一解析(有 override→custom dir, 无→默认 appdata/Godot/app_userdata/<config/name>); parity_anchor.py 与 analyze_playtest.py 的硬编码 APPDATA 路径改为调用它
- 流程: process-conventions §1 第 1 条(建区即跑 setup)与 §3 环境基线第 4 条(闸壳自检); iter 技能冷检出三件套→四件套(.zcode/.qoder 两份本机副本已同步, 不入 git)
- 系统测试 V3d: 隔离后空 user 目录(无 settings.cfg)使 reduced_motion 取默认 false, 实查暴露 V3d 真实缺陷——测试同步驱动整场战斗后同帧 flush, RowPacer._was_pumping 从未置真, 演播后排窗的 pump_ended 边沿不触发, _end_overlay 永不打开; 旧绿只因本机 settings.cfg reduced=true 让排播走 consume_now 快路绕过队列。补一帧 await process_frame 让泵先观测到非空队列再 flush, 恢复真实边沿路径
- 取证: 隔离空目录下 00 冒烟 17/17、02 单元与集成 62 套全绿、03 探针 --click 全绿; 01 系统测试修正前 70/1 红(仅 V3d)、修正后 reduced=true 与 false 两档均 70/70 绿
2026-10-27 05:23:13 +08:00
DKChan f2b17b47bd 工程+文档(车道铁律): worktree 铁律改两车道——代码面(game/非.md)唯一强制 worktree,其余主区直改;新增 git pre-commit 直改闸(版本化+hooksPath+LF钉死+在位自检);AGENTS/process-conventions/architecture 三处规则同步 2026-10-26 03:34:16 +08:00
DKChan 57b0c3a59e docs(闸分域): 判据由路径前缀改文件性质——game/ 内 .md 归文档域
- 合回闸与 run_all_gates.sh 同口径:代码域=game/ 下非 .md 的行为载体;
  game/ 内 .md 与 game/ 外一切路径=文档域;两类都有仍跑全量档
- 回执对齐(covers_tip)与 dirty_game 同步改只看代码面
- 修 git diff 默认 quotepath 把中文路径写成转义串、后缀判 .md 必失效的缺陷
- 同步 AGENTS/process-conventions/architecture/roadmap/tests README 与四份技能
- 规则评估样例:c25daa30(旧判 full、新判 docs);本批自身(docs)
2026-10-26 01:38:25 +08:00
DKChan becd300391 fix(格式换代): 换行符归一清偿合并脚本双重转换(三文件曾成 CR CR LF)+§12.1 一处旧措辞改齐(无设计线段的条目须在实况指认证据) 2026-10-25 07:50:49 +08:00
DKChan c550654896 merge master(改动四类与两层模型)+手工合四文件:格式换代与新状态词并轨 2026-10-25 07:44:25 +08:00
DKChan 9093ba0044 wip(格式换代·待 rebase): 待办清单条目格式换代第一遍——删设计面与归属、现状改实况、加改动面四档与可选优先级;闸判据七项+撤销证明十项全红过绿;69 条全面重写 2026-10-25 06:59:02 +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 a74fa87fe5 merge(master)+二轮清扫:并回 master 新进提交(iter36 收尾/golden 纪律/S13 治本卡),冲突三处——process-conventions 取 master 新条款(回执 dirty_game 对齐判据/每批跑一次闸/复跑理由)重编号 8–14+闸件义务句维持人工确认口径,S9 卡 D4 维持全项目禁令版(master 侧旧定界句作废),状态面板瘦身卡取 master 删除(iter36 收尾已退役,清洗随亡);随批清扫——待办清单「变异测试禁令写入规约」整条删除(本批即其执行)、roadmap 待编池同步移除 2026-10-25 03:59:11 +08:00
DKChan 270287cd30 docs(闸频率): 全量域闸收口为「每批一次」——冻结→件核→并 master→跑一次→合回
规则文本(process-conventions):
- §1.2/§3.9/§3.10 收口顺序固定为上列五步,删「批末+合回两个时机」与「重跑本域闸再合回」;明列唯一两种合法复跑(闸红且修法动 game/;闸开跑后 master 又推进),并写明「再跑一遍保险」不构成理由
- 回执与分支尖的对齐判据改为代码面:回执 commit 之后仅追加 reports/、design/ 等非 game/ 提交,回执照样有效;合回闸六况拦截描述随之改口,回执新增 dirty_game 字段

机检(tools/run_all_gates.sh):头注写明本脚本是批末终局动作;回执写 dirty_game(跑闸时 game/ 带未提交已跟踪改动=验的不是这版字节,合回闸拒收),首个回执字段验证:干净树 0/脏树 1/还原 0,回执 dirty_arg 0/1 两态落盘正确

钩子(.zcode/hooks/worktree-guard.sh,本机豁免面):合回闸由「回执 commit == 分支尖」改为「回执覆盖分支尖的 game/ 面」(covers_tip:祖先判定+game/ diff 为空),新增 dirty_game 拦截,错误话术随动

验证:A 层 7 临时仓库夹具全中(回执对齐/闸后仅 reports 提交/闸后改 game//dirty_game/master 未并/quick/含新增红),两处变异各按预期翻红(covers_tip→commit 同一使 S2 翻红;删 dirty 拦截使 S4 翻绿),还原后 sha256 一致且 7 例复跑全中;B 层 5 评估案例(evals.json)只读子代理判分见会话
2026-10-25 01:33:24 +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 7f68ffa85e docs(流程): 合回后零复跑改革——§3.10「按域复跑」换代为「合并后主区零复跑:code 批刷类名缓存+冒烟启动约 1 分钟、docs 批零动作」,全量验证收敛为 worktree 批末+分支并 master 重跑两处;§3.9 五况扩六况(master HEAD 非回执 commit 祖先即拦,未测内容合不进 master);AGENTS.md 引用同步;待办清单登记本批条目(已完成) 2026-10-24 01:05:09 +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 c61d00b41a docs(迭代周期规则批): 迭代周期三条线定型——中值精确值不取整/5–10 日常规/超 10 须带日期特批/硬下限 5、硬上限 20(特批不放行)
2026-10-21 用户裁定落地四件:
- process-conventions 四查③改「总估时三条线」(<5 不得编/5–10 直接编/超 10 呈报整批/拆批两案等裁、确认后带日期标记/>20 不得编、确认也不放行)
- doc-conventions §12.2 预计周期列改「≈N 个工作日」中值精确值形态(退役 0.5 步进周形态,1 周=5 工作日)
- roadmap 粒度句换代;迭代 31–35 五行按中值精确值改写(31≈7.5/32≈8.75/33≈13.25/34≈11 归特批/35≈15.25 个工作日)
- pipeline_gate:WEEKS_RE→PERIOD_RE;周期判据改三条线(<5 与 >20 判红、10<x≤20 须带日期特批标记、「—」历史行豁免)

变异验证 8 例(worktree 备份→sed 变异→恢复):25 带标记红(硬上限拦)/4 红(硬下限拦)/15 无标记红/15 带标记绿/20 带标记绿(边界放行)/10 无标记绿(边界不触批)/旧周形态红/标记缺日期红;恢复后全绿
2026-10-21 23:33:27 +08:00
DKChan 8a2f80fe7c docs(营地交互重做): 卡④退回美术设计段(v2.3 非有效卡,美术设计闭合后重立卡)+编排四查③增总估时下限(区间中值求和不得低于 5 天)+迭代 33 编入卡①③②(≈2.5 周带超上限特批),文档域闸全绿 2026-10-21 07:48:26 +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