Find My Location

核心用法

Find My Location 是一款基于 macOS 的自动化工具，通过操控 Apple 原生 Find My 应用获取已共享位置的联系人实时地址。用户配置目标联系人和已知地点后，工具自动打开 Find My、截取地图界面、读取辅助功能数据，并返回结构化位置信息。

工作流程：
1. 自动启动 Find My 并选择目标联系人
2. 使用 peekaboo 读取屏幕可访问性数据
3. 匹配配置的已知地点地标（如家、公司附近建筑）
4. 输出人类可读或 JSON 格式结果

显著优点

• 原生集成：直接调用 Apple 官方 Find My 应用，数据来源可靠
• 精度可控：支持街道级地址返回，可通过地标匹配减少 AI 视觉依赖
• 灵活输出：提供简洁文本和完整 JSON 两种格式，便于集成
• 开源透明：MIT 许可，代码可审计

潜在缺点与局限性

• 平台锁定：仅支持 macOS 13+，Windows/Linux 用户无法使用
• 权限繁琐：需授予辅助功能和屏幕录制权限，涉及隐私敏感操作
• 外部依赖重：必须安装 peekaboo 和可选的 Hammerspoon，维护成本较高
• fragile 架构：依赖 UI 自动化（点击坐标），macOS 更新可能导致失效
• 隐私合规风险：追踪他人位置需对方主动共享，但自动化采集可能引发伦理争议

适合人群

• 需要自动化获取家人/朋友位置的 macOS 开发者
• 构建个人自动化工作流（如到家触发智能家居）的技术用户
• 对 UI 自动化和 Apple 生态系统有深入了解的用户

常规风险

• 隐私泄露：屏幕截图和位置数据以明文存储于 /tmp
• 账户安全：需要 iCloud 登录状态，工具本身不处理认证但依赖系统会话
• 误操作风险：UI 点击可能因窗口焦点错误触发 unintended 操作
• Apple 政策风险：自动化操控系统应用可能违反 macOS 使用条款，存在未来版本被封禁可能

概述

findmy-location 是一款 macOS 专用命令行工具，利用 Apple Find My 生态系统的位置共享功能，实现对已授权联系人的精准定位追踪。该工具通过 UI 自动化和屏幕辅助功能技术，从 Find My 应用中提取位置信息并转换为可读地址。

核心用法

使用流程分为三步：首先确保 Mac 已登录 iCloud 且目标联系人开启了位置共享；其次安装 peekaboo 工具用于屏幕读取；最后运行命令获取位置。支持两种输出模式——人类可读文本和结构化 JSON，便于集成到其他自动化工作流。

配置文件中可预设常用地点（家、工作地等），工具会自动识别这些位置的视觉标记并标注上下文。若遇陌生地点，会返回截图路径供 AI 视觉分析。

显著优点

• 精度高：直接读取 Find My 原生数据，非第三方定位服务
• 零依赖：纯 Python 标准库实现，无网络 API 调用
• 灵活集成：JSON 输出模式便于自动化场景
• 隐私可控：数据本地处理，不经过外部服务器

潜在缺点与局限性

平台锁定严重：仅支持 macOS 13+，且必须保持 Find My 应用运行。Windows/Linux 用户完全无法使用。

权限门槛极高：需要 Accessibility（辅助功能）和 Screen Recording（屏幕录制）两大敏感权限，这在 macOS 隐私模型中属于最高风险级别。

稳定性依赖外部工具：核心功能依赖 peekaboo 和可选的 Hammerspoon，任何一方的更新都可能导致工具失效。

法律与伦理边界模糊：即使技术上可行（对方已共享位置），自动化追踪和记录他人位置的行为可能触及隐私法律灰色地带。

适合人群

• 需要确认老人/儿童安全的家庭成员
• 频繁协调多位同事外勤位置的团队管理者
• 已将 macOS 作为自动化中枢的高级用户

不适合：隐私敏感型用户、多平台环境、或无法接受高权限要求的场景。

常规风险

• 高权限要求带来的系统攻击面扩大
• 屏幕截图可能意外捕获其他敏感信息
• 配置文件读取范围超出声明功能（USER.md 探测）
• shell=True 存在潜在命令注入通道
• 个人开发者维护，长期更新保障存疑