前言¶
个人健康管理往往散落在体检 PDF、聊天里的零散指标和「今天有没有动」的自问之间。自己建表格、搜跟练视频、对照参考范围，重复劳动多；把同一套流程交给通用对话，又缺少本地数据结构和定时提醒。下面介绍的 aihealth（坐标 @user_7f864702/aihealth）是 SkillHub 社区上的专业类 Skill，把体检多模态解析、指标对比、运动方案与打卡写进标准 SKILL.md 工作流，并附带 Python 脚本与配置模板，便于在支持 Skills 的 Agent 中落地。
这是什么¶
aihealth 在 SkillHub 上归类为 professional / 医疗健康，当前版本 1.0.0，由社区用户 user_7f864702（页面展示作者为「麦哥的传说」）发布，来源为 community。包内 SKILL.md 将其概括为「健康管理技能 v1.0」：体检报告分析、运动计划、视频推送、打卡监控与每日自动提醒；元数据标明适用渠道包括 feishu、telegram、discord。SkillHub 标签 requires_api_key=false，表示安装本 Skill 本身不强制绑定第三方 API Key（可选能力如腾讯文档同步需另行配置 Token，见包内 README.md）。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_7f864702/aihealth
- API 坐标页：https://api.skillhub.cn/user_7f864702/aihealth
核心功能¶
以下能力均来自包内 SKILL.md、README.md 与 scripts/ 说明，安装后由 Agent 按技能文档触发执行。
自然语言触发与激活¶
用户无需死记命令。技能文档列出多类触发语，例如「激活健康打卡」「体检报告」「运动计划」「打卡」，以及脂肪肝、血压、肩颈腰等健康问题关键词；也可直接发送 PDF、Word 或图片。首次激活类表述会引导绑定用户 ID 并配置定时提醒（heartbeat 或 cron，见下文）。
多模态体检与指标处理¶
支持文字、PDF（含扫描件 OCR）、.docx、图片输入。脚本侧依赖 pdfplumber、python-docx、pytesseract 等（见 requirements.txt）。提取身高体重、肝酶、血脂、血糖、血压等常见指标，并对姓名、身份证号、手机号等字段做脱敏；结合 config/reference_ranges.json 与参考文档做异常倾向提示（如 ALT/GGT、血脂、血糖、血压及肩颈腰椎相关风险提示）。
运动计划与跟练资源¶
根据异常指标匹配运动类型（文档示例包括八段锦、太极、快走、肩颈拉伸、腰椎养护等），并可匹配 B 站教学视频（videos/video_library.json 与 video_matcher.py）。用户可说「今天的运动」「生成运动计划」「想减脂」等获取当日方案与链接。
打卡、对比与文档输出¶
- 打卡数据写入
data/checkins/{user_id}/等路径；支持周报/月报思路及飞书文档写入（feishu_doc_writer.py等）。 data_comparator.py支持多次体检数据对比与趋势标记。README.md另说明可生成健康管理方案、饮食相关模板、Excel 跟踪表，以及通过TENCENT_DOCS_TOKEN创建腾讯文档在线表（可选）。
定时提醒¶
SKILL.md 描述两种方式：OpenClaw Heartbeat（默认约每 2 小时检查，在 09:00 等时段推送运动计划；文档还列出 18:00 打卡、21:30 睡觉提醒）与 cron 备用（示例调用 scripts/daily_health_reminder.sh）。部分时段在「功能说明」中标注为待开发，以文档「待优化（v2.0）」列表为准。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 官方安装文档检查或安装 CLI：
command -v skillhub && skillhub --version
未安装时可执行（完整安装，含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
说明见：https://skillhub.cn/install/skillhub.md。
2. 安装 aihealth 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。SkillHub 检索结果给出的命令为：
skillhub install aihealth --namespace user_7f864702 --dir <你的 skills 目录>
常见路径示例（同一文档摘录）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
也可在 SkillHub 页面将安装提示发给 Agent，让其按 skillhub.md 安装 @user_7f864702/aihealth。
3. Python 与系统依赖（使用 OCR/PDF 脚本时）¶
进入技能包目录后安装 Python 依赖（INSTALL.md / requirements.txt）：
pip install -r requirements.txt
国内环境可使用清华镜像（requirements.txt 内注释）：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
Linux 上 OCR 通常还需系统包（INSTALL.md）：
sudo apt-get install tesseract-ocr poppler-utils
4. 可选：OpenClaw 生态与其他 Skill¶
DEPENDENCIES.md 写明在 OpenClaw 场景下可能还需安装 autoglm-browser-agent、autoglm-image-recognition、feishu-doc、feishu-im-read 等技能，并配置飞书应用权限。仅将 aihealth 装到 Cursor 等客户端时，以对话触发与本地脚本为主，是否启用飞书/定时任务取决于你的运行环境是否提供 heartbeat、cron 或对应 IM 集成。
一键激活脚本（飞书用户 ID + cron 测试，SKILL.md 第五节）：
python3 scripts/activate_health_skill.py
典型用法¶
对话触发（推荐）¶
首次可发送激活或打卡相关语句，例如：
激活健康打卡
上传体检材料或口述结果，例如：
帮我分析体检报告
或直接发送 PDF/图片，由 Agent 按技能流程做 OCR 与指标分析。
运动与打卡示例（摘自技能文档）：
今天的运动
运动打卡
今天运动了
制定方案时可带结构化信息（README.md 示例）：
帮我制定健康管理方案
- 年龄34岁，男性
- 身高175cm，体重71kg
- 饮食习惯：蛋奶素
- 运动时间：中午
- 体检异常：ALT 50.65偏高
记录今天步数：10698步
命令行脚本（不经过对话时）¶
在技能包 scripts/ 目录下（路径以你安装后的实际目录为准）：
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
生成 Excel 跟踪表（需 openpyxl）：
python templates/health_tracking_generator.py --output 健康管理.xlsx --diet 蛋奶素
适用场景与注意¶
适合谁： 希望在 Agent 里统一管理体检解读、运动跟练链接、打卡记录的个人用户；使用飞书/Telegram/Discord 等渠道、或 OpenClaw 心跳/cron 的部署者，更容易用到定时推送与文档回写。
数据与隐私： 技能文档声明健康数据按用户 ID 存放在包内 data/users/、data/checkins/ 等本地路径，并对敏感字段脱敏；是否上传到外部服务取决于你是否启用腾讯文档、飞书等可选集成。
合规： 输出属于健康管理与生活方式建议范畴，不能替代医疗机构诊断与处方。异常指标应结合临床复查；技能自身在 v2.0 待办中仍列出部分提醒时段与 OCR 精度等待完善项。
平台侧信息： SkillHub 页面显示约 602 次下载（以页面统计为准），并提供安全扫描报告入口（如科恩实验室、云鼎实验室结论可在页面查看）。安装后若指标提取、视频链接或计划不匹配，可按 SKILL.md 中的反馈指引向发布者说明问题。
结尾¶
aihealth 把体检多模态输入、指标对照、运动方案、视频匹配、打卡与定时提醒串成一套可复制的 Agent Skill，适合作为个人健康管理的起点，再按需接上飞书或腾讯文档。安装与详情以 SkillHub 为准：
