用途：优化 ace_engine 中 C++ 头文件的编译效率，通过系统性减少依赖与重构实现，降低编译时间和内存占用。
主要能力：将头文件中超过 3 行的内联实现移至 cpp；删除未使用的 #include；把仅需类型名的包含改为前向声明（含 RefPtr/WeakPtr、跨命名空间等场景）；按需拆分常量/枚举头文件；在适用时引入 PIMPL；对模板方法使用显式实例化；用 compile-analysis 做单文件独立编译验证；统计优化前后指标。
使用方式：输入头文件（.h）则直接优化；输入 test_header.cpp 则从中提取头文件再优化。用户可指定“只分析不进行修改”，此时仅分析并给出建议，不改文件。test_header.cpp 只读，不得修改。
限制：只改结构不改业务逻辑；尽量直接编辑现有头/源文件，仅在拆分头文件时新建文件；不扩大修改范围；不做完整构建，只用 compile-analysis 做独立编译验证；PIMPL 有运行时开销，仅在编译收益足够时使用；模板显式实例化仅适用于参数类型已知且有限的情况。