From ab3181c1a5932944e9fa8538339b5ecd09fc2379 Mon Sep 17 00:00:00 2001
From: shuiyu1123 <shuiyu1123@163.com>
Date: Fri, 10 Jul 2026 19:33:30 +0800
Subject: [PATCH] add README.md

---
 README.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5a561e9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# lity3d
+
+x86-64 MASM 汇编 + C 混合架构游戏引擎，目标平台 Windows。
+
+## 架构
+
+- **热路径**（数学、内存、字符串、性能分析）：MASM 汇编，SSE/AVX2 优化
+- **外围系统**（窗口、渲染、ECS、音频、UI、脚本）：C17
+
+## 模块
+
+| 目录 | 说明 |
+|------|------|
+| `Engine/ASM/` | 汇编核心：向量/矩阵运算、内存管理、字符串操作、性能计数器 |
+| `Engine/Core/` | 引擎生命周期、日志、计时器 |
+| `Engine/Rendering/` | DirectX 11 渲染：设备管理、着色器、网格、纹理、摄像机 |
+| `Engine/ECS/` | 实体-组件-系统框架 |
+| `Engine/Physics/` | 碰撞检测、刚体 |
+| `Engine/Audio/` | XAudio2 音频 |
+| `Engine/Editor/` | 自研编辑器、UILayer、位图字体、字形图集（中文渲染） |
+| `Engine/VisualScript/` | 积木式可视化编程系统 |
+| `Demo/` | 示例程序 |
+
+## 构建
+
+需要 MinGW-w64 (GCC 13+) 和 CMake。
+
+```bash
+cd GameEngineASM
+mkdir build && cd build
+cmake .. -G "MinGW Makefiles"
+cmake --build .
+```
+
+## 依赖
+
+D3D11、DXGI、D3DCompiler、GDI32、XAudio2 — 均为 Windows SDK 自带，无第三方库。