iCloud查找功能

通过iCloud命令行界面（pyicloud）访问查找我的设备位置及电池状态。

设置

1. 安装pyicloud：

brew install pipx
pipx install pyicloud

2. 身份验证（一次性操作）：

向用户询问其Apple ID，然后运行：

icloud --username their.email@example.com --with-family --list

用户需要输入密码并完成双重认证。会话将被保存，有效期为1-2个月。

3. 存储Apple ID：

将Apple ID添加到您的TOOLS.md或工作区配置中，以便在后续查询时记住它：

## iCloud Find My
Apple ID: their.email@example.com

使用

列出所有设备

icloud --username APPLE_ID --with-family --list

输出格式：

------------------------------
Name           - Liam's iPhone
Display Name   - iPhone 15 Pro
Location       - {'latitude': 52.248, 'longitude': 0.761, 'timeStamp': 1767810759054, ...}
Battery Level  - 0.72
Battery Status - NotCharging
Device Class   - iPhone
------------------------------

解析提示：

• 设备之间通过------------------------------
• 分隔位置信息是Python字典（使用eval()
• 或正则表达式解析）
• 电池电量范围为0.0-1.0（乘以100得到百分比）
• 电池状态："正在充电"或"未充电"纬度,经度,时间戳（毫秒），水平精度

获取特定设备

通过筛选输出查找特定设备：

icloud --username APPLE_ID --with-family --list | grep -A 10 "iPhone"

解析位置

提取并格式化位置数据：

icloud --username APPLE_ID --with-family --list | \
  grep -A 10 "Device Name" | \
  grep "Location" | \
  sed "s/Location.*- //"

然后使用Python解析Python字典字符串，或使用正则表达式提取坐标。

解析电池信息

icloud --username APPLE_ID --with-family --list | \
  grep -A 10 "Device Name" | \
  grep "Battery Level"

设备名称

设备名称来自iCloud，可能包含：

• 花式Unicode撇号（U+2019 '）而非ASCII的'
• 完全没有撇号（例如，"Lindas iPhone"）

使用不区分大小写的匹配，并在需要时规范化撇号。

会话管理

• 会话持续1-2个月
• 存储在用户的主目录中
• 过期时，重新运行验证步骤
• PyiCloud 会在每次请求时自动验证

常见模式

出门前检查电量：

# Get battery for specific device
icloud --username ID --with-family --list | \
  grep -B 2 -A 5 "iPhone" | \
  grep "Battery Level"

获取当前位置：

# Extract location dict and parse coordinates
icloud --username 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']}\")"

检查设备是否正在充电：

icloud --username ID --with-family --list | \
  grep -A 10 "iPhone" | \
  grep "Battery Status"

主动用例

• 电量警告：在日历事件（外出）前检查电量水平
• 位置情境：通过检查用户的当前位置来回答“附近”查询
• 在家/外出检测：根据坐标检查用户是否在家
• 低电量警报：如果电量 <30% 且未在充电，则发出警告

故障排除

验证错误：

• 会话过期 - 重新验证
• Apple ID 错误 - 检查存储的 ID
• 需要两步验证 - 完成两步验证流程

无可用位置：

• 设备离线
• 查找功能已禁用
• 定位服务关闭

未找到设备：

• 使用以下命令检查确切的设备名称--list
• 名称区分大小写
• 可能包含Unicode撇号

注意事项

• 需要macOS系统（iCloud API存在特殊限制）
• 需启用家庭共享功能才能查看家庭成员设备
• 设备活跃时位置约每1-5分钟更新
• 电量读数可能为缓存数据（请核对时间戳）