guettaf-hossam/superdiagnostictoolAI 驱动的 Windows 诊断与自动修复工具，基于 Google Gemini。可检测崩溃、优化性能、扫描恶意软件，并生成 PowerShell 修复脚本。支持通用硬件（1-128+ 核心）。免费且开源。
AI 驱动的 Windows 诊断与修复工具
SuperDiagnosticTool 采集实时硬件遥测数据，将其发送至 Google Gemini API 进行分析，并生成 PowerShell 修复脚本以解决检测到的问题。它包含多层验证机制，生成的脚本必须通过这些验证，才会提示用户执行。
主界面，显示扫描模式选择与问题描述输入
Gemini 生成的脚本在提示用户批准执行前，需依次通过四项检查：
ScriptValidator）： 三级检查——黑名单（对破坏性模式硬性拦截）、可疑模式检测（可识别别名与混淆）、以及 0-100 分制的风险评分CriticalPathInterceptor）： 零信任关卡，任何触及 HKLM/HKCU 注册表键或 System32 路径的脚本都会被暂停，直到用户明确确认%TEMP%\superdiagnostic_execution_*.log$env: 变量且不会产生语法错误subprocess.run 运行，设有 5 分钟硬性超时、完整捕获 stdout/stderr，并自动清理临时文件。这是直接在主机层面执行，而非虚拟机或容器隔离。上述验证层是主要的安全边界。[FIXED]、[CLEANED]、[DISABLED] 标签来反映已完成的动作AI_Reports/ 以便历史追踪下载 SuperDiagnosticTool.exe — 独立可执行文件（无需 Python）
该可执行文件未签名。首次运行时 Windows SmartScreen 会显示警告。请参阅 TRUST_GUIDE.md 了解如何继续。如果你希望在运行前进行验证，请改为从源代码构建。
SuperDiagnosticTool.exe创建一个虚拟环境，使该工具的依赖与其他 Python 项目保持隔离：
python -m venv .venv
在 Windows 命令提示符中激活它，然后安装仓库列出的依赖项：
.venv\Scripts\activate
pip install -r requirements.txt
在 PowerShell 中，使用以下命令激活环境：
.\.venv\Scripts\Activate.ps1
如果 PowerShell 阻止激活脚本，请以当前用户身份打开 PowerShell 并运行一次 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，然后再次尝试激活命令。
python super_diagnose_v2.py
要确认在开始扫描之前源代码树和依赖项已准备就绪，请运行：
python -m compileall src super_diagnose_v2.py
该命令应能无错误完成。该工具在运行时仍需要 Windows 和管理员权限，因为若干诊断功能会使用 PowerShell 和受保护的系统信息。
选项 A：交互式输入（推荐首次使用时采用）
keyring）安全存储选项 B：环境变量 命令提示符：
set GEMINI_API_KEY=your_api_key_here
PowerShell：
$env:GEMINI_API_KEY = "your_api_key_here"
选项 C：手动密钥文件
在工具目录中创建 gemini.key：
your_api_key_here
| 模式 | 扫描内容 | 使用场景 |
|---|---|---|
| 快速扫描 | CPU、RAM、基本信息 | 快速性能检查 |
| 深度扫描 | 系统、网络、安全、日志、蓝牙、进程 | 全面故障排查 |
| 完整扫描 | 以上所有内容 + 磁盘健康、GPU、启动应用 | 完整系统审计 |
1. Run the tool
> SuperDiagnosticTool.exe
2. Describe your issue
> High CPU usage and slow performance
3. Select scan mode
> 3 (Complete System Scan)
4. Wait for AI analysis
[Scanning system layers...]
[Processing telemetry...]
5. Review the generated remediation script
> Execute? (y/n)
6. View the HTML report
> Open detailed report? (y/n)
$env:TEMP、$env:PATH）被正确保留[ANALYSIS_START]、[FIX_START]）的结构化提示词，以实现可靠的输出解析keyring）存储。绝不提交到版本控制。CriticalPathInterceptor 检查并获得用户明确确认。更多安全文档请参见 SECURITY.md。
pip install --upgrade psutil google-generativeai rich
AI_Reports/remediation.ps1 — 请手动检查其中是否有错误本项目使用 GitHub Actions 在推送版本标签时构建 Windows 可执行文件：
git tag -a v1.0.2 -m "Release notes" && git push origin v1.0.2
.exe 并自动创建发布版本有关发布工作流配置，请参见 .github/workflows/release.yml。
pip install pyinstaller
pip install -r requirements.txt
python build.py
这会生成带有内嵌图标和依赖项的 dist/SuperDiagnosticTool.exe。