OOPS

One-click Operating Pre-check System
一键运行预检系统

| | | |

让游戏脚本运行更顺畅
Run Your Game Scripts Smoothly

一键检测，运行前发现问题 | One-click check, find issues before running

---

📦 下载地址

• GitHub: https://github.com/idk500/OOPS/releases （国际用户推荐）
• Gitee: https://gitee.com/idk500/OOPS/releases （国内用户推荐，速度更快）

---

🚀 快速开始

方式1: 下载可执行文件（推荐）

1. 下载 - 从 GitHub Releases 或 Gitee Releases 下载 oops-windows-x64.zip
2. 运行 - 将oops-windows-x64.zip扔到项目根目录, 例如你的项目根目录是E:\\Z1D,则 放到 E:\\Z1D\下, 最后双击 E:\\Z1D\oops-windows-x64\oops.exe
3. 选择项目 - 选择要检测的游戏脚本项目, 当前无需选择.
4. 查看报告 - 自动生成HTML报告并在浏览器中打开

方式2: 使用Python运行

# 安装依赖
pip install -r requirements.txt

# 运行检测
python oops.py

---

✨ 主要功能

🔍 全面检测

• 系统信息 - CPU、内存、磁盘、GPU、显示设置
• 硬件适配 - 内存、磁盘类型、用户名、分辨率验证
• 网络连通性 - Git仓库、PyPI源、镜像站点
• 环境依赖 - Python版本、虚拟环境、系统库
• 路径规范 - 中文路径、特殊字符、权限检查
• 🆕 项目版本 - 本地/远程版本比对、启动器版本检测、自动更新建议
• 🆕 游戏设置 - 游戏配置文件检测、启动项验证

📊 智能报告

• HTML格式 - 美观的可视化报告
• 中文界面 - 所有检测项中文显示
• 问题分级 - 错误、警告、信息分类
• 修复建议 - 针对性的解决方案

🎯 特色检测

• HDR检测 - Windows HDR状态检测
• 分辨率验证 - 检查是否满足1920x1080最低要求
• 夜间模式检测 - 护眼模式/颜色滤镜检测
• 磁盘类型 - HDD/SSD识别，建议使用SSD

---

📖 文档导航

用户文档

• 🚀 快速开始 - 一分钟上手指南
• 📖 用户指南 - 详细使用说明（推荐新手阅读）
• ⚙️ 命令行手册 - 命令行参数和高级用法
• 📝 更新日志 - 版本更新历史

开发者文档

• 🔧 开发者指南 - 如何参与开发
• 📋 发布指南 - 版本发布流程
• 🤖 CI/CD 文档 - 自动化构建说明
• 📚 文档索引 - 完整文档列表

---

🎮 支持的项目

目前支持以下游戏脚本项目：

项目	配置文件	状态
绝区零自动化脚本	zenless_zone_zero.yaml	✅ 已支持
更多项目	敬请期待	🚧 开发中

---

💡 常见问题

Q: 检测需要多长时间？

A: 通常3-5秒完成所有检测。

Q: 需要联网吗？

A: 网络检测需要联网，其他检测可离线进行。

Q: 支持哪些操作系统？

A: 主要支持Windows，Linux和macOS部分功能可用。

Q: 检测会修改我的系统吗？

A: 不会。OOPS只进行检测，不会修改任何系统设置。后续也许会增加修复器，在用户监视下协助修复。

Q: Why OOPS?

A: OOPS 基于三个目的 开发

1. 探索 解决人类的本质是复读机的方法.
   1. 不基于口头传递, 而是通过机制保证的开源社区生态.
   2. 减轻开发者支持社区时需要反复面对基本问题的负担.
2. 探索 基于Agent 开发能力 和 传统SWE 结合的AI-SWE.
3. 我乐意.

---

🤝 参与贡献

欢迎贡献代码、文档或提出建议！

• 🐛 报告问题：GitHub Issues
• 💡 功能建议：GitHub Discussions
• 🔧 贡献代码：查看 开发者指南

---

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

---

🙏 致谢

感谢所有为开源项目提供问题反馈和解决方案的社区成员！

---

OOPS - 让游戏脚本运行更顺畅！
OOPS - Run Your Game Scripts Smoothly!