# 统信硬件管家

**Repository Path**: deepin20/UHI

## Basic Information

- **Project Name**: 统信硬件管家
- **Description**: 统信硬件管家 (UOS Hardware Inspector)，一站式笔记本硬件检测、诊断与修复工具专为统信 UOS / Deepin 系统打造。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-16
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 统信硬件管家 (UOS Hardware Inspector)

[![Python Version](https://img.shields.io/badge/python-3.6%2B-blue)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-GPLv3-green)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-UOS%20%7C%20Deepin%20%7C%20Linux-lightgrey)]()

> **一站式笔记本硬件检测、诊断与修复工具**，专为统信 UOS / Deepin 系统打造。

---

## 📖 简介

**统信硬件管家**（UOS Hardware Inspector，简称 **UHI**）是一款图形化的系统工具，帮助您：

- **全面检测**：一键扫描 CPU、内存、磁盘、显卡、网络、电池、温度传感器等所有核心硬件。
- **健康评估**：直观显示各硬件状态（正常/警告/异常），并给出优化建议。
- **深度诊断**：查看系统日志、USB/蓝牙设备、网络测速、驱动版本检查。
- **音频修复**：一键修复 Intel 500/600 系芯片组因 SOF 驱动导致的声卡丢失问题。
- **性能测试**：内存带宽测试、磁盘顺序读写测试。
- **温度监控**：实时绘制 CPU/GPU/磁盘温度曲线，辅助散热评估。
- **报告导出**：生成详细的 HTML 硬件检测报告，方便存档或分享。

无论您是普通用户还是系统管理员，UHI 都能让您快速了解硬件状况，定位并解决常见故障。

---

## ✨ 功能特性

| 模块 | 检测内容 |
|------|----------|
| **系统概览** | 操作系统、主机名、内核版本、产品型号（需 root）、BIOS 版本、内存总量、根分区使用 |
| **CPU** | 型号、物理/逻辑核心数、频率、实时使用率、各核心负载、温度（需硬件支持） |
| **内存** | 总内存、已用/可用、使用率、Swap 总量及使用率 |
| **磁盘** | 分区列表（挂载点、容量、已用、可用、使用率、文件系统）、S.M.A.R.T. 健康状态（需 root）、详细属性查看 |
| **显卡** | PCI 设备信息、NVIDIA 专有驱动型号/版本/温度/显存（如有） |
| **网络** | 有线/无线接口状态、IP 地址、默认网关、**网络测速**（需安装 speedtest-cli） |
| **电池** | 当前电量、充放电状态、剩余时间、设计容量/当前容量、健康度百分比 |
| **温度/风扇** | CPU/GPU/硬盘/主板温度、风扇转速（需硬件支持），**实时温度曲线** |
| **系统诊断** | 系统错误日志（dmesg + journalctl）、USB 设备列表、蓝牙适配器与设备、**音频配置备份与恢复**、**开机自启动诊断** |
| **驱动检查** | NVIDIA 驱动版本对比（当前 vs 最新）、Intel i915 驱动版本 |
| **音频修复** | 声卡检测（/proc/asound/cards、aplay -l、pactl）、驱动详情（已加载模块）、一键修复（禁用 SOF 驱动，强制使用 HDA） |
| **音量控制** | PulseAudio 输出设备列表、音量滑块、静音切换 |
| **性能测试** | 内存带宽测试（读/写）、磁盘顺序读写测试 |
| **导出报告** | 生成完整的 HTML 格式硬件报告，并自动在浏览器中打开 |
| **分享摘要** | 一键复制诊断摘要到剪贴板，便于快速分享 |

> 💡 **提示**：部分高级信息（如 S.M.A.R.T.、产品型号、电池容量）需要 **root 权限** 才能读取，建议使用 `sudo` 运行以获得完整数据。

---

## 🚀 安装与运行

### 1. 从源码运行（推荐）
```bash
# 克隆仓库
git clone https://github.com/your-username/uos-hardware-inspector.git
cd uos-hardware-inspector

# 安装 Python 依赖
pip3 install -r requirements.txt

# 安装系统依赖（可选，用于获取更多硬件信息）
sudo apt update
sudo apt install python3-tk dmidecode smartmontools lm-sensors speedtest-cli

# 启动（自动提权）
bash start.sh
```

### 2. 全局安装（使用 setup.py）
```bash
sudo python3 setup.py install
```
安装后可在终端直接运行 `uhi` 命令（需 root 权限）。

### 3. 一键启动脚本
项目根目录提供了 `start.sh`，自动检查环境、依赖，并以 root 权限运行（首次使用需输入 sudo 密码，之后可配置免密）。推荐使用此方式。

---

## 🖥️ 使用指南

### 启动界面
```bash
# 推荐：使用启动脚本（自动提权）
./start.sh

# 或手动运行
sudo python3 src/main.py
```

### 操作步骤
1. **刷新数据**：点击顶部 `🔄 刷新` 按钮，程序会在后台采集所有硬件信息，并更新各标签页内容。
2. **查看概览**：`概览` 标签页显示系统摘要和硬件健康状态（✅/⚠️/❌）。
3. **详细硬件**：分别点击 `CPU`、`内存`、`磁盘` 等标签页查看详细参数。
4. **温度监控**：进入 `温度曲线` 标签页，点击 `开始采集` 实时绘制温度曲线。
5. **系统诊断**：切换到 `系统诊断` 标签页，可查看日志、USB/蓝牙设备、网络测速、配置备份/恢复、开机自启动设置。
6. **音频修复**：切换至 `音频` 标签页，点击 `重新检测声卡`，若显示“需要修复”，点击 `修复声卡` 即可执行一键修复（需 root 权限）。修复后需重启系统生效。
7. **导出报告**：点击 `📄 导出报告`，可生成包含所有硬件信息的 HTML 报告，并自动在浏览器中打开。
8. **分享摘要**：点击 `📤 分享摘要`，将诊断摘要复制到剪贴板，方便粘贴到邮件或聊天工具中。

> ⚠️ **注意**：音频修复会修改系统配置文件（`/etc/modprobe.d/`）并更新 initramfs，操作不可逆，请确保已备份重要数据。

---

## 📋 依赖说明

| 依赖 | 用途 | 安装方式 |
|------|------|----------|
| `python3` (>=3.6) | 运行环境 | 系统自带 |
| `psutil` | 硬件信息采集 | `pip3 install psutil` |
| `tkinter` | GUI 界面 | `sudo apt install python3-tk` |
| `dmidecode` (可选) | 产品型号、BIOS | `sudo apt install dmidecode` |
| `smartmontools` (可选) | 磁盘 S.M.A.R.T. | `sudo apt install smartmontools` |
| `lm-sensors` (可选) | 温度传感器 | `sudo apt install lm-sensors` |
| `speedtest-cli` (可选) | 网络测速 | `sudo apt install speedtest-cli` |
| `pulseaudio-utils` (可选) | 音量控制（pactl） | `sudo apt install pulseaudio-utils` |

---

## ❓ 常见问题

### Q: 运行时提示“未找到声卡设备”？
**A**：请切换到 `音频` 标签页，点击 `修复声卡`，然后重启系统。该操作会强制系统使用传统 HDA 驱动，替代 SOF 驱动栈。

### Q: 某些硬件信息显示“未检测到”？
**A**：部分信息（如温度、风扇）需要硬件和内核支持，或需要 `root` 权限。建议使用 `sudo` 运行程序。

### Q: 导出报告时提示“保存失败”？
**A**：请检查保存路径是否有写入权限，或尝试保存到用户目录（如 `~/`）。

### Q: 如何卸载？
**A**：
```bash
sudo ./scripts/uninstall.sh
# 或手动删除
sudo pip3 uninstall uos-hardware-inspector
sudo rm -f /usr/local/bin/uhi
sudo rm -f /etc/sudoers.d/uhi
```

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！请确保代码符合 PEP 8 规范，并为新功能编写测试。

### 开发环境搭建
```bash
# 克隆并安装开发依赖
pip3 install -r requirements-dev.txt   # 包含 pytest 等
```

---

## 📄 许可证

本项目采用 **GNU General Public License v3.0** 开源协议，详见 [LICENSE](LICENSE) 文件。

---

## 📧 联系方式

- 作者：Your Name
- 邮箱：your@email.com
- 项目主页：https://github.com/your-username/uos-hardware-inspector

---

**统信硬件管家** – 让硬件状况一目了然，让系统问题一键修复。🎯