前言¶
体检报告、指标截图和日常运动记录往往散落在聊天窗口和本地文件里。每次想对照参考范围、改运动计划或补打卡，都要自己翻文档、手算步数，Agent 也很难稳定复用同一套流程。
下面介绍 SkillHub 社区 Skill ai健康助理（坐标 @user_7f864702/healthai）。它把体检多模态采集、指标对比、运动方案与打卡提醒写进通用 SKILL.md 工作流，并附带 Python 脚本，适合在 Cursor、Claude Code 等支持 Skills 的客户端里长期挂载。
这是什么¶
ai健康助理 是面向个人健康管理的 Agent Skill，当前在 SkillHub 上的版本为 1.0.4，分类 life-service，来源 community，发布者为 user_7f864702（SkillHub 页面展示作者为「麦哥的传说」）。Skill 包内元数据标注作者为 AutoClaw，支持飞书、Telegram、Discord 等渠道触发。
SkillHub 标签标明 requires_api_key=false，即安装本 Skill 本身不强制配置第三方 API Key；若使用腾讯文档在线同步等能力，需按包内说明单独配置 Token（见下文）。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_7f864702/healthai
- API 坐标页：https://api.skillhub.cn/user_7f864702/healthai
截至资料抓取时，SkillHub 显示评分 100000、下载 1053 次。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md、README.md 与脚本目录，可按需裁剪使用。
自然语言触发与健康对话¶
Skill 声明支持自然语言理解：用户提到体检、指标、脂肪肝、血压、运动计划、打卡等关键词，或由 AI 识别上下文后，即可进入健康管理流程。常见触发包括「激活健康打卡」「分析体检报告」「今天的运动」「运动打卡」等；也可直接发送 PDF、Word、图片，由多模态流程处理。
体检与指标处理¶
- 支持文字、PDF（含扫描件 OCR）、
.docx、图片等输入。 - 自动提取身高、体重、ALT、AST、GGT、血脂、血糖、血压等指标，并对姓名、身份证号、手机号等字段脱敏。
- 依据
config/reference_ranges.json与参考文档做异常识别（如肝酶偏高、血脂/血糖/血压异常等），并给出与指标匹配的运动建议（如八段锦、快走、肩颈拉伸等）。 - 对比多次体检数据，标注变化趋势，显著变化时可更新运动计划。
运动计划、视频与提醒¶
根据异常指标生成运动方案，并匹配 B 站教学视频（包内 videos/video_library.json 与 scripts/video_matcher.py）。定时提醒支持 OpenClaw Heartbeat（默认约每 2 小时检查，在 09:00 等时段推送运动计划）或手动配置 cron 调用 scripts/daily_health_reminder.sh；SKILL.md 中 18:00 打卡提醒、22:00 睡觉提醒在 v2.0 待办里仍标记为待完善，实际 Heartbeat 说明里写了 18:00 与 21:30 睡觉提醒，部署时需以你环境中的调度实现为准。
打卡、复盘与文档¶
- 打卡数据按用户 ID 落在
data/checkins/{user_id}/等路径（本地 JSON）。 - 支持周报/月报思路，并可写入飞书文档（
scripts/feishu_doc_writer.py等）；DEPENDENCIES.md列出对feishu-doc、feishu-im-read等配套 Skill 的依赖，飞书侧需开通相应应用权限。 README.md另提供饮食方案、健康管理方案模板、腾讯文档在线表（需TENCENT_DOCS_TOKEN）、Excel 跟踪表生成与卡路里计算脚本。
命令行辅助¶
在 Skill 目录下可调用例如：
python scripts/calorie_calc.py --steps 10698 --weight 70.9 --age 34
python scripts/create_online_doc.py --title "我的健康跟踪表"
python scripts/update_record.py --file-id 文档ID --steps 10698 --weight 70.9
python templates/health_tracking_generator.py --output 健康管理.xlsx --diet 蛋奶素
一键激活脚本（获取用户 ID、配置 cron、测试发送）：
python3 scripts/activate_health_skill.py
安装与启用¶
1. 通过 SkillHub CLI 安装到当前 Agent¶
先确认已安装 skillhub CLI（安装方式见 https://skillhub.cn/install/skillhub.md）。必须用 --dir 指向当前客户端的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install healthai --namespace user_7f864702 --dir ~/.cursor/skills/
其他常见路径（同一命令，仅改 --dir）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
也可将下面提示词交给 AI，让其按官方安装文档拉取 @user_7f864702/healthai：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_7f864702/healthai`。
2. 安装 Python 与系统依赖¶
进入安装后的 Skill 目录（示例路径随 --dir 变化）：
cd ~/.cursor/skills/@user_7f864702/healthai
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
图片 OCR 与 PDF 处理需要系统级组件（可选但建议）：
# Linux
sudo apt-get install tesseract-ocr poppler-utils
INSTALL.md 要求 Python 3.8+。
3. 可选：腾讯文档与飞书¶
- 腾讯文档：在 https://docs.qq.com/open/auth/mcp.html 获取授权后设置
export TENCENT_DOCS_TOKEN="你的Token值"（见README.md）。 - 飞书：按
DEPENDENCIES.md创建应用并开通im:message:send_as_user、docs:write、docs:read等权限；完整 OCR、浏览器搜视频等还依赖包内列出的其他 OpenClaw Skills，仅在 OpenClaw 生态下需要一并安装。
典型用法¶
对话式（推荐）¶
在已加载 Skill 的 Agent 中直接描述需求，例如 README.md 中的示例：
帮我制定健康管理方案
- 年龄34岁，男性
- 身高175cm，体重71kg
- 饮食习惯：蛋奶素
- 运动时间：中午
- 体检异常：ALT 50.65偏高
记录今天步数：10698步
创建腾讯文档健康跟踪表
首次使用可发送「激活健康打卡」，由 AI 绑定用户 ID 并配置定时提醒（见 SKILL.md 流程说明）。
上传体检材料¶
发送 PDF/图片或文字描述「帮我分析体检报告」，Skill 指引走 OCR/解析、脱敏、异常检测与运动方案更新。
本地数据位置¶
用户数据默认写在 Skill 目录下，例如：
data/users/{user_id}/health_data.json
data/users/{user_id}/health_records.json
data/checkins/{user_id}/YYYY-MM.json
包内说明强调数据本地存储、不上传云端；实际部署仍须自行做好目录权限与备份。
适用场景与注意¶
适合谁
- 希望在 IM 或 IDE 里用同一套话术管理体检、运动和打卡的个人用户。
- 已在用 OpenClaw / 飞书机器人，需要 Heartbeat 或 cron 推送日计划的用户。
- 需要脚本化卡路里、Excel 或腾讯文档跟踪表的轻度数据记录场景。
限制与风险
- 非医疗诊断：
README.md明确方案仅供参考，严重健康问题应遵医嘱。 - 环境差异：OCR 准确率、视频链接有效性、定时任务是否触发，依赖本机依赖、配套 Skills 与调度配置；
SKILL.md自述当前为 v1.0 测试版，部分提醒功能在路线图里仍待优化。 - 可选能力需额外配置：腾讯文档、飞书、浏览器搜视频等不是「零配置」；
DEPENDENCIES.md中的 OpenClaw 镜像与配套 Skill 仅在对应平台需要。 - 隐私：虽有脱敏逻辑，上传体检材料前仍应确认 Agent 与存储路径符合你的合规要求。
结尾¶
ai健康助理 把体检解读、指标对比、运动计划、打卡与文档输出收敛到一套 Skill 与脚本里，适合作为 life-service 类个人健康助手挂载到 Agent。安装时记住 SkillHub 坐标 @user_7f864702/healthai、用 --dir 对准客户端 skills 目录，并按需安装 Python 与 OCR 依赖。
官方 SkillHub 页面：https://www.skillhub.cn/skills/user_7f864702/healthai
