LifeOS 健康数据层实战指南：从 HEALTH.md 模板到可被 DA 推理的个人健康档案-港品优选

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对话式访谈、直接编辑或导入化验单三种方式填充这套模板，理解 DA（Digital 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.md），DA 会在下一次读取时自动纳入分析——这为第三小节介绍的"粘贴化验 PDF"路径提供了落点。

二、HEALTH.md 顶层档案逐段解读

HEALTH.md 是健康模块的"首页"，它本身不是数据仓库，而是入口与状态快照。逐段拆解如下。

2.1 Quick Reference：基础档案表

Detail	Value（示例值）
Age	30（1996-01-01 出生，示例）
Height	175 cm / 69 in（示例）
Weight	75 kg / 165 lbs（示例）
Blood Type	O Rh+（示例）
Biological Age	待首次生物标志物检测后填充
Healthcare	Sample Clinic 初级保健 + Sample Lab 生物标志物检测

模板刻意使用175 cm、75 kg、O Rh+这类"圆整的占位值"，METRICS.md 的 Notes 中对此有说明：占位值必须一眼就能看出"尚未录入真实数据"，避免误把模板当事实。

2.2 文件索引表：六个下游文件

File	Purpose
`CONDITIONS.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 在被问到"what's 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 Age	sample	保持或改善
Weight	75 kg / 165 lbs	70 kg
ApoB	100 mg/dL	低于 90 mg/dL
LDL-Cholesterol	120 mg/dL	低于 100 mg/dL
LDL Pattern	sample (A 或 B)	Pattern A
HDL-Cholesterol	50 mg/dL	高于 40 mg/dL
eGFR	100 mL/min	高于 90 mL/min
Omega-3 Total	5% by wt	高于 8%
Triglycerides	100 mg/dL	低于 150 mg/dL
HbA1c	5%	低于 5.7%
Glucose	90 mg/dL	70–99 mg/dL
Vitamin D, 25-OH	50 ng/mL	40–80 ng/mL
VO2 Max	35 mL/kg/min	高于 35
Blood Pressure	120/80 mmHg	低于 130/80
Resting HR	60 bpm	50–70 bpm

Trends（两次面板对比）——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 History（Past Conditions 表、Surgeries 表、Family History）→ Vitals Snapshot 表 → Blood Type → Notes。

其 Notes 特别强调两个跨文件约定：

DA 用这份文件做风险提示：当你询问新药、新补充剂或新手术时，DA 会依据过敏与病史标记风险；
为每个活动性疾病链接到 METRICS.md 的化验值和 MEDICATIONS.md 的用药，使 DA 能够跨文件推理。

3.3 MEDICATIONS.md：用药清单

四张表：Prescription Medications（Medication | Dose | Purpose | Notes）、Daily Supplements、As-Needed（非每日）、Past Medications。Notes 强调：列全所有规律服用的药物（含非处方药），以便 DA 在新处方或新补充剂咨询时标记相互作用；剂量调整应同时记录当前剂量与目标剂量并带日期；过敏与敏感条目归 CONDITIONS.md，不放在这里。

3.4 PROVIDERS.md：服务方档案

含 Primary Care（Provider/Practice/Location/Phone/Patient Portal/Last Visit/Next Visit 字段）、Specialists 表、Biomarker Testing（panel 大小、最近面板、节奏）、Pharmacy、Pending Referrals 表、Insurance 六块。Notes 给出两条实用建议：用Dr. Sample Provider这类通用占位名直到替换为止（"The DA will not invent real providers"）；同时提醒即便该目录属于私有区，也需斟酌是否要在明文里保存完整姓名与电话号码。

3.5 FITNESS.md 与 NUTRITION.md：生活方式档案

FITNESS.md：Current Routine（每日活动 + 力量训练）、Goals（主目标带目标日期 + 次目标）、Current Stats 表（体重、身高、VO2 Max、HRV、静息心率、步数、睡眠一致性）、Weight History 表（建议每月至少记录一个体重/体成分数据点以便 DA 检测趋势）、Notes。
NUTRITION.md：Dietary Approach（地中海/低碳水/高蛋白/植物基/限时进食等模式 + 遵循严格度）、Meal Preparation（备餐方式、外出就餐频率与类型）、Key Nutritional Considerations（Goals + 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.toml；TELOS 当前状态与理想状态写入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 # 授权指定来源

源码定义了四个可接入来源：oura（Oura 指环）、eightsleep（Eight Sleep 床垫）、apple（Apple Health）与function（Function Health 检测服务），对应healthsync/目录下的 apple.ts 等来源模块。

5.2 关键实现细节

目标路径：current.json写入~/.claude/LIFEOS/USER/HEALTH/current.json——正是USER/HEALTH/目录的运行时位置，说明健康数据在本机~/.claude/LIFEOS配置树与仓库模板之间保持同名结构对应；
日志与新鲜度：同步日志写入~/.claude/LIFEOS/MEMORY/OBSERVABILITY/healthsync.jsonl；FRESH_MS = 25 * 60 * 60 * 1000（25 小时）定义了数据的"新鲜度阈值"，超过即视为过期需要重新拉取；
超时与 OAuth：单次运行超时RUN_TIMEOUT_MS = 60_000，每次抓取超时FETCH_TIMEOUT_MS = 15_000；OAuth 回调端口为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 助手真正"理解"而不是"存储"的用户来说，这套文件结构就是起点。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析