{"id":"346f733d-23d4-4448-8987-b1834f43bc83","entityType":"agent","slug":"clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-","name":"Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别","canonicalUrl":"https://www.xpersona.co/agent/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-","canonicalPath":"/agent/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-","generatedAt":"2026-10-10T11:00:01.935Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:54:20.548Z","emptyReason":null},"description":"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。","descriptionLabel":"Source description","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 s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-child-nightmare-rollover-detection-analysis","sourceUrl":"https://clawhub.ai/smyx-sunjinhui/smyx-child-nightmare-rollover-detection-analysis","homepage":"https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/smyx-sunjinhui/smyx-child-nightmare-rollover-detection-analysis","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别 technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:54:20.548Z","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:54:20.548Z","emptyReason":null},"stars":null,"forks":null,"downloads":1671,"packageName":null,"latestVersion":"1.0.11","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:54:20.522Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T04:54:20.548Z","lastCrawledAt":"2026-10-10T04:54:20.522Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T04:54:20.522Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.11","createdAt":"2026-09-29T06:13:31.025Z","changelog":"- Updated SKILL.md to increment version number from 1.0.17 to 1.0.18. - Removed the skill-card.md file. - No changes to functionality or interface; documentation/metadata update only.","fileCount":31,"zipByteSize":40261},{"version":"1.0.10","createdAt":"2026-09-26T13:45:26.544Z","changelog":"- Updated version to 1.0.17. - Revised and expanded documentation in SKILL.md, including minor clarifications and improved structure. - Removed the file skill-card.md.","fileCount":31,"zipByteSize":40339},{"version":"1.0.9","createdAt":"2026-09-07T01:02:36.201Z","changelog":"- Updated version to 1.0.14 in SKILL.md. - Removed redundant file: skill-card.md. - No functional or logic changes in code; updates are documentation and housekeeping only.","fileCount":31,"zipByteSize":40393},{"version":"1.0.8","createdAt":"2026-08-29T04:17:46.691Z","changelog":"- Updated skill version to 1.0.13 - SKILL.md: Incremented version in metadata and documentation sections - Removed redundant file: skill-card.md - No changes to core functionality or workflow","fileCount":31,"zipByteSize":40487},{"version":"1.0.7","createdAt":"2026-08-17T22:10:28.804Z","changelog":"- Updated SKILL.md: incremented version to \"1.0.12\" with no content changes except version number. - Removed file: skill-card.md. - No change to feature set or functionality.","fileCount":31,"zipByteSize":40351},{"version":"1.0.6","createdAt":"2026-08-14T14:34:31.131Z","changelog":"- Updated version from 1.0.10 to 1.0.11 in SKILL.md. - Minor content and formatting adjustments in documentation for clarity. - Removed the file skill-card.md.","fileCount":31,"zipByteSize":40384},{"version":"1.0.5","createdAt":"2026-08-09T02:04:39.213Z","changelog":"- Updated SKILL.md: incremented version to 1.0.10 and made content changes. - Removed skill-card.md file.","fileCount":31,"zipByteSize":40387},{"version":"1.0.4","createdAt":"2026-07-30T22:29:27.980Z","changelog":"- Updated version number to 1.0.9 and SKILL.md documentation to reflect recent changes. - Removed the file skill-card.md. - No changes to core features or logic; this version focuses on documentation and cleanup.","fileCount":31,"zipByteSize":40442}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-child-nightmare-rollover-detection-analysis","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-child-nightmare-rollover-detection-analysis` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/smyx-sunjinhui/smyx-child-nightmare-rollover-detection-analysis before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/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:01.931Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-child-nightmare-rollover-detection-/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:54:20.548Z","emptyReason":null},"readme":"Skill: Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n\nOwner: smyx-sunjinhui\n\nSummary: Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\nTags: latest:1.0.11\n\nVersion history:\n\nv1.0.11 | 2026-09-29T06:13:31.025Z | auto\n\n- Updated SKILL.md to increment version number from 1.0.17 to 1.0.18.\n- Removed the skill-card.md file.\n- No changes to functionality or interface; documentation/metadata update only.\n\nv1.0.10 | 2026-09-26T13:45:26.544Z | auto\n\n- Updated version to 1.0.17.\n- Revised and expanded documentation in SKILL.md, including minor clarifications and improved structure.\n- Removed the file skill-card.md.\n\nv1.0.9 | 2026-09-07T01:02:36.201Z | auto\n\n- Updated version to 1.0.14 in SKILL.md.\n- Removed redundant file: skill-card.md.\n- No functional or logic changes in code; updates are documentation and housekeeping only.\n\nv1.0.8 | 2026-08-29T04:17:46.691Z | auto\n\n- Updated skill version to 1.0.13\n- SKILL.md: Incremented version in metadata and documentation sections\n- Removed redundant file: skill-card.md\n- No changes to core functionality or workflow\n\nv1.0.7 | 2026-08-17T22:10:28.804Z | auto\n\n- Updated SKILL.md: incremented version to \"1.0.12\" with no content changes except version number.\n- Removed file: skill-card.md.\n- No change to feature set or functionality.\n\nv1.0.6 | 2026-08-14T14:34:31.131Z | auto\n\n- Updated version from 1.0.10 to 1.0.11 in SKILL.md.\n- Minor content and formatting adjustments in documentation for clarity.\n- Removed the file skill-card.md.\n\nv1.0.5 | 2026-08-09T02:04:39.213Z | auto\n\n- Updated SKILL.md: incremented version to 1.0.10 and made content changes.\n- Removed skill-card.md file.\n\nv1.0.4 | 2026-07-30T22:29:27.980Z | auto\n\n- Updated version number to 1.0.9 and SKILL.md documentation to reflect recent changes.\n- Removed the file skill-card.md.\n- No changes to core features or logic; this version focuses on documentation and cleanup.\n\nv1.0.3 | 2026-07-13T13:18:29.745Z | auto\n\n- Updated internal versioning from 1.0.5 to 1.0.6 in documentation.\n- Removed the redundant skill-card.md file.\n- Minor maintenance edits to utility scripts and documentation.\n- No changes to user-facing features or main workflow.\n\nv1.0.2 | 2026-07-04T06:43:40.971Z | auto\n\n- Updated version to 1.0.5.\n- Revised and expanded documentation (SKILL.md), including improved formatting and extra information for usage, workflow, and constraints.\n- Removed outdated documentation file (skill-card.md).\n- Modified configuration and utility scripts for consistency.\n- Improved clarity regarding API usage, report output, and compliance requirements.\n\nv1.0.1 | 2026-06-24T23:45:26.639Z | auto\n\n**User-facing identity handling is now fully automatic; user no longer needs to provide open-id or similar parameters.**\n\n- Identity association and all open-id retrieval steps are performed silently by the internal system; users are not prompted for or shown any identity information.\n- All prompts, documentation, and error flows related to manual open-id provision are removed.\n- Scripts updated to reflect internal-only identity management for both analysis execution and historical report queries.\n- User input/output flows simplified for clarity and compliance; only analysis results and report links are displayed.\n- Minor documentation improvements and formatting updates for easier onboarding.\n\nv1.0.0 | 2026-05-25T15:06:03.208Z | auto\n\nInitial release of smyx-child-nightmare-rollover-detection-analysis\n\n- Night-time monitoring of children's sleep using infrared cameras, analyzing video and audio for rollovers, cries, and sleep talk.\n- Generates structured sleep quality reports, including rollover frequency, cry detection, sleep talk events, and overall sleep quality score.\n- Sends alerts to parents in case of possible nightmares or restless sleep based on detected events.\n- Strict open-id (user identity) acquisition and validation process before any analysis or report queries, with privacy and data protection considerations.\n- Provides history report queries, outputting results in markdown tables with direct report links.\n- Designed as an auxiliary parenting tool; not a substitute for medical/clinical diagnosis.\n\nArchive index:\n\nArchive v1.0.11: 31 files, 40261 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2170b), SKILL.md (12499b), 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 (168b)\n\nFile v1.0.11:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.18\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.11:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.11\",\n  \"publishedAt\": 1790662411025\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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\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\nAnalyzes children's nighttime sleep recordings for rollovers, crying, and sleep talking, then provides sleep-quality reports and possible-restlessness alerts.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents and caregivers can use this skill to review children's nighttime sleep recordings, identify possible restlessness, and view sleep reports and historical results. Its findings are parenting aids, not medical diagnoses.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Children's sleep audio/video or media URLs are sent to a cloud service.\n\nMitigation: Obtain guardian consent and confirm the service's retention and deletion terms before uploading.\n\nRisk: Reports are linked to an automatically managed identity, with tokens stored locally.\n\nMitigation: Review token storage and access controls, and check whether history lookup and uploads can be enabled per run.\n\nRisk: Restlessness and possible-nightmare alerts may be mistaken for medical diagnoses.\n\nMitigation: Use results only as parenting guidance and consult a pediatric or sleep specialist for persistent concerns.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis)\n- [API documentation](references/api_doc.md)\n- [Skill demonstration](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON]\n\n**Output Format:** [Structured sleep-analysis report or JSON; Markdown table for report history]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include report links and an optional saved result file.]\n\n## Skill Version(s):\n\n1.0.11 (source: ClawHub release metadata; bundled SKILL.md lists 1.0.18)\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, 40339 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2345b), SKILL.md (12499b), 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 (168b)\n\nFile v1.0.10:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.17\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.10:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1790430326544\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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\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: prod\n\nFile v1.0.10:skill-card.md\n\n## Description:\n\nAnalyzes a child's nighttime audio and video for rolling over, crying, and sleep talking, then provides sleep-quality reports and possible nightmare or restlessness alerts.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents or guardians use the skill to review a child's nighttime sleep recordings, receive behavioral summaries and possible restlessness alerts, and access prior reports. Its observations are not medical diagnoses.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive recordings of a child's bedroom or media URLs may be sent to a third-party cloud service.\n\nMitigation: Obtain guardian consent before use and confirm the provider's retention, deletion, encryption, and access-control practices before uploading real recordings.\n\nRisk: The skill may create or reuse an identity, store tokens locally, and retrieve prior cloud reports without an explicit prompt.\n\nMitigation: Review account and report access before use, restrict who can access local tokens, and avoid processing recordings when these behaviors are unacceptable.\n\nRisk: Behavioral alerts can be mistaken for a medical diagnosis.\n\nMitigation: Treat the report as a caregiving aid, not a diagnosis; consult a pediatric or sleep specialist for persistent concerns.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis)\n- [Skill API documentation](artifact/references/api_doc.md)\n- [Skill demonstration](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [Analysis, Guidance, Text]\n\n**Output Format:** [JSON analysis reports or Markdown summaries and historical-report tables]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include alert messages, report links, and an optional saved report file.]\n\n## Skill Version(s):\n\n1.0.10 (source: server-resolved ClawHub release)\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, 40393 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2442b), SKILL.md (12499b), 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.9:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.14\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1788742956201\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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\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\nThis skill analyzes fixed-camera child nighttime sleep audio and video to detect rollovers, crying, sleep talk, and body-jerk events, then returns sleep-quality reports and possible restless-sleep or nightmare alerts.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents, caregivers, and developers building child sleep-monitoring workflows use this skill to analyze night-vision sleep recordings, generate structured sleep-behavior reports, and surface non-diagnostic prompts to check on a child when restlessness or possible nightmare signals are detected.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill processes sensitive children's bedroom audio and video.\n\nMitigation: Use only with guardian consent, isolate the workspace, and confirm retention and deletion controls before deployment.\n\nRisk: The skill sends recordings and analysis requests to cloud APIs.\n\nMitigation: Confirm approved production endpoints, access controls, and data-handling terms before allowing real child recordings.\n\nRisk: The security evidence reports unsafe defaults, including apparent plaintext HTTP development services and local identity state.\n\nMitigation: Force HTTPS production services, protect or remove stored tokens and identity state, and review configuration before installation.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [API documentation](references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON]\n\n**Output Format:** [Structured sleep-behavior report text, Markdown tables for history listings, and JSON-compatible analysis fields]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include sleep-quality scores, event counts, alert text, recommendations, and report links.]\n\n## Skill Version(s):\n\n1.0.9 (source: server release metadata; artifact SKILL.md frontmatter states 1.0.14)\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, 40487 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2700b), SKILL.md (12499b), 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.8:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.13\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1787977066691\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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\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 child night-time sleep audio or video to report rollover frequency, crying, sleep talking, sleep-quality signals, and possible restless-sleep or nightmare alerts.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents, guardians, and developers can use this skill to analyze child sleep recordings or report history for rollover, crying, sleep-talk, and sleep-quality indicators. Results are intended as caregiving support and not as medical diagnosis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Child sleep recordings can contain highly sensitive video and audio and may be sent to cloud APIs.\n\nMitigation: Use only with clear guardian consent, trusted endpoints, and non-sensitive test data first; review data handling, retention, and access controls before real use.\n\nRisk: Bundled configuration can reference development, private, or non-HTTPS service addresses.\n\nMitigation: Confirm the skill is configured for the intended production HTTPS service before installation or execution.\n\nRisk: The skill may silently create or reuse a local identity and store tokens in the workspace database.\n\nMitigation: Review local account and token storage behavior, restrict workspace access, and remove stored credentials when they are no longer needed.\n\nRisk: Sleep-quality and nightmare alerts may be mistaken for clinical conclusions.\n\nMitigation: Present outputs as behavior statistics and caregiving prompts only; direct persistent concerns to pediatric or sleep-medicine professionals.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-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, JSON, Shell commands, Guidance]\n\n**Output Format:** [Markdown and structured JSON-style analysis text with report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include sleep-behavior statistics, alert messages, historical report lists, and exported report links; not a medical diagnosis.]\n\n## Skill Version(s):\n\n1.0.8 (source: ClawHub release evidence)\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, 40351 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2300b), SKILL.md (12499b), 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.7:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.12\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1787004628804\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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\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 child night-time sleep audio/video to report rollover frequency, crying, sleep-talk events, sleep-quality signals, and possible nightmare or restless-sleep alerts.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents, guardians, and agents supporting child sleep monitoring use this skill to analyze uploaded night-time sleep media and return behavior statistics, report links, and non-diagnostic comfort guidance.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive child bedroom audio/video and report history may be sent to a configured network service.\n\nMitigation: Confirm guardian consent, endpoint ownership, retention and deletion terms, and encryption or storage controls before use.\n\nRisk: The skill can silently create or reuse identity records and query historical reports.\n\nMitigation: Require explicit operator approval for history lookup and verify that local token or identity storage matches the deployment's privacy policy.\n\nRisk: Sleep-quality and nightmare alerts could be mistaken for medical conclusions.\n\nMitigation: Present results as behavioral observations only and route persistent sleep concerns to a qualified pediatric or sleep professional.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-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 sleep analysis report with event statistics, alerts, suggestions, and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write the report to a requested output file.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release metadata; artifact frontmatter lists 1.0.12)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.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, 40384 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2497b), SKILL.md (12499b), 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.6:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.11\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1786718071131\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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\n\nFile v1.0.6:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.6:scripts/config.yaml\n\n{}\n\nFile v1.0.6:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.6:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.6:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.6:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: dev\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nAnalyzes child overnight audio or video to produce sleep-behavior statistics, sleep-quality signals, and possible nightmare or restless-sleep alerts.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents, caregivers, and developers integrating the skill use it to submit child nighttime sleep media or media URLs, receive structured behavior analysis and report links, and query historical sleep reports.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Children's overnight audio/video or media URLs are sent to a configured cloud service.\n\nMitigation: Use only with guardian consent, and confirm the endpoint, retention, deletion, and access-control policies before sending media.\n\nRisk: The skill can silently create or reuse identity records and associate cloud reports with that identity.\n\nMitigation: Run it only in a workspace where the managed identity is expected, and avoid shared workspaces for sensitive child sleep reports.\n\nRisk: Tokens or profile data may be stored locally in the workspace.\n\nMitigation: Restrict workspace access, rotate or remove credentials after use, and avoid committing generated local state.\n\nRisk: Historical report queries retrieve cloud report data without a fresh confirmation step.\n\nMitigation: Require explicit operator confirmation before history queries in deployments handling child sleep reports.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis)\n- [API documentation](references/api_doc.md)\n- [SMYX 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, JSON, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown text with structured JSON report content and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May save the rendered report to a user-specified output file.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.6:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.6:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.5: 31 files, 40387 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2400b), SKILL.md (12499b), 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.5:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.10\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1786241079213\n}\n\nFile v1.0.5:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放儿童睡眠中频繁翻身/噩梦识别 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\n\nFile v1.0.5:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.5:scripts/config.yaml\n\n{}\n\nFile v1.0.5:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.5:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.5:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.5:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nAnalyzes child nighttime sleep video and audio to report rollover, crying, sleep-talk, body-jerk, sleep-quality, and possible nightmare or restless-sleep alerts.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and caregivers can use this skill to analyze child bedroom sleep media, generate sleep-behavior reports, and receive non-diagnostic alerts about possible nightmares or restless sleep.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive child bedroom audio/video and sleep-report history are sent to configured lifeemergence cloud services.\n\nMitigation: Use only with guardian consent, confirm the provider's retention, deletion, and access policies, and avoid inputs that should not leave the user's environment.\n\nRisk: The skill stores tokens locally and associates activity with cloud identities.\n\nMitigation: Treat the workspace data directory and smyx-api-key.txt as sensitive, restrict local access, and remove stored credentials when the skill is no longer needed.\n\nRisk: Arbitrary media URLs may be retrieved by the external service.\n\nMitigation: Use only trusted media URLs and avoid links that could expose private, untrusted, or unintended content.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis)\n- [Skill Demo](https://lifeemergence.com/sample.html)\n- [API Interface Documentation](references/api_doc.md)\n- [SMYX Analysis API Documentation](skills/smyx_analysis/references/api_doc.md)\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 text with report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write an optional result file when the user supplies an output path.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence; artifact SKILL.md frontmatter reports 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.5:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.5:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.4: 31 files, 40442 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2680b), SKILL.md (12498b), 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.4:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.9\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1785450567980\n}\n\nFile v1.0.4:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放儿童睡眠中频繁翻身/噩梦识别 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\n\nFile v1.0.4:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.4:scripts/config.yaml\n\n{}\n\nFile v1.0.4:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.4:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.4:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.4:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nAnalyzes child nighttime sleep video or audio from a fixed bedroom camera to report rollover frequency, crying, sleep talk, sleep quality, and possible nightmare or restless-sleep alerts. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal caregivers and developers use this skill to submit child nighttime sleep media or URLs for cloud analysis, receive behavior statistics and sleep-quality reports, and retrieve previous reports. The output is an assistive sleep-behavior report, not a medical diagnosis. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Child bedroom audio/video or URLs may be processed by vendor cloud APIs. <br>\nMitigation: Use only with clear guardian consent and submit media only when the vendor's retention, deletion, and encryption practices are acceptable. <br>\nRisk: Analysis history may be tied to local or remote identity state, and account tokens may be stored in a workspace SQLite database. <br>\nMitigation: Avoid shared workspaces unless account separation, retention, deletion, and token-storage practices have been reviewed. <br>\nRisk: The security verdict is suspicious because the skill handles highly sensitive child sleep media and identity-linked reports. <br>\nMitigation: Review carefully before installing and require organizational security review before production or shared-environment use. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis) <br>\n- [API documentation](references/api_doc.md) <br>\n- [Analysis API documentation](skills/smyx_analysis/references/api_doc.md) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Guidance] <br>\n**Output Format:** [Markdown and JSON analysis output from command-line execution] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include structured sleep-analysis fields, report links, and historical report tables returned by cloud APIs.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release evidence; artifact frontmatter reports 1.0.9) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.4:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.4:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.3: 31 files, 40403 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2517b), SKILL.md (12498b), 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.3:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.6\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1783948709745\n}\n\nFile v1.0.3:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放儿童睡眠中频繁翻身/噩梦识别 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\n\nFile v1.0.3:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.3:scripts/config.yaml\n\n{}\n\nFile v1.0.3:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.3:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.3:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.3:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.3:skill-card.md\n\n## Description: <br>\nAnalyzes child nighttime audio/video to report rollover frequency, crying, sleep talk, sleep quality, and possible restless-sleep or nightmare alerts. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nParents, caregivers, and developers integrating child sleep monitoring workflows can use this skill to analyze consented nighttime audio/video and produce behavior statistics, alerts, and report links. It is an assistive monitoring tool, not a medical diagnosis. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Children's bedroom audio/video may be sent to or fetched by a third-party cloud service. <br>\nMitigation: Use only recordings with guardian consent after verifying endpoint trust, retention and deletion terms, and data handling controls. <br>\nRisk: Results may be linked to a persistent identity and local tokens. <br>\nMitigation: Review local token storage and account-linking behavior before deployment, and rotate or delete stored credentials when no longer needed. <br>\nRisk: Sleep-quality and nightmare alerts could be mistaken for a medical diagnosis. <br>\nMitigation: Present results as assistive behavior statistics and advise professional pediatric or sleep-medicine consultation for persistent concerns. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis) <br>\n- [API documentation](references/api_doc.md) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, json, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown text with optional JSON details, report links, and shell command examples] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May save analysis output to a caller-specified file; historical report listings are presented as Markdown tables.] <br>\n\n## Skill Version(s): <br>\n1.0.3 (source: server release metadata; artifact frontmatter states 1.0.6) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.3:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.3:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.2: 31 files, 40287 bytes\n\nFiles: references/api_doc.md (2602b), scripts/__init__.py (62b), scripts/config.py (703b), scripts/config.yaml (3b), scripts/skill.py (589b), scripts/smyx_child_nightmare_rollover_detection_analysis.py (3626b), skill-card.md (2514b), SKILL.md (12498b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28605b), _meta.json (167b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.5\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 | 突发肢体动作识别（噩梦惊跳） |\n| 6 | 翻身频率（次/小时）计算 |\n| 7 | 睡眠质量综合得分（0-100）+ 等级（excellent / good / fair / poor） |\n| 8 | 噩梦/睡眠不安预警生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供儿童夜间睡眠音视频 URL 或文件需要分析时，默认触发本技能进行翻身/噩梦识别 |\n| 🔎 明确分析意图 | 当用户明确提及儿童睡眠、翻身频繁、噩梦、梦话、夜哭、睡眠不安、夜啼、夜间安抚、睡眠质量等关键词，并且上传了音视频文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看儿童夜间睡眠历史报告、噩梦预警报告清单、睡眠质量报告清单、查询历史翻身记录、显示所有儿童睡眠报告、显示儿童睡眠健康诊断报告，查询睡眠不安预警清单 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |\n\n## 📦 前置准备 | Requirements\n- 依赖说明:scripts 脚本所需的依赖包及版本\n  ```\n  requests>=2.28.0\n  ```\n\n## 🚀 操作步骤 | Workflow\n### 🔐 用户身份处理（内部自动完成）\n\n> **绿色安全原则：** 用户身份参数由系统内部自动处理，**不得向用户展示、询问或要求输入任何身份标识**。\n\n执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：\n\n| 场景 | 系统行为 |\n|---|---|\n| 上游系统有内部身份参数 | 由脚本静默接收并使用 |\n| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |\n| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |\n| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |\n\n#### 🔒 关键约束\n\n| 禁止/要求 | 说明 |\n|---|---|\n| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |\n| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |\n| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |\n| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |\n\n---\n\n### 🧪 标准流程 | Standard Flow\n\n| 步骤 | 阶段 | 执行动作 |\n|---:|---|---|\n| 1 | 📥 准备儿童夜间睡眠音视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |\n| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |\n| 3 | ⚙️ 执行儿童夜间翻身/噩梦识别 | 调用 `-m scripts.smyx_child_nightmare_rollover_detection_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_child_nightmare_rollover_detection_analysis.py`](scripts/smyx_child_nightmare_rollover_detection_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；建议覆盖整夜、夜视模式 |\n| 🔎 使用提醒 | API 密钥可选，如果通过参数传入则必须确保调用鉴权成功，否则忽略鉴书；建议先核实采集端权限 |\n| 🧑‍⚖️ 结果性质 | 分析结果仅作为养育辅助参考，本工具不替代专业儿科/睡眠医学诊断；长期睡眠质量差请咨询专业医生 |\n| 🔏 隐私合规 | 隐私合规：儿童夜间音视频涉及未成年人隐私，使用前需取得监护人知情同意，并妥善保管/加密相关录像 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json\n```\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1783147420971\n}\n\nFile v1.0.2:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放儿童睡眠中频繁翻身/噩梦识别 API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。\n\nFile v1.0.2:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.2:scripts/config.yaml\n\n{}\n\nFile v1.0.2:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.2:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.2:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.2:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.2:skill-card.md\n\n## Description: <br>\nAnalyzes child night-time sleep audio/video from a fixed camera to report rollovers, crying, sleep talk, sleep quality, and possible nightmare or restless-sleep alerts. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[smyx-sunjinhui](https://clawhub.ai/user/smyx-sunjinhui) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nParents, guardians, and developers use this skill to analyze child night-time sleep media for behavior statistics, sleep-quality summaries, and directional restless-sleep or possible-nightmare alerts. Agents can also use it to query cloud-stored historical reports when the user asks for prior sleep analysis results. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill processes highly sensitive child bedroom audio/video through cloud analysis and report workflows. <br>\nMitigation: Use only with guardian consent, trusted media sources, and a clear understanding of where media and reports are processed, stored, audited, and deleted. <br>\nRisk: Automatic account and report association plus local token storage can reduce user visibility into data access and retention. <br>\nMitigation: Review the account/report flow before installation, limit access to trusted environments, and verify local token handling and report deletion procedures. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/smyx-sunjinhui/skills/smyx-child-nightmare-rollover-detection-analysis) <br>\n- [API documentation](references/api_doc.md) <br>\n- [Analysis API documentation](skills/smyx_analysis/references/api_doc.md) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Guidance] <br>\n**Output Format:** [Markdown summaries and tables with optional JSON report details and report links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May create or retrieve cloud-backed child sleep analysis reports from user-provided local files or URLs.] <br>\n\n## Skill Version(s): <br>\n1.0.2 (source: server release metadata; artifact frontmatter lists 1.0.5) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.2:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.2:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3","readmeExcerpt":"Skill: Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别 Owner: smyx-sunjinhui Summary: Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json"},{"language":"bash","snippet":"python -m scripts.smyx_child_nightmare_rollover_detection_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input /path/to/night_sleep.mp4\n\n# 分析网络夜间睡眠音视频\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --url https://example.com/night_sleep.mp4\n\n# 显示历史儿童夜间翻身/噩梦识别报告（自动触发关键词：查看儿童夜间睡眠历史报告、噩梦预警报告清单等）\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_child_nightmare_rollover_detection_analysis --input sleep.mp4 --output result.json"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"smyx-child-nightmare-rollover-detection-analysis\"\ndescription: \"Using a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep. | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\"\nversion: \"1.0.18\"\nlicense: \"MIT-0\"\n---\n\n# 🌙 Child Restless Sleep / Nightmare Detection | 儿童睡眠中频繁翻身/噩梦识别\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **儿童睡眠中频繁翻身/噩梦识别** |\n| 🎯 核心目标 | 通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` |\n\nUsing a fixed camera in the child's bedroom (infrared night vision), the system continuously captures video and audio at night to analyze the child's sleep behavior. It detects rollover frequency (rollovers per minute), cries (recognizing specific cry-sound features), and sleep talk (speech during sleep), and generates a sleep-quality report. When rollovers occur too often (e.g., > 3 per hour), strong crying is detected, or sleep talk is observed, the system pushes 'possible nightmare' or 'restless sleep' alerts to the parents. Application scenarios: child bedrooms, infant rooms. The system relays night-time monitoring to help parents understand the child's sleep quality and provide timely comfort. Skill features: improve sleep.\n\n通过儿童床或卧室的固定摄像头（红外夜视），在夜间连续采集视频及音频，分析儿童的睡眠行为。检测翻身次数（每分钟翻身频率）、哭声（识别特定的哭声音频特征）以及梦话（检测睡眠中的语音），生成睡眠质量报告。当翻身过于频繁（如>3次/小时）、出现强烈哭声或梦话时，推送给父母'可能做噩梦'或'睡眠不安'的预警。应用场景：儿童卧室、婴儿房。系统夜间接力监测，帮助家长了解儿童睡眠质量，及时安抚。技能特点：改善睡眠。\n\n## 🤖 AI 角色 | AI Role\n| 角色要点 | 说明 |\n|---|---|\n| 说明 1 | **假设你是一个专业的儿童睡眠健康 AI。你的任务是分析儿童夜间睡眠视频及音频，检测翻身动作、哭声以及梦话，评估睡眠质量。不要提供医疗诊断或睡眠障碍诊断，仅输出基于视觉和听觉的睡眠行为统计与方向性安抚提醒。** |\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n### 1. 🧩 技能用途\n\n基于儿童夜间睡眠音视频，统计翻身次数、哭声/梦话事件，评估睡眠质量并对噩梦/睡眠不安推送预警\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 儿童夜视检测 |\n| 2 | 姿态/朝向变化分析（翻身事件） |\n| 3 | 哭声音频特征识别 |\n| 4 | 梦话/呓语识别 |\n| 5 |"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7cyxkr2ymf7zwsrybpedg8xx83ywrj\",\n  \"slug\": \"smyx-child-nightmare-rollover-detection-analysis\",\n  \"version\": \"1.0.11\",\n  \"publishedAt\": 1790662411025\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}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_CHILD_NIGHTMARE_ROLLOVER_DETECTION_ANALYSIS` - 儿童睡眠中频繁翻身/噩梦识别\n\n## 输入约束\n\n- 摄像头建议固定于儿童床上方/侧方，覆盖全身；夜间启用红外/微光模式\n- 必须含**音频通道**（用于哭声/梦话识别）\n- 视频帧率建议 ≥ 10 FPS；时段建议覆盖整夜（如 20:00 - 次日 07:00）\n\n## 关键检测对象\n\n- 姿态/身体朝向变化（翻身事件）\n- 哭声音频特征（音调 / 频率 / 持续时间）\n- 梦话/呓语（睡眠中语音识别）\n- 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 关键事件\n\n- `rollover` - 翻身事件（含时间戳，单次/累计）\n- `cry` - 哭声事件（含时间戳 + 持续秒数 + 强度）\n- `sleep_talk` - 梦话事件\n- `body_jerk` - 突发肢体大幅度动作（疑似噩梦惊跳）\n\n## 默认告警阈值（可由调用方覆盖）\n\n- 翻身频率阈值：> 3 次/小时 → 触发\"睡眠不安\"\n- 哭声强度阈值：超过预设 → 触发\"可能做噩梦\"\n- 梦话频次阈值：≥ 3 次/小时 → 触发\"睡眠不安\"\n\n## 输出字段（参考）\n\n- `child_detected` - 是否检测到儿童\n- `sleep_duration_min` - 累计睡眠时长（分钟）\n- `rollover_count` - 累计翻身次数\n- `rollover_rate_per_hour` - 翻身频率（次/小时）\n- `cry_events` - 哭声事件列表（时间戳 + 持续秒数 + 强度）\n- `sleep_talk_events` - 梦话事件列表\n- `body_jerk_events` - 突发肢体动作事件\n- `sleep_quality_score` - 睡眠质量综合得分（0-100）\n- `sleep_quality_grade` - 等级（excellent / good / fair / poor）\n- `nightmare_alert` - 是否触发噩梦/睡眠不安预警\n- `alert_message` - 预警文本（如\"宝宝近 1 小时翻身 5 次并伴有哭声，可能做噩梦，请前往安抚\"）\n\n> 仅输出基于视觉与听觉的睡眠行为统计，不提供医学诊断或睡眠障碍诊断；如儿童长期睡眠质量差，请咨询专业儿科或睡眠医学医生。"},{"path":"skills/smyx_analysis/references/api_doc.md","content":"# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |"},{"path":"scripts/config.yaml","content":"{}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1064,"uniquenessScore":39,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T04:54:20.548Z","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:54:20.548Z","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:01.935Z","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"}]}}}