wecom-ai-assistant/docs/phase5.md

Phase 5：会话入库 + 后台可看

新增内容

• 回调入库：WeCom POST 回调解析到客户消息后，get_or_create_session + add_message（user/assistant）写入 DB。
• 会话列表：GET /api/sessions 从 chat_sessions 表读取，需 Bearer token。
• 消息列表：GET /api/sessions/{session_id}/messages 从 messages 表读取，需 Bearer token。

验证

1. 配置好 WeCom 回调 URL、Token、EncodingAESKey，并确保回调可访问（公网或 ngrok）。
2. 在企微侧给应用发一条文本消息，触发 POST 回调。
3. 管理后台登录后打开「会话列表」，应出现一条会话；点「查看消息」应看到用户消息与机器人 echo 回复。

关键点

• 外部客户仅使用 public 知识；回调中只存消息内容与 external_user_id，不落内部配置。
• 会话以 external_user_id（企微 FromUserName）唯一，同一客户多条消息归同一会话。