取名自《黄帝内经》岐伯与黄帝论医之典，"脉镜"寓意以现代传感器为镜、映射古法脉象。
基于 Apple Watch 生理数据的中医脉诊分析系统，结合中医经典脉学理论，通过特征提取 + 大模型 + Agent Skill 实现智能辨脉。
适合场景：快速查看单次心电图记录的脉象分析
👉 在线体验页面
- ✅ 纯前端，无需安装
- ✅ 隐私安全，数据本地处理
- ✅ 支持多记录选择
⚠️ 功能简化：仅基础脉象识别（11种可测脉象）⚠️ 无 LLM 辅助辨证和深度分析
适合场景：深度分析、趋势追踪、辨证论治、知识库检索
# 安装依赖
cd tcm-pulse-diagnosis
pip install flask pandas neurokit2 scipy numpy
# 启动本地 Web 服务
python web/app.py
# 浏览器打开 http://localhost:5000完整功能：
- ✅ 21 维特征提取（vs Web版基础判断）
- ✅ LLM 辅助辨证论治（Claude API）
- ✅ 知识库 RAG 检索（经典文献 + 教学视频）
- ✅ 体质推断与养生建议
- ✅ 相兼脉分析（如"弦滑脉→肝郁痰湿"）
- ✅ 多次记录趋势分析
- ✅ 溯源推荐（相关教学视频片段）
| 功能 | Web 快速版 | Skill 完整版 |
|---|---|---|
| 基础脉象识别 | ✅ 11种 | ✅ 11种 + 辅助4种 |
| 特征维度 | 基础判断 | 21维完整提取 |
| LLM 辨证 | ❌ | ✅ Claude API |
| 知识库检索 | ❌ | ✅ RAG 检索 |
| 体质推断 | ❌ | ✅ |
| 相兼脉分析 | ❌ | ✅ |
| 趋势追踪 | ❌ | ✅ |
| 养生建议 | ❌ | ✅ |
| 视频溯源 | ❌ | ✅ |
| 部署方式 | 在线访问 | 本地运行 |
| 数据隐私 | 浏览器本地 | 本地 + API调用 |
可穿戴传感器 → 数据导出 → 特征提取 → 脉象分类 → LLM辨证 → 可视化报告
| 脉象 | 一句话释义 | 指下比喻 | 传感器特征 | 置信度 | 主病 |
|---|---|---|---|---|---|
| 迟脉 | 脉来迟缓，一息不足四至 | 老牛拉车 | HR < 60 bpm | 95% | 寒证、阳虚 |
| 数脉 | 脉来急促，一息五至以上 | 急鼓催征 | HR > 90 bpm | 95% | 热证、阴虚 |
| 疾脉 | 脉来极快，一息七八至 | 走马奔腾 | HR > 120 bpm | 90% | 阳极阴竭 |
| 促脉 | 数而一止，止无定数 | 快鼓忽漏拍 | 快心率 + 不规则早搏 | 85% | 阳盛实热、瘀血 |
| 结脉 | 迟而一止，止无定数 | 慢步偶踉跄 | 慢心率 + 不规则停搏 | 85% | 阴盛气结、寒痰 |
| 代脉 | 脉来一止，止有定数 | 钟摆定时缺格 | 等间距规律性漏拍 | 85% | 脏气衰微 |
| 弦脉 | 端直以长，如按琴弦 | 绷紧的吉他弦 | RMSSD<20ms + LF/HF>2.0 | 65% | 肝胆病、痛证 |
| 缓脉 | 一息四至，从容不迫 | 散步悠然 | RMSSD>50ms + HR 60-75 | 60% | 平脉或脾虚 |
| 洪脉 | 脉体宽大，来盛去衰 | 波涛拍岸 | R波振幅 > 1.5mV | 55% | 气分热盛 |
| 细脉 | 脉细如线，应指分明 | 蚕丝一缕 | R波振幅 < 0.5mV | 55% | 气血两虚 |
| 滑脉 | 往来流利，如盘走珠 | 玉珠滚盘 | RR变异系数 < 0.03 | 50% | 痰湿、妊娠 |
| 脉象 | 一句话释义 | 指下比喻 | 可行性 | 主病 |
|---|---|---|---|---|
| 涩脉 | 往来艰涩，如刀刮竹 | 锉刀挫铁 | RR变异系数>0.10（低置信） | 气滞血瘀 |
| 紧脉 | 绷紧有力，如转绳索 | 拧紧的麻绳 | LF/HF>3.0 + 快心率（低置信） | 寒证、痛证 |
| 弱脉 | 沉细无力，按之欲绝 | 棉絮飘空 | R波<0.3mV + HR<65（低置信） | 阳气虚衰 |
| 微脉 | 极细极软，似有似无 | 蛛丝将断 | R波<0.1mV（极低置信） | 气血大虚 |
浮脉、沉脉、伏脉、牢脉、濡脉、革脉、芤脉、散脉、长脉、短脉、动脉、实脉、虚脉
弥补策略（Skill版）：
- 引导自述：用户手动按压手腕回答问题
- LLM综合推理：结合可判定脉象 + 症状描述进行四诊合参
- 硬件扩展：MAX30102 PPG传感器（可扩展覆盖至~20种）
完整教程请访问 在线体验页面 - 数据采集
-
开启房颤功能（首次）
- iPhone 健康 App → 心脏 → 心电图(ECG) → 设置
- Apple Watch 安装"心电图" App
-
录制 ECG
- 静坐 5 分钟
- 打开手表心电图 App
- 手指按住表冠 30 秒
-
导出数据
- iPhone 健康 App → 个人头像 → 导出所有健康数据
- 保存到文件
-
解压提取
- 文件 App 长按
导出.zip→ 解压缩 - 进入
apple_health_export/electrocardiograms/
- 文件 App 长按
-
上传分析
- Web版：访问在线页面上传 CSV
- Skill版：本地 Web 界面上传
| 维度 | 传统手表 | 本系统 |
|---|---|---|
| 频率 | 心率BPM（1维） | 均值心率 + 最大/最小 + 区间分布（3维） |
| 节律 | 无 | RR变异系数 + 早搏计数 + 停搏计数 + 规律检测（4维） |
| 振幅 | 无 | R波均值 + 标准差 + 变异系数（3维） |
| 张力 | "压力指数"（1维） | SDNN + RMSSD + pNN50 + LF/HF（4维） |
| 流畅度 | 无 | Poincaré SD1 + RR粗糙度（2维） |
| 波形 | 无 | QRS宽度 + 信号质量（2维） |
| 合计 | 2维 | 21维 |
传统手表: 心率 + 压力指数 → "你今天压力有点大"
本系统: 18维特征 × 11种脉象 × 证候推理 → "弦数脉，肝火上炎，建议疏肝清热"
tcm-pulse-web/
├── index.html # Web 快速版（纯前端）
├── src/ # Skill 核心代码
│ ├── data_ingestion/ # HealthKit XML/ECG CSV 解析
│ ├── feature_extraction/ # 18维特征提取
│ ├── classification/ # 脉象分类器
│ ├── knowledge_base/ # 知识库管理
│ └── llm_pipeline/ # Claude API 辨证链
├── knowledge-base/ # 知识库数据
│ ├── structured/ # 28脉结构化JSON
│ ├── classical_texts/ # 经典文献
│ └── embeddings/ # FAISS向量索引
├── web/ # Skill 本地Web界面
├── config/ # 配置文件
├── scripts/ # 工具脚本
└── tests/ # 测试用例
- Python 3.8+
- Node.js 16+ (可选，用于前端开发)
# 1. 克隆项目
git clone https://github.com/SPA3K/tcm-pulse-web.git
cd tcm-pulse-web
# 2. 安装 Python 依赖
pip install flask pandas neurokit2 scipy numpy
# 3. 配置 Claude API（可选，用于 LLM 辨证）
export ANTHROPIC_API_KEY="your-api-key"
# 4. 启动服务
python web/app.py
# 5. 浏览器访问
open http://localhost:5000# 从教学视频提取知识
python scripts/video_ingestion.py --url "bilibili-url"
# 重建向量索引
python scripts/rebuild_embeddings.py在线体验页面展示了基础的脉象分析功能，以下是实际使用截图：
点击查看 Web 版界面截图
完整分析界面
左侧展示了"缓脉"诊断结果，包含体质类型、身体表现和调养建议；右侧展示五维雷达图和关键指标：
💡 提示：Web 快速版提供基础的 11 种脉象识别和可视化，适合快速查看单次记录。完整的 18 维特征分析、LLM 辨证和知识库检索需要使用 Skill 完整版。
测试数据：2026-05-09 录制的心电图（30秒，512Hz采样）
用户主诉：
- 最近工作压力大，总感觉胸闷喘不上气
- 每天饮用一杯咖啡
- 每天工作时间 13 小时电脑工作
- 有保证一周三次以上的有氧运动
分析过程：
$ python3 analyze_ecg.py
📊 正在解析 ECG 数据...
✅ 数据加载完成: 15360 个采样点
🔬 正在提取 18 维特征...
✅ 特征提取完成 (频率、节律、振幅、张力、流畅度 5 大维度, 21维特征)
🏥 正在进行脉象分类...
✅ 识别到主脉 1 种、兼脉 1 种
🤖 正在进行 LLM 辨证分析...
✅ 结合症状进行四诊合参诊断报告：
点击查看完整报告
============================================================
岐黄脉镜 - 中医脉诊分析报告
============================================================
【基本信息】
姓名: ***
记录时间: 2026-05-09 09:24:39 +0800
Apple 分类: 窦性心律
主诉症状: 工作压力大、胸闷气短、长时间电脑工作
【脉象诊断】
┌─ 主脉 ─────────────────────────────────────┐
│ 【结脉】- 迟而一止，止无定数 │
│ │
│ 脉象特征： │
│ • 心律不齐，检测到 4 次早搏 │
│ • RR 间期变异性增高 │
│ • 节律紊乱，无规律性停顿 │
│ │
│ 传统释义："缓时一止复来" │
│ 指下感受：如慢步偶踉跄，行走不稳 │
└─────────────────────────────────────────┘
┌─ 兼脉 ─────────────────────────────────────┐
│ 【洪脉】- 脉体宽大，来盛去衰 │
│ │
│ 脉象特征： │
│ • R 波振幅显著偏高 │
│ • 脉势洪大有力 │
│ • 搏动有力但略显浮躁 │
│ │
│ 传统释义："如波涛汹涌，拍岸而来" │
│ 指下感受：如按鼓皮，有弹指之力 │
└─────────────────────────────────────────┘
【四诊合参 - 辨证分析】
证型：肝郁气滞 + 心神不宁 + 阴虚火旺
┌─ 病机分析 ───────────────────────────────┐
│ │
│ 1. 肝郁气滞（情志因素） │
│ • 长期工作压力 → 肝气郁结 │
│ • 久坐伏案 → 气机不畅 │
│ • 结脉主因：气滞血瘀，脉道受阻 │
│ │
│ 2. 心神不宁（脏腑失调） │
│ • 胸闷气短 → 心气不足，心神失养 │
│ • 咖啡因摄入 → 扰动心神，加重心悸 │
│ • 洪脉主因：心火内盛，虚火上炎 │
│ │
│ 3. 阴虚火旺（耗损过度） │
│ • 工作 13 小时 → 阴液暗耗 │
│ • 用眼过度 → 肝肾阴虚 │
│ • 运动虽多但阴液补充不足 │
│ │
│ 病机总结： │
│ 肝郁化火 → 心肝火旺 → 灼伤阴液 → 阴虚内热 │
│ 气滞血瘀 → 脉道不畅 → 心悸胸闷 → 结脉现象 │
└─────────────────────────────────────────┘
【调理方案】
═══════════════════════════════════════════════
一、饮食调理（重点：滋阴降火、疏肝理气）
═══════════════════════════════════════════════
【宜食】
┌─ 滋阴清热类 ─────────────────────────────┐
│ • 百合：养心安神，清心除烦（每日 20g 煮粥） │
│ • 莲子：补脾益肾，养心安神（每日 15g） │
│ • 银耳：滋阴润肺，生津止渴（隔日炖汤） │
│ • 麦冬：养阴润肺，清心除烦（10g 泡水代茶） │
│ • 玉竹：养阴润燥，生津止渴 │
└─────────────────────────────────────┘
┌─ 疏肝理气类 ─────────────────────────────┐
│ • 玫瑰花：疏肝解郁（3-5 朵泡茶，替代咖啡） │
│ • 陈皮：理气健脾（5g 煮水） │
│ • 佛手：疏肝理气，和胃止痛 │
│ • 香橼：疏肝理气，宽胸化痰 │
└─────────────────────────────────────┘
┌─ 养心安神类 ─────────────────────────────┐
│ • 酸枣仁：养心安神（每晚 10g 煮水或研粉冲服） │
│ • 茯苓：健脾安神，利水渗湿 │
│ • 远志：安神益智，祛痰开窍 │
│ • 龙眼肉：补益心脾，养血安神（每日 5-8 颗） │
└─────────────────────────────────────┘
┌─ 日常食疗方 ─────────────────────────────┐
│ │
│ 【疏肝养心茶】（工作时饮用，替代咖啡） │
│ 玫瑰花 3 朵 + 麦冬 10g + 菊花 3 朵 │
│ 功效：疏肝解郁，滋阴清热，明目护眼 │
│ 用法：沸水冲泡，可续水 2-3 次 │
│ │
│ 【安神助眠粥】（晚餐食用） │
│ 百合 20g + 莲子 15g + 大米 100g │
│ 功效：养心安神，健脾和胃 │
│ 用法：煮粥食用，晚餐 1 碗 │
│ │
│ 【滋阴润肺汤】（隔日炖服） │
│ 银耳 1 朵 + 雪梨 1 个 + 百合 15g + 枸杞适量 │
│ 功效：滋阴润肺，清热降火 │
│ 用法：炖汤，下午或睡前服用 │
└─────────────────────────────────────┘
【忌食】
⚠️ 辛辣刺激：辣椒、花椒、生姜、大蒜（加重肝火）
⚠️ 煎炸烧烤：油炸食品、烧烤（助火伤阴）
⚠️ 温热壮阳：羊肉、狗肉、鹿茸（加重阴虚）
⚠️ 咖啡浓茶：咖啡、浓茶、能量饮料（扰动心神）
→ 建议：逐步减量，用玫瑰花茶、麦冬茶替代
⚠️ 烟酒：严格戒除（最伤肝肾阴液）
═══════════════════════════════════════════════
二、起居调摄（重点：调畅气机、养护心神）
═══════════════════════════════════════════════
【工作建议】
┌─ 时间管理 ───────────────────────────────┐
│ • 每工作 50 分钟 → 休息 10 分钟 │
│ （站起来活动、眺望远方、深呼吸） │
│ │
│ • 午休 15-30 分钟（闭目养神即可） │
│ 时间：13:00-13:30 │
│ 作用：养心安神，恢复精力 │
│ │
│ • 工作时长控制：建议逐步调整至 10 小时以内 │
│ 过劳耗伤阴液，得不偿失 │
└─────────────────────────────────────┘
┌─ 办公姿势 ───────────────────────────────┐
│ • 每 2 小时做"八段锦"之"两手托天理三焦" │
│ 作用：疏通气机，缓解胸闷 │
│ │
│ • 颈椎保健：经常转动头颈，避免固定一个姿势 │
│ │
│ • 深呼吸练习：吸气鼓腹，呼气收腹（3-5 次/小时） │
│ 作用：调畅气机，缓解胸闷气短 │
└─────────────────────────────────────┘
【运动调整】
✓ 现有运动很好（有氧运动每周 3 次以上）
建议优化：
┌─ 运动时间 ───────────────────────────────┐
│ • 最佳时间：傍晚 17:00-19:00 │
│ （此时肾经当令，补益阴液效果最佳） │
│ │
│ • 避免：早晨空腹剧烈运动（耗气伤阴） │
│ • 避免：临睡前 2 小时剧烈运动（扰动心神） │
└─────────────────────────────────────┘
┌─ 运动方式 ───────────────────────────────┐
│ 【继续保持】 │
│ • 慢跑、游泳、骑行等有氧运动 │
│ │
│ 【建议增加】柔和的调息运动 │
│ • 太极拳（疏肝理气，调和阴阳） │
│ • 八段锦（调理五脏，通畅气血） │
│ • 瑜伽（舒展筋骨，安神静心） │
│ │
│ 运动强度：以微微出汗、不喘为宜 │
│ （大汗淋漓反而耗伤阴液） │
└─────────────────────────────────────┘
【睡眠调理】
┌─ 作息时间 ───────────────────────────────┐
│ • 入睡时间：23:00 之前（子时前入睡养阴） │
│ • 起床时间：7:00 左右 │
│ • 午休：13:00-13:30（15-30 分钟） │
│ │
│ ⚠️ 重点：23:00-1:00 是胆肝经修复时间 │
│ 熬夜最伤肝胆，加重气滞 │
└─────────────────────────────────────┘
┌─ 助眠方法 ───────────────────────────────┐
│ • 睡前 1 小时：停止电脑工作，远离电子屏幕 │
│ │
│ • 睡前温水泡脚（15-20 分钟） │
│ 可加：艾叶 10g、生姜 3 片 │
│ 作用：引火下行，宁心安神 │
│ │
│ • 睡前按摩穴位： │
│ - 内关穴（手腕内侧）：宁心安神 │
│ - 神门穴（手腕尺侧）：养心安神 │
│ - 三阴交（小腿内侧）：滋阴降火 │
│ 每穴按揉 3 分钟，以酸胀为度 │
└─────────────────────────────────────┘
【情志调摄】
┌─ 疏肝解郁方法 ───────────────────────────┐
│ │
│ 1. 倾诉宣泄 │
│ • 找信任的朋友或家人聊天 │
│ • 书写日记，记录情绪 │
│ • 不要将压力憋在心里 │
│ │
│ 2. 音乐疗法 │
│ • 工作时：听舒缓的轻音乐 │
│ • 推荐：古琴、古筝、自然声音 │
│ • 避免：激烈的摇滚、说唱 │
│ │
│ 3. 呼吸冥想 │
│ • 每日 10 分钟正念冥想 │
│ • 专注呼吸，觉察身体 │
│ • 缓解焦虑，平复心神 │
│ │
│ 4. 户外活动 │
│ • 周末去公园、山林（接触自然） │
│ • 绿色养肝，开阔心胸 │
└─────────────────────────────────────┘
═══════════════════════════════════════════════
三、中药调理（建议咨询中医师后使用）
═══════════════════════════════════════════════
【推荐成方】
┌─ 逍遥散加减 ─────────────────────────────┐
│ 主治：肝郁气滞，心神不宁 │
│ │
│ 组成： │
│ 柴胡 10g、当归 10g、白芍 12g、白术 10g │
│ 茯苓 15g、薄荷 6g、生姜 3 片、炙甘草 6g │
│ 加：酸枣仁 15g、百合 15g、麦冬 10g │
│ │
│ 功效：疏肝解郁，健脾安神，滋阴清热 │
│ 用法：水煎服，每日 1 剂，分早晚 2 次服用 │
│ 疗程：2-4 周为一疗程 │
└─────────────────────────────────────┘
【中成药选择】
• 逍遥丸：疏肝健脾，适合肝郁气滞
• 天王补心丹：养心安神，适合心神不宁
• 杞菊地黄丸：滋肾养肝，适合肝肾阴虚
⚠️ 注意：请在中医师指导下选择使用，切勿自行配伍
═══════════════════════════════════════════════
四、预后评估
═══════════════════════════════════════════════
【短期目标】（2-4 周）
✓ 胸闷气短症状明显改善
✓ 睡眠质量提升
✓ 咖啡依赖逐步减少
【中期目标】（1-3 个月）
✓ 结脉现象减少或消失
✓ 心悸症状明显好转
✓ 工作效率提升，疲劳感减轻
【长期目标】（3-6 个月）
✓ 体质改善，阴阳平衡
✓ 工作与生活平衡
✓ 建立健康的生活方式
【复诊建议】
• 初次调理后 2 周复诊，评估效果
• 之后每月复诊 1 次
• 如症状加重，随时就诊
============================================================
⚠️ 重要提示
============================================================
1. 本诊断基于脉象分析和症状描述，属于中医辨证参考
2. 不能替代专业中医师面诊，建议到正规中医医院就诊
3. 中药调理需在中医师指导下进行，切勿自行用药
4. 如出现胸痛、心悸加重等急性症状，请立即就医
============================================================
核心诊断：
- 证型：肝郁气滞 + 心神不宁 + 阴虚火旺
- 主脉：结脉（气滞血瘀，脉道受阻）
- 兼脉：洪脉（心火内盛，虚火上炎）
病机分析：
长期工作压力 → 肝气郁结 → 气滞血瘀 → 结脉现象
久坐用眼 + 咖啡因刺激 → 阴液暗耗 → 心肝火旺 → 洪脉表现
胸闷气短 → 气机不畅，心气不足
调理重点：
- 饮食：滋阴降火（百合、麦冬、银耳）+ 疏肝理气（玫瑰花、陈皮）
- 起居：工作 50 分钟休息 10 分钟，23:00 前入睡，睡前泡脚按摩
- 运动：继续有氧运动 + 增加太极、八段锦等柔和运动
- 情志：音乐疗法、呼吸冥想、户外活动疏解压力
- 禁忌：戒咖啡（改用玫瑰花茶）、避免辛辣煎炸、严格戒烟酒
预后：2-4 周症状改善，1-3 个月结脉现象减少，3-6 个月体质明显改善
| 诊法 | Skill | 数据来源 | 状态 |
|---|---|---|---|
| 切诊（脉诊） | 岐黄脉镜 |
手表心率/HRV/ECG + 脉诊知识库 | ✅ 已实现 |
| 望诊 | 望神观色 |
摄像头面色/舌象分析 | 📋 规划中 |
| 闻诊 | 闻声辨气 |
麦克风语音/咳嗽/呼吸音 | 📋 规划中 |
| 问诊 | 问症知源 |
结构化问诊对话 + 症状图谱 | 📋 规划中 |
| 四诊合参 | 四诊合参 |
综合四诊 → 辨证论治 | 📋 规划中 |
本项目的脉象分类算法和特征提取方法参考了以下学术文献：
-
Zhang J, et al. "AI: Bridging Ancient Wisdom and Modern Innovation in Traditional Chinese Medicine." JMIR Medical Informatics, 2024. DOI: 10.2196/58491
- 中医AI全景综述，涵盖舌诊、脉诊、问诊各方向
-
Li X, et al. "Wearable multichannel-active pressurized pulse sensing platform." Microsystems & Nanoengineering (Nature子刊), 2024. DOI: 10.1038/s41378-024-00703-7
- 三通道脉搏监测+机器学习，可穿戴脉诊标杆论文
-
Liu H, et al. "Classification research of TCM pulse conditions based on multi-label voice analysis." Journal of Traditional Chinese Medical Sciences, 2024. DOI: 10.1016/j.jtcms.2024.03.008
- 多标签脉象分类方法（本项目分类算法参考）
-
Zhu H, et al. "A Novel Microfluidic Pressure Sensor for Traditional Chinese Medicine Pulse Data Collection and Analysis." SCITEPRESS, 2023. DOI: 10.5220/0011679000003443
- 微流控脉搏传感器+AI分析
-
Frontiers Review "Artificial Intelligence for Traditional Chinese Medicine Pulse Diagnosis: A Review." Frontiers in Bioengineering and Biotechnology, 2022. DOI: 10.3389/fbioe.2022.1010358
- 信号处理管线、特征提取方法、ML/DL分类方法综述
- SPA3K - 项目创建者与维护者
- Claude Sonnet 4.5 - AI 协作开发者
- 论文作者团队 - 感谢 Zhang J, Li X, Liu H, Zhu H 等学者的研究为本项目提供的理论基础
- Apple - 提供 Apple Watch ECG 传感器数据
- 开源社区 - NeuroKit2、Chart.js、Tailwind CSS 等优秀工具
感谢所有为本项目做出贡献的开发者和研究者！
MIT License
本系统仅供学习研究使用，不能替代专业医疗诊断。任何健康问题请咨询专业中医师或医疗机构。
Made with ❤️ by SPA3K