tidymymac

TidyMyMac 是一款面向开发者的开源 macOS 存储清理工具。它从终端扫描、审查并回收磁盘空间，其设计目标明确为透明和安全：先检查、删除前审查、默认试运行，并保持终端原生。 README 中列出的功能包括：用于浏览和选择清理内容的交互式 TUI；审查屏幕中的逐项选择（可取消选择单个下载、Docker 镜像/容器/卷、iOS 备份或 Time Machine 快照）；斜杠过滤器和全选/取消全选；默认试运行；任何清理器都无法触及的保护路径（无论标志如何）；模块化清理器；捆绑类别和项目目录的命名配置文件；进度报告和回收空间摘要；扫描结果的 JSON 或 CSV 导出；shell 清理脚本生成；以及在任何命令中定位特定类别。 README 通过指出 macOS 会在难以检查的位置（如缓存、开发者工件、日志和模糊的“系统数据”类别）积累存储空间来激励该工具。 清理器涵盖：临时文件（/tmp、/var/tmp、用户临时目录）；应用程序缓存（~/Library/Caches）；系统日志（~/Library/Logs、/Library/Logs、/var/log）；Homebrew 缓存；Docker 工件（已停止的容器、未标记的镜像、孤立卷）；iOS 备份；旧的 macOS 更新残留和安装程序；安装文件（.dmg、.pkg）和 ~/Downloads 中的大项目；已卸载应用程序的孤立文件；Xcode DerivedData、归档和模拟器；Go 构建和模块缓存；项目工件，如 node_modules、dist、target 和 .venv，以及配置文件项目路径中超过 500MB 的文件；本地 Time Machine 快照；以及废纸篓。 文档中记录的安装选项包括：curl 安装脚本（安装到 /usr/local/bin，回退到 $HOME/.local/bin，并提示 sudo）、Homebrew tap、go install，以及使用 make build 从源码构建。README 声明需要 Go 1.26+。 使用围绕命令展开：scan（默认交互式表格、类别选择、配置文件扫描、JSON/CSV/表格输出、详细输出、--print-all、--save、--generate-script、--quiet）；clean（默认试运行、--execute 删除、类别或配置文件选择、--include-large-files、--from-file、JSON 输出、--prompt-sudo）；profile（创建、添加类别、添加路径、列出、移除路径、删除）；protect/unprotect 和列出保护项；以及 version、explain、list categories 和 history。 安全说明：默认试运行，仅通过 --execute 删除，保护路径作为硬性阻止，CLI 标志无法覆盖，内置对 AI 模型存储（~/.ollama/models 和 ~/.cache/huggingface）的保护（即使没有配置文件），无静默操作，以及非致命错误。 配置位于可选的 ~/.tidymymac/config.yaml，涵盖保护路径、默认禁用的类别和配置文件。故障排除文档指出，macOS 上终端缺少“完全磁盘访问”权限可能导致废纸篓和某些类别报告为 0 B。该项目采用 MIT 许可证。