cocojojo5213/Dev-Janitor

cocojojo5213/Dev-Janitor has 869 GitHub stars and 57 forks. GitHot measured +5 in 7 days and +7 in 15 days. Last checked 2026-11-09 14:43 UTC. Last push 2026-10-14.

这些数字如何统计

Cross-platform desktop app for cleaning development artifacts, managing local developer tools, and checking common environment issues.

869 星标 57 forks

实测星标增长

24小时: 更新延迟
7天: +5
15天: +7
1个月: 更新延迟

各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。

README.zh-CN.md

原文

Dev Janitor

一个跨平台桌面应用，用于清理开发残留、管理本地开发工具，并检查常见的环境问题。

安装 • 功能 • 截图 • 开发 • 贡献 • English

概览

Dev Janitor 用来处理开发过程中不断累积的本地残留文件和后台进程，例如包管理器缓存、构建输出、临时文件、AI 工具残留、端口占用，以及 Shell 配置漂移等问题。

功能

清理

扫描项目目录中的常见开发残留，例如 node_modules、target、日志、缓存和临时文件。
检测 AI 编程工具留下的临时残留，同时避免把 .codex/config.toml、.claude/settings.json、.goosehints、.junie/AGENTS.md 这类仍在使用的项目配置误判成垃圾文件。
按项目查看和清理 AI 聊天记录、缓存、会话状态与调试文件。
清理 GitHub Copilot CLI 官方会话目标，但不删除整个 .copilot 配置目录。

工具管理

查看 Node、Python、Rust、Go 等生态中的常用工具。
检查版本并更新常见的全局包，区分“最新”和“未检查更新”，保留命令失败的具体原因。
提供 AI Agent CLI 与包管理器更新命令说明，涵盖 Pi 新包名、npm/pnpm 跨主版本更新及各安装渠道限制。
在一个界面中管理 25 个 AI CLI 工具，包括 Codex、Claude Code、Kiro、Factory Droid、Mistral Vibe、Qoder CLI、Pi、OpenCode、Gemini CLI 和 GitHub Copilot CLI 等。
优先使用厂商官方的原生安装与自更新流程；旧版 Amazon Q 安装会引导迁移到 Kiro CLI。

安全扫描

检查本地工具配置中的已知风险和易受攻击的设置。
标记通常应只监听 localhost 的端口。
检测常见配置文件中的 API 密钥、GitHub token 和提供商凭证泄露。
检查 MCP 服务器配置中可能导致凭证泄露或 SSRF 的模式。

系统工具

查看长期运行的开发进程。
查找某个端口当前被哪个进程占用。
排查 PATH 与 Shell 配置中的常见问题，包括 Windows 系统/用户持久化 PATH 条目。

截图

统一查看和管理开发工具

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

回收包管理器缓存占用的空间

检查开发进程和端口占用

安装

最新稳定版会在 v* tag 的 release workflow 通过预检查后发布。正式安装版会检查经过签名的 GitHub Release，并可在应用内下载、安装和重启到新版本。

Windows

从 Releases 页面下载：

安装版：.msi
便携版：*_portable.zip

macOS

从 Releases 下载 .dmg 文件。首次运行时，可能需要使用 右键 > 打开 通过 Gatekeeper。

Linux

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

开发

本项目基于 Tauri 2、React 19 和 Rust。

开发环境配置

前置要求

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；默认的 Cargo 与 Tauri 构建仍会启用完整的 desktop feature。

参与贡献

提交 Pull Request 之前，请先阅读 CONTRIBUTING.md。

尽量让每个 Pull Request 聚焦在单一问题上。
功能或行为变化时，请同步更新文档。
安全问题请按 SECURITY.md 中的方式私下报告。
参与协作时请遵守 CODE_OF_CONDUCT.md。

项目文档

许可证

本项目采用 MIT License。

联系方式

邮箱：[email protected]

_{Built by cocojojo5213}