child-psycho-companion/README.md

儿童心理陪伴玩偶

基于小智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. 安装

cd child-psycho-companion
pip install -e .

2. 配置 API Key

export MINIMAX_API_KEY=your-api-key-here

3. 使用示例

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. 运行测试

# 安装测试依赖
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 接入点
• 构建案例库系统
• 开发咨询师终端
• 家长端报告界面