Repository navigation
Releases: jason840709/MacStorageLens
Release list
MacStorageLens 1.7.5
MacStorageLens 1.7.5 — 系統垃圾規則深度整合與廢紙簍
同一版本的介面修正
1.7.5 Build 32 雖然把規則與廢紙簍功能接進底層,卻又在安全清理頁加入版本專屬的大型「整併位置」卡片。那個設計把 release note 變成永久資訊架構,未來每次更新都可能繼續堆疊一次性區塊。Build 33 在不改變 1.7.5 功能範圍的前提下,撤回這個 UI,重新完成真正的產品整合。
新的清理頁資訊架構
- 六級 profile selector 是唯一入口,不新增第七種模式,也不新增版本專屬功能卡。
- 所選 profile 下方保留一個通用摘要;「掃描範圍與安全規則」會從
CleanupScope.cases(for:)、minimumTier與目前模式動態產生。 - 選取 超激進(L5) 時,摘要內才顯示三項附加功能:高影響可回收資料、廢紙簍永久清空、系統管理項目(僅檢視)。
- 選取 自定義 時,才展開逐項 scope 開關與最低容量設定。
- MacSai 僅以一行低干擾來源說明出現在等級摘要底部;來源資訊不再主導版面。
這個結構沒有綁定 1.7.5。未來新增 CleanupScope 或調整 minimumTier 時,詳情區會沿用同一套模型,不需要再增加「1.7.6 規則位置」「1.7.7 規則位置」等遺留 UI。
六種操作模式
| 操作模式 | 實際內容 |
|---|---|
| 超級保守(L1) | 標準/沙盒/群組快取;Spotify offline 與 broad Gradle state 在 sizing 前排除。 |
| 保守(L2) | 剪貼簿暫存、App web/render cache、停滯 incomplete downloads。 |
| 平衡(L3) | Xcode、Cursor/Antigravity、Claude/Codex 與 package-manager 精確 cache allowlist。 |
| 激進(L4) | 嚴格 bundle-ID App leftovers、可證明損壞的第三方 plist、使用者 logs/diagnostics。 |
| 超激進(L5) | 基礎範圍加入舊 installer/disk image;高影響資料、system review 與廢紙簍永久清空在選取 L5 後以三個獨立、預設關閉的附加開關呈現。 |
| 自定義 | 所有 scope 各自開關;Trash scope 預設不會自動加入既有偏好。 |
廢紙簍的掃描範圍
- 目前使用者
~/.Trash。 /Volumes/<volume>/.Trashes/<目前 UID>,但<volume>必須在執行時再次證明是本機、可寫、非內置、非 Time Machine 的真實外接卷宗 root。
不包含其他 UID、整棵 .Trashes、NAS/伺服器 #recycle、SMB/NFS/WebDAV/AFP/SSHFS 等遠端 mount、符號連結、特殊檔案、控制字元路徑,以及掃描後才新增但未列在候選中的項目。
執行語意
- Trash candidate 為
permanentDeleteMatchedItems,不能再移進 Finder Trash。 - 候選永遠預設未勾選,且
requiresManualSelection == true。 - 執行前重新驗證 root、精確 direct child、類型與 symlink 狀態。
- 逐項呼叫
FileManager.removeItem;部分失敗會留下逐項 failure,不會把整批冒充成功。 - 只刪除 matched items;
~/.Trash或.Trashes/<UID>root 本身保留。 - 清理後使 Trash scope 失效,下一次補充掃描重新列舉。
與 MacSai 的關係
MacSai 的 System Junk 與 Trash Bins implementation 被當成 source-level research reference;MacStorageLens 沒有直接編譯或貼入 MacSai source。整併仍走既有 CleanupEngine、六級風險模型、逐項 selection、live revalidation、外接/NAS capability 與 JSON cleanup log。
MacSai BSD 3-Clause license 與來源說明保存在 ThirdParty/MacSai-LICENSE.txt、THIRD_PARTY_NOTICES.md 與 MACSAI_SOURCE_REVIEW.md。
明確未整併的功能
Universal Binary thinning、語系資源刪除、broken login-item repair、Document Versions、deleted-user data、broad privileged system cache/log、global temp recursion、broad Application Support installer discovery 與 uninstaller-style fuzzy/company matching 都明確留在範圍外。
驗證摘要
- Source-reviewed policy:83 / 83
- Static wiring:40 / 40
- System Junk filesystem:23 / 23
- Developer/AI fixture:25 / 25
- Live revalidation:6 / 6
- Direct delete:6 / 6
- Trash Bins:38 / 38
- Static contract:363 / 363
- Cleanup Incremental Index:31 / 31
完整限制與 macOS-only acceptance 見 docs/VERIFICATION.md。
版本
- App:1.7.5 / Build 33
- Scanner:2.5.3(未修改)
- Cleanup Incremental Index schema:6