返回更新列表
新发布Aug 19, 2026

SuperDiagnosticTool v1.0.5

AI 驱动的 Windows 诊断与自动修复工具，基于 Google Gemini。可检测崩溃、优化性能、扫描恶意软件，并生成 PowerShell 修复脚本。支持通用硬件（1-128+ 核心）。免费且开源。

分享

超级诊断工具

超级诊断工具图标

AI 驱动的 Windows 诊断与自我修复工具

Release License Stars

SuperDiagnosticTool 是一款智能系统诊断工具，它将实时硬件遥测与 Google Gemini AI 相结合，用于分析、诊断并自动修复 Windows 系统问题。采用安全优先架构，可为任何 Windows 配置提供生产级诊断能力。

截图

主界面

主界面，显示扫描模式选择与问题描述输入

主要特性

通用硬件支持

  • 动态伸缩： 自动适配任何 CPU 配置（1-128+ 核）
  • 硬件无关逻辑： 在老旧系统（Intel Pentium）到高端工作站（AMD Threadripper、Intel Xeon）上均可无缝工作
  • 优雅降级： 安全处理不支持的特性（CPU 频率、电池检测、交换内存）
  • 低配优化： 轻量执行，即使在资源受限的硬件上也不会导致系统卡顿

智能 AI 分析

  • Google Gemini 集成： 基于先进 AI 的系统分析与诊断
  • 上下文感知建议： 将用户报告的问题与系统遥测数据相关联
  • 安全审计： 扫描可疑进程、资源泄露及潜在恶意软件
  • 修复后验证： 生成完成报告，显示已修复内容与需要手动关注的内容

安全优先架构

生产级安全性（85%）

多层验证

  • 知识库匹配： 验证 AI 解决方案是否与经过测试的、已知的 5 个含成功率记录的解决方案匹配
  • 预演模拟： 在操作（服务、文件、注册表）之前预览所有更改
  • 多级脚本验证： 黑名单、白名单及风险评分（0-100）
  • 系统还原点： 在进行任何修改前自动创建系统还原点

增强监控

  • 执行前后快照： 在更改前后捕获完整的系统状态
  • 变更检测： 自动跟踪所有修改（服务、注册表、启动项）
  • 回滚生成： 自动生成脚本，以便在需要时撤销更改
  • 执行日志： 所有操作的全面日志

PowerShell 安全

  • 管理员权限验证： 所有修复脚本包含提权检查
  • 变量清理： 基于正则的转义可防止错误，同时保留 $env: 变量
  • 服务安全检查： 操作前验证服务是否存在
  • 沙盒执行： 带超时保护的监控环境
  • 错误处理： 全面的 try-catch 块与安全措施

全面系统扫描

  • 性能指标： CPU 使用率（总体 + 每核）、内存分布、资源消耗 Top 进程
  • 网络智能： 活动接口、DNS 配置、Wi-Fi 信号强度、连通性测试
  • 安全完整性： 防病毒状态、防火墙配置文件、Windows 更新历史
  • 硬件健康： 磁盘 SMART 状态、GPU 信息、电池状态（笔记本电脑）
  • 系统服务： 启动应用程序、失败的服务、关键事件日志
  • 进程审计： 基于资源使用和位置识别可疑进程

以人为本的报告

  • 专业 HTML 报告： 深色主题、响应式诊断报告，包含可视化指标
  • 过去式完成描述： 报告使用 [已修复]、[已清理]、[已禁用] 标签显示已完成的操作
  • 手动关注部分： 清晰区分自动修复项目与需要用户干预的项目
  • 带时间戳的归档： 所有报告保存至 AI_Reports/ 目录，便于历史追溯

快速开始

下载

下载 SuperDiagnosticTool.exe - 独立可执行文件（无需 Python）

系统要求

  • Windows 10 或 Windows 11
  • 管理员权限
  • Google Gemini API 密钥（获取免费密钥）

首次运行

  1. 下载并运行 SuperDiagnosticTool.exe
  2. 根据提示输入你的 Google Gemini API 密钥
  3. 描述你的系统问题
  4. 选择扫描模式（快速/深度/完全）
  5. 查看 AI 分析与修复脚本
  6. 执行修复或查看详细 HTML 报告

安装（针对开发者）

先决条件

  • Python 3.8 或更高版本
  • pip 包管理器

安装依赖

pip install psutil google-generativeai rich

从源码运行

python super_diagnose_v2.py

使用方法

API 密钥设置

选项 A：交互式输入（推荐新手使用）

  • 首次运行时工具会提示输入你的 API 密钥
  • 密钥会保存在本地 gemini.key 文件中，供后续使用

选项 B：环境变量

set GEMINI_API_KEY=your_api_key_here

选项 C：手动密钥文件 在同目录下创建 gemini.key：

your_api_key_here

扫描模式

模式扫描内容适用场景
快速扫描CPU、内存、基本信息快速性能检查
深度扫描系统、网络、安全、日志、蓝牙、进程全面故障排除
完全扫描以上所有 + 磁盘健康、GPU、启动项完整系统审计

示例工作流

# 1. 运行工具
SuperDiagnosticTool.exe

# 2. 描述你的问题
> CPU 使用率高，性能缓慢

# 3. 选择扫描模式
> 3（完全系统扫描）

# 4. 等待 AI 分析
[正在扫描系统层...]
[正在处理遥测逻辑...]

# 5. 查看修复脚本
[PowerShell 脚本显示]
> 是否执行？(y/n)

# 6. 查看 HTML 报告
> 是否打开详细报告？(y/n)

技术细节

代码架构

  • 模块化设计，每个诊断类别有独立函数
  • 全面的错误处理，使用 try-except 块
  • 硬件无关的查询，带优雅降级
  • 专业文档字符串和清晰的变量命名

PowerShell 脚本生成

  • 执行前进行管理员权限验证
  • 基于正则的变量转义，防止语法错误
  • 正确保留环境变量（$env:TEMP、$env:PATH）
  • 带存在性检查的安全服务管理
  • 使用 -ErrorAction SilentlyContinue 抑制错误

Gemini AI 集成

  • 结构化提示，实现一致输出解析
  • 分隔区域（[ANALYSIS_START]、[FIX_START]），便于可靠提取
  • 基于系统遥测的上下文感知分析
  • 已完成的修复操作使用过去式报告

安全与隐私

  • 不收集数据： 所有分析在本地进行；仅系统遥测数据发送至 Gemini API
  • API 密钥安全： 密钥本地存储，永不提交至版本控制
  • 管理员透明： 用户必须明确批准所有修复脚本
  • 非破坏性： 未经用户同意，不删除文件或修改注册表
  • 开源： 完整源代码可供安全审计

详见 SECURITY.md。

故障排除

“API 密钥无效”错误

  • 验证你的 API 密钥是否正确且处于活动状态
  • 检查是否有隐藏字符或空白
  • 确保密钥已启用 Gemini API 访问权限
  • 在 https://makersuite.google.com/app/apikey 重新生成密钥

“未以管理员身份运行”

  • 右键单击可执行文件，选择“以管理员身份运行”
  • 或者当工具自动提权时允许 UAC 提示

“模块未找到”错误（Python 版本）

pip install --upgrade psutil google-generativeai rich

PowerShell 脚本失败

  • 确保你正在运行 Windows PowerShell 5.1 或更高版本
  • 检查执行策略是否允许脚本执行
  • 查看 AI_Reports/remediation.ps1 中的脚本以查找错误

从源码构建

自动构建（推荐）

该项目使用 GitHub Actions 在推送版本标签时自动构建 Windows 可执行文件：

  1. 将你的更改推送到 main 分支
  2. 创建并推送版本标签：git tag -a v1.0.2 -m "发布说明" && git push origin v1.0.2
  3. GitHub Actions 将自动构建 .exe 并创建一个发布版本
  4. 从 发布页面 下载

详见 RELEASE_PROCESS.md。

手动构建（用于测试）

在 Windows 上：

pip install pyinstaller
pip install -r requirements.txt
python build.py

这将在 dist/SuperDiagnosticTool.exe 创建包含嵌入图标和依赖的可执行文件。

注意： 如果你看到“Windows 已保护你的电脑”警告，请阅读 TRUST_GUIDE.md 了解快速修复方法或如何永久添加白名单。

注意： 在 Linux/Mac 上构建将生成特定平台的二进制文件，而非 Windows .exe 文件。请使用 GitHub Actions 进行官方 Windows 发布。

文件结构

SuperDiagnosticTool/
├── super_diagnose_v2.py    # 主诊断脚本
├── build.py                # 构建 EXE 的脚本
├── icon.ico                # 应用程序图标
├── .github/workflows/      # GitHub Actions 工作流
│   └── release.yml        # 自动构建与发布
├── docs/
│   ├── icon.png           # README 用图标
│   └── screenshot_main.png # 主界面截图
├── src/                    # 源代码模块
│   ├── safety/            # 安全与验证模块
│   └── security/          # 安全特性
├── AI_Reports/             # 生成的 HTML 报告
├── README.md               # 本文件
├── RELEASE_PROCESS.md      # 发布流程文档
├── LICENSE                 # GPL-3.0 许可证
├── SECURITY.md             # 安全文档
└── .gitignore              # Git 忽略规则

免责声明

重要：系统修改警告

本工具会生成并执行 PowerShell 脚本，修改系统服务、配置和设置。尽管采用安全优先原则：

  • 务必在操作前检查生成的 PowerShell 脚本
  • 在运行自动修复前备份重要数据
  • 如有可能，先在非生产系统上测试
  • 了解系统所做的变更

作者不对因使用本工具造成的任何系统损坏、数据丢失或意外后果负责。使用风险自负。

贡献

欢迎贡献！请：

  1. Fork 本仓库
  2. 创建特性分支（git checkout -b feature/改进）
  3. 提交更改（git commit -m '添加改进'）
  4. 推送到分支（git push origin feature/改进）
  5. 发起 Pull Request

许可证

本项目采用 GNU 通用公共许可证 v3.0 授权 - 详见 LICENSE 文件。

版权所有 (C) 2026 GUETTAF HOUSSEM EDDINE

作者

Knight
电子技术工程专业学生
阿克利·穆罕默德·乌哈吉大学，布维拉，阿尔及利亚
邮箱: [email protected]
GitHub: @Guettaf-hossam

致谢

  • Google Gemini AI 提供智能系统分析
  • psutil 库提供跨平台系统监控
  • Rich 库提供美观的终端输出

版本 1.0 | 最后更新: 2026年1月

由 Knight 用心打造 | 阿克利·穆罕默德·乌哈吉大学

阅读更多

分类

通用工具漏洞分析脚本与自动化配置审计取证分析恶意软件分析机器学习事件响应AI 安全日志分析