Psycho Assess - 专业心理测评#

Overview#

提供基于国际标准心理量表的专业心理测评服务。支持单量表测评或全套5量表综合测评，交互式答题后自动计算得分、对照临床阈值、生成可视化HTML评估报告。

量表清单#

量表题目数评估维度评估周期PHQ-99题抑郁症状过去2周GAD-77题焦虑症状过去2周PSS-1010题压力感知过去1个月RSES10题自尊水平整体感受BFI-1010题大五人格一般特征

全套测评共46题，预计完成时间10-15分钟。

工作流程#

Step 1: 确定测评范围#

向用户说明可用的5个量表，询问要做的测评：

• "全套测评" (46题，10-15分钟) — 最全面的心理画像
• 指定量表 — 如"我想测抑郁" → PHQ-9；"测焦虑" → GAD-7

用户说"随便"或没有指定时，默认推荐全套测评。

Step 2: 逐量表交互式答题#

量表题目和选项数据从 references/scales.md 读取。

答题规则：

• 逐量表推进：完成一个量表的所有题目后再进入下一个
• 每道题展示：题目编号、题目文本、选项（带分值）
• 确认答题：用户输入选项编号（如 0/1/2/3）或选择文字
• 记录答案：以 JSON 数组格式记录每道题的分值
• 显示进度：如 "PHQ-9: 3/9 已完成"

答题过程中的重要提醒：

• 提醒用户根据指导语的 时间范围 作答（PHQ-9/GAD-7是"过去两周"，PSS-10是"过去一个月"）
• 量表间切换时，先展示新量表的指导语
• 全程保持中立、专业的态度，不对答案做任何评判

Step 3: 评分计算#

所有题目完成后，使用 scripts/score_engine.py 计算得分：

单个量表：

bash

python scripts/score_engine.py --scale PHQ-9 --answers '[0,2,1,3,1,0,2,1,0]'

全套测评：

bash

python scripts/score_engine.py --all --answers '{"PHQ-9":[0,2,1,3,...],"GAD-7":[...],...}'

评分引擎自动处理：

• PHQ-9/GAD-7：直接求和，对照临床阈值
• PSS-10：自动反向计分（第4、5、6、7、9、10题）
• RSES：自动反向计分（第2、5、6、8、9题）
• BFI-10：反向计分 + 按五维度分别计算均值
• PHQ-9第9题（自伤念头）：任何非0回答自动触发高危标记

Step 4: 生成可视化报告#

使用评分结果生成HTML报告：

bash

python scripts/generate_report.py --results-file '<json_path>' --output psycho_report.html

报告包含：

• 测评概览（各量表得分与严重程度一瞥）
• 每个量表的详细解读（得分圆环 + 进度条 + 临床阈值 + AI解读）
• 大五人格雷达图（SVG，显示五维度分布）
• 大五人格维度卡片
• 高危信号预警（红色/橙色/黄色分级）
• 个性化综合建议
• 心理援助热线
• 免责声明

Step 5: 呈现报告#

• 使用 preview_url 展示HTML报告
• 使用 deliver_attachments 交付报告文件
• 口头总结关键发现（1-2句话），引导用户查看完整报告

注意：如果PHQ-9得分≥15或GAD-7得分≥15或PHQ-9第9题>0，必须在口头回复中强调"强烈建议寻求专业帮助"，并附上心理援助热线。

特殊处理规则#

PHQ-9 第9题高危标记#

PHQ-9第9题（"有不如死掉或用某种方式伤害自己的念头"）的任何非0回答（即回答≥1），无论总分为多少，都必须在结果中标注为高危信号。评分引擎自动检测并在JSON中返回 q9_warning: true。

质量控制#

• 如果用户答案出现"全0"或"全最高分"的模式，可以提醒用户确认是否认真作答，但不强制要求重新作答
• 提醒用户这是一个筛查工具，不是诊断工具

隐私保护#

• 不在报告中显示"你可以跟别人分享"之类的建议
• 强调这是一个私密的自我了解工具

资源文件#

scripts/score_engine.py#

评分计算引擎，支持单量表和全套测评的计分、阈值对照、反向计分、多维度计算。

scripts/generate_report.py#

HTML报告生成器，将评分结果JSON注入模板生成完整可视化报告，含SVG雷达图。

references/scales.md#

5个专业量表的完整数据：题目文本、选项、计分规则、临床阈值、解读模板。

assets/report_template.html#

HTML报告模板，包含CSS样式、布局结构，通过 {{PLACEHOLDER}} 注入动态内容。