rougeGame/Docs/Production/ProjectConventions.md

文件与资源规范

• gameFramework/：可独立构建的 C++20 规则、V1 编解码、原生测试和固定第三方 JSON 头文件；不出现 UE 构建文件、反射宏或类型。
• Source/GameFrameworkExternal/：链接先由 CMake 生成的核心静态库，统一 Win64 / VS2022 / Release /MD / C++20 ABI。
• Source/UEAdapter/：宿主生命周期、原子文件存储、GUID、偏好与本地化转换。
• 运行性能采集使用 Source/UEAdapter/ 的 IronsPerformanceSubsystem；面板、视口安全区域和 UI 命中变换使用 Source/ueRouge/ 的 IronsPerformanceOverlay。运行诊断和用户偏好不写入 gameFramework 的进度数据；验收记录在 Docs/QA/PerformanceOverlay/。
• Source/ueRouge/：Actor、摄像机、Enhanced Input、物理事实、UMG 和表现。
• Source/IronsEditor/：仅编辑器使用的 MCP 原生工具与 UE 自动测试。
• Content/IRONSPORE/：地图、蓝图、UMG、导入模型/材质、纹理和声音；Raw/ 中的运行时字体、本地化 JSON 和必要许可作为 NonUFS 随包分发。
• SourceAssets/Blender/：可编辑 Blender 源。SourceAssets/Exports/Unity/ 保留本次迁移使用的 FBX 原件，目录名表示来源。建模修改和重新导出使用 Blender MCP。
• SourceAssets/UI/：SVG 原件；SourceAssets/Derived/UI/：确定性 PNG 派生。导入、移动、重命名 UE 资产通过引擎工具维护引用。
• SourceAssets/ThirdParty/<发行方>/<资源包>/：许可明确的原件与归档。作者、版本/日期、来源、SHA-256 登记在素材台账及 JSON 记录中，许可存入 Docs/Production/Licenses/。
• Tools/Framework/ 与 Tools/Unreal/：构建、MCP、派生和验收入口；Docs/QA/ 只保存实际验证及整理后的证据。
• Builds/、Saved/、Intermediate/、Binaries/、缓存、凭据和本地工作副本不提交。正式进度与 QA 进度隔离，文件操作须限定本工程完整路径。

存档 V1 约束、独立 MCP 会话、长时间性能测试安排和调试收尾遵循项目根目录 AGENTS.md。