通过 iCloud API 查询家庭设备的位置与电量，支持 Apple 账号 2FA 认证，适合实时定位追踪与电池状态监控。

基本信息

• 技能名称?iCloud Find My
• 中文名称?家庭设备实时定位与电量监控
• 作者?liamnichols
• 分类?专业技能
• 版本?1.0.0
• 标签?apple-ecosystem, location-tracking, device-management, family-sharing, icloud-api, battery-monitoring, cli-tool

使用方法

使用说明
核心用法
iCloud Find My 技能基于开源库 pyicloud，提供命令行方式访问 Apple 生态系统中的 Find My 网络数据。核心能力包括：

1. 设备定位查询 ：获取 iPhone、iPad、Mac 等设备的实时 GPS 坐标（纬度/经度）、时间戳及精度信息
2. 电池状态监控 ：读取电量百分比（0-100%）及充电状态（Charging/NotCharging）

3. 家庭共享支持 ：通过 --with-family 参数查看家庭成员授权的设备
   典型工作流 ：

   列出所有设备及其状态

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

   提取特定设备的坐标与电量

   icloud --username --with-family --list | grep -A 10 "设备名称" 输出为结构化文本，需配合 grep 、 sed 或 Python eval() 解析 Location 字段中的 Python 字典。

   显著优点
   原生 Apple 集成 ：直接调用 iCloud 官方 API，无需额外硬件或第三方定位服务
   家庭场景友好 ：支持 Family Sharing，父母可监控子女设备，配偶可互查位置
   低延迟更新 ：设备活跃时位置约 1-5 分钟刷新，满足日常追踪需求
   会话持久化 ：一次 2FA 认证后，session 可维持 1-2 个月，减少频繁验证

   零成本 ：开源工具，无订阅费用

   潜在缺点与局限性
   | 限制类型 | 具体说明 | |---------|---------| | 平台锁定 | 仅限 macOS（iCloud API 存在平台特异性），Linux/Windows 用户无法直接使用 | | 隐私合规风险 | 监控家庭成员需对方在 Find My 中明确授权，滥用可能违反当地隐私法规 | | 解析复杂 | Location 字段为 Python 字典字符串，需编程处理，非纯 CLI 友好 | | 认证依赖 | Apple ID 密码 + 2FA 门槛较高，session 过期后需人工重新授权 | | 离线盲区 | 设备关机或关闭定位服务时无数据，不支持历史轨迹回放 | | 名称匹配陷阱 | Unicode 标点（如 U+2019 '）与 ASCII 不一致，grep 易漏匹配 | ---
   适合人群
   Apple 全家桶用户 ：深度依赖 iPhone/Mac/iPad 生态的家庭
   家长监护场景 ：需确认子女设备电量与位置，避免失联焦虑
   智能家居联动 ：基于"在家/离家"状态触发自动化（如开灯、调温）
   开发者/极客 ：愿编写脚本解析输出，整合至个人工作流

   不适合 ：跨平台用户、隐私敏感且无家庭共享授权场景、追求开箱即用的非技术用户。

   常规风险

4. 账户安全风险 ：Apple ID 凭证存储于本地 session，若设备被入侵，攻击者可获取家庭设备实时位置。建议：启用 FileVault 磁盘加密，session 过期后及时清理 ~/.pyicloud 。
5. 误用法律风险 ：未经同意追踪他人设备可能触犯《个人信息保护法》或当地跟踪骚扰法规。
6. API 稳定性 ：pyicloud 为社区维护项目，Apple 随时可能更改 iCloud 端点导致工具失效（历史上有多次 breaking change）。
7. 数据时效误导 ：电池数据可能缓存，低电量提醒需结合时间戳判断，避免决策失误。