fix: align backend APIs and upload flow

API.md

@@ -945,3 +945,18 @@ file: (二进制分片)
 | 3000-3099 | 管理后台 | 3000 管理员不存在, 3003 权限不足 |
 | 3100-3199 | 会话 | 3100 会话不存在 |
 | 3200-3299 | 分片 | 3201 分片不存在, 3202 分片合并失败, **3203 分片过小**, **3204 分片数不匹配**, **3205 会话过期**, **3206 分片号无效** |
+
+## 会话一致性说明
+
+- `GET /api/Conversation/List` 的请求和响应结构不变，结果按 `ModificationTime ?? CreationTime` 倒序返回。
+- 活动会话由 `(UserId, ChatType, TargetId)` 唯一确定；重复的好友或入群事件按幂等成功处理。
+- `20260911000100_ConversationUniqueness` 会保留最新活动记录、合并最大未读数和最大已读序号，并软删除其余重复记录。
+# 消息历史搜索
+
+`GET /api/Message/Search` 在当前用户拥有的会话中搜索历史文本消息。
+
+- 参数：`conversationId`、`keyword`（去除首尾空格后 1–50 字符）、可选独占游标 `cursor`、`limit`（1–50，默认 30）。
+- 只返回未撤回、未删除的文本消息，按 `sequenceId` 倒序排列。
+- 响应继续使用统一 `Result`，数据结构为 `{ messages, hasmore }`。下一页以本页最后一条消息的 `sequenceId` 作为独占游标。
+- `POST /api/Conversation/MarkRead` 新增可选 `lastReadSequenceId` 查询参数，旧客户端不传时仍兼容。
+- 会话列表的 `dateTime` 表示最后消息活动时间；标记已读不会改变此时间或会话排序。