feat: 工作台聊天室功能

docs/development/backend.md

@@ -62,7 +62,7 @@ middleware.ts 提供 API 参数校验函数：
 
 ### 数据访问
 
-`src/server/db/projects.ts` 提供项目数据访问函数，`src/server/db/providers.ts` 提供供应商数据访问函数，`src/server/db/models.ts` 提供模型数据访问函数。输入输出使用 `src/shared/api.ts` 的类型。函数内部使用 Drizzle query builder 包装 `bun:sqlite` Database。
+`src/server/db/projects.ts` 提供项目数据访问函数，`src/server/db/providers.ts` 提供供应商数据访问函数，`src/server/db/models.ts` 提供模型数据访问函数，`src/server/db/conversations.ts` 提供会话和消息数据访问函数。输入输出使用 `src/shared/api.ts` 的类型。函数内部使用 Drizzle query builder 包装 `bun:sqlite` Database。
 
 ## AI 服务层
 
@@ -85,6 +85,10 @@ middleware.ts 提供 API 参数校验函数：
 
 每次 AI 调用时从 DB 查询 providers，构建 registry 后通过 `registry.languageModel('providerId:modelId')` 获取模型实例。不使用缓存层。模型是否存在以及业务能力标签由调用方基于 models 表先行校验，registry 只负责将 providerId/modelId 映射到 AI SDK 模型实例。
 
+### Agent 流式调用
+
+`src/server/ai/agent-stream.ts` 提供 `agentStream(options)` 函数，封装 Vercel AI SDK `streamText` 调用。接收数据库实例、消息数组和模型 DB ID，从 DB 查询模型与供应商信息后构建 Provider Registry，使用 `:` 作为 provider 和 modelId 的分隔符。默认使用 `stepCountIs(1)` 限制单步调用。返回 `StreamTextResult`，路由层通过 `result.toUIMessageStreamResponse()` 转为 SSE 响应。
+
 ### 供应商连通性测试
 
 供应商连通性测试返回 `{ providerTestResponse: { ok, message } }`，前端根据 `ok` 展示成功或失败提示。
@@ -102,6 +106,21 @@ middleware.ts 提供 API 参数校验函数：
 | `anthropic`         | `createAnthropic({ apiKey, baseURL })`              |
 | `openai-compatible` | `createOpenAICompatible({ name, apiKey, baseURL })` |
 
+## 聊天 API
+
+聊天 API 按项目维度组织会话和消息：
+
+| 方法   | 路径                                            | 说明               |
+| ------ | ----------------------------------------------- | ------------------ |
+| GET    | `/api/projects/:id/conversations`               | 列出项目下所有会话 |
+| POST   | `/api/projects/:id/conversations`               | 创建新会话         |
+| GET    | `/api/projects/:id/conversations/:cid`          | 获取会话详情       |
+| DELETE | `/api/projects/:id/conversations/:cid`          | 删除会话及其消息   |
+| GET    | `/api/projects/:id/conversations/:cid/messages` | 获取会话消息列表   |
+| POST   | `/api/projects/:id/chat`                        | 发送消息并流式回复 |
+
+聊天路由处理器位于 `src/server/routes/chat/`，遵循统一的 handler 模式。`send.ts` 处理发送消息：验证会话归属后保存用户消息到 DB，调用 `agentStream` 获取流式响应，返回 SSE UI 消息流，流结束后后台保存 AI 回复到 DB。
+
 ## 类型规范
 
 - 共享类型以 src/shared/api.ts 为唯一源头