中医经络推理引擎（TCM Meridian Inference Skill）是一个基于规则的中医经络推理工具，以独立 HTTP 服务或 CLI 方式运行，用于根据 6 条经络的左右测量值输出结构化推理结果。
用途 输入 6 条经络（肝 liver、脾 spleen、肾 kidney、胃 stomach、胆 gallbladder、膀胱 bladder）的左右温度测量值（足部采集，浮点数，单位 °C），输出健康评分、经络状态、组合判症、门店讲解文案与调理建议，面向门店讲解、外部系统集成、AI 辅助解读等场景。
主要能力
- 综合健康评分 healthScore（0-100，6 经络均值），以及各经络单独评分 scores。
- 每条经络的状态与详情（meridians）：status（stable / left_low / right_low / cross）、score、symptoms（症状标签）、tags。
- 跨经络组合判症（combinations），包含：转氨酶偏高（肝左低 + 胆左低，标签 transaminase、liver_combo）、颈椎风险提示（肾与膀胱相反侧低，标签 cervical）、腰椎风险提示（肾与膀胱同侧低，标签 lumbar）、心脏供血注意（≥4 条经络右低，标签 heart_supply）、头部供血注意（≥4 条经络左低，标签 head_supply）、颈椎加重提示（肾+膀胱相反低且脾左低，标签 cervical_plus）。
- 输出 summary（机器可读简短摘要）、reportSummary、storefront（门店讲解文案：focusHeadline、clientExplanation、talkTrack、retestPrompt）、advice（调理建议列表）、riskTags（去重风险标签）、trace（完整推理轨迹，调试用）。
- 规则库：thresholds.json（温度阈值与评分参数，如 lowMin=35.3、normalMin=35.6，以及每项扣分分值）、meridian_rules.json（单经络规则，每条经络 3 个状态 × 6 条经络 = 18 条）、combination_rules.json（组合判症规则 6 条）。修改规则后重启 API 即生效，无需改代码。
使用方式 启动 HTTP 服务： cd ~/clawd/skills/tcm-meridian-inference bash scripts/start_api.sh # 默认 18790 bash scripts/start_api.sh 8080 # 指定端口 TCM_API_PORT=9090 bash scripts/start_api.sh # 环境变量
HTTP 接口：
- POST /api/inference/meridian-diagnosis：完整推理（评分+状态+组合判症+门店文案+建议）。
- POST /test：用内置示例数据测试。
- GET /healthz：健康检查。
- GET /：服务信息。
请求体示例： { "subject": {"id": "test-001", "name": "测试用户"}, "measurements": { "liver": {"left": 35.0, "right": 36.1}, "spleen": {"left": 35.1, "right": 35.9}, "kidney": {"left": 35.0, "right": 35.8}, "stomach": {"left": 35.1, "right": 36.0}, "gallbladder": {"left": 35.0, "right": 35.9}, "bladder": {"left": 35.2, "right": 35.9} } } 字段说明：subject 可选；measurements 必填，每条经络需包含 left 与 right（浮点数，单位 °C）；可选 trendDelta 字段（默认 = right - left）。
响应体包含 engine（mode: rule-based-mvp，version: 0.2.0）、subject、healthScore、scores、meridians、sixDimensionScores、riskTags、combinations、summary、reportSummary、advice、storefront（focusHeadline、clientExplanation、talkTrack、retestPrompt）、trace。
CLI 单次推理（无需启动 HTTP 服务）： cd ~/clawd/skills/tcm-meridian-inference python3 scripts/infer.py path/to/case.json --pretty python3 scripts/infer.py path/to/case.json --out result.json
OpenClaw 调用方式：
- 方式A：Agent 通过 exec tool 调用 TCM API（先 curl http://localhost:18790/healthz 确认服务运行，再 POST 调用）。
- 方式B：CLI 命令行触发，例如： openclaw agent --agent main --deliver --message "请帮我推理经络数据: liver左35右36, spleen左35.1右35.9, kidney左35右35.8, stomach左35.1右36, gallbladder左35右35.9, bladder左35.2右35.9"
- 方式C：Cron 定时推理 + 结果推送，例如： { "schedule": "0 9 * * *", "task": "调用 TCM API 推理经络数据并将结果 POST 到外部 URL", "delivery": { "mode": "webhook", "to": "https://your-app.com/api/tcm-callback" } }
- 方式D：反向集成（外部系统调 TCM），外部系统直接调用：
curl -X POST http://<HOST_IP>:18790/api/inference/meridian-diagnosis
-H "Content-Type: application/json"
-d @request.json 适用于门店系统、小程序后端、IoT 设备网关等。
使用示例：
1. 启动 API
cd ~/clawd/skills/tcm-meridian-inference bash scripts/start_api.sh
2. 健康检查
curl http://localhost:18790/healthz
3. 用示例数据测试
curl -X POST http://localhost:18790/test
4. 完整推理
curl -s -X POST http://localhost:18790/api/inference/meridian-diagnosis
-H "Content-Type: application/json"
-d '{"measurements":{"liver":{"left":34.5,"right":34.3},"spleen":{"left":34.8,"right":34.6},"kidney":{"left":33.5,"right":34.2},"stomach":{"left":34.0,"right":34.5},"gallbladder":{"left":34.2,"right":34.0},"bladder":{"left":33.8,"right":34.8}}}' | python3 -m json.tool
5. CLI 单次推理（无需 API）
python3 scripts/infer.py /path/to/case.json --pretty
与 AI 推理集成 流程：用户提交经络数据 → TCM API 规则推理 → 结构化 JSON → Agent AI 解读 → 用户友好报告。规则引擎擅长精确的阈值判断和组合逻辑；AI 擅长自然语言理解和个性化表达，可把结构化结果作为 prompt 的一部分交给 OpenClaw agent 做进一步分析。
适用场景 门店讲解与调理建议输出、外部系统（门店系统、小程序后端、IoT 设备网关）集成、OpenClaw agent 调用、Cron 定时推理与 webhook 推送、AI 辅助自然语言解读。
限制与说明
- 引擎为纯规则推理（rule-based-mvp，version 0.2.0），基于阈值与组合逻辑，不外接依赖。
- Python stdlib-only：零外部依赖，Python 3.6+ 即可运行。
- 输出内容为规则推理结果，不涉及真实医疗诊断结论；准确性、临床适用性、收费与价格等信息暂未提供。
- 原项目路径为 ~/clawd/projects/tcm-meridian-inference-mvp/，资料标注勿直接修改。