🌀 EReality?

A Windows Reality Check Tool for Lucid Dreamers, Built with Python. (开发者: Ex.Electron)

Important

💡 AI 提示 / AI Generation Notice
本项目的核心架构、代码重构、安全校验流程与 GUI 均由 Codex + GPT-5.6 协同生成；人类作者负责创意把控、需求定义、技术 Review 与最终决策。
本项目仍应被视为一个由人类维护的开源项目：任何安全相关用途都建议先进行独立审计与充分测试。

功能

• 随机间隔触发、免打扰时段、全屏应用自动避让
• Windows 任务栏时钟精确定位，失败时自动降级到右下角
• 纯色或自定义图片遮挡、透明度和坐标微调
• 系统提示音、TTS、本地音频文件
• 四步现实检验：两次时间、常识单选、3 字记忆回答与强制等待
• OpenAI 兼容 API 动态出题、后台预加载、连接测试与离线题库降级
• 两次短回答支持本地完全一致或可调阈值的 AI 语义近似度判定
• 自动保存详细日志、按大小轮转备份，并可在设置页查看最近日志
• 梦境警报、自定义全部提示文字
• 托盘菜单信息与快捷操作定制、每日成功次数统计
• 配置自动保存到 %APPDATA%\RealityCheckTool\config.json

安装与运行

需要 Windows 10/11 和 Python 3.10+：

py -3.10 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e .
reality-check

也可以运行：

python -m reality_check

程序启动后默认只显示在系统托盘。双击或单击托盘图标可打开设置。

测试

核心时间与配置逻辑只依赖 Python 标准库：

python -m unittest discover -s tests -v

目录

src/reality_check/
  config.py            配置与统计持久化
  time_utils.py        时间解析及跨午夜比较
  windows_api.py       WinAPI 时钟定位与全屏检测
  trigger_engine.py    随机触发、免打扰与延迟
  overlay.py           任务栏时钟遮挡窗口
  verification.py      验证状态机与梦境警报
  questions.py         题目数据校验与本地预设题库
  llm_client.py        OpenAI 兼容 API 与 QThread 异步请求
  logging_utils.py     自动日志、文件轮转与未捕获异常记录
  settings_window.py   设置界面
  audio.py             提示音/TTS/本地音频
  tray_app.py          托盘菜单及应用协调

许可证

本项目采用 MIT License 开源。