mcpField
T
tracking-pettracer-location

tracking-pettracer-location

github.com/tristanmanchester其他396 次安装7 周前更新
代码仓库

关于 tracking-pettracer-location

tracking-pettracer-location 是通过非官方门户接口查询 PetTracer 项圈位置证据的技能与辅助脚本，供获授权的宠物主人使用。它区分测量时间、新鲜度和未经验证的精度信息，不保证实时追踪，也不是厂商支持的客户端。

主要功能

  1. 01列出账户设备并定位项圈
  2. 02依据测量时间检查定位时效
  3. 03验证坐标并呈现质量字段
  4. 04获取有时限的时区历史记录
  5. 05标注时间是否位于请求区间

适用场景

  1. 01检查获授权项圈的最新有效定位
  2. 02查看指定时间范围内的位置历史
  3. 03区分旧定位与近期账户联系

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tristanmanchester/agent-skills --skill tracking-pettracer-location

安装后在 Claude Code 中输入/tracking-pettracer-location确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
PORTAL.md
scripts/
pettracer.py
tests/
test_pettracer.py
test_review_regressions.py

详细介绍

PetTracer 位置证据

保留此技能：它解决了特定用户的查询任务。本次审查未确认存在当前官方公开的开发者 API 或替代 CLI。因此，门户辅助工具明确为非官方工具，并非供应商支持的客户端，也不保证能够实时追踪。如果官方应用／门户的行为或账户协议有所不同，请优先使用官方应用／门户。

确认目标和权限

仅使用用户拥有或获准检查的账户／项圈。将实际设备 ID 与账户设备清单和官方应用核对后，再将坐标解释为宠物的位置。HomeStation 配置的位置不是项圈的 GPS 定位结果。若缺少设备类型字段，该类型仍未得到验证；不要根据任意名称或响应中的第一项推断设备类型。

将 SKILL_DIR 解析为此技能的安装目录。私下设置 PETTRACER_TOKEN，或为经授权的登录设置 PETTRACER_USERNAME 和 PETTRACER_PASSWORD。切勿在聊天中索要凭据，也不要将凭据作为命令参数传递。该辅助工具不会存储或打印令牌，也不接受任意 API 源站或凭据重定向。

python "$SKILL_DIR/scripts/pettracer.py" list
python "$SKILL_DIR/scripts/pettracer.py" locate --device-id 12345 --max-age-seconds 900

将示例 ID 替换为已验证的项圈 ID。默认的 900 秒是本地报告阈值，不是制造商的保证，也不适用于所有追踪模式。recent 表示提供的测量时间戳在所选阈值范围内；这并不表示宠物一直待在这些坐标处。

按字面读取时间戳

仅使用 timeMeasure 计算定位结果的时间差。将 timeDb 和 lastContact 分开处理；数据库活动或联系时间较新，并不能让旧位置变新。拒绝不带时区的日期，不要默默将其视为 UTC。未知时间和未来时间是明确的状态，默认都不能视为新鲜定位。显示实际定位时间／时区和时间差，并同时显示检索时间。

该辅助工具会验证经纬度是否为有限值且在有效范围内，并保留零值。它不会估算电池电量，也不会在缺少经过验证的校准／单位约定时转换原始信号／精度字段。acc 和 horiPrec 是彼此独立的原始质量字段，单位未经验证；不要仅因某个社区集成如此处理，就将其中任何一个称为以米为单位的半径。home 是设备标志，不能证明宠物位于精确的地理围栏内。

历史记录

使用明确包含时区的时间窗口，每次辅助工具请求最多七天：

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

这些是示例时间，并非当前请求的时间范围。辅助工具会保留提供方的顺序，并注明数据完整性未经验证。检查返回的时间戳是否位于请求的时间范围内；未知时间戳／超出范围的点仍须保留标记。若要绘制路线，请有意排序或去重，同时保留原始数据和间隔。稀疏 GPS 定位点之间的直线并非宠物实际行走的路径。

实时更新和模式

若要立即寻找宠物或使用实时模式，请使用官方应用／门户。订阅更新本身并不会命令项圈获取新的定位结果。更改模式可能影响电池和设备行为；读取位置时不要顺带更改设置。旧的无界监听器已移除；门户和流式传输 中保留的协议说明描述了明确限定范围的新集成所需的证据，并非经过测试的实时客户端。

除非已实际建立经授权的运行服务／计划任务，否则不要承诺持续监视或未来通知。流式传输失败或没有 GPS 定位结果，并不能证明宠物安全、静止不动、在室内或在家中。

如实报告位置结果

说明选中的项圈、最新的有效测量坐标、测量时间、数据时效状态，以及相关缺失数据或质量信息。单独报告最后联系时间。地图链接可能会向第三方透露精确位置；仅在符合用户请求时才提供，并对原始历史记录保密。不要夸大精度，不要无必要地将精确位置反向地理编码为地址，也不要推断人类的日常规律。

退出码为零表示已处理读取请求，并不代表存在近期 GPS 定位。检查 last_fix.freshness 和 device_type_verified。缺失或无效的定位、架构错误、身份验证失败和历史记录为空，是不同的结果。每个请求的套接字超时和 2 MiB 响应大小上限，并不构成总墙钟时间 SLA。不会自动重试或循环重新登录；重试前请核实异常的端点或架构。

维护者：python -m unittest discover -s "$SKILL_DIR/tests" -v 用于测试解析、选择、请求边界和模拟传输。本次审查未查询任何在线账户或项圈。供应商运营支持：https://help.pettracer.com/。

历史记录结果会保留每条原始记录，并标明其测量时间相对于所请求的闭区间是处于范围内、范围外还是未知。这与定位数据的时效状态分开。lastPos 不是对象属于架构错误，不能据此认定没有 GPS 定位。

评论

支持 Markdown