Chat API

所有 Chat API 需要 Bearer Token 认证。

会话管理

获取会话列表

GET /api/chat/sessions?target_type=&limit=20&offset=0

创建会话

POST /api/chat/sessions
Body: { "title": "新对话", "target_type": "ai", "target_id": "" }

删除会话

DELETE /api/chat/sessions/{session_id}

消息收发

发送消息

POST /api/chat/send
Body: { "content": "你好", "images": [], "session_id": "abc", "target_type": "ai" }
Response: { "message_id": "uuid" }

SSE 流式响应

GET /api/chat/stream/{message_id}?token=jwt

中断生成

POST /api/chat/abort
Body: { "message_id": "uuid" }

未读管理

标记已读

POST /api/chat/mark-read
Body: { "session_id": "abc" }

获取未读计数

GET /api/chat/unread-counts
Response: { "counts": { "session_1": 3, "session_2": 1 } }

任务管理

活跃任务列表

GET /api/chat/active-tasks

取消任务

POST /api/chat/tasks/{task_id}/cancel

追加消息

POST /api/chat/tasks/{task_id}/message
Body: { "content": "重点看安全部分" }

重连任务流

GET /api/chat/task/{task_id}/stream

消息搜索

搜索消息

GET /api/chat/messages/search?q=keyword&session_id=&limit=20

分页加载

GET /api/chat/messages?session_id=abc&before=2026-03-15T00:00:00&limit=50

联系人

联系人列表

GET /api/chat/contacts

发起聊天

POST /api/chat/contacts/start
Body: { "member_id": "m001" }