108 lines
2.8 KiB
Markdown
108 lines
2.8 KiB
Markdown
|
# 儿童心理陪伴玩偶
|
|||
|
|
|
|||
|
|
基于小智AI生态的儿童心理筛查插件，通过分析儿童与玩偶的对话内容，
|
|||
|
|
识别潜在的心理问题（如霸凌、抑郁情绪、焦虑、家庭矛盾等），
|
|||
|
|
为家长提供早期预警。
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
child-psycho-companion/
|
|||
|
|
├── src/
|
|||
|
|
│ └── psycho_screener/ # 核心筛查模块
|
|||
|
|
│ ├── __init__.py
|
|||
|
|
│ └── screener.py # 筛查器实现
|
|||
|
|
├── tests/
|
|||
|
|
│ ├── __init__.py
|
|||
|
|
│ ├── conftest.py
|
|||
|
|
│ └── test_screener.py # 单元测试
|
|||
|
|
├── .env.example # 环境变量模板
|
|||
|
|
├── pyproject.toml
|
|||
|
|
└── README.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 1. 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd child-psycho-companion
|
|||
|
|
pip install -e .
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 配置 API Key
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
export MINIMAX_API_KEY=your-api-key-here
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 使用示例
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
from psycho_screener import PsychoScreener
|
|||
|
|
|
|||
|
|
screener = PsychoScreener(api_key="your-api-key")
|
|||
|
|
|
|||
|
|
# 对儿童对话进行筛查
|
|||
|
|
context = """
|
|||
|
|
孩子：今天在学校，小明又打我了，我好害怕。
|
|||
|
|
孩子：他说如果我告诉老师就会打我。
|
|||
|
|
"""
|
|||
|
|
result = screener.screen(context)
|
|||
|
|
|
|||
|
|
if result.detected:
|
|||
|
|
print(f"检测到问题：{result.summary}")
|
|||
|
|
prefix = screener.build_response_prefix(result)
|
|||
|
|
print(f"响应前缀：{prefix}")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. 运行测试
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 安装测试依赖
|
|||
|
|
pip install -e ".[dev]"
|
|||
|
|
|
|||
|
|
# 运行单元测试（Mock 模式，不调用真实 API）
|
|||
|
|
pytest tests/test_screener.py -v -m unit
|
|||
|
|
|
|||
|
|
# 运行集成测试（需要真实 API key）
|
|||
|
|
export MINIMAX_API_KEY=your-key
|
|||
|
|
pytest tests/test_screener.py -v -m integration
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 核心流程
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
儿童语音 → 小智AI (STT) → 对话上下文
|
|||
|
|
↓
|
|||
|
|
心理筛查器 (MiniMax API)
|
|||
|
|
↓
|
|||
|
|
ScreeningResult {detected, category, severity}
|
|||
|
|
↓
|
|||
|
|
┌───────────┴───────────┐
|
|||
|
|
detected=True detected=False
|
|||
|
|
↓ ↓
|
|||
|
|
注入前缀标记 原样返回
|
|||
|
|
"已发现特定心理问题：..."
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 检测类别
|
|||
|
|
|
|||
|
|
| 类别 | 描述 | 严重程度 |
|
|||
|
|
|------|------|---------|
|
|||
|
|
| bullying | 霸凌/同伴冲突 | low-high |
|
|||
|
|
| depression | 抑郁情绪 | medium-high |
|
|||
|
|
| anxiety | 焦虑/恐惧 | low-medium |
|
|||
|
|
| family_conflict | 家庭矛盾 | medium-high |
|
|||
|
|
| self_esteem | 自卑/自我否定 | low-medium |
|
|||
|
|
| trauma | 创伤事件 | medium-high |
|
|||
|
|
| social_isolation | 社交孤立 | medium-high |
|
|||
|
|
| other | 其他心理需求 | - |
|
|||
|
|
|
|||
|
|
## 下一步
|
|||
|
|
|
|||
|
|
- [ ] 接入 xinnan-tech/xiaozhi-esp32-server MCP 接入点
|
|||
|
|
- [ ] 构建案例库系统
|
|||
|
|
- [ ] 开发咨询师终端
|
|||
|
|
- [ ] 家长端报告界面
|