zidankhainur2/download-organizer-pro

# 下载 Organizer Pro      ## 功能 - **原生 WPF 桌面 GUI**：精巧的深色模式界面 (`Show-OrganizerGUI`)，包含目标文件夹浏览器、一键操作按钮、实时 KPI 摘要卡片、可排序的 DataGrid 以及实时控制台流。 - **独立可执行文件构建流水线 (`build.ps1`)**：编译为单个 `dist/DownloadOrganizerPro.exe` 二进制文件，带有自定义应用程序图标 (`assets/app.ico`) 且无控制台窗口开销 (`-noConsole`)。 - **分类整理**：按扩展名将文件自动整理到专属的分类文件夹中（`Documents`、`Images`、`Archives`、`Code`、`Applications` 等）。 - **智能关键词分类**：基于优先级加权的文件关键词规则进行子分类排序（例如 `Resume.pdf` -> `Documents/CV`）。 - **SHA256 重复文件检测**：通过文件大小进行预过滤，并比较 SHA256 校验和以标记重复下载的文件。 - **撤销操作**：带有事务日志的移动操作支持立即将文件恢复到原始目录。 - **Dry Run 模拟模式**：在不更改磁盘内容的情况下测试分类和目标规则 (`-DryRun`)。 - **实时文件夹监听器**：自动化的 `FileSystemWatcher` 文件夹监控，支持文件写入防抖 (`-Watcher`)。 - **Task Scheduler 支持**：原生 Windows 计划任务注册，支持自动化后台运行。 - **丰富的 HTML 仪表板报告**：独立的深色模式 HTML 报告，包含 KPI 卡片、分类细分表格和操作状态。 - **多格式导出**：将结果导出为 CSV、JSON 或交互式 HTML 仪表板 (`-ExportCSV`、`-ExportJSON`、`-ExportHTML`)。 - **Config 驱动架构**：通过带有严格 schema 验证的 `config.json` 进行完全自定义。 - **100% 模块化 PowerShell 5.1 代码库**：强类型领域模型，零外部依赖，兼容 strict 模式。 ## 快速启动与使用 ### 选项 1：双击启动桌面 GUI（Windows 用户） 双击 `Run-GUI.bat` 或运行 `dist/DownloadOrganizerPro.exe`。 ### 选项 2：PowerShell 终端 GUI ``` .\DownloadOrganizer.ps1 -GUI ``` ### 选项 3：命令行 (CLI) 模式 ``` # 基本组织运行 .\DownloadOrganizer.ps1 # 模拟运行 .\DownloadOrganizer.ps1 -DryRun # 递归文件夹扫描 .\DownloadOrganizer.ps1 -Recurse # 撤销上次移动操作 .\DownloadOrganizer.ps1 -Undo # 实时文件夹监视器 .\DownloadOrganizer.ps1 -Watcher # 导出 HTML & CSV 报告 .\DownloadOrganizer.ps1 -ExportHTML -ExportCSV ``` ### 选项 4：编译独立可执行文件 ``` .\build.ps1 ``` ## 文件夹结构示例 **整理前：** ``` Downloads/ ├── Resume_2026.pdf ├── setup_installer.exe ├── vacation_photo.jpg ├── project_backup.zip └── financial_report.xlsx ``` **整理后：** ``` Downloads/ ├── Documents/ │ ├── CV/ │ │ └── Resume_2026.pdf │ └── financial_report.xlsx ├── Applications/ │ └── setup_installer.exe ├── Images/ │ └── vacation_photo.jpg └── Archives/ └── project_backup.zip ``` ## 仓库结构 ``` DownloadOrganizerPro/ ├── DownloadOrganizer.ps1 # Main Entry Point (CLI & GUI Auto-Launcher) ├── Run-GUI.bat # One-Click Windows Batch Launcher ├── build.ps1 # Automated PS2EXE Executable Compiler ├── config.json # Application Configuration ├── assets/ # Project Branding & App Icon (app.ico) ├── modules/ # Modular Domain Engine (15 Modules) │ ├── Models.psm1 # Domain Entities (OrganizerFile, OrganizerSummary) │ ├── Utils.psm1 # Helper Functions & Hash Calculator │ ├── Validation.psm1 # Schema & Path Validation │ ├── Config.psm1 # Config Parser │ ├── Scanner.psm1 # Directory Scanner & Filter │ ├── Classifier.psm1 # Extension Classifier │ ├── SmartClassifier.psm1 # Keyword Rule Classifier │ ├── DuplicateDetector.psm1 # SHA256 Duplicate Detector │ ├── Mover.psm1 # File Mover & Transaction Logger │ ├── Logger.psm1 # Logger │ ├── Summary.psm1 # Execution Summary Calculator │ ├── Undo.psm1 # Transaction Manifest Undo Engine │ ├── Watcher.psm1 # FileSystemWatcher Real-Time Monitor │ ├── Scheduler.psm1 # Windows Task Scheduler Integrator │ ├── ReportGenerator.psm1 # CSV, JSON & HTML Report Engine │ └── GUI.psm1 # Native WPF Desktop GUI Module ├── tests/ # Pester Unit & Integration Suite │ ├── Unit/ # 14 Dedicated Unit Test Files (49 Test Cases) │ └── run_test.ps1 # Integration Test Runner ├── docs/ # Architectural & Design Documentation │ ├── GUI_GUIDE.md # Desktop GUI User Guide │ └── BUILD_GUIDE.md # Executable Build & Compilation Guide ├── dist/ # Release Binary Distribution Package └── README.md ``` ## 环境要求 - Windows 10 / 11 / Server - PowerShell 5.1 或更高版本（兼容 PowerShell Core 7+） ## 安装与设置 1. **克隆仓库**： git clone https://github.com/zidankhainur2/DownloadOrganizerPro.git cd DownloadOrganizerPro 2. **运行单元和集成测试**： Invoke-Pester .\tests\Unit .\tests\run_test.ps1 3. **启动 GUI / 编译可执行文件**： .\Run-GUI.bat .\build.ps1 ## 文档 完整的架构设计和用户指南可在 [docs/](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/) 目录中找到： - [桌面 GUI 用户指南 (GUI_GUIDE.md)](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/GUI_GUIDE.md) - [可执行文件构建指南 (BUILD_GUIDE.md)](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/BUILD_GUIDE.md) - [产品需求文档 (PRD.md)](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/PRD.md) - [架构文档 (ARCHITECTURE.md)](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/ARCHITECTURE.md) - [配置指南 (CONFIGURATION.md)](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/CONFIGURATION.md) - [风格与编码规范 (STYLEGUIDE.md)](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/STYLEGUIDE.md) - [测试指南 (TESTING.md)](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/docs/TESTING.md) ## 贡献 欢迎贡献代码！在提交 pull request 之前，请查阅 [CONTRIBUTING.md](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/CONTRIBUTING.md) 和 [CODE_OF_CONDUCT.md](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/CODE_OF_CONDUCT.md)。 ## 许可证 本项目基于 [MIT 许可证](file:///c:/Users/zidan/Desktop/Coding/PROJEK/DownloadOrganizerPro/LICENSE) 授权 - Copyright (c) 2026 zidankhainur。

标签：AI合规, IPv6, Libemu, PowerShell, SHA256校验, WPF, 多人体追踪, 文件整理, 桌面工具, 网络调试, 自动化