foxzool wiki

Weekly Review

Properties1
tagssystem, weekly-review, coordination

44 min read

Weekly Review — 周期复盘

每周将行动转化为策略。 不是流水账，而是总结完成、卡点、可复用的经验、需要调整的决策。

当前周期

周期日期
当前2026-08-08 ~ 2026-08-24
上一篇2026-06-30 ~ 2026-08-08

本周总结（2026-08-08 ~ 2026-08-24，2.3 周）

✅ 完成

  1. Bevy v0.19.1 正式发布（08-13）—— 终结 5 个月等待

    • 08-13T00:02:58Z 发布，距 v0.19.0 整 55 天，终结「v0.19.0 remains latest」状态。上一周期最大卡点（「0.19.1 无限期推迟」）正式解除。
    • 0.19.1 milestone 100% closed（75/76，一项移出）。
    • 0.19.2 补丁规划随即开启（3 open → 7/12，58.3%）。

  2. Bevy 0.20 稳步推进：63.2% → 66.9%（83/124）

    • 关键 PRs：bevy_extract 独立 crate 落地（#22852，兑现 08-05 预言）、Editor 相机上游化（#25434，+3622 行）、UI Val::Em/Rem（#25231）、Taffy 13（#25413）、parallel contiguous iteration（#25264，132× 加速）、RectLight GPU clustering（#24827）、Flat Pointer Events（#25337）、Observer EventPatterns（#24013）、deprecated load_* 全删（#25444）。
    • 0.20 迁移清单 carried-forward 增至 18 项。

  3. 合并暂停恢复 + 两次爆发日

    • 08-08~08-11 连续 4 天静默（合并暂停）→ 08-11 单日 18 PR（8 月最大）→ 08-19 单日 25 PR（8 月新纪录）→ 08-23 依赖卫生日（2 PR）。
    • 多次 GitHub 搜索索引延迟导致盲区补采（08-02/03/05/11/13 批次）。

  4. Wiki 基础设施：lint 连续 16 天 [CLEAN]，新增 jms55 实体页

    • 08-09~08-24 每日 lint 0 genuine structural defects。
    • 08-21 创建 entities/jms55.md（达 2+ 源阈值），Total pages 134→135。

  5. raw sha256 约定澄清 + 引号转义损坏修复

    • 08-21 fix：修正 08-19 raw 失实 sha256，确立「追加小节不纳入 sha256、锚定原始正文」约定。
    • 08-15 字节级修复 bevy-migration-2026-08.md 与 bevy-ecs-event-state-roadmap.md 的 patch 转义引号损坏。

🔴 卡点

  • Stale 页面爆炸式增长：14 → 91（+77，暴增 550%） — 上周期承诺「批量刷新 14 个 stale」完全未执行，反而因 5 月中旬批量建页集中到期而暴涨。仅 bevy-solari-pathtracer.md 被 08-21 更新清除 1 个 stale。本周期最大负面信号。
  • 日更降频仍未执行 — 连续第 4 次 weekly review 承诺降频，仍每天 4 文件更新，即使 08-15/16/17 是 0 PR 静默日。上周期 4 项重点全部未执行。
  • 双流程同日重复入库 — researcher pipeline 与平行每日检查流程连续 2 次（08-21、08-23）同日重复入库，PR 100% 重复，浪费算力。
  • DeerFlow 独立 cron 未落地 — 08-09 后零 DeerFlow 更新，承诺的每周 1 次独立检查未注册。
  • log.md 接近旋转阈值 — 410/500 条，警告阈值 450。

🔁 可复用的经验

  • 宽窗口盲区补采模式成熟 — 多次用宽窗口 merged: 复查 + commits API 交叉验证，捕获 GitHub 搜索索引延迟漏采的 PR（08-02/03/05/11/13）。已稳定为日更标准操作。
  • 合并暂停 vs 真实静默判别标准 — 用 commits API + open PR 更新状态区分「合并暂停」（dev 未停）与「真实静默」，避免误判。
  • concurrent-run-recovery 流程 — 并发实例碰撞时保留先入产物仅补缺（08-12/13 两次验证）。
  • raw sha256 约定澄清 — 追加小节不纳入 sha256、锚定原始正文，避免 provenance 漂移复发。
  • 引号转义损坏字节级修复模式 — patch 在 CJK 上下文写 ASCII 双引号会产生反斜杠残留，需字节级修复。

⚠️ 需要调整的决策

  • Stale 页面批量刷新必须立即执行 — 91 个 stale 页（约 80 个为 5 月建页 90d 到期），一次性脚本化处理（bump updated + verify frontmatter），不再拖延。
  • 合并双每日流程为单流程 — researcher pipeline 与平行每日检查流程应合并，消除重复入库。
  • DeerFlow 独立 cron 真正落地 — 连续 2 周期承诺未执行，需在 Hermes cron 注册每周 1 次检查。
  • 日更降频执行 — 静默日（0 PR）跳过更新。本周期 4 个静默日（08-15/16/17 + 08-23）。
  • log.md 旋转准备 — 410/500，预计 1-2 周内触发 rotation。

🎯 下周重点

  1. 批量刷新 91 个 stale 页面（脚本化 bump updated + verify frontmatter）。
  2. 合并双每日流程为单流程（或停止同日重复入库）。
  3. 注册 DeerFlow 独立 cron（每周 1 次）。
  4. 执行日更降频：静默日（0 PR）跳过，仅在有合并/迁移敏感变更时更新。
  5. 跟踪 0.19.2 补丁发布（7/12）与 0.20 迁移清单（18 项）。

更新历史

  • 2026-08-24: 更新，覆盖 2026-08-08 ~ 2026-08-24（2.3 周）
  • 2026-08-08: 更新，覆盖 2026-06-30 ~ 2026-08-08（5.5 周）
  • 2026-06-29: 更新，覆盖 2026-06-17 ~ 2026-06-29
  • 2026-06-16: 更新，覆盖 2026-06-09 ~ 2026-06-16
  • 2026-06-08: 更新，覆盖 2026-06-02 ~ 2026-06-08
  • 2026-06-01: 更新，覆盖 2026-05-26 ~ 2026-06-01
  • 2026-05-25: 更新，覆盖 2026-05-19 ~ 2026-05-25
  • 2026-05-18: 更新，覆盖 2026-05-12 ~ 2026-05-18
  • 2026-05-11: 更新，覆盖 2026-05-05 ~ 2026-05-11
  • 2026-05-02: 初始创建，覆盖 2026-04-27 ~ 2026-05-02

历史周期：2026-06-30 ~ 2026-08-08

✅ 完成

  1. DeerFlow #1 部署阻塞正式解除 — Scheduled tasks MVP 合并（2026-07-13）

    • PR #3898：cron + once 调度、workspace 管理页面、durable persistence、9,392 additions/65 files。阻塞 ZoOL 企业部署 3 个月的最大障碍清零。
    • OpenViking memory adapter（#4707, 2026-08-07 合并）解决 #2 阻塞（可插拔 memory backend）。
    • 两次周更（Jul 13 + Aug 8）：stars 75.3k→76.9k→79.5k（+4.2k），forks 10.4k→10.9k。
    • 2.1.0 milestone 从 77% → 91.7%（43 open / 474 closed，268 new closures）。
    • 新增 Buzz/Nostr IM channel（#4649）、Monocle tracing（#4024）、Browser Live（#4719）、first-principles skill（#4398）、E2B sandbox capacity（#4575）。

  2. Bevy 0.19.1 patch release 从「stalled at 52%」推进到「92.2% 仅差临门一脚」

    • 7/1: 停滞在 20/38（52%）。7/7: 12-PR burst → 29/48（60%）。
    • 7/8-23: 150 PRs merge wave → 58/64（90.6%）。7/25: 59/64（92.2%）。
    • 8/8: 71/77（92.2%），scope 通胀 35→77（+120%），但发布仍无 tag。

  3. Feathers UI 成为 Bevy 默认 widget 框架

    • ~30+ PRs 系统性迁移（Phases 1-6），kfc35/taearls 主导。
    • #25237 Feathers HardLimit/SoftLimit → RangeInclusive API 改进。
    • examples/2d_shapes → FeathersCheckbox（#25164）。

  4. Bevy 0.20 稳步推进：25/59（42%）→ 67/106（63.2%）

    • 关键 PRs：render world window data ECS（#25005, BREAKING）、wgpu 30（#24841）、Solari v7（#24767）、bindless 2D（#24833）。

  5. Wiki 基础设施稳定运行，39 天连续 [CLEAN]

    • 零 genuine structural defects。Jul 30 日志轮转顺利。
    • Aug 5-6 创建 8 月月度跟踪页（bevy-game-dev-2026-08.md + bevy-migration-2026-08.md）。
    • 索引 127 → 134 页。

  6. 两篇研究/博客素材入库

    • 7/4: ARPG 地形设计（concepts/arpg-terrain-design.md）。
    • 7/26: Bevy ICU4X CJK segmentation blog（raw + brief + draft）。

🔴 卡点

  • Bevy 0.19.1 发布无限期推迟 — 6 周前 “imminent”，至今无 tag。Scope 通胀 35→77（+120%），open items 从 5→6 不减反增。
  • 日更 ROI 不见改善 — 三次 weekly review 承诺降频，始终未执行。零 PR 日仍补 lint + 记录。
  • DeerFlow 跟踪间隔 3.5 周 — 错过 OpenViking 合并（#2 阻塞）的中间观察点。
  • Stale 页面 1→14 持续累积 — system/ bevy-blog/project/ ARPG/pixel-art 四组页面均超过 90d，未做任何刷新。
  • 大型页面未拆分 — 26 个 >200 行页面，7 月日更页进入僵尸化。
  • 6/29 五项重点一项未解决 — 降频/DeerFlow/拆分/Person 验证连续第三次挂起。

🔁 可复用的经验

  • Gap update 模式有效但需改进频率 — 7/23 150-PR gap update 证明批量回填可行，但 16 天间隔信息密度过高，建议 ≤7 天。
  • DeerFlow 长期跟踪→回报告知管道验证 — 从 4 月记录 #3898 阻塞到 7/13 合并，完整决策链已沉淀。
  • Feathers 迁移已形成分析模板 — 按 widget 类型（Radio/Checkbox/NumberInput/Button/ScrollBar）分组，用于成熟度判断和 upgrade checklist。
  • Log rotation 双次验证可靠 — 6/23 + 7/30 平滑执行。

⚠️ 需要调整的决策

  • 立即执行日更降频 — 不能再拖延。建议即日起切换为「每周 2 次 batch update + 重大 breaking 即时」。
  • DeerFlow 独立 cron 跟踪 — 每周 1 次检查，不依赖 weekly review 才想起。
  • Stale 页面批量刷新 — 14 页至少做一次轻量更新（bump date + verify frontmatter）。
  • 7 月日更页归档 — add 「已结」标记，从 8 月页引用。
  • Weekly review 频率恢复 1~2 周一次 — 5.5 周间隔信息密度过高。

🎯 下周重点

  1. 执行日更降频 — 每周 2 次 batch update，过滤安静日。
  2. DeerFlow 独立 cron 跟踪 — 每周 1 次。
  3. 批量刷新 14 个 stale 页面。
  4. 归档 7 月日更页。

历史周期：2026-06-17 ~ 2026-06-29

✅ 完成

  1. Bevy 0.19.0 STABLE 正式发布（2026-06-18） — 经 3 个 RC 阶段后里程碑终告完成。

    • 6/17 安静日（仅 lint），6/18 爆发 19-PR merge wave → 0.19 milestone CLOSED → 当日发布 v0.19.0 stable。
    • 6/18 官方博文研究入库：创建 entities/bevy-0-19-release-notes.md（31 个核心章节完整摘要）。
    • 更新 entities/bevy-pbr.md 添加 0.19 渲染高亮（Contact Shadows、SSR、Area Lights 等）。
    • 543 PRs closed，里程碑从 5 月至 6 月跨越近两月最终完成。

  2. Bevy 0.19 发布博文全流水线完成（研究→发布）

    • 6/18 官方博文研究入库 → 6/19 blog draft v2 → 6/20 final 草稿 → 6/20 微信公众号发布成功。
    • 封面图通过 FAL + PicList 生成并上传至 assets.zool.me。
    • 完整验证了「research → raw → wiki entity → draft → final → publish」的 wiki-to-publishing 流水线。

  3. Post-release 跟踪平稳过渡

    • 0.19.1 补丁里程碑跟踪启动（Jun 20-29）：从 3/7（42%）→ 20/28（71%），8 项新 scope 加入。
    • 0.20 里程碑持续跟踪（25 closed / 32 open as of Jun 29）。
    • 合并率显著下降：多数日子 0~3 PRs，单日最高 6（6/24）。

  4. Lint 持续 12 天结构零缺陷

    • 6/17~6/29 每日 lint 均为 [CLEAN]：0 真正 structural defects（仅预期中的 inbox artifacts）。
    • 6/21 修复 lint 脚本 extract_wikilinks() 对 [[page|text]] 语法的解析 bug → broken wikilinks 从 2→1。
    • 警告维持稳定：1 contested、27 low-confidence（medium）、25 large pages（+6 比两周前）。
    • 6/23 Wiki log 轮转：1419 条目归档到 log-2026.md，新 log 从 0 开始，当前 108/500。

  5. PBR 页面 0.19 特性同步

    • entities/bevy-pbr.md 更新：Contact Shadows、Physically Based SSR、Rectangular Area Lights、Parallax Corrected Cubemaps、White Furnace Test、Partial Bindless、Skinned Mesh Culling、Solari Improvements。

🔴 卡点

  • 日更 ROI 持续恶化 — 6/236/29 多数日子 03 PRs，但每日仍执行 4 个文件更新。0.19 正式版已发布，亟需降频。
  • 大型页面仍未拆分 — bevy-game-dev-2026-06.md、bevy-migration-2026-06.md、bevy.md 在 0.19 发布后仍在每天追加少量 daily sections，大量记录已无长期价值。
  • 0.19.1 scope 持续扩张 — 总 items 从 25→28→34→36，和 0.19 final 前的 scope creep 模式相似。补丁版时间线不可测。
  • DeerFlow 全周无跟踪 — 上次 deerflow 更新在 6/8（2.0-m1 RC 阶段），已三周无检查。2.0-m1 是否已正式发布？cron PRs 状态？完全未知。
  • 上周五项重点仅完成 1 项 — (1) #24594 regression 随 milestone closed 自动解决；(2) 日更降频待执行；(3) DeerFlow 检查未做；(4) 页面拆分未做；(5) Person entity 检查未做。

🔁 可复用的经验

  • Wiki-to-publishing 流水线验证成功 — Bevy 0.19 发布博文从研究到发布经 wiki 全流程。bevy-0-19-release-notes.md 同时为 wiki 沉淀了长期价值（31 章摘要）和博文素材，说明 research → entity → publish 的复用模式有效。
  • Lint 脚本持续进化 — [[page|text]] 语法解析 bug 在 6/21 被 lint 暴露并修复，证明自动化检查能发现工具链自身缺陷。
  • 0.19 final 时 log 轮转策略执行顺利 — 1419 条目按期归档到 log-2026.md，新 log 从 0 开始，工具链无中断。
  • FAL + PicList 封面图生成流程已标准化 — 公众号发布封面图自动生成 + 上传 + 引用，可复用于后续博客发布。

⚠️ 需要调整的决策

  • 立即执行日更降频 — 0.19 正式版已发布，每日 03 PRs 不值得每天 4 个文件更新。建议切换为「每周 23 次」批处理模式，或仅在 ≥3 PRs 合并或有 breaking changes 时更新。
  • 6 月日更页必须拆分归档 — bevy-game-dev-2026-06.md 和 bevy-migration-2026-06.md 应在 6 月底或 7 月初按「0.19 rc timeline / breaking changes / release retrospective」三类拆分。大量零 PR 日期的 daily sections 可以安全清除。
  • DeerFlow 跟踪需设定提醒 — 连续三周未更新，不应依赖每周综述才想起。建议在 Hermes cron 中注册专门任务。
  • 每周复盘执行率需管理 — 本周 5 项重点仅完成 1 项。建议下周重点压缩至 3 项以内，每项设明确完成标准。

🎯 下周重点

  1. 执行日更降频方案 — 切换为每周 2~3 次批处理更新，过滤安静日（≤2 PRs）。
  2. 拆分 6 月日更页 — 按专题切分 bevy-game-dev-2026-06.md，清除零 PR 日期记录。
  3. 做一次 DeerFlow 全貌检查 — stars、2.0-m1 发布状态、cron PRs（#1092、#2624）、2.0.0 scope。
  4. 为 7 月做准备 — 新建 bevy-game-dev-2026-07.md 和 bevy-migration-2026-07.md，确保 6 月页归档后平滑过渡。
  5. 验证 person entity 来源一致性 — 对 cart、pcwalton、mockersf、loreball 等实体页做至少 2 个独立源确认。

历史周期：2026-06-09 ~ 2026-06-16

✅ 完成

  1. Bevy 0.19 进入 rc.3 阶段，里程碑从 99.2%→99.8%→99.1%（scope creep），final 再次推迟

    • 6/9 里程碑 519/523（99.2%，4 open）：#24464 BSN docs 大修（+888/-640，清除 “Inheritance” 概念，关闭 3 issues）。
    • 6/10 爆发 25-PR merge wave（本周最大日）：Beer’s law volume attenuation（#24516，重大 PBR 正确性修复）、Feathers modal dialog（#24559）、Okhsla/Okhsva 色彩空间（#24137）、pipeline constants for materials（#24502）、AmbientLightFlags WGSL rename（#24509，BREAKING）。3 个迁移敏感变更。
    • 6/11 里程碑 527/528（99.8%，1 open）：BSN field name shorthand（#24526，S-Blocked 解除）、bindless transmission fix（#24573）、release notes copyediting（#24577）。当日仅剩 #24582。
    • 6/12 rc.3 发布（6/10），但 resources-as-components 回归（#24594，P-Regression）出现，里程碑回退到 527/531（4 open）。Name From<&str>→From<&‘static str>（#24544，BREAKING）。
    • 6/13 安静日（0 merged PRs），里程碑膨胀至 527/532（5 open）。首个 0.20 issue 出现（#24610）。
    • 全周累计：9 天 43+ PRs 跟踪。rc.3 已发布但 regression 未解，final 从「imminent」降级为「watch regression」。

  2. Diagnostic overlay 概念页 + cart 实体页创建

    • 6/15 基于 #24611（cart）创建 concepts/diagnostic-overlay.md（FPS/frame_time 诊断覆盖层配置、点击穿透修复历史）和 entities/cart.md。
    • 修复上游数据错误：GH @cart 名字从 “Catheryne Carter” 纠正为 “Carter Anderson”。
    • Schema 新增 diagnostics 标签。
    • 索引从 120→122 页。

  3. Lint 连续 8 天结构零缺陷

    • 6/9~6/16 每日 lint 均为 [CLEAN]：0 orphan、0 broken wikilinks、0 not-in-index、0 frontmatter errors、0 tag violations。
    • 警告维持稳定：1 contested、26 medium-confidence、19 large pages。
    • 新增 raw article 完整性验证：6/11 和 6/15 两次 ingest 后均有文件存在确认。

  4. Raw provenance 持续补强

    • 6/11 创建 2 raw articles（#24488 ECS safety comments、#24573 bindless transmission fix）。
    • 6/15 创建 3 raw articles（#24611 diagnostic overlay）。
    • 所有 raw files 在创建后经实际存在验证，确认无「log 称已建但文件缺失」的问题。

🔴 卡点

  • Resources-as-components regression（#24594，P-Regression）—— 0.19 final 的实际 blocker — alice-i-cecile 已 filed 3 issues 并 opened fix PR，但截至 6/16 仍需 SME review。类型同时作为 Resource 和 Component 不再有效，影响所有使用此模式的项目。
  • Bevy 0.19 final 从「imminent」降级为「watch regression」 — rc.3 已发布（6/10），但回归问题使 milestone 从 1 open 回退到 5 open。等 regression fix 合并后仍需切 rc.4？或 direct final？时间线不可测。
  • 大型页面继续膨胀 — bevy-game-dev-2026-06.md（662 行）、bevy-migration-2026-06.md（478 行）、bevy.md（515 行）持续日更积累。若 0.19 final 前继续日更，月底将重演 5 月的超大文件问题。
  • DeerFlow cron PRs（#1092、#2624）本周无任何进展 — 上次更新在 6/8，本周无 DeerFlow 更新，2.0-m1 是否已正式发布？cron 是否进入 2.0.0 scope？需一轮检查。
  • 日更 ROI 持续下降 — 6/136/16 连续多日只有 lint + 02 PRs 可记，但日更每天仍执行 4 个文件更新。0.19 final 后必须降频。

🔁 可复用的经验

  • 上游数据源头验证 — 6/15 创建 cart.md 时，analyst 提供 “Catheryne Carter”，经实际查阅 GH @cart + Bevy Foundation announcement 确认为 “Carter Anderson”。建议：对所有 person entity 页做至少 2 个独立源确认。
  • 25-PR merge wave 分类模式再次验证 — 6/10 的爆发日延续了「BREAKING / MAJOR / additive / bugfix」四级分类，事后迁移清单提取效率明显高于逐条记录。已稳定为 Bevy 日更的标准格式。
  • Raw article 完整性验证已落地 — 6/11 和 6/15 的 ingest 已包含 file-existence verification，不再重蹈 5/30 的 “log 声称创建但文件未写入” 问题。
  • Lint 稳定性证明 schema 成熟 — 连续 8 天 [CLEAN] 说明 taxonomy、frontmatter 规范、lint 脚本均已进入稳定维护期，无需额外调整。

⚠️ 需要调整的决策

  • Bevy 0.19 final 预期从「imminent」修正为「回归依赖」 — 上周的判断「final 真正即将到来」被 resources-as-components regression 否定。应关注 #24594 fix PR 状态而非 milestone 百分比。
  • 日更降频不能等到 final 后再执行 — rc.3 后 merge rate 骤降，但日更仍在执行，每天产生 4 个文件更新却只记录 0~2 PRs。建议立即切换为「事件驱动 + 每周综述」而非等待 final 发布。
  • 大型页面赛前拆分需评估 — 0.19 仍未发布，bevy-game-dev-2026-06.md（662 行）和 bevy-migration-2026-06.md（478 行）仍在增长。考虑在 6 月底前以「rc timeline + breaking changes + release retrospective」三类提前拆分，避免重蹈 5 月 ~800 行的局面。
  • DeerFlow 跟踪节奏调整 — 本周零更新，说明 DeerFlow 已进入 2.0-m1 finalize 静默期。下周应主动做一次全貌检查（stars、m1 进度、cron 状态、2.0.0 scope），而非等待 cron 驱动。

🎯 下周重点

  1. 追踪 resources-as-components regression（#24594）fix PR 状态 → 决定 Bevy 0.19 final 时间预期。
  2. 评估并执行日更降频：切换到「事件驱动 + 每周 1~2 次大更新」模式，减少 lint/日更空转。
  3. 做一次 DeerFlow 全貌检查（stars、m1/m2 状态、cron PRs、2.0.0 milestone scope）。
  4. 若 0.19 final 发布前不再爆发大 merge wave，提前拆分 6 月日更页（rc timeline / breaking changes / feature retrospective）。
  5. 对 6 月所有 person entity 页做一次来源一致性检查（cart 错误说明此检查必要）。

历史周期：2026-06-02 ~ 2026-06-08

✅ 完成

  1. Bevy 0.19 final 真正进入「imminent」状态：open items 从 10 降至 ~3

    • 6/2 创建 6 月追踪体系：bevy-game-dev-2026-06.md + bevy-migration-2026-06.md，5 个 PR 合并（ScenePatchInstance queue fix、double-sided normals、panic → fallback error handler）。
    • 6/3 爆发 23-PR merge wave：vertex buffer compression（#21926，+2251/-433，7 个月 review）、meshlet CPU 优化（52%→6.7%）、define_label! breaking change（#24445）、glTF clearcoat（#24514）。
    • 6/4 安静日仅 1 个 PR（#24520 shader regression hotfix）。
    • 6/5 合并 3 个 PR：BSN inline macros（#24524）、font asset resolution overhaul（#24362，BREAKING，+237/-104）、custom_phase_item docs 修正。
    • 6/6 合并 4 个 PR：PbrNeutral → KhronosPbrNeutral BREAKING rename（#24530）、bsn! autocomplete fix（#24519）、text layout scheduling（#24538）、resources_as_components migration docs（#24513）。
    • 6/7 Scene ecosystem day：5 个 PR 合并，包括 0.19 官方 release notes「Next Generation Scenes」（#24523）、SceneList for SmallVec（#24542）、Scene for Option

      （#24536）、MenuButton 导航修复、IME 文本修复。

    • 6/8 合并 3 个 PR：Feathers scrollbar/list view（#24544，关闭里程碑长期项 #24092）、HierarchyPropagatePlugin remove-insert fix、SystemHandle run support。里程碑 ~514/520（~3 open）。
    • 全周累计：0.19 milestone 从 500 → 520 items，open 从 6 → ~3，百分比维持在 98.8%。

  2. PBR 渲染专题入库

    • 6/4 创建 4 篇 PR raw articles（#24514 clearcoat texture、#24453 transmission roughness IOR、#24484 clippy mem_forget、#24445 define_label! interner）。
    • 新建 2 个概念页：concepts/clearcoat.md（glTF KHR_materials_clearcoat）、concepts/transmission.md（glTF KHR_materials_transmission）。
    • 新建 2 个实体页：entities/standard-material.md（StandardMaterial 属性表与修复记录）、entities/bevy-pbr.md（bevy_pbr crate 架构）。
    • 四页交叉链接，并与 bevy-rendering.md、bevy.md 建立关联。

  3. BSN 概念页大规模扩展

    • 6/7 基于 0.19 release notes（#24523）扩展 concepts/bsn.md：新增 12 个子节（Scene Functions、Scene Spawning Systems、Scene Lists、BSN Relationships、Composable Patch、Templates & FromTemplate、Inline Asset Templates、Entity Reference Syntax、Implicit Into、Event Observation、Scene Assets & Caching）。
    • 补充 Option

      Scene（#24536）和 SmallVec SceneList（#24542）子节。

    • 创建 3 个 raw articles（#24523、#24536、#24542）。

  4. DeerFlow 2.0-m1 进入 RC 阶段

    • 6/3 更新：stars 70.3k，2.0-m1 里程碑 168/184（91%），RC tags v2.0-m1-rc0/rc1 已切。
    • 新 2.0.0 里程碑出现（1/18 = 5%），预示 CLI engine、credential isolation、layered architecture 后 m1 路线。
    • Cron PRs（#1092、#2624）仍未合并，仍是企业部署最大阻塞。

  5. Lint 连续 5 天结构零缺陷

    • 6/2、6/3、6/4、6/7、6/8 均为 [CLEAN]：0 orphan、0 broken wikilinks、0 not-in-index、0 frontmatter errors、0 tag violations。
    • 警告数从 37 → 45，主要增长来自大型页面（16 → 18）和 medium-confidence（20 → 26）。

🔴 卡点

  • Bevy 0.19 final 仍未发布 — 虽然只剩 ~3 open items，且 6/8 关闭了长期项 #24092，但 final 尚未切 tag。Scope creep 从 500 → 520 持续膨胀，意味着「最后 3 项」可能被新增 docs/BSN-polish 任务替换。
  • 里程碑百分比已失效 — 全周 98.6%→98.8%，但 open count 从 6→10→7→8→6→~3 波动剧烈，百分比无法反映实际进度。需要以「open count + 是否有关键 blocker」为主要指标。
  • 大型页面继续膨胀 — bevy-game-dev-2026-05.md（800 行）、bevy-migration-2026-05.md（765 行）已严重 oversized；bevy-game-dev-2026-06.md（新建）和 bevy-migration-2026-06.md（新建）若持续日更，月底将再次膨胀。
  • DeerFlow cron 仍是企业部署阻塞 — 2.0-m1 RC 已切，但 cron PRs（#1092、#2624）仍未进入合并队列，说明企业级定时任务调度不是 2.0-m1 优先项。

🔁 可复用的经验

  • 按 impact 分级记录 23-PR merge wave — 6/3 的爆发日按 BREAKING / MAJOR / additive / bugfix 四级分类记录，事后检索和迁移清单提取效率远高于流水账。
  • PR → raw → concept → entity 流水线已验证 — PBR 专题（clearcoat/transmission/StandardMaterial/bevy-pbr）从 4 个 PR 到 4 个 wiki 页面，仅用一个 session 完成，说明渲染/图形类知识适合快速实体化。
  • 按月切分日更追踪页 — 6/2 新建 bevy-game-dev-2026-06.md / bevy-migration-2026-06.md，避免 5 月文件无限膨胀，是可持续的日更模式。
  • 0.19 release notes 直接作为概念页扩充来源 — #24523 官方 release notes 不是简单记录为 raw，而是直接拆解为 BSN 概念页 12 个子节，将「发布材料」转化为「长期知识库」。

⚠️ 需要调整的决策

  • 0.19 final 后立即执行降频 + 拆分 — 本周验证：日更在高密度 merge 期有价值，但 6/8 后只剩 ~3 open items，日更 ROI 趋近于零。final 发布后必须切换为「release digest + breaking changes only」，并立即拆分 5/6 月日更页。
  • 大型页面拆分策略：按「rc timeline / migration guide / feature retrospective」三类 — 而非简单按月切分。bevy-game-dev-2026-05.md 应拆为「0.19 rc timeline」、「0.19 migration guide」、「0.19 release notes」三个独立页面。
  • 里程碑记录维度升级 — 从「百分比 + open count」升级为「百分比 + open count + scope creep 量 + 关键 blocker 状态」。在 bevy.md 中已自然记录，但建议创建 bevy-milestone-dynamics.md 概念页独立沉淀。
  • DeerFlow 跟踪从「m1 进度」转向「2.0.0 路线」 — 2.0-m1 即将发布，后续 wiki 应关注 2.0.0 里程碑中的 cron、credential isolation、layered architecture 是否进入企业需求射程。

🎯 下周重点

  1. 紧跟 Bevy 0.19.0 final 发布 → 立即将 bevy-migration-2026-05.md + bevy-migration-2026-06.md 合并为正式迁移指南，并归档日更页。
  2. 执行日更降频：final 后改为「release digest + 重大 breaking changes only」，预计每周 1~2 次更新。
  3. 拆分 bevy-game-dev-2026-05.md（800 行）和 bevy-migration-2026-05.md（765 行）为专题子页。
  4. DeerFlow 2.0-m1 正式版发布跟踪，评估 cron 是否进入 2.0.0 scope。
  5. 验证 BSN 扩展页（concepts/bsn.md）的 cross-link 完整性：确认 12 个新子节均已链接到相关实体/概念页。

历史周期：2026-05-26 ~ 2026-06-01

✅ 完成

  1. Bevy 0.19 final 从「imminent」转为「release drift」再恢复推进

    • 5/26~5/28 连续 6 天几乎无功能性合并，0.19 milestone 从 466/485（96%，19 open）膨胀到 466/490（95.1%，24 open）。
    • 5/29 merge train 恢复：8 个 PR 合并，里程碑回到 480/495（97.0%，15 open）。
    • 5/30 再合并 4 个 PR，里程碑推进到 485/497（97.6%，12 open）。
    • 本周关键判断从「final 即将发布」修正为「仍受 performance regression #24448 与 late rc 修复节奏影响，但已重新接近发布」。

  2. 0.19 迁移 watchlist 持续更新，覆盖新的 breaking / additive API

    • 记录并沉淀 #24404 SortedRenderPhase::add → add_retained breaking change。
    • 记录 #24424 Immutable Resources API 补充、#24405 SmallVec SystemParam、#24440 FromTemplate → Default+Clone 清理。
    • 记录 #24473 BSN caching unsupported syntax 改为 compile-time error、#24406 BundleWriter RelationshipHookMode additive API。
    • 相关页面 bevy.md、bevy-game-dev-2026-05.md、bevy-migration-2026-05.md 持续保持同步。

  3. Raw provenance 补强与一次写入缺口修复

    • 5/29 创建 5 个 PR raw articles：#24404、#24424、#24405、#24440、#24408。
    • 5/30 创建 3 个 raw articles：#24486、#24473、#24406，并在后续核查中发现前一轮 log 已记录但文件未实际写入。
    • 5/30 追加修复：实际创建缺失的 3 个 raw 文件，并补齐 entities/bevy.md、concepts/bevy-game-dev-2026-05.md、concepts/bevy-migration-2026-05.md 的 sources frontmatter。

  4. Bevy Remote Protocol (BRP) 专题入库

    • 5/31 新建 raw/articles/bevy-remote-protocol-research-sources-2026-05.md。
    • 新建 entities/bevy-remote-protocol.md，明确 BRP 是 JSON-RPC 运行时 ECS inspection/mutation protocol，是 editor tooling、自动化测试和 agent-driven debugging 的协议底座，而不是 Bevy Editor 本身。
    • 更新 entities/bevy-version-notes.md 与 concepts/bevy-game-development.md 的交叉链接。

  5. Lint 继续保持结构零缺陷

    • 5/26~6/1 每日 lint 均为 [CLEAN]：0 orphan、0 broken wikilinks、0 not-in-index、0 frontmatter errors、0 tag violations。
    • 5/26 处理一轮结构维护：归档 2 个 orphan stub，补齐 7 个 index 缺口，修复 4 个 tag violation，新增 12 个 taxonomy tags。
    • 警告维持稳定：1 contested、20 low-confidence、16 large pages；最大页面仍是 bevy-arpg-combat-ecs.md、bevy-game-dev-2026-05.md、bevy-migration-2026-05.md。

🔴 卡点

  • Bevy 0.19 final 未发布且节奏漂移 — 5/23 rc.2 后并未快速 final，5/26~5/28 连续无功能合并，open issues 一度升至 24；「imminent」判断需要降级为「watch release blockers」。
  • Performance regression #24448 仍是潜在 blocker — 5/29 已确认 root cause 来自 PR #23481 的 GPU bin unpacking，但仍处于 S-Waiting-on-SME；若需要 revert，会影响 0.19 final 时间线和迁移说明。
  • 大型活跃页面继续膨胀 — bevy-game-dev-2026-05.md 和 bevy-migration-2026-05.md 已超过 700 行，但仍处于日更活跃期；现在拆分风险高，需等 0.19 final 后归档/切分。
  • 自动化写入可靠性暴露缺口 — 5/30 出现「log 声称 raw 文件创建，但实际未写入」的问题，说明 kanban/writer 产物必须在最终报告前做 file-existence verification。

🔁 可复用的经验

  • Milestone drift 不能只看百分比 — 本周 0.19 从 96%→95.1%→97.6%，百分比本身会被 scope creep 扭曲；更可靠的记录维度是「open issue count、连续无 merge 天数、release-blocking issue 是否有 owner/SME」。
  • Raw article 写入后必须二次验证 — 对所有声称创建的 raw 文件，至少检查文件存在、frontmatter sha256、sources frontmatter 是否引用；5/30 的补救说明验证了这个质量门必要。
  • 日更总结应区分「无新迁移项」和「release risk」 — 5/26~5/28 虽然没有新 migration action，但 milestone 膨胀、gizmo regression、performance regression 都是 release risk，值得记录在 watchlist 而不是沉默。
  • BRP 这类协议页适合建 entity 而非 concept — 它是一个具体 Bevy 子系统/协议实体，后续可以连接 editor、debug tooling、AI agent 调试闭环等多个概念页。

⚠️ 需要调整的决策

  • 0.19 final 前继续日更，但 final 后必须降频 — 本周证明 rc 后期仍可能突然恢复 merge train；在 final 发布前保持日更合理。final 发布后建议切换为「release digest + breaking changes only」。
  • 大型页面拆分延后到版本尘埃落定后 — 现在拆分 bevy-game-dev-2026-05.md / bevy-migration-2026-05.md 会增加同步成本；建议 0.19 final 后按「rc timeline / migration guide / release retrospective」三类切分。
  • 新增 verification gate — 所有由 writer/kanban 声称创建的 raw articles，后续日志前必须验证实际文件存在，并确认 frontmatter sources 已补到对应 synthesis pages。
  • BRP 后续应升为调试工具链专题 — 目前只有实体页；若继续研究 Bevy editor / runtime inspection / agent debugging，应创建 bevy-debug-tooling 或 bevy-agent-debugging-loop 概念页。

🎯 下周重点

  1. 继续跟踪 Bevy 0.19 final：重点关注 #24448 performance regression、milestone open items、是否发布 rc.3/final。
  2. 0.19 final 发布后，立即整理 bevy-migration-2026-05.md 为正式迁移指南，并将日更页面转入归档/拆分流程。
  3. 对本周新增 raw articles 做一次抽样 verify：sha256、source_url、frontmatter sources、正文 provenance 是否一致。
  4. 基于 BRP 页面继续补一篇 Bevy runtime tooling / agent debugging loop 概念页，连接 BRP、Bevy Remote Protocol、editor tooling、自动化测试。
  5. 将大型页面拆分列入 post-release maintenance，而不是在 release 活跃窗口中提前拆。

历史周期：2026-05-19 ~ 2026-05-25

✅ 完成

  1. Bevy v0.19.0-rc.2 发布，rc.1 全部阻塞项清零

    • 5/21 一天内解决全部 3 个 rc.1 blockers（#24282 crates.io 命名、#24279 tileset y-axis、#24352 2D crash），里程碑 448/457 (98%)
    • 5/22 BSN Prefix Overhaul (#24367) 合并，引入 ~/@ 新语法，:Template 旧语法废弃
    • 5/23 v0.19.0-rc.2 正式发布，所有 rc.1 blockers 已关闭，0.19 final imminent
    • 全周跟踪 30+ merged PRs，涵盖渲染（Solari light leak #24332、GPU batching #24365、Skybox cleanup #24389）、ECS（MovingPtr unsoundness #24375）、UI（FixedNode #24323、Text2d size #24399）、Asset（AssetId deprecation #24392）

  2. 渲染管线深度专题两波爆发

    • 阴影映射系统：从 0 到完整概念页 bevy-shadow-maps.md，覆盖 ShadowLodOrigin (#24289)、GPU HLOD (#24343)、RenderShadowLodOrigin crash fix (#24359)、SpotLight Frustum docs (#24324) 完整 PR 链
    • Solari 路径追踪器：新建 bevy-solari-pathtracer.md，梳理 BRDF 能量守恒 (#24243)、光照泄漏 (#24332)、OpenPBR vs Filament 选型
    • Skybox / 双世界同步：PR #24389 触发新建 skybox.md + sync-component-plugin.md，记录 ExtractComponentPlugin 路径偏离时的手动注册陷阱

  3. ECS 事件与状态生命周期时序跨框架调研

    • 5/25 完成两波调研：Bevy 特定问题（事件双缓冲延迟、run_if 静默丢事件、Observer 递归风险）+ 跨框架对比（Bevy vs Flecs vs Unity DOTS vs Entitas vs Godot）
    • 新建概念页：bevy-ecs-event-timing.md、bevy-state-lifecycle-timing.md
    • 新建对比页：ecs-event-state-timing.md
    • Schema 扩展：events、observers、deferred-execution 标签入库

  4. Billboard 渲染跨引擎对比

    • 5/22 研究员 kanban 任务产出 → wiki：新建 bevy_mod_billboard.md（实体）、billboard-rendering.md（概念）、billboard-cross-engine.md（六引擎功能矩阵对比）
    • 产出 Bevy 缺失清单 8 项，可直接指导 ZoOL 的 3D 血条/粒子文字实现

  5. Lint 与结构零缺陷保持

    • 5/19~5/25 每天 lint，结构性问题连续 7 天为 0
    • 仅 5/20 修复 3 个 tag violation（shadow、lod、gpu），5/22 修复 1 个（person），5/23 修复 2 个（path-tracing、global-illumination）
    • 截至 5/25 总页数 104，raw articles 持续积累，零孤儿页、零断链

🔴 卡点

  • 0.19 final 仍未发布 — rc.2 后 milestone 从 466/474 (98%) 膨胀到 466/478 (97.5%)，open issues 从 8 → 12，“imminent” 已持续两周，交付日期不可测
  • BSN Prefix Overhaul 后期 breaking change — #24367 在 rc.2 窗口期引入 ~/@ 语法，所有现有 BSN 代码需迁移，late-cycle breaking change 增加 final 前稳定性风险
  • TextLayoutInfo 回归链 — #24245 引入 → #24384 报告 multi_window_text 崩溃 → #24399 修复，显示 rc 阶段仍有未覆盖的 2D/UI 回归

🔁 可复用的经验

  • “rc blocker 清零” 追踪模式 — 5/21 一天内 3 个 blocker 全解，wiki 中 bevy.md 的 watchlist 按 “blocker / milestone / merged PR” 三层结构记录，事后复盘时因果关系清晰
  • Bugfix → 设计教训页面 — PR #24389（Skybox 一行修复）不仅记录为 raw article，还上升为 sync-component-plugin.md 概念页，将具体 bug 转化为可复用的架构知识
  • 跨框架对比页结构 — ecs-event-state-timing.md 采用 “机制 → 表现 → 应对策略” 三列对比，比单纯罗列事实更易指导技术选型

⚠️ 需要调整的决策

  • 日更节奏：rc 阶段仍有高密度事件，但 final 发布后需降级 — 当前每日仍有 3~7 PRs 值得记录，但 0.19 final 发布后应切换为 “release 驱动 + 重大架构变更驱动” 模式，避免空转
  • 里程碑膨胀记录已落地 — 上周决策要求增加 “里程碑膨胀观察”，本周 bevy.md 已自然记录 466/478 (97.5%)，但尚未独立成页；若 0.19 发布后 milestone 继续膨胀，建议创建 bevy-milestone-dynamics.md 概念页
  • Contributor 实体页维护成本 — 本周新建 pcwalton / loreball / mockersf 3 个实体页，但 contributor 信息可能快速过时；建议设定阈值：仅当某 contributor 有 ≥3 个 impactful PRs 或担任 reviewer 时才建实体页

🎯 下周重点

  1. 紧跟 Bevy 0.19.0 final 发布 → 立即更新 bevy-migration-2026-05.md 为正式版迁移指南，升级 bevy.md release 历史
  2. 评估日更降级方案：final 发布后改为 “每周综述 + 重大 PR 即时更新” 混合节奏
  3. 继续 ECS 时序专题：将 bevy-ecs-event-timing.md 与现有 bevy-ecs-messaging.md 深度整合，可能合并或建立双向交叉引用
  4. 若 Billboard 对比结论进入 ZoOL 项目实现阶段，将设计决策沉淀到 projects/bevy-game/ 决策记录

历史周期：2026-05-12 ~ 2026-05-18

✅ 完成

  1. Bevy 0.19.0-rc.1 发布

    • 5/14 首个 RC 版本发布，里程碑 433/440 (98%)，release gate 基本清空
    • 5/18 BSN EntityTemplate (#24174) 合并，解锁 bsn! 实体名称引用能力
    • 全周跟踪 20+ merged PRs，包括 Solari BRDF 分层修正、GPU culling revert、FXAA/SMAA 公开、EditableText 修复等

  2. 体素渲染深度专题

  3. Lint 与结构稳定性

    • 5/15、5/16、5/17、5/18 四次 lint，结构性问题均为 0
    • 15 个 medium confidence + 14 个 large page 警告，无阻断
    • 5/16 批量修复 2 个 tag violation（feature-flags、migration 补入 taxonomy）

🔴 卡点

  • 0.19 正式版仍未发布 — rc.1 后 merge train 冻结，SME 决策阻塞于 crates.io 命名 (#24279) 和 tileset y-axis (#24275)
  • 里程碑 scope creep — 从 440 → 449 items，open issues 从 7 → 14，“99%” 的幻觉持续，实际交付日期不可测

🔁 可复用的经验

  • Lint 完全自动化 — 连续 4 天 lint 零结构性问题，维护开销趋近乎于零，说明 taxonomy 和 frontmatter 规范已稳定
  • 专题深度 ingest 模式 — 体素专题一天内完成 raw → entity ×2 + concept ×2 + comparison ×1，验证了 “一日一专题” 爆发式知识整理能力

⚠️ 需要调整的决策

  • 日更频率 vs 信息密度 — rc.1 冻结后大量日子为 “0 merged PRs”，需评估是否继续每日更新还是改为 “有实质变化才更新”
  • 里程碑膨胀记录 — 449 items 且持续增长，应在 bevy.md 中增加 “里程碑膨胀观察” 段落，避免被百分比误导

🎯 下周重点

  1. 紧跟 Bevy 0.19 正式版 / rc.2 发布 → 立即更新 migration-notes
  2. 监控 SME 阻塞 issue #24279 和 #24275 的决议
  3. 评估日更节奏，考虑改为事件驱动（仅在有 release/重大 PR 时更新）
  4. 考虑新增 “Bevy 里程碑观察” 概念页，记录 scope creep 模式

历史周期：2026-05-05 ~ 2026-05-11

✅ 完成

  1. Bevy 0.19 发布倒计时

    • 每日跟踪 Bevy 动态，本周合计 60+ PRs 被 merge
    • 0.19 里程碑从 97.7% 推进到 99.3%，发布备志录 sprint 已完成
    • 关键功能：feathers 正式版、Scene Components、wgpu 29.0.3、resource hooks、Quit on RenderErrors

  2. Wiki 大规模扩张

    • 从 Obsidian Vault 迁移 9 篇 Bevy 学习文章进 wiki（坐标系、状态管理、插件注记等）
    • 页数从 22 → 44，翻倍
    • 新增：游戏设计理论（HP、伤害公式 6 篇、ARPG 对比 3 篇）、像素画纹理过滤研究、Bevy 博客索引

  3. Lint 与质量门

    • 5/9 次大规模 lint：修复 4 页断链 wikilink、补齐 frontmatter、更新 Tag Taxonomy 50+
    • 5/10 拆分超大页面 4 → 13 页（damage-formulas 6 篇、arpg 3 篇、bevy-migration 2 篇、bevy-game-dev 2 篇）
    • 5/11 P0 修复：修复 15 个断链、创建 hub 页面、bulk 补充 frontmatter 31 页

🔴 卡点

  • 0.19 仍未发布 — 几乎每天 99%，但 release 一直在 “imminent”。可能差一个最后的 CI 网关或 maintainer 最终 review。
  • raw/ 不可变策略 — 5/7 审核发现 raw/ 中旧文章保留了错误的 Scene Components 代码片段，但按规范不能直接修改 raw/。需要在非 raw 页面用正确表述覆盖。

🔁 可复用的经验

  • 超大页面拆分规则生效 — 5/10 的拆分验证了 schema 中 “200 行分割”线是有效的，未来可以用于其他胆大页面。
  • Vault 迁移模式 — 从 Obsidian Vault 迁移现有笔记到 wiki 是高效率知识复用的方法，可复用于其他专题收集。

⚠️ 需要调整的决策

  • Tag Taxonomy 需定期审查 — 5/9 次 lint 时更新了 50+ tags，需要在下次 lint 时检查是否有漂浮 tags（即未在 taxonomy 中定义的 tags）。
  • Bevy-blog 项目空间需更新 — 现有已发布 16 篇文章已索引，但 tasks.md 中的 0.19 解读任务还未完成。发布后需要更新 outputs/。

🎯 下周重点

  1. 紧跟 Bevy 0.19 正式发布 → 立即更新 migration-notes 和项目空间
  2. 修复 3 篇 Bevy 空白文章（知识缺口）
  3. 继续 DeerFlow 周度跟踪（关注 cron PR #1092 是否 merge）
  4. 考虑创建”游戏设计”专题标签组（伤害公式、HP、ARPG 对比等）

历史周期：2026-04-27 ~ 2026-05-02

✅ 完成

  1. Wiki 架构搭建

    • 从评估报告出发，12 次操作完成四层建设：system/、projects/、pages/、archive/
    • Wiki 从 7 页扩展到 20 页
    • 8 层结构全部就位：index、schema、system、projects、pages、raw、assets、archive

  2. Profile 角色化

    • coder → Builder（完整 SOUL）
    • writer → Writer（含 ZoOL 写作风格指南）
    • researcher → 已有清晰 SOUL，补齐 MEMORY.md

  3. Bevy 0.19 素材准备

    • 写作 Brief 已备，等待 Writer 启稿
    • 0.19 里程碑 96%，接近发布

  4. 发布工作流

    • omni-pub BEVY 主题更新
    • Goldminer Stage 3 文章发布（公众号）

🔴 卡点

  • 0.19 暂时还差 14 个 issue，无法写正式发布稿，但可以写特性汇总
  • Gateway 未运行，使用时需要手动启动

🔁 可复用的经验

  • SOUL.md 模板：Researcher 的 SOUL 结构（身份/职责/流程/边界/质量/语言）可以作为标准模板
  • 项目空间模板：context + AGENTS + tasks + decisions + log + inbox + outputs 可以作为所有未来的项目标准结构
  • Brief 模式：Coordinator（current profile）准备 Brief → Writer 写稿的模式效率高

⚠️ 需要调整的决策

  • Writer 模型绑定 → ✅ 已解决（moonshotai/kimi-k2.6 via OpenRouter）
  • Gateway 管理：3 个 Gateway 目前全停止，需要决定是保持常开还是按需启动

🎯 下周重点

  1. ZoOL 切换到 Writer 写 Bevy 0.19 草稿
  2. 考虑绑定 Writer 的模型
  3. 继续跟踪 0.19 milestone → 正式发布时更新文章发布
  4. 如果 Goldminer Stage 4 有想法，开始规划

Graph View

Backlinks