Pet Grooming Effectiveness & Hairball Risk Analysis | 宠物梳毛器梳理效果与毛球风险 — 宠物美容效果与毛球风险分析 | Pet Grooming Effectiveness & Hairball Risk Analysis

宠物梳毛器梳理效果与毛球风险分析 | Pet Grooming Effectiveness & Hairball Risk Analysis 当用户提供宠物梳毛区域视频或图像URL/文件时，触发本技能进行毛发状态分析；支持通过上传本地视频/图片或网络URL，调用服务端API进行识别，检测打结面积占比、梳下毛发量，输出毛球风险等级，帮助预防毛球症。 应用场景：智能梳毛器、长毛宠物护理、宠物健康管理。

AI角色假设：您是一个专业的宠物护理分析AI。您的任务是基于梳毛器区域的视频/图像（梳毛前后），分析宠物毛发的打结程度和梳下的毛发量，评估毛球症风险等级。不要提供医疗诊断或治疗方案，仅客观描述观察到的毛发状态。

任务目标：本Skill用于：通过梳毛器区域视频/图像进行宠物毛发状态分析，获取标准化的梳理效果评估和毛球风险等级 能力包含：视频/图像分析、毛发打结面积检测、梳下毛发量估算、毛球风险等级评估、梳理效果评分、历史趋势对比

触发条件：默认触发：当用户提供梳毛器区域视频/图像URL或文件需要分析时，默认触发本技能进行梳理效果与毛球风险分析 当用户明确需要进行毛发/梳毛监测时，提及梳毛、毛发打结、掉毛量、毛球症、毛球风险、梳理效果、长毛护理、换毛期等关键词，并且上传了视频文件或者图片文件 当用户提及以下关键词时，自动触发历史报告查询功能：查看历史梳毛报告、历史梳理报告、毛球风险报告清单、梳毛分析报告清单、查询历史毛发报告、显示所有梳毛报告、显示毛球风险报告，查询健康风险提示报告

自动行为：如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 强制数据获取规则（次高优先级）：如果用户触发任何历史报告查询关键词（如"查看所有梳毛报告"、"显示所有毛球风险报告"、"查看历史报告"等），必须：直接使用python -m scripts.smyx_grooming_effectiveness_analysis --list --open-id参数调用API查询云端的历史报告数据 严格禁止：从本地memory目录读取历史会话信息、严格禁止手动汇总本地记录中的报告、严格禁止从长期记忆中提取报告 必须统一从云端接口获取最新完整数据，然后以Markdown表格格式输出结果

前置准备 依赖说明：scripts脚本所需的依赖包及版本requests>=2.28.0

操作步骤 open-id获取流程控制（强制执行，防止遗漏） 在执行梳理效果与毛球风险分析前，必须按以下优先级顺序获取open-id： 第1步：【最高优先级】检查技能所在目录的配置文件（优先） 路径：skills/smyx_common/scripts/config.yaml（相对于技能根目录） 完整路径示例：${OPENCLAW_WORKSPACE}/skills/{当前技能目录}/skills/smyx_common/scripts/config.yaml →如果文件存在且配置了api-key字段，则读取api-key作为open-id ↓（未找到/未配置/api-key为空） 第2步：检查workspace公共目录的配置文件 路径：${OPENCLAW_WORKSPACE}/skills/smyx_common/scripts/config.yaml →如果文件存在且配置了api-key字段，则读取api-key作为open-id ↓（未找到/未配置） 第3步：检查用户是否在消息中明确提供了open-id ↓（未提供） 第4步：必须暂停执行，明确提示用户提供用户名或手机号作为open-id 关键约束：禁止自行假设,自行推导,自行生成open-id值（如openclaw-control-ui、default、userC113、user123等） 禁止跳过open-id验证直接调用API 必须在获取到有效open-id后才能继续执行分析 如果用户拒绝提供open-id，说明用途（用于保存和查询历史报告记录），并询问是否继续

标准流程： 准备视频/图像输入 提供本地视频/图片文件路径或网络URL 确保画面清晰展示梳毛器区域，能看到宠物毛发表面状态和梳下的毛发堆积，光线充足，无遮挡 建议提供梳毛前后的对比画面，以获得更准确的梳理效果评估 获取open-id（强制执行） 按上述流程控制获取open-id 如无法获取，必须提示用户提供用户名或手机号 执行梳理效果与毛球风险分析 调用-m scripts.smyx_grooming_effectiveness_analysis处理视频/图像文件（必须在技能根目录下运行脚本） 参数说明：--input：本地视频/图片文件路径；--url：网络视频/图片URL地址（API服务自动下载）；--pet-type：宠物类型，可选值：cat/dog/bird/other，默认cat；--open-id：当前用户的open-id（必填，按上述流程获取）；--list：显示梳毛历史分析报告列表清单（可以输入起始日期参数过滤数据范围）；--api-key：API访问密钥（可选）；--api-url：API服务地址（可选，使用默认值）；--detail：输出详细程度（basic/standard/json，默认json）；--output：结果输出文件路径（可选）

查看分析结果 接收结构化的梳理效果与毛球风险观察报告 包含：毛发打结面积占比（体表可见打结区域面积与总体表面积的比例）、打结严重程度分级（轻度/中度/重度）、梳下毛发量估算（堆积面积或视觉体积评估）、梳理效果评分（基于梳毛前后对比的改善程度）、毛球风险等级（低/中/高/极高）、历史趋势对比（与近期梳毛报告的打结/掉毛趋势变化）

重要提示：仅客观描述观察到的毛发状态，不提供医疗诊断或治疗方案

分析指标说明 指标 说明 风险参考 打结面积占比 毛发表面可见打结/缠结区域占总体表面积的比例 <5% 低风险；5-15% 中风险；15-30% 高风险；>30% 极高风险 打结严重程度 基于打结密度和深度的综合分级 轻度（表面浮毛纠缠）/ 中度（形成毛片）/ 重度（贴皮毛毡化） 梳下毛发量 梳毛后脱落在梳毛器/周围的毛发堆积量 少量（正常代谢）/ 中量（换毛期）/ 大量（异常脱毛需关注） 梳理效果评分 梳毛前后毛发平整度改善程度（0-100） >80 梳理充分；60-80 基本到位；<60 需补充梳理 毛球风险等级 基于打结程度、掉毛量和宠物品种的综合评估 低 / 中 / 高 / 极高 历史趋势 与近期报告对比的打结和掉毛变化趋势 持续加重需关注换毛期或皮肤问题

毛球风险等级定义 风险等级 判定条件 建议措施 低 打结<5%，梳下毛量少，短毛或已充分梳理 维持当前梳理频率即可 中 打结5-15%，梳下毛量中等，轻度缠结 适当增加梳理频次，关注换毛期 高 打结15-30%，梳下毛量较大，有明显毛片 增加每日梳理，考虑化毛膏辅助 极高 打结>30%，梳下毛量很大，贴皮毡化 需专业美容处理，高度关注毛球症风险

资源索引 必要脚本：见 scripts/smyx_grooming_effectiveness_analysis.py（用途：调用API进行梳理效果与毛球风险分析，本地文件上传，网络URL由API服务自动下载） 配置文件：见 scripts/config.py（用途：配置API地址、默认参数和视频格式限制） 领域参考：见 references/api_doc.md（何时读取：需要了解API接口详细规范和错误码时）

注意事项 仅在需要