技能介绍

要解决什么问题

家里猫狗看起来「有点不对」，但还没到必须挂号的程度时，你往往只有一段手机视频或几张照片，很难自己判断是毛发、体态还是面部细节出了问题。本技能面向通过视频做宠物健康参考分析的场景：把本地文件或公网视频 URL 交给后端 API，拿回一份结构化的宠安卫士健康报告，而不是在对话里凭印象瞎猜。

技能如何工作

触发上，用户上传视频/图片、给出 URL，或明确提到宠物健康诊断、宠安报告等关键词时会进入流程；若用户要查看历史报告，技能约定必须走云端列表接口（python -m scripts.pet_analysis --list --open-id），禁止从本地 memory 或 LanceDB 里拼历史记录。

分析主路径在技能根目录执行 scripts/pet_analysis.py：

--input / --url：本地路径或网络地址（公网 URL 由 API 侧下载，不必先落盘到本地再传）
--pet-type：cat / dog / bird / other
--open-id：必填；须按技能规定的流程获取真实用户标识，经 SHA-256 后再传入，不得臆造 default、user123 等占位值
--detail：输出粒度（如 json）

报告侧通常覆盖：基本信息、整体状况、毛发与身体/面部特征、常见疾病预警、养护建议。历史清单会以 Markdown 表格输出，报告名称、宠物类型、分析时间四列，点击查看列用接口字段 reportImageUrl 生成 🔗 查看报告 链接。

适用边界与注意点

视频格式：mp4 / avi / mov，单文件上限约 10MB；画面需能看清整体、毛发与面部，光线尽量充足。
结果仅供健康参考，不能替代执业宠医的诊断与治疗决策。
只能使用技能自带的 scripts/pet_analysis.py，不要临时写替代脚本；API 密钥可选，传入则须保证鉴权成功。

截图预览

使用场景

收到救助站或朋友发来的公网宠物视频 URL，需要在挂号前先跑一遍 API，拿到毛发、体态与预警项的结构化宠安卫士报告。
用户上传本地 mp4/mov 猫咪或狗狗视频，指定 `--pet-type` 后执行分析，核对报告里的面部特征与常见疾病预警是否需进一步就医。
对话里触发「查看历史宠物报告」等关键词时，必须用 `--list --open-id` 调云端接口，把返回记录整理成含 reportImageUrl 的 Markdown 表格。
用户同时提供图片或短视频并明确要做「宠物健康检查」，在拿到有效 open-id（SHA-256 后传入）前不跳过验证直接调分析脚本。