# package-clearup-tool

**Repository Path**: dcren/package-clearup-tool

## Basic Information

- **Project Name**: package-clearup-tool
- **Description**: 清理 npm / Yarn / pnpm / pip / Poetry / uv / Conda / Maven / Gradle / Cargo / Go / Composer / NuGet 仓库的小工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 包清理工具 (package-clearup-tool)

一个跨平台的桌面应用程序，用于清理各种编程语言包管理器的缓存。

## 支持的包管理器

| 语言生态 | 包管理器 | 缓存路径 | 备注 |
|---------|---------|---------|------|
| **JavaScript** | npm | `~/.npm` | Node.js 默认包管理器 |
| | Yarn | `~/.cache/yarn` | Facebook 推出的包管理器 |
| | pnpm | `~/.cache/pnpm` | 高效磁盘利用的包管理器 |
| **Python** | pip | `~/.cache/pip` | Python 默认包管理器 |
| | Poetry | `~/.cache/pypoetry` | Python 依赖管理工具 |
| | uv | `~/.cache/uv` | 高性能 Python 包管理器 |
| | Conda | `~/conda pkgs` | Anaconda/Miniconda 包缓存 |
| **JVM** | Maven | `~/.m2/repository` | Apache 构建工具 |
| | Gradle | `~/.gradle/caches` | 构建自动化工具 |
| **.NET** | NuGet | `~/.nuget/packages` | Microsoft 包生态系统 |
| **Go** | Go | `$GOPATH/pkg/mod` | Go 模块缓存 |
| **PHP** | Composer | `~/.cache/composer` | PHP 依赖管理 |
| **Rust** | Cargo | `~/.cargo/registry/cache` | Rust 包管理器 |
| **自定义** | 自定义管理器 | 用户配置路径 | 支持用户添加自定义包管理器 |

## 功能特性

- **多平台支持**: Windows、macOS、Linux
- **一键清理**: 快速清除各包管理器的缓存文件
- **自定义管理**: 支持添加和配置自定义包管理器
- **实时统计**: 显示缓存大小、文件数量等信息
- **安全清理**: 清理前预览、确认对话框保护
- **命令检测**: 自动检测各包管理器命令是否可用

## 软件架构

本项目采用 Tauri 框架构建，结合 Rust 后端和 Vue.js 前端：

```
package-clearup-tool/
├── src/                    # Vue.js 前端源码
│   ├── components/         # Vue 组件
│   ├── api/                # API 接口定义
│   ├── types/              # TypeScript 类型定义
│   ├── App.vue             # 主应用组件
│   ├── main.ts             # 应用入口
│   └── style.css           # 全局样式
├── src-tauri/              # Rust 后端源码
│   ├── src/
│   │   ├── main.rs         # 程序入口
│   │   └── lib.rs          # Tauri 命令实现
│   └── managers/           # 包管理器模块
│       ├── common.rs       # 公共结构体和工具函数
│       ├── javascript.rs   # npm/Yarn/pnpm 实现
│       ├── python.rs       # pip/Poetry/uv/Conda 实现
│       ├── jvm.rs          # Maven/Gradle 实现
│       ├── golang.rs       # Go 实现
│       ├── php.rs          # Composer 实现
│       ├── rust.rs         # Cargo 实现
│       ├── dotnet.rs       # NuGet 实现
│       └── custom.rs       # 自定义管理器实现
├── index.html              # HTML 入口
└── package.json            # 前端依赖配置
```

### 技术栈

- **前端**: Vue 3 + TypeScript + Vite
- **后端**: Rust + Tauri
- **UI 框架**: 原生 CSS (包含完整的主题样式)

## 安装教程

### 方式一：预编译二进制

从 [Gitee Releases](https://gitee.com/dcren/package-clearup-tool/releases) 下载对应平台的安装包：

- **Windows**: `.exe` 安装包或 `.msi`
- **macOS**: `.dmg` 或 `.pkg`
- **Linux**: `.deb`、`.rpm` 或 AppImage

### 方式二：从源码编译

#### 环境要求

- [Rust](https://www.rust-lang.org/) 1.70+
- [Node.js](https://nodejs.org/) 18+
- [pnpm](https://pnpm.io/) 8+

#### 编译步骤

```bash
# 1. 克隆仓库
git clone https://gitee.com/dcren/package-clearup-tool.git
cd package-clearup-tool

# 2. 安装前端依赖
pnpm install

# 3. 安装 Rust 依赖
cd src-tauri
cargo fetch
cd ..

# 4. 启动开发版本
pnpm tauri dev

# 或构建发布版本
pnpm tauri build
```

## 使用说明

### 界面功能

1. **侧边栏**: 左侧显示所有检测到的包管理器，按语言生态分组
2. **主面板**: 选中某个包管理器后显示其缓存信息
3. **缓存统计**: 显示缓存大小、文件数量、最后修改时间
4. **缓存列表**: 展示缓存条目，支持搜索和筛选
5. **自定义管理器**: 可添加自定义的包管理器配置

### 操作流程

1. 启动应用，等待扫描各包管理器的缓存状态
2. 点击左侧选中要清理的包管理器
3. 查看缓存信息和条目列表
4. 点击「清理」按钮执行清理操作
5. 可选择清理全部或特定目标

### 键盘快捷键

| 快捷键 | 功能 |
|-------|------|
| `Ctrl/Cmd + F` | 搜索缓存条目 |
| `Esc` | 关闭对话框 |

## 参与贡献

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)
4. 推送分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 许可证

本项目基于 MIT 许可证开源，详情请参阅 [LICENSE](LICENSE) 文件。

## 常见问题

**Q: 清理后会影响已安装的包吗？**  
A: 不会。清理的只是缓存文件，不会删除已安装的包。重新安装时需要重新下载。

**Q: 如何添加自定义包管理器？**  
A: 在设置页面点击「添加自定义管理器」，填写管理器名称、命令名称和缓存路径即可。

**Q: 支持哪些操作系统？**  
A: 本应用支持 Windows 10+、macOS 10.15+、Linux (主流发行版)。