# fileTools

**Repository Path**: tan-jinling/fileTools

## Basic Information

- **Project Name**: fileTools
- **Description**: No description available
- **Primary Language**: Go
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 2
- **Created**: 2026-08-21
- **Last Updated**: 2026-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CleanDesk & Everything Search - 桌面整理、C盘清理、数据迁移与全盘极速秒搜系统

> 🚀 **纯原生 Windows 桌面独立软件（类似微信 / QQ 独立程序）**，基于 Go + Win32 原生窗口与 Apple macOS Sequoia 顶级设计系统开发。无需依赖外部浏览器打开，双击即用，无黑色命令行黑框，内置现代化高分辨率应用 Logo 图标与版本信息。

---

## 🌟 核心特性一览

### 1. 🔍 Everything 全盘极速文件秒搜
- **全盘 6 盘多协程并发直读引擎**：
  - 支持 `C:`, `D:`, `E:`, `F:`, `G:`, `H:` 等所有驱动器多协程并发毫秒级检索。
  - 两阶段分级秒搜机制：顶层与关键软件目录 **< 300ms 瞬间就绪**，深层目录静默后台流式写入，完全不卡界面！
- **毫秒级内存检索内核**：
  - 紧凑型扁平内存结构，百万级文件仅占用约 25MB 内存，单次查询响应时间 **< 2ms**。
- **全套 Everything 专业搜索语法**：
  - 🧩 **多词空格匹配**：空格代表同时包含（如 `百度网盘 pdf`、`report 2026 docx`）。
  - ⛔ **排除匹配**：`-tmp` 或 `!temp` 排除包含该词的项目。
  - 🏷️ **后缀与通配符**：`*.png`、`ext:zip;rar;7z`、`test_??.go`。
  - 📏 **文件大小区间**：`size:>100mb`、`size:<50kb`、`size:10mb-50mb`。
  - 📁 **类型与路径过滤**：`folder:`、`file:`、`path:Windows\System32`。
  - ⚡ **正则表达式与开关**：支持区分大小写 (`Aa`)、全字匹配 (`\b`)、完整路径匹配 (`📂`) 与正则表达式 (`.*`)。
- **丝滑流畅交互与系统联动**：
  - 🖱️ **单击路径列**：直接调起 Windows 资源管理器**打开该文件所在文件夹**。
  - 🖱️ **双击整行 / 单击文件名**：直接**打开/运行该文件**。
  - 📁 **资源管理器定位**：在资源管理器中**定位并选中该文件**。
  - 🏷️ **盘符高亮角标**：`[C:]` `[D:]` `[E:]` `[F:]` `[G:]` `[H:]` 一目了然。
  - 📋 **一键复制完整路径 / 复制文件名**。
  - 🗑️ **安全移至 Windows 回收站**。
  - 📥 **搜索结果一键导出为 CSV 表格**。
  - ⌨️ **快捷键支持**：`Ctrl+F` 快速聚焦搜索框、`↑/↓` 切换行、`Enter` 运行、`Esc` 清空。

---

### 2. 🗂️ Windows 桌面杂乱应用与文件智能整理
- **全桌面深度扫描**：自动聚合分析当前用户桌面 (`%USERPROFILE%\Desktop`)、公共桌面 (`C:\Users\Public\Desktop`) 及 OneDrive 同步桌面。
- **LNK 快捷方式解析与死链检测**：纯 Go 原生解析 `.lnk` 目标路径、运行参数，自动标记已经卸载但残留的**无效死链图标**。
- **智能 10 大专业分类归纳**：
  - **图像类** (`.jpg`, `.png`, `.webp`, `.psd`, `.ai`, `.raw`, `.svg` 等) ➡ `图像与设计素材`
  - **视频类** (`.mp4`, `.mkv`, `.mov`, `.avi`, `.flv`, `.ts` 等) ➡ `视频与影视素材`
  - **音频类** (`.wav`, `.flac`, `.ape`, `.mp3`, `.aac`, `.midi` 等) ➡ `音频与音乐乐谱`
  - **文档与文本类** (`.docx`, `.xlsx`, `.pptx`, `.pdf`, `.txt`, `.md`, `.wps`, `.ofd` 等) ➡ `办公文档与电子书`
  - **压缩与磁盘镜像** (`.zip`, `.rar`, `.7z`, `.tar`, `.iso`, `.dmg` 等) ➡ `压缩包与磁盘镜像`
  - **程序与代码工程** (`.exe`, `.msi`, `.bat`, `.py`, `.go`, `.java`, IDE开发快捷方式) ➡ `程序与代码工程`
  - **数据与结构化文件** (`.csv`, `.sql`, `.sqlite`, `.json`, `.xml`, `.parquet` 等) ➡ `数据与数据库`
  - **网页与网络** (`.html`, `.css`, `.url`, `.desktop` 书签) ➡ `网页与网络书签`
  - **工程设计** (`.dwg`, `.dxf`, `.stl`, `.obj`, `.blend`, `.c4d`, `.max`, CAD快捷方式) ➡ `工程设计与3D模型`
  - **字体与系统** (`.ttf`, `.otf`, `.dll`, `.sys`, `.ini`, `.reg` 等) ➡ `字体与系统配置`
- **两种整理模式**：
  - **分类文件夹归类模式**：一键在桌面生成对应的分类文件夹，将杂乱图标与文件秒级分拣归类。
  - **桌面抽屉 / 快速启动看板模式**：在软件内提供分类快捷启动看板，保持物理桌面干干净净。
- **一键撤销还原**：每次整理自动生成时间戳快照，可在「最近快照」与「历史与审计」中随时一键将所有文件完整恢复回原始桌面位置！


---

### 3. 🧹 全盘垃圾文件清理与严格人为审核 (Human-in-the-Loop)
- **多驱动器全盘扫描**：支持 C:, D:, E:, F:, G:, H: 等所有盘符并发扫描。
- **真实文件名解析**：集成 **Windows 回收站 `$I` 索引解析器**，精准提取并显示被删文件**在删除前的真实原始文件名与所在目录**。
- **规则覆盖库**：
  - 系统与用户临时文件 (`Windows\Temp`, `AppData\Local\Temp`)
  - Windows Update 已安装补丁的历史下载包 (`SoftwareDistribution\Download`)
  - 系统崩溃转储与错误报告 (`Minidump`, `WER`)
  - 主流浏览器网页高速缓存 (Chrome, Edge, Firefox, Brave, 360 等)
  - 开发者与包管理缓存 (`npm`, `pip`, `gradle`, `go-build`, `nuget` 等)
  - 系统与软件冗余日志 (`*.log`, `*.bak`, `*.old`, `*.dmp`)
  - 驱动器回收站 (`$Recycle.Bin`)
- **三级安全风险评级**：
  - 🟢 **安全清理 (Safe)**：100% 临时缓存，清理无风险，默认预勾选。
  - 🟡 **建议确认 (Caution)**：开发编译缓存、错误转储，按需清理。
  - 🔴 **谨慎操作 (Warning)**：回收站文件，需人工确认后清理。
- **人为审核确认机制**：
  - 支持按盘符过滤、按风险评级过滤、关键词搜索、明细路径查看。
  - **双重审核弹窗**：显示拟清理项目总数、释放体积、涉及盘符清单。
  - 可自主选择 **「移至 Windows 回收站 (安全可恢复)」** 或 **「直接永久删除」**。
  - 提供实时进度条与操作日志控制台。

---

### 4. 🚀 大文件与重度应用数据迁移 (NTFS Directory Junction 技术)
- **重度应用数据智能探测**：
  - 微信电脑版聊天与离线文件 (`Documents\WeChat Files`，常占数十GB)
  - QQ / TIM 离线多媒体缓存 (`Documents\Tencent Files`)
  - 用户下载目录 (`Downloads`)、文档目录 (`Documents`)
  - Android SDK、Gradle 依赖缓存
  - WSL2 / Docker 虚拟硬盘镜像 (`ext4.vhdx`)、VirtualBox 虚拟机文件 (`.vdi`)
  - 自定义任意大文件夹深度探测
- **NTFS 目录联接点 (Junction `mklink /J`) 核心技术**：
  - 将数据高速迁移到目标大容量磁盘（如 `D:\MigratedAppData\...`）并进行数据完整性校验。
  - 在原路径自动建立 NTFS Directory Junction 联接点。
  - **优势**：微信、QQ 等软件依然按原路径读写，**完全无需修改软件设置，程序无感知正常运行**，彻底拯救 C 盘空间！
- **人为审核与一键回滚**：
  - 迁移前对比源盘与目标盘剩余容量。
  - 必须由用户审核确认后方可启动迁移。
  - 实时显示传输文件数、已传输体积、传输速度 (MB/s)。
  - 提供历史迁移记录，支持**一键解除联接并无损迁回原盘**。

---

## 🛠️ 运行与构建

- **直接运行**：双击 `clean-desk-migrator.exe` 或运行 `run.bat`。
- **一键重新编译**：双击运行 `build.bat`。包含了所有前端静态资源、Windows 图标与版本资源，为纯单文件可执行程序，可直接分发给任何 Windows 10/11 用户使用。