SomaLoop App 设计

00一句话与目标

01产品原则

十一家 AI 教练的形态与失败模式（App 调研合集第一、二部分）浓缩成七条。每条都会在验收里出现。

1. Agent 就是界面。手环无屏，用户与身体数据的全部交互经由 Agent 发生。Today 页不是仪表盘，是 Agent 的时间线。
2. 先说，再等你问。每天最多三张主动卡（醒来、运动后、睡前），加事件触发的推送；没有超出个人基线的变化就不生成。WHOOP 的原则：无事则静。
3. 每句话可点开依据。任何含数字或结论的句子都附「依据」芯片，点开是原始数据段、时间戳与基线。后台统计接地率并展示。这是对 Google、WHOOP 最集中负评（引用不存在的数据）的直接回应。
4. 能动手。Agent 可发起测量（心率、血氧、HRV、ECG）、设提醒（普通、吃药、喝水）、设久坐提醒、远程开启运动模式、写入记忆。七家大厂无一能按下测量键，这是唯一不用比模型聪明的地方。
5. 记得，并且让你看见它记得。记忆分目标、健康史、生活事件、关注与忽略四类，可查、可改、可删；主动消息必须读记忆，否则重蹈 WHOOP Daily Outlook 的投诉。
6. 说人话，不说病名。不出现房颤、呼吸暂停、高血压等疾病名，不做血糖与血压数值；说「节律不规则」「血氧低于你的基线」；所有输出附「健康参考，非医疗建议」。
7. 数据永远免费，只卖解读。原始数据、导出、基础指标不收费；若有付费层，只放 Agent 解读、计划与长期指标（订阅分层报告结论）。
8. 可拆开看，可接出去。面向 BioHacker 的承诺：每个分数都能拆到原始数据；每段数据都能导出（CSV / EDF / WFDB）；实时 RR、PPG、ECG 流可以开给自己的程序；Agent 用的每个工具都以 MCP 暴露，用户可以换成自己的模型。App 里做的每一件事，开发者都能用 SDK 复现。

02用户与场景

首发用户

个人佩戴者，25 到 45 岁，戴过或考虑过 WHOOP、Oura、Fitbit Air，对「订阅制」和「只给分数不给原因」不满，愿意对一个 App 说自己的生活。机构版（护士站、班组、教练看队员）作为后续模块，本版只在信息架构里留位。

DevKit 用户

与首发用户重叠但动机不同：量化自我与生物黑客（自己写脚本看 HRV、做咖啡与睡眠的对照实验）、研究者与学生（要原始 ECG 与时间戳）、AI Agent 开发者（要 MCP 与事件流）、准备做产品的团队（把这个 App 当白标起点）。App 对他们的承诺见第一章第八条；专属入口在 Me 页的「Lab」区：原始数据流开关、导出、实验、MCP 端点与 API key、接地率与记忆保存率面板。演示稿里 Me 页要把这块做出来，因为它是「DevKit for BioHacker」这句话的证据。

核心用例

用户用一句话描述一件生活里的事，Agent 把它变成一个「玩法」（Playbook）：明确目标、要收集什么数据、手环要做什么动作、每天什么节奏说话、什么时候结束并复盘。第四章定义了十二个玩法，三个是主演示。

03信息架构

四个标签加一个常驻输入框。Today 是 Agent 时间线，其余三个标签是 Agent 的「工作台」，每一屏右下角都能追问。

04场景引导系统

用户不知道该对一个健康 Agent 说什么，这是所有 AI 教练冷启动的共同问题。SomaLoop 用「玩法」把开放式对话变成有限的、可预期的入口，并在四个位置持续引导。

引导出现的四个位置

玩法（Playbook）的统一结构

每个玩法是一份声明式配置，Agent 依此执行；开发者未来可以用同样结构写自己的玩法。

playbook:
  id: marathon-4w
  trigger: ["马拉松", "跑马", "半马", "全马", "参赛"]      # 命中即建议开启
  intake: [赛事日期, 目标完赛时间, 每周可训练天数, 最近一次长跑距离]   # 一次问完，写入记忆
  needs: [夜间心率, HRV, 睡眠分期, 运动会话心率, 步数]   # 手环数据
  actions: [开启跑步模式, 训练日晨间恢复门控, 长跑日前夜提醒, 赛前 3 天减量, 赛日 5:30 闹钟]
  cadence: {morning: 训练建议, post_workout: 负荷与区间复盘, evening: 明日预告, weekly: 周报}
  guardrails: [负荷比 > 1.4 强制降级, 夜间心率高于基线 8 bpm 连续两晚建议休息]
  memory_writes: [目标: 10/12 马拉松 4:00, 生活事件: 训练周期]
  end: {at: 赛后 3 天, deliver: 复盘卡 + 是否续接「恢复两周」玩法}

三个主演示玩法

其余九个玩法（摘要）

05Agent 交互规范

消息卡类型

依据（Evidence）

每个含数据的句子绑定一个依据对象：指标、时间范围、数值、基线区间、图表类型。渲染为芯片，点开为底部抽屉，显示原始数据段（可缩放）、采样点、基线阴影区、数据来源（自动监测 / 即时测量）。没有依据的句子在开发者面板里标灰并计入未接地率。目标：含数据句子的依据覆盖率 100%，整体回答接地率 ≥ 80%（WHOOP 自报 56.6%）。

记忆

• 四类：目标、健康史、生活事件、关注与忽略。每条记录来源对话与时间，可编辑、可删除，删除后下一条消息立即不再引用。
• 写入回执必须出现在时间线里，用户看得见 Agent 记了什么。
• 主动卡生成前必须读取记忆；开发者面板显示「应保存上下文的实际保存率」与「主动卡引用记忆的比例」。

三个旋钮与静默原则

• 频率：少（只在偏离基线时）/ 标准（每天最多 3 张）/ 多（加上每次运动后与每周报）。默认标准。
• 长度：一句话 / 标准 / 详细。默认标准（标题 + 3 句 + 3 条要点）。
• 语气：直接 / 温和。默认直接。参照 Oura 的 direct / conversational。
• 静默：夜间 23:00 到 7:00 不推送（SOS 与用户设置的例外除外）；近 7 天已说过的结论不重复；用户点过「今天休息」后当日不再催训练。

语言规范

• 数字先于形容词：「夜间心率 52，比基线低 3」而不是「你的心率很好」。
• 比较对象永远是本人基线，不是人群；基线未满时明说「还不知道」，不用人群区间冒充。
• 不做结论性判断（正常 / 没问题），只说相对变化与可能的生活因素。
• 一张卡最多一个反问句。
• 拒答后必须给动作。

06数据与算法层

全部确定性计算在手机侧完成，LLM 只做解读与编排。手环不跑 AI。

V8 能给什么

没有的：呼吸率字段（从 PPI 的呼吸性窦性心律不齐推算）、原始加速度流（做不了肌肉负荷）、GPS（配速用手机 GPS 补）、震动马达指令（「震一下」用一分钟后的闹钟替代，演示时如实说明）。

指标层（第一版范围）

• 夜间五项基线（心率、HRV、呼吸率推算、皮温、SpO2）：7 到 30 天个人范围，超出即事件。这是 Agent 主动消息的主要事件源，也是 Body 页的第一屏。
• 睡眠分：参照 Apple 公开权重（时长 50 / 就寝规律 30 / 中断 20）做参考实现，贡献项全部可见。
• 恢复分：白盒，六项贡献（RHR 偏离、HRV 平衡、皮温偏离、恢复指数、睡眠、前日活动）各 0 到 100 并给量化说明。
• 负荷：TRIMP 加 7 对 28 天比值，分档抄 Garmin / Polar 公开阈值；不做 EPOC 与肌肉负荷。
• 日间压力：HRV 包加步数排除运动；粒度 30 分钟，标注。
• 校准期：所有分数 14 夜；期间显示「已积累 N / 14 夜」与已能看的原始趋势；第 14 夜主动推送「从今天起可以看恢复分了」并解释组成。

Agent 架构

• 内联注入（WHOOP 做法）：当天摘要、基线、最近事件、记忆在 prompt 渲染时直接注入；只有「发起测量、设提醒、开运动模式、查历史、写记忆」走工具调用。
• 确定性优先（Google 做法）：事件检测、基线、负荷比全部是算法输出，LLM 不做数值计算。
• 拒答门禁：合成 Persona 输入集覆盖疾病名提问，通过率作为发版前置。
• 模型可换：Claude、GPT、Gemini、DeepSeek、本地模型均可；开发者可自带 key。

07屏幕与关键流程

这是演示稿要做出来的清单。带「★」的是三个主演示流程必经的屏。

08设计语言

对齐 WHOOP 与 Oura 的标准，具体到可以验收的规则。页首的小样是按这套规则做的 Today 页。

09边界与合规

• 非医疗器械，仅供健康参考与研发；所有 Agent 输出附「健康参考，非医疗建议」。
• 不出现疾病名；不做血糖、血压数值；HRV 包里的血压与血管老化度隐藏或标「参考」。
• 不用人群阈值冒充个人基线；基线未满时明说。
• 发给医生、联系家属、改用药提醒必须人确认并留痕。
• 数据默认留在手机；云端可选且可自建；明示不用于训练。健康数据按敏感个人信息处理，单独同意。
• 拒答门禁通过率作为发版前置；接地率作为发版门禁指标。

10度量与验收

11路线与演示稿计划

阶段

1. HTML 演示稿（本文档确认后开始）：手机尺寸的可点击原型，深色，按第八章规则实现；三条主演示流程可完整走通；数据为脚本化的假数据，但结构与真实 SDK 字段一致；可部署到 ecg-devband-report.pages.dev/app/demo。
2. 原生 App：建议 Flutter 一套代码，通过平台通道桥接 V8 的 iOS 静态库与 Android aar；BLE 连接与历史同步（每批 50 组、断点续传）在原生层；指标层与 Agent 编排在 Dart 层；多设备并发演示前必须真机实测。若团队更熟原生，则 iOS Swift + Android Kotlin 双写，SDK 直接调用。
3. 白标化：品牌、配色、玩法库、旋钮默认值全部配置化，成为开发者套件的参考 App。

演示稿的三条主线（15 分钟）

剩余 2 分钟：Me 页展示记忆与三个旋钮，再进 Lab 打开一条实时 RR 流、导出一段 ECG、展示 MCP 端点与接地率，说明「这就是 DevKit for BioHacker：消费者能用，开发者能拆」。

可点击的 HTML 演示稿：ecg-devband-report.pages.dev/app/demo（核心页与核心交互，假数据，结构与 SDK 字段一致）。