# pc_monitoring

**Repository Path**: qytang/pc_monitoring

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-20
- **Last Updated**: 2025-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pulseboard: Energy Capsule ⚡

![Python](https://img.shields.io/badge/Python-3.8+-3776AB?logo=python&logoColor=white)
![PyQt6](https://img.shields.io/badge/GUI-PyQt6-41CD52?logo=qt&logoColor=white)
![License](https://img.shields.io/badge/License-NonCommercial-red.svg)

**Pulseboard** 是一个极简、赛博朋克风格的 Windows 桌面监控胶囊。它设计为“隐形存在”，平时以微型能量条吸附在屏幕顶部，鼠标悬停时展开为高颜值的全息仪表盘。

> "Not just a monitor, but a desktop ornament."

---

## ✨ 核心特性

### 1. 💊 能量胶囊设计 (Energy Capsule)
- **隐形模式**：常驻屏幕顶部，仅显示 3 条粗壮的霓虹能量条 (CPU/RAM/NET)，高度仅 **20像素**。
- **交互展开**：鼠标悬停丝滑展开半透明磨砂玻璃面板，移除自动收起。
- **极致紧凑**：宽度仅 340px，不占用宝贵的屏幕空间。

### 2. 💎 赛博朋克 / 极简双主题
- **Dark Mode (默认)**：深空灰背景 + 霓虹呼吸灯 (青/粉/黄)，专为暗色桌面设计。
- **Light Mode**：清爽白背景 + Office 蓝配色，适合办公环境。
- **字体优化**：主界面采用硬朗的 `Segoe UI` 数字，设置页采用优雅的 `微软雅黑 Light`。

### 3. 📊 真实精准的数据
- **CPU/RAM**：显示 Top 5 资源占用进程，拒绝系统空闲进程干扰，数据归一化处理（0-100%）。
- **网络**：智能探测主网卡，计算真实物理带宽占用率 (支持 1Gbps/2.5Gbps 等)，拒绝虚拟网卡干扰。
- **零延迟**：基于后台独立线程采集，UI 60fps 丝滑刷新。

### 4. ⚙️ 贴心功能
- **开机自启**：内置注册表管理，一键设置开机后台运行。
- **一键退出**：右上角隐形关闭按钮，瞬间释放所有资源。
- **随意拖拽**：按住顶部边缘即可在屏幕上方水平滑动位置。
- **极客 ToolTip**：鼠标悬停在仪表盘上可查看详细硬件参数 (CPU型号、IP地址、协商速率等)。

---

## 🚀 快速开始

### 环境要求
- Windows 10/11
- Python 3.8+

### 安装依赖

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

### 启动

```bash
python app.py
```

---

## 🎮 操作指南

| 动作 | 效果 |
| --- | --- |
| **鼠标悬停** | 展开详细监控面板 |
| **鼠标移开** | 自动收起为能量条 |
| **拖拽顶部** | 水平调整胶囊位置 |
| **左上角齿轮** | 进入设置 (开机自启 / 主题切换) |
| **右上角 ×** | 彻底关闭程序 |

---

## 👤 作者

**乾颐堂 · 现任明教教主**

---

## ⚠️ 授权与声明 (License)

本项目采用 **非商业使用授权 (Non-Commercial Use Only)**。

- ✅ **允许**：个人下载、安装、使用、学习源码、二次开发自用。
- 🚫 **禁止**：任何形式的商业用途，包括但不限于打包出售、企业内部大规模部署、作为商业软件的一部分分发。

如需商业授权或定制开发，请联系作者。

---

## 📧 反馈与联系 (Contact)

如果你发现了 Bug，或者有很酷的想法，欢迎发送邮件反馈：

**collinsctk@qytang.com**

---

## 🛠️ 技术栈

- **GUI**: PyQt6 (纯代码手绘 UI，无图片素材)
- **Core**: psutil (系统指标采集)
- **System**: winreg (注册表管理)