开发清洁工

跨平台桌面应用程序，用于清理开发产物、管理本地开发者工具以及检查常见的环境问题。

下载 • 功能 • 截图 • 开发 • 贡献 • 简体中文

概述

Dev Janitor 帮助您掌控本地开发环境。它专注于日常工作中积累的文件、缓存、服务以及配置漂移等问题。

功能

清理

• 扫描项目目录，查找常见的开发产物，如 node_modules、target、日志、缓存和临时文件。
• 检测 AI 编码工具留下的临时文件，同时不会误将活跃的项目配置文件（如 .codex/config.toml 或 .claude/settings.json）标记为垃圾。
• 按项目分别审查并删除 AI 对话历史、缓存和调试文件。

工具管理

• 检查 Node.js、Python、Rust、Go 等生态中已安装的工具。
• 核对版本并更新常用的全局包。
• 从一个界面管理当前使用的 AI CLI 工具，如 Codex、Claude Code、Cursor、Gemini CLI、Aider、Continue、Kiro、iFlow 和 OpenCode。

安全扫描

• 检查是否存在风险的本地工具配置及已知的脆弱设置。
• 标记通常应仅监听 localhost 的端口。
• 检测存储在常见配置文件中的 API 密钥。
• 检查 MCP 服务器配置中可能导致凭据泄露或 SSRF 的模式。

系统工具

• 检查长期运行的开发进程。
• 查找占用特定端口的进程。
• 审查 PATH 和 shell 配置问题。

截图

在一个地方管理开发工具

按项目审查并清理 AI 工具残留

释放包管理器缓存占用的空间

检查开发进程和端口使用情况

安装

Windows

从 Releases 下载最新文件：

• 安装程序：.msi
• 便携版：*_portable.zip

macOS

从 Releases 下载 .dmg 文件。首次启动时，可能需要右键点击后选择“打开”，以绕过 Gatekeeper 限制。

Linux

AppImage、.deb 和 .rpm 包已在 Releases 页面发布。

开发

Dev Janitor 使用 Tauri 2、React 19 和 Rust 构建。

git clone https://github.com/cocojojo5213/Dev-Janitor.git
cd Dev-Janitor
corepack enable pnpm
pnpm install
pnpm tauri dev

pnpm lint
pnpm build
cargo test

贡献

请在提交拉取请求前阅读 CONTRIBUTING.md。

• 保持拉取请求的专注性。
• 当行为或设置发生变化时，及时更新文档。
• 如发现安全问题，请按照 SECURITY.md 中的说明私下报告。
• 请遵守 CODE_OF_CONDUCT.md 中的各项要求。

项目文档

• 贡献指南
• 行为准则
• 安全策略
• 支持

许可证

本项目采用 MIT 许可证 开源。

联系方式

邮箱：cocojojo5213@gmail.com

Dev-Janitor 快速上手指南

Dev-Janitor 是一款跨平台桌面工具，旨在帮助开发者清理开发产物、管理本地工具链并检查常见的环境安全问题。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Windows (10/11), macOS, 或 Linux。
• 架构支持：支持 x86_64 及 ARM64 (如 Apple Silicon) 架构。
• 前置依赖：
  • 普通用户：无需安装任何额外依赖，直接下载即可运行。
  • 开发者（需源码构建）：
    • Node.js 24 LTS+
    • pnpm 10.30.3+
    • Rust 1.94.0+

提示：国内用户若需下载依赖，建议在构建时配置国内镜像源（如 pnpm config set registry https://registry.npmmirror.com 和 Rust 的 ustc 源）。

安装步骤

您可以直接从 GitHub Releases 页面下载预编译版本，无需手动编译。

Windows

1. 访问 Releases 页面。
2. 下载最新版本的安装包：
   • 标准安装：选择 .msi 文件。
   • 便携版：选择 *_portable.zip 文件，解压后即可运行。
3. 双击运行安装程序或直接启动可执行文件。

macOS

1. 访问 Releases 页面。
2. 下载 .dmg 文件。
3. 将应用拖入 Applications 文件夹。
4. 首次启动注意：由于 macOS Gatekeeper 机制，若无法直接打开，请右键点击图标选择 Open（打开），然后在弹窗中确认打开。

Linux

1. 访问 Releases 页面。
2. 根据您的发行版选择对应的包：
   • Debian/Ubuntu: 下载 .deb 包，使用 sudo dpkg -i <文件名>.deb 安装。
   • Fedora/RHEL: 下载 .rpm 包，使用 sudo dnf install <文件名>.rpm 安装。
   • 通用：下载 AppImage 文件，赋予执行权限后运行 (chmod +x <文件名>.AppImage && ./<文件名>.AppImage)。

基本使用

安装完成后，启动 Dev-Janitor 应用程序。以下是核心功能的最简使用流程：

1. 清理开发垃圾 (Cleanup)

• 在主界面选择 Cleanup 标签页。
• 工具会自动扫描项目目录中的常见垃圾文件（如 node_modules, target, 日志，缓存等）。
• AI 专项清理：它会自动识别 AI 编程工具（如 Cursor, Claude Code）产生的临时文件和聊天记录，同时智能保留必要的配置文件（如 .codex/config.toml）。
• 勾选需要清理的项目，点击 Remove 释放空间。

2. 管理开发工具 (Tool Management)

• 切换到 Tools 标签页。
• 查看已安装的 Node, Python, Rust, Go 等生态工具版本。
• 统一管理 AI CLI 工具（如 Codex, Aider, Continue 等），在此界面即可查看状态或更新全局包。

3. 安全扫描 (Security Scan)

• 进入 Security 模块。
• 自动检测本地配置风险，例如：
  • 不应暴露在公网的端口（仅应监听 localhost 的端口）。
  • 硬编码在配置文件中的 API Key。
  • MCP Server 配置中可能导致凭证泄露的模式。
• 根据提示修复标记的风险项。

4. 系统实用工具 (System Utilities)

• 使用 Services 视图查看长期运行的开发进程。
• 快速查询占用特定端口的进程。
• 检查 PATH 环境变量及 Shell 配置是否存在冲突。

源码构建（仅限开发者）

如果您希望贡献代码或自定义构建，请按以下步骤操作：

git clone https://github.com/cocojojo5213/Dev-Janitor.git
cd Dev-Janitor

# 启用 pnpm (需已安装 Node.js)
corepack enable pnpm

# 安装依赖 (国内用户建议先配置 npm 镜像源)
pnpm install

# 启动开发模式
pnpm tauri dev

构建生产版本：

pnpm build
cargo test