返回开发日志

2026-09-25

完整问卷映射、正式权重与结果分析流程

更新 EQAI 完整问卷映射,统一正式计分配置、Knowledge Base 固化复用和百分比结果分析流程。

---

date: 2026-09-25

author: Tony

---

完整问卷映射、正式权重与结果分析流程

KL 已明确区分公开入口、EQAI 正式量表和完整问卷结果。目前三个已开放入口对应:

  • eq:EQAI负面情绪管理量表,共 33 题;
  • stress:EQAI人际关系社交压力问卷,共 41 题;
  • relationship:EQAI社交能力自评量表,共 50 题。

目录中的 4、6、7 题短分量表仍可用于推荐入口展示,但不会被当成完整结果的题目集合。

维度和题目身份

每道题所属维度来自 EQAI assessment result JSON 的 dimension 字段。KL 不让 AI 创建、改名或移动维度。题目身份优先使用全局唯一的 question_id,缺失时才使用 item_code。

权重来源调整

KL 已取消并删除由 DeepSeek 自行分配每题权重的机制。当前只接受 EQAI 返回的:

1. 正式 scoring_configuration; 2. 经验心理测量配置 empirical_scoring_configuration。

正式规则优先于经验配置。两者都不存在时,系统暂时采用维度内等权:如果某个维度有 N 道题,每题权重为 1/N。该临时规则由 KL 确定性计算,不调用 AI,也不会写入 Knowledge Base 冒充正式配置。

校验成功的正式或经验配置可以写入运行时 assessment-knowledge-base.json,身份由 EQAI scale slug、version ID 和完整题目集合 hash 共同决定。相同版本后续复用同一份配置,保证结果可重复。

本次变更同时清空了开发环境 Knowledge Base 中之前生成的 AI 权重。生产环境的持久化 KB 需要在部署时单独、明确地清理,构建流程不会覆盖运行时文件。

分数计算与显示

每个维度内的正式题目权重会归一化为总和 1.00。单题贡献公式为:

正向题有效分 = 原始得分 X
反向题有效分 = 8 - 原始得分 X
单题贡献 = (有效分 ÷ 7) × 该题 weight

维度得分是该维度全部单题贡献之和,最高为 1。综合得分对全部维度等权取平均:

综合得分 = 所有维度得分之和 ÷ 维度总数

综合得分和每个维度得分统一转换为百分比,精确显示到 0.1%。结果页的 AI 简短分析和 KL Chat 使用同一份确定性分数,不再直接累加原始题目分数,也不会让 AI 重新生成另一套分数。

当前 EQAI 返回字段检查

KL 当前接收的单题字段包括题目 ID、题目文本、维度、1–7 分、分数范围、答案选项和反向计分标记。当前契约中没有读取单题 weight 字段;权重只能从顶层 scoring_configuration 或 empirical_scoring_configuration 进入。

因此,在 EQAI 正式返回计分配置前,KL 会明确使用临时维度内等权结果,并在页面标注其计算口径。结果页先展示以综合环形分数、维度雷达图、维度条形对比和高低维度提示组成的可视化简报;下方提供可点击展开的详细 AI 分析报告。