# pythonExcel

**Repository Path**: youlai-code/python-excel

## Basic Information

- **Project Name**: pythonExcel
- **Description**: 报告分析仓库
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# USB记录合规分析工具

一个专业的USB设备使用记录分析工具，用于批量处理Excel格式的USB使用记录，并根据白名单进行合规性分析。

## 功能特点

- 📁 **批量分析**：支持批量导入文件夹中的多个Excel文件
- 🔍 **智能筛选**：实时搜索过滤设备序列号和文件名
- 📊 **双白名单机制**：支持内部白名单和公开白名单分类管理
- 🎨 **可视化界面**：直观的GUI界面，颜色标记不同状态的设备
- 📥 **导出报表**：一键导出分析结果为Excel汇总报表
- 🔄 **表格排序**：点击表头即可对任意列进行排序

## 系统要求

- Windows 操作系统
- Python 3.7+

## 依赖库

```
pandas
openpyxl
tkinter (Python自带)
```

## 安装与运行

### 方式一：使用Python运行

1. 安装依赖：
```bash
pip install pandas openpyxl
```

2. 运行程序：
```bash
python usb_tool.py
```

### 方式二：使用打包的可执行文件

直接运行 `dist` 目录下的 `.exe` 文件

## 使用说明

### 1. 配置白名单

- **内部白名单**：在左侧"内部白名单 SN"框中输入内部授权的USB设备序列号，每行一个
- **公开白名单**：在左侧"公开白名单 SN"框中输入公开授权的USB设备序列号，每行一个

### 2. 批量分析

1. 点击 **"📁 批量分析文件夹"** 按钮
2. 选择包含USB记录Excel文件的文件夹
3. 程序将自动分析所有 `.xlsx` 文件中的"USB记录"工作表

### 3. 查看结果

- **蓝色**：内部白名单设备
- **绿色**：公开白名单设备
- **红色**：未知/未授权设备

### 4. 筛选与排序

- 使用顶部的搜索框实时筛选结果
- 点击表头可对相应列进行升序/降序排序

### 5. 导出报表

点击 **"📥 导出汇总报表"** 按钮，选择保存位置导出Excel汇总文件

## Excel文件格式要求

- 文件扩展名：`.xlsx`
- 工作表名称：必须以 `USB记录` 开头
- 数据列：
  - 第1列：设备类型（需包含"大容量存储设备"）
  - 第2列：设备名称
  - 第3列：厂商
  - 第4列：序列号（SN）
  - 第7列：首次使用时间
  - 第8列：最后使用时间

## 项目结构

```
报告分析/
├── usb_tool.py          # 主程序源代码
├── usb_tool.spec        # PyInstaller打包配置
├── usbkey.txt           # 密钥文件
├── dist/                # 打包后的可执行文件目录
├── build/               # 打包过程中间文件
└── README.md            # 项目说明文档
```

## 打包说明

使用PyInstaller进行打包：

```bash
pyinstaller usb_tool.spec
```

生成的可执行文件位于 `dist` 目录

## 常见问题

**Q: 程序无法识别Excel文件？**  
A: 请确保Excel文件格式为 `.xlsx`，且包含名为"USB记录"的工作表

**Q: 导出的报表在哪里？**  
A: 点击导出时会弹出文件保存对话框，可自定义保存路径

**Q: 白名单可以保存吗？**  
A: 当前版本需手动输入，建议保存在独立文本文件中便于复制粘贴

## 许可证

本项目仅供内部使用

## 更新日志

### v1.0
- 初始版本发布
- 支持批量分析USB记录
- 双白名单机制
- 表格排序功能
- 导出Excel报表