feat: initial commit - Dota 2 egui overlay with GSI, OpenDota API, SQLite cache and recommendation engine

Made-with: Cursor

README.md

@@ -0,0 +1,92 @@
+# Dota 2 助手 (Dota 2 Assistant)
+
+Windows 上的 Dota 2 英雄选择与出装推荐 Overlay 应用。实时读取游戏状态，在 BP 阶段提供英雄克制推荐，游戏中提供出装建议。
+
+## 功能
+
+- **选将阶段 (BP)**: 根据对方已选英雄，通过 OpenDota 数据推荐克制英雄
+- **游戏中**: 根据当前英雄推荐各阶段最优出装路线
+- **游戏内 Overlay**: 透明悬浮窗叠加在 Dota 2 之上，支持鼠标穿透
+- **本地缓存**: 英雄/物品数据缓存 24 小时，减少 API 请求
+
+## 安装
+
+### 依赖
+
+- Windows 10/11
+- Dota 2 (Steam)
+- Visual Studio C++ 构建工具 (用于编译)
+
+### 编译
+
+```powershell
+# 安装 Rust (如果未安装)
+winget install Rustlang.Rustup
+
+# 克隆并编译
+git clone <repo>
+cd dota2-assistant
+cargo build --release
+```
+
+### 配置 Dota 2 GSI
+
+运行安装脚本 (需要知道 Dota 2 安装路径):
+
+```powershell
+.\install_gsi.ps1
+# 或指定自定义路径:
+.\install_gsi.ps1 -DotaPath "D:\Steam\steamapps\common\dota 2 beta"
+```
+
+### 手动配置
+
+1. 将 `config\gamestate_integration_assistant.cfg` 复制到:
+   ```
+   <Steam>\steamapps\common\dota 2 beta\game\dota\cfg\gamestate_integration\
+   ```
+
+2. 在 Steam 中给 Dota 2 添加启动参数: `-gamestateintegration`
+
+3. 将 Dota 2 设置为**无边框窗口 (Borderless Window)** 模式
+
+## 使用
+
+1. 先启动 `dota2-assistant.exe`
+2. 再启动 Dota 2
+3. 进入游戏后 Overlay 会自动出现
+4. 按 **F12** 切换显示/隐藏
+
+## 架构
+
+```
+Dota 2 Game (GSI)
+    │ HTTP POST (每 0.5 秒)
+    ▼
+GSI HTTP Server (axum, :3000)
+    │
+    ▼
+State Manager (Arc<Mutex<AppState>>)
+    │
+    ├──► 推荐引擎 ──► OpenDota API ──► SQLite 缓存
+    │
+    └──► egui Overlay UI (主线程, GLFW 透明窗口)
+```
+
+## 注意事项
+
+- **VAC 安全**: 仅使用 GSI 官方接口 + 透明窗口技术，不涉及内存读取或 DLL 注入
+- **GSI 限制**: 只能获取玩家自己可见的信息（不能读取对方未展示的选择）
+- **网络依赖**: 首次运行需联网拉取英雄数据，之后可离线使用缓存
+
+## 技术栈
+
+| 组件 | 技术 |
+|------|------|
+| 语言 | Rust |
+| 异步运行时 | tokio |
+| Overlay UI | egui_overlay 0.9 (GLFW + egui 0.29) |
+| GSI 服务器 | axum 0.7 |
+| API 客户端 | reqwest 0.12 |
+| 本地缓存 | rusqlite (SQLite, bundled) |
+| 数据源 | OpenDota API (免费) |