电脑硬件信息查询工具说明文档

📖 脚本简介

这是一个基于Python开发的电脑硬件信息查询工具，遵循kuai格式规范。该工具能够全面扫描并获取本机的CPU、内存、磁盘、显卡、主板等硬件的详细信息，并支持多种输出格式，为用户提供美观易读的硬件报告。

✨ 功能特点

🔍 全面的硬件信息获取

• 系统信息：操作系统版本、架构、运行时间等
• 处理器信息：CPU型号、核心数、使用率、频率等
• 内存信息：总容量、使用情况、内存条详细信息（品牌、型号、频率、类型）
• 存储设备：硬盘型号、容量、分区情况、使用率
• 显卡信息：GPU型号、显存、使用率、温度、驱动版本
• 主板信息：主板型号、BIOS版本、制造商信息

🎯 智能识别与优化

• 内存类型识别：支持DDR、DDR2、DDR3、DDR4、DDR5等类型自动识别
• Windows系统优化：特别针对Windows系统进行优化，获取更详细的硬件信息
• 显卡品牌识别：自动识别显卡品牌（ASUS、MSI、技嘉等）
• 虚拟设备过滤：自动过滤虚拟显示设备，只显示真实硬件

📊 多种输出格式

• 控制台输出：传统的文本格式，适合快速查看
• HTML报告：美观的网页格式报告，支持响应式设计

🔧 灵活的显示选项

• 简要信息：快速概览所有硬件的关键信息
• 详细信息：完整的硬件参数和技术规格

💻 系统要求

• 操作系统：Windows 11（推荐），也支持其他Windows版本
• Python版本：Python 3.11.0+
• 网络连接：生成HTML报告时需要

📦 依赖库说明

必需库

• psutil：系统和进程监控库，获取CPU、内存、磁盘等基础信息
• py-cpuinfo：CPU详细信息获取库
• GPUtil：NVIDIA显卡信息获取库
• pywin32：Windows系统API访问库

库功能说明

库名	作用	缺失影响
psutil	基础系统信息	无法获取CPU、内存、磁盘基础信息
py-cpuinfo	CPU详细参数	CPU信息显示不完整
GPUtil	NVIDIA显卡监控	无法获取NVIDIA显卡的使用率和温度
pywin32 + wmi	Windows硬件详情	内存条、显卡、主板等详细信息缺失

🚀 使用方法

启动参数配置

1. 信息详细程度

• 简要信息：显示硬件的关键参数，适合快速了解配置
• 详细信息：显示完整的硬件规格和技术参数

2. 输出格式

• 控制台输出：在命令行窗口中显示文本格式的硬件信息
• HTML报告：生成网页格式的报告文件，自动在浏览器中打开

运行流程

1. 启动kuai客户端
2. 选择脚本参数（信息详细程度和输出格式）
3. 点击运行
4. 等待硬件扫描完成
5. 查看结果（控制台或浏览器）

📋 输出格式详解

控制台输出格式

============================================================
                    硬件信息查询工具                    
============================================================
扫描时间: 2025-01-15 14:30:25

=================== 系统信息 ===================
操作系统: Windows 11
系统架构: AMD64
运行时间: 2天15小时30分钟

=================== 处理器信息 ===================
处理器型号: Intel(R) Core(TM) i7-12700K CPU @ 3.60GHz
物理核心数: 12核心
逻辑核心数: 20线程
使用率: 15.2%
当前频率: 3600.0 MHz

=================== 内存信息 ===================
总容量: 32.0 GB
已使用: 18.5 GB (57.8%)
可用内存: 13.5 GB (42.2%)
内存类型: DDR4

内存条详细信息:
插槽1: 16.0GB DDR4 - 品牌: Corsair - 频率: 3200MHz
        型号: CMK32GX4M2E3200C16
插槽2: 16.0GB DDR4 - 品牌: Corsair - 频率: 3200MHz
        型号: CMK32GX4M2E3200C16

HTML报告格式

• 响应式设计：支持桌面和移动设备
• 现代化界面：采用渐变背景和卡片式布局
• 数据可视化：使用进度条显示使用率
• 详细表格：以表格形式展示复杂的硬件信息
• 自动打开：生成后自动在默认浏览器中打开

⚠️ 注意事项

权限要求

• 管理员权限：某些硬件信息需要管理员权限才能获取
• Windows API访问：需要pywin32库支持Windows系统调用

兼容性说明

• 最佳体验：Windows 11系统下功能最完整
• 其他系统：Linux/macOS下部分功能可能受限
• 虚拟机环境：在虚拟机中运行可能无法获取某些硬件信息

性能提示

• 扫描时间：首次运行可能需要10-30秒完成硬件扫描
• 资源占用：扫描过程中会占用少量CPU和内存资源
• 网络要求：HTML报告无需网络，但某些样式可能依赖字体CDN

🔧 故障排除

常见问题

1. 缺少依赖库

现象：提示某些库未安装 解决：kuai客户端会自动安装依赖，如有问题请重新运行

2. 权限不足

现象：某些硬件信息显示为"Unknown" 解决：以管理员身份运行kuai客户端

3. HTML报告无法打开

现象：生成报告后浏览器未自动打开 解决：手动打开生成的HTML文件，路径会在控制台中显示

4. 内存信息不准确

现象：内存类型或品牌识别错误 解决：这是正常现象，某些内存条的信息可能无法完全识别

📊 支持的硬件类型

CPU

• Intel处理器（全系列）
• AMD处理器（全系列）
• ARM处理器（部分支持）

内存

• DDR、DDR2、DDR3、DDR4、DDR5
• 主流品牌：Samsung、SK Hynix、Micron、Corsair、G.Skill等

显卡

• NVIDIA GeForce系列（完整支持）
• AMD Radeon系列（基础支持）
• Intel集成显卡（基础支持）

存储

• 机械硬盘（HDD）
• 固态硬盘（SSD）
• NVMe SSD
• 外置存储设备

🌟 特色功能

1. 智能内存识别

能够识别内存的代数（DDR几），通过多种方法进行交叉验证：

• MemoryType字段识别
• TypeDetail位标志检查
• 设备定位符推断
• 部件号码分析
• 频率范围推断

2. 显卡品牌检测

自动识别显卡的AIB厂商：

• 华硕（ASUS）、微星（MSI）、技嘉（GIGABYTE）
• 蓝宝石（SAPPHIRE）、XFX、PowerColor
• EVGA、Zotac、Palit、Gainward等

3. 虚拟设备过滤

智能过滤虚拟显示设备：

• 远程桌面显示器
• 虚拟显示驱动
• USB显示设备
• 无线显示适配器

4. 数据格式化

• 自动选择合适的容量单位（MB/GB/TB）
• 智能的百分比显示
• 友好的时间格式（天/小时/分钟）

🎨 界面预览

简要信息模式

专注于核心硬件参数，一目了然地展示：

• 系统版本和架构
• CPU型号和核心数
• 内存容量和类型
• 主要显卡和显存
• 存储设备概览

详细信息模式

提供完整的硬件规格，包括：

• 详细的系统信息和运行时间
• CPU的完整技术参数
• 内存条的详细规格表
• 显卡的完整信息表
• 存储设备的分区情况
• 主板和BIOS信息