# DeleteCursorCache

**Repository Path**: HiHi_Peter/delete-cursor-cache

## Basic Information

- **Project Name**: DeleteCursorCache
- **Description**: 缓存删除工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cursor 缓存清理工具

一款简单易用的 macOS 工具，用于清理 Cursor 应用的缓存文件，释放磁盘空间。

![Version](https://img.shields.io/badge/version-1.0-blue.svg)
![Platform](https://img.shields.io/badge/platform-macOS-green.svg)
![License](https://img.shields.io/badge/license-MIT-lightgrey.svg)

## 功能特性

### 可清理的缓存类型

**浏览器缓存：**
- 代码缓存 - Code Cache
- GPU缓存 - GPUCache
- 图形缓存 - DawnGraphiteCache
- Cookie数据 - Cookies
- 会话存储 - Session Storage

**应用缓存：**
- 工作区缓存 - Workspace Storage
- 全局存储 - Global Storage
- 应用缓存 - Application Cache
- 历史记录 - History
- 日志文件 - Logs

### 核心功能

- ✅ **选择性清理** - 可选择性删除各类缓存，灵活自由
- ✅ **一键全选** - 全选/取消全选功能，操作便捷
- ✅ **大小显示** - 实时显示每个缓存的占用空间
- ✅ **安全删除** - 后台异步删除，不阻塞主线程
- ✅ **详细反馈** - 显示删除进度和详细的结果反馈
- ✅ **中文界面** - 完全中文化，易于使用
- ✅ **自动适配** - 自动识别用户路径，兼容所有 macOS 用户
- ✅ **现代化设计** - 美观的 SwiftUI 界面

## 快速开始

### 下载安装

#### 方法一：使用 DMG 安装包（推荐）

1. 从 [Releases](https://github.com/yourusername/cursor-cache-cleaner/releases) 下载最新版本的 `.dmg` 文件
2. 双击打开 DMG 文件
3. 将 `Cursor Cache Cleaner.app` 拖拽到 `应用程序` 文件夹
4. 启动应用（首次运行可能需要在"系统设置 > 隐私与安全"中允许）

#### 方法二：从源码构建

1. 克隆仓库
   ```bash
   git clone https://github.com/yourusername/cursor-cache-cleaner.git
   cd cursor-cache-cleaner
   ```

2. 在 Xcode 中打开项目
   ```bash
   open DeleteCursorCache.xcodeproj
   ```

3. 构建并运行
   - 按 `⌘R` 运行项目
   - 或使用 `Product > Archive` 创建发布版本

### 使用方法

1. **启动应用**
   - 从启动台或应用程序文件夹中打开 "Cursor 缓存清理工具"

2. **选择要清理的缓存**
   - 勾选你想删除的缓存类型
   - 点击"全选"快速选择所有缓存
   - 查看每个缓存的占用空间

3. **删除缓存**
   - 点击"删除选中的缓存"按钮
   - 等待删除完成（显示进度）
   - 查看删除结果

4. **完成**
   - 查看删除统计（成功/失败数量）
   - 查看每个项目的删除状态

## 系统要求

- macOS 12.0 或更高版本
- 具有管理员权限（用于删除系统目录文件）

## 兼容性

- ✅ 支持所有 macOS 用户（自动识别用户主目录）
- ✅ 使用动态路径获取，确保在不同用户环境下正常工作
- ✅ 无需手动配置路径

## 开发与打包

### 快速打包（推荐）

使用提供的脚本一键打包：

```bash
# 运行打包脚本
./create_dmg.sh
```

这将自动：
- 构建 Release 版本
- 创建 .app 文件
- 生成 DMG 安装包

输出文件：
- `Cursor缓存清理工具-v1.0.dmg` - DMG 安装包
- `build/Cursor缓存清理工具/Cursor缓存清理工具.app` - 应用程序

### 手动打包步骤

详细说明请参考 [打包指南.md](打包指南.md)

简要步骤：
1. 在 Xcode 中选择 `Product > Archive`
2. 在 Organizer 中点击 `Distribute App`
3. 选择导出方式并保存

### 分发应用

打包完成后：
- 直接共享 DMG 文件
- 或上传到 GitHub Releases
- 或通过其他渠道分发

📖 详细打包说明请查看 [打包指南.md](打包指南.md)

## 注意事项

⚠️ **重要提示：**

- **使用前关闭 Cursor** - 请在使用前确保已关闭 Cursor 应用，否则可能无法删除某些缓存文件
- **设置可能重置** - 删除后某些 Cursor 设置可能会重置，请谨慎操作
- **首次使用需授权** - 首次运行时，macOS 可能会提示访问权限，请点击"允许"
- **建议备份** - 删除前建议备份重要数据

## 技术实现

### 技术栈

- **UI 框架**: SwiftUI - 现代化、声明式界面
- **语言**: Swift
- **平台**: macOS 12.0+

### 核心技术

- 后台异步删除（不阻塞主线程）
- 动态路径获取（`NSHomeDirectory()`）
- 文件大小自动计算和格式化
- 完善的错误处理机制
- 实时状态反馈

### 目录结构

```
DeleteCursorCache/
├── CacheItem.swift              # 缓存数据模型和管理器
├── ContentView.swift            # 主界面视图
├── DeleteCursorCacheApp.swift   # 应用入口
├── DeleteCursorCache.entitlements  # 权限配置
└── Assets.xcassets/            # 资源文件
```

## 常见问题

### Q: 应用无法删除某些缓存？
A: 请确保已经完全关闭 Cursor 应用，包括 Dock 中的所有实例。

### Q: 删除后需要重启 Cursor 吗？
A: 是的，建议重启 Cursor 应用以使更改生效。

### Q: 删除缓存会影响我的项目文件吗？
A: 不会。这个工具只删除缓存文件，不会影响你的项目代码或工作区内容。

### Q: 可以撤销删除操作吗？
A: 不可以。一旦删除就无法恢复，请在删除前确认。

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！

## 作者

Created with ❤️ for Cursor users

---

**享受更快的 Cursor 体验！** 🚀