导读：
Shadowrocket桌面小组件可实现节点状态与流量实时监控,本文详解iOS系统添加流程，解析全局路由四种模式差异，并针对小组件不刷新等常见问题提供解决方案。
桌面小组件的核心价值
对于需要频繁切换国际网络加速策略的跨境办公用户,Shadowrocket桌面小组件提供了零层级交互的监控能力，无需打开应用即可查看当前节点延迟、今日流量消耗及连接状态，显著提升多任务处理效率。
小火箭添加桌面小组件操作流程
-
进入编辑模式
长按iOS主屏幕空白区域，待图标抖动后点击左上角"+"按钮 -
选择组件规格
在小组件库搜索"Shadowrocket"，系统提供三种尺寸：- 小号：仅显示当前节点名称与延迟
- 中号：增加流量统计与开关按钮
- 大号：完整展示多节点状态列表
-
完成配置
点击"添加小组件"后，在编辑界面选择"配置"选项，确保关联正确的Shadowrocket配置文件，建议将小组件置于首屏便于学术资源访问时快速监控。
全局路由模式对小组件显示的影响
小组件数据刷新逻辑与Shadowrocket全局路由设置强相关,四种模式差异如下：
配置模式（Config）
Rule-based > 根据规则列表分流小组件显示"规则"字样，流量统计仅计算代理部分，适合精准控制跨境办公流量的用户。
代理模式（Proxy）
Global Proxy > 全部流量经过节点小组件展示总流量消耗,延迟数值反映当前节点到目标服务器的真实质量，适合4K流媒体场景。
直连模式（Direct）
Direct > 不经过任何代理小组件显示"直连"状态，流量统计归零，用于排除本地网络故障。
场景模式（Scene）
SSID/Event Trigger > 自动切换策略小组件根据当前场景自动更新显示内容,如切换至"公司WiFi"场景时自动隐藏敏感节点信息。
常见显示异常排查
现象：小组件长期显示"正在更新"
原因：后台应用刷新权限被系统限制，或当前节点TCP握手超时
解决方法：
设置 > 通用 > 后台App刷新 > 开启Shadowrocket；切换至TCP/UDP双通节点，避免使用仅支持WebSocket的协议。
现象：流量数据与App内不一致
原因：小组件缓存机制与App实时统计存在时间差
解决方法：
长按小组件选择"编辑小组件" > 关闭"使用缓存数据"，强制每次刷新从App获取最新统计。
现象：节点列表显示为空白
原因：配置文件未包含Widget支持的节点分组标签
解决方法：
在配置文件中为节点添加#widget标签，或确保使用支持Widget API的订阅链接（通常以sub://或https://开头且包含完整节点元数据）。
节点服务选择建议
小火箭添加桌面小组件后,延迟数据的准确性直接取决于节点质量，建议选择提供专线中转或IEPL专线的服务商，这类节点具备更稳定的TCP连接保持能力，确保小组件延迟显示与实际使用体验一致，对于需要频繁切换的学术访问场景，优先考虑支持自动故障转移的订阅配置，避免手动刷新小组件时遭遇节点失效。
完成上述设置后,Shadowrocket桌面小组件将成为你跨境办公 workflow 中最高效的状态监控入口。
