宠安卫士水族健康诊断

要解决什么问题

水族宠物生病时，主人往往只能凭肉眼判断，等到白点、烂鳍、体色发暗或游动呆滞已经明显时，干预窗口往往已经偏晚。本技能面向金鱼、锦鲤、斗鱼、虾、蟹等常见物种，把「上传一段能看清体表与游动的视频」变成一份可对照查阅的宠安卫士健康报告，并支持从云端拉取历史记录，而不是依赖本地会话或记忆文件拼凑清单。

技能如何工作

触发方式很直接：用户提供本地视频路径或公网视频 URL（mp4 / avi / mov，单文件上限约 100MB），或在说出「鱼宠健康检查」等意图并附上视频/图片时进入分析流程；若用户要「查看历史鱼宠报告」「显示宠安报告清单」等，则走历史列表分支。

核心执行路径如下：

• 身份标识：分析前必须拿到有效的 open-id（禁止臆造或跳过），用于报告落库与查询；用户不愿提供时需说明用途并确认是否继续。
• 视频分析：在技能根目录调用 scripts/aquarium_analysis.py，本地文件以 multipart/form-data 上传，网络地址由服务端自行下载，无需你先下到本地。
• 逐帧特征：通过服务端 API 解析画面，关注鳞片完整性、鱼鳍舒展、体色光泽、游动活跃度，并对白点病、烂鳍、体色异常、呆滞等迹象做预警，再结合水质相关因素做综合研判。
• 历史报告：列表查询只能走 python -m scripts.aquarium_analysis --list --open-id ... 对接云端；禁止读取 memory/、MEMORY.md 或 LanceDB 等本地记忆充当历史数据源。表格需含报告名称、鱼宠类型、分析时间，并用 reportImageUrl 生成「🔗 查看报告」链接。

可选参数包括 --fish-type（如 goldfish / koi / betta / shrimp / crab 等）、--detail（basic / standard / json）等；上传的附件会自动保存到技能目录下 attachments。

适用边界与注意点

输出仅供健康参考，不能替代专业水族兽医面诊与化验。API 密钥若传入则须保证鉴权成功，否则按文档约定处理。接口异常时也不得回退到本地记忆汇总报告；只能使用技能自带脚本，不要临时拼新脚本。