当前位置：首页 > news >正文

鸿蒙心理测评模块实战｜PHQ-9/GAD7双量表答题、实时计分与结果本地化存储

news 2026/5/28 4:14:29

一、前言

心晴驿站已正式稳定上架华为应用市场，所有专栏内容均基于线上真实版本复盘产出，所有逻辑、代码、优化方案均通过真机测试、性能校验、隐私合规审核，具备完整落地与参赛复用价值。

在前八篇专栏中，我们完成了项目整体架构搭建、Stage模型分层、全局路由封装、公共组件化、隐私树洞功能、Preferences本地化存储体系，项目底层技术底座已完全成熟，具备支撑核心业务模块开发的全部条件。

本篇正式落地项目核心业务功能——心理测评模块。作为产品核心刚需功能，测评模块区别于普通娱乐测评，采用行业通用的PHQ-9 抑郁筛查量表 + GAD-7 焦虑筛查量表，实现纯端侧离线答题、实时计分、自动情绪评级、结果本地留存、历史记录查看完整闭环。全程无云端计算、无数据上传、隐私安全可控，完美契合产品离线治愈、高隐私的核心定位。

二、测评模块产品设计与行业规范

2.1 双量表选型依据

为保证测评专业性、合规性与实用性，项目摒弃自编娱乐题库，选用心理学通用权威量表，也是轻量化心理工具类APP最常用的两套筛查标准：

PHQ-9 抑郁筛查量表：共9道题目，针对抑郁情绪、低落状态、行为状态进行量化评分，适合日常自我情绪筛查；
GAD-7 焦虑筛查量表：共7道题目，针对紧张、焦虑、惶恐、失眠等焦虑状态量化评估，题型轻量化、适配移动端自测场景。

两套量表题目精简、计分逻辑公开、无版权风险，完全适配鸿蒙轻量化应用定位，同时满足上架内容合规要求。

2.2 核心业务流程设计

项目测评模块采用标准化流程，用户体验连贯、逻辑闭环：

测评列表页选择量表 → 逐题作答、实时计分 → 完成答题 → 算法自动评级 → 结果页面展示详情 → 本地自动存储记录 → 个人中心可查看/清空历史数据

2.3 核心功能亮点

纯离线运算：计分、评级全部端侧算法完成，无需联网、无后端接口依赖；
实时动态计分：答题过程实时累加分数，进度动态更新；
分级结果展示：根据分数区间区分正常、轻度、中度、偏重情绪状态；
隐私可控存储：测评数据本地私有存储，用户可自主清空，无隐性留存；
交互轻量化：上一题、下一题、快速重测、进度记忆，适配移动端操作习惯。

三、测评模块分层架构设计

延续项目统一四层分层架构，测评模块严格遵循数据、算法、视图、存储完全解耦原则，结构清晰、可扩展性极强，后续可快速新增其他量表。

数据层（constant）：统一维护 PHQ-9、GAD-7 题库、分数区间、评级文案常量；
算法层（service）：封装通用计分算法、情绪评级算法、结果匹配逻辑；
视图层（pages/components）：答题页面、进度组件、结果卡片、测评列表复用公共组件；
存储层（utils）：对接第八篇封装的 Preferences 工具，实现结果持久化存储与读取。

四、题库与评级常量结构化封装

新建constant/test_const.ets，统一管理双量表题库、选项分值、评级规则，集中式管理便于后期迭代新增题目与调整规则。

/** * 心理测评题库 & 评级规则常量 * PHQ-9 抑郁量表 / GAD-7 焦虑量表 * 心晴驿站上架正式版本 */ // 单题选项分值（两套量表通用：完全没有、偶尔、时常、几乎每天） export const TEST_SCORE_OPT = [0, 1, 2, 3] // PHQ9 9道题目 export const PHQ9_QUESTIONS: string[] = [ "做事提不起兴趣、没愉快感", "心情低落、沮丧或绝望", "入睡困难、睡得不踏实或睡得过多", "疲惫无力、精力不足", "食欲不振或暴饮暴食", "自我否定、觉得自己失败或让家人失望", "难以集中注意力", "动作或说话迟缓、或坐立不安", "有伤害自己的念头" ] // GAD7 7道题目 export const GAD7_QUESTIONS: string[] = [ "紧张、焦虑、容易心烦", "无法控制地担心、胡思乱想", "过度担忧各类事情", "难以放松、无法平静", "坐立不安、难以静坐", "容易烦躁、易怒", "惶恐不安、预感坏事发生" ] // PHQ9 分数评级规则 export function getPhq9Level(score: number): {level: string, desc: string} { if (score <= 4) { return { level: "情绪正常", desc: "近期情绪状态稳定，保持良好心态，继续保持规律作息与好心情。" } } else if (score <= 9) { return { level: "轻度情绪低落", desc: "存在轻微低落情绪，属于正常情绪波动，可通过放松、休息、倾诉自我调节。" } } else if (score <= 14) { return { level: "中度情绪低落", desc: "负面情绪较为明显，建议多放松解压，持续调整心态，必要时寻求亲友陪伴。" } } else { return { level: "偏重情绪低落", desc: "近期情绪压力较大，建议重视自身状态，多休息、积极调节，必要时寻求专业帮助。" } } } // GAD7 分数评级规则 export function getGad7Level(score: number): {level: string, desc: string} { if (score <= 4) { return { level: "情绪平稳", desc: "近期心态平稳，焦虑感较低，状态良好。" } } else if (score <= 8) { return { level: "轻度焦虑", desc: "存在轻微焦虑情绪，多为生活压力导致，可通过放松、冥想、休息缓解。" } } else if (score <= 12) { return { level: "中度焦虑", desc: "焦虑感较为明显，容易胡思乱想、心神不宁，建议主动解压、规律作息。" } } else { return { level: "偏重焦虑", desc: "焦虑情绪较为突出，影响日常状态，建议及时调节、放松身心，必要时寻求专业疏导。" } } }

五、测评算法服务层封装

新建service/test_service.ets，封装答题计分、结果解析核心算法，彻底解耦页面与业务逻辑，页面只负责视图渲染。

/** * 测评核心算法服务 * 纯端侧离线计分、评级逻辑 */ import { PHQ9_QUESTIONS, GAD7_QUESTIONS, getPhq9Level, getGad7Level } from '../constant/test_const' // 获取题目列表 export function getQuestionList(type: 'phq9' | 'gad7'): string[] { return type === 'phq9' ? PHQ9_QUESTIONS : GAD7_QUESTIONS } // 计算总分并获取测评结果 export function calcTestResult(type: 'phq9' | 'gad7', answerList: number[]): {score: number, level: string, desc: string} { // 累加总分 let totalScore: number = 0 answerList.forEach(item => { totalScore += item }) // 根据类型匹配评级 if (type === 'phq9') { return { score: totalScore, ...getPhq9Level(totalScore) } } else { return { score: totalScore, ...getGad7Level(totalScore) } } }

六、答题页面完整 ArkTS 实战落地

基于全局公共组件、路由架构、存储能力，实现完整答题交互逻辑：进度展示、题目切换、选项选择、禁止空题、完成跳转结果页。

/** * 测评答题页面 * 支持 PHQ9 / GAD7 双量表复用 * 实时计分、进度更新、题目切换 */ import { WarmCard, WarmButton } from '../components/common' import { RouteUtils } from '../utils/route_utils' import RoutePath from '../constant/route_const' import { getQuestionList, calcTestResult } from '../service/test_service' import { setStoreData } from '../utils/store_utils' import StoreKey from '../constant/store_key' @Entry @Component struct TestAnswerPage { // 测评类型 @State testType: 'phq9' | 'gad7' = 'phq9' // 当前题目下标 @State currentIndex: number = 0 // 答案数组记录 @State answerArr: number[] = [] // 题目列表 private questionList: string[] = [] aboutToAppear() { // 获取路由参数判断测评类型 const params = router.getParams() as {type: 'phq9' | 'gad7'} this.testType = params.type this.questionList = getQuestionList(this.testType) // 初始化答案数组补0 this.answerArr = new Array(this.questionList.length).fill(0) } // 选择当前题目分值 onSelectScore(score: number) { this.answerArr[this.currentIndex] = score } // 下一题 / 提交 nextStep() { // 判断是否未选择 if (this.answerArr[this.currentIndex] === undefined) { return } if (this.currentIndex < this.questionList.length - 1) { this.currentIndex++ } else { // 答完所有题目，计算结果、存储、跳转 const res = calcTestResult(this.testType, this.answerArr) // 本地存储测评结果 setStoreData(StoreKey.PHQ9_SCORE, res.score) setStoreData(StoreKey.TEST_LEVEL, res.level) setStoreData(StoreKey.TEST_DESC, res.desc) // 跳转结果页 RouteUtils.push(RoutePath.TEST_RESULT_PAGE, res) } } build() { Column() { // 顶部进度信息 this.TopProgressBar() // 题目卡片 this.QuestionCard() // 选项区域 this.OptionArea() Blank().layoutWeight(1) // 底部按钮 this.BottomBtn() } .width('100%') .height('100%') .padding(16) .backgroundColor('#F8FAFF') } // 顶部进度展示 @Builder TopProgressBar() { Row() { Text(`第${this.currentIndex + 1}题 / 共${this.questionList.length}题`) .fontSize(14) .fontColor('#666') Blank().layoutWeight(1) Text('进度 ' + Math.round(((this.currentIndex + 1) / this.questionList.length) * 100) + '%') .fontSize(14) .fontColor('#7FB8F7') } .width('100%') } // 题目展示卡片 @Builder QuestionCard() { WarmCard() { Text(this.questionList[this.currentIndex]) .fontSize(16) .fontWeight(FontWeight.Medium) .lineHeight(26) } .margin({ top: 20 }) } // 选项区域 @Builder OptionArea() { Column({ space: 12 }) { ForEach([ { score: 0, text: "完全没有" }, { score: 1, text: "偶尔几天" }, { score: 2, text: "一半以上天数" }, { score: 3, text: "几乎每天" } ], item => { WarmCard() { Text(item.text) .fontSize(15) .fontColor(this.answerArr[this.currentIndex] === item.score ? '#7FB8F7' : '#333') } .onClick(() => this.onSelectScore(item.score)) }) } .margin({ top: 20 }) } // 底部按钮 @Builder BottomBtn() { Row({ space: 12 }) { if (this.currentIndex > 0) { WarmButton({ text: "上一题", primary: false, onClick: () => this.currentIndex-- }) .layoutWeight(1) } WarmButton({ text: this.currentIndex < this.questionList.length - 1 ? "下一题" : "提交查看结果", primary: true, onClick: () => this.nextStep() }) .layoutWeight(1) } .width('100%') .margin({ bottom: 20 }) } }

七、测评结果页实现与数据回显

结果页接收路由参数，展示分数、情绪评级、改善建议，同时数据落地本地存储，支持后续历史记录查询。

/** * 测评结果展示页面 * 展示分数、情绪等级、治愈建议 */ import { WarmCard, WarmButton } from '../components/common' import { RouteUtils } from '../utils/route_utils' @Entry @Component struct TestResultPage { @State score: number = 0 @State level: string = '' @State desc: string = '' aboutToAppear() { const params = router.getParams() as {score: number, level: string, desc: string} this.score = params.score this.level = params.level this.desc = params.desc } build() { Column() { Text("测评结果") .fontSize(20) .fontWeight(FontWeight.Bold) .margin({ top: 30 }) WarmCard() { Column({ space: 15 }) { Text(`综合得分：${this.score} 分`) .fontSize(18) .fontWeight(FontWeight.Medium) Text(`情绪状态：${this.level}`) .fontSize(16) .fontColor('#7FB8F7') Text(this.desc) .fontSize(14) .fontColor('#666') .lineHeight(24) } .width('100%') .alignItems(HorizontalAlign.Center) } .margin({ top: 20 }) Blank().layoutWeight(1) WarmButton({ text: "返回首页", primary: true, onClick: () => RouteUtils.clearAllPush(RoutePath.INDEX_PAGE) }) .margin({ bottom: 30 }) } .width('100%') .height('100%') .padding(16) .backgroundColor('#F8FAFF') } }