Before you begin
先备份，再确认版本，再开始修改。
这是最重要的一步。先备份能保留回退空间；先确认版本能避免尝试根本不支持的功能。如果这两件事没做，后面的步骤大概率只会浪费时间。
教程
Nugget 使用教程：从准备环境、连接设备，到第一次应用你真正想要的功能。
这页按实际使用顺序整理：先准备电脑端环境和备份，再确认系统版本，然后连接设备、运行 Nugget、拿到需要的 MobileGestalt 文件，最后再从最容易验证效果的模块开始。
Windows
- 安装 Apple Devices 或 iTunes
- 如果设备无法识别，优先检查数据线、端口和“信任此电脑”提示
Linux
- 安装 usbmuxd
- 安装 libimobiledevice
源码运行
- Python 3.9+
- pymobiledevice3
- PySide6
Step by step
第一次使用建议按这个顺序走，最稳。
先把环境和连接跑通，再进入 tweak 本身，会比上来就试功能稳定很多。
01
先备份设备
开始前先做一次完整备份。这样即使修改后效果不满意，或者出现异常，也有更稳妥的恢复空间。
02
准备电脑环境
Windows 先装 Apple Devices 或 iTunes；Linux 先装 usbmuxd 和 libimobiledevice。如果要从源码运行，还需要 Python 3.9+、pymobiledevice3 和 PySide6。
03
启动 Nugget
你可以使用桌面端现成版本，也可以按源码方式创建虚拟环境、安装依赖，然后运行 `python3 main_app.py`。
04
连接并信任设备
使用数据线连接设备后，在 iPhone 或 iPad 上点击“信任此电脑”。修改过程中不要中途拔线。
05
先从一组简单功能开始
第一次使用建议优先尝试 PosterBoard、状态栏自定义、SpringBoard 选项这类效果明确、容易验证的功能。
06
应用后重启并检查效果
部分修改需要重启或重新加载系统界面。完成后先确认效果是否正常，再继续下一个 tweak。
Version check
在你点任何开关之前，先看自己处在哪个版本范围。
不是所有 tweak 都在所有系统上可用。先看这里，能减少很多误判。
iOS 17.0 - 26.0+
- PosterBoard 动态壁纸与社区壁纸
- 状态栏自定义、SpringBoard 细节调整、内部调试项
- 部分 26.0+ 构建可关闭 Liquid Glass
- 可关闭部分守护进程与高风险隐藏项
iOS 17.0 - 26
- MobileGestalt：Dynamic Island、开机提示音、充电上限等
- 隐藏设置页、地区限制相关开关、Feature Flags
- iOS 17.6 及以下可用 EU Enabler
iOS 18.1 - 26
- AI Enabler
- Device Spoofing
- iOS 26.2 及以上不再支持 MobileGestalt 和 AI Enabler
MobileGestalt
如果你需要 MobileGestalt 相关功能，先把文件准备好。
对于 iOS 26 及以下的部分功能，你可能需要先拿到设备对应的 mobilegestalt 文件。
- 1
在 iPhone 或 iPad 上安装快捷指令 App。
- 2
下载 Save MobileGestalt 快捷指令。
- 3
运行快捷指令并保存生成的文件。
- 4
把文件传到电脑上。
- 5
将文件放到 Python 程序同目录，或在 Nugget 中指定路径。
源码运行命令
python3 -m venv .env
source .env/bin/activate
pip3 install -r requirements.txt
python3 main_app.py
如果你的系统环境不同，命令也可能是 `python / pip` 而不是 `python3 / pip3`。
First tweaks to try
第一次使用，建议先从这些最容易看出效果的模块开始。
先做“看得见结果”的修改，会更容易判断程序是否工作正常。
PosterBoard
- 设置动态壁纸、浏览社区壁纸，或把视频转换成壁纸。
状态栏
- 修改运营商文字、电池显示细节、信号格、时间文本和图标显隐。
SpringBoard 选项
- 尝试锁屏脚注、截图显示 Dynamic Island、充电时不降亮度、锁屏文字等。
MobileGestalt
- 在支持版本上探索 Dynamic Island、充电上限、Tap to Wake、AOD、Stage Manager 等。
Practical tips
遇到问题时，先从连接、版本和操作顺序排查。
大部分新手问题都不是出在功能本身，而是出在前置条件没做好。
如果设备识别异常，先检查是否已经信任电脑，再换线材或端口。
第一次不要同时开启太多项目，先改一项、验证一项，更容易判断问题来源。
遇到版本边界不确定的功能时，先确认系统版本，再决定是否继续尝试。
桌面端打不开时，先排查系统安全策略或权限拦截问题。