算法说明书 · CFHI 家庭健康风险指数 v1.0.md 5.4 KB

算法说明书 · CFHI 家庭健康风险指数 v1.0

系列:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之一) 实现位置:client-app.html(屏 c11 家庭指数 · 引擎 CFHI_ENTRY / CFHI_DEEP / CFHI_LAMBDA_Q / submitEntry() / submitDeep()) 参数单一真相源:shared/cfhi-params.js(⚠️ 由 scripts/build-cfhi-params.py 从 configs/cfhi-params.json 生成,禁止手改) 方法论 SSOT(IP 层):[[【助飞科技】/知识产权/文字著作/家庭健康风险指数(CFHI)/CFHI 评分标准与计分方法 v0.3.md]] —— 本文只写 APP 实现口径,方法论权属与表述以 IP 文档为准 基线版本:client-app.html v1.120 · cfhi-params v0.3.1(2026-09-05 核对:内容与实现一致 · v1.88 D6 更名 / v1.96 双子分均已收录)


一、概述

CFHI(Chinese Family Health Risk Index)用问卷 + 检测 + 穿戴 + 行为多源数据量化家庭健康风险。客户端采用双层题库制:

层 题量 时长 作用
Layer 1 · 入口版快测 14 题(7 维 × 2)+ λ 治理 2 题 约 3 分钟 建立基线,低门槛引流
Layer 2 · 深度测评 31 题(7 维) 约 15 分钟 覆盖入口版基线,生成短板清单,完成 +200 积分

覆盖优先级(按维度独立覆盖,不是整分替换):真实检测数据 > 深度版 > 入口版。

二、维度与权重

维度 名称 权重 w 入口版题数 深度版题数
D1 免疫基础 1.5 2 4
D2 代谢健康 1.0 2 5
D3 慢病管理 1.0 2 4
D4 家族遗传风险 1.0 2 4
D5 生活方式 1.0 2 5
D6 心理与恢复 1.0 2 5
D7 医疗可及 1.0 2 4
  • 每维度满分 6 分;加权满分 R_max = 45(= 1.5×6 + 6×6)
  • 短板判定:score ≤ 2 标红(雷达图红点 + 明细条橙色)

三、计分公式

3.1 选项计分

每题 4 个选项,按选项序位计 0 / 1 / 2 / 3 分(选项按状态从差到好排列)。

3.2 维度分

s_d = min(6, round( 该维合计 ÷ (该维题数 × 3) × 6 ))

入口版与深度版同一公式,只换题库。

3.3 基线指数 P(百分制)

P = round( Σ( w_d × s_d ) ÷ 45 × 100 )

3.4 分级阈值(gradeOf())

分级 分数区间
🟢 健康完备型 ≥ 85
🟡 局部缺口型 70 – 84
🟠 系统失衡型 55 – 69
🔴 高风险型 < 55

四、λ 家庭治理系数(入口版 2 题)

λ = λ_机制 + λ_账户,钳制在 [0.75, 1.05]

λ_机制(健康决策机制):无 = 0.80 | 口头共识无书面 = 0.85 | 设决策人未系统化 = 0.90 | 完整治理体系 = 1.00 λ_账户(建档完整度):仅 1 人建档 = −0.05 | 核心成员已建档 = 0.00 | 全员建档定期更新 = +0.05

治理完备可加分(λ > 1.00),上限 1.05 而非 1.00。

五、家庭聚合(方案 C · 短板敏感)

F = round( ( 0.75 × mean(P_members) + 0.25 × min(P_members) ) × λ )
  • 均值占 75% + 最弱成员占 25% —— 家庭分被最差成员拉低,体现「短板敏感」(2026-08-01 Jack 拍板)
  • 实现:MINGDAO_CFHI_PARAMS.familyScore(scores, lambda)
  • 当前客户端口径:入口版产出 P 与 λ 展示(演示口径);深度版提交后直接覆盖 CFHI.total = P 并触发三屏同步刷新(c1 卡 / c6 / c11)

六、结果输出

入口版结果页:基线分 P + 分级 + λ 值 + 7 维明细条 + 短板提示 + 「补深度测评(+200 积分)」引导。

深度版结果页:新基线 P + 分级 + 7 维明细(逐项显示 vs 旧基线分差)+ 短板清单(最低 2 维,作顾问面谈提纲)+ 积分入账。

合规声明(不可删):D6 含 PHQ-2 / GAD-2 国际公版筛查题,结果仅为风险提示,不构成医学诊断。

D6 双子分(v1.96 · 呈现层):7 维明细 D6 行下挂「心理状态 · 问卷」(基线子分)+「恢复质量 · 数据」(动态子分,未接穿戴显示「待接入穿戴」)+ 70/30 合成注。数据驱动:CFHI.dims[D6].subs(val:null 渲染待接入态)。合成规则与总分不变,方法论见 IP v0.3.1 §5.1 呈现层补充。

七、题库与数据文件

资产 位置 说明
入口版题库 client-app.html · CFHI_ENTRY(7 维 × 2 题)+ CFHI_LAMBDA_Q(2 题) 与顾问端 shared/cfhi-questions.js 同源
深度版题库 client-app.html · CFHI_DEEP(31 题) D3 注明「无慢病家庭按满分计」· D6 注明「筛查非诊断」
参数 shared/cfhi-params.js 权重 / R_max / 分级阈值 / λ 选项值 / 聚合公式
当前演示基线 CFHI.total = 65(2026-08-13 入口版实测) K 线 / 积分 / 个人 7 维为模拟演示

八、已知边界

  1. 深度版覆盖回写目前仅本次会话生效,落库持久化归 Phase 2 后端
  2. 穿戴数据接入(×1.2 倍率)方向已定、未实现
  3. 复测激励(如 30 天后复测 +20)待 P1 与 CFHI 复测叙事一并设计

文档版本:v1.0 · 2026-09-01 · Jack + Claudian 文档版本:v1.0.1 · 2026-09-05 · 基线戳刷新(v1.73→v1.120 · cfhi-params v0.3.1)· 内容核对无漂移未改