Crosshair Overlay 是一款 Windows 桌面准心叠加工具，专为 FPS 游戏设计。支持三种叠加引擎，覆盖所有游戏模式。
- Simple Overlay — 窗口化/无边框全屏下显示准心，
Alt+X一键切换 - Real Overlay（管理员） — FSO 独占全屏下显示准心，使用管理员权限覆盖游戏窗口
- Game Bar Widget — 基于 Xbox Game Bar 的准心组件，支持真正的独占全屏（包括 Vulkan 游戏）
- Widget 准心自动居中 — 基于 WindowBounds API + DisplayInformation，自动适应所有分辨率/比例/DPI
- Widget 设置同步 — 桌面端修改样式后 2 秒内自动同步到 Widget
- Widget 显示/隐藏同步 —
Alt+X切换准心可见性自动同步到 Widget - 6 种准心样式 — 十字、圆点、十字+圆点、圆环、圆环+圆点、实心轮廓
- 完全自定义 — 颜色、粗细、长度、间距、透明度、轮廓描边
- 全局快捷键 —
Alt+X显示/隐藏准心，`Alt+`` 打开设置 - 系统托盘 — 最小化到托盘运行，右键菜单快速切换
- 配置持久化 — 设置自动保存到
%APPDATA%\CrosshairOverlay\settings.json - DWM 异常保护 — 重启后桌面合成器未就绪时不再崩溃
1. 下载 zip → 解压
2. 双击 setup.bat → 完成安装
3. 按 Alt+X 显示准心
4. 进游戏设置为「窗口化全屏（无边框）」模式
1. 双击 setup.bat → 自动安装证书和 Widget
2. 按 Win+G 打开 Xbox Game Bar
3. 在 Widget 菜单中选择「准心叠加层」
4. 固定 📌 → 关闭 Game Bar 后准心仍可见
5. 点击 Home Bar 上的鼠标图标 → 启用「点击穿透」
6. 桌面端改设置 → Widget 实时同步
⚠️ 重要：固定后必须启用点击穿透，否则 Widget 窗口会拦截鼠标操作，导致桌面对应区域无法点击。启用后所有鼠标事件将穿透 Widget 直达底层游戏/桌面。
当前发布包由独立 WPF 桌面端和独立 Widget MSIX 组成，文件同步是跨进程配置同步的可靠回退通道。组合 MSIX 额外启用 AppService 即时同步，但文件通道仍会保留。
- GitHub: v1.1.0 Release（83 MB）
- Gitee（国内加速）: v1.1.0 Release
| 快捷键 | 功能 |
|---|---|
Alt + X |
显示/隐藏准心 |
Alt + `` |
打开设置窗口 |
Win + G |
打开 Xbox Game Bar (Widget) |
| 游戏 | Simple Overlay | Real Overlay | Game Bar Widget |
|---|---|---|---|
| 无畏契约 (Valorant) | ✅ 窗口化全屏 | ✅ 独占全屏 | ✅ |
| CS2 | ✅ 窗口化全屏 | ✅ 独占全屏 | ✅ |
| 三角洲行动 | ✅ 窗口化全屏 | ✅ 独占全屏 | ✅ |
| Simple Overlay | Real Overlay | Game Bar Widget | |
|---|---|---|---|
| 管理员权限 | 不需要 | 需要 | 不需要 |
| 窗口化全屏 | ✅ | ✅ | ✅ |
| FSO 独占全屏 | ❌ | ✅ | ✅ |
| 真正独占全屏 | ❌ | ❌ | ✅ |
| Vulkan | ✅ | ❌ | ✅ |
| 反作弊 | ✅ 安全 | ✅ 安全 | ✅ 最安全 |
CrosshairOverlay/
├── CrosshairOverlay/ # WPF 桌面应用
│ ├── App.xaml.cs # 应用入口 + 热键 + 托盘
│ ├── MainWindow.xaml # 设置窗口
│ ├── Rendering/
│ │ ├── OverlayHost.cs # 叠加窗口引擎
│ │ └── CrosshairRenderer.cs # SkiaSharp 准心渲染
│ ├── Services/
│ │ ├── AppServiceServer.cs # MSIX 包内 IPC
│ │ ├── SettingsService.cs # JSON 配置持久化
│ │ └── StartupService.cs # 开机自启
│ └── ViewModels/
│ └── MainViewModel.cs # MVVM ViewModel
│
├── CrosshairOverlay.Widget/ # UWP Game Bar Widget
│ ├── CrosshairPage.xaml.cs # 准心渲染 (UWP Shapes)
│ ├── Services/
│ │ └── AppServiceClient.cs # IPC 客户端
│ └── Package.appxmanifest # Game Bar 扩展声明
| 组件 | 技术 |
|---|---|
| 桌面应用 | C# / .NET 8 / WPF / SkiaSharp |
| Game Bar Widget | C# / UWP / .NET Native |
| 跨进程通信 | AppServiceConnection (WinRT IPC) + 文件同步 fallback |
| 窗口叠加 | Win32 API / UpdateLayeredWindow |
| 配置持久化 | System.Text.Json |
| 打包 | MSIX / Desktop Bridge |
# 桌面应用
dotnet build CrosshairOverlay
# 测试
dotnet test CrosshairOverlay.Tests
# Game Bar Widget（需要 VS 2019+ + UWP 工作负荷）
& "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin\MSBuild.exe" CrosshairOverlay.Widget\CrosshairOverlay.Widget.csproj /p:Configuration=Release /p:Platform=x64
# 发布（自包含）
dotnet publish CrosshairOverlay -c Release -r win-x64 --self-contained trueMIT