{"id":"859a4157-c0c5-4c88-a5e0-461156d57c65","entityType":"agent","slug":"clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi","name":"Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）","canonicalUrl":"https://www.xpersona.co/agent/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi","canonicalPath":"/agent/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi","generatedAt":"2026-10-10T11:55:52.189Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:35:45.468Z","emptyReason":null},"description":"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.5K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-social-interaction-analysis-analysis","sourceUrl":"https://clawhub.ai/smyx-sunjinhui/smyx-social-interaction-analysis-analysis","homepage":"https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/smyx-sunjinhui/smyx-social-interaction-analysis-analysis","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动） technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:35:45.468Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:35:45.468Z","emptyReason":null},"stars":null,"forks":null,"downloads":1522,"packageName":null,"latestVersion":"1.0.8","tractionLabel":"1.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:35:45.438Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T09:35:45.468Z","lastCrawledAt":"2026-10-10T09:35:45.438Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T09:35:45.438Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.8","createdAt":"2026-08-26T21:03:30.387Z","changelog":"- Updated SKILL.md to increment the version from 1.0.11 to 1.0.12. - Removed the sample file skill-card.md. - No functional or feature changes to code; documentation only. - Maintains all previous usage, workflow instructions, and feature descriptions.","fileCount":31,"zipByteSize":40207},{"version":"1.0.7","createdAt":"2026-08-20T00:44:35.123Z","changelog":"- Updated skill version to 1.0.11 and SKILL.md content. - Removed the file skill-card.md. - No end-user feature changes or visible skill behavior changes documented. - Project documentation has been revised and versioned.","fileCount":31,"zipByteSize":40096},{"version":"1.0.6","createdAt":"2026-08-15T08:02:29.181Z","changelog":"- Updated SKILL.md to version 1.0.10 with minor content changes and version bump. - Removed the file skill-card.md. - Updated configuration details in skills/smyx_common/scripts/config.yaml. - No changes to core functionality or user-facing features.","fileCount":31,"zipByteSize":40171},{"version":"1.0.5","createdAt":"2026-08-04T22:49:29.759Z","changelog":"- Removed the file skill-card.md. - No changes to skill functionality or code; documentation only change. - Cleanup of root folder by deleting a redundant or outdated documentation file.","fileCount":31,"zipByteSize":40116},{"version":"1.0.4","createdAt":"2026-08-02T08:10:29.246Z","changelog":"- Version updated from 1.0.5 to 1.0.8 in SKILL.md. - Minor documentation edits; no major feature or functionality changes. - skill-card.md has been removed from the repository.","fileCount":31,"zipByteSize":40203},{"version":"1.0.3","createdAt":"2026-07-13T23:39:26.933Z","changelog":"smyx-social-interaction-analysis-analysis 1.0.3 - Internal utility scripts updated: changes made to `skills/smyx_common/scripts/util.py` - Documentation cleanup: removed the redundant `skill-card.md` file","fileCount":31,"zipByteSize":40201},{"version":"1.0.2","createdAt":"2026-07-05T20:37:24.576Z","changelog":"- Updated version to 1.0.5. - Minor documentation changes in SKILL.md. - Removed obsolete file: skill-card.md.","fileCount":31,"zipByteSize":40094},{"version":"1.0.1","createdAt":"2026-07-02T20:17:31.654Z","changelog":"- User identity handling is now fully automated by the backend; users no longer provide or see open-id or related parameters. - Updated workflow and documentation to remove all prompts for user identity input and made the process transparent to the user. - Improved clarity and format of skill documentation, including scenario overview, workflow, resource index, and parameter explanations. - Enhanced consistency for report retrieval: history queries now always use cloud API and never local data. - Sample usage updated to reflect new identity handling and script parameter changes.","fileCount":31,"zipByteSize":39716}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-social-interaction-analysis-analysis","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-social-interaction-analysis-analysis` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/smyx-sunjinhui/smyx-social-interaction-analysis-analysis before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T11:55:52.185Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-social-interaction-analysis-analysi/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:35:45.468Z","emptyReason":null},"readme":"Skill: Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n\nOwner: smyx-sunjinhui\n\nSummary: AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\nTags: latest:1.0.8\n\nVersion history:\n\nv1.0.8 | 2026-08-26T21:03:30.387Z | auto\n\n- Updated SKILL.md to increment the version from 1.0.11 to 1.0.12.\n- Removed the sample file skill-card.md.\n- No functional or feature changes to code; documentation only.\n- Maintains all previous usage, workflow instructions, and feature descriptions.\n\nv1.0.7 | 2026-08-20T00:44:35.123Z | auto\n\n- Updated skill version to 1.0.11 and SKILL.md content.\n- Removed the file skill-card.md.\n- No end-user feature changes or visible skill behavior changes documented.\n- Project documentation has been revised and versioned.\n\nv1.0.6 | 2026-08-15T08:02:29.181Z | auto\n\n- Updated SKILL.md to version 1.0.10 with minor content changes and version bump.\n- Removed the file skill-card.md.\n- Updated configuration details in skills/smyx_common/scripts/config.yaml.\n- No changes to core functionality or user-facing features.\n\nv1.0.5 | 2026-08-04T22:49:29.759Z | auto\n\n- Removed the file skill-card.md.\n- No changes to skill functionality or code; documentation only change.\n- Cleanup of root folder by deleting a redundant or outdated documentation file.\n\nv1.0.4 | 2026-08-02T08:10:29.246Z | auto\n\n- Version updated from 1.0.5 to 1.0.8 in SKILL.md.\n- Minor documentation edits; no major feature or functionality changes.\n- skill-card.md has been removed from the repository.\n\nv1.0.3 | 2026-07-13T23:39:26.933Z | auto\n\nsmyx-social-interaction-analysis-analysis 1.0.3\n\n- Internal utility scripts updated: changes made to `skills/smyx_common/scripts/util.py`\n- Documentation cleanup: removed the redundant `skill-card.md` file\n\nv1.0.2 | 2026-07-05T20:37:24.576Z | auto\n\n- Updated version to 1.0.5.\n- Minor documentation changes in SKILL.md.\n- Removed obsolete file: skill-card.md.\n\nv1.0.1 | 2026-07-02T20:17:31.654Z | auto\n\n- User identity handling is now fully automated by the backend; users no longer provide or see open-id or related parameters.\n- Updated workflow and documentation to remove all prompts for user identity input and made the process transparent to the user.\n- Improved clarity and format of skill documentation, including scenario overview, workflow, resource index, and parameter explanations.\n- Enhanced consistency for report retrieval: history queries now always use cloud API and never local data.\n- Sample usage updated to reflect new identity handling and script parameter changes.\n\nv1.0.0 | 2026-05-23T08:41:18.096Z | auto\n\nInitial release of AI-powered pet social interaction analysis for multi-pet households.\n\n- Detects and classifies cat-cat, dog-dog, and cat-dog interactions (sniffing, chasing, biting, fleeing, hiding, playing) from fixed camera videos.\n- Records duration, frequency, initiator, and receiver for each interaction and generates a structured social-behavior report.\n- Includes strict open-id (user identity) acquisition and validation for report management and history queries.\n- Supports automatic historical report queries with results output as Markdown tables with clickable report links.\n- Designed for multi-pet families, boarding centers, daycare, and animal behavior clinics; provides only behavior observation with no training or medical advice.\n\nArchive index:\n\nArchive v1.0.8: 31 files, 40207 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2591b), SKILL.md (14064b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (472b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.12\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1787778210387\n}\n\nFile v1.0.8:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.8:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.8:scripts/config.yaml\n\n{}\n\nFile v1.0.8:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.8:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.8:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.8:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: dev\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nAnalyzes multi-pet images or videos to classify social behaviors such as sniffing, chasing, biting, fleeing, hiding, and playing, then returns a structured interaction report with durations, frequencies, participants, and potential conflict indicators.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal pet owners, pet boarding centers, pet daycare teams, and animal behavior clinics use this skill to review multi-pet media, quantify interaction patterns, and identify possible aggression or stress signals for observation-oriented reporting.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends pet media and report requests to the publisher's cloud service.\n\nMitigation: Use only media appropriate for third-party processing, obtain consent for shared household, clinic, daycare, or boarding-center footage, and confirm retention and deletion practices before deployment.\n\nRisk: The skill silently creates or reuses an account identity and stores service tokens or user records in the workspace data directory.\n\nMitigation: Run it in an isolated workspace or account, restrict access to workspace data, and clear stored credentials and user records after use when operationally appropriate.\n\nRisk: The skill can retrieve cloud-hosted history for the resolved account identity.\n\nMitigation: Gate history-list workflows behind explicit user intent and verify account and tenant isolation before enabling use with sensitive footage.\n\n## Reference(s):\n\n- [ClawHub Skill Release](https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis)\n- [API 接口文档](references/api_doc.md)\n- [Skill demo](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON]\n\n**Output Format:** [Markdown text containing structured JSON-like analysis content and report links; optional file output when requested.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Can return a structured analysis report or a history list for the resolved account identity.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release metadata; artifact frontmatter says 1.0.12)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.8:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.8:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.7: 31 files, 40096 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2352b), SKILL.md (14064b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (472b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.11\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1787186675123\n}\n\nFile v1.0.7:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.7:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.7:scripts/config.yaml\n\n{}\n\nFile v1.0.7:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.7:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.7:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.7:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: dev\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nAnalyzes multi-pet video or image inputs to classify social interactions, quantify duration, frequency, initiator, and receiver, and return a structured social-behavior report.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal pet owners, pet boarding centers, daycare staff, and behavior-clinic users can analyze multi-pet footage to understand relationships, identify possible conflict or stress patterns, and produce an observational report. The skill is for behavior observation and does not provide medical or training advice.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Pet videos or image inputs may leave the device for remote analysis.\n\nMitigation: Use only footage appropriate for provider processing, and confirm retention, deletion, and access practices before submitting private household media.\n\nRisk: The skill can create or reuse an account-linked local identity and token database.\n\nMitigation: Run it in an isolated workspace when possible, review generated local data, and remove identity or token files when they are no longer needed.\n\nRisk: Cloud report history may be queried for the current workspace identity.\n\nMitigation: Use a dedicated identity for this skill and review or disable automatic history lookup where possible.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis)\n- [API interface documentation](references/api_doc.md)\n- [Skill demo](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, files, guidance]\n\n**Output Format:** [Markdown or JSON text with optional saved file output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Produces structured analysis results, report links, and history-list output when requested.]\n\n## Skill Version(s):\n\n1.0.7 (source: server-resolved release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.7:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.7:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.6: 31 files, 40171 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2523b), SKILL.md (14064b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (472b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.10\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1786780949181\n}\n\nFile v1.0.6:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.6:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.6:scripts/config.yaml\n\n{}\n\nFile v1.0.6:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.6:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.6:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.6:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: dev\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nAnalyzes multi-pet household images or videos to classify social interactions such as sniffing, chasing, biting, fleeing, hiding, and playing, then produces a structured social-behavior report with duration, frequency, initiator, and receiver observations.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and pet-care operators use this skill to analyze multi-pet interactions from fixed-camera footage, quantify friendly, neutral, and conflict behaviors, and review structured social-behavior reports. It is intended for visual behavior observation, not medical, veterinary, or training advice.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Household pet images or video may be uploaded to LifeEmergence-hosted APIs.\n\nMitigation: Use only with informed consent and acceptable data-handling terms; confirm retention, deletion, and access controls before deployment.\n\nRisk: The skill can create or reuse an internal identity and store authentication tokens locally.\n\nMitigation: Review local credential storage and token lifecycle before installation, and prefer a deployment that documents identity and token handling clearly.\n\nRisk: Certain phrases can trigger automatic cloud report history lookup.\n\nMitigation: Require explicit user confirmation before cloud history queries or deploy a version that makes report lookup opt-in.\n\n## Reference(s):\n\n- [Skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis)\n- [API documentation](references/api_doc.md)\n- [Skill usage demo](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and JSON-style structured analysis results, with report links when available]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include analysis progress, behavior classifications, conflict-level observations, recommendations, and cloud report links.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release metadata; artifact frontmatter states 1.0.10)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.6:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.6:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.5: 31 files, 40116 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2497b), SKILL.md (14063b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1785883769759\n}\n\nFile v1.0.5:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.5:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.5:scripts/config.yaml\n\n{}\n\nFile v1.0.5:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.5:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.5:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.5:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nAnalyzes multi-pet images or videos to identify social interactions such as sniffing, chasing, biting, fleeing, hiding, and playing, then returns a structured social-behavior report with durations, frequency, roles, observations, and report links.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users, pet-care operators, and developers use this skill to analyze multi-pet interaction media and produce behavior observations for homes, boarding centers, daycare, and animal behavior clinics. The results are for visual behavior observation and should not be treated as medical or training advice.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill may upload pet videos or media URLs to a remote service for cloud processing.\n\nMitigation: Run it only with footage and URLs approved for cloud processing, and confirm user consent before submitting sensitive media.\n\nRisk: The skill may query cloud report history tied to a resolved user identity.\n\nMitigation: Use approved accounts and review returned history before sharing it outside the intended user context.\n\nRisk: The skill may create or reuse an internal user identity and persist service tokens in the workspace data directory.\n\nMitigation: Install and run it only in trusted workspaces, review local credential storage, and rotate or remove stored tokens when access is no longer needed.\n\n## Reference(s):\n\n- [Skill API Interface Documentation](references/api_doc.md)\n- [Shared Analysis API Interface Documentation](skills/smyx_analysis/references/api_doc.md)\n- [Skill Demo](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON]\n\n**Output Format:** [Markdown report with structured JSON-style analysis results and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write the returned report to a user-specified output file and may return cloud report history for the resolved user identity.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release metadata; artifact frontmatter says 1.0.8)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.5:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.5:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.4: 31 files, 40203 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2739b), SKILL.md (14063b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1785658229246\n}\n\nFile v1.0.4:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.4:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.4:scripts/config.yaml\n\n{}\n\nFile v1.0.4:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.4:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.4:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.4:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nAnalyzes multi-pet videos to classify social interactions such as sniffing, chasing, biting, fleeing, hiding, and playing, then returns a structured social-behavior report with durations, frequencies, initiators, receivers, and report links. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal pet owners, pet boarding centers, pet daycare operators, and animal behavior clinics use this skill to submit multi-pet videos or URLs and receive structured observations about social behavior and possible conflict patterns. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Pet videos or URLs are processed by the LifeEmergence/SMYX cloud service. <br>\nMitigation: Use only footage you are permitted to upload, and review the service owner, retention policy, deletion path, and access controls before processing sensitive home, client, or facility footage. <br>\nRisk: History reports are retrieved from the cloud and associated with the resolved account identity. <br>\nMitigation: Confirm that users understand report history is account-linked, and verify how to revoke access or delete stored reports before relying on the history feature. <br>\nRisk: The skill may create or reuse a local identity and persist account tokens in the workspace data database. <br>\nMitigation: Run the skill in an isolated workspace when possible, and inspect or clear workspace data credentials after use in shared or sensitive environments. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n- [Pet Social Interaction Analysis API doc](references/api_doc.md) <br>\n- [SMYX Analysis API doc](skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, guidance] <br>\n**Output Format:** [Markdown text with structured JSON analysis payloads and report links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include cloud report-history listings and optional saved output files when requested.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release metadata; artifact frontmatter declares 1.0.8) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.4:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.4:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.3: 31 files, 40201 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2787b), SKILL.md (14063b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.5\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1783985966933\n}\n\nFile v1.0.3:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.3:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.3:scripts/config.yaml\n\n{}\n\nFile v1.0.3:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.3:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.3:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.3:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.3:skill-card.md\n\n## Description: <br>\nAnalyzes multi-pet images or videos to identify social interactions, classify behaviors such as sniffing, chasing, biting, fleeing, hiding, and play, and produce a structured behavior report. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal pet owners, boarding centers, daycare operators, and behavior clinics use this skill to analyze multi-pet media for interaction patterns, potential conflict, and social-behavior reports. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Pet or home-camera media and generated report history may be processed by lifeemergence.com cloud services. <br>\nMitigation: Use only with media the user is authorized to share, avoid sensitive scenes, and confirm organizational approval for cloud processing before installation. <br>\nRisk: The skill can silently create or reuse a local identity, authenticate remotely, store returned tokens locally, and fetch report history tied to that identity. <br>\nMitigation: Review local identity and token storage before deployment, restrict runtime access to trusted environments, and clear stored credentials when the skill is no longer needed. <br>\nRisk: Behavior classifications such as play, aggression, stress, or conflict are observational and can be uncertain from visual media alone. <br>\nMitigation: Treat outputs as behavior observations rather than medical or training advice, and route serious conflict or welfare concerns to a qualified professional. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n- [Pet social interaction API documentation](artifact/references/api_doc.md) <br>\n- [Common analysis API documentation](artifact/skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, JSON, Guidance] <br>\n**Output Format:** [Markdown text with structured JSON report content and report links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Can save output to a file when requested; history reports are fetched from the cloud service.] <br>\n\n## Skill Version(s): <br>\n1.0.3 (source: server release metadata; artifact frontmatter says 1.0.5) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.3:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.3:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.2: 31 files, 40094 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2688b), SKILL.md (14063b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28605b), _meta.json (160b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.5\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1783283844576\n}\n\nFile v1.0.2:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.2:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.2:scripts/config.yaml\n\n{}\n\nFile v1.0.2:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.2:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.2:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.2:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.2:skill-card.md\n\n## Description: <br>\nAI-powered pet social interaction analysis for multi-pet households that analyzes pet interaction videos, detects behaviors such as sniffing, chasing, biting, fleeing, hiding, and playing, and produces a structured social-behavior report. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and pet-care operators use this skill to analyze multi-pet household, boarding, daycare, or clinic videos for social behavior patterns, interaction frequency, duration, and potential conflict indicators. The output is for behavior observation and should not be treated as medical or training advice. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill uploads pet videos or video URLs and generated reports to configured Life Emergence cloud services. <br>\nMitigation: Use it only when cloud processing is acceptable for the footage, and review account, retention, and deletion behavior before using private household camera footage. <br>\nRisk: The skill silently creates or reuses an internal identity, may read local identity material, and stores tokens in a workspace SQLite database. <br>\nMitigation: Review the configured identity and local credential storage before installation, isolate the workspace when needed, and remove local tokens or API key files after use. <br>\n\n\n## Reference(s): <br>\n- [Pet Social Interaction Analysis API Documentation](references/api_doc.md) <br>\n- [Common Analysis API Documentation](skills/smyx_analysis/references/api_doc.md) <br>\n- [ClawHub Skill Page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis) <br>\n- [Skill Demo](https://lifeemergence.com/sample.html) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [analysis, markdown, JSON, shell commands, files] <br>\n**Output Format:** [Markdown text containing structured JSON-like analysis results and report links; optional output file when requested] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Can query historical cloud reports and can save results to a user-specified local output path.] <br>\n\n## Skill Version(s): <br>\n1.0.2 (source: server release metadata; artifact frontmatter reports 1.0.5) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.2:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.2:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.1: 31 files, 39716 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3493b), skill-card.md (2245b), SKILL.md (14063b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (22801b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28605b), _meta.json (160b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.4\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行社交行为分析 | 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地多宠互动视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络多宠互动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |\n| `--list` | 显示社交行为分析历史报告列表清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_social_interaction_analysis_analysis.py`](scripts/smyx_social_interaction_analysis_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟 |\n| 🔎 使用提醒 | **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析 |\n| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别 |\n| 🧑‍⚖️ 结果性质 | **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师 |\n| 🔎 使用提醒 | 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json\n```\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1783023451654\n}\n\nFile v1.0.1:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.1:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.1:scripts/config.yaml\n\n{}\n\nFile v1.0.1:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.1:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.1:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.1:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.1:skill-card.md\n\n## Description: <br>\nAnalyzes multi-pet images or videos to classify social interactions, quantify duration, frequency, initiators, and receivers, and return structured social-behavior reports. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users, pet-care operators, and behavior-clinic staff use this skill to submit multi-pet footage or a video URL and receive structured observations about interaction types, participants, frequency, duration, conflict signals, and report links. The skill is for behavior observation support and does not provide medical or training advice. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Pet videos or video URLs may be processed by the publisher's cloud service. <br>\nMitigation: Use only when the publisher's privacy, retention, and deletion terms are acceptable; avoid sensitive household footage. <br>\nRisk: Report history may be tied to an automatically managed persistent identity with local storage of user records and tokens. <br>\nMitigation: Use a separate workspace for evaluation and clear local state and tokens according to organizational policy. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-social-interaction-analysis-analysis) <br>\n- [API 接口文档](references/api_doc.md) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, shell commands] <br>\n**Output Format:** [Markdown report text with optional JSON details and report links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May write the generated report to a user-specified output file.] <br>\n\n## Skill Version(s): <br>\n1.0.1 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.1:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.1:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.0: 31 files, 34754 bytes\n\nFiles: references/api_doc.md (696b), scripts/__init__.py (50b), scripts/api_service.py (1704b), scripts/config.py (705b), scripts/config.yaml (3b), scripts/skill.py (600b), scripts/smyx_social_interaction_analysis_analysis.py (3409b), SKILL.md (13610b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (2094b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1857b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (11394b), skills/smyx_analysis/scripts/smyx_analysis.py (3691b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (45b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2518b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (15835b), skills/smyx_common/scripts/config.yaml (463b), skills/smyx_common/scripts/dao.py (11119b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (18384b), _meta.json (160b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.0\"\n---\n\n# Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🎯 AI 角色\n\n**假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。**\n\n## 任务目标\n\n- 本 Skill 用于：通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n- 能力包含：多宠个体识别与追踪、姿态识别、社交行为分类（友好/中性/对抗）、发起者-接收者关系标注、互动时长与频次统计、社交关系评估、潜在冲突预警\n- 触发条件:\n    1. **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析\n    2. 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件\n    3. 当用户提及以下关键词时，**自动触发历史报告查询功能**\n       ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录\n- 自动行为：\n    1. 如果用户上传了附件或者视频文件，则自动保存为本地文件\n    2. **⚠️ 强制数据获取规则（次高优先级）**：如果用户触发任何历史报告查询关键词（如\"查看所有社交报告\"、\"显示互动记录\"、\"查看历史报告\"等），**必须**：\n        - 直接使用 `python -m scripts.smyx_social_interaction_analysis_analysis --list --open-id` 参数调用 API\n          查询云端的历史报告数据\n        - **严格禁止**：从本地 memory 目录读取历史会话信息、严格禁止手动汇总本地记录中的报告、严格禁止从长期记忆中提取报告\n        - **必须统一**从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果\n\n## 前置准备\n\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 操作步骤\n\n### 🔒 open-id 获取流程控制（强制执行，防止遗漏）\n\n**在执行社交行为分析前，必须按以下优先级顺序获取 open-id：**\n\n```\n第 1 步：【最高优先级】检查技能所在目录的配置文件（优先）\n        路径：skills/smyx_common/scripts/config.yaml（相对于技能根目录）\n        完整路径示例：${OPENCLAW_WORKSPACE}/skills/{当前技能目录}/skills/smyx_common/scripts/config.yaml\n        → 如果文件存在且配置了 api-key 字段，则读取 api-key 作为 open-id\n        ↓ (未找到/未配置/api-key 为空)\n第 2 步：检查 workspace 公共目录的配置文件\n        路径：${OPENCLAW_WORKSPACE}/skills/smyx_common/scripts/config.yaml\n        → 如果文件存在且配置了 api-key 字段，则读取 api-key 作为 open-id\n        ↓ (未找到/未配置)\n第 3 步：检查用户是否在消息中明确提供了 open-id\n        ↓ (未提供)\n第 4 步：❗ 必须暂停执行，明确提示用户提供用户名或手机号作为 open-id\n```\n\n**⚠️ 关键约束：**\n\n- **禁止**自行假设,自行推导,自行生成 open-id 值（如 openclaw-control-ui、default、userC113、user123 等）\n- **禁止**跳过 open-id 验证直接调用 API\n- **必须**在获取到有效 open-id 后才能继续执行分析\n- 如果用户拒绝提供 open-id，说明用途（用于保存和查询历史报告记录），并询问是否继续\n\n---\n\n- 标准流程:\n    1. **准备视频输入**\n        - 提供本地多宠互动视频文件路径或网络视频 URL\n        - 拍摄建议：固定摄像头，视角覆盖宠物主要活动区域，确保画面中可同时看到多只宠物；光线充足，避免遮挡\n        - 视频时长：建议 ≥ 1 分钟，较长视频可覆盖更完整的互动模式\n        - 支持视频格式：mp4/avi/mov\n    2. **获取 open-id（强制执行）**\n        - 按上述流程控制获取 open-id\n        - 如无法获取，必须提示用户提供用户名或手机号\n    3. **执行社交行为分析**\n        - 调用 `-m scripts.smyx_social_interaction_analysis_analysis` 处理视频文件（**必须在技能根目录下运行脚本**）\n        - 参数说明:\n            - `--input`: 本地多宠互动视频文件路径\n            - `--url`: 网络多宠互动视频 URL 地址（API 服务自动下载）\n            - `--pet-type`: 宠物类型，可选值：cat/dog/other，默认 cat\n            - `--open-id`: 当前用户的 open-id（必填，按上述流程获取）\n            - `--list`: 显示社交行为分析历史报告列表清单\n            - `--api-key`: API 访问密钥（可选）\n            - `--api-url`: API 服务地址（可选，使用默认值）\n            - `--detail`: 输出详细程度（basic/standard/json，默认 json）\n            - `--output`: 结果输出文件路径（可选）\n    4. **查看分析结果**\n        - 接收结构化的社交行为分析报告\n        - 包含：**互动行为清单**（类型、发起者、接收者、持续时间、频次）、**行为分类统计**（友好/中性/对抗占比）、**社交关系评估**（配对关系热力图）、**潜在冲突预警**（如\"猫咪A持续追逐猫咪B，可能引发应激，建议增加垂直空间或隔离\"）\n        - **重要提示**：仅输出基于视觉的行为观察结果，**不提供医疗或训练建议**\n\n## 🐾 互动行为分类体系\n\n### 友好行为 🟢\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 嗅闻 | 互相嗅闻头部/尾部/身体 | 正常社交问候、信息交换 |\n| 蹭头/摩擦 | 头部或身体主动蹭对方 | 亲昵标记、信任表达 |\n| 依偎/靠拢 | 身体贴近躺卧或坐在一起 | 亲密关系、安全感 |\n| 互相舔毛 | 一方主动舔舐另一方 | 社交联结、等级关系 |\n| 玩耍互动 | 交替追逐、扑咬（无攻击性） | 友好社交、精力释放 |\n\n### 中性行为 🟡\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 平行活动 | 同空间各自活动，无直接互动 | 共存但不亲密 |\n| 旁观 | 一方注视另一方但未参与 | 好奇或评估 |\n| 绕行 | 一方绕开另一方行走 | 避免冲突的礼貌行为 |\n| 资源共享 | 同时使用食盆/猫砂盆但无争抢 | 关系可接受 |\n\n### 对抗行为 🔴\n\n| 行为 | 特征描述 | 社交含义 |\n|------|----------|----------|\n| 追逐 | 一方持续追赶另一方（非玩耍） | 霸凌、领地驱赶 |\n| 撕咬/攻击 | 带攻击意图的扑咬、拍打 | 直接攻击，需干预 |\n| 威胁姿态 | 哈气、弓背、低吼、露齿 | 警告、防御 |\n| 逃跑 | 一方快速逃离另一方 | 恐惧、被霸凌 |\n| 躲避 | 一方长期躲在角落/高处 | 持续受压、缺乏安全感 |\n\n## 🚨 冲突预警分级\n\n| 等级 | 触发条件 | 建议 |\n|------|----------|------|\n| 🟢 和谐 | 友好行为 > 70%，对抗 < 10% | 社交关系良好，维持现状 |\n| 🟡 轻度紧张 | 对抗 10%-25%，偶有追逐 | 增加资源（食盆/猫砂盆/休息区），观察趋势 |\n| 🟠 明显冲突 | 对抗 25%-50%，某方持续被追 | 建议增加垂直空间/隔离区，考虑行为咨询 |\n| 🔴 严重霸凌 | 对抗 > 50%，某方长期躲避 | ⚠️ 建议立即隔离，寻求专业行为矫正 |\n\n## 💡 多宠家庭环境优化建议参考\n\n| 问题 | 可能原因 | 环境调整方向 |\n|------|----------|--------------|\n| 食盆争抢 | 资源不足 | 增加食盆数量，分散放置 |\n| 猫砂盆冲突 | 猫砂盆太少 | N+1 原则（猫数量+1个砂盆） |\n| 追逐/驱赶 | 领地不足 | 增加垂直空间（猫爬架/高架） |\n| 躲避不出 | 缺乏安全区 | 设置专属躲避窝/高台 |\n| 狗追猫 | 狩猎本能 | 猫狗分离活动区，设置猫专属通道 |\n\n## 资源索引\n\n- 必要脚本：见 [scripts/smyx_social_interaction_analysis_analysis.py](scripts/smyx_social_interaction_analysis_analysis.py)(用途：调用 API 进行社交行为分析，本地文件上传，网络 URL 由 API 服务自动下载)\n- 配置文件：见 [scripts/config.py](scripts/config.py)(用途：配置 API 地址、默认参数和场景代码)\n- 领域参考：见 [references/api_doc.md](references/api_doc.md)(何时读取：需要了解 API 接口详细规范和错误码时)\n\n## 注意事项\n\n- 仅在需要时读取参考文档，保持上下文简洁\n- 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 1 分钟\n- **画面中需同时包含多只宠物**，单只宠物视频无法进行互动分析\n- 摄像头需固定，视角覆盖宠物主要活动区域；移动拍摄可能影响个体追踪与行为识别\n- API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴权\n- **分析结果仅供行为观察参考，不提供医疗或训练建议**；严重冲突建议咨询专业行为师\n- 玩耍与攻击行为在视觉上存在一定重叠（如玩耍中的扑咬），需结合频次、持续时间和双方反应综合判断\n- 禁止临时生成脚本，只能用技能本身的脚本\n- 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载\n- 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段 reportImageUrl 作为超链接地址，且自动转化为如下 Markdown\n  表格格式输出，包含\"报告名称\"、\"宠物类型\"、\"分析时间\"、\"点击查看\"四列，其中\"报告名称\"列使用`社交行为分析报告-{记录id}`形式拼接, \"点击查看\"\n  列使用\n  `[🔗 查看报告](reportImageUrl)`\n  格式的超链接，用户点击即可直接跳转到对应的完整报告页面。\n- 表格输出示例：\n  | 报告名称 | 宠物类型 | 分析时间 | 点击查看 |\n  |----------|----------|----------|----------|\n  | 社交行为分析报告-20260312172200001 | 猫 | 2026-03-12 17:22:00 | [🔗 查看报告](https://example.com/report?id=xxx) |\n\n## 使用示例\n\n```bash\n# 分析本地多宠互动视频（以下只是示例，禁止直接使用openclaw-control-ui 作为 open-id）\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat --open-id your-open-id\n\n# 分析网络多宠互动视频（以下只是示例，禁止直接使用openclaw-control-ui 作为 open-id）\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog --open-id your-open-id\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list --open-id your-open-id\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --open-id your-open-id --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --open-id your-open-id --output result.json\n```\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1779525678096\n}\n\nFile v1.0.0:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）\n\nFile v1.0.0:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口地址\n\n`POST https://your-api-server.com/api/v1/common-analysis`\n\n## 请求头\n\n| 字段           | 必选 | 说明                            |\n|--------------|----|-------------------------------|\n| X-API-Key    | 是  | API访问密钥                       |\n| Content-Type | 是  | 文件上传或 application/json（URL模式） |\n\n## 请求参数\n\n### 1. 文件上传模式\n\n| 字段           | 类型     | 必选 | 说明                                    |\n|--------------|--------|----|---------------------------------------|\n| video        | file   | 是  | MP4视频文件                               |\n| detail_level | string | 否  | 输出详细程度：basic/standard/full，默认standard |\n\n### 2. URL模式\n\n| 字段           | 类型     | 必选 | 说明                                    |\n|--------------|--------|----|---------------------------------------|\n| video_url    | string | 是  | 可公开访问的视频URL                           |\n| detail_level | string | 否  | 输出详细程度：basic/standard/full，默认standard |\n\n## 响应格式\n\n```json\n{\n  \"code\": 200,\n  \"message\": \"success\",\n  \"data\": {\n    \"analysis_time\": \"2026-03-10 15:30:00\",\n    \"face_detection\": {\n      \"status\": \"success\",\n      \"face_count\": 1,\n      \"quality_score\": 95\n    },\n    \"diagnosis\": {\n      \"overall_constitution\": \"平和质\",\n      \"organ_condition\": {\n        \"liver\": \"正常\",\n        \"heart\": \"轻微火旺\",\n        \"spleen\": \"略虚\",\n        \"lung\": \"正常\",\n        \"kidney\": \"正常\"\n      },\n      \"color_analysis\": {\n        \"complexion\": \"微黄\",\n        \"correspondence\": \"脾胃功能略弱\"\n      }\n    },\n    \"health_warnings\": [\n      \"注意休息，避免熬夜\"\n    ],\n    \"suggestions\": [\n      \"饮食清淡，减少辛辣食物摄入\"\n    ]\n  }\n}\n```\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.0:scripts/config.yaml\n\n{}\n\nFile v1.0.0:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.0:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.0:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.0:skills/smyx_common/scripts/config.yaml\n\nenv: prod\n\nApiEnum:\n  api-key:\n  api-secret-key:\n  database-url:\n  base-url-open-api: \"https://open.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitor.lifeemergence.com\"\n  base-url-health: \"https://lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: false\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: \"XIAN_ZHAO_GAN_ZHI\"\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret:\n  default--skill-platform-name: ARK_CLAW\n\nFile v1.0.0:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.0:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3","readmeExcerpt":"Skill: Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动） Owner: smyx-sunjinhui Summary: AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owner","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python -m scripts.smyx_social_interaction_analysis_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json"},{"language":"bash","snippet":"python -m scripts.smyx_social_interaction_analysis_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --input /path/to/multi_pet.mp4 --pet-type cat\n\n# 分析网络多宠互动视频\npython -m scripts.smyx_social_interaction_analysis_analysis --url https://example.com/multi_pet.mp4 --pet-type dog\n\n# 显示历史分析报告/显示报告清单列表（自动触发关键词：查看历史社交报告、互动报告清单等）\npython -m scripts.smyx_social_interaction_analysis_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_social_interaction_analysis_analysis --input video.mp4 --pet-type cat --output result.json"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"smyx-social-interaction-analysis-analysis\"\ndescription: \"AI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics. | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\"\nversion: \"1.0.12\"\nlicense: \"MIT-0\"\n---\n\n# 🐾 Pet Social Interaction Analysis | 宠物社交行为分析（与其他宠物互动）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **宠物社交行为分析（与其他宠物互动）** |\n| 🎯 核心目标 | 通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` |\n\nAI-powered pet social interaction analysis for multi-pet households. Uses pose recognition and behavior classification to detect cat-cat, dog-dog, and cat-dog interactions—sniffing, chasing, biting, fleeing, hiding, playing—then records duration, frequency, initiator and receiver to generate a social-behavior report. Helps owners understand pet relationships, spot aggression or stress sources, and promote harmonious cohabitation. Scenarios: multi-pet homes, pet boarding centers, pet daycare, animal behavior clinics.\n\n通过多宠家庭固定摄像头，分析宠物之间（猫-猫、狗-狗、猫-狗等）的互动视频，利用姿态识别和行为分类模型检测嗅闻、追逐、撕咬、逃跑、躲避、玩耍等行为类型，记录每种行为的持续时间、频次以及发起者，生成社交行为报告。帮助主人了解宠物间的社交关系，识别潜在的攻击行为或压力源，促进多宠和谐共处。应用场景：多宠家庭（多猫/多狗/猫狗混养）、宠物寄养中心、宠物日托班、宠物行为诊所。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的宠物行为学AI。你的任务是分析多宠家庭固定摄像头的视频，识别宠物之间的互动行为类型（嗅闻、追逐、撕咬、逃跑、躲避、玩耍等），记录每种行为的持续时间、频次、发起者和接收者，输出社交行为报告。不要提供医疗或训练建议，仅输出基于视觉的行为观察结果。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n通过多宠互动视频进行社交行为识别与量化，记录互动类型、参与者、持续时间和频次，输出社交关系报告\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 多宠个体识别与追踪 |\n| 2 | 姿态识别 |\n| 3 | 社交行为分类（友好/中性/对抗） |\n| 4 | 发起者-接收者关系标注 |\n| 5 | 互动时长与频次统计 |\n| 6 | 社交关系评估 |\n| 7 | 潜在冲突预警 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供多宠互动视频需要分析时，默认触发本技能进行社交行为分析 |\n| 🔎 明确分析意图 | 当用户明确需要多宠社交评估时，提及多猫、多狗、猫狗混养、宠物打架、追逐、霸凌、互动等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史社交报告、历史互动报告、社交行为报告清单、显示所有社交报告、查询互动记录 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-social-interaction-analysis-analysis\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1787778210387\n}"},{"path":"references/api_doc.md","content":"# API 接口文档\n\n此处用于存放宠物社交行为分析 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/ai-analysis/v2/start-common-ai-analysis` - 启动通用 AI 分析任务（社交行为分析）\n2. `/web/ai-analysis/get-common-ai-analysis-result` - 获取分析结果\n3. `/web/ai-analysis/page-common-ai-analysis-result` - 分页查询历史报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_SOCIAL_INTERACTION_ANALYSIS_ANALYSIS` - 宠物社交行为分析（与其他宠物互动）"},{"path":"skills/smyx_analysis/references/api_doc.md","content":"# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |"},{"path":"scripts/config.yaml","content":"{}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":982,"uniquenessScore":44,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T09:35:45.468Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T09:35:45.468Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T11:55:52.189Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}