技能介绍

要解决什么问题

家里装了猫爬架或猫树、又接了固定机位摄像头时，你往往只能凭印象判断猫「爱睡哪一层、会不会上下跳」。连续录像很长，人工逐段盯帧既费时，也很难把各层停留时长和层间跳跃/转移次数量化成一张可对比的图。本技能面向这类素材：用户提供覆盖整座爬架视角的视频（本地文件或公网 URL），由服务端做多区域活动识别，输出结构化报告与 2D 活动热力图，用于观察运动量与行为丰富度，不提供疾病诊断或治疗建议。

技能如何工作

触发条件通常是：用户上传猫爬架/猫树区域视频，或明确提到活动热力图、停留时长、跳跃次数、运动量评估等意图。Agent 在技能根目录调用 python -m scripts.smyx_pet_climbing_frame_heatmap_analysis，通过 --input 或 --url 传入素材；可选 --pet-type（默认 cat）。流程上系统会静默处理用户身份（不向用户索要或展示内部身份参数），脚本调用 API 完成分析后返回：各层停留统计、跳跃/转移计数、活动密度分布及热力图相关结果，并附带报告链接。

若用户要查历史记录，须用 --list 从云端接口拉取清单（禁止从本地 memory 或人工汇总凑表），结果以 Markdown 表格展示，报告字段会转成可点击链接。

适用边界与注意点

输入：支持常见视频格式（如 mp4/avi/mov），单文件大小上限约 10MB；网络 URL 由 API 侧下载，无需你先下到本地。
拍摄：建议固定机位、能覆盖全部层级，连续录制足够时长，热力分布才有参考价值。
输出性质：指标用于丰富度与活动量观察，不能替代兽医判断。
脚本：只能使用技能自带的 scripts/smyx_pet_climbing_frame_heatmap_analysis.py，不要临时拼脚本。

截图预览

使用场景

家中猫爬架固定机位已录好覆盖全层的视频，需要自动统计各层停留时长、层间跳跃次数并生成二维活动热力图。
用户提供猫树区域的公网视频 URL，希望在不上传本地文件的情况下完成多区域活动识别并拿到结构化分析报告。
调整爬架层级或玩具摆放后，用同机位新录像与往期结果对照，观察活动密度与转移次数是否变化。
口头要求查看历史猫爬架活动热力图报告清单时，需从云端接口拉取完整列表并以表格链接形式展示。

适合人员

在家给猫树接摄像头、每周攒一段录像的饲主，想量化猫咪各层停留与跳跃而不是凭印象描述。
正在做猫咪丰容改造的家庭用户，需要用热力图对比改造前后爬架使用分布（仅行为观察，不作疾病判断）。
通过 Agent 执行 `smyx_pet_climbing_frame_heatmap_analysis` 的维护者，需严格用 `--list` 查云端历史报告而非本地记忆。
撰写宠物行为观察笔记或内容的记录者，要把长视频沉淀为带报告链接的停留与转移指标说明。