# pc-clean

**Repository Path**: kiddzs/pc-clean

## Basic Information

- **Project Name**: pc-clean
- **Description**: AI辅助磁盘清理
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PC Clean - AI 辅助磁盘清理工具

一款基于 **WPF + .NET 8** 的 Windows 10/11 AI 辅助磁盘清理工具，采用 MVVM 架构，支持多级别清理、AI 智能决策、大文件/重复文件分析、AppData 空间分析、备份还原等功能。

## 功能特性

- **多级别清理** — 清理项按风险等级分为六级：安全 / 常规 / 深度 / 办公软件 / 云盘 / 开发工具
- **AI 智能决策** — 集成 AI 服务，辅助判断大文件/AppData 目录是否可安全清理，提供智能清理建议
- **大文件分析** — 全盘/指定目录扫描，可配置阈值，支持按类型筛选与快速操作
- **重复文件分析** — 三级递进匹配（大小分组 → 头哈希 → SHA256 全量校验），智能分组展示
- **AppData 空间分析** — 扫描 Local / Roaming / LocalLow 三区域，按应用维度统计占用
- **备份与还原** — 高风险操作前自动备份，支持选择性还原与定期清理
- **进程冲突检测** — 扫描时自动检测关联应用是否运行，提示用户关闭后再清理
- **扫描引擎热插拔** — 引擎以独立 DLL 加载，支持运行时动态替换升级（Shadow Copy + WeakReference 验证）
- **自动更新** — 基于 Gitee 仓库的整包升级 + 策略/规则/引擎组件增量更新，启动时静默检查

## 技术栈

| 项目 | 技术 |
|------|------|
| 框架 | .NET 8 + WPF |
| 架构模式 | MVVM（CommunityToolkit.Mvvm） |
| 依赖注入 | Microsoft.Extensions.DependencyInjection |
| 引擎隔离 | AssemblyLoadContext（可回收、热插拔） |
| AI 服务 | OpenAI 兼容接口（百炼 MaaS） |
| UI 风格 | 现代扁平化深色/浅色主题 |

## 项目结构

```
src/
├── PCClean.App/          # WPF 主程序（Views、ViewModels、样式、引擎宿主）
├── PCClean.Core/         # 契约层（模型、服务接口、分析器）
├── PCClean.Engine/       # 可热插拔扫描/清理引擎（清理器、规则、策略）
└── PCClean.Core.Tests/   # 单元测试
update.json               # Gitee 升级清单（整包 + 组件版本）
```

## 自动更新机制

基于 Gitee 仓库 raw 文件驱动，无需额外服务器：

| 更新类型 | 说明 |
|----------|------|
| 整包升级 | 比对 `update.json` 中 `version`，下载完整安装包执行静默安装 |
| 策略增量 | 下载最新策略 JSON → `%AppData%\PCClean\Strategies\`，下次扫描自动生效 |
| 规则增量 | 下载最新规则 JSON → `%AppData%\PCClean\Rules\`，同 ID 覆盖内置规则 |
| 引擎增量 | 下载新版 Engine DLL → 替换 `Engine\PCClean.Engine.dll`，支持热重载 |

- 启动时静默检查（受设置页“启动时检查更新”/“每24小时检查”开关控制）
- “关于”页面支持手动检查 + 一键下载更新

## 构建与运行

### 环境要求

- Windows 10/11
- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)

### 构建

```bash
dotnet build PCClean.slnx
```

### 运行

```bash
dotnet run --project src/PCClean.App
```

> 注意：注册表清理、系统文件清理等功能需要**管理员权限**运行。

## 清理等级说明

| 等级 | 说明 | 风险 |
|------|------|------|
| 安全清理 | 临时文件、缩略图缓存、回收站、日志等 | 无风险 |
| 常规清理 | Windows Update 缓存、浏览器缓存、Prefetch 等 | 一般安全 |
| 深度清理 | 注册表无效项、旧系统安装、应用残留 | 需谨慎 |
| 办公软件 | Office/WPS/微信/钉钉等缓存 | 可选 |
| 云盘缓存 | OneDrive/Dropbox/百度网盘等缓存 | 可选 |
| 开发工具 | npm/NuGet/pip/Docker/IDE 缓存等 | 可选 |

## 安全设计

- 所有删除操作 try-catch 保护，跳过被占用文件
- 系统关键目录（Windows、Program Files 等）默认排除
- 微信/QQ 严禁清理聊天记录数据库
- IDE 缓存仅清理 Cache/logs，不触碰用户设置与扩展
- 高风险操作前自动备份，支持一键还原
- 删除操作默认移入回收站

## 许可证

本项目基于 [MIT 许可证](LICENSE) 开源——你可以自由使用、修改和分发，但需保留版权声明。