心理健康智能助手

┌─────────────────────────────────────────────────────────┐
│                    Gradio Web UI (app.py)               │
│  ┌──────┬──────┬──────┬──────┬──────┬──────┬──────┐   │
│  │登录  │对话  │评估  │放松  │日记  │统计  │管理  │   │
│  └──────┴──────┴──────┴──────┴──────┴──────┴──────┘   │
└───────────────────────┬─────────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────────┐
│                   应用层 (api/apps/)                     │
│  ┌────────────┬────────────┬────────────┬────────────┐ │
│  │conversation│ emotion    │ sas        │ relaxation │ │
│  │_app.py     │ _app.py    │ _app.py    │ _app.py    │ │
│  ├────────────┼────────────┼────────────┼────────────┤ │
│  │statistics  │ user       │ admin      │            │ │
│  │_app.py     │ _app.py    │ _app.py    │            │ │
│  └────────────┴────────────┴────────────┴────────────┘ │
└───────────────────────┬─────────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────────┐
│              服务层 (api/db/services/)                   │
│  ┌─────────────────────────────────────────────────┐   │
│  │ UserService | EmotionService | ConversationSvc │   │
│  │ AssessmentService                               │   │
│  └─────────────────────────────────────────────────┘   │
└───────────────────────┬─────────────────────────────────┘
                        │
┌───────────────────────▼─────────────────────────────────┐
│              数据层 (api/db/db_models.py)                │
│  ┌─────────────────────────────────────────────────┐   │
│  │ User | Emotion | Conversation | Assessment      │   │
│  └─────────────────────────────────────────────────┘   │
│                   SQLite (mindmate.db)                   │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│              外部集成 (api/tools/)                        │
│  ┌─────────────────────────────────────────────────┐   │
│  │ web_search_tools.py  - 智谱Z.AI语义搜索         │   │
│  │ mcp_search.py        - 百度地图MCP工具集        │   │
│  │ amap_rest_tools.py   - 高德地图REST API         │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│                 AI引擎 (CAMEL-AI)                        │
│  ┌─────────────────────────────────────────────────┐   │
│  │ ChatAgent | RolePlaying | Tools | ModelFactory │   │
│  └─────────────────────────────────────────────────┘   │
│         ↓ 调用 OpenAI Compatible API                    │
│  ┌─────────────────────────────────────────────────┐   │
│  │ DeepSeek-V3 / Qwen2.5 / 其他兼容模型           │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

resonant-soul-main/
├── api/                          # 后端核心代码
│   ├── apps/                     # 应用模块
│   │   ├── admin_app.py          # 管理员功能（用户管理）
│   │   ├── conversation_app.py   # 对话引擎（ChatAgent + 工具调用）
│   │   ├── emotion_app.py        # 情绪分析（关键词+LLM兜底+日记分析）
│   │   ├── relaxation_app.py     # 放松规划（意图识别+地图工具）
│   │   ├── sas_app.py            # SAS量表（反向计分+维度分析+LLM建议）
│   │   ├── statistics_app.py     # 统计分析（Agent化+暖色图表）
│   │   └── user_app.py           # 用户认证（登录/注册/密码修改）
│   ├── db/                       # 数据库层
│   │   ├── db_models.py          # ORM模型定义
│   │   ├── init_data.py          # 初始化数据（管理员账号）
│   │   └── services/             # 数据服务层
│   │       ├── assessment_service.py   # 评估CRUD+统计
│   │       ├── conversation_service.py # 对话CRUD+统计
│   │       ├── emotion_service.py      # 情绪CRUD+统计
│   │       └── user_service.py         # 用户CRUD+认证
│   ├── tools/                    # 外部工具集成
│   │   ├── amap_rest_tools.py    # 高德地图REST API
│   │   ├── mcp_search.py         # 百度地图MCP工具（8个工具函数）
│   │   └── web_search_tools.py   # 智谱Z.AI语义搜索
│   ├── utils/                    # 工具函数
│   │   ├── file_utils.py         # 文件操作
│   │   ├── log_utils.py          # 日志配置
│   │   └── t_crypt.py            # 加密解密
│   ├── constants.py              # 常量定义
│   └── settings.py               # 全局配置（模型初始化）
├── conf/                         # 配置文件
│   └── service_conf.yaml         # LLM配置、管理员账号
├── docker/                       # Docker部署
│   └── entrypoint.sh             # 容器启动脚本
├── logs/                         # 日志目录
├── resources/                    # 资源文件（截图）
├── test/                         # 测试用例
│   └── test_emotion_app.py       # 情绪分析单元测试
├── app.py                        # 主入口（Gradio界面）
├── Dockerfile                    # Docker镜像构建
├── pyproject.toml                # 项目元数据+依赖
├── requirements.txt              # pip依赖列表
├── uv.lock                       # uv依赖锁定
├── mindmate.db                   # SQLite数据库文件
└── README.md                     # 项目说明

用户输入
  ↓
情绪分析（关键词匹配 + LLM兜底）
  ↓
保存情绪记录到数据库
  ↓
构造系统提示词（包含当前情绪）
  ↓
负面情绪？→ 调用 supportive_case_search_tool 检索资源
  ↓
创建 ChatAgent（注入历史对话+检索结果）
  ↓
调用 agent.step() 生成回复
  ↓
后处理（移除第三人称表述）
  ↓
保存对话记录 + 更新情绪图表

preferred = os.environ.get('SEARCH_PREFERRED', 'mcp').lower()
if preferred == 'sdk':
    tools = get_tools()  # 智谱SDK
else:
    tools = mcp_tools if mcp_tools else get_tools()  # 优先MCP

# 反向计分（第5题）
reverse_indices = [5]
processed_scores = [5-score if idx in reverse_indices else score 
                    for idx, score in enumerate(scores, 1)]

# 标准分计算
rough_score = sum(processed_scores)
standard_score = int(rough_score * 1.25)

dim_map = {
    "紧张-焦虑": [1],
    "恐惧-惊恐": [2, 3],
    "躯体化/解离": [4],
    "消极预期": [5],  # 已反向处理
}

取最近N条日记（时间倒序）
  ↓
构造提示词（包含日期、情绪、内容）
  ↓
调用 ChatAgent（CHAT_MDL）
  ↓
Agent输出：
  - 情绪趋势概括
  - 主要困扰主题（≤3点）
  - 可执行建议（3-5条，≤30字/条）
  - 温暖安慰话（第二人称）
  ↓
失败时规则兜底（统计主情绪+通用建议）

请基于以下同一用户最近的情绪日记做一个简明的综合分析，并给出温暖的安慰与3-5条可执行的小建议。
要求：
1) 概括最近情绪趋势（积极/焦虑/抑郁/愤怒/平静的比例与变化）
2) 提炼主要困扰主题（最多3点）
3) 给出3-5条具体可执行建议，每条≤30字
4) 用第二人称、温暖口吻收尾给出一段安慰话
5) 全文中文，避免医学诊断与药物建议，不夸大承诺
6) 只依据提供的日记做推断，不要编造

【日记（按时间从近到远）】
- 2025-10-24 15:04:51 | 情绪：焦虑, 抑郁 | 内容：我的计算机实验又失败了...
- 2025-10-24 14:44:41 | 情绪：焦虑, 抑郁 | 内容：我的计算机实验失败了...
...

intent_map = {
    "food": "美食|餐厅|小吃|咖啡",
    "relax": "足浴|足疗|修脚|按摩|推拿|SPA|汗蒸|网吧|KTV|休闲",
    "sport": "健身|球馆|体育馆|羽毛球|篮球|游泳|网球|乒乓",
}

fig, (ax1, ax2, ax3) = plt.subplots(1, 3, figsize=(15, 5))

# 柱状图（情绪分布）
warm_bar_colors = ["#F4A261", "#E76F51", "#E9C46A", "#F28482", "#FFB703"]

# 饼图（评估结果）
warm_pie_colors = ["#FFE0B2", "#FFCC80", "#FFB74D", "#FFA726", "#FB8C00"]

# 折线图（对话趋势）
warm_line = "#E76F51"

def stats_snapshot_tool(user_id: int, days: int = 7) -> Dict[str, Any]:
    """返回紧凑统计快照（纯文本/数字），供Agent分析"""
    return {
        "days": days,
        "total_emotions": {...},
        "daily_emotions": {...},
        "assessment_result_distribution": {...},
        "conversations_total": 11,
        "conversations_daily_counts": {...},
    }

你是一位温暖、专业的心理支持助理。你可以调用工具获取用户最近统计信息，
请基于工具返回的快照，总结趋势、给出3-5条可执行建议，并以温柔口吻收尾。
避免医学诊断与药物建议，输出简洁 Markdown。

请使用 stats_snapshot_tool(user_id=2, days=7) 获取数据后，再输出：
1) 情绪趋势（1-2句）
2) 关键观察（最多3点）
3) 温暖建议（3-5条，每条≤25字）
4) 鼓励收尾（1-2句）

### 使用统计简析
- 最近7天主要情绪：焦虑
- 期间对话次数：11

### 温暖建议
- 记录每天一个小确幸，睡前复盘1分钟
- 进行3分钟呼吸放松，缓解紧张
- 找到一位可信任的朋友聊聊
- 安排一次短途散步，给自己放个小假

你已经很努力了，保持当下的节奏，我们一起慢慢变好。

llm:
  model_type: 'deepseek-ai/DeepSeek-V3'  # 或 'Qwen/Qwen2.5-7B-Instruct'
  model_url: 'https://api.siliconflow.cn/v1/'
  api_key: 'sk-your-api-key-here'

admin:
  username: 'admin'
  password: 'admin@123'
  name_nick: '系统管理员'

# 搜索工具选择
export SEARCH_PREFERRED=mcp  # 或 sdk

# 百度地图API密钥（用于MCP工具）
export BAIDU_MAPS_API_KEY=your_baidu_key

# 智谱API密钥（用于Z.AI搜索）
export ZHIPU_API_KEY=your_zhipu_key
export ZAI_CHAT_MODEL=glm-4.6

# 1. 安装UV包管理器
pip install uv
set UV_INDEX=https://mirrors.aliyun.com/pypi/simple

# 2. 创建虚拟环境并安装依赖
uv sync --python 3.10 --all-extras

# 3. 激活虚拟环境
cd .venv/Scripts
activate  # Windows
# source .venv/bin/activate  # Linux/Mac

python app.py

uv pip compile pyproject.toml --all-extras -o requirements.txt

from api.utils.t_crypt import encrypt_api_key, decrypt_api_key, generate_key

# 加密存储
key = generate_key()
encrypted = encrypt_api_key(api_key, key)

# 使用时解密
api_key = decrypt_api_key(encrypted, key)

# 运行所有测试
pytest

# 运行特定测试文件
pytest test/test_emotion_app.py -v

# 测试覆盖率
pytest --cov=api --cov-report=html

# test/test_emotion_app.py
@pytest.mark.parametrize("text, expected_emotion", [
    ("我今天很开心", ["积极"]),
    ("我感到很焦虑", ["焦虑"]),
    ("他非常愤怒", ["愤怒"]),
    ("她有点抑郁", ["抑郁"]),
])
def test_analyze_emotion_single_emotion(text, expected_emotion):
    """测试单个情绪识别"""
    assert analyze_emotion(text) == expected_emotion

# 日志配置（api/utils/log_utils.py）
from loguru import logger

logger.add(
    "logs/resonant-soul.{time:YYYY-MM-DD}.log",
    rotation="00:00",  # 每天午夜轮转
    retention="30 days",  # 保留30天
    level="INFO"
)

# 定时备份SQLite
cp mindmate.db backups/mindmate_$(date +%Y%m%d_%H%M%S).db

# 保留最近30天备份
find backups/ -name "mindmate_*.db" -mtime +30 -delete

# 添加健康检查端点（待实现）
@app.get("/health")
def health_check():
    return {
        "status": "healthy",
        "db_connected": check_db_connection(),
        "model_loaded": CHAT_MDL is not None,
    }