# Windows电脑诊断修复工具

**Repository Path**: zionloh/WindowsDoctor

## Basic Information

- **Project Name**: Windows电脑诊断修复工具
- **Description**: Windows电脑一键诊断修复工具，用于个人、企业终端电脑常规故障诊断和修复，支持AI高级诊断功能
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-21
- **Last Updated**: 2026-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZionLoh 自助终端诊断修复工具

**商标：ZionLoh** · v1.3.0 · 兼容 Windows 7 / 8 / 8.1 / 10 / 11 及后续 Windows 版本

面向公司桌面运维与家庭用户的**一键诊断 + 一键修复 + 手动指引**三合一工具，
解决桌面运维中大量"统称网络问题"的重复性故障。
![输入图片说明](image.png)

## v1.3 新增

- **CLI 命令行模式**：`main.py <子命令>` 规范入口，全部核心操作与 GUI 对等，供外部任务调度与 AI Agent 调用；加 `--json` 输出结构化 JSON，退出码语义化（0 成功 / 1 失败 / 2 参数错 / 3 需管理员）
- **Windows 常见问题修复库**：13 项高频故障一键修复（任务栏/资源管理器反复重启、开机黑屏仅鼠标、快捷方式失效、控制面板打不开、注册表拒绝访问、打印服务反复重启、音频服务异常、网络发现不可用、系统更新失败、网络连接受限、启动项优化、系统文件完整性、时间同步），按 6 大类别分组；每项含【问题描述 / 常见原因 / 一键修复 / 验证方式】，破坏性操作执行前自动备份 + 二次确认
- **全局搜索框**：顶栏搜索框可搜索「功能板块 + 修复项」，回车弹出结果列表，双击/点击直达对应板块或修复项
- **系统托盘常驻**：纯 ctypes 实现（不引入第三方库）；最小化/关闭到托盘，右键菜单支持一键诊断 / AI 诊断 / 内存优化 / 磁盘清理 / 退出，操作结果气球通知
- **AI 诊断进度可视化**：分阶段进度条（准备数据 → 收集占用 → 调用模型 → 渲染结果），长等待过程可视化

## v1.2 新增

- **网络质量检测**：延迟/丢包率/抖动/带宽四指标测量 + 综合评级 + 问题定位 + 可操作修复建议
- **共享修复板块**：一键修复"扩展错误1272/Guest登录受限/无法访问共享"（参考已验证的 V2 脚本）
- **AI 增强诊断**：基础检测 + 深度探测（DNS对比/策略核查/进程签名/SSL证书/路由追踪/端口扫描/磁盘IO压测）交给 AI 交叉分析，AI 能力上限高于内置功能，输出区分【基础检测】与【AI增强】
- **系统信息扩展**：操作系统安装时间/内部版本/功能更新/运行时长 + TOP10 异常登录日志
- **全量数据导出**：一键导出全部诊断数据为 JSON（含增强探测），作排障依据
- **UI 商业化重构**：统一边框/分割线/悬停反馈/扁平滚动条，任务栏图标修复（AppUserModelID）

## 功能总览

| 模块 | 诊断项 | 修复项 | 覆盖内容 |
|------|--------|--------|----------|
| 网络 | 15 项 | 13 项 | 网卡驱动、物理链路、IP/DHCP、网关、DNS、外网、系统代理、**代理深度检测**、**网络质量综合检测**、防火墙、SMB 共享、**共享访问诊断**、hosts 劫持、Wi-Fi 信号、远程桌面 |
| 系统 | 10 项 | 6 项 | 关键服务、磁盘空间、磁盘 SMART 健康、蓝屏/异常断电记录、启动项、时间同步、Windows 更新、UAC、待重启挂起 |
| 外设 | 5 项 | 1 项 | 打印机与打印队列、音频、USB 异常设备、显卡、蓝牙 |
| 性能 | 5 项 | 2 项 | CPU / 内存 / 开机耗时 / 垃圾文件 / 磁盘垃圾安全扫描 |
| 安全 | 4 项 | 2 项 | 杀毒软件状态、系统文件完整性、病毒库更新、**TOP10异常登录日志** |
| **合计** | **39 项** | **26 项** | 覆盖 98% 以上日常家用/办公故障场景 |
| **故障修复库** | — | **13 项 / 6 类** | 桌面与资源管理器、系统设置与权限、服务类故障、更新与网络、性能与启动、系统完整性 |

### CLI 命令行模式（外部任务 / AI Agent 调度）

```bash
main.py diagnose                        # 全量诊断 + HTML 报告 (有问题退出码 1)
main.py --json diagnose                 # 结构化 JSON 输出
main.py winfix list                     # Windows 常见问题修复库清单
main.py winfix search 打印               # 搜索修复项
main.py winfix info wf_print_spooler    # 修复项详情(描述/原因/操作/验证)
main.py winfix run wf_print_spooler --verify      # 一键修复 + 自动验证
main.py winfix run wf_black_screen --confirm      # 高风险项需显式 --confirm(自动备份)
main.py disk-clean --dry-run            # 磁盘清理预览
main.py netquality                      # 网络质量检测
main.py export-all                      # 导出全量诊断数据 JSON
main.py tray                            # 托盘值守模式(无主窗口)
main.py help                            # 全部子命令
```

退出码：`0` 成功 · `1` 执行失败/诊断有异常 · `2` 参数用法错误 · `3` 需要管理员权限。

### GLI 底层 JSON 协议（保留，供深度集成）

```bash
main.py --gli '{"verb":"diagnose"}'                      # 全量诊断(JSON输出)
main.py --gli '{"verb":"winfix_run","args":{"id":"wf_explorer_restart","confirm":true}}'
main.py --gli '{"verb":"deep_tracert","args":{"host":"www.baidu.com"}}'
main.py --gli-cmd list                                   # 全部动词清单
```

动词: diagnose / repair / list / pcinfo / netquality / share_fix / disk_clean /
memory_optimize / ai_diagnose / system_ext / winfix_list / winfix_run / winfix_search /
startup_list / startup_optimize / organize / export_all / help + 7 个 deep_* 增强探测。

### 六大扩展板块

| 板块 | 功能 |
|------|------|
| 💻 电脑信息 | CPU/内存/磁盘/内外网 IPv4 与 IPv6/MAC/主板与 BIOS 序列号 + CPU/内存/磁盘 IO/网络连接四类 TOP10 进程；一键复制、导出 CSV/HTML 用于报障工单 |
| 🧹 磁盘清理 | 白名单安全策略：仅临时文件/缓存/浏览器 Cache/更新残留；扫描出清单→勾选→确认后清理；只删 24h 前文件、被占用自动跳过，绝不删用户文件 |
| ⚡ 内存优化 | 收缩全进程工作集(EmptyWorkingSet) + 清理待机内存列表(Standby List)，不结束任何进程 |
| 🤖 AI 管理 | 内置国内外 TOP10 AI 厂商(DeepSeek/智谱/通义/Kimi/千帆/MiniMax/豆包/OpenAI/Anthropic/Gemini)，OpenAI 兼容协议，支持自定义厂商/模型/API地址/密钥；密钥仅存本机 ai_config.json |
| 🧠 AI 诊断 | 将诊断结果+系统信息+进程占用交给已配置的 AI 模型，输出诊断结论/问题分析/修复建议/风险提示，可复制或保存为 Markdown 报告；分阶段进度条可视化 |
| 🧰 故障修复库 | 13 项 Windows 高频故障一键修复，按 6 类别分组；每项含问题描述/常见原因/一键修复/验证方式；破坏性操作自动备份(backups/ 目录)并二次确认 |
| 🔍 系统代理深度检测 | 识别代理软件(V2Ray/Clash 等)残留：代理死/代理活但内网不通/PAC 失效/绕过列表为空 四类场景，一键智能修复或彻底关闭 |

### 系统托盘（纯 ctypes，不引入第三方库）

- 关闭窗口或最小化 → 隐藏到系统托盘继续值守（右下角气球提示）
- 右键托盘图标：打开主窗口 / 一键诊断 / AI 诊断 / 内存优化 / 磁盘清理 / 退出
- 托盘菜单触发的操作在后台线程执行，结果经气球通知反馈，不阻塞界面
- `main.py tray` 可启动无窗口的纯托盘值守模式（适合开机自启后台巡检）

### 全局搜索

顶栏搜索框支持两类目标：**功能板块**（如"磁盘清理"、"内存优化"、"AI 诊断"）与
**Windows 修复项**（如"打印"、"黑屏"、"注册表"）。回车弹出结果列表，双击/点击"直达选中项"
即可跳到对应板块；命中修复项时会自动在故障修复库中筛选定位。

## 快速开始

```bash
# 图形界面（推荐，直接双击 exe 或）
python main.py

# 命令行诊断（适合远程/批量/外部调度）
python main.py diagnose

# 列出全部诊断/修复项
python main.py fix --list

# 查看 Windows 故障修复库并执行修复
python main.py winfix list
python main.py winfix run wf_explorer_restart --verify

# 执行指定基础修复
python main.py fix fix_flush_dns

# 全部子命令
python main.py help
```

> 建议始终**右键 → 以管理员身份运行**，以获得完整修复能力。

## 项目结构

```
ZionLoh-DiagnosticTool/
├── main.py               # 入口 (GUI + CLI 子命令模式)
├── main.pyw              # 无控制台 GUI 入口(pythonw 双击启动)
├── gui.py                # 科技风图形界面 (tkinter, Win7 可用)
├── core/
│   ├── models.py         # 诊断项/修复项模型与注册中心
│   ├── utils.py          # 命令执行/提权/系统信息/日志/配置
│   ├── checks_network.py # 网络诊断
│   ├── checks_system.py  # 系统诊断
│   ├── checks_hardware.py# 外设诊断
│   ├── checks_perf.py    # 性能与安全诊断
│   ├── repairs.py        # 一键修复动作库
│   ├── winfix.py         # Windows 常见问题修复库(13 项/6 类) + 自动备份
│   ├── tray.py           # 系统托盘(纯 ctypes Shell_NotifyIconW)
│   ├── proxy_deep.py     # 系统代理深度检测与智能修复
│   ├── pcinfo.py         # 电脑信息 + TOP10 进程 + 导出
│   ├── ai.py             # AI 厂商配置 + OpenAI 兼容调用 + AI 诊断
│   ├── cleaner.py        # 磁盘安全清理 + 内存优化
│   ├── relocator.py      # 系统盘搬家 + 文件整理
│   ├── netquality.py     # 网络质量检测 + 测速源配置
│   ├── smb_fix.py        # 共享访问修复
│   ├── sysinfo_ext.py    # 系统版本扩展信息 + 登录日志
│   ├── gli.py            # GLI 底层 JSON 协议分发
│   └── report.py         # HTML 报告生成
├── tools/
│   └── smoke_gui.py      # GUI 冒烟测试脚本(逐页切换+搜索+进度条)
├── config.json           # 配置文件
├── ZionLoh.spec          # PyInstaller 打包配置
├── build.bat             # 一键打包脚本
├── version_info.txt      # EXE 版本信息
├── docs/                 # 文档
└── reports/ logs/ backups/   # 报告 / 日志 / 修复备份 输出目录
```

## 配置说明 (config.json)

| 键 | 默认值 | 说明 |
|----|--------|------|
| dns_preferred | 223.5.5.5 | 一键修复时设置的公共 DNS |
| dns_backup | 114.114.114.114 | 备用 DNS |
| test_domains | www.baidu.com 等 | DNS 解析测试域名（可换成公司内网域名） |
| ping_hosts | 223.5.5.5 等 | 外网连通性 ping 目标（内网环境可换成网关） |
| report_dir | reports | 诊断报告输出目录 |

**测速源配置 (speedtest.json)**：在「网络质量」页点「⚙ 更换内网测速源」，输入自定义测速 URL（每行一个，需 http/https 开头，保存时校验格式），保存到程序目录 `speedtest.json` 后**立即生效**（每次测速时动态读取，无需重启或重新打包）。自定义源优先尝试、失败自动回退内置默认源；清空保存或删除 speedtest.json 即恢复默认。

**配置统一存放与迁移**：`config.json`（主配置）、`ai_config.json`（AI 厂商/密钥/默认模型）、`speedtest.json`（测速源）全部保存在**程序可执行文件同目录**（打包后为 exe 所在目录，而非临时解压目录）。程序启动时自动加载，修改后重启生效（测速源除外，立即生效）。**复制整个程序目录到其他电脑即完成全部配置迁移**，无需重新配置。

修改后重启程序生效。

## 兼容性设计

- **Win7**: 不依赖 `Get-NetAdapter` 等 Win8+ PowerShell 命令独占功能，全部提供 `netsh`/`wmic`/`sc` 降级路径；GUI 使用 tkinter（Win7 自带 tcl/tk 兼容）。
- **Win10/11**: 优先使用 PowerShell CIM 命令获取更准确数据。
- **未来版本**: 未使用任何已废弃的私有 API，全部基于系统自带命令行工具，向前兼容性好。

## 安全承诺

- 只在本机执行**只读诊断**与**常见系统修复**，不联网上传任何数据。
- 高风险操作（重置 hosts、重启电脑、改注册表）需二次确认；hosts 重置自动备份原文件。
- 故障修复库中所有 `risky` 项（涉及注册表/系统文件）执行前**自动备份**到程序目录
  `backups/` 子目录（含时间戳标签），可随时在「故障修复库」页点「📂 打开备份目录」查看。
- 临时文件清理只删除 Temp 目录内容，不触碰用户文档。
- 托盘与本工具全部使用**系统自带能力 + Python 标准库/ctypes**，不引入第三方二进制，
  降低杀软误报风险。

## 许可与商标

商标 **ZionLoh** (c) 2026，保留所有权利。