用途：在用户拥有或获授权的 PetTracer 账户下，读取项圈清单、最新已知 GPS 定位，或限定时间范围的位置历史。该技能为社区非官方工具，并非厂商支持的客户端，也不保证实时追踪；官方应用或门户行为不一致时应以官方为准。
主要能力：list 列出账户项圈清单；locate 按设备 ID 获取最新定位，可用 --max-age-seconds 设定本地新鲜度阈值（默认 900 秒）；history 按显式时区窗口查询历史，单次请求最多七天。
使用方式：将 SKILL_DIR 解析为已安装技能目录，私下设置 PETTRACER_TOKEN，或设置 PETTRACER_USERNAME 与 PETTRACER_PASSWORD 进行授权登录；不要在聊天中索要凭据，也不要通过命令行参数传递。示例： python "$SKILL_DIR/scripts/pettracer.py" list python "$SKILL_DIR/scripts/pettracer.py" locate --device-id 12345 --max-age-seconds 900 python "$SKILL_DIR/scripts/pettracer.py" history --device-id 12345 --from-time 2026-09-13T06:00:00+02:00 --to-time 2026-09-13T12:00:00+02:00
限制与注意：仅使用 timeMeasure 计算定位年龄，timeDb 与 lastContact 需分开看待；无时区日期应拒绝而非默认 UTC。acc 与 horiPrec 为未验证单位的原始质量字段，不能当作米半径。home 只是设备标志，不等于精确地理围栏内。历史结果保留原始顺序，完整性未经验证，稀疏定位点之间的直线并非实际路径。退出码为零仅表示读取已处理，不代表存在新定位；需检查 last_fix.freshness 与 device_type_verified。无自动重试或重新登录循环。维护者可运行 python -m unittest discover -s "$SKILL_DIR/tests" -v 测试解析、选择、请求边界与模拟传输。厂商帮助：https://help.pettracer.com/。