用途:通过 iCloud CLI(pyicloud)访问 Find My,获取设备位置与电池状态。
主要能力:用 --with-family --list 列出家庭所有设备;输出含设备名、显示名、位置(latitude、longitude、timeStamp 毫秒、horizontalAccuracy)、电量(0.0-1.0)、充电状态(Charging/NotCharging)与设备类型。可按设备名过滤,提取位置字典并用 Python 的 eval() 或正则解析坐标,读取电量或充电状态。典型用途包括出门前查电量、根据坐标判断在家/外出、回答“附近”类问题、电量低于 30% 且未充电时提醒。
使用方式:先安装: brew install pipx pipx install pyicloud 首次认证: icloud --username their.email@example.com --with-family --list 需输入密码并完成双重验证,会话保存 1-2 个月。可将 Apple ID 记入 TOOLS.md 或工作区配置。列出设备: icloud --username APPLE_ID --with-family --list 查找设备: icloud --username APPLE_ID --with-family --list | grep -A 10 "iPhone" 解析坐标: icloud --username APPLE_ID --with-family --list | grep -A 10 "iPhone" | grep "Location" | sed "s/.*- //" | python3 -c "import sys; loc = eval(sys.stdin.read()); print(f"{loc['latitude']}, {loc['longitude']}")"
限制:需 macOS,并开启家庭共享才能查看家庭设备;设备离线、关闭 Find My 或定位服务时无位置;会话过期需重新认证;设备名可能含 Unicode 撇号或不含撇号,大小写敏感,建议忽略大小写并规范化撇号;活跃设备位置约每 1-5 分钟更新,电量可能为缓存值,需核对时间戳。