# Media-Crypt-Tool

**Repository Path**: ASD123-dsh/Media-Crypt-Tool

## Basic Information

- **Project Name**: Media-Crypt-Tool
- **Description**: 这是一个用于批量加密、解密及识别媒体文件（视频、音频、图片）的实用工具。提供图形化界面（GUI）和命令行脚本，支持断点恢复和操作前备份，确保数据处理的安全性与稳定性。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 媒体文件整合加密工具 (Media Crypt Tool)

这是一个用于批量加密、解密及识别媒体文件（视频、音频、图片）的实用工具。提供图形化界面（GUI）和命令行脚本，支持断点恢复和操作前备份，确保数据处理的安全性与稳定性。

## 📋 功能特性

*   **核心功能**:
    *   **加密**: 对文件数据进行混淆处理（原地修改）。
    *   **解密**: 还原被加密的文件。
    *   **扫描识别**: 智能识别目录下的文件是否已被加密（基于文件头 Magic Bytes 校验）。
*   **支持格式**: `.mkv`, `.rmvb`, `.mp4`, `.f4v`, `.avi`, `.mp3`, `.jpg`, `.jpeg`。
*   **安全机制**:
    *   **断点恢复**: 处理大文件时若意外中断（断电/崩溃），再次运行时可从断点处继续，避免文件损坏。
    *   **备份功能**: 支持在执行加密/解密前将文件备份到指定目录。
*   **操作界面**: 提供基于 PySide6 的图形界面，操作直观；同时保留独立命令行脚本。

## 🛠️ 环境依赖

*   Python 3.10+
*   依赖库: 见 `requirements.txt`

## 🚀 快速开始

### 1. 安装依赖

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

### 2. 准备密钥

在程序运行目录下创建一个名为 `key_file.txt` 的文件。程序将读取该文件的前 8 个字节并求和，作为加密/解密的密钥。

> **注意**: 请务必妥善保管您的 `key_file.txt`。如果丢失，已加密的文件将无法解密！

### 3. 运行程序

#### 图形界面 (推荐)

运行主程序启动 GUI：

```bash
python integrated.py
```

在界面中：
1.  选择 **根目录**（包含要处理的媒体文件）。
2.  确认 **密钥文件** 路径。
3.  点击 **扫描识别** 查看当前文件状态。
4.  选择 **加密** 或 **解密**（建议勾选“执行前备份”）。

#### 命令行工具

*   **加密**: `python encode.py` (自动扫描当前目录及子目录进行加密)
*   **解密**: `python decode.py` (自动扫描当前目录及子目录进行解密)
*   **识别**: `python code_num.py` (生成加密/未加密文件报告)

## 📦 打包发布 (Windows)

如果需要生成可执行文件 (.exe)，请使用 PyInstaller：

```bash
pyinstaller "AD整合加密-解密-扫描识别.spec"
```

编译完成后，可执行文件位于 `dist/` 目录下。

## ⚠️ 重要注意事项

1.  **原地修改风险**: 加密和解密操作均为**原地修改 (In-place)**。虽然程序包含断点恢复机制，但在处理重要数据前，**强烈建议开启备份选项**。
2.  **密钥一致性**: 必须使用加密时使用的同一个 `key_file.txt` 进行解密，否则文件将被破坏。
3.  **文件过滤**: 程序会自动跳过系统文件、脚本本身以及日志文件。

## 📂 项目结构

*   `integrated.py`: GUI 主程序入口。
*   `crypto_core.py`: 核心算法模块（封装了加密逻辑与断点恢复）。
*   `encode.py` / `decode.py`: 独立的加密/解密脚本。
*   `key_file.txt`: 密钥源文件。
*   `AD整合加密-解密-扫描识别.spec`: PyInstaller 打包配置。

---
**License**: MIT