英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

下载

macOS / Linux 暂不提供预编译版（macOS 还没有签名证书，Linux 也没在真实机器上验过）。你可以自己 pnpm tauri build 编译。等有签名通道 + 真机验证后会把 release 矩阵加回来——欢迎 PR。

看效果

_{实际使用 · 左：D:\ 树状视图（每行带占用百分比条）· 中：拖 D:\steam\steamapps 给 AI，AI 用 markdown 回答这是什么、能不能删 · 右：Studio 卡片展开 Conda packages cache（5.12 GB · 150,867 文件）}

_{初始空态 · 顶部"选择磁盘或文件夹"→ 点扫描后才会有内容；右侧 Studio 已经认出 WeChat / Conda 两个脚本（脚本默认路径还没扫到，所以是"未扫到"状态）}

三件事

Pinkbin 只做三件事：简单、简单、还是TMD简单

1. 把磁盘空间分配看清楚

Windows 上直读 NTFS Master File Table（其他平台用 jwalk 跨平台 walker 兜底），整盘 C: 2–5 秒扫完。出彩色 treemap + 单行 22px 高的树视图——一眼看到 D:\xwechat_files 占了 80GB，C:\Users\<你>\AppData\Local\Docker 占了 50GB。

2. 拖拽到中间 AI 分析"这个文件夹是什么"

不认识的文件夹？把它从左边树或右边路径拖进中间聊天框，AI 解释这是什么、能不能删、删了会丢什么。BYOK——你提供 Anthropic / OpenAI / Gemini 的 Key，或本地跑 Ollama 完全免费。

Pinkbin 只发目录元数据给 AI（路径名、大小、文件数、扩展名占比、最多 20 条样本路径）—— 永远不读文件内容。

3. 已知应用走专属清理脚本

某些应用大众化、占空间大、清理边界清楚——给它写一份清理脚本（一份 TOML + 一份 Rust 集成测试），用户在 Studio 卡片里直接按 scope 单独清。目前两个：

• 微信 PC 端（3.x + 4.x 双兼容）—— 22 个 scope，清缓存/接收媒体/聊天备份，永不动聊天 DB / 收藏 / 朋友圈 / CustomEmotion
• Conda 环境—— 整目录回收 stale env（conda-meta/history mtime > 90 天），base env 灰显不可勾

未来会做的：Steam shadercache · Chrome 缓存 · Docker buildx · HuggingFace 模型 · npm/pnpm/pip cache · OBS 录像 · IDE 索引——大众应用、占空间大、清理边界清楚的，逐个走 14-phase 工作流加进来（含红线集成测试守护）。为什么砍掉之前那 36 个 legacy scaffold：因为没人验过 glob 边界，存在误删风险（典型例子：旧版 node-modules 把 Cursor / VSCode / 游戏内嵌的 node_modules 也命中了）。

所有删除默认进系统回收站，可恢复。每一次操作写 ~/.pinkbin/undo.jsonl，可选 7 天 quarantine。

怎么用

1. 下载安装包（上面），双击安装，桌面出现 Pinkbin 图标
2. 打开 → 右上角 ⚙ 配 AI——填LLM的API Key
3. 顶部"选择磁盘或文件夹"→ 点扫描——2-5 秒后看到 treemap + 树
4. 遇到陌生大文件夹——拖到中间聊天框问 AI；或者右侧 Studio 已经认出了的（微信、conda）直接看清理面板
5. 删除前：目前只提供WeChat和Conda的清理脚本，可自动无风险清理。其他的，自行清理，毕竟宁可错放1000GB，不可错删一个文件。

架构

想看人话解释（不堆术语，普通用户也能看懂）：📖 docs/ARCHITECTURE.md

┌────────────────────┐     ┌─────────────────────┐
│   React + Tauri    │────>│  Rust workspace     │
│   (前端 UI)         │<────│  (4 crates)         │
└────────────────────┘     └──────────┬──────────┘
                                      │
        ┌─────────────────┬───────────┼──────────────┬──────────────┐
        │                 │           │              │              │
   ┌────▼────┐    ┌──────▼─────┐  ┌──▼──────┐  ┌────▼────┐  ┌──────▼──────┐
   │ scanner │    │  scaffold  │  │executor │  │advisor  │  │scaffold-lint│
   │ NTFS MFT│    │ TOML 加载   │  │Recycle/ │  │AI 顾问   │  │ CI 校验     │
   │ + jwalk │    │ + globset  │  │Quarant. │  │4 协议   │  │              │
   └─────────┘    └────────────┘  └─────────┘  └─────────┘  └─────────────┘

路线图

• 整盘秒扫，看到每个文件夹占多少
• 拖任意文件夹给 AI 问"这是什么、能不能删"
• 微信、Conda 已经支持一键清理
• 加一个"撤销"按钮，删错了能一键找回
• 把更多常见软件加进来：Steam、Chrome、Docker、npm/pip、HuggingFace、OBS、各种 IDE 缓存……
• 出 macOS / Linux 的预编译版（要先解决签名 + 真机验证）
• 让用户能自己写、自己分享清理脚本

帮帮孩子吧

最有价值的贡献是写新的清理脚本。每加一个 App 支持就是一份 PR：

1. 在 docs/scaffold-requirements/ 写需求文档（红线清单：聊天 DB？账号 key？用户收藏？）
2. 在你机器上跑这个 App，用 Glob 列出真实目录结构，找出 cache vs 用户数据的边界
3. 抄 scaffolds/_templates/scaffold.toml 写 TOML
4. 抄 crates/scaffold/tests/_templates/scaffold_safety.rs 写 safety test（正向断言 + 红线断言，CI 必跑，没测试不收）
5. pnpm tauri dev 目视确认卡片渲染
6. 提 PR，模板会带 14 项 checklist

Claude Code 用户可以直接在仓库根目录敲 /add-scaffold <id>，一键启动 14-phase 工作流。

详细流程：.claude/commands/add-scaffold.md。

开发

git clone https://github.com/cccyd2003-qwq/pinkbin.git && cd pinkbin
pnpm install
pnpm tauri dev            # 桌面 app（首次会编译 Rust 依赖，5-15 分钟）
pnpm -C apps/desktop dev  # 仅前端，浏览器调试，mock 后端
cargo test --workspace    # 全工作空间测试

需要 Node 20+ · pnpm 9+ · Rust stable · Tauri 前置依赖（Windows 上是 VS Build Tools 2022 + WebView2）。

致谢

• 灵感来源
  • WizTree —— NTFS MFT 直读思路与速度标杆
  • SpaceSniffer —— treemap 可视化先驱
  • CleanMyWechat —— 微信清理脚本范本，messaging 需求文档参考它
  • SquirrelDisk —— Tauri + Rust 实现参考
• 依赖巨人的肩膀：Tauri · d3-hierarchy · jwalk · ntfs · globset · trash-rs · react-markdown

• 协作：Claude Code · @jtlyu（性能优化 + WeChat 4.x 重写 + scaffold harness 工作流基建）

许可证

MIT · 欢迎 fork、商用、闭源衍生。改 scaffold 时记得同步改它的 safety test——红线断言是防止误删用户数据的最后一道闸。