系统软件清理工具

简介

扫描并清理 Windows 孤立软件与残留数据：注册表（系统 / 家庭用户）、 Program Files 目录、Winget / Scoop / Chocolatey 包管理器清单、 LOCALAPPDATA / APPDATA / PROGRAMDATA 应用数据多维度比对， 自动匹配「已装软件 ↔ 残留数据」，图形界面与命令行两种模式。 纯本地运行（Windows），核心逻辑仅用 Python 标准库，可选依赖增强 GUI 体验。

核心功能

• 多维度软件扫描：Windows 注册表（系统 / 家庭用户）、Program Files（x86 与 64 位）、 Winget / Scoop / Chocolatey 包管理器清单，支持自定义扫描路径。
• 应用数据扫描：LOCALAPPDATA / APPDATA / PROGRAMDATA 三个数据目录，支持自定义路径。
• 智能对比分析：字符串相似度模糊匹配已装软件与残留数据，按大小排序优先处理大目录。
• 安全清理：回收站删除（可恢复）、直接删除（需管理员权限）、演习模式（不实际删除，只分析）、批量选择。
• 权限管理：自动请求管理员权限；支持 icacls 强制修改权限后删除；PowerShell / CMD 快速启动入口。

使用说明

图形界面（推荐）：

• 双击运行 run_cleaner.bat 或 run_cleaner.ps1（需管理员权限）。
• 或在命令行执行 python main.py。

命令行常用组合：

# 基本扫描
python main.py --cli --scan

# 扫描并自动清理所有孤儿数据
python main.py --cli --scan --clean --auto

# 指定扫描路径
python main.py --cli --scan --custom-install D:\Programs --custom-appdata D:\AppData

# 演习模式（不实际删除）
python main.py --cli --scan --clean --dry-run

# 导出 / 导入报告
python main.py --cli --scan --export report.json
python main.py --cli --import report.json --clean

运行环境要求

• 操作系统：Windows 10 / 11
• Python：3.8+
• 权限：部分功能需要管理员权限
• 可选依赖（增强 GUI，不装也能跑核心）：psutil / send2trash / pywin32

注意事项

• 直接删除模式不可恢复，重要数据先走回收站删除或演习模式确认。
• 扫描注册表 / Program Files 需要管理员权限；家庭用户目录权限受限。

本地运行

Windows 本地运行步骤：

1. 安装 Python 3.8+（python.org，勾选 “Add Python to PATH”）。

2. 推荐用 uv 创建虚拟环境：

   # 安装 uv
   powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
   # 创建虚拟环境并安装可选依赖
   uv venv
   .venv\Scripts\python -m pip install psutil send2trash pywin32

3. 启动：双击 run_cleaner.bat / run_cleaner.ps1（需管理员权限），或 python main.py。