Xpersona
中

中医面诊分析工具

CLAWHUB · Unverified

Supports uploading local MP4 videos or network video URLs to call the server-side API for facial diagnosis. It returns structured TCM facial diagnosis result... Skill: 中医面诊分析工具 Owner: smyx-sunjinhui Summary: Supports uploading local MP4 videos or network video URLs to call the server-side API for facial diagnosis. It returns structured TCM facial diagnosis result... Tags: latest:1.0.3 Version history: v1.0.3 | 2026-05-05T10:27:36.174Z | auto Initial release of the TCM facial diagnosis analysis skill. - Enables facial analysis from uploaded MP4 videos or network video URLs vi

62
Rank
84
Safety
953
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 953 downloads reported by the source. Last updated 10/12/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:new-smyx-new-smyx-face-analysis
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-new-smyx-new-smyx-face-analysis/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

13,828 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: "face-analysis"
description: "Supports uploading local MP4 videos or network video URLs to call the server-side API for facial diagnosis. It returns structured TCM facial diagnosis results. | 支持通过上传本地 MP4 视频或网络视频 URL，调用服务端 API 进行面部诊断，返回结构化的中医面诊结果"
version: "1.0.0"
---

# TCM Facial Diagnosis Analysis Tool | 中医面诊分析工具

This feature supports users in uploading local MP4 video files or providing network video URLs. By leveraging advanced
server-side AI diagnostic APIs, it performs deep analysis and real-time capture of facial features in the video. Based
on the TCM theory of "Inspection," the system precisely analyzes key indicators such as complexion, luster, and texture.
Ultimately, it returns a structured facial diagnosis report containing physical constitution identification and health
status assessment, providing users with a convenient and professional digital health reference.

本功能支持用户上传本地MP4视频文件或提供网络视频URL，通过调用服务端先进的AI智能诊断API，对视频画面中的人物面部特征进行深度解析与实时捕捉。系统将依据中医“望诊”理论，精准分析面色、光泽及纹理等关键信息，最终返回一份包含体质辨识与健康状态评估的结构化中医面诊结果，为用户提供便捷、专业的数字化健康参考

## ⚠️ 强制记忆规则（最高优先级）

**本技能明确约定：**

- **绝对禁止读取任何本地记忆文件**：包括但不限于 `memory/YYYY-MM-DD.md`、`MEMORY.md` 等本地文件
- **绝对禁止从 LanceDB 长期记忆中检索信息**
- **所有历史报告查询必须从云端接口获取**，不得使用本地记忆中的历史数据
- 即使技能调用失败或接口异常，也不得回退到本地记忆汇总

## 任务目标

- 本 Skill 用于：通过面部视频进行中医面诊分析，获取结构化的健康诊断结果和养生建议
- 能力包含：视频分析、面部特征识别、脏腑状况评估、健康风险提示、养生建议生成
- 触发条件:
    1. **默认触发**：当用户提供视频 URL 或文件需要分析，但**未明确提及"风险分析"、"跌倒检测"、"行为识别"时，默认触发本技能**
       进行中医面诊分析
    2. 当用户明确需要进行中医面诊分析时，提及中医面诊、舌诊，以及上传了视频文件或者图片文件
    3. 当用户提及以下关键词时，**自动触发历史报告查询功能**
       ：查看历史面诊报告、历史报告、历史面诊分析清单、面诊清单、面诊报告清单、查询历史报告、查看报告列表、查看报告清单、查看报告表格、查看所有报告、显示所有面诊报告、显示面诊报告
- 自动行为：
    1. 如果用户上传了附件或者图片文件，则自动保存到技能目录下 attachments
    2. **⚠️ 强制数据获取规则（次高优先级）**：如果用户触发任何历史报告查询关键词（如"查看所有面诊报告"、"显示所有面诊报告"、"
       查看历史报告"、"显示面诊报告"、"面诊报告清单"、"显示所有报告"、"查看报告列表"等），**必须**：
        - 直接使用 `python -m scripts.face_analysis --list --open-id` 参数调用 API
          查询云端的历史报告数据
        - **严格禁止**：从本地 memory 目录读取历史会话信息、严格禁止手动汇总本地记录中的报告、严格禁止从长期记忆中提取报告
        - **必须统一**从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果

## 前置准备

- 依赖说明:scripts 脚本所需的依赖包及版本
  ```
  requests>=2.28.0
  ```

## 操作步骤

### 🔒 open-id 获取流程控制（强制执行，防止遗漏）

**在执行面诊分析前，必须按以下优先级顺序获取 open-id：**

```
第 1 步：【最高优先级】检查技能所在目录的配置文件（优先）
        路径：skills/smyx_common/scripts/config.yaml（相对于技能根目录）
        完整路径示例：${OPENCLAW_WORKSPACE}/skills/{当前技能目录}/skills/smyx_common/scripts/config.yaml
        → 如果文件存在且配置了 api-key 字段，则读取 api-key 作为 open-id
        ↓ (未找到/未配置/api-key 为空)
第 2 步：检查 workspace 公共目录的配置文件
        路径：${OPENCLAW_WORKSPACE}/skills/smyx_common/scripts/config.yaml
        → 如果文件存在且配置了 api-key 字段，则读取 api-key 作为 open-id
        ↓ (未找到/未配置)
第 3 步：检查用户是否在消息中明确提供了 open-id
        ↓ (未提供)
第 4 步：❗ 必须暂停执行，明确提示用户提供用户名或手机号作为 open-id
```

**⚠️ 关键约束：**

- **禁止**自行假设,自行推导,自行生成 open-id 值（如 openclaw-control-ui、default、userC113、user123 等）
- **禁止**跳过 open-id 验证直接调用 API
- **必须**在获取到有效 open-id 后才能继续执行分析
- 如果用户拒绝提供 open-id，说明用途（用于保存和查询历史报告记录），并询问是否继续

---

- 标准流程:
    1. **准备视频输入**
        - 提供本地 MP4 视频

README.md

# 中医面诊分析工具 (face-analysis)

## 技能介绍
这是一个基于AI的中医面诊分析技能，可以通过面部视频自动分析健康状况，返回结构化的诊断结果和养生建议。

## 快速开始
### 1. 配置API信息
编辑 `scripts/config.py`，设置你的API地址和密钥：
```python
DEFAULT_API_URL = "https://your-api-server.com/api/v1/face-analysis"
DEFAULT_API_KEY = "your-api-key-here"
```

### 2. 分析本地视频
```bash
python scripts/face_analysis.py --input /path/to/your/video.mp4
```

### 3. 分析网络视频
```bash
python scripts/face_analysis.py --url https://example.com/video.mp4
```

## 功能特性
- ✅ 支持本地MP4视频上传
- ✅ 支持网络视频URL分析
- ✅ 三种输出详细程度：精简/标准/完整
- ✅ 结构化JSON结果输出
- ✅ 自动保存结果到文件
- ✅ 内置视频格式和大小校验

## 目录结构
```
face-analysis/
├── SKILL.md              # 技能说明文件（系统自动加载）
├── README.md             # 本说明文件
├── scripts/
│   ├── face_analysis.py  # 主程序
│   └── config.py         # 配置文件
├── references/
│   ├── api_doc.md        # API接口文档
│   ├── tcm_theory.md     # 中医面诊理论参考
│   └── faq.md            # 常见问题
└── assets/
    └── template.json     # 返回结果模板
```

## 使用示例
### 标准输出
```
📊 中医面诊分析报告
==================================================
⏰ 分析时间: 2026-03-10 15:30:00
🎯 人脸检测: success (置信度: 95分)

🔍 诊断结果:
  整体体质: 平和质
  脏腑状况:
    liver: 正常
    heart: 轻微火旺
    spleen: 略虚
    lung: 正常
    kidney: 正常
  面色分析: 微黄
  对应提示: 脾胃功能略弱

⚠️ 健康警示:
  ⚠️  注意休息，避免熬夜

💡 养生建议:
  💡 饮食清淡，减少辛辣食物摄入
  💡 保持规律作息，每晚11点前入睡
  💡 适当进行有氧运动，如散步、太极拳
==================================================
```

### 输出到JSON文件
```bash
python scripts/face_analysis.py --input video.mp4 --detail full --output result.json
```

## 注意事项
1. 视频要求：清晰正面面部，光线充足，时长5-30秒为宜
2. 支持格式：mp4、avi、mov，最大100MB
3. API需要自行部署或接入第三方服务
4. 结果仅供参考，不能替代专业医生诊断

_meta.json

{
  "ownerId": "kn7cyxkr2ymf7zwsrybpedg8xx83ywrj",
  "slug": "new-smyx-new-smyx-face-analysis",
  "version": "1.0.3",
  "publishedAt": 1777976856174
}

references/api_doc.md

# API接口文档

## 接口地址
`POST https://your-api-server.com/api/v1/face-analysis`

## 请求头
| 字段 | 必选 | 说明 |
|------|------|------|
| X-API-Key | 是 | API访问密钥 |
| Content-Type | 是 | multipart/form-data（文件上传）或 application/json（URL模式） |

## 请求参数
### 1. 文件上传模式
| 字段 | 类型 | 必选 | 说明 |
|------|------|------|------|
| video | file | 是 | MP4视频文件 |
| detail_level | string | 否 | 输出详细程度：basic/standard/full，默认standard |

### 2. URL模式
| 字段 | 类型 | 必选 | 说明 |
|------|------|------|------|
| video_url | string | 是 | 可公开访问的视频URL |
| detail_level | string | 否 | 输出详细程度：basic/standard/full，默认standard |

## 响应格式
```json
{
  "code": 200,
  "message": "success",
  "data": {
    "analysis_time": "2026-03-10 15:30:00",
    "face_detection": {
      "status": "success",
      "face_count": 1,
      "quality_score": 95
    },
    "diagnosis": {
      "overall_constitution": "平和质",
      "organ_condition": {
        "liver": "正常",
        "heart": "轻微火旺",
        "spleen": "略虚",
        "lung": "正常",
        "kidney": "正常"
      },
      "color_analysis": {
        "complexion": "微黄",
        "correspondence": "脾胃功能略弱"
      }
    },
    "health_warnings": [
      "注意休息，避免熬夜"
    ],
    "suggestions": [
      "饮食清淡，减少辛辣食物摄入"
    ]
  }
}
```

## 错误码说明
| 错误码 | 说明 |
|--------|------|
| 400 | 请求参数错误 |
| 401 | API密钥无效 |
| 403 | 权限不足 |
| 413 | 文件过大 |
| 415 | 不支持的文件格式 |
| 500 | 服务器内部错误 |

scripts/config.yaml

{}

Sponsored

Ads related to 中医面诊分析工具 and adjacent AI workflows.