# ai-cleaner

**Repository Path**: mooremok/ai-cleaner

## Basic Information

- **Project Name**: ai-cleaner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Cleaner

一款基于 **Wails**（Go + WebView2）的桌面清理工具，专注于清理 AI 开发工具（Cursor、Claude Code、GitHub Copilot 等）产生的可移除数据，以及 Windows 用户数据目录的扫描与清理。

## 特性

### AI 工具清理
- 自动识别常用 AI 编程工具的可清理数据：缓存、对话历史、日志、临时文件、索引数据、崩溃报告
- 支持跨平台：Windows / macOS / Linux
- 内置插件覆盖：Cursor、Claude Code、GitHub Copilot、Codeium、Tabnine、JetBrains AI、Windsurf、Cline、Continue 等

### 用户数据扫描
- 扫描 `%APPDATA%`（Roaming）与 `%LOCALAPPDATA%`（Local）一级子目录
- 按占用大小倒序排列
- 多选批量删除（带路径穿越防护）

### 通用文件浏览器
- 双击进入任意子目录
- 右键菜单：
  - 目录：进入 / 打开电脑上的位置 / 删除目录及所有内容
  - 文件：打开电脑上的位置 / 删除文件
- 显示文件名后缀、修改时间、创建时间、占用大小
- 支持面包屑跳转与全屏切换

### 其他
- 实时磁盘监控与历史趋势图
- 深色赛博风 UI（荧光绿主题）
- 清理前自动风险分级（安全 / 中等 / 危险）

## 技术栈

| 层级 | 技术 |
| --- | --- |
| 桌面框架 | Wails v2.12.0 |
| 后端 | Go 1.21+ |
| 前端 | React 18 + TypeScript + Vite |
| 样式 | Tailwind CSS 3 |
| 桌面运行时 | Windows WebView2 |

## 项目结构

```
cleaner_for_ai/
├── app.go                      # Wails 入口，绑定前端方法
├── main.go                     # 程序入口
├── internal/
│   ├── scanner/                # 扫描器
│   ├── cleaner/                # 清理器
│   ├── plugins/                # 清理插件（Cursor、Claude、通用工具）
│   ├── monitor/                # 实时磁盘监控
│   └── storage/                # 快照与设置存储
├── frontend/
│   └── src/
│       ├── App.tsx             # 侧边栏导航主框架
│       ├── components/         # UI 组件（ScanList / AppDataScanner / FileBrowser / Dashboard ...）
│       └── assets/             # Logo 与图标
├── build/
│   ├── appicon.png             # 应用图标
│   └── windows/icon.ico        # Windows 任务栏图标
├── wails.json                  # Wails 项目配置
└── README.md
```

## 开发

### 环境要求

- Go 1.21+
- Node.js 18+
- Wails CLI v2.12.0+

```powershell
go install github.com/wailsapp/wails/v2/cmd/wails@latest
```

### 开发模式（热重载）

```powershell
# 必须在项目根目录执行，且指定平台（默认 386 在 Windows 下会崩溃）
wails dev -platform windows/amd64
```

启动后会打开桌面应用窗口，同时 Vite 在 `http://localhost:34115` 提供浏览器调试入口。

### 构建生产包

```powershell
# 必须显式指定 amd64
wails build -platform windows/amd64
```

产物路径：`build/bin/ai-cleaner.exe`

## 配置

编辑 `wails.json` 调整项目元信息（名称、输出文件名、作者等）。前端开发服务器、Vite 构建、依赖安装命令也在该文件中定义。

## 常见问题

### 启动崩溃
Windows 默认构建目标为 386，存在并发 GC 崩溃问题。必须显式 `-platform windows/amd64`。

### 任务栏图标未更新
修改 `build/appicon.png` 后需同步重新生成 `build/windows/icon.ico`（256×256 内嵌 PNG）。

## License

MIT