Dev Janitor：开发环境清理与管理工具

项目简介

Dev Janitor 是一款跨平台桌面应用，基于 Tauri 2、React 19 和 Rust 构建，用于清理开发过程中产生的文件与缓存、管理本地开发者工具、检查常见环境问题。它关注日常开发中不断堆积的文件、缓存、服务与配置偏差，帮助本地开发机保持整洁可控。

主要功能

清理

• 扫描项目目录中的常见开发产物，例如 node_modules、target、日志、缓存和临时文件。
• 识别 AI 编码工具留下的临时残留，同时不会把 .codex/config.toml、.claude/settings.json、.goosehints、.junie/AGENTS.md 这类正在使用的项目配置文件误判为垃圾。
• 按项目查看并删除 AI 对话历史、缓存、会话状态和调试文件。
• 清理 GitHub Copilot CLI 的会话目标，而不删除整个 .copilot 配置目录。

工具管理

• 检查 Node、Python、Rust、Go 等相关生态中已安装的工具。
• 检查并更新常见全局包，区分「已确认最新」与「未检查更新」两种状态，并保留失败原因。
• 在一个界面中管理 25 种 AI CLI 工具，包括 Codex、Claude Code、Kiro、Factory Droid、Mistral Vibe、Qoder CLI、Pi、OpenCode、Gemini CLI、GitHub Copilot CLI 等。
• 优先采用官方原生安装与自更新流程；旧的 Amazon Q 安装会引导迁移到 Kiro CLI。
• 更新命令说明 列出了 AI Agent CLI、Pi 扩展包以及各包管理器的命令和安装渠道限制。

安全扫描

• 检查有风险的本地工具配置和已知的脆弱配置。
• 标记通常应只监听 localhost 的端口。
• 检测常见配置文件中存放的 API key、GitHub token 和供应商凭据。
• 检查 MCP server 配置中可能导致凭据泄露或 SSRF 的模式。

系统工具

• 查看长时间运行的开发进程。
• 查找占用指定端口的进程。
• 检查 PATH 与 shell 配置问题，包括 Windows 系统/用户 PATH 的持久化条目。

安装与使用

从 Releases 页面下载对应平台的安装包：

• Windows：.msi 安装包，或 *_portable.zip 便携版。
• macOS：.dmg。
• Linux：AppImage、.deb、.rpm。

已安装的正式版本会检查签名的 GitHub release，并可在应用内下载、安装并重启完成更新。

开发环境

需要 Node.js 24 LTS+、pnpm 11.15.1+、Rust 1.97.1。

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

构建检查命令：

pnpm lint
pnpm validate:release
pnpm build
pnpm test
cargo fmt --check --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
cargo check --manifest-path src-tauri/Cargo.toml --target x86_64-pc-windows-gnu

pnpm test 只运行 Rust 核心测试，不编译 Tauri 桌面外壳；改动 Tauri 命令接线时可使用 pnpm test:rust:full。

注意事项

• macOS 首次启动可能因 Gatekeeper 拦截，需要「右键 > 打开」。
• 通过其他包管理器或独立安装器安装的 CLI，应沿用原安装渠道更新。
• npm/pnpm 更新到 latest 可能跨主版本；旧 Pi 包若导致 EEXIST，请先卸载旧包再安装新包。
• 更新流程中八种包管理器的变更操作会保留错误原因，命令超时时间已延长到 15 分钟；Cargo 避免强制重编译，Yarn 全局管理限定为 Classic。

---

本作品整理自 GitHub 开源项目 cocojojo5213/Dev-Janitor，原作者 @cocojojo5213，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。