🎮 启原引擎 - Qiyuan Engine

—— 重新定义“启动”！

你是否也曾在深夜的游戏中，因为一个闪光弹或一个全屏技能而眼前一白？你是否觉得这瞬间的白，充满了神圣的仪式感，仿佛在预示着什么？

别怀疑，这就是启动的征兆！

启原引擎，一个致力于捕捉并升华这些“神圣时刻”的跨时代桌面工具。它潜伏在你的系统后台，默默等待那个天选时刻的降临，然后——启动！

✨ 遥遥领先的功能

• 🖥️ 智能屏幕感知: 7x24小时赛博待命，实时监测屏幕颜色占比，精准捕捉触发时机。
• 🎬 万物皆可启动: 不仅仅是“原神”，通过修改配置，你可以让它启动任何你想要的视频和音频，万物皆可“启原”！
• 🎨 全自定义配置: 从触发颜色、容差、屏幕占比，到冷却时间、扫描间隔，一切尽在掌握。你的启动，你做主！
• 🖼️ 现代化图形界面: 自带 CustomTkinter 打造的控制台，让你告别命令行，优雅地调整每一个参数。
• 📦 开箱即用: 提供基于 PyInstaller 的打包版本，没有 Python 环境的朋友也能即刻开玩，感受这份电子功德。
• 🚀 自动化发布: 集成 GitHub Actions，每次版本更新，自动打包发布，功德++。

📸 界面截图

  

🚀 食用方法

🎊 对于普通玩家

1. 前往本项目的 Releases 页面。
2. 下载最新版本的 QiyuanEngine-vX.X.X-Windows.zip 压缩包。
3. 解压后，双击 启原引擎.exe 即可开始！
4. 在图形界面的“设置”选项卡中，调整为你喜欢的参数，然后点击“保存配置”。
5. 回到“控制”选项卡，点击“启动引擎”，开始你的赛博仪式！

🛠️ 配置项说明

配置项	UI 控件	说明
video_path	视频文件	触发时播放的视频文件路径。
audio_path	音频文件	触发时播放的音频文件路径。
play_audio	播放音频	是否播放音频的开关。
interval_seconds	扫描间隔	每隔多少秒扫描一次屏幕。值越小越灵敏，但 CPU 占用会略高。
cooldown_seconds	冷却时间	成功触发一次后，进入“贤者时间”，防止连续触发。
color_rgb	触发颜色	你希望监测的屏幕主色调。
color_tolerance	颜色容差	对目标颜色的匹配宽松度。值越高，越容易匹配到相近的颜色。
threshold_percent	触发阈值	目标颜色在屏幕上的占比达到多少时，才算成功触发。

💻 给开发者

想要亲自为这份电子功德添砖加瓦？没问题！

1. 克隆仓库

   git clone https://github.com/Jerry-FaGe/qiyuan-engine.git
   cd qiyuan-engine

2. 创建并同步环境 (我们使用 uv 进行管理)

   # 创建虚拟环境
   uv venv
   
   # 安装所有依赖，包括开发依赖
   uv sync --dev

3. 运行！

   # 运行 GUI 版本
   uv run run_gui.py
   
   # 或者，如果你是命令行爱好者
   uv run run_cli.py

4. 打包你自己的版本

   uv run pyinstaller QiyuanEngine.spec

   打包好的文件会出现在 dist 文件夹中。

📜 许可

本项目采用 GPL-3.0 License 授权。