Mole V1.42.0 发布解读：mo clean 的超大工作区扫描、sudo 误判修复与开发者缓存清理增强

Mole V1.42.0 发布解读mo clean 的超大工作区扫描、sudo 误判修复与开发者缓存清理增强【免费下载链接】Mole Clean, uninstall, analyze, optimize, and monitor your Mac. Free open-source CLI, plus a native Mac app.项目地址: https://gitcode.com/GitHub_Trending/mole15/MoleMole 是一个用于清理、卸载、分析、优化与监控 Mac 的免费开源 CLI 工具同时提供原生 Mac App。本篇基于仓库中的发布说明 V1.42.0 逐条解读该版本的 7 项变更并结合当前仓库的源码实现说明每一项改动在lib/、cmd/目录下的落地位置与工作原理帮助读者理解 Mole 在清理安全边界和扫描性能两个方向上的演进思路。读完本篇你将能对应到每一条 Changelog 背后的关键函数、超时参数与安全守卫从而更准确地评估哪些行为在你的工作流中值得依赖。版本总览七个变更点的归类V1.42.0 的 Changelog 共包含 7 条更新按命令维度可以归纳为四个命令的增强mo cleanProject artifacts 扫描在超大工作区里能正常完成慢扫描超时后仍会展示已找到的部分结果mo clean在 sudo 提示里输入密码不再被误判成跳过 sudomo cleanApp leftovers 可以清理已删除应用、已卸载 DMG 留下的失效应用记录且不会删除文件mo cleanDeveloper cleanup 能发现更多可再生成缓存包括 VS Code WebStorage、QQ、LM Studio、Folo、SenPlayer、Xcode 模拟器缓存和 XCTest 测试数据mo analyze打开已有缓存的文件夹时后台刷新期间会继续显示已有结果mo updateNightly 更新不再重复安装同一个版本mo status也更接近 Mac App 的健康状态判断mo uninstall相关文件清理在系统项、应用 helper、symlink 和 container cache 上更谨慎。下面逐条展开并在每一条给出可核对的源码依据。mo clean超大工作区下 Project artifacts 扫描的超时与部分结果变更描述Project artifacts项目构建产物的扫描在超大工作区里不会再卡住当慢扫描超时后仍会展示已找到的部分结果。源码依据该能力位于项目产物清理模块 project.sh。核心扫描函数scan_purge_targets见 project.sh#L482内部引入了统一的扫描超时预算local scan_timeout${MO_PURGE_SCAN_TIMEOUT_SEC:-60} [[ $scan_timeout ~ ^[1-9][0-9]*$ ]] || scan_timeout60 [[ $scan_timeout -ge 2 ]] || scan_timeout2 local scan_deadline$((SECONDS scan_timeout))关键点在于可配置超时扫描总时长由环境变量MO_PURGE_SCAN_TIMEOUT_SEC控制默认 60 秒并被限制在最小 2 秒避免误配导致几乎不扫描。逐阶段截止时间fd/find 扫描、cachedir标签扫描、结果过滤等多个阶段共用同一个scan_deadline每个阶段调用_mole_timeout_with_deadline计算剩余可用时间而不是各自独立计时。这样整轮扫描有明确的上界不会因某个大目录而无限等待。部分结果而非空结果scan_purge_targets中先: $output_file清空对外可见的结果文件只在所有生产者与过滤器完成后才写入结果见 project.sh#L502-L507 附近注释a timeout or read failure cannot turn a partial prefix into delete candidates。这意味着超时不会把半成品前缀误当作可删除候选而已找到的结果仍会按阶段落盘并对外可见即 Changelog 所说的展示已找到的结果。配套的安全与性能策略同文件内可一并了解扫描深度默认min_depth1、max_depth6project.sh#L19-L20避免深入过深。活动度分级函数classify_purge_activityproject.sh#L765只允许完整有界扫描才返回old超时与读取失败一律fail closed防止把活跃产物误判为可清理。受保护产物过滤is_protected_purge_artifactproject.sh#L454对bin/vendor/DerivedData等做了上下文敏感的保护例如仅当能确认是 .NET 的bin才允许清理。适用前提这些行为针对的是mo clean中 Project artifacts 一类的项目产物扫描超时参数默认值与可覆盖项均以当前仓库lib/clean/project.sh实际内容为准。mo clean在 sudo 提示中输密码不再被误判为跳过 sudo变更描述在 sudo 提示里输入密码不再被 Mole 误判成用户跳过 sudo。源码依据sudo 会话管理集中在 sudo.sh。修复的核心在密码请求函数_request_passwordsudo.sh#L47与对外入口request_sudo_accesssudo.sh#L71。其中对终端密码读取做了如下处理_request_password() { local tty_path$1 sudo -k 2 /dev/null local stty_orig stty_orig$(stty -g $tty_path 2 /dev/null || echo ) trap [[ -n ${stty_orig:-} ]] stty ${stty_orig:-} $tty_path 2 /dev/null || true RETURN ... if sudo -v $tty_path /dev/null 2 $tty_path; then return 0 fi return 1 }要点显式从 TTY 读入sudo -v $tty_path明确把 sudo 的原生提示路由到同一个 TTY 设备读取配合stty -g保存/恢复终端状态避免用户键入密码时的字符或回显开关变化被外层流程当作异常输入而误判为跳过/取消。GUI 兜底路径当没有可读写 TTY例如从 GUI 拉起时request_sudo_access会走osascript的原生密码对话框sudo.sh#L96-L126并对提示文案做了转义防止应用显示名里带引号时破坏 AppleScript 字符串。Touch ID 路径当系统支持 Touch ID 且非 clamshell合盖模式时会后台拉起sudo -v并限时轮询失败/超时后再回落到密码输入sudo.sh#L156-L207确保输密码这一分支稳定可达而不是被提前判定为跳过。此外sudo.sh 还提供request_sudo_access_with_passwordsudo.sh#L210用于显式传入密码的场景以及_start_sudo_keepalivesudo.sh#L244后台保活减少长任务过程中因 sudo 时间戳过期而反复二次认证的体验问题。mo cleanApp leftovers 清理失效应用记录且不删文件变更描述App leftovers 可以清理已删除应用和已卸载 DMG留下的失效应用记录且不会删除文件。源码依据应用残留相关逻辑位于 apps.sh。其中clean_orphaned_system_servicesapps.sh#L911专门清理应用卸载后仍残留的系统级服务LaunchDaemons / LaunchAgents / PrivilegedHelperTools并内置了一份known_protect_patterns强保护清单如 Zoom、Docker、Intego、Homebrew services 等以避免把仍在使用的服务误判为孤儿见 apps.sh#L947-L976。孤儿应用数据的判定则由is_bundle_orphanedapps.sh#L432负责它按保护名单 → 敏感数据模式 → 已安装 bundle 列表 → 硬编码系统组件 → 30 天修改时间 → mdfind 兜底的顺序做 fail-closed 判定。对于失效应用记录 / pkg receipts仓库提供了专门的包记录模块 pkg_receipts.sh。从源码结构看V1.42.0 所述的清理已删除应用、已卸载 DMG 留下的失效记录且不删文件对应的是对这类应用记录 / 安装回执的失效项进行清理记录层面而非直接删除用户数据文件——这与clean_orphaned_app_dataapps.sh#L630在删除前对候选做身份快照、并用safe_clean_guardedorphan_cleanup_candidate_still_eligibleapps.sh#L592在每次大小探测后重新校验应用是否仍存在、对象是否被替换的守卫式删除设计一致只有在确认候选仍为孤儿时才真正删除否则保留。注意该条目强调的是只清理失效记录、不删文件的边界。实际删除前仍会经过上述身份快照与资格复检任何一步超时或状态不确定都会 fail closed保留候选这一保守策略是本版本更谨慎基调的体现。mo cleanDeveloper cleanup 覆盖更多可再生成缓存变更描述Developer cleanup 能发现更多可再生成的缓存包括 VS Code WebStorage、QQ、LM Studio、Folo、SenPlayer、Xcode 模拟器缓存和 XCTest 测试数据。源码依据开发者缓存清理位于 dev.sh。从该文件可见Xcode 相关的清理做了细粒度的进程守卫与分区处理Simulator 系统缓存/Library/Developer/CoreSimulator/Caches的清理会先探测 CoreSimulator / booted 模拟器是否活跃dev.sh#L1517-L1560 附近注释说明CoreSimulatorService、simdiskimaged是 launchd 服务可能在 Simulator 退出后仍存活活跃或状态未知时打印skipped (process state unknown)并跳过避免误删正在使用的运行时。XCTest 测试数据$HOME/Library/Developer/XCTestDevices的清理同样带进程守卫dev.sh#L1776-L1815检测到 Xcode / XCTest / Simulator 活动时以skipped收尾。延迟/回退机制当清理被进程活动打断时会调用mole_defer_cleanup_family Simulatordev.sh#L1749、dev.sh#L1766把这一族缓存留到安全时机再清理而非直接放弃。对于 Changelog 点名的 VS Code WebStorage、QQ、LM Studio、Folo、SenPlayer 等可再生成缓存其共同特征是可通过重新构建/重启重新生成因此被归入可清理白名单。从源码结构看这类新增缓存项的加入遵循与 Xcode 部分相同的模式先做可再生成语义确认再在清理前做进程/活跃状态守卫与超时保护确保不会删除正在被写或正被使用的数据。mo analyze缓存文件夹在后台刷新期间保持结果可见变更描述打开已有缓存的文件夹时在后台刷新期间会继续显示已有结果而不是把界面清空等待新扫描。源码依据该行为位于 Go 侧的分析模块 cache.go。关键设计缓存模式版本cacheSchemaVersion 3cache.go#L29注释说明每次目录大小语义变化都会 bump 版本号让陈旧的磁盘缓存条目被拒绝而不是被静默复用。v2 引入硬链接去重以对齐duv3 把普通 Parallels 虚拟机存储纳入统计而非按名字跳过。概览快照结构overviewSizeSnapshotcache.go#L31-L35保存Size、Updated、SchemaVersion配合overviewSnapshotCache内存缓存与overviewSnapshotLoaded标志cache.go#L37-L41。刷新标记historyEntry上的NeedsRefresh字段见snapshotFromModelcache.go#L43-L57被设置为m.viewNeedsRefresh || m.scanning。这意味着当某目录已有缓存且正在后台扫描scanning true时条目会带NeedsRefreshtrue界面据此先展示旧结果、后台刷新后再替换从而避免刷新期间空白。适用前提cache.go顶部标注//go:build darwin说明该 Go 侧实现面向 macOS 构建缓存损坏时会备份为storePath .corrupt并重建cache.go#L109-L115不会让损坏缓存阻塞界面。mo update / mo statusNightly 去重安装与健康信号对齐变更描述Nightly 更新不再重复安装同一个 buildmo status的健康状态判断也更接近 Mac App。源码依据Nightly 按 commit 比较更新逻辑位于 update.sh。当通道为nightly时比较 commit hash 而非版本号update.sh#L855-L862 注释并据此提示New nightly commit … available。在执行阶段若最新 nightly commit 与当前已安装一致则提示Already on latest nightly, commit并跳过重装update.sh#L1077无法解析最新 nightly commit 时则明确Unable to resolve latest nightly commit. No update was installed.update.sh#L1061并提供mo update --nightly --force作为显式强制重装入口update.sh#L1063。适用范围限制Nightly 更新仅对脚本安装可用Homebrew 安装跟随稳定版update.sh#L1023。mo status 健康信号mo status的指标与健康判断分散在 cmd/status 目录下的metrics_*.go与diagnosis.go等文件中。V1.42.0 所述更接近 Mac App 的健康状态判断指的是 CLI 侧的健康评分口径与 Mac App 对齐便于同一台机器在 CLI 与 GUI 中得到一致的健康结论。mo uninstall相关文件清理在边界上更谨慎变更描述相关文件related-file清理在系统项、应用 helper、symlink 和 container cache 上更谨慎。源码依据卸载相关文件清理的删除守卫贯穿 file_ops.sh 与 apps.sh 共用的安全删除函数如safe_remove、safe_clean_guarded以及身份快照函数orphan_cleanup_candidate_snapshot见 apps.sh#L566。本版本更谨慎的落点体现在symlink 安全lib/下存在专门的 symlink 安全删除逻辑配套测试 file_ops_safe_remove_symlink.bats确保对符号链接的处理不会沿链接误删目标或产生越权。系统项 / container 保护应用清理对Containers/、Group Containers/、LaunchAgents、Application Scripts/等由系统托管或误判成本高的路径做了显式永不加入约束见 apps.sh#L752-L755 的CRITICAL: NEVER add ...注释降低误伤系统托管项与容器存根的风险。身份复检删除前通过_mole_path_matches_identity对扫描根 / 父目录 / 目标做 inode 级身份比对见 project.sh#L864-L890 的最终删除守卫确保证明身份与真正删除之间没有文件系统遍历的空窗避免删除与候选之间发生对象替换。小结本版本的两条主线把 7 条变更放在一起看V1.42.0 的重心清晰落在两条主线上扫描/清理的性能与部分结果语义mo clean的项目产物扫描引入统一超时预算与阶段截止时间mo analyze用NeedsRefresh让缓存结果在后台刷新期间保持可见mo update用 commit 比较避免 Nightly 重复安装——共同目标是让长任务在有限时间内给出可用结果而不是无限等待或重复劳动。删除前的安全边界sudo密码输入不再被误判为跳过、App leftovers 只清理失效记录且不删文件、Developer cleanup 对活跃进程做守卫、mo uninstall对系统项/helper/symlink/container 更谨慎——共同目标是宁可保留、fail closed也不误删。如果你想进一步核对本文涉及的具体实现可按命令入口进入对应目录mo clean看 lib/cleanproject.sh、apps.sh、dev.shmo analyze看 cmd/analyzecache.gomo update/mo status看 lib/manage/update.sh 与 cmd/status卸载与删除守卫看 lib/uninstall 与 lib/core/file_ops.sh。所有行为均以当前仓库实际源码为准超时阈值、保护清单等参数也以上述文件中的默认值与可覆盖环境变量为准。【免费下载链接】Mole Clean, uninstall, analyze, optimize, and monitor your Mac. Free open-source CLI, plus a native Mac app.项目地址: https://gitcode.com/GitHub_Trending/mole15/Mole创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考