morningform

Morning Form

Morning Form 是一款高端、移动优先的状态优化 Web 应用，涵盖评估、档案生成、方案推荐、每日指导、签到、洞察和可穿戴设备集成。

本地开发

cd /Users/reubenselby/Desktop/morning-form
npm install
npx prisma db push
npm run db:seed
npm run dev

应用 URL：

http://localhost:3000

本地预置的演示用户：

[email protected]

当前分支工作流

• main：已构建的 MVP
• feat/real-health-oauth：用于审核真实服务提供商连接配置的分支

待审阅的 PR：

https://github.com/contactxyz-admin/morning-form/pull/1

健康集成

Morning Form 目前支持：

• 基于 Terra 的 Apple Health 和 Garmin 连接流程
• Whoop、Oura、Fitbit 和 Google Fit 的直接 OAuth 脚手架
• 通过 Prisma 持久化服务提供商连接
• 配置凭据后使用回调路由和令牌交换
• 缺少凭据时平稳回退到模拟模式

详细的服务提供商配置说明见：

docs/HEALTH_PROVIDER_SETUP.md

指标

• 激活漏斗（注册 → 首个有依据的回答 → 留存）：npx tsx scripts/metrics/activation-funnel.ts --signup-since 2026-03-22 --signup-until 2026-04-21。输出 CSV 和易读摘要。参见 docs/plans/2026-04-21-002-feat-activation-funnel-instrumentation-plan.md。

复测循环

复测循环（默认关闭，由 RETEST_LOOP_ENABLED 控制）负责执行“回访流程”：实验室检测完成一次 Draw 后，系统会安排下一次复测；Vercel 每日 cron（/api/cron/retest-nudge，由 CRON_SECRET 控制）会发送有次数上限的提醒序列，并衡量复测留存情况（由提醒促成的复测即归因于该循环）。启用该标志时，上方的指标 CLI 会追加复测留存部分。为现有用户补录基线（启用前以暗模式运行）：先运行 npx tsx scripts/retest/backfill-baseline-draws.ts（试运行），再运行 --apply。可调参数位于 src/lib/retest/constants.ts。参见 docs/runbooks/retest-loop-go-live.md 和 docs/plans/2026-06-17-001-feat-return-leg-retest-loop-plan.md。

检索

配置嵌入服务提供商后即可启用混合检索。它仅为 SourceChunk.text 生成嵌入，每个分块存储一个 VectorEmbedding，并保持 search_graph_nodes 使用相同的公开接口，同时通过向量、词法和图 RRF 进行排序。设置 HYBRID_RETRIEVAL_ENABLED=false 即可回退到旧版词法／图检索行为。

生产环境部署：

npx prisma generate
npx prisma db push
npx tsx scripts/backfill-embeddings.ts --dry-run --estimate
npx tsx scripts/backfill-embeddings.ts --batch 80

参见 docs/runbooks/hybrid-retrieval-production.md 和 docs/runbooks/backfill-embeddings.md。