Psycho Assess - 专业心理测评
Overview
提供基于国际标准心理量表的专业心理测评服务。支持单量表测评或全套5量表综合测评，交互式答题后自动计算得分、对照临床阈值、生成可视化HTML评估报告。
量表清单
| 量表 | 题目数 | 评估维度 | 评估周期 |
|---|---|---|---|
| PHQ-9 | 9题 | 抑郁症状 | 过去2周 |
| GAD-7 | 7题 | 焦虑症状 | 过去2周 |
| PSS-10 | 10题 | 压力感知 | 过去1个月 |
| RSES | 10题 | 自尊水平 | 整体感受 |
| BFI-10 | 10题 | 大五人格 | 一般特征 |
全套测评共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 计算得分：
单个量表：
python scripts/score_engine.py --scale PHQ-9 --answers '[0,2,1,3,1,0,2,1,0]'
全套测评：
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报告：
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}} 注入动态内容。
