# computer-status

**Repository Path**: zhangrui_i_admin/computer-status

## Basic Information

- **Project Name**: computer-status
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-21
- **Last Updated**: 2026-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 电脑状态悬浮监控

轻量级 Windows 桌面监控工具，包含 **MiniBar 悬浮条** 和 **详情窗口** 双界面。

## 功能

### MiniBar 悬浮条（任务栏左上角）
- 常驻显示 CPU 占比、内存占比、CPU 温度、GPU 温度
- 无值的温度项自动隐藏，不占位
- 点击展开详情窗口，右键可退出
- 支持拖拽移动位置，位置自动记忆
- 不抢焦点，不影响正常操作

### 详情窗口
- **处理器** — 实时使用率 + 温度 + 进度条
- **显卡** — 实时使用率 + 温度 + 进度条（支持 NVIDIA / Intel / AMD）
- **内存** — 已用/总量 + 使用率 + 进度条
- **磁盘** — C 盘已用/总量 + 使用率 + 进度条
- **网络** — 实时上传/下载速度
- **温度颜色** — <50°C 绿色 / 50-70°C 橙色 / >70°C 红色
- **使用率颜色** — <60% 蓝色 / 60-85% 橙色 / >85% 红色
- **窗口拖拽** — 左键拖动，位置自动记忆
- **透明度调节** — 右键菜单选择 80%-100%
- **系统托盘** — 最小化到托盘，右键显示/隐藏/退出
- **管理员提权** — 右键菜单"以管理员运行"，CPU 温度需要管理员权限
- **开机自启** — 右键菜单或托盘菜单切换，写入注册表实现
- **高 DPI 适配** — 自动感知系统缩放

## 文件结构

```
computer-status/
├── status_monitor.py              # 主程序（UI + 数据采集）
├── lib/
│   └── LibreHardwareMonitorLib.dll # 硬件传感器库
├── requirements.txt               # Python 依赖
├── build.bat                      # PyInstaller 打包脚本
└── README.md                      # 项目说明
```

## 快速启动

### 安装依赖

```bash
pip install -r requirements.txt
```

### 运行

```bash
py status_monitor.py
```

> 如需 CPU 温度，请右键悬浮窗选择"以管理员运行"。

### 打包为 EXE

双击 `build.bat` 或执行：

```bash
pyinstaller --noconfirm --onefile --windowed --name "ComputerStatus" --add-data "lib;lib" status_monitor.py
```

生成的 `dist/ComputerStatus.exe` 需配合 `lib/LibreHardwareMonitorLib.dll` 使用。

### 开机自启

1. 右键悬浮窗 → 勾选「开机自启」
2. 或将打包后的 `ComputerStatus.exe` 放入启动文件夹（`shell:startup`）

## 温度读取原理

程序通过 [LibreHardwareMonitorLib](https://github.com/LibreHardwareMonitor/LibreHardwareMonitor) 直接访问硬件传感器，无需额外运行其他软件：

| 传感器 | 权限要求 | 说明 |
|--------|---------|------|
| GPU 温度 | 普通用户 | 通过显卡驱动 API 读取 |
| GPU 使用率 | 普通用户 | 通过显卡驱动 API 读取 |
| CPU 温度 | **管理员** | 需加载 WinRing0 内核驱动 |
| CPU 使用率 | 普通用户 | 通过 psutil 读取 |

> 未以管理员运行时，CPU 温度显示 `-- °C`，其余功能正常。

## 依赖

| 包 | 用途 |
|---|---|
| PyQt5 | GUI 框架 |
| psutil | CPU/内存/磁盘/网络数据 |
| pythonnet | 调用 .NET 库 (LibreHardwareMonitorLib) |

## 操作说明

| 操作 | 功能 |
|---|---|
| **MiniBar 左键单击** | 展开/收起详情窗口 |
| **MiniBar 拖拽** | 移动 MiniBar 位置 |
| **MiniBar 右键** | 显示详情窗口 / 退出 |
| 详情窗口左键拖拽 | 移动详情窗口 |
| 详情窗口右键 | 透明度 / 管理员运行 / 开机自启 / 退出 |
| 关闭详情窗口 | 隐藏到系统托盘（MiniBar 仍可见） |
| 托盘右键 | 显示隐藏 / 管理员运行 / 开机自启 / 退出 |