mc-fix-todo

name	mc-fix-todo
description	认领并收敛项目代码中的一个TODO

任务简介

认领并收敛项目代码中的一个TODO。若用户已经指定了todo，则做用户的。

任务详细流程

1. 注意：项目中的todo大部分都很容易处理，其所依赖的子系统已经相当完善.
2. 认领其中一个你认为相对容易解决的todo。若用户已经指定了todo，则做用户的。
3. 选定了一个todo之后，请你先阅读相关readme文件，以初步了解内容和范围，然后启动七个子代理，彻查该todo涉及到的代码。这七个子代理中，需要有3~5个左右专门负责探索项目中已有的对应基建，以实现完美的、最高程度的复用。不要限制子代理的输出字数，让它们尽可能详细地输出它们的探索结果。
4. 收敛的过程可能会非常复杂，可能需要你深入理解相关代码、探索并复用已有基建、设计并输出一份合理的实现方案（但不要进入计划模式）、编写大量代码、编写测试用例、修复编译错误和测试失败等。你需要充分利用你的编程能力和项目理解能力来完成这个任务。不允许简单删除这个todo或者留下一个不完整的实现来应付了事，必须要完整地收敛它，确保相关功能完全实现、没有遗漏、没有使用简化实现、没有临时占位符、没有未集成的孤岛代码等。
5. 最后，生成简体中文提交信息并提交代码，然后推送到远程仓库。注意：可能有人在和你并行工作，你可能需要处理潜在的合并冲突。
6. 如果拉取/推送代码的时候因为网络问题没有成功，那么你无需重试，将该提交留在本地后即可停下来了，以后我会帮你去做。另外，/include/minecraft-reborn/version.h这个文件如果git显示未提交，你不用理会，将其留在工作区即可，重点是处理其他文件。

你需要随时留意：

1. 尽可能准确复刻D:\Minecraft\MC研究\Minecraft1.16.5源码\net\minecraft下的算法、逻辑、时序等，与原版任何一点点偏差都会导致偏离预期。但不要照搬，因为cpp和java的特性不同，项目的架构也不同，你需要根据cpp的特性和当前项目的架构进行合理的架构设计和调整。
2. 是否完整，没有遗漏类、文件、函数、数据、结构、逻辑分支等
3. 是否闭环、是否完整集成到游戏逻辑当中，没有形成无法被调用的“孤岛代码”

注意本项目基建已经相当完善（代码量已经60w行），各种常数、常用工具函数、音频系统、粒子系统、资源包系统、命令系统、实体系统、物品系统、物理系统、碰撞、tick调度等都已经有了相当完善的实现（存档系统除外，目前未实现存档系统）(另外world对象上面也挂了相当多的工具方法以便访问世界、操作世界等)，务必充分探索以实现复用，避免重复实现，或者以未实现为理由留下TODO。

善用README

几乎每个目录下都有一个简体中文编写的 README.md，它很重要，在你探索项目实现的时候，提前看看它，能节省不少多余的文件查找与查看，节省不少上下文开销。

【重要】为了节省上下文，请你尽量阅读各级目录的 README.md 来获取你需要的信息，而不是直接查看代码文件。

例如：当你修改想修改或查看src\common\world\chunk\ChunkLoadTicketManager.cpp，你必须提前依次查看目录链上的各级目录上的readme文件：

• 项目根目录的 README.md
• src\common\README.md
• src\common\world\README.md
• src\common\world\chunk\README.md

请你不仅自己要严格遵照上述要求，而且在给子代理的prompt中也要要求它们先查看相关目录链上的README.md来获取信息，而不是直接查看代码文件。

实现要求

1. 阻塞等待所有子代理完成（禁止子代理在后台运行）。所有子代理完成之后，请你总结出一个详细的TODO收敛行动指南，并且给出详细的逐步收敛建议。然后不要停下来，而是继续立即开始一步步执行！
2. 你时间充足、上下文也充足，先把所有任务代码一口气写完，最后再编译
3. 请你使用cmake --build --preset windows-clang-relwithdebinfo进行编译
4. 务必尽可能复用项目中已有的基建！
5. 在任务执行过程中，你可以随时派出子代理来帮你完成一些子任务，比如说探索项目中已有的对应基建、探索项目中需要依赖的某个子系统是否存在、甚至帮你编写代码！

关于代码

【重要】必须参考下面mc源码！ windows环境源码位于 D:\Minecraft\MC研究\Minecraft1.16.5源码 macos环境源码位于 ~/MC_Dev/Minecraft1.16.5源码

1. 必须优雅、考虑到未来拓展、结构清晰美观整洁、架构强大，必须参考mc源码（主要是为了学习mc真实游戏逻辑而非架构。mc的架构水平和代码质量并不高！），但不要照搬，必须根据cpp的特性和当前项目的架构进行合理的架构设计和调整。
2. 当前项目是一个复刻项目，目标是完全使用cpp尽可能一致地复刻java版mc的游戏体验，并在存档、数据包等层面上尽可能兼容和复用现有java版minecraft生态。务必要有清晰、优雅、能让人赏心悦目的目录结构，不要把很多文件全部堆在一个目录下，要划分好细分的子目录。
3. 你需要先阅读readme文件了解怎么构建项目
4. 需要断言+单测来保证代码质量；每个方法前都要附上doc注释说明方法的用法和注意事项（容易踩坑的地方）
5. 务必要有清晰、优雅、能让人赏心悦目的目录结构，不要把很多文件全部堆在一个目录下，要划分好细分的子目录！
6. 编译过程中遇到的warning你也要一并解决
7. 需要使用命名空间隔离各个子系统的标识符。下面是最佳实践：

namespace mr {
namespace entity {
namespace attribute {

/**
 * @brief 属性修改器操作类型
 *
 * 定义属性修改器如何影响基础值
 */
enum class Operation : u8 {
    // ...
}}}}

提交代码之前，必须使用clang-format对你修改的文件进行格式化：

clang-format -i src\common\xxx\Foo.cpp
clang-format -i src\common\xxx\Foo.hpp