# 算法说明书 · 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)· 内容核对无漂移未改*