\r \r

Psycho Assess - 专业心理测评\r

\r

Overview\r

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

量表清单\r

\r | 量表 | 题目数 | 评估维度 | 评估周期 |\r |------|--------|----------|----------|\r | PHQ-9 | 9题 | 抑郁症状 | 过去2周 |\r | GAD-7 | 7题 | 焦虑症状 | 过去2周 |\r | PSS-10 | 10题 | 压力感知 | 过去1个月 |\r | RSES | 10题 | 自尊水平 | 整体感受 |\r | BFI-10 | 10题 | 大五人格 | 一般特征 |\r \r 全套测评共46题，预计完成时间10-15分钟。\r \r

工作流程\r

\r

Step 1: 确定测评范围\r

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

• "全套测评" (46题，10-15分钟) — 最全面的心理画像\r
• 指定量表 — 如"我想测抑郁" → PHQ-9；"测焦虑" → GAD-7\r \r 用户说"随便"或没有指定时，默认推荐全套测评。\r \r

Step 2: 逐量表交互式答题\r

\r 量表题目和选项数据从 references/scales.md 读取。\r \r 答题规则：\r

• 逐量表推进：完成一个量表的所有题目后再进入下一个\r
• 每道题展示：题目编号、题目文本、选项（带分值）\r
• 确认答题：用户输入选项编号（如 0/1/2/3）或选择文字\r
• 记录答案：以 JSON 数组格式记录每道题的分值\r
• 显示进度：如 "PHQ-9: 3/9 已完成"\r \r 答题过程中的重要提醒：\r
• 提醒用户根据指导语的时间范围作答（PHQ-9/GAD-7是"过去两周"，PSS-10是"过去一个月"）\r
• 量表间切换时，先展示新量表的指导语\r
• 全程保持中立、专业的态度，不对答案做任何评判\r \r

Step 3: 评分计算\r

\r 所有题目完成后，使用 scripts/score_engine.py 计算得分：\r \r 单个量表：\r

python scripts/score_engine.py --scale PHQ-9 --answers '[0,2,1,3,1,0,2,1,0]'\r
```\r
\r
**全套测评：**\r
```bash\r
python scripts/score_engine.py --all --answers '{"PHQ-9":[0,2,1,3,...],"GAD-7":[...],...}'\r
```\r
\r
评分引擎自动处理：\r
- PHQ-9/GAD-7：直接求和，对照临床阈值\r
- PSS-10：自动反向计分（第4、5、6、7、9、10题）\r
- RSES：自动反向计分（第2、5、6、8、9题）\r
- BFI-10：反向计分 + 按五维度分别计算均值\r
- PHQ-9第9题（自伤念头）：任何非0回答自动触发高危标记\r
\r
### Step 4: 生成可视化报告\r
\r
使用评分结果生成HTML报告：\r
\r
```bash\r
python scripts/generate_report.py --results-file '\x3Cjson_path>' --output psycho_report.html\r
```\r
\r
报告包含：\r
- 测评概览（各量表得分与严重程度一瞥）\r
- 每个量表的详细解读（得分圆环 + 进度条 + 临床阈值 + AI解读）\r
- 大五人格雷达图（SVG，显示五维度分布）\r
- 大五人格维度卡片\r
- 高危信号预警（红色/橙色/黄色分级）\r
- 个性化综合建议\r
- 心理援助热线\r
- 免责声明\r
\r
### Step 5: 呈现报告\r
\r
- 使用 `preview_url` 展示HTML报告\r
- 使用 `deliver_attachments` 交付报告文件\r
- 口头总结关键发现（1-2句话），引导用户查看完整报告\r
\r
**注意**：如果PHQ-9得分≥15或GAD-7得分≥15或PHQ-9第9题>0，必须在口头回复中强调"强烈建议寻求专业帮助"，并附上心理援助热线。\r
\r
## 特殊处理规则\r
\r
### PHQ-9 第9题高危标记\r
PHQ-9第9题（"有不如死掉或用某种方式伤害自己的念头"）的任何非0回答（即回答≥1），无论总分为多少，都必须在结果中标注为高危信号。评分引擎自动检测并在JSON中返回 `q9_warning: true`。\r
\r
### 质量控制\r
- 如果用户答案出现"全0"或"全最高分"的模式，可以提醒用户确认是否认真作答，但不强制要求重新作答\r
- 提醒用户这是一个筛查工具，不是诊断工具\r
\r
### 隐私保护\r
- 不在报告中显示"你可以跟别人分享"之类的建议\r
- 强调这是一个私密的自我了解工具\r
\r
## 资源文件\r
\r
### scripts/score_engine.py\r
评分计算引擎，支持单量表和全套测评的计分、阈值对照、反向计分、多维度计算。\r
\r
### scripts/generate_report.py\r
HTML报告生成器，将评分结果JSON注入模板生成完整可视化报告，含SVG雷达图。\r
\r
### references/scales.md\r
5个专业量表的完整数据：题目文本、选项、计分规则、临床阈值、解读模板。\r
\r
### assets/report_template.html\r
HTML报告模板，包含CSS样式、布局结构，通过 `{{PLACEHOLDER}}` 注入动态内容。\r