LifeOS 健康数据层实战指南从 HEALTH.md 模板到可被 DA 推理的个人健康档案【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS导读本指南围绕 LifeOS 个人健康模块的核心文档 HEALTH.md 展开它是整个USER/HEALTH/目录的顶层总览用一张 Quick Reference 表汇总年龄、身高、体重、血型等基础档案用 Current Status 与 Recent Updates 记录当前健康焦点与最新动态并索引 CONDITIONS、MEDICATIONS、PROVIDERS、FITNESS、NUTRITION、METRICS 六份专题文件。读完本文你将掌握如何通过/interview对话式访谈、直接编辑或导入化验单三种方式填充这套模板理解 DADigital Assistant如何跨文件推理健康风险并了解 HealthSync 等源码工具如何把可穿戴设备数据自动汇入该目录。一、HEALTH 目录在 LifeOS 中的定位1.1 属于 USER 身份层的私有区域USER/HEALTH/位于 LifeOS 的 USER 身份层内按 USER/README.md 的说明整个USER/树存放 LifeOS 所知道的关于你的全部信息——身份、声音、目标、项目与工作上下文并且会在每次会话启动时通过CLAUDE.md的-imports被加载使 DA 一开机就知道你是谁、在忙什么。健康数据在这一层里有一个特殊属性私有性。HEALTH 目录 README 明确写道This directory is private by default and is not included in public LifeOS releases.——发布工具会拒绝发布USER/HEALTH/下的任何内容对待它的方式应当像对待你的病历一样。因此填充真实数据时无需担心随仓库发布泄露。1.2 扁平化文件布局的设计意图该目录刻意采用一个主题一个 Markdown 文件的扁平布局不建子目录。原因有两层DA 扫描效率DA 需要快速扫描健康数据以回答我这个季度该重点关注什么总结我上次的化验报告这类问题扁平结构降低检索成本人手编辑友好用户手工编辑时无需在目录树中来回跳转。目录内共七个文件职责划分如下文件职责HEALTH.md顶层总览年龄、身高体重、当前焦点、快速参考METRICS.md化验数值、生物标志物、生命体征、每日活动数据与趋势FITNESS.md运动计划、体重历史、健身目标NUTRITION.md饮食模式、备餐方式、营养优先级MEDICATIONS.md处方药、日常补充剂、按需用药、历史用药PROVIDERS.md初级保健、专科、检测服务、待办转诊CONDITIONS.md活动性疾病、过敏史、病史此外你还可以直接把带日期的化验单文件丢进该目录例如lab_results_2026-01.mdDA 会在下一次读取时自动纳入分析——这为第三小节介绍的粘贴化验 PDF路径提供了落点。二、HEALTH.md 顶层档案逐段解读HEALTH.md 是健康模块的首页它本身不是数据仓库而是入口与状态快照。逐段拆解如下。2.1 Quick Reference基础档案表DetailValue示例值Age301996-01-01 出生示例Height175 cm / 69 in示例Weight75 kg / 165 lbs示例Blood TypeO Rh示例Biological Age待首次生物标志物检测后填充HealthcareSample Clinic 初级保健 Sample Lab 生物标志物检测模板刻意使用175 cm、75 kg、O Rh这类圆整的占位值METRICS.md 的 Notes 中对此有说明占位值必须一眼就能看出尚未录入真实数据避免误把模板当事实。2.2 文件索引表六个下游文件FilePurposeCONDITIONS.md活动性疾病与病史示例MEDICATIONS.md当前用药与补充剂示例PROVIDERS.md医疗服务提供方与检测服务示例FITNESS.md运动计划与目标示例NUTRITION.md饮食与进食模式示例METRICS.md化验值、生命体征、每日活动示例这张表的作用是让 DA以及人从顶层快速路由到对应细节文件。2.3 Current Status状态三栏结构模板将当前状态分为三个编号/列表区块Primary Concerns (Ranked)——按优先级排序的核心关切每条需写清问题是什么 正在做什么 跟踪的指标。模板示例Sample concern one — short description of the top issue and what is being done about it.Positive Indicators——正向指标某指标在目标范围内、某指标趋势向好、某指标自上次检查以来保持稳定。Areas Needing Attention——需关注区域某指标低于目标需要干预、某指标趋势方向不对、某指标处于临界值。这一问题—正向—待改进的三分法为 DA 提供了结构化的推理输入当用户询问健康建议时DA 可以据此直接引用当前焦点。2.4 Current Focus季度焦点段模板要求用三到四句话概括本季度健康上的主动工作例如体重管理、睡眠优化、血脂改善、伤病恢复或建立基线。其设计目的是让 DA 在被问到whats the current health focus时能原样引用这段话因此建议写成可直接复述的短段落而非长篇论述。2.5 Recent Updates更新日志按日期倒序记录最近的化验结果、就诊、用药变更开始/停止/调剂量、健身里程碑或退步。模板示例为- **2026-01-01 (sample):** Brief note about a recent lab result...。建议保持每条一行、以日期开头便于 DA 解析时间线。三、六份专题文件的继承结构HEALTH.md 索引的六个文件各自承担独立的健康子域理解它们的结构有助于一次性完成整套档案的填充。3.1 METRICS.md数据核心这是整个健康模块的数据核心分为四个表Key Numbers示例面板 2026-01-01——每行Metric | Value | Status | Target四列模板内置了 15 项常用指标及目标值可直接沿用为你的目标基线Metric示例值示例目标Biological Agesample保持或改善Weight75 kg / 165 lbs70 kgApoB100 mg/dL低于 90 mg/dLLDL-Cholesterol120 mg/dL低于 100 mg/dLLDL Patternsample (A 或 B)Pattern AHDL-Cholesterol50 mg/dL高于 40 mg/dLeGFR100 mL/min高于 90 mL/minOmega-3 Total5% by wt高于 8%Triglycerides100 mg/dL低于 150 mg/dLHbA1c5%低于 5.7%Glucose90 mg/dL70–99 mg/dLVitamin D, 25-OH50 ng/mL40–80 ng/mLVO2 Max35 mL/kg/min高于 35Blood Pressure120/80 mmHg低于 130/80Resting HR60 bpm50–70 bpmTrends两次面板对比——Prior Panel | Latest Panel | Direction三列方向字段取值如Improving、Slight improvement、Stable用于刻画指标随时间的变化方向。Daily Metrics可穿戴/应用快照——每日活动数据卡路里消耗、运动时长、HRV、步数、睡眠一致性、VO2 Max均来自可穿戴设备或健康应用。Lab Sources——记录检测服务商、最近面板日期与检测生物标志物数量例如Sample Lab | 2026-01-01 | 120 biomarkers。3.2 CONDITIONS.md疾病与风险结构为Active Conditions每条含 marker、status、notes无则写_None._→ Allergies药物/环境/食物三类→ Medical HistoryPast Conditions 表、Surgeries 表、Family History→ Vitals Snapshot 表 → Blood Type → Notes。其 Notes 特别强调两个跨文件约定DA 用这份文件做风险提示当你询问新药、新补充剂或新手术时DA 会依据过敏与病史标记风险为每个活动性疾病链接到 METRICS.md 的化验值和 MEDICATIONS.md 的用药使 DA 能够跨文件推理。3.3 MEDICATIONS.md用药清单四张表Prescription MedicationsMedication | Dose | Purpose | Notes、Daily Supplements、As-Needed非每日、Past Medications。Notes 强调列全所有规律服用的药物含非处方药以便 DA 在新处方或新补充剂咨询时标记相互作用剂量调整应同时记录当前剂量与目标剂量并带日期过敏与敏感条目归 CONDITIONS.md不放在这里。3.4 PROVIDERS.md服务方档案含 Primary CareProvider/Practice/Location/Phone/Patient Portal/Last Visit/Next Visit 字段、Specialists 表、Biomarker Testingpanel 大小、最近面板、节奏、Pharmacy、Pending Referrals 表、Insurance 六块。Notes 给出两条实用建议用Dr. Sample Provider这类通用占位名直到替换为止The DA will not invent real providers同时提醒即便该目录属于私有区也需斟酌是否要在明文里保存完整姓名与电话号码。3.5 FITNESS.md 与 NUTRITION.md生活方式档案FITNESS.mdCurrent Routine每日活动 力量训练、Goals主目标带目标日期 次目标、Current Stats 表体重、身高、VO2 Max、HRV、静息心率、步数、睡眠一致性、Weight History 表建议每月至少记录一个体重/体成分数据点以便 DA 检测趋势、Notes。NUTRITION.mdDietary Approach地中海/低碳水/高蛋白/植物基/限时进食等模式 遵循严格度、Meal Preparation备餐方式、外出就餐频率与类型、Key Nutritional ConsiderationsGoals Lab-Informed Priorities、Hydration饮水目标与咖啡因模式、Food Sensitivities。其 Notes 直接点明输入质量与输出质量的对应关系Vague placeholders produce vague advice. Specific real entries produce specific real advice.四、填充真实数据的三种途径HEALTH 目录 README 按工作量递增给出三种填充方式覆盖从零基础到已有数据源的全部场景。4.1 途径一运行 Health 访谈推荐调用Skill(Interview)即 Interview 工作流。该流程以同伴对话而非表单的方式逐项提问一次只问一个问题写完即existsSync守卫——绝不覆盖用户已给出的答案用户可对任意条目说skip、随时说done提前结束部分完成的 onboarding 同样有效Pulse 会展示已有的部分。访谈序列中与健康档案相关的步骤包括Principal identity 写入PRINCIPAL/PRINCIPAL_IDENTITY.md与LIFEOS_CONFIG.tomlTELOS 当前状态与理想状态写入TELOS/最终由bun Tools/SeedPulse.ts先 dry-run 再--apply生成LIFEOS_STATE.json并重生成PRINCIPAL_TELOS.md。该工作流只写用户的配置树绝不触碰系统文件若单独以lifeos interview调用会先确认 Setup 已运行。4.2 途径二直接编辑文件直接以真实数据替换示例值。关键前提是保持每个文件的结构不变——The structure of each file is the structure your DA expects.所有示例值均为占位符METRICS.md的 Notes 提醒在录入真实化验结果之前不要依赖 DA 的分析结论。4.3 途径三粘贴化验单 PDF把化验单文件PDF 或 Markdown放入USER/HEALTH/目录然后请 DA 提取数值写入METRICS.md与CONDITIONS.md。带日期的化验单文件如lab_results_2026-01.md会被 DA 在下次读取时自动纳入。这是把已有纸质/PDF 数据迁移进系统的最高效路径。五、从模板到自动化源码中的健康数据通路填充完成的 HEALTH 档案不只是给人看的 Markdown它会进入 LifeOS 的自动化数据通路其中最具代表性的是 HealthSync.ts 基础 CLI 与healthsync/子模块。5.1 HealthSync 命令集从源码头部注释可见其命令行接口bun LIFEOS/TOOLS/HealthSync.ts pull # 拉取全部来源 bun LIFEOS/TOOLS/HealthSync.ts pull --source oura # 仅拉取指定来源 bun LIFEOS/TOOLS/HealthSync.ts status # 查看同步状态 bun LIFEOS/TOOLS/HealthSync.ts current # 查看当前健康快照 bun LIFEOS/TOOLS/HealthSync.ts auth oura # 授权指定来源源码定义了四个可接入来源ouraOura 指环、eightsleepEight Sleep 床垫、appleApple Health与functionFunction Health 检测服务对应healthsync/目录下的 apple.ts 等来源模块。5.2 关键实现细节目标路径current.json写入~/.claude/LIFEOS/USER/HEALTH/current.json——正是USER/HEALTH/目录的运行时位置说明健康数据在本机~/.claude/LIFEOS配置树与仓库模板之间保持同名结构对应日志与新鲜度同步日志写入~/.claude/LIFEOS/MEMORY/OBSERVABILITY/healthsync.jsonlFRESH_MS 25 * 60 * 60 * 100025 小时定义了数据的新鲜度阈值超过即视为过期需要重新拉取超时与 OAuth单次运行超时RUN_TIMEOUT_MS 60_000每次抓取超时FETCH_TIMEOUT_MS 15_000OAuth 回调端口为AUTH_PORT 8474源码注释还记录了 Oura 的一个已知坑——拒绝127.0.0.1形式的回调地址返回 400 invalid_request必须用localhost返回 302因为两者虽然解析到同一 loopback但 Oura 只接受后者。5.3 配套的健康工具同一目录下还有其他与健康数据相关的工具可作为佐证FITNESS.md提到若使用可穿戴设备链接其导出让每日指标自动流入 METRICS.md——这正是 HealthSync 的职责AppleHealthImport.ts 与healthsync/apple.ts对应 Apple Health 数据导入HealthSnapshot.ts 则对应健康快照的生成与读取是current.json 快照这一设计的上游/下游配套。六、隐私边界与跨文件写作约定6.1 私有区发布保护如第一节所述USER/HEALTH/处于私有区LifeOS 发布工具拒绝发布其内容。这一点在 USER/README.md 有更完整的描述发布构建器会从暂存区删除整个USER/树并以通用脚手架覆盖。因此无论你在该目录写入多少真实健康数据都不会进入任何公开发布物。6.2 跨文件写作约定总结综合各文件 Notes维护这套档案时应遵守以下约定CONDITIONS.md 是风险中枢过敏、敏感、病史集中在 CONDITIONS.md并链接到 METRICS.md 的化验值与 MEDICATIONS.md 的用药供 DA 做跨文件风险推理MEDICATIONS.md 只放在用什么过敏条目归 CONDITIONS不归 MEDICATIONS列全规律用药含 OTC以支持相互作用检查剂量调整记录当前值与目标值并带日期METRICS.md 只放真实数值占位值要圆整得一眼可辨录入真实化验前不依赖 DA 分析每次面板更新同时维护 Trends 表FITNESS.md 至少每月一个数据点让 DA 能检测体重/体成分趋势NUTRITION.md 的输入质量决定建议质量具体真实的条目产出具体真实的建议PROVIDERS.md 斟酌明文敏感度即便在私有区也应考虑是否将完整姓名与电话以明文存放。七、结语让健康档案成为可推理的活数据HEALTH.md 及其六个姊妹文件共同构成了 LifeOS 的健康知识层——它不是静态表单而是一组有约定、可链接、可自动同步的结构化 Markdown 档案。通过 Interview 工作流 的对话式填充、直接编辑或化验单导入完成初始化后DA 便能回答这个季度健康上该专注什么总结我上次的面板这类问题接入 HealthSync 后可穿戴设备数据还能以 25 小时新鲜度阈值自动汇入使档案从模板进化为活数据。对任何希望让个人健康数据被 AI 助手真正理解而不是存储的用户来说这套文件结构就是起点。【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考