# toolkit

**Repository Path**: xjldream/toolkit

## Basic Information

- **Project Name**: toolkit
- **Description**: 基于 Python 的实用工具集
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VDC 专业工具箱 v1.0

本项目为 VDC 工作流的各类实用小工具集合。经过工程化重构，提供统一的现代化 UI 入口，底层采用多线程处理和统一的错误管理机制，保障日常工作的稳定高效。

## 主要功能

- **📁 文件处理工具**
  - **批量修改扩展名**：一键递归修改文件夹中特定后缀名的文件，防覆盖机制保证数据安全。
  - **文件哈希计算器**：支持批量计算 MD5, SHA1, SHA256, SHA512，针对大文件采用分块读取，不会导致内存溢出。
  - **文件解压与重命名**：批量自动解压 ZIP, RAR, 7Z, TAR 等格式，可选择提取到同级目录或统一自定义目录，支持保留原始文件层级或扁平化重命名防冲突。
- **⚙️ 系统工具**
  - **文件占用检查**：使用 Windows Restart Manager API 及 `psutil`，精准检测被其他进程独占的文件或文件夹，支持一键终止占用进程。
- **📊 iCubeMotion工具**
  - **获取 Bcm Guid**：智能解析 BIM XML 文件中的 `ModelTree` 节点结构，提取叶子节点的 UUID 及分类路径，自动导出为 Excel 文件 (`.xlsx`)。

## 安装与运行

### 1. 环境准备

确保您的计算机上已安装 **Python 3.8+**。

### 2. 安装依赖

打开终端，在项目根目录下执行：

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

### 3. 启动工具箱

运行主入口文件：

```bash
python src/main.py
```

## 打包

### 1. 确保依赖已安装

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

### 2. 执行包命令

```bash
python build.py
```

### 3. 查看打包结果

打包完成后，会在项目根目录下生成 `dist/` 目录，包含可执行文件 `VDC专业工具箱.exe`。

### 4. 分发

将 `VDC专业工具箱.exe` 发送给其他用户即可。

## 工程架构

重构后的代码结构如下：

- `main.py`: 项目统一启动入口。
- `src/`: 源代码目录，包含业务逻辑与视图。
  - `src/ui/`: 包含主窗体框架 (`mainApp.py`)，及通用 UI 组件 (`components/`) 和各个工具的视图 (`views/`)。
- `src/core/`: 各工具脱离 UI 的核心业务逻辑，通过消息队列与前端进行安全通信。
- `src/utils/`: 通用工具库，如多线程管理器 `ThreadWorker`。
- `scripts/`: 包含需要在特定环境(如 Revit Dynamo)中直接独立运行的脚本（如 `GetGuid.py`）。

## 测试

本项目引入了 `pytest` 单元测试。
如果需要运行测试，请在项目根目录执行：

```bash
python -m pytest src/tests/
```