MAS-CLI 项目：解决多卷宗应用更新问题的技术方案

在 macOS 生态中，MAS-CLI 作为命令行版的 Mac App Store 工具，近期针对多卷宗环境下应用更新的问题进行了重要优化。本文将深入解析该问题的技术背景、解决方案的设计思路以及实现细节。

问题背景

当用户通过 Time Machine 等备份工具将应用程序备份至挂载卷宗（如 /Volumes/Backup/Applications）时，MAS-CLI 会同时检测到原始安装路径（/Applications）和备份路径中的应用。这导致在系统更新时，备份卷宗中的应用也会被意外更新，破坏了备份的原始状态。

该问题源于 MAS-CLI 的全局应用搜索机制，其设计初衷是为了支持苹果官方的大容量应用存储方案（MAS-designated large app drive）。在 PR #779 合并后，工具会扫描所有卷宗的 Applications 目录。

技术解决方案

核心设计原则

1. 尊重系统偏好：通过读取 com.apple.appstored 域的 PreferredVolume 键值，自动识别系统指定的大容量应用存储位置
2. 最小化影响：默认情况下仅处理系统首选卷宗中的应用，避免干扰备份或其他卷宗
3. 可扩展性：为未来实现更灵活的路径配置预留架构空间

实现细节

1. 系统设置读取：使用 macOS 的 defaults 系统读取应用商店的存储偏好设置

let defaults = UserDefaults(suiteName: "com.apple.appstored")
let preferredVolume = defaults?.string(forKey: "PreferredVolume")

2. 路径解析优化：

• 当存在首选卷宗时，仅扫描 /Applications 和指定卷宗的 Applications 目录
• 无特殊设置时，保持原有行为（扫描所有卷宗）

3. 应用实例去重：

• 对同 bundle ID 的应用实例，优先采用 /Applications 下的版本
• 仅在首选卷宗存在独占应用时才处理该路径下的实例

用户影响与最佳实践

对于普通用户：

• 无需任何配置即可获得符合预期的更新行为
• 备份卷宗中的应用将保持备份时的原始状态

对于高级用户：

• 可通过后续实现的配置系统自定义扫描路径
• 未来版本将支持 glob 模式匹配等高级路径指定方式

技术演进路线

1. 即时方案（v2.2.2）：

• 基于系统偏好设置实现基础路径控制

2. 中期规划：

• 引入配置系统持久化用户设置
• 实现 glob 模式支持（考虑使用 Swift 原生方案或第三方库）

3. 长期发展：

• 完整的路径配置系统
• 用户提示机制（Tip System）引导高级配置

该解决方案既解决了当前用户遇到的备份干扰问题，又为未来的功能扩展奠定了良好的架构基础，体现了 macOS 生态工具对系统特性的深度整合能力。