文章正文
这套源码是一套开源的 Windows 磁盘清理桌面工具，项目名叫 Pinkbin。
它没有把功能堆成又一个”一键清理全家桶”，而是把”看清空间、看懂文件夹、放心删”三件事做扎实。
核心扫描走 Windows 上直读 NTFS 主文件表（MFT）的方案，整盘 C 盘通常 2 到 5 秒就能扫完，比传统递归遍历快一个量级。
扫完之后会给出彩色的 treemap 方块图和单行 22 像素高的树状视图，哪个文件夹占了多少空间一眼就能看出来。
遇到不认识的超大文件夹，你可以直接把它从左侧树或右侧路径拖进中间的聊天框，Pinkbin 会调用你配置的 AI 顾问来解释”这是什么、能不能删、删了会丢什么”。
这里有个很关键的设计：发给 AI 的只有目录元数据，包括路径名、大小、文件数量、扩展名占比和最多 20 条样本路径，程序永远不读取你的文件实际内容。
对于微信 PC 端和 Conda 环境这类”大众化、占空间大、边界清楚”的应用，Pinkbin 内置了专属清理脚本，用户在面板里按 scope 单独勾选清理。
目前微信支持 3.x 和 4.x 双版本共 22 个 scope，Conda 则按环境回收过期依赖，base 环境默认灰显不可勾选。
所有删除操作默认进入系统回收站而不是物理删除，每一次操作还会写入本机 undo 日志，并可选 7 天隔离期，误删能找回。
技术栈上是标准的 Tauri 2 桌面方案：前端 React 18 加 TypeScript，后端是 Rust workspace 多 crate 架构，扫描、清理脚本、执行器、AI 顾问各司其职。
AI 部分采用 BYOK 模式，你自己填 Anthropic、OpenAI、Gemini 的 Key，或者在本地跑 Ollama 完全免费使用。
数据全部留在你本机，不上云、不回传，这对注重隐私的用户很友好。
仓库里还带了一份 14 阶段的工作流和脚手架红线测试，想给更多软件写清理脚本的话可以照着扩展。
整体来说这是一份质量相当扎实的开源桌面工具源码，适合想研究 Rust 桌面开发、文件系统扫描或自托管清理工具的人拿来学习和二次开发。
源码简介
Pinkbin 是一个开源的 Windows 磁盘清理桌面工具，采用 Tauri 2 加 Rust 技术栈开发。它的目标是帮用户把”看空间、懂文件夹、放心删”三件事做简单：通过直读 NTFS MFT 实现秒级全盘扫描，用 treemap 和树状视图直观展示每个文件夹的占用。它支持把陌生文件夹拖给 AI 顾问分析能否删除，且只发送目录元数据、绝不读取文件内容。对微信和 Conda 内置专属清理脚本，删除默认进回收站可恢复。代码组织清晰，含扫描、脚本、执行、AI 顾问等多个 Rust crate，适合学习桌面开发与文件系统处理。
适用场景
- 想学习 Tauri 2 加 Rust 桌面应用开发，参考真实项目的工程结构与多 crate 拆分。
- 需要自托管一个注重隐私的磁盘清理工具，避免把文件信息上传到云端。
- 研究 NTFS MFT 直读、文件系统遍历与 treemap 可视化实现的开发者。
技术栈与运行环境
- 前端：React 18 加 TypeScript 加 Tauri 2 加 react-markdown
- 后端：Rust workspace 多 crate（scanner / scaffold / executor / advisor / scaffold-lint / steam-inspector）加 Tauri IPC
- 扫描：Windows 直读 NTFS MFT（ntfs crate），跨平台用 jwalk 兜底
- AI：BYOK 四协议（Anthropic / OpenAI / Gemini / Ollama），reqwest 调用
- 删除：trash-rs 进系统回收站，本机 ~/.pinkbin 存 undo 日志
- 环境：Node 20 以上 · pnpm 9 以上 · Rust stable · Windows 需 VS Build Tools 2022 加 WebView2
功能亮点
- 秒级全盘扫描：直读 NTFS MFT 主文件表，C 盘 2 到 5 秒扫完，跨平台用 jwalk 兜底。
- AI 顾问分析文件夹：拖拽陌生文件夹给 AI 问”能不能删”，只发目录元数据、永不读文件内容。
- 微信与 Conda 专属清理：内置清理脚本，微信 3.x 和 4.x 双版本 22 个 scope，Conda 回收过期环境。
- 回收站可恢复删除：默认进系统回收站，写 undo 日志，可选 7 天隔离，误删能找回。
- 隐私优先：数据全部留本机不上云，AI 仅见路径、大小、文件数等元数据。
- 清理脚本红线测试：每份 scaffold 强制集成测试，正向断言加红线断言防误删。
安装与部署提示
- 拉取仓库后执行 `pnpm install` 安装前端依赖。
- 桌面端用 `pnpm tauri dev` 启动，首次会编译 Rust 依赖，约 5 到 15 分钟。
- 仅调试前端可 `pnpm -C apps/desktop dev`，后端走 mock。
- 跑全量测试用 `cargo test –workspace`。
- Windows 需装 VS Build Tools 2022 与 WebView2 运行时，NTFS MFT 直读需要管理员权限（安装包自带 UAC manifest）。
- 编译正式包用 `pnpm tauri build`，产物为 NSIS exe 或 MSI。
截图与演示说明
- 扫描结果页：docs/screenshots/hero.png，展示 D 盘树状视图（每行带占用百分比条）、拖拽文件夹给 AI 的对话、Studio 卡片展开 Conda 缓存。
- 初始空态页：docs/screenshots/empty.png，展示”选择磁盘或文件夹”未扫描时的三栏布局。
- 桌面图标与品牌：apps/desktop/src-tauri/icons/ 下多尺寸 PNG（128×128、64×64 等）与 Windows、Android 图标资源。
- 架构图：README 内嵌 Rust workspace 与 Tauri 分层图，crates 含 scanner、scaffold、executor、advisor。
- 部署后可在本机运行 `pnpm tauri dev` 补充。
常见问题
- 问：Pinkbin 会读取我文件里的内容吗？
答：不会。程序只把目录元数据（路径、大小、文件数、扩展名占比、最多 20 条样本路径）发给 AI，永不读取文件实际内容，数据也不上传云端。
- 问：删错了能找回吗？
答：能。所有删除默认进入系统回收站而非物理删除，每次操作写入本机 undo 日志，还支持 7 天隔离期，误删可直接恢复。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
本源码托管于 GitHub（cccyd2003-qwq/pinkbin），基于 MIT 协议开源，可自由 fork、商用与闭源衍生。本文提供完整源码压缩包免费下载，仅供学习与研究使用，请于下载后 24 小时内删除或遵守 MIT 许可合规使用，切勿用于商业违规分发。正式发行版 exe 或 msi 请前往仓库 Releases 页面获取。
