把做好的小组件拖到 iPhone 桌面上（9 步标准流程）

完整流程

1. 先在 Widgetsmith 里完成创建并保存——别忘了起名，名字出现在步骤 7 的选择列表里
2. 返回 iPhone 主屏幕
3. 长按主屏幕任意空白区域，直到 App 图标进入"抖动模式"（jiggle mode）
4. 点屏幕左上角的 "+" 按钮，进入小组件选择面板
5. 搜索 "Widgetsmith"，或者向下滚动找到 Widgetsmith 的图标
6. 左右滑动选择你刚才做的小组件尺寸（Small / Medium / Large），点击 Add Widget
7. 长按刚添加到桌面的小组件（此时是默认 Widgetsmith 占位样式），选 Edit Widget
8. 在弹出的面板里，点击 Widget 这一项，从列表中选出你刚才在 Widgetsmith 里创建并命名好的那个小组件
9. 调整一下位置，点屏幕右上角的 Done

常见问题

Widgetsmith 没出现在第 5 步的候选列表里

这是 iOS 系统的已知 bug，解决方法：

• 重启 iPhone，90% 的情况重启后就会出现
• 如果还不行，打开设置 → 通用 → 语言与地区 → 日历，临时切一下再切回来。这个操作会强制 iOS 重建小组件列表
• 确认 Widgetsmith 已经在前台至少打开过一次（刚装完直接去桌面添加经常会找不到）

桌面小组件显示灰色方块

灰色方块通常是因为：你之前在 Widgetsmith 里删除了这个小组件的配置，但桌面上还留着一个指向它的引用。长按桌面的灰块 → Edit Widget → 重新选一个 Widgetsmith 小组件即可。

如果灰块里连选项都没有，直接删掉灰块，重新按上面的流程添加一个。

桌面小组件下方为什么会显示"Widgetsmith"标签

这是 Apple iOS 的强制要求——每一个桌面小组件下方都必须显示提供方的 App 名，Widgetsmith 无法去掉。iPad 桌面例外，Widgetsmith 标签在 iPad 上会自动隐藏。

桌面小组件变黑色方块

黑色方块通常是照片权限丢失了。长按黑块 → Edit Widget → 回到 Widgetsmith App → 重新选一下照片；如果还不行，打开 Widgetsmith 的设置 → App Privacy Permissions → Photos → 设为 Full Access。