{"id":"cd2d56a8-d073-4fe4-8a9e-bb3f532bdcf5","entityType":"agent","slug":"clawhub-18072937735-smyx-respiratory-symptom-recognition-analys","name":"Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具","canonicalUrl":"https://www.xpersona.co/agent/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys","canonicalPath":"/agent/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys","generatedAt":"2026-10-10T07:09:57.485Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T14:42:48.387Z","emptyReason":null},"description":"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 Skill: Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具 Owner: 18072937735 Summary: Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 Tags: latest:1.0.18 Version history: v1.0","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-respiratory-symptom-recognition-analysis","sourceUrl":"https://clawhub.ai/18072937735/smyx-respiratory-symptom-recognition-analysis","homepage":"https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/18072937735/smyx-respiratory-symptom-recognition-analysis","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":68,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T14:42:48.387Z","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-09T14:42:48.387Z","emptyReason":null},"stars":null,"forks":null,"downloads":2461,"packageName":null,"latestVersion":"1.0.18","tractionLabel":"2.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T14:42:48.387Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T14:42:48.387Z","lastCrawledAt":"2026-10-09T14:42:48.387Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T14:42:48.387Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.18","createdAt":"2026-09-30T11:54:40.759Z","changelog":"- Removed the file skill-card.md from the repository. - No changes to core features, workflow, or interface. - This update only affects documentation by removing an ancillary markdown file.","fileCount":30,"zipByteSize":41593},{"version":"1.0.17","createdAt":"2026-09-25T13:50:15.140Z","changelog":"- Version update from 1.0.17 to 1.0.19. - Documentation updated in SKILL.md, including version and possibly descriptive, instructional, or formatting adjustments. - Internal configuration changes in config.yaml. - skill-card.md file has been removed.","fileCount":30,"zipByteSize":41544},{"version":"1.0.16","createdAt":"2026-09-14T23:37:30.871Z","changelog":"- Version updated from 1.0.15 to 1.0.17. - Documentation updated in SKILL.md; content and formatting may be refined. - Outdated or redundant documentation file skill-card.md was removed. - No functional or script-level code changes indicated.","fileCount":30,"zipByteSize":41772},{"version":"1.0.15","createdAt":"2026-08-26T14:03:30.259Z","changelog":"- Updated version to 1.0.15 in SKILL.md. - Minor documentation/content changes in SKILL.md; version references updated. - Removed the file: skill-card.md.","fileCount":30,"zipByteSize":41724},{"version":"1.0.14","createdAt":"2026-08-20T05:05:29.736Z","changelog":"- Updated internal configuration in config.yaml. - Removed the documentation file \"skill-card.md\". - No functional changes to detection or analysis logic. - Version number remains at 1.0.13 (no update to SKILL.md version field).","fileCount":30,"zipByteSize":41844},{"version":"1.0.13","createdAt":"2026-08-14T07:23:55.256Z","changelog":"- Updated version to 1.0.13 in documentation. - Removed the file `skill-card.md`. - No changes to functionality or workflow. Documentation and resource structure updated.","fileCount":30,"zipByteSize":41669},{"version":"1.0.12","createdAt":"2026-08-08T16:22:30.498Z","changelog":"- Updated SKILL.md content with documentation and version metadata changes. - Removed the skill-card.md file from the package. - No functional or code changes to the skill's logic.","fileCount":30,"zipByteSize":42050},{"version":"1.0.11","createdAt":"2026-07-29T06:43:36.385Z","changelog":"- Updated skill version to 1.0.10 in documentation. - Removed the file: skill-card.md - No functional or behavioral changes to code or features. - Minor documentation version update; all usage and instructions remain unchanged.","fileCount":30,"zipByteSize":41780}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17f8q65zg3y98t86jdg1177g583whq8:smyx-respiratory-symptom-recognition-analysis","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/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-10T07:09:57.480Z"}},"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-respiratory-symptom-recognition-analys/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-18072937735-smyx-respiratory-symptom-recognition-analys/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T14:42:48.387Z","emptyReason":null},"readme":"Skill: Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n\nOwner: 18072937735\n\nSummary: Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\n\nTags: latest:1.0.18\n\nVersion history:\n\nv1.0.18 | 2026-09-30T11:54:40.759Z | auto\n\n- Removed the file skill-card.md from the repository.\n- No changes to core features, workflow, or interface.\n- This update only affects documentation by removing an ancillary markdown file.\n\nv1.0.17 | 2026-09-25T13:50:15.140Z | auto\n\n- Version update from 1.0.17 to 1.0.19.\n- Documentation updated in SKILL.md, including version and possibly descriptive, instructional, or formatting adjustments.\n- Internal configuration changes in config.yaml.\n- skill-card.md file has been removed.\n\nv1.0.16 | 2026-09-14T23:37:30.871Z | auto\n\n- Version updated from 1.0.15 to 1.0.17.\n- Documentation updated in SKILL.md; content and formatting may be refined.\n- Outdated or redundant documentation file skill-card.md was removed.\n- No functional or script-level code changes indicated.\n\nv1.0.15 | 2026-08-26T14:03:30.259Z | auto\n\n- Updated version to 1.0.15 in SKILL.md.\n- Minor documentation/content changes in SKILL.md; version references updated.\n- Removed the file: skill-card.md.\n\nv1.0.14 | 2026-08-20T05:05:29.736Z | auto\n\n- Updated internal configuration in config.yaml.\n- Removed the documentation file \"skill-card.md\".\n- No functional changes to detection or analysis logic.\n- Version number remains at 1.0.13 (no update to SKILL.md version field).\n\nv1.0.13 | 2026-08-14T07:23:55.256Z | auto\n\n- Updated version to 1.0.13 in documentation.\n- Removed the file `skill-card.md`.\n- No changes to functionality or workflow. Documentation and resource structure updated.\n\nv1.0.12 | 2026-08-08T16:22:30.498Z | auto\n\n- Updated SKILL.md content with documentation and version metadata changes.\n- Removed the skill-card.md file from the package.\n- No functional or code changes to the skill's logic.\n\nv1.0.11 | 2026-07-29T06:43:36.385Z | auto\n\n- Updated skill version to 1.0.10 in documentation.\n- Removed the file: skill-card.md\n- No functional or behavioral changes to code or features.\n- Minor documentation version update; all usage and instructions remain unchanged.\n\nv1.0.10 | 2026-07-15T01:04:43.292Z | auto\n\n- Removed the file: skill-card.md\n- No feature or functional changes; only documentation cleanup.\n\nv1.0.9 | 2026-07-11T14:04:33.957Z | auto\n\n- Version update from 1.0.6/1.0.8 to 1.0.9.\n- Documentation updated (SKILL.md) with minor revisions.\n- Internal scripts updated: config.py and util.py changed.\n- Redundant file skill-card.md removed.\n\nv1.0.8 | 2026-06-29T17:09:28.892Z | auto\n\n- Updated documentation for improved clarity and structured module overview in SKILL.md.\n- Enhanced formatting with tables, icons, and clearer workflow steps in the main skill documentation.\n- Reorganized and simplified usage instructions and capability descriptions.\n- Removed outdated or redundant documentation files (skill-card.md).\n\nv1.0.7 | 2026-06-24T08:05:35.335Z | auto\n\n- User open-id is now handled internally and automatically; users are no longer required or prompted to provide any identity parameters.\n- All open-id logic and related prompts have been removed from user-facing documentation and examples.\n- History query and all analysis operations are automatically associated with the current session identity, ensuring a smoother user experience.\n- Documentation and usage instructions have been updated to reflect these changes, focusing on privacy and automation.\n- skill-card.md file has been removed.\n\nv1.0.6 | 2026-06-16T01:14:25.031Z | auto\n\n- Updated skill version to 1.0.6.\n- Adjusted config file lookup logic: now checks skills/smyx_common/scripts/config.yaml as the first priority for api-key/open-id retrieval.\n- Aligned documentation and open-id acquisition instructions to reflect new config path priority.\n- Removed redundant or old documentation file (skill-card.md).\n- Made minor maintenance updates and clarifications in API service, config, and utility scripts for consistency.\n\nv1.0.5 | 2026-06-14T05:09:25.169Z | auto\n\nNo changes detected in this version.\n\n- Version number updated from 1.0.4 to 1.0.5 with no modifications to files or documentation.\n\nv1.0.4 | 2026-06-14T04:52:58.634Z | auto\n\n- Updated skill version to 1.0.4 and added license information (MIT-0) in SKILL.md.\n- Removed obsolete file: skill-card.md.\n- Made minor adjustments to configuration, script, and requirement files to align with the new version.\n- No changes to core functionality or user-facing features.\n\nv1.0.3 | 2026-05-26T16:05:43.227Z | auto\n\n- Refactored skill structure to separate common and analysis modules, improving maintainability.\n- Added new directory: skills/smyx_analysis with dedicated scripts, config, docs, and requirements.\n- Removed face_analysis module and related files.\n- Updated configuration and utility logic to support modular analysis.\n- Adjusted SKILL.md with revised instructions, reduced local storage requirements, and clarified video file size limits (now 10MB).\n- Ensured all historical report queries fetch exclusively from the cloud API, strictly prohibiting use of local memory.\n\nv1.0.2 | 2026-05-14T16:05:04.752Z | auto\n\n### Version 1.0.2 Changelog\n\n- Updated configuration management (`config.py` and related YAMLs) for improved flexibility between development, test, and production environments.\n- Enhanced utility functions in `util.py` to streamline data processing and config access.\n- Refactored and optimized `skill.py` scripts for both common modules and the face analysis component, improving code organization.\n- Various codebase cleanups for maintainability and stability.\n\nv1.0.1 | 2026-05-06T04:16:25.750Z | auto\n\n- Updated internal configuration handling: changes to config files for development, testing, and production environments.\n- Adjusted face_analysis and common utility scripts to improve code maintainability and configuration structure.\n- No user-facing features were added or removed; functionality and usage are unchanged.\n- Documentation and version fields were updated for consistency.\n\nv1.0.0 | 2026-04-17T16:35:12.548Z | auto\n\nInitial release of Respiratory Symptom Recognition Analysis:\n\n- Introduces automatic detection and frequency analysis of coughing, expectoration (phlegm), and wheezing from video using computer vision.\n- Generates structured health reports, trend charts, severity assessments, and anomaly alerts based on real-time video analysis.\n- Enforces strict rules to obtain user open-id before processing; forbids use of any local or long-term memory for history retrieval—history must always be fetched from the cloud API.\n- Supports default and keyword-triggered operation modes for both live video analysis and historical report queries.\n- Outputs historical analysis reports in Markdown tables with direct links for user convenience.\n\nArchive index:\n\nArchive v1.0.18: 30 files, 41593 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2259b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.18:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.19\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.18:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.18\",\n  \"publishedAt\": 1790769280759\n}\n\nFile v1.0.18:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\n\nFile v1.0.18: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.18:scripts/config.yaml\n\n{}\n\nFile v1.0.18:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.18: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.18: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.18: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.18:skill-card.md\n\n## Description:\n\nAnalyzes respiratory videos for coughing, expectoration, and wheezing episodes and provides symptom counts, health alerts, and monitoring 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\nIndividuals, caregivers, and healthcare teams can review respiratory symptom counts, alerts, and historical monitoring reports from videos. Results support health monitoring and do not replace medical diagnosis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive health videos or URLs are sent to a cloud analysis service, and historical reports can be queried.\n\nMitigation: Obtain user consent and confirm the publisher and data retention policy before sending health media or accessing reports.\n\nRisk: The skill may silently create or reuse an identity and persist tokens or profile data in the workspace data directory.\n\nMitigation: Review the account model and restrict access to stored identity and token data before installation.\n\nRisk: Symptom assessments and alerts may be mistaken for a clinical diagnosis.\n\nMitigation: Treat results as monitoring aids, not medical advice; seek professional assessment for concerning symptoms.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis)\n- [Respiratory symptom analysis API documentation](references/api_doc.md)\n- [Skill demonstration](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON]\n\n**Output Format:** [Structured analysis results or Markdown monitoring reports and historical report tables]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include symptom counts, health warnings, suggestions, and report links; not a medical diagnosis.]\n\n## Skill Version(s):\n\n1.0.18 (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.18:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.18:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.17: 30 files, 41544 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2049b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.17:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.19\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.17:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.17\",\n  \"publishedAt\": 1790344215140\n}\n\nFile v1.0.17:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\n\nFile v1.0.17: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.17:scripts/config.yaml\n\n{}\n\nFile v1.0.17:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.17: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.17: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.17: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.17:skill-card.md\n\n## Description:\n\nAnalyzes respiratory videos or images for coughing, phlegm, and wheezing, and provides symptom counts and early health alerts.\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\nPeople and caregivers use the skill to review respiratory symptoms in supplied media and retrieve past monitoring reports for follow-up. Its alerts are for monitoring, not medical diagnosis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Respiratory media and historical report queries are sent to lifeemergence.com services.\n\nMitigation: Avoid submitting real health media until you have reviewed the publisher's privacy, retention, and deletion commitments; use a separate workspace or account for sensitive testing.\n\nRisk: The skill silently creates or reuses a local identity and stores access tokens in a workspace SQLite database.\n\nMitigation: Use an isolated workspace and account, and review the local identity and token handling before deployment.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis)\n- [Respiratory analysis API documentation](artifact/references/api_doc.md)\n- [Skill demonstration](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON]\n\n**Output Format:** [Text or Markdown with structured JSON results]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Symptom counts, health alerts, suggestions, historical report links, and optional saved output.]\n\n## Skill Version(s):\n\n1.0.17 (source: server-resolved ClawHub release; artifact frontmatter lists 1.0.19)\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.17:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.17:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.16: 30 files, 41772 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2596b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.16:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.17\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.16:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.16\",\n  \"publishedAt\": 1789429050871\n}\n\nFile v1.0.16:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\n\nFile v1.0.16: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.16:scripts/config.yaml\n\n{}\n\nFile v1.0.16:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.16: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.16: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.16: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.16:skill-card.md\n\n## Description:\n\nDetects coughing, expectoration, and wheezing in respiratory symptom videos, counts episodes, and produces early health-anomaly alerts and monitoring 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\nExternal users, caregivers, and developers use this skill to submit respiratory monitoring videos or video URLs for symptom-count analysis, health risk warnings, care suggestions, report links, and cloud history report lookup.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive respiratory-health media may be uploaded to cloud APIs.\n\nMitigation: Review data handling, consent, retention, and endpoint authorization before installing or running the skill.\n\nRisk: Security evidence reports weak transport controls and requires HTTPS-only production endpoints.\n\nMitigation: Use only reviewed HTTPS production endpoints and remove or block HTTP or local test endpoints from release artifacts.\n\nRisk: The skill may silently create or reuse an identity and store reusable tokens locally.\n\nMitigation: Make identity scope explicit, protect or remove local token storage, and ensure prior reports are retrieved only for the intended user.\n\nRisk: Respiratory symptom analysis can be mistaken for medical diagnosis.\n\nMitigation: Present results only as health-monitoring support and direct users to professional medical care for diagnosis or urgent symptoms.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis)\n- [Skill demo](https://lifeemergence.com/sample.html)\n- [Respiratory Symptom API Documentation](references/api_doc.md)\n- [SMYX Analysis API Documentation](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, shell commands, guidance]\n\n**Output Format:** [Markdown report or JSON payload with report links; shell command examples for execution.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Processes mp4, avi, and mov inputs up to 10 MB and can query cloud-stored history reports.]\n\n## Skill Version(s):\n\n1.0.16 (source: server release metadata; artifact frontmatter reports 1.0.17)\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.16:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.16:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.15: 30 files, 41724 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2532b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.15:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.15\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.15:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.15\",\n  \"publishedAt\": 1787753010259\n}\n\nFile v1.0.15:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\n\nFile v1.0.15: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.15:scripts/config.yaml\n\n{}\n\nFile v1.0.15:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.15: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.15: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.15: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.15:skill-card.md\n\n## Description:\n\nBased on computer vision, this skill analyzes respiratory videos or URLs to detect coughing, phlegm, and wheezing frequency, count episodes, and produce early health anomaly alerts.\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 and developers use this skill to submit respiratory health videos or video URLs for symptom frequency analysis, structured monitoring reports, health risk warnings, and report history lookup.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Respiratory health videos or URLs may be sent to the configured SMYX/Life Emergence remote service.\n\nMitigation: Use the skill only with explicit consent and appropriate privacy controls, and avoid patient or regulated health data unless those controls are in place.\n\nRisk: The skill may create or reuse persistent local identity records and tokens for report history.\n\nMitigation: Review local identity handling before installation and use report-history features only where persistent identity records are acceptable.\n\nRisk: Analysis results are health-monitoring guidance and are not a medical diagnosis.\n\nMitigation: Treat reports as supplementary monitoring information and direct users to professional medical care for diagnosis, severe symptoms, or clinical decisions.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis)\n- [Skill Demo](https://lifeemergence.com/sample.html)\n- [Respiratory Symptom Recognition API Documentation](references/api_doc.md)\n- [SMYX Analysis API Documentation](skills/smyx_analysis/references/api_doc.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown reports and optional JSON analysis output with shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include respiratory symptom counts, risk level, health warnings, medical suggestions, report links, and report-history tables.]\n\n## Skill Version(s):\n\n1.0.15 (source: frontmatter and server-resolved release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.15:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.15:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.14: 30 files, 41844 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2813b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.14:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.13\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.14:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.14\",\n  \"publishedAt\": 1787202329736\n}\n\nFile v1.0.14:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\n\nFile v1.0.14: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.14:scripts/config.yaml\n\n{}\n\nFile v1.0.14:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.14: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.14: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.14: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.14:skill-card.md\n\n## Description:\n\nBased on computer vision, this skill analyzes respiratory videos or image inputs to detect coughing, phlegm, and wheezing episodes, count symptom frequency, and produce early health-alert 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\nExternal users and developers use this skill to submit respiratory monitoring media or URLs for cloud-backed symptom analysis, history lookup, risk scoring, and health-monitoring reports. Results are for health reference and early anomaly alerts, not professional diagnosis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Respiratory videos, images, or URLs may be sent to LifeEmergence cloud services for analysis.\n\nMitigation: Use only media that the user is authorized to share, and avoid patient or regulated health data unless consent, retention terms, and backend authorization assurances are clear.\n\nRisk: Reports can be linked to an internal identity and history lookup can retrieve cloud-stored reports.\n\nMitigation: Review identity linkage and history access behavior before deployment, and restrict use to environments where report access controls are acceptable.\n\nRisk: Local account or token state may be stored in the workspace.\n\nMitigation: Run in a controlled workspace, review local state handling, and clear stored state when it is no longer needed.\n\nRisk: Health outputs may be mistaken for medical diagnosis.\n\nMitigation: Present results as health reference and early anomaly alerts only, and direct users to professional medical care for diagnosis or urgent symptoms.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis)\n- [Respiratory symptom recognition API documentation](artifact/references/api_doc.md)\n- [SMYX analysis API documentation](artifact/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 reports, JSON responses, and CLI text output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include symptom counts, risk levels, health warnings, medical suggestions, history tables, report links, and optional saved output files.]\n\n## Skill Version(s):\n\n1.0.14 (source: server release metadata; SKILL.md frontmatter remains 1.0.13)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.14:skills/smyx_analysis/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nyaml==6.0.3\n\nFile v1.0.14:skills/smyx_common/requirements.txt\n\npydash==8.0.6\nSQLAlchemy==2.0.46\nPyYAML==6.0.3\n\nArchive v1.0.13: 30 files, 41669 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2355b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.13:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.13\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.13:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.13\",\n  \"publishedAt\": 1786692235256\n}\n\nFile v1.0.13:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\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\nBased on computer vision, this skill analyzes respiratory videos or video URLs to detect coughing, phlegm, and wheezing frequency, count symptom episodes, and return early health-monitoring alerts and report links.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[18072937735](https://clawhub.ai/user/18072937735)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agent operators use this skill to submit respiratory monitoring videos or video URLs for cloud analysis of coughing, sputum, wheezing, and related risk signals. It can also retrieve cloud-hosted historical analysis reports associated with the resolved user identity.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Respiratory videos, video URLs, identity-linked request metadata, and report-history queries are sent to a LifeEmergence cloud service.\n\nMitigation: Evaluate with non-sensitive media first and install only after confirming acceptable privacy, retention, deletion, and account-control terms.\n\nRisk: The skill can silently create or reuse identities, store access tokens locally, and retrieve health report history.\n\nMitigation: Use a dedicated workspace or test identity for evaluation, review local token storage, and avoid using production identities until the behavior is approved.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis)\n- [Publisher Profile](https://clawhub.ai/user/18072937735)\n- [Respiratory Symptom Recognition API Documentation](references/api_doc.md)\n- [Skill Demo](https://lifeemergence.com/sample.html)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Guidance]\n\n**Output Format:** [Markdown text with structured JSON analysis results and report links]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include cloud report history entries and report-image export URLs when listing prior analyses.]\n\n## Skill Version(s):\n\n1.0.13 (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.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: 30 files, 42050 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2978b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.12:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.11\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.12:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.12\",\n  \"publishedAt\": 1786206150498\n}\n\nFile v1.0.12:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\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\nBased on computer vision, this skill analyzes respiratory-health videos to detect and count coughing, phlegm, and wheezing episodes for early anomaly alerts. | 基于计算机视觉分析呼吸道健康视频，检测并统计咳嗽、咳痰、喘息发作频次，用于健康异常早期提醒。\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 and developers use this skill to submit local respiratory-health videos or public video URLs for cloud-based symptom recognition, structured monitoring reports, and report-history lookup. It is intended for health reference and early anomaly awareness, not as a substitute for professional medical diagnosis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends respiratory-health videos or URLs to the Life Emergence cloud service.\n\nMitigation: Use only media that the user is authorized to process and avoid sensitive personal or patient media unless privacy, retention, consent, and account-management terms are acceptable.\n\nRisk: The skill may create or reuse a local identity and store authentication tokens or local state in the workspace.\n\nMitigation: Run the skill in an isolated workspace, restrict access to local state, and clear stored identity or token data after use on shared systems.\n\nRisk: Historical report queries can retrieve prior cloud reports associated with the local identity.\n\nMitigation: Confirm the intended identity context before listing reports and share report links only with authorized recipients.\n\nRisk: Respiratory symptom analysis could be mistaken for a medical diagnosis.\n\nMitigation: Present outputs as health-reference monitoring information and direct users to professional medical care for diagnosis, urgent symptoms, or treatment decisions.\n\n## Reference(s):\n\n- [Respiratory Symptom Recognition API Documentation](references/api_doc.md)\n- [Skill Demo](https://lifeemergence.com/sample.html)\n- [ClawHub Skill Page](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, json, shell commands, guidance]\n\n**Output Format:** [Markdown report text with embedded structured JSON; optional JSON or file output for detailed results and report history.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Analyzes local video files or public video URLs, can list cloud report history, and may include report export links.]\n\n## Skill Version(s):\n\n1.0.12 (source: server release metadata; artifact frontmatter says 1.0.11)\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: 30 files, 41780 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2741b), SKILL.md (10480b), 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 (165b)\n\nFile v1.0.11:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.10\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.11:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.11\",\n  \"publishedAt\": 1785307416385\n}\n\nFile v1.0.11:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\n\nFile v1.0.11:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.11:scripts/config.yaml\n\n{}\n\nFile v1.0.11:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.11:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.11:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.11:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.11:skill-card.md\n\n## Description: <br>\nUses computer vision to detect and count coughing, phlegm, and wheezing in respiratory videos, producing health monitoring reports and early anomaly alerts. <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 users and developers use this skill to submit respiratory symptom videos or URLs for cloud-based analysis, receive structured symptom counts, risk levels, suggestions, and report links, and query prior reports tied to the resolved user identity. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can send health-related videos or URLs to Life Emergence cloud endpoints for processing. <br>\nMitigation: Use only when users understand and accept cloud processing of health media, and avoid submitting sensitive media unless that processing is appropriate for the use case. <br>\nRisk: The skill can automatically create or reuse an identity, link history to that identity, and store authentication tokens in the workspace database. <br>\nMitigation: Run in a controlled workspace, review identity and token persistence before installation, and clear stored credentials or workspace state when the skill is no longer needed. <br>\nRisk: The skill returns health monitoring outputs that may be mistaken for medical diagnosis. <br>\nMitigation: Treat outputs as advisory health-reference information and rely on qualified medical professionals for diagnosis, urgent symptoms, or treatment decisions. <br>\n\n\n## Reference(s): <br>\n- [Respiratory symptom recognition API documentation](references/api_doc.md) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, shell commands, guidance] <br>\n**Output Format:** [Markdown tables and structured JSON-style analysis reports with links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include health warnings, medical suggestions, report links, and historical report tables; results are health-reference outputs, not medical diagnoses.] <br>\n\n## Skill Version(s): <br>\n1.0.11 (source: server release metadata; artifact frontmatter states 1.0.10) <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.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: 30 files, 41653 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2480b), SKILL.md (10479b), 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 (165b)\n\nFile v1.0.10:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.10:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1784077483292\n}\n\nFile v1.0.10:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\n\nFile v1.0.10:skills/smyx_analysis/references/api_doc.md\n\n# API接口文档\n\n## 接口规范\n\n- 基础地址：由 smyx_common 配置统一管理\n- 认证方式：API Key 鉴权\n- 请求格式：支持文件上传\n- 响应格式：JSON\n\n## 错误码说明\n\n| 错误码 | 说明       |\n|-----|----------|\n| 400 | 请求参数错误   |\n| 401 | API密钥无效  |\n| 403 | 权限不足     |\n| 413 | 文件过大     |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误  |\n\nFile v1.0.10:scripts/config.yaml\n\n{}\n\nFile v1.0.10:skills/smyx_analysis/scripts/config.yaml\n\n{}\n\nFile v1.0.10:skills/smyx_common/scripts/config-dev.yaml\n\nApiEnum:\n  base-url-open-api: \"http://192.168.1.234:9601/smyx-open-api\"\n  base-url-open-h5: \"http://192.168.1.234:4100\"\n  base-url-health: \"http://192.168.1.234:7070/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.10:skills/smyx_common/scripts/config-test.yaml\n\nApiEnum:\n  base-url-open-api: \"https://livemonitortest.lifeemergence.com/smyx-open-api\"\n  base-url-open-h5: \"http://livemonitortest.lifeemergence.com\"\n  base-url-health: \"https://healthtest.lifeemergence.com/jeecg-boot-xzgz\"\n\nConstantEnum:\n  is-debug: true\n\nFile v1.0.10:skills/smyx_common/scripts/config.yaml\n\nApiEnum:\n  api-key: null\n  api-secret-key: null\n  base-url-health: https://lifeemergence.com/jeecg-boot-xzgz\n  base-url-open-api: https://open.lifeemergence.com/smyx-open-api\n  base-url-open-h5: http://livemonitor.lifeemergence.com\n  database-url: null\nConstantEnum:\n  app--id: x1a3s4nwy1s2r4se\n  current--tentant-code: XIAN_ZHAO_GAN_ZHI\n  default--skill-platform-name: ARK_CLAW\n  feishu-app--id: cli_a93d769369badcb1\n  feishu-app--secret: null\n  is-debug: false\nenv: prod\n\nFile v1.0.10:skill-card.md\n\n## Description: <br>\nAnalyzes respiratory symptom videos or URLs with a cloud vision API to detect coughing, phlegm, and wheezing frequency, then returns structured health-monitoring results 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 users and health-monitoring agents use this skill to analyze respiratory symptom videos or URLs, retrieve cloud-generated monitoring reports, and view historical report records. Results are for health reference and early anomaly awareness, not medical diagnosis. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Sensitive respiratory or health-related videos or URLs are sent to the publisher's cloud service. <br>\nMitigation: Obtain explicit user confirmation before uploads and avoid patient-identifying media unless the workspace and service terms are appropriate. <br>\nRisk: The skill creates or reuses a local identity and stored API tokens for report history. <br>\nMitigation: Use isolated workspaces for shared environments and review identity and token handling before enabling history queries. <br>\nRisk: Health-monitoring analysis may be misleading if treated as diagnosis. <br>\nMitigation: Present results as reference information only and direct users to medical professionals for diagnosis or urgent respiratory symptoms. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis) <br>\n- [Respiratory symptom recognition API documentation](references/api_doc.md) <br>\n- [Skill demo](https://lifeemergence.com/sample.html) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, shell commands] <br>\n**Output Format:** [Markdown text with structured JSON analysis results and report links] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May save analysis output to a local file when an output path is provided.] <br>\n\n## Skill Version(s): <br>\n1.0.10 (source: ClawHub 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.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: 30 files, 41821 bytes\n\nFiles: references/api_doc.md (3022b), scripts/config.py (688b), scripts/config.yaml (3b), scripts/respiratory_symptom_recognition_analysis.py (9155b), scripts/skill.py (582b), skill-card.md (2840b), SKILL.md (10479b), 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 (164b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.8\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_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.respiratory_symptom_recognition_analysis` 处理输入（**必须在技能根目录下运行脚本**） |\n| 4 | 📊 查看分析结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |\n\n### ⚙️ 脚本参数说明\n\n| 参数 | 含义 | 备注 |\n|---|---|---|\n| `--input` | 本地视频文件路径 | 适用于本地文件分析 |\n| `--url` | 网络视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |\n| `--duration-min` | 监测时长分钟，默认 5 | 按需填写 |\n| `--list` | 显示呼吸道症状识别历史分析报告列表清单（可以输入起始日期参数过滤数据范围） | 用于云端历史报告查询 |\n| `--api-url` | API 服务地址（可选，使用默认值） | 按需填写 |\n| `--detail` | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |\n| `--output` | 结果输出文件路径（可选） | 可选 |\n\n## 🗂️ 资源索引 | Resource Index\n| 资源类型 | 路径 | 用途 | 何时读取 |\n|---|---|---|---|\n| 🐍 必要脚本 | [`scripts/respiratory_symptom_recognition_analysis.py`](scripts/respiratory_symptom_recognition_analysis.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 🐍 必要脚本 | [`scripts/config.py`](scripts/config.py) | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |\n| 📘 领域参考 | [`references/api_doc.md`](references/api_doc.md) | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |\n\n## ⚠️ 注意事项 | Notes\n| 分类 | 注意事项 |\n|---|---|\n| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |\n| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB |\n| 🧑‍⚖️ 结果性质 | 分析结果仅供健康参考和早期异常提醒，不能替代专业医师诊断和医学检查 |\n| 🔎 使用提醒 | 本工具用于辅助监测，确诊请遵医嘱进行相关检查 |\n| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |\n| 🌐 网络地址 | 传入的网路地址参数，不需要下载本地，默认地址都是公网地址，api 服务会自动下载 |\n| 📜 报告输出 | 当显示历史分析报告清单的时候，从接口返回 json 数据中提取字段  作为超链接地址，且自动转化为如下 Markdown |\n| 📜 报告输出 | 表格输出示例 |\n\n## 🧰 使用示例 | Examples\n```bash\n# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json\n```\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1783778673957\n}\n\nFile v1.0.9:references/api_doc.md\n\n# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测\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: prod\n\nFile v1.0.9:skill-card.md\n\n## Description: <br>\nAnalyzes respiratory videos or URLs with cloud computer-vision services to detect coughing, sputum-clearing, and wheezing frequency and return structured monitoring reports. <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 users and care-support workflows use this skill to submit respiratory videos or URLs for early warning-style respiratory symptom monitoring and history lookup. Results are for health reference only and do not replace professional diagnosis or medical testing. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Respiratory videos, URLs, derived analysis data, report-history requests, and identity/account metadata are sent to publisher cloud services. <br>\nMitigation: Use only with data you are permitted to share externally, confirm the provider's privacy and retention terms, and avoid highly sensitive footage unless those terms are acceptable. <br>\nRisk: The skill can create and persist local identity or token state in the workspace data directory. <br>\nMitigation: Review the workspace data directory after use and remove persisted identity or token files when the skill is no longer needed. <br>\nRisk: Outputs are health-monitoring references and may be incomplete or incorrect for clinical decisions. <br>\nMitigation: Treat results as early-warning support only and seek professional medical evaluation for severe, persistent, or concerning symptoms. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Release](https://clawhub.ai/18072937735/skills/smyx-respiratory-symptom-recognition-analysis) <br>\n- [Respiratory Symptom Recognition API Documentation](artifact/references/api_doc.md) <br>\n- [Shared AI Analysis API Documentation](artifact/skills/smyx_analysis/references/api_doc.md) <br>\n- [Skill Demo](https://lifeemergence.com/sample.html) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, json, guidance] <br>\n**Output Format:** [Markdown or JSON text with structured symptom counts, risk indicators, suggestions, report links, and historical report lists.] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Can write analysis output to a local file when requested; analysis and report history depend on the publisher's cloud services.] <br>\n\n## Skill Version(s): <br>\n1.0.9 (source: server release metadata; artifact frontmatter lists 1.0.8) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.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","readmeExcerpt":"Skill: Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具 Owner: 18072937735 Summary: Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 Tags: latest:1.0.18 Version history: v1.0","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python -m scripts.respiratory_symptom_recognition_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json"},{"language":"bash","snippet":"python -m scripts.respiratory_symptom_recognition_analysis --list"},{"language":"text","snippet":"requests>=2.28.0"},{"language":"bash","snippet":"# 分析日常监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/monitor_video.mp4 --monitor-scenario daily-check 分析术后康复监测视频\npython -m scripts.respiratory_symptom_recognition_analysis --input /path/to/recovery_video.mp4 --monitor-scenario post-op 分析网络视频\npython -m scripts.respiratory_symptom_recognition_analysis --url https://example.com/respiratory_video.mp4 --monitor-scenario hospital 显示历史分析报告/显示分析报告清单列表/显示历史监测报告（自动触发关键词：查看历史监测报告、历史报告、监测报告清单等）\npython -m scripts.respiratory_symptom_recognition_analysis --list\n\n# 输出精简报告\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --detail basic\n\n# 保存结果到文件\npython -m scripts.respiratory_symptom_recognition_analysis --input video.mp4 --monitor-scenario daily-check --output result.json"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"respiratory_symptom_recognition_analysis\"\ndescription: \"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病\"\nversion: \"1.0.19\"\nlicense: \"MIT-0\"\n---\n\n# 🫁 Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具\n> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询\n\n---\n\n## 🧭 技能概览 | Overview\n\n| 模块 | 内容 |\n|---|---|\n| 🏷️ 技能名称 | **呼吸道症状智能识别工具** |\n| 🎯 核心目标 | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 |\n| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |\n| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |\n| 🧩 场景码 | `RESPIRATORY_SYMPTOM_RECOGNITION` |\n\nBased on advanced computer vision and behavior recognition algorithms, this feature automatically detects and counts the\nfrequency of respiratory symptoms such as coughing, expectoration, and wheezing. Through real-time video analysis, the\nsystem precisely captures key characteristics including chest movement, body posture, and mouth actions, effectively\ndistinguishing between normal breathing and abnormal symptomatic behaviors. Additionally, the system automatically logs\nthe time, frequency, and duration of symptom episodes to generate dynamic health trend charts. When the frequency of\nsymptoms exceeds normal thresholds, it promptly issues health anomaly alerts, helping users and their families detect\nsigns of respiratory disease early and providing data support for timely medical consultation.\n\n本功能基于先进的计算机视觉与行为识别算法，能够自动检测并统计用户的咳嗽、咳痰及喘息等呼吸道症状的发作频率。系统通过实时视频分析，精准捕捉胸部起伏、身体姿态及口部动作等关键特征，有效区分正常呼吸与异常症状行为。同时，系统会自动记录症状发作的时间、频次及持续时长，生成动态健康趋势图，当检测到症状频次超出正常阈值时，及时发出健康异常提醒，帮助用户及家属早期发现呼吸道疾病迹象，为及时就医提供数据支持\n\n## 🎬 技能演示 | Skill Demo\n\n[▶️ 点击查看技能使用介绍](https://lifeemergence.com/sample.html)\n\n---\n\n## 🎯 任务目标 | Goals\n\n### 1. 🧩 技能用途\n\n通过视频进行呼吸道症状智能识别，自动检测咳嗽、咳痰、喘息等症状，统计发作频率，生成健康监测报告，实现早期异常提醒\n\n### 2. 🛠️ 能力范围\n\n| 序号 | 具体能力 |\n|---:|---|\n| 1 | 视频分析 |\n| 2 | 咳嗽动作识别 |\n| 3 | 咳痰识别 |\n| 4 | 喘息识别 |\n| 5 | 发作频次统计 |\n| 6 | 症状严重程度评估 |\n| 7 | 健康风险预警 |\n| 8 | 就医建议生成 |\n\n### 3. ⚡ 触发条件\n\n| 触发类型 | 触发规则 |\n|---|---|\n| ✅ 默认触发 | **默认触发**：当用户提供视频 URL 或文件需要进行呼吸道症状识别时，默认触发本技能进行分析 |\n| 🔎 明确分析意图 | 当用户明确需要进行呼吸道监测、咳嗽识别、症状统计，提及咳嗽、咳痰、喘息、呼吸道、肺部监测等关键词，并且上传了视频文件或者图片文件 |\n| 📚 历史报告查询 | 当用户提及以下关键词时，**自动触发历史报告查询功能** ：查看历史监测报告、历史症状报告、呼吸道识别报告清单、查询历史报告、查看监测报告列表、显示所有监测报告、显示呼吸道分析报告，查询呼吸道症状识别报告 |\n\n### 4. 🤖 自动行为\n\n| 自动行为 | 执行要求 |\n|---|---|\n| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |\n| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |\n\n#### ⚠️ 强制数据获取规则（次高优先级）\n\n> **橙色强约束：** 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。\n\n必须执行：\n\n```bash\npython -m scripts.respiratory_symptom_recognition_analysis --list\n```\n\n| 类型 | 要求 |\n|---|---|\n| ✅ 必须 | 使用 `python -m scripts.respiratory_symptom_recognition_analysis --list` 调用 API 查询云端的历史报告数据 |\n| 🚫 严格禁止 | 从本地 `memory` 目录读取历史会话信息 |\n| 🚫 严格禁止 | 手动汇总本地记录中的报告 |\n| 🚫 严格禁止 | 从长期记忆中提取报告 |\n| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7e2caqj7pnsvr9r7t8zenghs83xw7n\",\n  \"slug\": \"smyx-respiratory-symptom-recognition-analysis\",\n  \"version\": \"1.0.18\",\n  \"publishedAt\": 1790769280759\n}"},{"path":"references/api_doc.md","content":"# 呼吸道症状智能识别分析 API 文档\n\n## 接口概述\n\n本技能调用云端视觉AI接口，自动识别视频中的咳嗽、咳痰、喘息等呼吸道症状，统计发作频次，评估严重程度，实现健康异常早期提醒。\n\n## 支持识别的呼吸道症状\n\n| 症状类型 | 描述 | 统计方式 |\n|----------|------|----------|\n| 咳嗽 | 胸部收缩+张口咳嗽动作识别 | 按发作次数统计 |\n| 咳痰 | 咳嗽后清痰动作识别 | 按发作次数统计 |\n| 喘息 | 呼吸急促、张口喘息识别 | 按发作次数统计 |\n| 胸闷 | 胸部不适表情识别 | 按持续时间评估 |\n\n## 监测场景\n\n| 场景类型 | 适用场景 |\n|----------|----------|\n| 日常监测 | 居家日常健康监测 |\n| 术后康复 | 手术后呼吸道康复监测 |\n| 病房监测 | 医院病房持续监测 |\n| 其他 | 自定义监测场景 |\n\n## 风险等级划分\n\n| 等级 | 描述 | 建议 |\n|------|------|------|\n| 🟢 正常 | 症状发作频次在正常范围 | 继续日常监测 |\n| 🟡 轻度 | 轻度症状，偶发 | 注意休息，观察变化 |\n| 🟠 中度 | 中度症状，频发 | 建议就医检查 |\n| 🔴 重度 | 重度症状，频繁发作 | 立即就医 |\n\n## API 响应字段说明\n\n### 基础信息\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| id | string | 分析记录ID |\n| data.analysis_time | string | 分析时间 |\n| data.person_detection.status | string | 对象检测状态 |\n| data.person_detection.quality_score | int | 画面质量评分 0-100 |\n\n### 诊断结果\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.diagnosis.risk_score | int | 整体风险评分 0-100 |\n| data.diagnosis.risk_level | string | 风险等级：normal/mild/moderate/severe |\n| data.diagnosis.total_cough_count | int | 咳嗽总次数 |\n| data.diagnosis.total_sputum_count | int | 咳痰总次数 |\n| data.diagnosis.total_wheeze_count | int | 喘息总次数 |\n| data.diagnosis.average_freq_per_minute | float | 平均每分钟发作频次 |\n| data.diagnosis.symptom_counts | object | 各症状详细计数 |\n| data.diagnosis.severity_assessment | object | 各症状严重程度评估 |\n\n### 警示与建议\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| data.health_warnings | array[string] | 健康风险警示信息列表 |\n| data.medical_suggestions | array[string] | 就医护理建议列表 |\n\n## 错误码说明\n\n| 错误码 | 说明 |\n|--------|------|\n| 200 | 请求成功 |\n| 400 | 请求参数错误 |\n| 401 | API 鉴权失败 |\n| 413 | 文件大小超出限制 |\n| 415 | 不支持的文件格式 |\n| 500 | 服务器内部错误 |\n| 503 | 服务繁忙，请稍后重试 |\n| COMMON_AI_ANALYSIS_TIMEOUT | AI分析超时，请稍后重试 |\n\n## 医学提示\n\n1. 本工具仅用于辅助健康监测和早期异常提醒\n2. 不能替代专业医师诊断、胸部X光、CT等医学检查\n3. 分析结果仅供参考，确诊请遵医嘱进行相关检查\n4. 如果出现严重呼吸困难，请立即就医，不要依赖工具监测"},{"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":"Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 Skill: Respiratory Symptom Smart Recognition Tool | 呼吸道症状智能识别工具 Owner: 18072937735 Summary: Based on computer vision, automatically detects coughing, phlegm, and wheezing frequency, counts the frequency of episodes, used for early health anomaly alerts, helping to detect respiratory diseases in a timely manner. | 呼吸道症状智能识别技能，基于计算机视觉自动检测咳嗽、咳痰、喘息频率，统计发作频次，用于健康异常早期提醒，帮助及时发现呼吸道疾病 Tags: latest:1.0.18 Version history: v1.0","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":955,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T14:42:48.387Z","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-09T14:42:48.387Z","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-10T07:09:57.485Z","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"}]}}}