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

一、前言

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

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

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

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

2.1 双量表选型依据

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

• PHQ-9 抑郁筛查量表：共9道题目，针对抑郁情绪、低落状态、行为状态进行量化评分，适合日常自我情绪筛查；

• GAD-7 焦虑筛查量表：共7道题目，针对紧张、焦虑、惶恐、失眠等焦虑状态量化评估，题型轻量化、适配移动端自测场景。

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

2.2 核心业务流程设计

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

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

2.3 核心功能亮点

• 纯离线运算：计分、评级全部端侧算法完成，无需联网、无后端接口依赖；

• 实时动态计分：答题过程实时累加分数，进度动态更新；

• 分级结果展示：根据分数区间区分正常、轻度、中度、偏重情绪状态；

• 隐私可控存储：测评数据本地私有存储，用户可自主清空，无隐性留存；

• 交互轻量化：上一题、下一题、快速重测、进度记忆，适配移动端操作习惯。

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

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

1. 数据层（constant）：统一维护 PHQ-9、GAD-7 题库、分数区间、评级文案常量；

2. 算法层（service）：封装通用计分算法、情绪评级算法、结果匹配逻辑；

3. 视图层（pages/components）：答题页面、进度组件、结果卡片、测评列表复用公共组件；

4. 存储层（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')
  }
}
    

八、模块核心优势与上架优化点

8.1 纯端侧离线运算，合规安全

所有计分、评级逻辑全部本地算法完成，无网络请求、无数据上传，从根源规避用户情绪隐私泄露风险，完全契合华为应用市场隐私合规标准。

8.2 业务高度解耦，扩展性极强

题库、算法、视图、存储完全分层，后续新增其他心理量表，仅需新增题库常量与评级规则，无需改动页面与核心逻辑，可插拔式迭代。

8.3 交互体验精细化打磨

支持上一题回退修改、实时进度展示、选项高亮选中、空题拦截提示，交互逻辑闭环，无操作BUG，适配全年龄段用户使用习惯。

8.4 数据隐私可控

测评数据仅存储应用私有目录，用户可在个人中心一键清空所有测评记录，无隐性留存，完全满足隐私最小化原则。

九、开发踩坑复盘（实战避坑）

9.1 数组初始空值导致计分异常

问题：初始答案数组为空，未作答题目为 undefined，导致总分计算 NaN 报错。

解决：页面初始化时根据题目数量自动补0，保证每道题默认有初始分值，杜绝计算异常。

9.2 切换量表题库错乱

问题：双量表复用同一页面，缓存未重置导致题目错乱、分数叠加错误。

解决：页面每次进入重新获取参数、重置题库与答案数组，保证量表数据隔离。

9.3 未做未答拦截导致数据缺失

问题：用户跳过题目直接提交，部分题目无分数，测评结果不准确。

解决：强制判断当前题目的选择状态，未选择无法进入下一题，保证测评完整性。

9.4 页面栈堆积导致重复测评

问题：多次进入测评页面会叠加页面栈，返回逻辑混乱。

解决：沿用全局路由规范，结果页返回采用清空栈跳转，保证页面层级干净。

十、本篇总结与下篇预告

本篇我们完整落地了心晴驿站核心业务------双量表心理测评模块，实现了 PHQ-9、GAD7 两套专业量表的完整答题流程、端侧实时计分、智能情绪评级、结果本地存储、路由跳转闭环。全程基于 ArkTS 原生开发，复用项目架构、路由、组件、存储能力，代码规范、交互完善、隐私合规、可直接上线使用。

测评模块的落地，标志着项目核心治愈业务体系基本成型，隐私树洞、心理测评两大核心亮点功能全部完成开发。

下篇预告（第十篇） ：治愈游戏模块实战开发，从零实现解压泡泡、彩虹收集、雨声冥想、涂色治愈四大轻量化交互功能，详解鸿蒙动画交互、触摸事件、帧动画优化与低功耗适配方案。