{"id":"33a6ff61-8644-4343-bd2c-0b97de459d36","entityType":"agent","slug":"clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis","name":"Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）","canonicalUrl":"https://www.xpersona.co/agent/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis","canonicalPath":"/agent/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis","generatedAt":"2026-10-10T06:26:08.944Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T19:56:39.117Z","emptyReason":null},"description":"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-neonatal-jaundice-screening-analysis","sourceUrl":"https://clawhub.ai/18072937735/smyx-neonatal-jaundice-screening-analysis","homepage":"https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/18072937735/smyx-neonatal-jaundice-screening-analysis","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":66,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色） 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-09T19:56:39.117Z","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-09T19:56:39.117Z","emptyReason":null},"stars":null,"forks":null,"downloads":2051,"packageName":null,"latestVersion":"1.0.13","tractionLabel":"2.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T19:56:39.117Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T19:56:39.117Z","lastCrawledAt":"2026-10-09T19:56:39.117Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T19:56:39.117Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.13","createdAt":"2026-10-01T16:17:27.218Z","changelog":"- Removed the \"skill-card.md\" file from the package. - No change to core features or user workflow. - Documentation and skill functionality remain unchanged.","fileCount":31,"zipByteSize":41534},{"version":"1.0.12","createdAt":"2026-09-24T19:28:41.833Z","changelog":"- Version updated to 1.0.15 - Updated internal configuration files (`config.yaml`) - Documentation improvements in SKILL.md, including version bump and minor edits - Removed deprecated file: `skill-card.md`","fileCount":31,"zipByteSize":41448},{"version":"1.0.11","createdAt":"2026-09-15T21:29:30.648Z","changelog":"- Updated version to 1.0.14 in SKILL.md. - Removed redundant file: skill-card.md. - No changes to functionality or workflow. - Documentation and usage instructions remain unchanged.","fileCount":31,"zipByteSize":41632},{"version":"1.0.10","createdAt":"2026-08-28T16:19:31.639Z","changelog":"- Removed the file skill-card.md. - No changes were made to the skill’s code or functionality. - Documentation and usage of the skill remain unchanged.","fileCount":31,"zipByteSize":41681},{"version":"1.0.9","createdAt":"2026-08-23T00:34:45.261Z","changelog":"- Version update from 1.0.8 to 1.0.10 in SKILL.md. - Minor internal configuration changes in `skills/smyx_common/scripts/config.yaml`. - Removed redundant documentation file `skill-card.md`.","fileCount":31,"zipByteSize":41661},{"version":"1.0.8","createdAt":"2026-08-11T12:30:35.470Z","changelog":"Version 1.0.8 - Updated SKILL.md documentation, including minor adjustments and version bump to 1.0.8. - Removed the skill-card.md file for streamlined documentation structure. - No changes to core functionality or code are indicated.","fileCount":31,"zipByteSize":41479},{"version":"1.0.7","createdAt":"2026-08-03T00:55:33.640Z","changelog":"- Version updated to 1.0.7. - Documentation improved: SKILL.md updated for clarity and detail. - Obsolete file removed: skill-card.md deleted.","fileCount":31,"zipByteSize":41570},{"version":"1.0.6","createdAt":"2026-07-27T02:28:43.247Z","changelog":"- Updated version to 1.0.6 in SKILL.md. - Removed file: skill-card.md. - No changes to core logic or functionality documented. - Documentation update ensures version consistency and cleans up removed/outdated files.","fileCount":31,"zipByteSize":41669}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-neonatal-jaundice-screening-analysis","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-neonatal-jaundice-screening-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/18072937735/smyx-neonatal-jaundice-screening-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-18072937735-smyx-neonatal-jaundice-screening-analysis/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/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-10T06:26:08.940Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-neonatal-jaundice-screening-analysis/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-09T19:56:39.117Z","emptyReason":null},"readme":"Skill: Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n\nOwner: 18072937735\n\nSummary: Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\n\nTags: latest:1.0.13\n\nVersion history:\n\nv1.0.13 | 2026-10-01T16:17:27.218Z | auto\n\n- Removed the \"skill-card.md\" file from the package.\n- No change to core features or user workflow. \n- Documentation and skill functionality remain unchanged.\n\nv1.0.12 | 2026-09-24T19:28:41.833Z | auto\n\n- Version updated to 1.0.15\n- Updated internal configuration files (`config.yaml`)\n- Documentation improvements in SKILL.md, including version bump and minor edits\n- Removed deprecated file: `skill-card.md`\n\nv1.0.11 | 2026-09-15T21:29:30.648Z | auto\n\n- Updated version to 1.0.14 in SKILL.md.\n- Removed redundant file: skill-card.md.\n- No changes to functionality or workflow.\n- Documentation and usage instructions remain unchanged.\n\nv1.0.10 | 2026-08-28T16:19:31.639Z | auto\n\n- Removed the file skill-card.md.\n- No changes were made to the skill’s code or functionality.\n- Documentation and usage of the skill remain unchanged.\n\nv1.0.9 | 2026-08-23T00:34:45.261Z | auto\n\n- Version update from 1.0.8 to 1.0.10 in SKILL.md.\n- Minor internal configuration changes in `skills/smyx_common/scripts/config.yaml`.\n- Removed redundant documentation file `skill-card.md`.\n\nv1.0.8 | 2026-08-11T12:30:35.470Z | auto\n\nVersion 1.0.8\n\n- Updated SKILL.md documentation, including minor adjustments and version bump to 1.0.8.\n- Removed the skill-card.md file for streamlined documentation structure.\n- No changes to core functionality or code are indicated.\n\nv1.0.7 | 2026-08-03T00:55:33.640Z | auto\n\n- Version updated to 1.0.7.\n- Documentation improved: SKILL.md updated for clarity and detail.\n- Obsolete file removed: skill-card.md deleted.\n\nv1.0.6 | 2026-07-27T02:28:43.247Z | auto\n\n- Updated version to 1.0.6 in SKILL.md.\n- Removed file: skill-card.md.\n- No changes to core logic or functionality documented.\n- Documentation update ensures version consistency and cleans up removed/outdated files.\n\nv1.0.5 | 2026-07-13T11:54:27.060Z | auto\n\n- Internal utility updates in skills/smyx_common/scripts/util.py.\n- Removed the redundant skill-card.md documentation file.\n- No changes to the user-facing features or workflow.\n\nv1.0.4 | 2026-07-10T00:30:48.600Z | auto\n\nVersion 1.0.4\n\n- Updated documentation in SKILL.md with the latest feature, usage, and scenario details.\n- Removed skill-card.md file to streamline documentation.\n- No code or logic changes; this release focuses on documentation and guidance improvements.\n\nv1.0.3 | 2026-07-05T01:49:43.897Z | auto\n\n**Changelog for smyx-neonatal-jaundice-screening-analysis v1.0.3**\n\n- Greatly improved privacy: removed all prompts/requirements for user to input or view open-id or internal identification info; these are now handled automatically and invisibly by the system.\n- Strengthened data security and compliance: identity association and report fetching use only trusted backend mechanisms.\n- Refactored user documentation: simplified workflow steps and emphasized that identity details should not be displayed, requested, or shown in examples.\n- Updated and clarified SKILL.md; expanded resource index and workflow summary.\n- Removed obsolete files and consolidated script structure.\n\nv1.0.2 | 2026-06-23T04:29:30.645Z | auto\n\n- Improved code structure and refactored logic in key scripts for maintainability.\n- Updated configuration handling in config.yaml to better support API key management.\n- Removed redundant or outdated documentation files (skill-card.md).\n- Enhanced shared utility and data access modules to streamline script interactions.\n\nv1.0.1 | 2026-06-18T10:44:25.966Z | auto\n\n- Updated open-id configuration priority: now checks scripts/config.yaml in the skill directory first.\n- Documentation improvements and simplification in SKILL.md for better clarity and guidance.\n- Removed obsolete or redundant markdown files (skill-card.md).\n- Updated or refined scripts and requirements for consistency with the new configuration logic.\n- Added explicit license information (MIT-0) to SKILL.md.\n- No user-facing feature changes; changes are process and documentation-focused.\n\nv1.0.0 | 2026-05-26T07:44:08.130Z | auto\n\nsmyx-neonatal-jaundice-screening-analysis 1.0.0 – Initial public release\n\n- Enables AI-driven pre-screening of neonatal jaundice by analyzing high-resolution facial images to assess sclera and skin yellowness.\n- Automatically outputs jaundice risk level (low / medium / high / inconclusive) with parental and medical action suggestions.\n- Supports daily scheduled or on-demand analysis, image quality checks, and reminder notifications for medium or high risk.\n- Allows querying and viewing of structured historical screening reports via cloud API, with strict open-id/user authentication requirements.\n- Designed for integration with smart baby monitors or maternal/infant apps, and applicable in both home and healthcare settings.\n- Bilingual instructions and workflows provided (English/Chinese) for diverse user needs.\n\nArchive index:\n\nArchive v1.0.13: 31 files, 41534 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2453b), SKILL.md (13160b), 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 (161b)\n\nFile v1.0.13:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.15\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.13:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.13\",\n  \"publishedAt\": 1790871447218\n}\n\nFile v1.0.13: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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\n\n> 仅输出基于视觉的黄疸风险初筛提示，**不替代** 经皮胆红素仪 / 血清胆红素 / 医生面诊；中高风险务必尽快就医，由专业医生评估并制定干预方案。\n\nFile v1.0.13: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.13:scripts/config.yaml\n\n{}\n\nFile v1.0.13:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.13: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.13: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.13: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.13:skill-card.md\n\n## Description:\n\nAnalyzes newborn facial images or short videos to provide preliminary jaundice-risk guidance and links to screening reports.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents and neonatal care teams can submit a newborn's facial image or short video for preliminary jaundice-risk screening and retrieve prior reports. The result is not a medical diagnosis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Newborn health images or videos may be sent to remote services, and report history may be queried without explicit consent.\n\nMitigation: Obtain guardian consent before upload or cloud history access, and review the destination and report links before using real infant data.\n\nRisk: Automatically created or reused identities and locally stored access tokens could expose reports across users.\n\nMitigation: Use only a trusted single-user workspace until authenticated per-user identity, explicit consent, and secure token storage are in place.\n\nRisk: Visual screening can produce misleading jaundice-risk results, especially when lighting or image quality is poor.\n\nMitigation: Treat outputs as preliminary, recapture inconclusive images in suitable lighting, and seek clinician assessment and bilirubin testing for concerning results.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis)\n- [Screening API documentation](references/api_doc.md)\n- [Analysis API documentation](skills/smyx_analysis/references/api_doc.md)\n- [Skill demonstration](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [Analysis, Markdown, JSON, Guidance]\n\n**Output Format:** [Text or Markdown screening report; optional structured JSON and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Risk levels include low, medium, high, and inconclusive; historical report listings are available.]\n\n## Skill Version(s):\n\n1.0.13 (source: server release metadata; packaged SKILL.md declares 1.0.15)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.13:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.13:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.12: 31 files, 41448 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2300b), SKILL.md (13160b), 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 (161b)\n\nFile v1.0.12:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.15\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.12:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.12\",\n  \"publishedAt\": 1790278121833\n}\n\nFile v1.0.12:references/api_doc.md\n\n# API 接口文档\n\n此处用于存放新生儿黄疸筛查（面部皮肤颜色）API 的接口文档，待后续补充。\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 响应格式：JSON\n\n## 主要接口\n\n1. `/web/health-analysis/v2/start-health-analysis` - 启动新生儿黄疸筛查任务\n2. `/web/health-analysis/v2/get-health-analysis-result` - 获取黄疸风险分析结果\n3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史筛查记录\n4. `/health/order/api/getReportDetailExport?id={id}` - 导出完整报告\n\n## 场景代码\n\n- `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\n\n> 仅输出基于视觉的黄疸风险初筛提示，**不替代** 经皮胆红素仪 / 血清胆红素 / 医生面诊；中高风险务必尽快就医，由专业医生评估并制定干预方案。\n\nFile v1.0.12:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.12:scripts/config.yaml\n\n{}\n\nFile v1.0.12:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.12:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.12:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.12:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.12:skill-card.md\n\n## Description:\n\nAnalyzes newborn face images or video to provide a preliminary visual jaundice-risk indication and suggested follow-up, without replacing clinical testing or diagnosis.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nParents and care teams use the skill to screen newborn face images or short videos for possible jaundice and view preliminary risk guidance or past reports. Results are not a diagnosis and should not replace bilirubin testing or clinical assessment.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive newborn face images or video URLs and report queries are sent to LifeEmergence cloud services.\n\nMitigation: Obtain guardian consent before use and confirm the publisher's data retention, deletion, and access practices.\n\nRisk: The skill silently creates or reuses persistent identities and tokens with limited user-facing control.\n\nMitigation: Ask the publisher how identities are bound to accounts, how tokens are stored, and whether local identity data is encrypted before installation.\n\nRisk: Visual screening can be inconclusive or misleading, especially with poor lighting or obscured facial features.\n\nMitigation: Treat output as preliminary guidance only; seek clinical assessment and appropriate bilirubin testing rather than relying on the result for diagnosis.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis)\n- [API interface reference](references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON]\n\n**Output Format:** [Structured analysis text or JSON; historical reports may be presented in Markdown]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Preliminary risk indication, suggested follow-up, and report links when available]\n\n## Skill Version(s):\n\n1.0.12 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.12:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.12:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.11: 31 files, 41632 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2558b), SKILL.md (13160b), 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 (161b)\n\nFile v1.0.11:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.14\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.11:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.11\",\n  \"publishedAt\": 1789507770648\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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: dev\n\nFile v1.0.11:skill-card.md\n\n## Description:\n\nAnalyzes newborn face images or short videos to produce a visual jaundice risk hint based on sclera color and facial skin yellowness, with recommendations for clinical confirmation when risk is elevated.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal caregivers, clinicians, and developers use this skill to run an AI-assisted visual prescreening workflow for neonatal jaundice from newborn face media. The output supports early risk triage and directs medium or high risk cases to professional bilirubin testing and medical review.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill handles highly sensitive newborn health images, videos, and report queries.\n\nMitigation: Install and use it only with explicit guardian consent and after confirming retention, deletion, and access controls for infant health records.\n\nRisk: Default networking and hidden identity or account handling may expose sensitive data in ways users do not expect.\n\nMitigation: Confirm the release uses HTTPS production endpoints, avoids silent account creation or token storage, and clearly documents any account association before deployment.\n\nRisk: Visual jaundice screening can be misleading under poor lighting, color casts, filters, or obstructed facial features.\n\nMitigation: Require clear naturally lit media and treat medium, high, or repeated abnormal results as prompts for professional bilirubin testing rather than diagnosis.\n\n## Reference(s):\n\n- [API Interface Documentation](references/api_doc.md)\n- [Supplemental API Error Codes](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 or JSON analysis report with risk level, confidence, recommended action, and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May save analysis output to a user-specified file and may list prior reports as a Markdown table.]\n\n## Skill Version(s):\n\n1.0.11 (source: ClawHub release evidence; artifact frontmatter reports 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.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, 41681 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2753b), SKILL.md (13160b), 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 (161b)\n\nFile v1.0.10:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.10\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.10:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1787933971639\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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: dev\n\nFile v1.0.10:skill-card.md\n\n## Description:\n\nAnalyzes newborn face images or short videos to produce a visual jaundice risk hint based on sclera color and facial skin yellowness, with non-diagnostic guidance for follow-up.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal caregivers, clinical support teams, and developers use this skill to pre-screen newborn face images or short videos for visual jaundice risk and to retrieve cloud-linked historical screening reports. The output is a preliminary risk hint and follow-up guidance, not a medical diagnosis or bilirubin measurement.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill handles sensitive newborn images, videos, and account-linked report history through cloud services.\n\nMitigation: Use only where a guardian has explicitly consented to cloud processing, and apply appropriate access control, encryption, and retention practices for submitted media and reports.\n\nRisk: The skill can create or reuse a local default identity and store API tokens in a workspace SQLite database.\n\nMitigation: Run it in an isolated workspace, restrict access to local storage, and remove local identity or token data when it is no longer needed.\n\nRisk: Visual jaundice screening can be misleading under poor lighting, color casts, filters, occlusion, or unclear facial views.\n\nMitigation: Capture clear images in natural white light, treat inconclusive or medium/high risk outputs conservatively, and confirm concerns with professional bilirubin testing and clinical review.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [API interface reference](references/api_doc.md)\n- [Analysis API error reference](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Guidance]\n\n**Output Format:** [Markdown and JSON-style structured screening reports with risk level, confidence, recommended action, and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include low, medium, high, or inconclusive jaundice-risk hints; historical report queries are returned from cloud-linked records.]\n\n## Skill Version(s):\n\n1.0.10 (source: frontmatter and 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.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, 41661 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2691b), SKILL.md (13160b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (472b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.10\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1787445285261\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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\nAnalyzes newborn face images or short videos to return a visual jaundice risk hint and recommended next step for caregiver or clinical follow-up.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal caregivers, healthcare staff, and product teams use the skill to submit newborn face images or short videos for visual jaundice pre-screening, receive low, medium, high, or inconclusive risk hints, and decide whether to observe, retake the image, or seek clinical bilirubin testing.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive newborn images, videos, medical-risk results, and report history are routed through configured remote services.\n\nMitigation: Use only after confirming the backend is the intended production HTTPS service and that guardian consent, data retention, and access controls are handled outside the skill.\n\nRisk: The skill silently creates or reuses identities and stores tokens or profile data locally.\n\nMitigation: Review whether local workspace token/profile storage is acceptable before deployment and clear or isolate the workspace data store when handling real infant health records.\n\nRisk: Visual jaundice screening can be misleading because lighting, filters, occlusion, or skin-color artifacts can affect color analysis.\n\nMitigation: Treat outputs as pre-screening only, retake images in natural white light when quality is poor, and require professional bilirubin measurement for medium or high risk results.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis)\n- [API documentation](artifact/references/api_doc.md)\n- [Skill demo](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [Analysis, Markdown, JSON, Shell commands, Guidance]\n\n**Output Format:** [Markdown or JSON structured report with risk level, confidence, observed visual features, recommended action, alert text, and optional report link.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May save reports to a local file when an output path is provided and may list historical reports from the configured cloud API.]\n\n## Skill Version(s):\n\n1.0.9 (source: server release metadata; artifact 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.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, 41479 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2360b), SKILL.md (13159b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1786451435470\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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: prod\n\nFile v1.0.8:skill-card.md\n\n## Description:\n\nAnalyzes newborn face images or short videos for visual jaundice indicators and returns a non-diagnostic low, medium, high, or inconclusive risk hint with suggested next steps.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users, caregivers, and clinical support teams use this skill to submit newborn face images or short videos for non-diagnostic visual jaundice risk screening, history lookup, and follow-up guidance.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends sensitive newborn face images or videos, related metadata, and account identifiers to a LifeEmergence cloud service.\n\nMitigation: Use only with explicit guardian consent, appropriate privacy controls, and approval for cloud processing of infant media and identifiers.\n\nRisk: The skill silently creates and persists local identity or token records for future report history lookup.\n\nMitigation: Review local credential storage behavior before deployment and restrict access to generated identity or token records.\n\nRisk: Visual jaundice screening can be affected by lighting, filters, image quality, and other capture conditions.\n\nMitigation: Treat outputs as screening hints only and require clinical bilirubin confirmation, especially for medium or high risk results.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-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, Guidance]\n\n**Output Format:** [Markdown report or JSON result with risk level, confidence, recommendations, and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May save an output file when requested; results are non-diagnostic visual screening hints.]\n\n## Skill Version(s):\n\n1.0.8 (source: frontmatter and server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.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, 41570 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2674b), SKILL.md (13159b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.7\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1785718533640\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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: prod\n\nFile v1.0.7:skill-card.md\n\n## Description: <br>\nScreens newborn facial images or short videos for visual jaundice risk indicators, producing low, medium, high, or inconclusive risk hints with follow-up guidance. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[18072937735](https://clawhub.ai/user/18072937735) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal caregivers, clinical support teams, and developers use this skill to pre-screen newborn facial imagery for visual jaundice risk signals and retrieve structured cloud reports. It is an early attention aid and does not replace clinician diagnosis or bilirubin testing. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Sensitive newborn face images, videos, and report-history requests are handled through the provider's cloud service. <br>\nMitigation: Use only with guardian consent and confirm the provider's retention, deletion, access-control, and data-handling expectations before deployment. <br>\nRisk: The skill may silently create or reuse persistent identity and token state. <br>\nMitigation: Deploy only where silent account creation and local token storage are acceptable, and isolate or rotate local state according to the environment's policy. <br>\nRisk: Visual jaundice screening can be misleading if treated as a diagnosis. <br>\nMitigation: Present results as preliminary risk hints and route medium, high, inconclusive, or persistent abnormal results to clinician review and bilirubin testing. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n- [Neonatal jaundice screening API documentation](references/api_doc.md) <br>\n- [Shared analysis API documentation](skills/smyx_analysis/references/api_doc.md) <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 detail and report links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include jaundice risk level, confidence, recommended action, visual feature metrics, and cloud report links.] <br>\n\n## Skill Version(s): <br>\n1.0.7 (source: frontmatter and server release evidence) <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.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, 41669 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2891b), SKILL.md (13159b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.6\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1785119323247\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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: prod\n\nFile v1.0.6:skill-card.md\n\n## Description: <br>\nAnalyzes newborn face images or short videos through a cloud service to return a visual jaundice risk hint based on sclera color and facial skin yellowness. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[18072937735](https://clawhub.ai/user/18072937735) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nCaregivers, clinicians, and developers use this skill to submit newborn face images or short videos for cloud-based visual jaundice pre-screening and to retrieve historical screening reports. The results are risk hints and report links, not a substitute for clinician evaluation or bilirubin measurement. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Newborn images, video URLs, report queries, and report links may contain sensitive infant health data and are sent to the LifeEmergence cloud service. <br>\nMitigation: Use only with guardian consent; confirm the publisher's retention, authorization, deletion, and access-control practices before using real infant health data. <br>\nRisk: The skill can create or reuse a local identity and cached tokens in the workspace. <br>\nMitigation: Run it in a controlled workspace, protect or remove local identity and token files after use, and avoid shared machines for real health data. <br>\nRisk: Visual jaundice screening can be misleading under poor lighting, filters, face occlusion, or warm yellow light and is not a medical diagnosis. <br>\nMitigation: Capture clear newborn face media in natural white light and route medium, high, inconclusive, or persistent abnormal results to a clinician for bilirubin measurement. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis) <br>\n- [Publisher Profile](https://clawhub.ai/user/18072937735) <br>\n- [Skill Demo](https://lifeemergence.com/sample.html) <br>\n- [API Documentation](references/api_doc.md) <br>\n- [Shared Analysis API Documentation](skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, shell commands, guidance] <br>\n**Output Format:** [Structured JSON or Markdown report text with risk level, confidence, recommended action, and report links.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May save report output to a file when an output path is supplied; history queries return cloud report records.] <br>\n\n## Skill Version(s): <br>\n1.0.6 (source: frontmatter and server release evidence) <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.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, 41733 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2944b), SKILL.md (13159b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28776b), _meta.json (160b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.4\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1783943667060\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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: <br>\nAnalyzes newborn face images or short videos with AI visual screening to estimate sclera and facial-skin yellowness and return a low, medium, high, or inconclusive jaundice-risk hint. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[18072937735](https://clawhub.ai/user/18072937735) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal caregivers, newborn-family product teams, and medical-support staff use this skill to submit newborn face media for a cloud-based visual jaundice pre-screen and history-report lookup. Results are preliminary risk hints and should be confirmed by professional bilirubin measurement and clinical review. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can send sensitive newborn face images, videos, and health-report queries to the publisher's cloud service. <br>\nMitigation: Use only with guardian consent in a controlled workspace, avoid unnecessary identifying media, and do not use the result as a diagnosis or for urgent medical decisions. <br>\nRisk: Visual jaundice screening can be affected by lighting, filters, obstruction, skin products, or camera quality. <br>\nMitigation: Capture media in natural white light without filters or obstructions, treat inconclusive or medium/high results as prompts for professional bilirubin testing, and seek clinical care for concerning symptoms. <br>\nRisk: The security review notes automatic local identity management and workspace token persistence. <br>\nMitigation: Install only in an isolated workspace, review stored credentials before and after use, and clear local state or rotate tokens when the skill is no longer needed. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Listing](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis) <br>\n- [Skill Demo](https://lifeemergence.com/sample.html) <br>\n- [API Documentation](references/api_doc.md) <br>\n- [Analysis API Documentation](skills/smyx_analysis/references/api_doc.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Guidance] <br>\n**Output Format:** [Markdown and JSON-style structured analysis text with report links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Outputs include visual jaundice-risk hints, confidence or recommended action fields when returned by the service, history-report records, and links to exported reports; outputs are not medical diagnoses.] <br>\n\n## Skill Version(s): <br>\n1.0.5 (source: server release evidence; artifact frontmatter lists 1.0.4) <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.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, 41514 bytes\n\nFiles: references/api_doc.md (3435b), scripts/__init__.py (55b), scripts/config.py (701b), scripts/config.yaml (3b), scripts/skill.py (594b), scripts/smyx_neonatal_jaundice_screening_analysis.py (3656b), skill-card.md (2653b), SKILL.md (13159b), skills/smyx_analysis/__init__.py (0b), skills/smyx_analysis/references/api_doc.md (427b), skills/smyx_analysis/requirements.txt (45b), skills/smyx_analysis/scripts/__init__.py (0b), skills/smyx_analysis/scripts/api_service.py (1509b), skills/smyx_analysis/scripts/config.py (1003b), skills/smyx_analysis/scripts/config.yaml (3b), skills/smyx_analysis/scripts/skill.py (6529b), skills/smyx_analysis/scripts/smyx_analysis.py (3833b), skills/smyx_common/__init__.py (0b), skills/smyx_common/requirements.txt (47b), skills/smyx_common/scripts/__init__.py (177b), skills/smyx_common/scripts/api_service.py (2645b), skills/smyx_common/scripts/base.py (469b), skills/smyx_common/scripts/config-dev.yaml (214b), skills/smyx_common/scripts/config-prod.yaml (0b), skills/smyx_common/scripts/config-test.yaml (256b), skills/smyx_common/scripts/config.py (24363b), skills/smyx_common/scripts/config.yaml (473b), skills/smyx_common/scripts/dao.py (18266b), skills/smyx_common/scripts/skill.py (2473b), skills/smyx_common/scripts/util.py (28605b), _meta.json (160b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.4\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿正面面部高清图像/短视频，提取巩膜与面部皮肤的黄染特征 → 输出 4 级黄疸风险（low_risk / medium_risk / high_risk / inconclusive）并给出明确就医建议\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 新生儿面部检测 |\n| 2 | 巩膜（眼白）分割与黄染指数计算 |\n| 3 | 面部皮肤 ROI 颜色分析（Lab b* / YCbCr 偏移） |\n| 4 | 可见参考色卡的白平衡校准识别 |\n| 5 | 光照质量评分（low / medium / high） |\n| 6 | 估算胆红素水平（mg/dL |\n| 7 | 仅参考） |\n| 8 | 风险等级与置信度判定 |\n| 9 | 家长推送文本与下一步建议（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light） |\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_neonatal_jaundice_screening_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.smyx_neonatal_jaundice_screening_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_neonatal_jaundice_screening_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_neonatal_jaundice_screening_analysis.py`](scripts/smyx_neonatal_jaundice_screening_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| 📁 格式支持 | 输入要求：支持 jpg/png 高清图像（建议 1-3 MB）或 mp4/avi/mov 3-10 秒短视频，最大 10MB |\n| 🧑‍⚖️ 结果性质 | **本工具仅作家庭/初筛参考，不能替代** 经皮胆红素仪 / 血清总胆红素（TSB）/ 新生儿科医生诊断 |\n| 🔎 使用提醒 | 偏色光（黄光夜灯、暖白光）、滤镜美颜、皮肤化妆品/护肤油残留 会导致误判，必须在自然白光下重拍 |\n| 🔎 使用提醒 | 黄疸进展可能很快，新生儿首周内**任何**中高风险结果建议立即就医；本工具结果连续异常时不要等待\"系统提醒升级\" |\n| 🔏 隐私合规 | 隐私合规：新生儿面部图像涉及未成年人高度敏感隐私，使用前需取得监护人明确知情同意，妥善加密保管 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json\n```\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783643448600\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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 newborn facial images or short videos to provide a visual jaundice risk hint, structured findings, suggested next steps, and report links. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[18072937735](https://clawhub.ai/user/18072937735) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal caregivers, healthcare staff, and developers use the skill to submit newborn face images or short videos for visual jaundice prescreening and historical report lookup. The output is intended as an early risk hint and should be confirmed with professional bilirubin testing for medium or high risk results. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Newborn images, videos, and report queries are processed by external services and linked to locally persisted identity data. <br>\nMitigation: Obtain guardian consent, disclose external endpoints and retention behavior, and review local data/smyx-common-claw.db and data/smyx-api-key.txt before deployment. <br>\nRisk: The visual output may be mistaken for a medical diagnosis. <br>\nMitigation: Present results only as prescreening guidance and direct medium or high risk cases to professional transcutaneous or serum bilirubin confirmation. <br>\nRisk: The security scan verdict is suspicious because of sensitive data handling and local token or identity persistence. <br>\nMitigation: Prefer a version with explicit consent, endpoint disclosure, retention limits, and removal of the pet-type mismatch before broad use. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/18072937735/skills/smyx-neonatal-jaundice-screening-analysis) <br>\n- [Neonatal Jaundice 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, Files] <br>\n**Output Format:** [Markdown or JSON structured report with risk level, confidence, recommended action, alert text, and optional report links.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Can save an output file when requested and can list historical reports through the remote service.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: SKILL.md frontmatter and server release evidence) <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","readmeExcerpt":"Skill: Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色） Owner: 18072937735 Summary: Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python -m scripts.smyx_neonatal_jaundice_screening_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json"},{"language":"bash","snippet":"python -m scripts.smyx_neonatal_jaundice_screening_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析本地新生儿面部高清图像\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input /path/to/baby_face.jpg\n\n# 分析网络新生儿面部高清图像/短视频\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --url https://example.com/baby_face.jpg\n\n# 显示历史新生儿黄疸筛查报告（自动触发关键词：查看新生儿黄疸历史报告、黄疸筛查报告清单等）\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --list\n\n# 输出精简报告\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --detail basic\n\n# 保存结果到文件\npython -m scripts.smyx_neonatal_jaundice_screening_analysis --input baby.jpg --output result.json"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"smyx-neonatal-jaundice-screening-analysis\"\ndescription: \"Using a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。\"\nversion: \"1.0.15\"\nlicense: \"MIT-0\"\n---\n\n# 👶 Neonatal Jaundice Screening (Facial Skin Color) | 新生儿黄疸筛查（面部皮肤颜色）\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **新生儿黄疸筛查（面部皮肤颜色）** |\n| 🎯 核心目标 | 通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `SMYX_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` |\n\nUsing a neonatal monitor or baby camera, the system captures high-resolution facial images of the newborn and uses AI visual analysis to detect sclera color (white in normal babies, yellow when jaundiced) and facial skin yellowness index (based on skin-color chromatic spaces, e.g., mapping the skin region to estimated clinical bilirubin levels). It outputs a jaundice-risk hint (low / medium / high risk). The skill assists parents and medical staff in the early detection of neonatal hyperbilirubinemia for timely medical intervention. Application scenarios: newborn families, mother-baby rooming-in, neonatology wards, postpartum care centers. The system captures and analyzes images on a daily schedule or on demand, outputting a jaundice-risk level and pushing reminders when medium or high risk is reached. Skill features: neonatal jaundice has a high incidence; if severe, it can lead to kernicterus and brain injury. AI visual pre-screening helps parents monitor changes at home and recognize signs that require medical attention. Can be integrated into smart baby monitors or maternal/infant apps, becoming a practical health assistant for newborn families.\n\n通过新生儿监护器或婴儿摄像头拍摄新生儿面部高清图像，利用AI视觉分析技术检测巩膜（眼白）的颜色（正常白色，黄疸时呈黄色）以及面部皮肤的黄染指数（基于肤色色度空间，如将皮肤区域映射到临床胆红素水平估算），输出黄疸风险提示（低风险/中风险/高风险）。该技能可辅助家长及医护人员早期发现新生儿高胆红素血症，及时就医干预。应用场景：新生儿家庭、母婴同室、新生儿科、月子中心。系统每日定时或按需拍照分析，输出黄疸风险等级，当达到中高风险时推送提醒。技能特点：新生儿黄疸发病率高，严重时可导致核黄疸，造成脑损伤。通过AI视觉初筛，可帮助家长在家监测黄疸变化，及时识别需要就医的迹象。该技能可集成到智能婴儿监护器或母婴APP中，提升产品实用性，成为新生儿家庭的健康助手。\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基于新生儿"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-neonatal-jaundice-screening-analysis\",\n  \"version\": \"1.0.13\",\n  \"publishedAt\": 1790871447218\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_NEONATAL_JAUNDICE_SCREENING_ANALYSIS` - 新生儿黄疸筛查（面部皮肤颜色）\n\n## 输入约束\n\n- 设备：新生儿监护器 / 婴儿摄像头 / 手机后置摄像头\n- 图像/视频要求：高清、正面、五官清晰、面部完整可见\n- **光照要求**：自然白光最佳；**严禁使用偏色 LED 光（黄光夜灯、暖光等会引起严重误判）**\n- 拒绝厚妆 / 滤镜；新生儿建议在喂奶或安静状态下采集\n- 视频时长 3-10 秒 或 单张 1-3 MB 高清图均可\n- 推荐附带可见参考色卡放在面颊旁，便于颜色校正（白平衡校准）\n\n## 关键观测特征\n\n- `face_visible` - 是否检测到清晰新生儿面部\n- `sclera_visible` - 巩膜（眼白）是否可见\n- `sclera_yellowness_index` - 巩膜黄染指数（0-1，越大越黄）\n- `skin_yellowness_index` - 面部皮肤黄染指数（基于色度空间 Lab b* 通道 / YCbCr 色度偏移）\n- `skin_color_lab_b` - 皮肤 Lab b* 通道值（反映黄-蓝偏向）\n- `estimated_bilirubin_mg_dl` - 估算胆红素水平（mg/dL，仅参考）\n- `light_quality_score` - 光照质量评分（low / medium / high，过低时不出具风险）\n- `color_card_calibrated` - 是否进行了色卡白平衡校准\n\n## 风险等级分级\n\n- `low_risk` - 低风险（皮肤/巩膜无明显黄染）\n- `medium_risk` - 中风险（建议门诊经皮胆红素或血清胆红素复测）\n- `high_risk` - 高风险（建议**立即就医复测**，警惕高胆红素血症 / 核黄疸风险）\n- `inconclusive` - 不确定（光照差 / 面部遮挡 / 巩膜不可见等，无法出具结论）\n\n## 默认阈值（可由调用方覆盖）\n\n- 中风险：`skin_yellowness_index ∈ [0.30, 0.55]` 或 `sclera_yellowness_index ∈ [0.20, 0.40]`\n- 高风险：`skin_yellowness_index > 0.55` 或 `sclera_yellowness_index > 0.40`\n- 光照质量阈值：light_quality_score < 0.4 → 强制返回 `inconclusive`\n\n## 输出字段（参考）\n\n- `infant_detected` / `face_visible` / `sclera_visible`\n- `feature_metrics` - 黄染相关特征（sclera_yellowness_index / skin_yellowness_index / skin_color_lab_b / estimated_bilirubin_mg_dl）\n- `light_quality_score` / `color_card_calibrated`\n- `jaundice_risk_level` - 风险等级（low_risk / medium_risk / high_risk / inconclusive）\n- `risk_confidence` - 置信度（0-1）\n- `recommended_action` - 建议动作（home_observe / clinic_recheck / urgent_hospital_visit / recapture_better_light）\n- `alert_message` - 推送给家长的文本（如\"宝宝面部黄染指数 0.62，巩膜可见明显黄色，建议尽快前往新生儿科复测胆红素\"）\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":1135,"uniquenessScore":42,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T19:56:39.117Z","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-09T19:56:39.117Z","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-10T06:26:08.944Z","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"}]}}}