20260410-153006

README.md

@@ -1,13 +1,19 @@
 # Python-Learning-Resources
 本项目用于整理和记录 Python 学习过程中的重要资料与工具文档，方便查阅与系统学习。
+
 # 目录结构
-Python-Learning-Resources/  
-├── [README.md](README.md)       # 项目主说明文件  
-└── [psutil](psutil.md)       # psutil 库详细功能文档
+
+| 类型 | 名称 | 说明 |
+| :---: | --- | --- |
+| 库 |  |  |
+|| [psutil](#psutil-快速概览) | 平台系统监控库，涵盖 CPU、内存、磁盘、网络、进程管理等核心功能。 |
+|| [py-cpuinfo](#py-cpuinfo-快速概览) | 用于跨平台获取 CPU 型号、核心数、频率、缓存、指令集等信息。 |
 
 ---
+
 当前包含：
 - [psutil 详细功能文档](psutil.md)：跨平台系统监控库 `psutil` 的完整使用指南，涵盖 CPU、内存、磁盘、网络、进程管理等核心功能。
+- [py-cpuinfo 详细使用文档](py-cpuinfo.md)：轻量级 Python 库 `py-cpuinfo` 的完整使用指南，用于跨平台获取 CPU 型号、核心数、频率、缓存、指令集等信息。
 
 ---
 
@@ -46,14 +52,58 @@ print(psutil.pids())    # 查看所有进程 PID
 ```
 
 详细用法请参考 [psutil.md](psutil.md)。
+
+---
+
+## py-cpuinfo 快速概览
+
+`py-cpuinfo` 是一个轻量级的 Python 库，用于**跨平台获取 CPU 信息**，无需安装系统级依赖，适用于 Linux / Windows / macOS / BSD 等系统。它常用于性能分析、环境检测、硬件审计、自动化运维等场景。
+
+### 核心功能
+
+- **基础信息**：CPU 型号、厂商、架构、家族编号
+- **核心与线程**：物理核心数、逻辑 CPU 数量、每核线程数
+- **频率信息**：标称主频、当前实际主频
+- **缓存信息**：L1/L2/L3 缓存大小
+- **指令集支持**：AVX、SSE、AES 等指令集检测
+
+### 安装
+
+```bash
+pip install py-cpuinfo
+```
+
+### 快速开始
+
+```python
+from cpuinfo import get_cpu_info
+
+info = get_cpu_info()
+print(info['brand_raw'])  # 输出 CPU 型号
+print(f"物理核心: {info['cores']}, 逻辑核心: {info['count']}")
+print(f"标称频率: {info['hz_advertised_friendly']}")
+```
+
+详细用法请参考 [py-cpuinfo.md](py-cpuinfo.md)。
+
+---
+
 ### 适用场景
 
+**psutil 适用场景：**
 - 系统资源实时监控
 - 服务器性能分析
 - 进程级资源审计
 - 自动化运维脚本
 - 安全/异常进程检测
 
+**py-cpuinfo 适用场景：**
+- 性能调优与环境检测
+- 软件兼容性判断
+- 硬件审计与资产盘点
+- 自动化运维脚本
+- CPU 特性检测（如 AVX、AES 支持）
+
 ---
 
 > 更多 Python 学习资源将持续更新到此仓库。