{"id":"e2b407a0-5215-4ca4-af89-bcd77044d22b","entityType":"agent","slug":"clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal","name":"Fish Flashing & Scraping Detection (Ectoparasite Warning) | 爬宠体温调节行为识别（晒点/躲避）","canonicalUrl":"https://www.xpersona.co/agent/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal","canonicalPath":"/agent/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal","generatedAt":"2026-10-10T11:00:03.589Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T04:47:25.529Z","emptyReason":null},"description":"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 Skill: Fish Flashing & Scraping Detection (Ectoparasite Warning) | 爬宠体温调节行为识别（晒点/躲避） Owner: 18072937735 Summary: Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-reptile-thermoregulation-behavior-analysis","sourceUrl":"https://clawhub.ai/18072937735/smyx-reptile-thermoregulation-behavior-analysis","homepage":"https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/18072937735/smyx-reptile-thermoregulation-behavior-analysis","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration be"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:47:25.529Z","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-10T04:47:25.529Z","emptyReason":null},"stars":null,"forks":null,"downloads":1673,"packageName":null,"latestVersion":"1.0.12","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:47:25.529Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T04:47:25.529Z","lastCrawledAt":"2026-10-10T04:47:25.529Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T04:47:25.529Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.12","createdAt":"2026-09-29T20:42:31.913Z","changelog":"- Removed the file: skill-card.md - No feature or logic changes in the core skill. - Documentation and functionality unaffected by this removal.","fileCount":31,"zipByteSize":45514},{"version":"1.0.11","createdAt":"2026-09-24T07:55:34.044Z","changelog":"- Updated version number to 1.0.15 in SKILL.md to reflect the latest release. - SKILL.md content revised; no major functional or descriptive changes identified. - Configuration (config.yaml) updated. - Removed obsolete file: skill-card.md.","fileCount":31,"zipByteSize":45879},{"version":"1.0.10","createdAt":"2026-09-14T02:20:28.723Z","changelog":"- Updated version to 1.0.13 in SKILL.md. - Removed the file skill-card.md. - No changes to skill functionality or logic; documentation and metadata only.","fileCount":31,"zipByteSize":45715},{"version":"1.0.9","createdAt":"2026-08-24T20:13:30.646Z","changelog":"- Updated skill version to 1.0.10. - SKILL.md refined; no functional or workflow changes described. - skill-card.md file has been removed. - No new user-facing commands or features added in this release.","fileCount":31,"zipByteSize":45742},{"version":"1.0.8","createdAt":"2026-08-19T11:57:30.276Z","changelog":"- Removed the file: skill-card.md - No changes to functionality or user-facing features. - This update only deletes an internal documentation file.","fileCount":31,"zipByteSize":45847},{"version":"1.0.7","createdAt":"2026-08-15T10:58:28.393Z","changelog":"Version 1.0.7 Changelog - Updated documentation (SKILL.md) content and version number. - Made changes to config.yaml script for skill configuration. - Removed the file skill-card.md from the project.","fileCount":31,"zipByteSize":45797},{"version":"1.0.6","createdAt":"2026-08-04T11:47:33.116Z","changelog":"- Removed the file: skill-card.md - No changes to core functionality or user experience. - Housekeeping update only; documentation file cleanup.","fileCount":31,"zipByteSize":45689},{"version":"1.0.5","createdAt":"2026-07-29T00:27:28.544Z","changelog":"- Version updated from 1.0.5 to 1.0.8. - Documentation significantly revised and expanded in SKILL.md. - skill-card.md file removed. - No changes to code or functionality; update is documentation-focused.","fileCount":31,"zipByteSize":45898}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-reptile-thermoregulation-behavior-analysis","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"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-18072937735-smyx-reptile-thermoregulation-behavior-anal/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/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:00:03.584Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-reptile-thermoregulation-behavior-anal/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":"high","updatedAt":"2026-10-10T04:47:25.529Z","emptyReason":null},"readme":"Skill: Fish Flashing & Scraping Detection (Ectoparasite Warning) | 爬宠体温调节行为识别（晒点/躲避）\n\nOwner: 18072937735\n\nSummary: Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\n\nTags: latest:1.0.12\n\nVersion history:\n\nv1.0.12 | 2026-09-29T20:42:31.913Z | auto\n\n- Removed the file: skill-card.md\n- No feature or logic changes in the core skill.\n- Documentation and functionality unaffected by this removal.\n\nv1.0.11 | 2026-09-24T07:55:34.044Z | auto\n\n- Updated version number to 1.0.15 in SKILL.md to reflect the latest release.\n- SKILL.md content revised; no major functional or descriptive changes identified.\n- Configuration (config.yaml) updated.\n- Removed obsolete file: skill-card.md.\n\nv1.0.10 | 2026-09-14T02:20:28.723Z | auto\n\n- Updated version to 1.0.13 in SKILL.md.\n- Removed the file skill-card.md.\n- No changes to skill functionality or logic; documentation and metadata only.\n\nv1.0.9 | 2026-08-24T20:13:30.646Z | auto\n\n- Updated skill version to 1.0.10.\n- SKILL.md refined; no functional or workflow changes described.\n- skill-card.md file has been removed.\n- No new user-facing commands or features added in this release.\n\nv1.0.8 | 2026-08-19T11:57:30.276Z | auto\n\n- Removed the file: skill-card.md\n- No changes to functionality or user-facing features. \n- This update only deletes an internal documentation file.\n\nv1.0.7 | 2026-08-15T10:58:28.393Z | auto\n\nVersion 1.0.7 Changelog\n\n- Updated documentation (SKILL.md) content and version number.\n- Made changes to config.yaml script for skill configuration.\n- Removed the file skill-card.md from the project.\n\nv1.0.6 | 2026-08-04T11:47:33.116Z | auto\n\n- Removed the file: skill-card.md\n- No changes to core functionality or user experience.\n- Housekeeping update only; documentation file cleanup.\n\nv1.0.5 | 2026-07-29T00:27:28.544Z | auto\n\n- Version updated from 1.0.5 to 1.0.8.\n- Documentation significantly revised and expanded in SKILL.md.\n- skill-card.md file removed.\n- No changes to code or functionality; update is documentation-focused.\n\nv1.0.4 | 2026-07-13T17:49:29.448Z | auto\n\n- Updated version to 1.0.5 in SKILL.md.\n- Removed the redundant skill-card.md file.\n- Modified utility script (skills/smyx_common/scripts/util.py); details not specified.\n- General documentation and metadata improvements.\n\nv1.0.3 | 2026-07-08T20:15:30.331Z | auto\n\n- Updated version to 1.0.4 in SKILL.md.\n- SKILL.md revised: minor text and formatting adjustments; version bump only.\n- No changes to code logic or APIs.\n\nv1.0.2 | 2026-07-02T19:37:30.310Z | auto\n\nsmyx-reptile-thermoregulation-behavior-analysis 1.0.2\n\n- Internal Python files updated: scripts/dao.py and scripts/util.py.\n- Documentation cleanup: removed skill-card.md file. \n- No user-facing changes in functionality or workflow.\n\nv1.0.1 | 2026-06-27T05:45:26.169Z | auto\n\n- Major update: Identity handling and data security improved, with refined workflows and user experience.\n- Internal user identity (open-id) is now processed automatically; users are never prompted to input or see identity values.\n- Cloud-only querying for historical reports enforced; all manual/local history lookups are strictly forbidden.\n- Documentation, resource index, and workflow instructions reorganized for greater clarity and compliance with privacy standards.\n- Outdated files removed; detailed parameter tables and scenario codes added for developer reference.\n- Skill description and usage expanded to better guide both end-users and developers.\n\nv1.0.0 | 2026-06-08T04:56:42.947Z | auto\n\nsmyx-reptile-thermoregulation-behavior-analysis v1.0.0\n\n- Initial release of automated reptile behavior analysis for thermoregulation.\n- Supports video-based monitoring of lizards, snakes, and turtles using fixed enclosure cameras.\n- Detects and reports movement frequency and dwell duration between basking and hiding zones.\n- Outputs daily thermal zone utilization reports, including preference classification and activity rhythms.\n- Provides alert escalation based on behavioral anomalies, with species-specific logic and context-awareness.\n- Strict open-id control and cloud-based historical report retrieval included.\n\nArchive index:\n\nArchive v1.0.12: 31 files, 45514 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2004b), SKILL.md (18597b), 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 (167b)\n\nFile v1.0.12:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.15\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行爬宠体温调节行为识别 | 调用 `-m scripts.smyx_reptile_thermoregulation_behavior_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地爬宠箱固定摄像头视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络爬宠箱固定摄像头视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 类别标识，爬宠体温调节场景默认 `other` | 按需填写 |\n| `--list` | 显示爬宠温区利用历史报告清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_reptile_thermoregulation_behavior_analysis.py`](scripts/smyx_reptile_thermoregulation_behavior_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；**视野必须同时覆盖晒点+躲避+冷区+过渡区**；帧率 ≥ 15 FPS；**加热灯/UVB 灯必须开启**；默认 ≥ 2 小时（建议 24 小时完整节律） |\n| 🔎 使用提醒 | **核心采样窗口**：≥ 2 小时滚动窗口（体温调节是慢节律行为，1 小时内无法建立完整节律） |\n| 🔎 使用提醒 | **核心输出**：`thermal_preference_label`（basking_preferred / hiding_preferred / frequent_shuttling / balanced / abnormal_immobility） |\n| 🔎 使用提醒 | **4 级提醒策略递进**（info → important → urgent → critical），侧重环境优化与福利改善 |\n| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限 |\n| 🔎 使用提醒 | 红线约束 |\n| 🧑⚖️ 结果性质 | **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等具体疾病诊断 |\n| 🔎 使用提醒 | **🚨 绝对禁止**输出具体药物名称、剂量、给药方案 |\n| 🔎 使用提醒 | **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定） |\n| 🔎 使用提醒 | **禁止**用于商业广告 / AI 训练；禁第三方共享 |\n| 🔎 使用提醒 | **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议） |\n| 🔎 使用提醒 | **绝对禁止**伪造或夸大温区停留占比、移动频次等指标；所有数据必须基于真实视频帧分析 |\n| 🔎 使用提醒 | **必须**按 **species（精确到物种）** 匹配基线（夜行种：豹纹守宫 / 鞭尾蜥 / 部分壁虎昼间多躲避属正常；昼行种：鬃狮蜥 / 蓝舌 / 变色龙 / 水龙昼间应多晒点；晨昏行种早晚活动高峰）；**禁止使用通用阈值盲判夜行种昼间躲避为异常** |\n| 📚 文档读取 | **必须**考虑生理性上下文（**蜕皮期偏好躲避（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判 |\n| 🔎 使用提醒 | **必须**在 UVB/加热设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80% 时返回 `thermoregulation_signal_unreliable` 并建议调整摄像头或在设备开启后重新分析 |\n| 🔎 使用提醒 | **必须**：连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n| 📜 报告输出 | **必须**：温区利用报告**按 enclosure_id + 日期输出**，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史温区利用报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json\n```\n\nFile v1.0.12:_meta.json\n\n{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.12\",\n \"publishedAt\": 1790714551913\n}\n\nFile v1.0.12: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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80%）\n\n## 4 级提醒策略递进（侧重环境优化与福利改善，非疾病诊断）\n\n- Level 1（balanced / basking_preferred_normal / hiding_preferred_normal）：仅入库 + 用户 APP 积极反馈\"温区利用正常，当前环境设置适宜\"\n- Level 2（frequent_shuttling_abnormal）：重要提示，建议**评估温度梯度（晒点/冷区温差是否在物种适宜范围内）/ 检查加热设备是否故障或位置不当 / 评估躲避区数量是否足够**\n- Level 3（excessive_hiding / excessive_basking）：紧急提示，建议**立即检查环境参数（晒点温度/冷区温度/UVB 强度/湿度）+ 近距离观察宠物体表/食欲/排泄 / 如持续 ≥ 72 小时则联系爬宠兽医**\n- Level 4（abnormal_immobility）：最高紧急提示 + 推送所有管理人员 + 强烈建议**立即检查宠物反应（轻轻触碰是否有反应）/ 立即测各温区实际温度 / 联系爬宠兽医（异常不动可能是严重疾病信号）**\n\n## 单日提醒上限\n\n- Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限\n\n## 红线约束\n\n- **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等**具体疾病诊断**\n- **🚨 绝对禁止**输出具体药物名称、剂量、给药方案\n- **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定）\n- **禁止**用于商业广告 / AI 训练；禁第三方共享\n- **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议）\n- 温区停留占比 / 移动频次等指标必须基于真实视频帧分析；**禁止伪造或夸大指标**\n- 物种特异性：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**（某些石龙子 / 守宫）早晚活动高峰 → 必须**按物种基线判定**；**严禁通用阈值盲判夜行种昼间躲避为异常**\n- 必须考虑生理性上下文：**蜕皮期偏好躲避（湿度需求）/ 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化** → 不可直接告警\n- UVB / 加热设备关闭时 → 无法区分温区 → 必须返回 `thermoregulation_signal_unreliable` 并建议在设备开启后重新分析\n- 视野未覆盖所有温区（晒点/躲避/冷区缺一）/ 跟踪率 < 80% → 必须返回 `thermoregulation_signal_unreliable` 并建议调整摄像头\n- 必须告知用户：AI 行为分析仅供参考，**最终环境优化与疾病判断需用户结合现场观察并由专业爬宠兽医确认**\n\n## 输出报告字段\n\n- `report_date` - 报告日期\n- `enclosure_id` - 爬宠箱 ID\n- `species` - 宠物物种\n- `basking_temp_setting_c` - 晒点温度设定\n- `cool_zone_temp_setting_c` - 冷区温度设定\n- `basking_zone_duration_ratio` - 晒点区停留占比\n- `hiding_zone_duration_ratio` - 躲避区停留占比\n- `zone_transitions_per_hour` - 每小时移动次数\n- `thermal_preference_label` - 温区偏好标签\n- `activity_rhythm_consistency_score` - 节律一致性\n- `composite_scene` - 综合判定\n- `alert_level` - 提醒等级\n- `recommended_actions` - 建议动作（评估温度梯度 / 检查设备 / 观察体表食欲排泄 / 联系爬宠兽医，**不含药物**）\n- `disclaimer` - 免责声明\n\nFile v1.0.12: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.12:scripts/config.yaml\n\n{}\n\nFile v1.0.12:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.12: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.12: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.12: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.12:skill-card.md\n\n## Description:\n\nAnalyzes reptile enclosure video to summarize movement and time spent in basking and hiding zones.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nReptile keepers and enclosure operators use this skill to review basking and hiding patterns, receive environmental guidance, and consult past reports.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Enclosure media or URLs are sent to a configured cloud service.\n\nMitigation: Review the destination and obtain approval before sharing enclosure footage or links.\n\nRisk: The skill silently creates or reuses a local identity database containing account tokens and history context.\n\nMitigation: Avoid shared workspaces unless access to the local identity and cloud report history is controlled.\n\nRisk: Behavioral warnings may be mistaken for a veterinary diagnosis.\n\nMitigation: Check species-specific baselines and recording conditions; consult a reptile veterinarian for persistent or severe symptoms.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis)\n- [Skill API documentation](artifact/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [Structured analysis text or JSON; Markdown tables for report history]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes zone-use metrics, alerts, recommendations, and report links when available.]\n\n## Skill Version(s):\n\n1.0.12 (source: server-resolved ClawHub release; bundled frontmatter lists 1.0.15)\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.12:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.12:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.11: 31 files, 45879 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2922b), SKILL.md (18597b), 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 (167b)\n\nFile v1.0.11:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.15\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行爬宠体温调节行为识别 | 调用 `-m scripts.smyx_reptile_thermoregulation_behavior_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地爬宠箱固定摄像头视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络爬宠箱固定摄像头视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 类别标识，爬宠体温调节场景默认 `other` | 按需填写 |\n| `--list` | 显示爬宠温区利用历史报告清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_reptile_thermoregulation_behavior_analysis.py`](scripts/smyx_reptile_thermoregulation_behavior_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；**视野必须同时覆盖晒点+躲避+冷区+过渡区**；帧率 ≥ 15 FPS；**加热灯/UVB 灯必须开启**；默认 ≥ 2 小时（建议 24 小时完整节律） |\n| 🔎 使用提醒 | **核心采样窗口**：≥ 2 小时滚动窗口（体温调节是慢节律行为，1 小时内无法建立完整节律） |\n| 🔎 使用提醒 | **核心输出**：`thermal_preference_label`（basking_preferred / hiding_preferred / frequent_shuttling / balanced / abnormal_immobility） |\n| 🔎 使用提醒 | **4 级提醒策略递进**（info → important → urgent → critical），侧重环境优化与福利改善 |\n| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限 |\n| 🔎 使用提醒 | 红线约束 |\n| 🧑⚖️ 结果性质 | **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等具体疾病诊断 |\n| 🔎 使用提醒 | **🚨 绝对禁止**输出具体药物名称、剂量、给药方案 |\n| 🔎 使用提醒 | **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定） |\n| 🔎 使用提醒 | **禁止**用于商业广告 / AI 训练；禁第三方共享 |\n| 🔎 使用提醒 | **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议） |\n| 🔎 使用提醒 | **绝对禁止**伪造或夸大温区停留占比、移动频次等指标；所有数据必须基于真实视频帧分析 |\n| 🔎 使用提醒 | **必须**按 **species（精确到物种）** 匹配基线（夜行种：豹纹守宫 / 鞭尾蜥 / 部分壁虎昼间多躲避属正常；昼行种：鬃狮蜥 / 蓝舌 / 变色龙 / 水龙昼间应多晒点；晨昏行种早晚活动高峰）；**禁止使用通用阈值盲判夜行种昼间躲避为异常** |\n| 📚 文档读取 | **必须**考虑生理性上下文（**蜕皮期偏好躲避（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判 |\n| 🔎 使用提醒 | **必须**在 UVB/加热设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80% 时返回 `thermoregulation_signal_unreliable` 并建议调整摄像头或在设备开启后重新分析 |\n| 🔎 使用提醒 | **必须**：连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n| 📜 报告输出 | **必须**：温区利用报告**按 enclosure_id + 日期输出**，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史温区利用报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json\n```\n\nFile v1.0.11:_meta.json\n\n{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.11\",\n \"publishedAt\": 1790236534044\n}\n\nFile v1.0.11: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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80%）\n\n## 4 级提醒策略递进（侧重环境优化与福利改善，非疾病诊断）\n\n- Level 1（balanced / basking_preferred_normal / hiding_preferred_normal）：仅入库 + 用户 APP 积极反馈\"温区利用正常，当前环境设置适宜\"\n- Level 2（frequent_shuttling_abnormal）：重要提示，建议**评估温度梯度（晒点/冷区温差是否在物种适宜范围内）/ 检查加热设备是否故障或位置不当 / 评估躲避区数量是否足够**\n- Level 3（excessive_hiding / excessive_basking）：紧急提示，建议**立即检查环境参数（晒点温度/冷区温度/UVB 强度/湿度）+ 近距离观察宠物体表/食欲/排泄 / 如持续 ≥ 72 小时则联系爬宠兽医**\n- Level 4（abnormal_immobility）：最高紧急提示 + 推送所有管理人员 + 强烈建议**立即检查宠物反应（轻轻触碰是否有反应）/ 立即测各温区实际温度 / 联系爬宠兽医（异常不动可能是严重疾病信号）**\n\n## 单日提醒上限\n\n- Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限\n\n## 红线约束\n\n- **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等**具体疾病诊断**\n- **🚨 绝对禁止**输出具体药物名称、剂量、给药方案\n- **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定）\n- **禁止**用于商业广告 / AI 训练；禁第三方共享\n- **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议）\n- 温区停留占比 / 移动频次等指标必须基于真实视频帧分析；**禁止伪造或夸大指标**\n- 物种特异性：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**（某些石龙子 / 守宫）早晚活动高峰 → 必须**按物种基线判定**；**严禁通用阈值盲判夜行种昼间躲避为异常**\n- 必须考虑生理性上下文：**蜕皮期偏好躲避（湿度需求）/ 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化** → 不可直接告警\n- UVB / 加热设备关闭时 → 无法区分温区 → 必须返回 `thermoregulation_signal_unreliable` 并建议在设备开启后重新分析\n- 视野未覆盖所有温区（晒点/躲避/冷区缺一）/ 跟踪率 < 80% → 必须返回 `thermoregulation_signal_unreliable` 并建议调整摄像头\n- 必须告知用户：AI 行为分析仅供参考，**最终环境优化与疾病判断需用户结合现场观察并由专业爬宠兽医确认**\n\n## 输出报告字段\n\n- `report_date` - 报告日期\n- `enclosure_id` - 爬宠箱 ID\n- `species` - 宠物物种\n- `basking_temp_setting_c` - 晒点温度设定\n- `cool_zone_temp_setting_c` - 冷区温度设定\n- `basking_zone_duration_ratio` - 晒点区停留占比\n- `hiding_zone_duration_ratio` - 躲避区停留占比\n- `zone_transitions_per_hour` - 每小时移动次数\n- `thermal_preference_label` - 温区偏好标签\n- `activity_rhythm_consistency_score` - 节律一致性\n- `composite_scene` - 综合判定\n- `alert_level` - 提醒等级\n- `recommended_actions` - 建议动作（评估温度梯度 / 检查设备 / 观察体表食欲排泄 / 联系爬宠兽医，**不含药物**）\n- `disclaimer` - 免责声明\n\nFile v1.0.11: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.11:scripts/config.yaml\n\n{}\n\nFile v1.0.11:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.11: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.11: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.11: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.11:skill-card.md\n\n## Description:\n\nThrough fixed enclosure cameras, the skill analyzes reptile behavior videos to report movement frequency, dwell duration, thermal-zone preference, activity rhythm, and recommended husbandry follow-up for basking, hiding, cool, and transition zones.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal reptile keepers, vivarium operators, and developers use this skill to analyze fixed-camera reptile enclosure video or media URLs and produce thermal-zone utilization reports. It supports welfare-oriented review of basking, hiding, movement frequency, activity rhythm, and non-diagnostic recommendations.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Reptile enclosure media or media URLs may be sent to the configured cloud service.\n\nMitigation: Use only media you are authorized to share, review the service and retention behavior before deployment, and avoid sensitive household footage unless the cloud-processing path is approved.\n\nRisk: The skill creates or reuses an internal identity and stores service tokens locally.\n\nMitigation: Run the skill in an isolated workspace, review local token storage before use, and clear workspace credentials when the skill is no longer needed.\n\nRisk: Historical cloud reports may be queried without clear user-facing control.\n\nMitigation: Confirm that the operator is authorized to access historical reports and review returned report links before using them for decisions.\n\nRisk: Behavior analysis can be mistaken for veterinary diagnosis.\n\nMitigation: Treat outputs as welfare and environment-review guidance only, avoid medication or disease conclusions, and consult a qualified reptile veterinarian for health concerns.\n\n## Reference(s):\n\n- [API interface documentation](artifact/references/api_doc.md)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown and JSON-like structured analysis reports with command examples and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Reports may include enclosure ID, species, zone dwell ratios, movement frequency, rhythm consistency, thermal preference label, alert level, recommended actions, and disclaimers.]\n\n## Skill Version(s):\n\n1.0.11 (source: server release metadata; artifact frontmatter says 1.0.15)\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.11:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.11:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.10: 31 files, 45715 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2529b), SKILL.md (18597b), 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 (167b)\n\nFile v1.0.10:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.13\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行爬宠体温调节行为识别 | 调用 `-m scripts.smyx_reptile_thermoregulation_behavior_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地爬宠箱固定摄像头视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络爬宠箱固定摄像头视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 类别标识，爬宠体温调节场景默认 `other` | 按需填写 |\n| `--list` | 显示爬宠温区利用历史报告清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_reptile_thermoregulation_behavior_analysis.py`](scripts/smyx_reptile_thermoregulation_behavior_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；**视野必须同时覆盖晒点+躲避+冷区+过渡区**；帧率 ≥ 15 FPS；**加热灯/UVB 灯必须开启**；默认 ≥ 2 小时（建议 24 小时完整节律） |\n| 🔎 使用提醒 | **核心采样窗口**：≥ 2 小时滚动窗口（体温调节是慢节律行为，1 小时内无法建立完整节律） |\n| 🔎 使用提醒 | **核心输出**：`thermal_preference_label`（basking_preferred / hiding_preferred / frequent_shuttling / balanced / abnormal_immobility） |\n| 🔎 使用提醒 | **4 级提醒策略递进**（info → important → urgent → critical），侧重环境优化与福利改善 |\n| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限 |\n| 🔎 使用提醒 | 红线约束 |\n| 🧑⚖️ 结果性质 | **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等具体疾病诊断 |\n| 🔎 使用提醒 | **🚨 绝对禁止**输出具体药物名称、剂量、给药方案 |\n| 🔎 使用提醒 | **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定） |\n| 🔎 使用提醒 | **禁止**用于商业广告 / AI 训练；禁第三方共享 |\n| 🔎 使用提醒 | **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议） |\n| 🔎 使用提醒 | **绝对禁止**伪造或夸大温区停留占比、移动频次等指标；所有数据必须基于真实视频帧分析 |\n| 🔎 使用提醒 | **必须**按 **species（精确到物种）** 匹配基线（夜行种：豹纹守宫 / 鞭尾蜥 / 部分壁虎昼间多躲避属正常；昼行种：鬃狮蜥 / 蓝舌 / 变色龙 / 水龙昼间应多晒点；晨昏行种早晚活动高峰）；**禁止使用通用阈值盲判夜行种昼间躲避为异常** |\n| 📚 文档读取 | **必须**考虑生理性上下文（**蜕皮期偏好躲避（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判 |\n| 🔎 使用提醒 | **必须**在 UVB/加热设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80% 时返回 `thermoregulation_signal_unreliable` 并建议调整摄像头或在设备开启后重新分析 |\n| 🔎 使用提醒 | **必须**：连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n| 📜 报告输出 | **必须**：温区利用报告**按 enclosure_id + 日期输出**，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史温区利用报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json\n```\n\nFile v1.0.10:_meta.json\n\n{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.10\",\n \"publishedAt\": 1789352428723\n}\n\nFile v1.0.10: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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80%）\n\n## 4 级提醒策略递进（侧重环境优化与福利改善，非疾病诊断）\n\n- Level 1（balanced / basking_preferred_normal / hiding_preferred_normal）：仅入库 + 用户 APP 积极反馈\"温区利用正常，当前环境设置适宜\"\n- Level 2（frequent_shuttling_abnormal）：重要提示，建议**评估温度梯度（晒点/冷区温差是否在物种适宜范围内）/ 检查加热设备是否故障或位置不当 / 评估躲避区数量是否足够**\n- Level 3（excessive_hiding / excessive_basking）：紧急提示，建议**立即检查环境参数（晒点温度/冷区温度/UVB 强度/湿度）+ 近距离观察宠物体表/食欲/排泄 / 如持续 ≥ 72 小时则联系爬宠兽医**\n- Level 4（abnormal_immobility）：最高紧急提示 + 推送所有管理人员 + 强烈建议**立即检查宠物反应（轻轻触碰是否有反应）/ 立即测各温区实际温度 / 联系爬宠兽医（异常不动可能是严重疾病信号）**\n\n## 单日提醒上限\n\n- Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限\n\n## 红线约束\n\n- **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等**具体疾病诊断**\n- **🚨 绝对禁止**输出具体药物名称、剂量、给药方案\n- **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定）\n- **禁止**用于商业广告 / AI 训练；禁第三方共享\n- **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议）\n- 温区停留占比 / 移动频次等指标必须基于真实视频帧分析；**禁止伪造或夸大指标**\n- 物种特异性：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**（某些石龙子 / 守宫）早晚活动高峰 → 必须**按物种基线判定**；**严禁通用阈值盲判夜行种昼间躲避为异常**\n- 必须考虑生理性上下文：**蜕皮期偏好躲避（湿度需求）/ 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化** → 不可直接告警\n- UVB / 加热设备关闭时 → 无法区分温区 → 必须返回 `thermoregulation_signal_unreliable` 并建议在设备开启后重新分析\n- 视野未覆盖所有温区（晒点/躲避/冷区缺一）/ 跟踪率 < 80% → 必须返回 `thermoregulation_signal_unreliable` 并建议调整摄像头\n- 必须告知用户：AI 行为分析仅供参考，**最终环境优化与疾病判断需用户结合现场观察并由专业爬宠兽医确认**\n\n## 输出报告字段\n\n- `report_date` - 报告日期\n- `enclosure_id` - 爬宠箱 ID\n- `species` - 宠物物种\n- `basking_temp_setting_c` - 晒点温度设定\n- `cool_zone_temp_setting_c` - 冷区温度设定\n- `basking_zone_duration_ratio` - 晒点区停留占比\n- `hiding_zone_duration_ratio` - 躲避区停留占比\n- `zone_transitions_per_hour` - 每小时移动次数\n- `thermal_preference_label` - 温区偏好标签\n- `activity_rhythm_consistency_score` - 节律一致性\n- `composite_scene` - 综合判定\n- `alert_level` - 提醒等级\n- `recommended_actions` - 建议动作（评估温度梯度 / 检查设备 / 观察体表食欲排泄 / 联系爬宠兽医，**不含药物**）\n- `disclaimer` - 免责声明\n\nFile v1.0.10: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.10:scripts/config.yaml\n\n{}\n\nFile v1.0.10:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.10: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.10: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.10: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.10:skill-card.md\n\n## Description:\n\nThrough fixed enclosure cameras, the skill analyzes reptile enclosure videos to report movement frequency, dwell duration, thermal-zone preference, activity rhythm, and abnormal basking or hiding patterns.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal reptile keepers, vivarium operators, and developers use this skill to analyze fixed-camera reptile footage, summarize basking and hiding behavior, and generate thermal-zone utilization reports with non-diagnostic care guidance.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Enclosure footage and generated reports are processed by the publisher's cloud service.\n\nMitigation: Use the skill only with footage and report data suitable for that third-party service, and require clear data retention and deletion commitments before sensitive deployment.\n\nRisk: Security evidence reports cached cloud identity tokens and plaintext development endpoints.\n\nMitigation: Require production HTTPS-only endpoints, documented token storage behavior, and removal of plaintext token persistence before operational use.\n\nRisk: Behavior analysis can be mistaken for veterinary diagnosis or direct device-control authority.\n\nMitigation: Keep outputs limited to behavior statistics and care suggestions, require user confirmation for environment changes, and refer medical concerns to a qualified reptile veterinarian.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis)\n- [API 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, Guidance]\n\n**Output Format:** [Markdown or JSON reports with analysis results, alert levels, recommended actions, and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Outputs should avoid disease diagnoses, medication names, dosage instructions, and unsupported metric claims.]\n\n## Skill Version(s):\n\n1.0.10 (source: server release metadata; artifact frontmatter reports 1.0.13)\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.10:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.10:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.9: 31 files, 45742 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2585b), SKILL.md (18597b), 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 (166b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.10\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行爬宠体温调节行为识别 | 调用 `-m scripts.smyx_reptile_thermoregulation_behavior_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地爬宠箱固定摄像头视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络爬宠箱固定摄像头视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 类别标识，爬宠体温调节场景默认 `other` | 按需填写 |\n| `--list` | 显示爬宠温区利用历史报告清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_reptile_thermoregulation_behavior_analysis.py`](scripts/smyx_reptile_thermoregulation_behavior_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；**视野必须同时覆盖晒点+躲避+冷区+过渡区**；帧率 ≥ 15 FPS；**加热灯/UVB 灯必须开启**；默认 ≥ 2 小时（建议 24 小时完整节律） |\n| 🔎 使用提醒 | **核心采样窗口**：≥ 2 小时滚动窗口（体温调节是慢节律行为，1 小时内无法建立完整节律） |\n| 🔎 使用提醒 | **核心输出**：`thermal_preference_label`（basking_preferred / hiding_preferred / frequent_shuttling / balanced / abnormal_immobility） |\n| 🔎 使用提醒 | **4 级提醒策略递进**（info → important → urgent → critical），侧重环境优化与福利改善 |\n| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限 |\n| 🔎 使用提醒 | 红线约束 |\n| 🧑⚖️ 结果性质 | **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等具体疾病诊断 |\n| 🔎 使用提醒 | **🚨 绝对禁止**输出具体药物名称、剂量、给药方案 |\n| 🔎 使用提醒 | **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定） |\n| 🔎 使用提醒 | **禁止**用于商业广告 / AI 训练；禁第三方共享 |\n| 🔎 使用提醒 | **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议） |\n| 🔎 使用提醒 | **绝对禁止**伪造或夸大温区停留占比、移动频次等指标；所有数据必须基于真实视频帧分析 |\n| 🔎 使用提醒 | **必须**按 **species（精确到物种）** 匹配基线（夜行种：豹纹守宫 / 鞭尾蜥 / 部分壁虎昼间多躲避属正常；昼行种：鬃狮蜥 / 蓝舌 / 变色龙 / 水龙昼间应多晒点；晨昏行种早晚活动高峰）；**禁止使用通用阈值盲判夜行种昼间躲避为异常** |\n| 📚 文档读取 | **必须**考虑生理性上下文（**蜕皮期偏好躲避（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判 |\n| 🔎 使用提醒 | **必须**在 UVB/加热设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80% 时返回 `thermoregulation_signal_unreliable` 并建议调整摄像头或在设备开启后重新分析 |\n| 🔎 使用提醒 | **必须**：连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n| 📜 报告输出 | **必须**：温区利用报告**按 enclosure_id + 日期输出**，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史温区利用报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json\n```\n\nFile v1.0.9:_meta.json\n\n{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.9\",\n \"publishedAt\": 1787602410646\n}\n\nFile v1.0.9: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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80%）\n\n## 4 级提醒策略递进（侧重环境优化与福利改善，非疾病诊断）\n\n- Level 1（balanced / basking_preferred_normal / hiding_preferred_normal）：仅入库 + 用户 APP 积极反馈\"温区利用正常，当前环境设置适宜\"\n- Level 2（frequent_shuttling_abnormal）：重要提示，建议**评估温度梯度（晒点/冷区温差是否在物种适宜范围内）/ 检查加热设备是否故障或位置不当 / 评估躲避区数量是否足够**\n- Level 3（excessive_hiding / excessive_basking）：紧急提示，建议**立即检查环境参数（晒点温度/冷区温度/UVB 强度/湿度）+ 近距离观察宠物体表/食欲/排泄 / 如持续 ≥ 72 小时则联系爬宠兽医**\n- Level 4（abnormal_immobility）：最高紧急提示 + 推送所有管理人员 + 强烈建议**立即检查宠物反应（轻轻触碰是否有反应）/ 立即测各温区实际温度 / 联系爬宠兽医（异常不动可能是严重疾病信号）**\n\n## 单日提醒上限\n\n- Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限\n\n## 红线约束\n\n- **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等**具体疾病诊断**\n- **🚨 绝对禁止**输出具体药物名称、剂量、给药方案\n- **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定）\n- **禁止**用于商业广告 / AI 训练；禁第三方共享\n- **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议）\n- 温区停留占比 / 移动频次等指标必须基于真实视频帧分析；**禁止伪造或夸大指标**\n- 物种特异性：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**（某些石龙子 / 守宫）早晚活动高峰 → 必须**按物种基线判定**；**严禁通用阈值盲判夜行种昼间躲避为异常**\n- 必须考虑生理性上下文：**蜕皮期偏好躲避（湿度需求）/ 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化** → 不可直接告警\n- UVB / 加热设备关闭时 → 无法区分温区 → 必须返回 `thermoregulation_signal_unreliable` 并建议在设备开启后重新分析\n- 视野未覆盖所有温区（晒点/躲避/冷区缺一）/ 跟踪率 < 80% → 必须返回 `thermoregulation_signal_unreliable` 并建议调整摄像头\n- 必须告知用户：AI 行为分析仅供参考，**最终环境优化与疾病判断需用户结合现场观察并由专业爬宠兽医确认**\n\n## 输出报告字段\n\n- `report_date` - 报告日期\n- `enclosure_id` - 爬宠箱 ID\n- `species` - 宠物物种\n- `basking_temp_setting_c` - 晒点温度设定\n- `cool_zone_temp_setting_c` - 冷区温度设定\n- `basking_zone_duration_ratio` - 晒点区停留占比\n- `hiding_zone_duration_ratio` - 躲避区停留占比\n- `zone_transitions_per_hour` - 每小时移动次数\n- `thermal_preference_label` - 温区偏好标签\n- `activity_rhythm_consistency_score` - 节律一致性\n- `composite_scene` - 综合判定\n- `alert_level` - 提醒等级\n- `recommended_actions` - 建议动作（评估温度梯度 / 检查设备 / 观察体表食欲排泄 / 联系爬宠兽医，**不含药物**）\n- `disclaimer` - 免责声明\n\nFile v1.0.9: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.9:scripts/config.yaml\n\n{}\n\nFile v1.0.9:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.9: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.9: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.9: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.9:skill-card.md\n\n## Description:\n\nAnalyzes fixed-camera reptile enclosure video to report basking, hiding, cool-zone dwell time, zone transitions, activity rhythm, thermal preference labels, alerts, and report links.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal reptile keepers, breeders, and smart vivarium app developers use this skill to analyze enclosure videos or URLs for thermal-zone use, behavior rhythm, and environment-related warning signals. The skill is intended to provide behavior statistics and care guidance, not veterinary diagnosis or medication instructions.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Reptile enclosure videos and account-linked report history are sent to the configured cloud service.\n\nMitigation: Install only when that data sharing is acceptable, review endpoint configuration before use, and avoid submitting sensitive footage unless permitted.\n\nRisk: The skill creates local identity and token state with limited user control.\n\nMitigation: Use an isolated workspace for shared machines, review identity handling before deployment, and remove local state when the skill is no longer needed.\n\nRisk: The security scan verdict is suspicious because of cloud-backed analysis, silent identity handling, media upload, report-history access, and local token storage.\n\nMitigation: Perform deployment review before use and restrict operation to users who understand the cloud, identity, and report-history behavior.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis)\n- [API documentation](references/api_doc.md)\n- [Skill 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:** [JSON or Markdown report text with behavior metrics, recommended actions, and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include thermal preference labels, alert levels, historical report tables, and exported report URLs.]\n\n## Skill Version(s):\n\n1.0.9 (source: server release metadata; artifact frontmatter says 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.9:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.9:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.8: 31 files, 45847 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2740b), SKILL.md (18596b), 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 (166b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.9\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行爬宠体温调节行为识别 | 调用 `-m scripts.smyx_reptile_thermoregulation_behavior_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地爬宠箱固定摄像头视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络爬宠箱固定摄像头视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 类别标识，爬宠体温调节场景默认 `other` | 按需填写 |\n| `--list` | 显示爬宠温区利用历史报告清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_reptile_thermoregulation_behavior_analysis.py`](scripts/smyx_reptile_thermoregulation_behavior_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；**视野必须同时覆盖晒点+躲避+冷区+过渡区**；帧率 ≥ 15 FPS；**加热灯/UVB 灯必须开启**；默认 ≥ 2 小时（建议 24 小时完整节律） |\n| 🔎 使用提醒 | **核心采样窗口**：≥ 2 小时滚动窗口（体温调节是慢节律行为，1 小时内无法建立完整节律） |\n| 🔎 使用提醒 | **核心输出**：`thermal_preference_label`（basking_preferred / hiding_preferred / frequent_shuttling / balanced / abnormal_immobility） |\n| 🔎 使用提醒 | **4 级提醒策略递进**（info → important → urgent → critical），侧重环境优化与福利改善 |\n| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限 |\n| 🔎 使用提醒 | 红线约束 |\n| 🧑⚖️ 结果性质 | **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等具体疾病诊断 |\n| 🔎 使用提醒 | **🚨 绝对禁止**输出具体药物名称、剂量、给药方案 |\n| 🔎 使用提醒 | **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定） |\n| 🔎 使用提醒 | **禁止**用于商业广告 / AI 训练；禁第三方共享 |\n| 🔎 使用提醒 | **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议） |\n| 🔎 使用提醒 | **绝对禁止**伪造或夸大温区停留占比、移动频次等指标；所有数据必须基于真实视频帧分析 |\n| 🔎 使用提醒 | **必须**按 **species（精确到物种）** 匹配基线（夜行种：豹纹守宫 / 鞭尾蜥 / 部分壁虎昼间多躲避属正常；昼行种：鬃狮蜥 / 蓝舌 / 变色龙 / 水龙昼间应多晒点；晨昏行种早晚活动高峰）；**禁止使用通用阈值盲判夜行种昼间躲避为异常** |\n| 📚 文档读取 | **必须**考虑生理性上下文（**蜕皮期偏好躲避（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判 |\n| 🔎 使用提醒 | **必须**在 UVB/加热设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80% 时返回 `thermoregulation_signal_unreliable` 并建议调整摄像头或在设备开启后重新分析 |\n| 🔎 使用提醒 | **必须**：连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n| 📜 报告输出 | **必须**：温区利用报告**按 enclosure_id + 日期输出**，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史温区利用报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json\n```\n\nFile v1.0.8:_meta.json\n\n{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.8\",\n \"publishedAt\": 1787140650276\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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80%）\n\n## 4 级提醒策略递进（侧重环境优化与福利改善，非疾病诊断）\n\n- Level 1（balanced / basking_preferred_normal / hiding_preferred_normal）：仅入库 + 用户 APP 积极反馈\"温区利用正常，当前环境设置适宜\"\n- Level 2（frequent_shuttling_abnormal）：重要提示，建议**评估温度梯度（晒点/冷区温差是否在物种适宜范围内）/ 检查加热设备是否故障或位置不当 / 评估躲避区数量是否足够**\n- Level 3（excessive_hiding / excessive_basking）：紧急提示，建议**立即检查环境参数（晒点温度/冷区温度/UVB 强度/湿度）+ 近距离观察宠物体表/食欲/排泄 / 如持续 ≥ 72 小时则联系爬宠兽医**\n- Level 4（abnormal_immobility）：最高紧急提示 + 推送所有管理人员 + 强烈建议**立即检查宠物反应（轻轻触碰是否有反应）/ 立即测各温区实际温度 / 联系爬宠兽医（异常不动可能是严重疾病信号）**\n\n## 单日提醒上限\n\n- Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限\n\n## 红线约束\n\n- **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等**具体疾病诊断**\n- **🚨 绝对禁止**输出具体药物名称、剂量、给药方案\n- **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定）\n- **禁止**用于商业广告 / AI 训练；禁第三方共享\n- **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议）\n- 温区停留占比 / 移动频次等指标必须基于真实视频帧分析；**禁止伪造或夸大指标**\n- 物种特异性：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**（某些石龙子 / 守宫）早晚活动高峰 → 必须**按物种基线判定**；**严禁通用阈值盲判夜行种昼间躲避为异常**\n- 必须考虑生理性上下文：**蜕皮期偏好躲避（湿度需求）/ 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化** → 不可直接告警\n- UVB / 加热设备关闭时 → 无法区分温区 → 必须返回 `thermoregulation_signal_unreliable` 并建议在设备开启后重新分析\n- 视野未覆盖所有温区（晒点/躲避/冷区缺一）/ 跟踪率 < 80% → 必须返回 `thermoregulation_signal_unreliable` 并建议调整摄像头\n- 必须告知用户：AI 行为分析仅供参考，**最终环境优化与疾病判断需用户结合现场观察并由专业爬宠兽医确认**\n\n## 输出报告字段\n\n- `report_date` - 报告日期\n- `enclosure_id` - 爬宠箱 ID\n- `species` - 宠物物种\n- `basking_temp_setting_c` - 晒点温度设定\n- `cool_zone_temp_setting_c` - 冷区温度设定\n- `basking_zone_duration_ratio` - 晒点区停留占比\n- `hiding_zone_duration_ratio` - 躲避区停留占比\n- `zone_transitions_per_hour` - 每小时移动次数\n- `thermal_preference_label` - 温区偏好标签\n- `activity_rhythm_consistency_score` - 节律一致性\n- `composite_scene` - 综合判定\n- `alert_level` - 提醒等级\n- `recommended_actions` - 建议动作（评估温度梯度 / 检查设备 / 观察体表食欲排泄 / 联系爬宠兽医，**不含药物**）\n- `disclaimer` - 免责声明\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 fixed-camera reptile enclosure videos to report basking, hiding, cool-zone dwell time, movement frequency, activity rhythm, and thermal preference signals.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users, reptile keepers, breeders, and developers can use this skill to analyze enclosure camera video or URLs for thermal-zone utilization reports and behavior-based husbandry guidance. The output is informational and should be checked against on-site observations and professional veterinary advice for health concerns.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends video files or video URLs and identity-linked request data to configured cloud services.\n\nMitigation: Use only with videos the user is authorized to submit, verify the configured service endpoints before execution, and avoid submitting sensitive enclosure footage unless the publisher and service are trusted.\n\nRisk: The skill may create or reuse an identity and persist authentication tokens locally.\n\nMitigation: Run it in a controlled workspace, review local credential storage expectations before installation, and clear persisted identity or token data when the workspace is no longer trusted.\n\nRisk: Behavior reports can influence animal-care decisions even though the skill does not provide a veterinary diagnosis.\n\nMitigation: Treat findings as behavior-analysis guidance, confirm camera coverage and device state, and escalate concerning or persistent alerts to a qualified reptile veterinarian.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis)\n- [API documentation](references/api_doc.md)\n- [Skill demo](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and JSON-style structured text; optional saved text output when an output path is provided.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Reports may include thermal-zone ratios, transition counts, rhythm scores, preference labels, alert levels, recommended actions, disclaimers, and report links.]\n\n## Skill Version(s):\n\n1.0.8 (source: server release evidence; artifact frontmatter reports 1.0.9)\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, 45797 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2743b), SKILL.md (18596b), 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 (166b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.9\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行爬宠体温调节行为识别 | 调用 `-m scripts.smyx_reptile_thermoregulation_behavior_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地爬宠箱固定摄像头视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络爬宠箱固定摄像头视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 类别标识，爬宠体温调节场景默认 `other` | 按需填写 |\n| `--list` | 显示爬宠温区利用历史报告清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_reptile_thermoregulation_behavior_analysis.py`](scripts/smyx_reptile_thermoregulation_behavior_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；**视野必须同时覆盖晒点+躲避+冷区+过渡区**；帧率 ≥ 15 FPS；**加热灯/UVB 灯必须开启**；默认 ≥ 2 小时（建议 24 小时完整节律） |\n| 🔎 使用提醒 | **核心采样窗口**：≥ 2 小时滚动窗口（体温调节是慢节律行为，1 小时内无法建立完整节律） |\n| 🔎 使用提醒 | **核心输出**：`thermal_preference_label`（basking_preferred / hiding_preferred / frequent_shuttling / balanced / abnormal_immobility） |\n| 🔎 使用提醒 | **4 级提醒策略递进**（info → important → urgent → critical），侧重环境优化与福利改善 |\n| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限 |\n| 🔎 使用提醒 | 红线约束 |\n| 🧑⚖️ 结果性质 | **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等具体疾病诊断 |\n| 🔎 使用提醒 | **🚨 绝对禁止**输出具体药物名称、剂量、给药方案 |\n| 🔎 使用提醒 | **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定） |\n| 🔎 使用提醒 | **禁止**用于商业广告 / AI 训练；禁第三方共享 |\n| 🔎 使用提醒 | **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议） |\n| 🔎 使用提醒 | **绝对禁止**伪造或夸大温区停留占比、移动频次等指标；所有数据必须基于真实视频帧分析 |\n| 🔎 使用提醒 | **必须**按 **species（精确到物种）** 匹配基线（夜行种：豹纹守宫 / 鞭尾蜥 / 部分壁虎昼间多躲避属正常；昼行种：鬃狮蜥 / 蓝舌 / 变色龙 / 水龙昼间应多晒点；晨昏行种早晚活动高峰）；**禁止使用通用阈值盲判夜行种昼间躲避为异常** |\n| 📚 文档读取 | **必须**考虑生理性上下文（**蜕皮期偏好躲避（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判 |\n| 🔎 使用提醒 | **必须**在 UVB/加热设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80% 时返回 `thermoregulation_signal_unreliable` 并建议调整摄像头或在设备开启后重新分析 |\n| 🔎 使用提醒 | **必须**：连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n| 📜 报告输出 | **必须**：温区利用报告**按 enclosure_id + 日期输出**，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史温区利用报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json\n```\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1786791508393\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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80%）\n\n## 4 级提醒策略递进（侧重环境优化与福利改善，非疾病诊断）\n\n- Level 1（balanced / basking_preferred_normal / hiding_preferred_normal）：仅入库 + 用户 APP 积极反馈\"温区利用正常，当前环境设置适宜\"\n- Level 2（frequent_shuttling_abnormal）：重要提示，建议**评估温度梯度（晒点/冷区温差是否在物种适宜范围内）/ 检查加热设备是否故障或位置不当 / 评估躲避区数量是否足够**\n- Level 3（excessive_hiding / excessive_basking）：紧急提示，建议**立即检查环境参数（晒点温度/冷区温度/UVB 强度/湿度）+ 近距离观察宠物体表/食欲/排泄 / 如持续 ≥ 72 小时则联系爬宠兽医**\n- Level 4（abnormal_immobility）：最高紧急提示 + 推送所有管理人员 + 强烈建议**立即检查宠物反应（轻轻触碰是否有反应）/ 立即测各温区实际温度 / 联系爬宠兽医（异常不动可能是严重疾病信号）**\n\n## 单日提醒上限\n\n- Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限\n\n## 红线约束\n\n- **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等**具体疾病诊断**\n- **🚨 绝对禁止**输出具体药物名称、剂量、给药方案\n- **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定）\n- **禁止**用于商业广告 / AI 训练；禁第三方共享\n- **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议）\n- 温区停留占比 / 移动频次等指标必须基于真实视频帧分析；**禁止伪造或夸大指标**\n- 物种特异性：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**（某些石龙子 / 守宫）早晚活动高峰 → 必须**按物种基线判定**；**严禁通用阈值盲判夜行种昼间躲避为异常**\n- 必须考虑生理性上下文：**蜕皮期偏好躲避（湿度需求）/ 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化** → 不可直接告警\n- UVB / 加热设备关闭时 → 无法区分温区 → 必须返回 `thermoregulation_signal_unreliable` 并建议在设备开启后重新分析\n- 视野未覆盖所有温区（晒点/躲避/冷区缺一）/ 跟踪率 < 80% → 必须返回 `thermoregulation_signal_unreliable` 并建议调整摄像头\n- 必须告知用户：AI 行为分析仅供参考，**最终环境优化与疾病判断需用户结合现场观察并由专业爬宠兽医确认**\n\n## 输出报告字段\n\n- `report_date` - 报告日期\n- `enclosure_id` - 爬宠箱 ID\n- `species` - 宠物物种\n- `basking_temp_setting_c` - 晒点温度设定\n- `cool_zone_temp_setting_c` - 冷区温度设定\n- `basking_zone_duration_ratio` - 晒点区停留占比\n- `hiding_zone_duration_ratio` - 躲避区停留占比\n- `zone_transitions_per_hour` - 每小时移动次数\n- `thermal_preference_label` - 温区偏好标签\n- `activity_rhythm_consistency_score` - 节律一致性\n- `composite_scene` - 综合判定\n- `alert_level` - 提醒等级\n- `recommended_actions` - 建议动作（评估温度梯度 / 检查设备 / 观察体表食欲排泄 / 联系爬宠兽医，**不含药物**）\n- `disclaimer` - 免责声明\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 reptile enclosure video or video URLs to report basking, hiding, cool-zone dwell time, zone transitions, activity rhythm, and thermal-preference warnings.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal reptile keepers, breeders, and smart vivarium operators use this skill to assess whether reptiles are using basking, hiding, and cool zones in expected patterns. Agents can use it to run analysis, retrieve historical reports, and return structured observations, non-diagnostic welfare guidance, and report links.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Uploaded reptile videos or video URLs are processed by a remote service.\n\nMitigation: Use only media that is approved for remote processing and review the configured service endpoints before running the skill.\n\nRisk: The skill uses an internal identity automatically and may store account tokens locally.\n\nMitigation: Review identity handling and local token storage before installation, especially in shared workspaces.\n\nRisk: The package configuration may point to development or private service addresses.\n\nMitigation: Confirm endpoint configuration matches the intended deployment environment before use.\n\nRisk: Behavior analysis could be mistaken for veterinary diagnosis or device-control authority.\n\nMitigation: Keep outputs limited to behavior observations and non-diagnostic guidance; require user confirmation for any environment changes and refer serious concerns to a qualified reptile veterinarian.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis)\n- [API documentation](references/api_doc.md)\n- [Analysis API 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, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and JSON-style structured reports with command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include report links, thermal preference labels, alert levels, recommended actions, and disclaimers; analysis depends on remote service responses.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release metadata; artifact frontmatter says 1.0.9)\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, 45689 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2572b), SKILL.md (18596b), 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 (166b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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 | 🔐 获取 open-id（强制执行） | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行爬宠体温调节行为识别 | 调用 `-m scripts.smyx_reptile_thermoregulation_behavior_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地爬宠箱固定摄像头视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络爬宠箱固定摄像头视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--pet-type` | 类别标识，爬宠体温调节场景默认 `other` | 按需填写 |\n| `--list` | 显示爬宠温区利用历史报告清单 | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/smyx_reptile_thermoregulation_behavior_analysis.py`](scripts/smyx_reptile_thermoregulation_behavior_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；**视野必须同时覆盖晒点+躲避+冷区+过渡区**；帧率 ≥ 15 FPS；**加热灯/UVB 灯必须开启**；默认 ≥ 2 小时（建议 24 小时完整节律） |\n| 🔎 使用提醒 | **核心采样窗口**：≥ 2 小时滚动窗口（体温调节是慢节律行为，1 小时内无法建立完整节律） |\n| 🔎 使用提醒 | **核心输出**：`thermal_preference_label`（basking_preferred / hiding_preferred / frequent_shuttling / balanced / abnormal_immobility） |\n| 🔎 使用提醒 | **4 级提醒策略递进**（info → important → urgent → critical），侧重环境优化与福利改善 |\n| 🔎 使用提醒 | 单日提醒上限：Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限 |\n| 🔎 使用提醒 | 红线约束 |\n| 🧑⚖️ 结果性质 | **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等具体疾病诊断 |\n| 🔎 使用提醒 | **🚨 绝对禁止**输出具体药物名称、剂量、给药方案 |\n| 🔎 使用提醒 | **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定） |\n| 🔎 使用提醒 | **禁止**用于商业广告 / AI 训练；禁第三方共享 |\n| 🔎 使用提醒 | **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议） |\n| 🔎 使用提醒 | **绝对禁止**伪造或夸大温区停留占比、移动频次等指标；所有数据必须基于真实视频帧分析 |\n| 🔎 使用提醒 | **必须**按 **species（精确到物种）** 匹配基线（夜行种：豹纹守宫 / 鞭尾蜥 / 部分壁虎昼间多躲避属正常；昼行种：鬃狮蜥 / 蓝舌 / 变色龙 / 水龙昼间应多晒点；晨昏行种早晚活动高峰）；**禁止使用通用阈值盲判夜行种昼间躲避为异常** |\n| 📚 文档读取 | **必须**考虑生理性上下文（**蜕皮期偏好躲避（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判 |\n| 🔎 使用提醒 | **必须**在 UVB/加热设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80% 时返回 `thermoregulation_signal_unreliable` 并建议调整摄像头或在设备开启后重新分析 |\n| 🔎 使用提醒 | **必须**：连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n| 📜 报告输出 | **必须**：温区利用报告**按 enclosure_id + 日期输出**，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史温区利用报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json\n```\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1785844053116\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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 < 80%）\n\n## 4 级提醒策略递进（侧重环境优化与福利改善，非疾病诊断）\n\n- Level 1（balanced / basking_preferred_normal / hiding_preferred_normal）：仅入库 + 用户 APP 积极反馈\"温区利用正常，当前环境设置适宜\"\n- Level 2（frequent_shuttling_abnormal）：重要提示，建议**评估温度梯度（晒点/冷区温差是否在物种适宜范围内）/ 检查加热设备是否故障或位置不当 / 评估躲避区数量是否足够**\n- Level 3（excessive_hiding / excessive_basking）：紧急提示，建议**立即检查环境参数（晒点温度/冷区温度/UVB 强度/湿度）+ 近距离观察宠物体表/食欲/排泄 / 如持续 ≥ 72 小时则联系爬宠兽医**\n- Level 4（abnormal_immobility）：最高紧急提示 + 推送所有管理人员 + 强烈建议**立即检查宠物反应（轻轻触碰是否有反应）/ 立即测各温区实际温度 / 联系爬宠兽医（异常不动可能是严重疾病信号）**\n\n## 单日提醒上限\n\n- Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限\n\n## 红线约束\n\n- **🚨 禁止**做\"代谢性骨病 / 呼吸道感染 / 寄生虫感染 / 应激综合征 / 消化停滞\"等**具体疾病诊断**\n- **🚨 绝对禁止**输出具体药物名称、剂量、给药方案\n- **禁止**长期存储完整爬宠箱视频（≤ 14 天，留温区利用时间序列 + 关键行为片段；养殖场按管理规定）\n- **禁止**用于商业广告 / AI 训练；禁第三方共享\n- **禁止**越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光参数；任何设备控制变更必须由用户确认（仅可建议）\n- 温区停留占比 / 移动频次等指标必须基于真实视频帧分析；**禁止伪造或夸大指标**\n- 物种特异性：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**（某些石龙子 / 守宫）早晚活动高峰 → 必须**按物种基线判定**；**严禁通用阈值盲判夜行种昼间躲避为异常**\n- 必须考虑生理性上下文：**蜕皮期偏好躲避（湿度需求）/ 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化** → 不可直接告警\n- UVB / 加热设备关闭时 → 无法区分温区 → 必须返回 `thermoregulation_signal_unreliable` 并建议在设备开启后重新分析\n- 视野未覆盖所有温区（晒点/躲避/冷区缺一）/ 跟踪率 < 80% → 必须返回 `thermoregulation_signal_unreliable` 并建议调整摄像头\n- 必须告知用户：AI 行为分析仅供参考，**最终环境优化与疾病判断需用户结合现场观察并由专业爬宠兽医确认**\n\n## 输出报告字段\n\n- `report_date` - 报告日期\n- `enclosure_id` - 爬宠箱 ID\n- `species` - 宠物物种\n- `basking_temp_setting_c` - 晒点温度设定\n- `cool_zone_temp_setting_c` - 冷区温度设定\n- `basking_zone_duration_ratio` - 晒点区停留占比\n- `hiding_zone_duration_ratio` - 躲避区停留占比\n- `zone_transitions_per_hour` - 每小时移动次数\n- `thermal_preference_label` - 温区偏好标签\n- `activity_rhythm_consistency_score` - 节律一致性\n- `composite_scene` - 综合判定\n- `alert_level` - 提醒等级\n- `recommended_actions` - 建议动作（评估温度梯度 / 检查设备 / 观察体表食欲排泄 / 联系爬宠兽医，**不含药物**）\n- `disclaimer` - 免责声明\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: prod\n\nFile v1.0.6:skill-card.md\n\n## Description:
\nAnalyzes fixed-camera reptile enclosure videos to estimate basking, hiding, cool-zone movement, dwell time, activity rhythm, and thermal preference signals.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[18072937735](https://clawhub.ai/user/18072937735)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to analyze reptile enclosure videos or video URLs, produce structured thermal-zone utilization reports, and receive non-diagnostic husbandry guidance about basking, hiding, movement, and activity rhythm.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill sends reptile enclosure videos or video URLs to the Life Emergence cloud service for analysis.
\nMitigation: Use only footage that is appropriate for cloud processing, obtain required authorization for shared or farm cameras, and avoid sensitive media.
\nRisk: The skill may create or reuse a cloud-linked identity and store authentication tokens locally.
\nMitigation: Install only in workspaces where local token storage is acceptable, and review deletion procedures for local data, tokens, and cloud reports before use.
\nRisk: Behavior analysis can be mistaken for veterinary diagnosis or treatment advice.
\nMitigation: Treat outputs as husbandry and welfare signals only; confirm health concerns with direct observation and a qualified reptile veterinarian.
\n\n\n## Reference(s):
\n- [API Interface Documentation](artifact/references/api_doc.md)
\n- [Skill Demo](https://lifeemergence.com/sample.html)
\n- [ClawHub Skill Page](https://clawhub.ai/18072937735/skills/smyx-reptile-thermoregulation-behavior-analysis)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, JSON, shell commands, guidance]
\n**Output Format:** [Markdown or JSON structured analysis report with recommended actions and report links]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May include thermal preference labels, zone dwell ratios, transition counts, alert level, recommended actions, and historical report links.]
\n\n## Skill Version(s):
\n1.0.6 (source: server release evidence)
\n\n## Ethical Considerations:
\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, 45898 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (3096b), SKILL.md (18596b), 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 (166b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / **frequent_shuttling_abnormal** / **excessive_hiding** / **excessive_basking** / **abnormal_immobility** / signal_unreliable），并按 4 级提醒策略递进（Level 1 积极反馈 → Level 2 评估温度梯度+设备+躲避区数量 → Level 3 紧急检查环境参数+体表+食欲+排泄 → Level 4 异常不动 → 立即测温+触碰反应+联系兽医 + 所有联系人）。**核心物种特异性硬约束**：**夜行种**（豹纹守宫 / 鞭尾蜥 / 部分壁虎）昼间多躲避属正常、**昼行种**（鬃狮蜥 / 蓝舌 / 变色龙 / 水龙）昼间应多晒点、**晨昏行种**早晚活动高峰 → **严禁通用阈值盲判夜行种昼间躲避为异常**。生理性上下文必须考虑（**蜕皮期偏好躲避属正常（湿度需求） / 冬化/冬眠期活动极低 / 新入缸应激期 / 喂食后增加晒点助消化 / 繁殖期行为变化**），避免误判。UVB / 加热设备关闭时无法区分温区 → 必须返回 `thermoregulation_signal_unreliable`。视野未覆盖所有温区 / 跟踪率 < 80% → 同样返回 unreliable。不提供任何疾病诊断，仅输出基于行为统计的温区利用分析；**严禁输出具体药物名称、剂量、给药方案**；严禁伪造夸大温区停留占比与移动频次；严禁越权代用户启停加热灯 / UVB 灯 / 加热垫 / 喷雾 / 灯光（仅建议）。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头**连续视频**（默认 ≥ 2 小时滚动窗口，建议 24 小时完整节律），识别 8 类综合场景（thermoregulation_balanced / basking_preferred_normal / hiding_preferred_normal / frequent_shuttling_abnormal / excessive_hiding / excessive_basking / abnormal_immobility / signal_unreliable）→ **五组指标**：温区停留 7 项（晒点占比 + 躲避占比 + 冷区占比 + 过渡占比 + 晒点进入次数 + 单次晒点平均时长 + 单次躲避平均时长）+ 移动穿梭 4 项（每小时移动次数 + 晒点→躲避次数 + 躲避→晒点次数 + 频繁穿梭标志）+ 活动节律 4 项（活动高峰时段 + 晒点高峰时段 + 昼夜模式 + 节律一致性评分）+ 温区偏好 2 项（**thermal_preference_label** + 物种基线 z-score）+ 排除上下文 7 项（UVB 开启 / 加热开启 / 蜕皮期 / 冬化期 / 新入缸期 / 喂食日 / 室温）→ 4 档提醒级别（info / important / urgent / critical）→ **4 级提醒策略递进**（积极反馈 → 评估温度梯度+设备+躲避区 → 紧急检查环境+体表+食欲+排泄 → 异常不动→立即测温+触碰+兽医 + 所有联系人）→ 单日提醒上限（Level 1 不限 / Level 2 × 3 / Level 3 × 4 / Level 4 不设上限）→ **每日温区利用报告**（按 enclosure_id 输出，含温区停留占比 + 每小时移动次数 + 节律一致性 + 温区偏好标签 + 建议动作 + 免责声明）\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 爬宠箱视野温区注册（晒点 / 躲避 / 冷区 / 过渡区） |\n| 2 | 爬宠目标检测与跟踪（含鬃狮蜥等大型蜥蜴 |\n| 3 | 豹纹守宫等小型壁虎 |\n| 4 | 玉米蛇 / 球蟒 |\n| 5 | 红腿象龟 / 苏卡达等龟类） |\n| 6 | 各温区停留时长累计 |\n| 7 | 温区转换事件检测（跨区域中心点跨越） |\n| 8 | 每小时频次统计 |\n| 9 | 单次停留时长分布 |\n| 10 | 昼夜活动节律分析 |\n| 11 | 活动高峰时段识别 |\n| 12 | 与物种基线 z-score 比较 |\n| 13 | **异常不动检测**（任一温区长时间静止 > 4 小时无区域转换） |\n| 14 | 生理性上下文识别（蜕皮 / 冬化 / 新入缸 / 喂食 / 繁殖） |\n| 15 | 设备状态门控（UVB/加热关闭返回 unreliable） |\n| 16 | 视野完整性门控（温区缺一返回 unreliable） |\n| 17 | 用户 APP 推送 |\n| 18 | 4 级提醒递进 |\n| 19 | 单日提醒上限 |\n| 20 | 温区利用报告（按 enclosure_id + 日期输出） |\n| 21 | 连续 ≥ 72 小时 Level 3 → 强烈建议联系**专业爬宠兽医** |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供爬宠箱固定摄像头视频 URL 或文件需要分析时，默认触发本技能进行爬宠体温调节行为识别 |\n| 🔎 明确分析意图 | 当用户明确提及晒点、躲避、温区、加热灯、UVB、爬宠节律、爬宠嗜睡、爬宠应激、蜥蜴/蛇/龟行为等关键词，并且上传了视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看爬宠温区历史报告、温区利用日志清单、爬宠行为节律记录、查询历史温区利用报告、显示所有爬宠箱温区报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_reptile_thermoregulation_behavior_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\nArchive v1.0.4: 31 files, 45662 bytes\n\nFiles: references/api_doc.md (8786b), scripts/__init__.py (69b), scripts/config.py (711b), scripts/config.yaml (3b), scripts/skill.py (598b), scripts/smyx_reptile_thermoregulation_behavior_analysis.py (3755b), skill-card.md (2504b), SKILL.md (18596b), 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/scr...","readmeExcerpt":"Skill: Fish Flashing & Scraping Detection (Ectoparasite Warning) | 爬宠体温调节行为识别（晒点/躲避） Owner: 18072937735 Summary: Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json"},{"language":"bash","snippet":"python -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input /path/to/vivarium.mp4\n\n# 分析网络爬宠箱固定摄像头视频（以下只是示例，禁止直接使用 作为 open-id）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --url https://example.com/vivarium.mp4\n\n# 显示历史温区利用报告清单（自动触发关键词：查看爬宠温区历史报告、温区利用日志清单等）\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_reptile_thermoregulation_behavior_analysis --input vivarium.mp4 --output result.json"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"smyx-reptile-thermoregulation-behavior-analysis\"\ndescription: \"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。\"\nversion: \"1.0.15\"\nlicense: \"MIT-0\"\n---\n\n# 🦎 Reptile Thermoregulation Behavior (Basking / Hiding) | 爬宠体温调节行为识别（晒点/躲避）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **爬宠体温调节行为识别（晒点/躲避）** |\n| 🎯 核心目标 | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` |\n\nThrough fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). It counts hourly transitions and per-zone dwell ratios, and outputs a thermal preference label (e.g. 'basking-preferred', 'hiding-preferred', 'frequent shuttling'). This skill helps assess whether the environmental temperature gradient is appropriate, infers pet health state (such as abnormal lethargy or stress reaction), and guides keepers to adjust heating layout. Application scenarios: vivariums, breeding tanks, reptile farms. The system monitors continuously, generates daily thermal-zone utilization reports, and pushes reminders when abnormalities occur. Skill features: reptiles are ectotherms that regulate body temperature through behavior. Long-term deviation from normal zone-utilization patterns (e.g. constantly hiding) may indicate disease, parasites, or environmental inadequacy. AI-based automatic monitoring helps keepers catch problems early, optimize setup, and improve animal welfare. This skill can be integrated into smart vivarium cameras or reptile-keeping apps.\n\n通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。统计单位时间内（如每小时）的移动次数和各温区的停留时长比例，输出温区偏好（如'偏好晒点''偏好躲避''频繁穿梭'）。该技能有助于评估环境温度是否适宜，判断宠物健康状态（如异常嗜睡、应激反应），指导饲养者调整加热设备布局。应用场景：爬宠箱、饲养缸、爬行动物养殖场。系统连续监测，生成每日温区利用报告，异常时推送提醒。技能特点：爬行动物是变温动物，需要通过行为调节体温。长期偏离正常温区利用模式（如总躲在躲避区）可能提示疾病、寄生虫或环境不适。通过 AI 自动监测，可帮助饲养者及早发现问题，优化环境设置，提升宠物福利。该技能可集成到智能爬宠箱摄像头或爬宠管理 APP 中。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的爬行动物行为监测 AI。你的任务是分析爬宠箱固定摄像头的视频（俯拍或斜俯拍，分辨率 ≥ 720p，帧率 ≥ 15 FPS，视野必须同时覆盖晒点区 + 躲避区 + 冷区 + 过渡区），先对三个温区做位置注册（基于用户标注或自动检测加热灯位置/洞穴掩体），然后跟踪宠物在各温区的停留时长（占比）+ 每小时温区移动次数 + 单次晒点/躲避平均时长 + 活动节律（昼夜模式 + 高峰时段），按 **species（精确到物种，鬃狮蜥 / 豹纹守宫 / 球蟒 / 玉米蛇 / 蓝舌石龙子 / 红腿象龟 / 苏卡达等）匹配标准基线**，计算 `thermal_preference_label`，按 8 类综合场景判定（thermoregulation_balanced / basking_preferred_normal / hiding_pre"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n \"slug\": \"smyx-reptile-thermoregulation-behavior-analysis\",\n \"version\": \"1.0.12\",\n \"publishedAt\": 1790714551913\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/health-analysis/v2/start-health-analysis` - 启动爬宠体温调节行为识别任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取分析结果（温区停留时长 / 移动频次 / 温区偏好 / 活动节律）\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史温区利用报告\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出每日温区利用报告\n5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整加热设备布局）\n\n## 场景代码\n\n- `SMYX_REPTILE_THERMOREGULATION_BEHAVIOR_ANALYSIS` - 爬宠体温调节行为识别（晒点/躲避）\n\n## 输入约束\n\n- 摄像头：爬宠箱固定摄像头 / 智能爬宠箱内置摄像头 / 养殖场监控摄像头\n- 分辨率 ≥ 720p；帧率 ≥ 15 FPS（体温调节行为非高速动作，15 FPS 足够）\n- **关键硬件要求**：**视野必须同时覆盖晒点区（加热灯下方高温区域）+ 躲避区（洞穴/掩体/冷区）+ 中间过渡区**（三个温区全部可见才能完整统计）\n- 拍摄角度：俯拍或斜俯拍（可清晰看到宠物位置与温区边界）\n- 光照：加热灯/UVB 灯正常开启时拍摄（关闭时无法区分温区）\n- **核心采样窗口**：默认连续 ≥ 2 小时（体温调节是慢节律行为，1 小时内可能无法建立完整节律）\n- 多箱场景按摄像头 ID 绑定到注册容器 ID\n- **部署时必须录入**：宠物物种（豹纹守宫 / 鬃狮蜥 / 蓝舌石龙子 / 玉米蛇 / 球蟒 / 红腿象龟 / 苏卡达等）、晒点温度（用户设定值）、冷区温度（用户设定值）、加热设备类型（加热灯 / 陶瓷加热器 / 加热垫）、UVB 灯类型与开启时段、躲避区数量与位置\n- 用户必须授权部署；养殖场需公示告知\n\n## 关键观测信号\n\n### 温区停留统计\n- `basking_zone_duration_ratio` - **晒点区停留时长占比**（核心指标，正常 30-60% 因物种而异）\n- `hiding_zone_duration_ratio` - **躲避区停留时长占比**（核心指标，正常 10-40% 因物种而异）\n- `cool_zone_duration_ratio` - 冷区停留时长占比\n- `transition_zone_duration_ratio` - 过渡区停留时长占比\n- `basking_session_count` - 晒点区进入次数\n- `basking_session_duration_minutes_avg` - 单次晒点停留平均时长（分钟）\n- `hiding_session_duration_minutes_avg` - 单次躲避停留平均时长（分钟）\n\n### 移动与穿梭统计\n- `zone_transitions_per_hour` - **每小时温区移动次数**（核心指标）\n- `basking_to_hiding_transitions` - 晒点→躲避直接移动次数\n- `hiding_to_basking_transitions` - 躲避→晒点直接移动次数\n- `frequent_shuttling_flag` - **频繁穿梭标志**（> 10 次/小时，可能温度梯度不合理或应激）\n\n### 活动节律\n- `activity_peak_hour` - 活动高峰时段（小时）\n- `basking_peak_hour` - 晒点高峰时段（通常与 UVB 灯/加热灯开启时段一致）\n- `diurnal_nocturnal_pattern` - 昼夜活动模式（昼行 / 夜行 / 晨昏行）\n- `activity_rhythm_consistency_score` - 活动节律一致性评分（与同物种正常节律的偏差度）\n\n### 温区偏好综合\n- `thermal_preference_label` - **温区偏好标签**（basking_preferred / hiding_preferred / **frequent_shuttling** / balanced / **abnormal_immobility**）\n- `thermal_preference_z_score` - 温区偏好相对物种基线的 z-score\n\n### 上下文与排除信号\n- `is_uv_bulb_on` - UVB 灯是否开启（关闭时爬宠不出晒点属正常）\n- `is_heating_device_on` - 加热设备是否开启\n- `is_during_shedding_cycle` - 是否处于蜕皮期（蜕皮期偏好躲避属正常）\n- `is_during_brimation` - 是否处于冬眠/冬化期（活动大幅减少属正常）\n- `is_newly_introduced` - 是否新入缸适应期（应激多躲属正常）\n- `is_feeding_day` - 是否喂食日（喂食后可能增加晒点停留助消化）\n- `ambient_room_temperature_c` - 室温（影响冷区实际温度）\n\n## 综合判定\n\n- `thermoregulation_balanced` - 温区利用正常均衡（符合物种基线）\n- `basking_preferred_normal` - 偏好晒点但属正常范围（消化期 / UVB 开启期）\n- `hiding_preferred_normal` - 偏好躲避但属正常范围（蜕皮期 / 新入缸 / 夜行种昼间）\n- `frequent_shuttling_abnormal` - **频繁穿梭异常**（> 10 次/小时，可能温度梯度不合理或应激）\n- `excessive_hiding` - **过度躲避**（躲避占比 > 70%，持续 ≥ 48 小时，非蜕皮/冬化/新入缸 → 疑似疾病/寄生虫/环境不适）\n- `excessive_basking` - **过度晒点**（晒点占比 > 80%，持续 ≥ 48 小时 → 疑似温度不足/消化问题/代谢异常）\n- `abnormal_immobility` - **异常不动**（任一温区长时间静止不动，> 4 小时无区域转换 → 疑似严重疾病/深度应激/温度极端不适）\n- `thermoregulation_signal_unreliable` - 信号不可靠（加热/UVB 设备关闭 / 视野未覆盖所有温区 / 跟踪率 "},{"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":"Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温区域）与躲避区（洞穴、冷区）之间的移动频次、停留时长以及活动节律。系统连续监测，生成每日温区利用报告，异常时推送提醒。 Skill: Fish Flashing & Scraping Detection (Ectoparasite Warning) | 爬宠体温调节行为识别（晒点/躲避） Owner: 18072937735 Summary: Through fixed enclosure cameras, the system analyzes behavior videos of reptiles (lizards, snakes, turtles) and detects movement frequency and dwell duration between the basking zone (heated area under the basking lamp) and the hiding zone (cave/cool side). | 通过爬宠箱固定摄像头，分析爬行动物（如蜥蜴、蛇、龟）的行为视频，检测宠物在晒点（加热灯下方高温","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1113,"uniquenessScore":47,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:47:25.529Z","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-10T04:47:25.529Z","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:00:03.589Z","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"}]}}}