Communitygithub.com

V4TIME/V4SKILL

通过 macOS 上的 FindMy.app 跟踪 Apple 设备和 AirTag。

V4SKILL 是什么?

该技能利用 macOS 的 Find My 应用来定位 Apple 设备和 AirTag,由于缺乏官方 CLI,它采用 AppleScript 自动化实现界面导航,并结合屏幕截图进行位置读取。它支持在终端中通过 AppleScript 或更可靠的 Peekaboo UI 自动化工具进行操作,覆盖设备、物品(如 AirTag)的实时位置查询以及持续监控路线。技能要求系统开启屏幕录制权限,并建议安装 Peekaboo,同时强调 AirTag 仅在页面保持前台时更新位置,限制较多但能有效弥补官方接口不足。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/apple/findmy

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

查找我的 (Apple)

通过 macOS 上的 FindMy.app 跟踪 Apple 设备和 AirTag。由于 Apple 没有为 FindMy 提供 CLI,该技能使用 AppleScript 打开应用并通过屏幕截图读取设备位置。

前提条件

  • macOS 系统,已安装 Find My 应用并登录 iCloud
  • 设备/AirTag 已在 Find My 中注册
  • 终端的屏幕录制权限(系统设置 → 隐私 → 屏幕录制)
  • 可选但推荐:安装 peekaboo 以获得更好的 UI 自动化体验: brew install steipete/tap/peekaboo

使用场景

  • 用户询问“我的[设备/猫/钥匙/包]在哪里?”
  • 跟踪 AirTag 位置
  • 检查设备位置(iPhone、iPad、Mac、AirPods)
  • 随时间监控宠物或物品的移动(AirTag 巡逻路线)

方法 1:AppleScript + 屏幕截图(基础)

打开 FindMy 并导航

# 打开 Find My 应用
osascript -e 'tell application "FindMy" to activate'

# 等待加载
sleep 3

# 截取 Find My 窗口截图
screencapture -w -o /tmp/findmy.png

然后使用 vision_analyze 读取截图:

vision_analyze(image_url="/tmp/findmy.png", question="这张图显示哪些设备/物品及其位置?")

切换标签页

# 切换到设备标签页
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Devices" of toolbar 1 of window 1
    end tell
end tell'

# 切换到物品标签页 (AirTag)
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Items" of toolbar 1 of window 1
    end tell
end tell'

方法 2:Peekaboo UI 自动化(推荐)

如果安装了 peekaboo,可用它实现更可靠的 UI 交互:

# 打开 Find My
osascript -e 'tell application "FindMy" to activate'
sleep 3

# 捕获并标注 UI
peekaboo see --app "FindMy" --annotate --path /tmp/findmy-ui.png

# 按元素 ID 点击特定设备/物品
peekaboo click --on B3 --app "FindMy"

# 捕获详情视图
peekaboo image --app "FindMy" --path /tmp/findmy-detail.png

然后用视觉分析:

vision_analyze(image_url="/tmp/findmy-detail.png", question="该设备/物品显示的位置是什么?包括可见的地址和坐标。")

工作流程:持续跟踪 AirTag 位置

用于监控 AirTag(例如跟踪猫的巡逻路线):

# 1. 打开 FindMy 到物品标签页
osascript -e 'tell application "FindMy" to activate'
sleep 3

# 2. 点击 AirTag 物品(保持页面打开——AirTag 仅在页面打开时更新)

# 3. 定期捕获位置
while true; do
    screencapture -w -o /tmp/findmy-$(date +%H%M%S).png
    sleep 300  # 每 5 分钟
done

用视觉分析每张截图提取坐标,然后汇总路线。

限制

  • FindMy 没有 CLI 或 API——必须使用 UI 自动化
  • AirTag 仅在 FindMy 页面保持前台显示时更新位置
  • 位置精度取决于附近参与 FindMy 网络的 Apple 设备
  • 需要屏幕录制权限才能截取屏幕
  • AppleScript UI 自动化在 macOS 版本间可能失效

规则

  1. 跟踪 AirTag 时保持 FindMy 应用在前台(最小化后更新会停止)
  2. 使用 vision_analyze 读取截图内容——不要尝试解析像素
  3. 对于持续跟踪,使用 cron 任务定期捕获并记录位置
  4. 尊重隐私——仅跟踪用户拥有的设备/物品

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

相关技能