🎯 Crosshair Overlay（准星覆盖工具）

📄 English 📄 中文

Windows 全局准星工具，支持高度自定义参数和热键操作，提供 GUI 编辑器模式和轻量级覆盖模式。

⚠ 免责声明

本工具会覆盖屏幕显示内容，存在反作弊风险。继续使用即表示您知悉风险并自行承担后果，作者不对任何后果负责。

---

✨ 主要功能

• 🎨 准星编辑器：可视化调节间距、线长、线粗、透明度等 20+ 参数，欢迎在 issue 中提出更多参数需求。
• 🌈 样式定制：支持实线、虚线、点线，内侧、外侧、多射线布局等个性化设置。
• 📥 配置管理：支持导入、导出准星代码，并可保存历史记录、删除或设为默认。
• 🖥️ 全局覆盖：无边框全屏显示，支持透明穿透点击和热键操作。
• ⚙ 双模式运行：
  • 带 GUI 编辑器模式（适用于自定义准星）。
  • 无界面准星覆盖模式（--nogui），更轻量级运行。

---

📌 安装

git clone https://github.com/LiebeV/Crosshair-Overlay.git
cd Crosshair-Overlay
pip install -r requirements.txt

建议使用 Python 3.8+ 运行，程序已优化 Windows 兼容性。

---

🚀 快速开始

1️⃣ 编辑器模式（推荐首次使用）

python crosshair.py

• 该模式允许自定义准星，并导出代码或设为默认，以便在覆盖模式中使用。

2️⃣ 准星覆盖模式（无 GUI 直接运行）

python crosshair.py --nogui <config_str>

• 适用于快速加载预设准星，无需额外界面。

---

⚙ 参数说明

参数	说明
--nogui	以无界面模式运行准星覆盖
config_str	准星代码（在编辑器模式中预设默认值或手动输入）

🎮 热键操作

• Ctrl + Alt + F9：退出程序
• Ctrl + Alt + F10：切换显示 / 隐藏

---

📜 许可证

本工具采用 LGPL-3.0（PySide6）+ MIT（keyboard） 开源许可协议。

---

❓ FAQ（常见问题）

🔹 为什么需要 Python？是否会提供 EXE？

目前工具仍在开发阶段，后续会发布 EXE 版，目前仅提供源码版本。

🔹 只能通过命令行参数启动准星覆盖吗？

是的，这样可以通过 Win + R 快速启动，适用于大多数场景。

🔹 运行 .py 文件时会有命令行窗口吗？

目前会有命令行窗口，后续 EXE 版本会解决该问题。

🔹 是否会支持其他操作系统？

本工具 仅针对 Windows 进行开发，不计划适配其他平台。

---

💡 提示：如果你有更多功能需求或发现 Bug，欢迎提交 issue！