Pet Poop Auto-Clean Trigger (Robot Vacuum Integration) | 宠物排便自动清理触发（联动扫地机） — 宠物排便自动清理触发（Robot Vacuum Integration）

宠物排便自动清理触发（Robot Vacuum Integration） ==============================================

简介

当用户提供狗厕所或宠物固定排便区域视频URL或文件时，触发本技能进行排便事件检测分析；通过安装在狗厕所或宠物固定排便区域的摄像头实时分析视频，识别宠物是否在该区域排便（粪便出现），并在宠物离开该区域后自动输出清扫触发信号，联动扫地机器人前往清理；实现宠物排泄物的即时自动化处理，减轻主人清理负担，保持居家环境卫生。

应用场景

宠物家庭室内狗厕所 阳台排便区 宠物笼舍

注意事项

仅输出基于视觉的事件检测结果，不进行医疗诊断。 视频要求：支持 mp4/avi/mov 格式，最大 10MB API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴权 清扫触发信号仅为本技能输出的"事件标志"，实际驱动扫地机器人需由用户侧的智能家居网关 / 扫地机 OpenAPI（石头/科沃斯/小米等）实现对接

触发条件

默认触发：当用户提供狗厕所/排便区域视频 URL 或文件需要做排便事件检测/自动清扫联动时，默认触发本技能 当用户明确需要联动扫地机清理时，提及狗厕所、宠物排便、自动清理、扫地机联动、智能家居清洁、宠物粪便检测等关键词，并且上传了视频文件或图片文件 当用户提及以下关键词时，自动触发历史报告查询功能：查看历史排便清扫报告、历史清扫触发记录、自动清理报告清单、查询排便事件记录、显示所有清扫触发报告

自动行为

如果用户上传了附件或者视频/图片文件，则自动保存为本地文件

强制数据获取规则

如果用户触发任何历史报告查询关键词（如"查看所有清扫报告"、"显示历史触发记录"、"查看历史报告"等），必须： + 直接使用 python -m scripts.smyx_poop_clean_trigger_analysis --list --open-id 参数调用 API 查询云端的历史报告数据 + 严格禁止：从本地 memory 目录读取历史会话信息、严格禁止手动汇总本地记录中的报告、严格禁止从长期记忆中提取报告 + 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果

前置准备

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

操作步骤

• open-id 获取流程控制：在执行排便事件检测分析前，必须按以下优先级顺序获取 open-id：

第 1 步：检查技能所在目录的配置文件（优先） 第 2 步：检查 workspace 公共目录的配置文件 第 3 步：检查用户是否在消息中明确提供了 open-id 第 4 步：必须暂停执行，明确提示用户提供用户名或手机号作为 open-id

• 标准流程：

准备视频输入：提供本地视频文件路径或网络视频 URL 确保摄像头固定俯拍狗厕所/排便区域，画面包含整个区域，光线充足 获取 open-id（强制执行） 按上述流程控制获取 open-id 如无法获取，必须提示用户提供用户名或手机号 执行排便事件检测分析：调用 -m scripts.smyx_poop_clean_trigger_analysis 处理视频文件（必须在技能根目录下运行脚本）

• 查看分析结果：接收结构化的事件检测报告

包含：宠物入区时间、排便行为开始/结束时间、粪便检出（是/否、估计数量/位置）、宠物离区时间、是否触发清扫信号、清扫触发时间戳、可联动设备建议（扫地机/智能家居平台）

重要提示

仅输出基于视频的事件检测结果，不提供任何医疗诊断或健康判定

资源索引

必要脚本：见 scripts/smyx_poop_clean_trigger_analysis.py（用途：调用 API 进行排便事件检测与清扫触发分析，本地文件上传，网络 URL 由 API 服务自动下载） 配置文件：见 scripts/config.py（用途：配置 API 地址、默认参数和视频格式限制） 领域参考：见 references/api_doc.md（何时读取：需要了解 API 接口详细规范和错误码时）

使用示例

分析本地狗厕所视频：python -m scripts.smyx_poop_clean_trigger_analysis --input /path/to/dog_toilet.mp4 --pet-type dog --open-id your-open-id 分析网络狗厕所视频：python -m scripts.smyx_poop_clean_trigger_analysis --url https://example.com/dog_toilet.mp4 --pet-type dog --open-id your-open-id 显示历史清扫触发报告/分析报告清单列表：python -m scripts.smyx_poop_clean_trigger_analysis --list --open-id your-open-id 输出精简报告：python -m scripts.smyx_poop_clean_trigger_analysis --input toilet.mp4 --pet-type dog --open-id your-open-id --detail basic * 保存结果到文件：python -m scripts.smyx_poop_clean_trigger_analysis --input toilet.mp4 --pet-type dog --open-id your-open-id --output result.json