index

Wiki Index

Content catalog. Every wiki page is listed under its type with a one-line summary. Read this first to find relevant pages for any query. Last updated: 2026-09-10 | Total pages: 152

Entities

• bevy — Rust ECS-first game engine; hub for Bevy engine notes, ecosystem findings, and ZoOL’s Bevy-related research.
• bevy_mod_billboard — Bevy 生态唯一专注 billboard 渲染的 crate（v0.7.0），支持 styled text、Y-axis locking、HDR，但已停滞近两年（仅兼容 Bevy 0.14）。
• bevy_mod_outline — Bevy 最成熟的网格描边插件，提供从简单顶点挤出到 JFA 距离场的多种描边渲染方式。
• bevy-pbr — Bevy 的 PBR 渲染 crate（bevy_pbr）：StandardMaterial、PBR shader、光照、阴影映射、0.19 clearcoat/transmission 修复。
• bevy_voxel_world — Bevy 体素地形插件：双层架构、多线程 meshing、chunk 管理、LOD、纹理数组、射线检测。
• block-mesh — Rust 体素网格化底层库：block-mesh crate、greedy_quads + visible_block_faces 双算法、126+ downstream 仓库。
• bevy-blog-index — ZoOL 的 Bevy 博客文章完整索引（16 篇，涵盖版本速览、核心概念、插件工具、实战教程）。
• bevy-coordinate-systems — Bevy 坐标系统深度解析：世界/局部/UI/NDC 空间、Transform 与 GlobalTransform 延迟同步机制。
• bevy-ecosystem-catalog — Bevy 流行插件生态完整目录（2025-05-09 调研），按功能领域分类的 crates.io 下载量排名。
• bevy-entity-design — Bevy Entity 结构源码解读：分代索引（Generational Indices）如何解决 ECS 中的 ABA 问题。
• bevy-landmass — Bevy 游戏引擎的导航插件，提供 AI 角色的寻路和局部碰撞规避功能。
• bevy_health_bar3d — 基于 billboard shader 的 Bevy 3D 血条 plugin，支持 2D/3D 渲染、自动面朝相机、自定义颜色、Percentage trait 适配任意组件。
• bevy-plugin-notes — Bevy 插件与工具生态笔记：战争迷雾、Flash 动画、第三人称模版等。
• bevy-puzzle-game — Bevy 拼图游戏开发实战系列分析（Day 1/4/5）：贝塞尔曲线切割、拖拽交互、性能优化。
• bevy-state-lifecycle-timing — Bevy States 生命周期时序问题：OnEnter 延迟触发（#7633）、状态钩子执行时机模糊、应对策略。
• bevy-state-management — Bevy 0.16 状态管理初学者指南精华：States、OnEnter/OnExit、StateScoped、run_if。
• bevy-rendering — Bevy 渲染系统核心概念与近期关键修复（阴影闪烁、GPU 裁剪等）。
• bevy-remote-protocol — Bevy Remote Protocol (BRP)：基于 JSON-RPC 的运行时 ECS 远程检查/修改协议，是 editor、debug tooling、自动化测试和 AI 调试的底层接口。
• bevy-shadow-maps — Bevy 阴影映射系统架构：visibility ranges 语义、ShadowLodOrigin 修复（0.19）。
• bevy-solari-pathtracer — Bevy Solari GPU 路径追踪器：BRDF 能量守恒修复、OpenPBR vs Filament 选型、reciprocity 权衡。
• bevy-sphere-topology — Bevy Sphere 拓扑选择：UV Sphere 与 IcoSphere 的适用场景、API 与性能对比。
• bevy_sprite3d — 将 2D sprite 以 perspective camera 渲染到 3D 世界的 Bevy 社区 crate（兼容 Bevy 0.16），被官方推荐为 billboard workaround。
• bevy-time-system — Bevy 三种时间系统详解：Real / Virtual / Fixed 的适用场景与行为差异。
• bevy-ui-text — Bevy UI 文本布局系统概念与底层修复记录。
• bevy-0-19-ui-feature-modularization — Bevy 0.19 UI feature 拆分及渲染陷阱：bevy_ui_render / system_font_discovery 与其他关键 feature 的必要性。
• bevy-0-19-release-notes — Bevy 0.19 官方博文完整摘要：BSN、Text Input、Rich Text、App Settings、Render Recovery、Bindless、SIMD、Contact Shadows、SSR、Area Lights 等全部 31 个核心章节。
• bevy-version-notes — Bevy 0.15/0.16/0.17 版本速览对比：核心特性、性能突破、升级注意事项。
• deerflow — ByteDance open-source SuperAgent harness with LangGraph, sandbox, memory, skills, MCP, sub-agents, and IM gateways.
• diablo-4 — Diablo 4 产品动态与设计理念：品质与新手友好位定下的终局追赶战略。
• grim-dawn — Grim Dawn 产品动态与设计理念：双精通组合系统与星座（Devotion）后期深度层。
• hit-points — 游戏中 HP 的原始定义（Hit Points，非 Health Points）、D&D 起源、历史演变与电子游戏传播。
• jms55 — Bevy 渲染核心贡献者：Solari 路径追踪器负责人、virtual geometry（meshlet）作者。
• landmass — 引擎无关的 Rust 导航算法 crate，是 bevy_landmass 的核心底层。
• last-epoch — Last Epoch 产品动态与设计理念：构筑深度与易上手度平衡的第三选择 ARPG。
• loreball — Bevy BSN 宏能力贡献者：#24336 bsn! const/unsafe block 支持。
• mockersf — Bevy 生态贡献者：#24317 bevy_settings → bevy-settings 重命名修复 rc.1 编译问题。
• cart — Carter Anderson，Bevy 创建者 / Bevy Foundation 负责人 / 核心维护者（BSN、diagnostic overlay 等）。
• oxidized-navigation — 从物理碰撞体自动生成导航网格（navmesh）的 Bevy 插件。
• path-of-exile-2 — Path of Exile 2 产品动态与设计理念：硬核动作 + 极深角色构筑的刷宝 ARPG 标杆。
• pcwalton — Bevy 渲染核心贡献者：GPU HLOD、ShadowLodOrigin、2D crash 修复。
• skybox — Bevy Skybox 组件：天空盒渲染、bevy_light 迁移历史、0.19 渲染世界清理 bugfix（PR #24389）。
• sidedawn — ZoOL 的等距 3D toon ARPG，锁定名 SideDawn；开发日志在 projects/sidedawn/。
• standard-material — Bevy StandardMaterial PBR 材质组件：属性清单、clearcoat/transmission 近期修复、使用模式。

Concepts

• arpg-camera-perspective — ARPG 视角设计深度研究：三种视角路径（等距/俯视/第三人称）、经典案例分析、Bevy 技术实现、设计决策框架。
• arpg-character-proportions — ARPG 角色模型比例与头身比设计规范：等距视角下的建模补偿技巧、主流游戏比例对比、Stylized Realism 推荐起点、Bevy 验证方法。
• arpg-terrain-design — ARPG 地形设计深度研究：开放世界与地下城组织模式、等角视角约束、Tile-Based 程序化管线、Arena 战斗空间设计、Biome 环境叙事、Bevy 技术实现路径。
• arpg-market-trends-2020-2025 — ARPG 市场与设计趋势（2020–2025）：五大核心趋势、市场规模与转化率、设计范式检查清单、未来信号。
• arpg-facing-combat — ARPG facing / 碰撞 / 遭遇（mosaic 研究合成；非 SideDawn 实现）。
• arpg-loot-economy — ARPG 掉落与经济综述（mosaic 2026-08-15；非产品锁）。
• arpg-ui-hud — ARPG HUD / 物品界面显示惯例（mosaic 2026-08-16；非 UI 锁）。
• arpg-skill-gem-assembly — 技能宝石拼装分层（mosaic 历史；SideDawn 无 skill crate）。
• astar-pathfinding — A* 寻路算法：图搜索算法，在游戏 AI 中广泛用于从起点到目标点的最短路径查找。
• bevy-development-patterns — Bevy 开发模式与工程实践笔记。
• bevy-ecs-game-type-fit — Decision note for matching game genres to Bevy ECS using the homogeneous-entity-density × update-frequency heuristic.
• bevy-ecs-event-timing — Bevy ECS 事件时序问题：双缓冲帧延迟
• bevy-ecs-event-state-roadmap — Bevy 事件/状态时序问题官方路线图与社区方案、run_if 陷阱、Message/Event 拆分、Observer 递归风险。
• bevy-ecs-messaging — Bevy ECS 消息系统语义约定与 MessageReader 文档改进。
• bevy-game-development — Reusable Bevy/Rust game-development practices, patterns, and implementation notes (April 2026 and earlier).
• bevy-game-dev-2026-05 — Bevy engine changes and development tracking for May 2026.
• bevy-game-dev-2026-06 — Bevy engine changes and development tracking for June 2026.
• bevy-game-dev-2026-07 — Bevy engine changes and development tracking for July 2026.
• bevy-game-dev-2026-08 — Bevy engine changes and development tracking for August 2026.
• bevy-game-dev-2026-09 — Bevy engine changes and development tracking for September 2026.
• bevy-migration-notes — Upgrade-sensitive Bevy changes and action items for April 2026.
• bevy-migration-2026-05 — May 2026 migration-sensitive changes and milestone tracking.
• bevy-migration-2026-06 — June 2026 migration-sensitive changes and milestone tracking.
• bevy-migration-2026-07 — July 2026 migration-sensitive changes and milestone tracking.
• bevy-migration-2026-08 — August 2026 migration-sensitive changes and milestone tracking.
• bevy-migration-2026-09 — September 2026 migration-sensitive changes and milestone tracking.
• bevy-projects — ZoOL’s Bevy repositories, prototypes, and project-specific implementation notes.
• bevy-toon-shader — Bevy Toon Shader 实现方案：Cartoon Shading 自定义 Material 实现，ARPG 角色渲染。
• billboard-rendering — Billboard 渲染技术概念：球形/圆柱/速度对齐/拉伸 billboard 变体，轴向组合，LOD/Facade 模式。
• bsn — Bevy Scene Notation (BSN) 声明式场景语法层，基于 bsn! / bsn_list! 宏和 SceneComponent derive。
• diagnostic-overlay — Bevy 0.19 bevy_dev_tools 诊断覆盖层：显示 FPS/frame_time，组件清单、配置方式、点击穿透修复历史。
• clearcoat — PBR clearcoat 概念与 Bevy 渲染：glTF KHR_materials_clearcoat、StandardMaterial 集成、#24514 纹理传播修复。
• voxel-rendering — 体素渲染：技术谱系、算法（Naive → Face Culling → Greedy → Marching Cubes）、Chunk 与 LOD 架构、光照与氛围技术、Bevy 生态方案选型。
• greedy-meshing — 贪心网格化算法详解：Mikola Lysenko 排序策略、与 block-mesh Rust 实现、AO 兼容性、Binary Greedy Meshing 优化变种。
• bevy-arpg-combat-ecs — Bevy ECS 战斗系统架构指南：命中检测、伤害管道、状态机、Meta-gem 触发、AOE 优化、与角色/技能/装备系统的集成。
• damage-formulas — 游戏伤害公式体系总览：四大公式对比总表、选型决策框架、子页面索引。
• damage-subtractive — 减法伤害公式详解：数学特性、EHP 推导、不破防死锁、多段攻击惩罚、FE/Terraria 实现。
• damage-percentage — 百分比减伤公式详解：DR 缩放、无敌风险、War3/LoL/Warframe/明日方舟实现。
• damage-division — 除法伤害公式详解：无死角缩放、攻防双向递减、DOTA2/LoL/WoW/RPG Maker 实现。
• damage-exponential — 指数伤害公式详解：完美一致性、对称性、数值膨胀、理论设计参考。
• damage-hybrid-formulas — 混合伤害公式与行业实践：Terraria/原神/明日方舟混合模式、选型指南。
• pixel-art-texture-filtering — 像素画纹理过滤深度研究：GPU 采样管线、Nearest vs Bilinear 数学原理、纹理游走现象、为什么像素游戏必须用 Nearest。
• bevy-pixel-perfect-rendering — Bevy 像素完美渲染方案：pixel_grid_snap 双相机管线、off-screen canvas 渲染、整数倍窗口缩放、RenderLayers 隔离。
• stylized-realism-game-art — Stylized Realism 游戏美术技术分析：定义、四种技术路线、优势与风险、Bevy 生态工具链、对 ARPG 的启示。
• sync-component-plugin — SyncComponentPlugin 概念：Bevy 双世界架构中的组件同步机制、自动注册与手动注册场景、Skybox 迁移 bug 教训。
• transmission — PBR transmission 概念与 Bevy 渲染：glTF KHR_materials_transmission、IOR 粗糙度缩放、#24453 物理正确性修复。
• ragnarok-online-art-style — Ragnarok Online 风格化美术分析：2D sprite + 3D 等距视角场景的混合视觉特征、魅力分析、现代进化尝试、对独立开发者启示、Bevy 实现路线。
• hover-highlighting-techniques — 游戏物体悬停高亮：技术谱系与实现深度解析。
• navmesh — 导航网格：定义游戏世界可行走表面的数据结构，是寻路算法的基础输入。
• orca-collision-avoidance — ORCA 碰撞规避：多代理局部碰撞规避算法，通过 dodgy crate 实现。

Comparisons

• ecs-event-state-timing — 跨框架 ECS 事件与状态生命周期时序对比：Bevy vs Flecs vs Unity DOTS vs Entitas vs Godot。

• agent-frameworks-cn-im — Tracks open-source agent systems for China enterprise IM assistant scenarios: Feishu/Lark, WeCom, DingTalk, skills, and scheduler support.

• arpg-2d-vs-3d-design — ARPG 2D/2.5D（等距视角）与 3D（第三人称视角）设计差异对比：摄像机、战斗、视觉、关卡、UI、成本、玩家心理、Bevy 决策框架。

• arpg-character-systems — ARPG 角色系统设计深度对比：Last Epoch / PoE2 / D4 / Grim Dawn 四款游戏职业、被动、技能、洗点、ECS 实现启示。

• arpg-damage-formulas — 六款主流 ARPG（D2/D4/PoE/原神/ER/Lost Ark）攻击端伤害公式深度对比：乘法堆叠策略、横向对比表、设计启示。

• arpg-defense-formulas — 六款主流 ARPG 防御端公式对比：防御模型分类、物理减伤机制、设计哲学。

• arpg-equipment-design — ARPG 装备系统设计对比：掉落 vs 打造、词缀复杂度、装备持久性、Build 赋能、稀有度意义，主流游戏 systemic trade-offs。

• arpg-multiplicative-stacking — ARPG 乘法堆叠策略对比：递减 vs 恒定、D4 桶系统、PoE increased/more、原神均衡原则。

• arpg-skill-systems-comparison — ARPG 技能系统设计对比 Part 1：PoE2 / D4 (LoH) / Last Epoch 自由度与上手难度权衡。

• arpg-skill-systems-comparison-part2 — ARPG 技能系统设计对比 Part 2：Grim Dawn / Lost Ark / Wolcen / Titan Quest / Victor Vran / Chronicon / Slormancer / Undecember 扩展对比。

• arpg-success-cases — ARPG 成功案例深度剖析：PoE2 / Hades / 黑神话 / Last Epoch 四案例对比，战斗、Build、叙事、商业、市场成绩五维度。

• bevy-image-filtering-nearest-vs-linear — Bevy ImagePlugin 的 default_nearest() 与 default_linear() 对比：API 差异、采样模式、使用场景。

• bevy-navigation-solutions — Bevy 导航方案对比：be vy_landmass / bevy_flowfield_tiles_plugin / bevy_northstar 三大方案选型。

• billboard-cross-engine — Unity/Unreal/Godot/Babylon.js/three.js/bevy 六引擎 billboard 功能矩阵对比：朝向模式、辅助功能、Bevy 缺失清单。

• hover-highlighting-comparison — 游戏物体高亮技术深度对比：6 维度评价 5 种常用高亮技术。

• voxel-rendering-pipelines — 体素渲染双路线对比：表面网格化（Meshing）vs 直接体渲染（Volume Rendering），维度、案例、Bevy 选型。

• terminal-emulators — macOS 终端模拟器选型对比：iTerm2 / Ghostty / Warp 三选一决策树。

Queries

System

• skill-registry — 全局技能分配清单，记录哪个 Profile 绑定哪些技能，以及高风险技能限制。
• memory-routing — 防污染规则表：什么信息应该写到哪里（Hermes memory / supermemory / wiki / projects / sessions）
• dashboard — 总控面板：Profile 状态、项目进展、Cron 任务、待办事项一览
• user-profile — 统一用户画像：ZoOL 的基本信息、技术环境、沟通风格、写作规范、家庭生活
• agent-log — 全局行为日志：所有 Profile 跨项目的动作记录
• weekly-review — 周期复盘：每周将行动转化为策略，总结完成、卡点、经验、调整

Projects

• bevy-blog — ZoOL 的 Bevy 游戏引擎中文技术博客项目（44+ 篇已发布）。

• context — 项目背景与范围。

• AGENTS — 角色分配与写作边界。

• tasks — 任务池：进行中 / 待办 / 已完成。

• decisions — 关键决策。

• log — 项目级进度日志。

• bevy-0-19-release-brief — 0.19 版本发布简报草稿。

• bevy-0-19-release-draft — 0.19 版本发布文章草稿。

• README — 项目输出物清单。

• bsn-spawn-button-20-to-5 — 归档 | Bevy BSN：spawn 按钮从 20 行到 5 行。

• sidedawn — SideDawn 产品实体；开发日志入口。

• context — 项目背景与范围。

• AGENTS — 谁写日志、写到哪。

• tasks — 任务池：进行中 / 待办 / 已完成。

• decisions — 已定决策。

• log — 项目级开发日志。

• research-skills-terrain — 技能 vs 地形研究笔记（FM-SD-RESEARCH-1，非决策）。

• research-mosaic-ingest — mosaic 研究入库索引（FM-SD-WIKI-MOSAIC-1，非决策）。

• research-arpg-mapgen-practices — ARPG 地图生成最佳实践（FM-SD-WIKI-MAPGEN-BP-20260828，非决策）。

Pages

• coordination-methods — 多 Profile 协作方法论：OPC 四角色模型、三阶段流程、切换规则
• research-methods — 研究方法论：五步研究法、来源策略、质量控制
• writing-methods — 写作方法论：四步写作法、ZoOL 风格摘要
• building-methods — 构建方法论：四步构建法、项目约定读取顺序
• wikilinks — Wiki 核心链接语法 [[page-name]] 的规范与使用规则。