{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}

Findmy

Theo dõi các thiết bị Apple/AirTags thông qua FindMy.app trên macOS.

Siêu dữ liệu kỹ năng

Nguồn	Đi kèm (được cài đặt theo mặc định)
Đường dẫn

skills/Apple/findmy ` | | Phiên bản |

1.0.0 ` | | Tác giả | Đại lý Hermes | | Giấy phép | MIT | | Nền tảng | macOS | | Thẻ |

FindMy

, `AirTag

, `location

, `tracking

, `macOS

, Apple |

Tham khảo: đầy đủ SKILL.md

thông tin

Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.

Tìm của tôi (Apple)

Theo dõi các thiết bị Apple và AirTags thông qua FindMy.app trên macOS. Vì Apple không cung cấp CLI cho FindMy, kỹ năng này sử dụng AppleScript để mở ứng dụng và chụp màn hình để đọc vị trí thiết bị.

Điều kiện tiên quyết

• macOS với ứng dụng Tìm của tôi và đăng nhập iCloud
• Thiết bị/AirTags đã được đăng ký trong Tìm của tôi
• Quyền ghi màn hình cho terminal (Cài đặt hệ thống → Quyền riêng tư → Ghi màn hình)
• Tùy chọn nhưng được khuyến nghị: Cài đặt peekaboo để tự động hóa giao diện người dùng tốt hơn:

brew install steipete/tap/peekaboo

Khi nào nên sử dụng

• Người dùng hỏi "[thiết bị/mèo/chìa khóa/túi] của tôi ở đâu?"
• Theo dõi vị trí AirTag
• Kiểm tra vị trí thiết bị (iPhone, iPad, Mac, AirPods)
• Giám sát chuyển động của thú cưng hoặc vật phẩm theo thời gian (các tuyến tuần tra AirTag)

Cách 1: AppleScript + Ảnh chụp màn hình (Cơ bản)

Mở FindMy và Điều hướng

# Open Find My app
osascript -e 'tell application "FindMy" to activate'

# Wait for it to load
sleep 3

# Take a screenshot of the Find My window
screencapture -w -o /tmp/findmy.png

`
``Sau đó sử dụng 
`vision_analyze
` để đọc ảnh chụp màn hình:

`

vision_analyze(image_url="/tmp/findmy.png", question="What devices/items are shown and what are their locations?")

`

### Chuyển đổi giữa các tab

``` bash

# Switch to Devices tab
osascript -e '
tell application "System Events"
    tell process "FindMy"
        CLIck button "Devices" of toolbar 1 of window 1
    end tell
end tell'

# Switch to Items tab (AirTags)
osascript -e '
tell application "System Events"
    tell process "FindMy"
        CLIck button "Items" of toolbar 1 of window 1
    end tell
end tell'

`

## Cách 2: Tự động hóa giao diện người dùng Peekaboo (Khuyến nghị)

Nếu 
`peekaboo
` được cài đặt, hãy sử dụng nó để tương tác giao diện người dùng đáng tin cậy hơn:

``` bash

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

# Capture and annotate the UI
peekaboo see --app "FindMy" --annotate --path /tmp/findmy-ui.png

# CLIck on a specific device/item by element ID
peekaboo CLIck --on B3 --app "FindMy"

# Capture the detail view
peekaboo image --app "FindMy" --path /tmp/findmy-detail.png

`
``Sau đó phân tích bằng tầm nhìn:

`

vision_analyze(image_url="/tmp/findmy-detail.png", question="What is the location shown for this device/item? Include address and coordinates if visible.")

`

## Quy trình làm việc: Theo dõi vị trí AirTag theo thời gian

Để theo dõi AirTag (ví dụ: theo dõi lộ trình tuần tra của mèo):

``` bash

# 1. Open FindMy to Items tab
osascript -e 'tell application "FindMy" to activate'
sleep 3

# 2. CLIck on the AirTag item (stay on page — AirTag only updates when page is open)

# 3. Periodically capture location
while true; do
    screencapture -w -o /tmp/findmy-$(date +%H%M%S).png
    sleep 300  # Every 5 minutes
done

`
``Phân tích từng ảnh chụp màn hình bằng tầm nhìn để trích xuất tọa độ, sau đó biên soạn lộ trình.

## Hạn chế
- FindMy **không có CLI hoặc API** — phải sử dụng tính năng tự động hóa giao diện người dùng
- AirTags chỉ cập nhật vị trí khi trang FindMy được hiển thị tích cực
- Độ chính xác của vị trí phụ thuộc vào các thiết bị Apple ở gần trong mạng FindMy
- Cần có quyền Ghi màn hình để chụp ảnh màn hình
- Tự động hóa giao diện người dùng AppleScript có thể bị hỏng trên các phiên bản macOS

## Quy tắc
1. Giữ ứng dụng FindMy ở nền trước khi theo dõi AirTags (dừng cập nhật khi thu nhỏ)
2. Sử dụng 
`vision_analyze
` để đọc nội dung ảnh chụp màn hình — đừng cố phân tích pixel
3. Để theo dõi liên tục, hãy sử dụng cronjob để định kỳ chụp và ghi nhật ký vị trí
4. Tôn trọng quyền riêng tư - chỉ theo dõi các thiết bị/vật phẩm mà người dùng sở hữu