灰色方块、黑色方块、蓝色方块的三种典型故障

灰色方块

症状：桌面上显示一个灰色/白色方块，里面什么都没有。

原因：Widgetsmith 配置里你之前创建的那个小组件被你在 Widgetsmith App 里删掉了，但桌面上还留着一个引用。

解决方法：

1. 长按灰块 → Edit Widget
2. 点击 Widget 这一项，从剩余列表里选一个仍然存在的小组件
3. 如果列表空了，去 Widgetsmith App 新建一个再回来选

黑色方块

症状：桌面原本是照片的小组件变成黑色方块。

原因：Widgetsmith 丢失了照片库访问权限，或者你删除了相册里引用的那张原图。

解决方法：

1. 回到 Widgetsmith App，打开那个小组件，重新选择一张照片
2. 如果还不行：Widgetsmith → 设置 → App Privacy Permissions → Photos → Manage → 确保 Full Access（全部访问）已开启

蓝色方块

症状：桌面上出现一个蓝色方块。

原因：小组件想加载的照片或数据超过了 iOS 允许的内存上限。常见于 Large 尺寸 + 超高清照片的组合。

解决方法：

1. 重启设备（FAQ 最推荐的第一步）
2. 把照片换成低分辨率版本
3. Large 尺寸换成 Medium 或 Small
4. 减少一个小组件里同时加载的资源量

万能的"重启 + 打开 Widgetsmith"

Widgetsmith 遇到任何异常，先试：打开 Widgetsmith App 一下 → 关掉 → 回桌面看看。不行再重启。这个组合能解决绝大多数 iOS 侧的小组件刷新 bug。