Stats项目桌面小部件数据不显示问题分析与解决方案

问题概述

Stats是一款macOS系统监控工具，近期在macOS Sequoia(15.0)系统上出现了桌面小部件无法显示数据的问题。用户报告称，虽然菜单栏中的监控数据正常显示，但所有桌面小部件(包括CPU、内存、磁盘等)均显示"No data"或空白状态。

环境特征

该问题主要出现在以下环境中：

• 硬件平台：M系列芯片(M1/M2/M3)的Mac设备，也有少量Intel机型报告
• 操作系统：macOS Sequoia 15.0及以上版本
• Stats版本：2.11.10至2.11.23均有报告

技术分析

根据用户提供的错误日志和代码分析，问题根源在于macOS Sequoia对偏好设置(CFPreferences)系统的修改。具体表现为：

1. 偏好设置读取失败：系统日志显示CFPrefsPlistSource无法读取Stats小部件的偏好设置域(eu.exelban.Stats.widgets)，导致userDefaults返回nil值。

2. 数据流中断：由于无法获取用户配置，小部件代码中的entry.value保持为nil，最终触发"No data"的显示逻辑。

3. 容器权限问题：错误信息表明Sequoia加强了对容器环境下偏好设置访问的限制，特别是当使用kCFPreferencesAnyUser标志时。

解决方案

经过社区验证，以下方法可解决此问题：

1. 重置应用设置：

   • 打开Stats应用
   • 进入"Settings"(设置)
   • 选择"Reset settings"(重置设置)
   • 重启应用

2. 完整修复流程：

   • 确保使用最新版Stats(2.11.23或更高)
   • 备份当前配置(如有需要)
   • 执行重置设置操作
   • 重新添加需要的小部件
   • 必要时重启系统

技术背景

macOS Sequoia引入了更严格的沙盒和安全策略，影响了偏好设置系统的行为。特别是：

• 加强了容器环境下偏好设置的访问控制
• 修改了kCFPreferencesAnyUser标志的使用规则
• 对跨进程偏好设置同步机制进行了调整

这些变化导致部分依赖传统偏好设置访问方式的应用出现兼容性问题。Stats的小部件系统正是因此受到影响。

预防建议

对于开发者：

• 适配macOS最新的偏好设置API
• 实现更健壮的错误处理机制
• 考虑使用替代的数据持久化方案

对于用户：

• 保持应用更新至最新版本
• 定期检查小部件功能状态
• 了解重置设置等基本故障排除方法

总结

Stats在macOS Sequoia上的小部件显示问题主要源于系统底层API变更导致的偏好设置访问异常。通过重置应用设置可以恢复功能，长期解决方案需要开发者进一步适配新的系统安全机制。这类问题也提醒我们，系统大版本升级时，监控类工具可能需要特别关注兼容性适配。