🚀 DevZen 开源啦!专治「项目多且乱」——你本地所有开发项目的一站式清单管理工具

先看见,再行动。🧠

作为一个开发者,你一定经历过这样的场景:

硬盘飘红了,想清理点空间,打开「访达」望着茫茫多的文件夹——这是我哪个项目来着?这个能删吗?node_modules 占了几个G?这个项目有没有推到 GitHub 上?

于是你关掉了窗口,继续忍受着磁盘空间的焦虑。😮‍💨

说实话,这种情况在 AI 编程新手 群体中尤为普遍——用 Cursor / Claude / ChatGPT 生成了十几个项目,有的还没 push 到 GitHub,有的 clone 下来改了两行就再没动过,node_modules 堆积如山却不知道能不能删……

DevZen 就是为解决这个问题而生的。


🧭 DevZen 是什么?

项目地址:https://github.com/szgenle/devzen

DevZen 是一个 跨平台桌面应用

❌ 不是又一个「清理工具」 ✅ 而是 你本地所有开发项目的清单

它的核心能力:扫描 → 识别 → 展示 → 清理 → 归档,帮你把本地项目「理清楚、看明白、管起来」。


✨ 当前 MVP 功能一览

DevZen 目前 v0.2.0

📋 1. 自动扫描,智能识别

打开 DevZen 就能自动扫描你的 Home 目录(~),智能跳过系统目录(Library、Applications、Downloads……)。通过 生态 Marker 文件 精准识别项目类型:

标志文件 项目类型
package.json Node.js
Cargo.toml Rust
go.mod Go
requirements.txt / pyproject.toml Python
pom.xml / build.gradle Java
*.xcodeproj Xcode
Package.swift SwiftPM
DevZen 主页扫描界面

DevZen 主界面:自动扫描并展示所有本地开发项目

👁️ 2. 项目信息,一目了然

每个项目卡片都清晰展示:

  • 项目名称 + 一句话描述(自动从 package.json 的 description 或 README 中提取)
  • 技术栈(Node / Rust / Go / Python 等)
  • 来源:GitHub 项目 / 远程仓库 / 🔴 仅本地(无远程备份)
  • 可清理的构建产物大小
  • 上次修改时间
  • Git 是否有未提交的修改
DevZen 项目详情卡片

每个项目的信息一目了然,来源、技术栈、可清理空间尽收眼底

🧹 3. 一键清理,安全放心

勾选项目 → 二次确认 → 一键删除构建产物。整个过程极其安全

  • 白名单制:只删除可安全重建的标准构建产物目录(node_modulestargetdistbuild 等)
  • 限定家目录:绝不越界操作
  • 二次确认弹窗:防止手滑
  • 符号链接隔离:不跟随 symlink,避免穿透到家目录之外
  • 本地项目强提醒:如果项目「仅本地无远程备份」,会醒目标红告诉你——这些项目没有远程备份,请谨慎操作

清理后自动重扫,状态栏显示本次释放了多少空间——这种「即时反馈」非常解压。✨

DevZen 清理功能

一键安全清理,释放磁盘空间

🔄 4. 重复项目检测

同一个项目 clone 了两份?DevZen 会自动检测,对比辅助你决策该删哪份。

📦 5. 安全卸载 & 一键归档

对于 GitHub 项目,可以放心地「删本地保远程」——随时可以一键 git clone 回来。


🎯 谁最需要 DevZen?

DevZen 的作者在 README 中写得很坦诚:

所有受困于「项目多且乱」的开发者——尤其是非计算机科班出身、通过 AI 编程开始写代码和接触 GitHub 的新手

这个群体有几个典型特征:

  • 不一定知道 node_modules 能删
  • 不一定记得自己 clone 过哪些项目
  • 用 AI 生成了项目但还没推到 GitHub
  • 本地散落着十几个「test-project-xxx」

DevZen 也是作者自用的工具——这个痛点他自己也同样需要解决。这种「dogfooding」(自己吃自己的狗粮)态度,让产品的设计非常务实。


🛠️ 技术架构亮点

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
src/
├── main/ # Electron 主进程
│ ├── index.ts # 应用入口、BrowserWindow
│ ├── ipc/ # IPC 路由
│ └── core/ # 核心逻辑
│ ├── markers.ts # 生态 marker / 可清理目录 / 系统目录黑名单
│ ├── scanner.ts # 扫描 + 识别 + 描述提取 + git 状态检测
│ └── cleaner.ts # 物理删除 + 安全校验
├── preload/ # contextBridge 暴露 window.devzen
├── renderer/ # React 18 渲染层
│ └── src/
│ ├── App.tsx
│ ├── components/
│ └── utils/
└── shared/ # 主/渲染共享类型与 IPC 通道名

技术栈:Electron 33 + electron-vite + React 18 + TypeScript

最值得称道的设计决策:主进程扫描与清理功能仅依赖 Node.js 内置模块,没有引入第三方依赖来做文件操作。这既保证了安全(减少供应链攻击面),也让打包体积更小、启动更快。

🔒 安全设计哲学

DevZen 的安全策略非常严谨,这在开源的个人工具中并不多见:

  1. 白名单目录删除:只删除标准构建产物目录
  2. 路径限制:仅允许操作家目录内的路径
  3. 二次确认:所有删除必须渲染层弹窗确认
  4. 仅本地项目强提醒:不懂技术的用户不会误以为可恢复
  5. 不跟随符号链接:避免穿透到家目录之外

这些细节体现了作者对用户数据的敬畏之心。👏


🗺️ 已完成功能路线

  • MVP:项目发现 + 构建产物清理 + 来源区分(已完成)
  • ✅ GitHub 项目安全卸载(已完成)
  • ✅ 项目分类与标签:个人 / 公司 / 开源 clone(已完成)
  • ✅ 重复项目检测(已完成)
  • ✅ 快速启动入口(已完成)
  • Windows 支持(已完成)

如果你有 Windows 使用场景,欢迎去 Issues 留言,这会直接影响 v0.2.0 的排期优先级。


🤝 如何参与?

DevZen 采用 MIT 开源协议,代码完全开放:

快速体验

1
2
3
4
5
6
7
8
9
# 1. 下载安装
# 访问 Releases 页面下载安装包(macOS / Windows 均可)


git clone https://github.com/szgenle/devzen.git
cd devzen
npm install
npm run dev # 开发模式
npm run dist # 打包(支持 macOS / Windows)

💭 最后想说的话

DevZen 这个项目最打动我的地方,是它对「开发者需求」的深刻理解。

它不是大厂的商业化产品,没有 PRD、没有产品经理。它来自一个真实开发者的真实痛点——本地项目太多太乱,需要一个东西来「看清全局」

正如它的 slogan 所说:「先看见,再行动」。

很多时候,问题本身不是「没有空间」,而是「不知道空间去哪了」。DevZen 让你先看见你的项目生态全貌,然后再做决定——这才是真正的「掌控感」。

如果你也有同样的困扰,不妨试试 DevZen。也欢迎来 GitHub 一起参与建设,让这个工具变得更好。🚀


项目地址:👉 https://github.com/szgenle/devzen


PS:如果你觉得这篇文章对你有帮助,欢迎分享给身边的开发者朋友。你的每一次 Star 和分享,都是对开源作者最好的鼓励!