tcm-face-tongue
中医面舌辨证。调用 RageHealth 开放接口,对人脸 / 舌头图片做中医辨证。包含「望面」(`face-tcm-analyse`)、「望舌」(`tongue-diagnosis`)、「面舌辨证」(`comprehensive-interpretation`) 三个子接口,输出体质(平和/气虚/阳虚/阴虚/痰湿/湿热/血瘀/气郁/特禀/气阴两虚)、五脏(心肝脾肺肾)阴阳得分、症状、面色/舌象分类、推荐食谱、综合解读等。当用户上传人脸/舌头照片要求"中医辨证"、"看体质"、"望面望舌"、"面诊舌诊"、"五脏分析"时使用此技能。 Skill: tcm-face-tongue Owner: qianchen94 Summary: 中医面舌辨证。调用 RageHealth 开放接口,对人脸 / 舌头图片做中医辨证。包含「望面」(face-tcm-analyse)、「望舌」(tongue-diagnosis)、「面舌辨证」(comprehensive-interpretation) 三个子接口,输出体质(平和/气虚/阳虚/阴虚/痰湿/湿热/血瘀/气郁/特禀/气阴两虚)、五脏(心肝脾肺肾)阴阳得分、症状、面色/舌象分类、推荐食谱、综合解读等。当用户上传人脸/舌头照片要求"中医辨证"、"看体质"、"望面望舌"、"面诊舌诊"、"五脏分析"时使用此技能。 Tags: latest:1.0.6 Version history: v1.0.6 | 2026-07-31T08:58:57.365Z | user - 切换默认接口网关为正式环境 https://gateway
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.6
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.6release · observed Jul 31, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: medium.
clawhub skill install s171yt7cn3hnxnz753rsh9b9yd86b5rb:tcm-face-tongue- Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
- 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: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-qianchen94-tcm-face-tongue/snapshot"
Documentation
CLAWHUB
90,993 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: tcm-face-tongue
description: 中医面舌辨证。调用 RageHealth 开放接口,对人脸 / 舌头图片做中医辨证。包含「望面」(`face-tcm-analyse`)、「望舌」(`tongue-diagnosis`)、「面舌辨证」(`comprehensive-interpretation`) 三个子接口,输出体质(平和/气虚/阳虚/阴虚/痰湿/湿热/血瘀/气郁/特禀/气阴两虚)、五脏(心肝脾肺肾)阴阳得分、症状、面色/舌象分类、推荐食谱、综合解读等。当用户上传人脸/舌头照片要求"中医辨证"、"看体质"、"望面望舌"、"面诊舌诊"、"五脏分析"时使用此技能。
---
# 中医面舌辨证(tcm-face-tongue)
## 何时使用
- 用户上传**正脸照** → 走 `face` 模式(望面,输出体质 + 五脏分析 + 食谱)
- 用户上传**伸舌照** → 走 `tongue` 模式(望舌,输出舌象分类 + 体质 + 症状)
- 用户**同时**给出人脸 + 舌头两张图 → 走 `combined` 模式(面舌辨证,输出主/次体质与综合解读)
如不确定哪种模式,按以下优先级:
1. 如果手上同时有"face + tongue"两图 → **combined**(信息最完整)
2. 只有人脸 → **face**
3. 只有舌头 → **tongue**
## 接口元数据
- **网关**:https://gateway.ragehealth.cn/openapi-prod
- **请求方式**:`POST` + `multipart/form-data`
- **认证头**:`AccessKey`、`Signature`(每次调用前重新生成)
- **三个接口**:
| 模式 | path | 必填参数 |
|:---|:---|:---|
| `face` | `/face/tcm-analyse` | `imageUrl` 或 `imageFile` |
| `tongue` | `/face/tongue` | `imageUrl` 或 `imageFile` |
| `combined` | `/face/comprehensive-interpretation` | `faceImageUrl` + `tongueImageUrl`(**仅接受公网 URL**) |
> **关于 `combined` 的本地图片**:官方接口只接 URL。当任一输入是本地文件时,`call_tcm.py combined` 会自动 **客户端 fallback**:分别调用 `face` + `tongue` 接口并把结果合并为 `{ faceTcm, tongueTcm, comprehensiveInterpretation: null, _clientFallback: true }`。此时缺失服务端的 `comprehensiveInterpretation.summary`,需要由调用方根据 `faceTcm` + `tongueTcm` 自行综合解读。
## 公共可选参数(`face` 与 `combined`)
| 参数 | 说明 |
|:---|:---|
| `customerIp` | 用户真实 IP(用于地域气候推断),优先级低于 `province&city` |
| `province` + `city` | 省 + 市,**必须成对传**;不传则按 IP 自动推断 |
| `fallbackProvince` + `fallbackCity` | 兜底省市,前面所有定位手段都失败时使用 |
| `age` | 整数;不传则算法自动估计 |
| `gender` | `0`=女 / `1`=男;不传则算法自动估计 |
| `skinInfo` | 肤质标签(`OSPW`/油性/干性/中性/混性);不传则算法自动检测 |
| `faceIdDetect` + `userGroup` | 是否开启人脸 ID 检测,开启时 `userGroup` 必填 |
> `tongue` 模式**只接受 `imageUrl` / `imageFile`**,不支持上述地理 / 人口学参数。
## 调用方式
```bash
# 望面(URL 或本地文件二选一)
python scripts/call_tcm.py face \
--image-url https://example.com/face.jpg \
[--province 广东省 --city 深圳市] [--age 30 --gender 0] [--skin-info 油性] \
[--output face.json] [--full-stdout]
# 望舌
python scripts/call_tcm.py tongue \
--image-file C:/path/to/tongue.jpg \
[--output tongue.json]
# 面舌辨证:双 URL 走官方接口;任一为本地文件则自动 client-side fallback
python scripts/call_tcm.py combined \
--face-image-url https://example.com/face.jpg \
--tongue-image-url https://example.com/tongue.jpg \
[--age 30 --gender 0] [--province 广东省 --city 深圳市] \
[--output combined.json]
# 面舌辨证(fallback:本地图)
python scripts/call_tcm.py combined \
--face-image-file C:/path/to/face.jpg \
--tongue-image-file C:/path/to/tongue.jpg \
--output combined.json
```
凭证由脚本自动从环境变量 `TCM_AK` / `TCM_SK` 读取,**不要**作为参数传入。首次使用前需前往 <https://ragehealth.cn/client> 注册申请 AK/SK,写入 `scripts/.env`(可与 skin-pro 共用同一对凭证)。脚本内部会生成 `Signature` 并以 `multipart/form-data` 提交。
## 执行步骤
1. **判定模式**:按上文"何时使用"的优先级选 `face` / `tongue` / `combined`。
2. **校验输入**:图片 jpg/png;伸舌图需正面伸出、光线充足、无明显反光。
3. **调脚本**:拿到 JSON;`success=false` 时提示用户重拍或检查图片质量。
4. **解读关键指标**(按模式取):
- **face**(`data` 直接挂):_meta.json
{
"ownerId": "kn71819j47ea8v4gfqaj24zmh986b313",
"slug": "tcm-face-tongue",
"version": "1.0.6",
"publishedAt": 1785488337365
}references/response_schema.md
# tcm-face-tongue 响应字段详解
接口顶层结构:`{ success: bool, data: { ... } }`。下表仅列出 `data` 内字段。
---
## 一、望面 `/face/tcm-analyse`
### 1. 基础元信息
| 字段 | 类型 | 说明 |
|:---|:---|:---|
| `age` | Int | 调整后年龄(用户传入则用之,否则算法估计) |
| `gender` | Int | `0`=女 / `1`=男 |
| `display_img` | String | 摆正调整后的图片 URL |
| `height` / `width` | Int | 摆正图尺寸 |
| `raw_height` / `raw_width` | Int | 原图尺寸 |
| `landmarks` | Array | 摆正后人脸关键点;`[10]`→庭、`[8]`→阙下/阙中、`[162]`→左太阳穴、`[6]`→鼻柱、`[389]`→右太阳穴、`[5]`→鼻尖、`[50]`→左颊、`[280]`→右颊 |
| `raw_landmarks` | Array | 原图关键点 |
| `face_color_region_show_url` | String | 面色分区效果图 |
| `face_id` | String | 仅 `faceIdDetect=true` 返回 |
| `occlusion.glasses` | Int | 是否戴眼镜,`0`=否 / `1`=是 |
### 2. 五脏与体质 `report_items[]`
数组,每项一个 `type` ∈ `{体质, 心, 肝, 脾, 肺, 肾}`。字段:
| 字段 | 类型 | 说明 |
|:---|:---|:---|
| `type` | String | 类型(体质 / 心 / 肝 / 脾 / 肺 / 肾) |
| `sex` | String | 性别 |
| `age_label` | String | 儿童 / 少年 / 青年 / 中年 / 老年 |
| `regions` | Array | syndrome 对应面部区域,与 `syndromes` 顺序一一对应 |
| `syndromes` | Array | 症状 |
| `diseases` | Array | 可能发生的疾病 |
| `yin_score` / `yang_score` | BigDecimal | 阴 / 阳属性得分 |
| `yin_yang_status` | String | 阴阳总体属性 |
| `face_info` | Array | 面部特征数组:`[0]`痘、`[1]`斑、`[2]`肤质、`[3]`面色 |
| `province` | String | 发起请求对应省份 |
| `fat` | String | 肥胖程度:瘦 / 适中 / 胖 |
| `face_color` | String | 面色 |
| `body_type` | String | 体质 |
| `out_reason` | String | 外因:风 / 寒 / 湿 / 燥 / 暑 / 火 |
| `emotion` | String | 情绪 |
| `analysis` | Array | 解析建议——表现 |
| `suggests` | Array | 解析建议——建议 |
| `disease_analysis` | Array | 可能出现的风险 |
| `disease_suggests` | Array | 风险对应的建议 |
### 3. 食谱 `recipes[]`
| 字段 | 类型 | 说明 |
|:---|:---|:---|
| `type` | String | 匹配类型(体质 / 心 / 肝 / 脾 / 肺 / 肾) |
| `match` | String | 匹配具体子类,如 `"体质气郁质"` |
| `food_name` | String | 食谱名称 |
| `food_image_url` | String | 食谱图片 |
| `effect` | String | 功效 |
| `ingredients` | Array | 材料 |
| `way` | Array | 做法步骤 |
| `notice` | Array | 注意事项 |
---
## 二、望舌 `/face/tongue`
### 1. 综合
| 字段 | 类型 | 说明 |
|:---|:---|:---|
| `score` | BigDecimal | 舌诊评分 0~100,越高越健康 |
| `overview` | String | 整体解析 |
### 2. 体质 `tiZhi`
| 字段 | 类型 | 说明 |
|:---|:---|:---|
| `tizhiType` | String | 平和质 / 气虚质 / 阳虚质 / 阴虚质 / 痰湿质 / 湿热质 / 血瘀质 / 气郁质 / 特禀质 / 气阴两虚质 |
| `tiZhiReason` | String | 中医辨证依据 |
### 3. 症状 `symptomArray[]`
| 字段 | 类型 | 说明 |
|:---|:---|:---|
| `symptom` | String | 症状名称(如 `"肺热咳嗽"`) |
| `symptomReason` | String | 中医分析依据 |
### 4. 舌象分类 `classify[]`
| 字段 | 类型 | 说明 |
|:---|:---|:---|
| `className` | String | 拼音标识 |
| `classNameCn` | String | 中文名(`正常` 时 `resolution=""`) |
| `category` | String | 舌形 / 舌神 / 舌色 / 苔色 / 苔质 |
| `score` | BigDecimal | 模型置信度 0~1 |
| `resolution` | String | 中医解读 |
| `deductionScore` | BigDecimal | 该项对总分的扣分值 |
`className` 枚举(按 `category` 分组):
- **舌形**:`chihen`(齿痕) / `liehen`(裂痕) / `shoushe`(瘦舌) / `pangshe`(胖舌) / `dianci`(点刺) / `nenshe`(嫩舌) / `laoshe`(老舌) / `zhengchang`(正常)
- **舌神**:`rongshe`(荣舌) / `kushe`(枯舌)
- **舌色**:`hongshe`(红舌) / `jiangshe`(绛舌) / `qingzishe`(青紫舌) / `danbaishe`(淡白舌) / `danhongshe`(淡红舌)
- **苔色**:`baitai`(白苔) / `huascripts/requirements.txt
requests>=2.28 pycryptodome>=3.18 python-dotenv>=1.0 # optional: auto-load .env for local dev
skill-card.md
## Description: <br> 中医面舌辨证。调用 RageHealth 开放接口,对人脸 / 舌头图片做中医辨证。包含「望面」(`face-tcm-analyse`)、「望舌」(`tongue-diagnosis`)、「面舌辨证」(`comprehensive-interpretation`) 三个子接口,输出体质(平和/气虚/阳虚/阴虚/痰湿/湿热/血瘀/气郁/特禀/气阴两虚)、五脏(心肝脾肺肾)阴阳得分、症状、面色/舌象分类、推荐食谱、综合解读等。当用户上传人脸/舌头照片要求"中医辨证"、"看体质"、"望面望舌"、"面诊舌诊"、"五脏分析"时使用此技能。 <br> This skill is ready for commercial/non-commercial use. <br> ## Publisher: <br> [qianchen94](https://clawhub.ai/user/qianchen94) <br> ### License/Terms of Use: <br> MIT-0 <br> ## Use Case: <br> External users and developers use this skill to call RageHealth face, tongue, or combined face-and-tongue analysis APIs and turn the returned JSON into concise traditional Chinese medicine body-constitution, organ-balance, tongue-image, recipe, and care guidance. <br> ### Deployment Geography for Use: <br> Global <br> ## Known Risks and Mitigations: <br> Risk: The skill sends face or tongue photos, optional demographic or location details, and RageHealth API credentials to a configured external RageHealth endpoint. <br> Mitigation: Confirm user consent, send only needed inputs, verify the intended base URL before use, and protect TCM_AK and TCM_SK as secrets. <br> Risk: Face ID detection can involve additional face-feature data handling. <br> Mitigation: Enable faceIdDetect only when explicitly needed and authorized, and require a userGroup when it is enabled. <br> Risk: The skill produces traditional Chinese medicine interpretations and recipe suggestions that could be mistaken for clinical advice. <br> Mitigation: Present results as reference-only wellness guidance, advise professional medical care for serious or persistent symptoms, and flag special populations or medication users to follow clinician advice. <br> Risk: Runtime dependencies are specified as minimum versions rather than a reviewed lockfile. <br> Mitigation: Use pinned dependencies or a reviewed lockfile in sensitive environments. <br> ## Reference(s): <br> - [tcm-face-tongue ClawHub Skill Page](https://clawhub.ai/qianchen94/skills/tcm-face-tongue) <br> - [Response Schema](artifact/references/response_schema.md) <br> - [RageHealth Credential Registration](https://ragehealth.cn/client) <br> ## Skill Output: <br> **Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] <br> **Output Format:** [Markdown guidance with shell command examples and JSON API outputs] <br> **Output Parameters:** [1D] <br> **Other Properties Related to Output:** [May write full API responses to JSON files; terminal output removes large landmark and polygon arrays unless full output is requested.] <br> ## Skill Version(s): <br> 1.0.6 (source: server release evidence) <br> ## Ethical Considerations: <br> Users 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>
AionUi
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!
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/qianchen94/skills/tcm-face-tongue",
"sourceUrl": "https://clawhub.ai/qianchen94/skills/tcm-face-tongue",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:09:33.945Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-qianchen94-tcm-face-tongue/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-qianchen94-tcm-face-tongue/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T10:09:33.945Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/qianchen94/tcm-face-tongue",
"sourceUrl": "https://clawhub.ai/qianchen94/tcm-face-tongue",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:09:33.945Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.6",
"href": "https://clawhub.ai/qianchen94/tcm-face-tongue",
"sourceUrl": "https://clawhub.ai/qianchen94/tcm-face-tongue",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-31T08:58:57.365Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-qianchen94-tcm-face-tongue/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-qianchen94-tcm-face-tongue/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.6",
"description": "- 切换默认接口网关为正式环境 https://gateway.ragehealth.cn/openapi-prod - 更新凭证注册网址说明,改为 https://ragehealth.cn/client - 新增 .env.example 文件,提供环境变量模板 - 移除冗余文档 skill-card.md - 其它文档描述小幅修订优化",
"href": "https://clawhub.ai/qianchen94/tcm-face-tongue",
"sourceUrl": "https://clawhub.ai/qianchen94/tcm-face-tongue",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-31T08:58:57.365Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
