# 清理工具

**Repository Path**: T_Salt/cleaning-tool

## 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-04-23
- **Last Updated**: 2026-10-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 牛马清理大师 (Cleaning Tool)

一款基于 Electron 构建的 Windows 系统深度清理与优化工具，致力于帮助用户释放磁盘空间、彻底卸载软件残留，以及精简开发者项目中的冗余依赖。

## 🌟 核心功能

### 1. 📦 软件卸载与清理
- **深度扫描**：读取 Windows 注册表，列出所有已安装的软件信息（版本、发布者、安装日期）。
- **常规卸载**：调用软件自带的卸载程序进行标准卸载。
- **强力清理**：类似 Geek Uninstaller 的强力模式。在软件常规卸载失败或卸载后，强制清理残留的安装目录、AppData 缓存文件夹以及注册表项。

### 2. 💾 磁盘瘦身
- **系统垃圾清理**：一键扫描并清理系统临时文件 (`C:\Windows\Temp`)、用户临时文件、Windows 更新缓存下载 (`SoftwareDistribution`) 以及清空回收站。
- **全盘无用文件扫描**：扫描其他盘符下的常见垃圾文件后缀（如 `.tmp`, `.log`, `.bak`, `.DS_Store` 等）并安全清理。
- **磁盘状态概览**：实时展示系统中各个磁盘的总容量和可用空间比例。

### 3. 💻 开发者 Node Modules 瘦身
- **依赖精简**：前端和 Node.js 开发者痛点解决。选择项目目录后，深度清理 `node_modules` 中无用的测试文件、Markdown 文档、示例代码等冗余文件，大幅释放硬盘空间，而不影响项目正常运行。

## 🛠️ 技术栈

- **框架**：[Electron](https://www.electronjs.org/) (JavaScript / HTML / CSS)
- **系统交互**：PowerShell (处理 Windows 注册表读取、静默卸载、深层文件删除)
- **主要依赖**：
  - `systeminformation`: 获取磁盘空间和系统信息
  - `fast-glob`: 高效扫描深层垃圾文件
  - `del` / `fs-extra`: 文件及目录的高效删除操作
  - `clean-modules`: 专门用于清理 `node_modules` 冗余的工具库
- **打包工具**：`electron-builder` (输出 NSIS 安装包)

## 🚀 快速开始

### 环境要求
- Windows 操作系统
- [Node.js](https://nodejs.org/) (建议 v16 及以上)
- 允许执行 PowerShell 脚本 (部分功能依赖 PowerShell)

### 安装依赖
```bash
# 克隆或下载本项目后，进入项目目录
npm install
```

### 运行开发环境
```bash
npm start
```

### 打包构建 (Windows)
```bash
npm run build
```
打包完成后，安装包将生成在 `dist/` 目录下（如：`牛马清理大师 Setup 1.0.1.exe`）。

## ⚠️ 注意事项
- **权限问题**：强力清理功能涉及注册表和系统目录操作，可能需要以管理员身份运行。
- **文件保护**：清理系统垃圾时，工具默认排除了 HTML 等可能被误删的项目文件，但执行**强力清理**时请务必确认操作目标。

## 📄 许可证
[ISC License](LICENSE) (参考 package.json)