# 慧解

**Repository Path**: leyar/huijie

## Basic Information

- **Project Name**: 慧解
- **Description**: 智能解压压缩包工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-18
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 慧解（Huijie）

修复网盘「防在线解压」导致的压缩包命名伪装，并自动递归解压。

网盘对压缩包做在线解压拦截时，常会把文件名改写为「xxx(1).zip」「xxx.zip.下载」或插入干扰词。本工具通过**文件头魔数识别真实格式**，解析被伪装的文件名，还原为可被解压工具识别的规范命名（含分卷），然后自动递归解压（支持 zip / rar / 7z，含密码池尝试）。

## 功能特性

- **命名修复**：魔数识别真实格式，还原被伪装/干扰的文件名，支持 `z01` / `7z.001` / `part01.zip` 等分卷命名风格
- **递归解压**：自动嵌套解压到设定深度，支持 zip / rar / 7z（含加密包，密码池依次尝试）
- **右键菜单**：资源管理器选中文件/文件夹 →「慧解」→ 解压/扫描（Win11 新菜单 + Win10 经典菜单双轨）
- **解压弹窗**：独立的 `huijie-extract.exe` 进程显示进度与密码输入，不阻塞资源管理器
- **侦听模式**：`huijie-watch.exe` 开机自启，轮询目录自动修复并解压新出现的完整分卷组
- **一键自修复**：首次启动自动完成菜单注册、自启设置、证书与稀疏包安装（Win11），全程无需手动配置

## 项目结构

| 目录 | 产物 | 说明 |
|---|---|---|
| `src/` | `huijie.exe`（CLI）+ `huijie-watch.exe` | 核心库（修复/解压/密码/侦听）与命令行入口 |
| `src-tauri/` | `huijie-gui.exe` | 主界面（托盘 + 日志 + 设置），`requireAdministrator` 提权启动，含 Win11 证书/稀疏包自修复 |
| `src-extract/` | `huijie-extract.exe` | 右键解压独立弹窗进程（进度条、密码输入） |
| `huijie-shell/` | `huijie_shell.dll` | 右键菜单 COM 扩展（`IExplorerCommand`），Win10 下兼作经典菜单处理 |
| `ui/` | — | Tauri 前端页面（gui 与 extract 共用） |
| `sparse-pkg/` | — | Win11 稀疏包清单与图标（`include_bytes!` 内嵌源，不随包分发） |
| `tests/` | — | 命名修复与解压集成测试 |

## 构建

环境要求：Rust 稳定版（edition 2024）、MSVC 工具链。`.cargo/config.toml` 已配置 `crt-static`，产物不依赖 VC++ 运行库，单机零 DLL 分发。

```powershell
# 核心库 + CLI + watch（根目录）
cargo build --release

# 主界面 GUI
cargo build --release --manifest-path src-tauri\Cargo.toml

# 解压弹窗进程
cargo build --release --manifest-path src-extract\Cargo.toml

# 右键菜单 COM 扩展（cdylib）
cargo build --release --manifest-path huijie-shell\Cargo.toml
```

运行测试：

```powershell
cargo test
```

## 部署

只需拷贝 **4 个文件**（放同一目录）：

| 文件 | 大小 | 用途 |
|---|---|---|
| `huijie-gui.exe` | ~14 MB | 主界面（启动弹一次 UAC） |
| `huijie-extract.exe` | ~11 MB | 右键解压弹窗进程 |
| `huijie-watch.exe` | ~3 MB | 开机自启静默侦听 |
| `huijie_shell.dll` | ~0.3 MB | 右键菜单 COM 扩展 |

其余文件（`AppxManifest.xml`、`Assets\` 图标、证书 `huijie.cer`）均已内嵌在 `huijie-gui.exe` 中，首次启动自动写出并安装，**无需随包分发**。

### 首次启动差异

| 系统 | 启动行为 | 用户操作 |
|---|---|---|
| **Windows 11** | UAC → 后台自动安装证书 + 注册稀疏包 + 注册右键菜单（2~5 秒） | 点一次 UAC「是」 |
| **Windows 10** | UAC → 后台自动注册经典右键菜单（`ContextMenuHandlers`） | 点一次 UAC「是」 |

## 右键菜单架构（双轨）

- **Windows 11**：新式菜单（"Show more options" 折叠菜单）要求包标识，通过**稀疏包**（sparse package）提供 `AppxManifest.xml` 身份 + `fileExplorerContextMenus` 声明；菜单图标来自包内 `Assets\*.png`，子菜单图标来自 DLL 的 `GetIcon`
- **Windows 10**：经典菜单走注册表 `HKCU\Software\Classes\*\shellex\ContextMenuHandlers` 直接挂 COM 扩展，无需证书与包

注册脚本内置旧版（fixarc 时代）注册表键清理，升级/卸载无残留。