Skip to content

songlipeng2003/DevCleaner

Repository files navigation

DevCleaner

License Tauri Vue.js Rust

专为开发者设计的跨平台磁盘清理工具
一站式扫描并清理各类开发工具缓存,释放宝贵的磁盘空间

特性支持工具快速开始使用方法开发指南贡献


✨ 特性

特性 说明
🛠️ 开发者专属 深度覆盖 15+ 开发工具缓存,理解开发者工作流
🌐 跨平台支持 原生支持 macOS、Windows 11、Linux
🔒 安全优先 智能白名单策略 + 清理前确认,避免误删重要文件
🤖 自动化 定期扫描 + 阈值通知,保持系统整洁
📊 可视化分析 直观的图表展示磁盘使用情况
高性能 Rust 后端驱动,快速扫描和清理
🎯 精准清理 支持按工具、按时间、按大小筛选清理目标

📋 支持的工具

类别 工具 清理内容
包管理器 npm / yarn / pnpm 全局缓存、_cacache、下载包
容器 Docker 镜像、容器、卷、构建缓存
iOS/macOS Xcode DerivedData、Archives、设备支持文件、SPM 缓存
包管理器 Homebrew 下载缓存、Cellar、日志
Python pip / conda / venv pip 缓存、__pycache__、虚拟环境
Ruby Ruby gems gem 缓存、Bundler 缓存、Rails 临时文件
Java Maven / Gradle 本地仓库、Wrapper 发行版、构建缓存
iOS 依赖 CocoaPods / Carthage 本地仓库、构建缓存
游戏开发 Unity 编辑器缓存、日志、下载缓存

🚀 快速开始

系统要求

系统 要求
macOS 10.15+ (Catalina 及以上)
Windows Windows 11 或 Windows 10 (1809+)
Linux 支持 GTK3 的发行版 (Ubuntu 20.04+, Fedora 33+ 等)
内存 4GB RAM (推荐 8GB+)
磁盘空间 200MB 可用空间

安装

下载预编译版本

访问 Releases 页面 下载对应平台的安装包。

从源码构建

# 克隆仓库
git clone https://github.com/songlipeng2003/devcleaner.git
cd devcleaner

# 安装前端依赖
npm install

# 安装 Rust 工具链 (如果未安装)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 开发模式运行
npm run tauri dev

# 构建应用
npm run tauri build

🖥️ 使用方法

首次使用

  1. 启动 DevCleaner 应用
  2. 应用会自动检测系统中已安装的开发工具
  3. 点击「开始扫描」按钮,扫描所有支持的缓存目录
  4. 查看扫描结果,按工具、大小、最后访问时间排序

扫描选项

  • 快速扫描:扫描常用工具的缓存目录
  • 深度扫描:扫描所有支持的工具,包括项目级缓存
  • 自定义扫描:选择特定工具进行扫描

清理选项

  • 安全清理:仅清理已知安全的缓存文件
  • 深度清理:清理所有可安全删除的缓存(包括较旧的文件)
  • 自定义清理:手动选择要清理的项目

自动化设置

  • 定期扫描:设置每日/每周自动扫描
  • 磁盘阈值:当磁盘空间低于指定阈值时自动提醒
  • 排除列表:添加需要排除的目录或文件

⚙️ 配置

配置文件位置

系统 路径
macOS ~/Library/Application Support/devcleaner/config.json
Windows %APPDATA%\devcleaner\config.json
Linux ~/.config/devcleaner/config.json

配置示例

{
  "scan": {
    "interval": "weekly",
    "deepScan": false,
    "excludedPaths": [
      "~/projects/important-cache",
      "/usr/local/opt"
    ]
  },
  "clean": {
    "strategy": "safe",
    "keepDays": 30,
    "confirmBeforeClean": true
  },
  "notifications": {
    "enabled": true,
    "thresholdGB": 10
  }
}

🛠️ 开发指南

项目结构

devcleaner/
├── src/                    # 前端源码 (Vue 3 + TypeScript)
│   ├── components/         # Vue 组件
│   ├── views/             # 页面视图
│   ├── stores/             # Pinia 状态管理
│   └── assets/             # 静态资源
├── src-tauri/              # Tauri 后端 (Rust)
│   ├── src/                # Rust 源码
│   ├── providers.json      # 工具提供者配置
│   └── Cargo.toml          # Rust 依赖配置
├── tests/                  # 测试文件
└── scripts/                # 构建和部署脚本

开发环境设置

# 1. 安装 Node.js (v18+)
# 2. 安装 Rust (通过 rustup)
# 3. 安装 Tauri CLI
npm install -g @tauri-apps/cli

# 4. 安装项目依赖
npm install

# 5. 启动开发服务器
npm run tauri dev

添加新的工具支持

  1. src-tauri/providers.json 中添加新的工具配置
  2. 配置工具的 ID、名称、图标和清理路径
  3. 前端会自动读取配置并显示新的工具

运行测试

# 运行单元测试
npm run test:unit

# 运行端到端测试
npm run test:e2e

# 运行 Rust 测试
cd src-tauri && cargo test

🤝 贡献

欢迎各种形式的贡献!

  1. 报告问题:通过 GitHub Issues 报告 bug 或提出功能建议
  2. 提交 Pull Request
    • Fork 本仓库
    • 创建功能分支 (git checkout -b feature/amazing-feature)
    • 提交更改 (git commit -m 'Add some amazing feature')
    • 推送到分支 (git push origin feature/amazing-feature)
    • 开启 Pull Request

开发规范

  • 代码风格:遵循各语言的官方代码风格指南
  • 提交信息:使用约定式提交 (Conventional Commits)
  • 测试:新功能需要包含相应的测试用例
  • 文档:更新相关文档和 README

📄 许可证

本项目基于 MIT 许可证 开源。

🙏 致谢

  • Tauri - 优秀的跨平台桌面应用框架
  • Vue.js - 渐进式 JavaScript 框架
  • Ant Design Vue - 企业级 UI 组件库
  • Rust - 安全可靠的系统编程语言

📞 支持与反馈


Made with ❤️ for developers everywhere

About

专为开发者设计的跨平台磁盘清理工具

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors