From bfe48439b35cac005cdc1dc38881f04b62467770 Mon Sep 17 00:00:00 2001 From: chenhang Date: Mon, 20 Jul 2026 14:03:40 +0800 Subject: [PATCH] refactor(chat): remove failures section from API documentation --- docs/backend/FRONTEND_MULTI_ROLE_CHAT_API.md | 40 -------------------- 1 file changed, 40 deletions(-) diff --git a/docs/backend/FRONTEND_MULTI_ROLE_CHAT_API.md b/docs/backend/FRONTEND_MULTI_ROLE_CHAT_API.md index afb62dde..971b8585 100644 --- a/docs/backend/FRONTEND_MULTI_ROLE_CHAT_API.md +++ b/docs/backend/FRONTEND_MULTI_ROLE_CHAT_API.md @@ -153,35 +153,6 @@ Authorization: Bearer 费用、锁消息数量、成功解锁数量及 `messageIds` 都只计算当前角色。钱包余额仍是账号全局余额。 -## 9. Guest History Sync - -```http -POST /api/chat/sync -Content-Type: application/json -Authorization: Bearer -``` - -```json -{ - "characterId": "maya-tan", - "messages": [ - {"role": "user", "content": "Hello", "timestamp": "2026-07-17T09:00:00Z"}, - {"role": "assistant", "content": "Hi", "timestamp": "2026-07-17T09:00:01Z"} - ] -} -``` - -每次同步只能包含一个角色。本地若保存了多个角色，前端按角色分组分别调用。 - -若页面使用用户聊天统计，也必须带角色： - -```http -GET /api/user/stats?characterId=maya-tan -``` - -其中 `totalMessages`、近期记忆、亲密度、情绪和关系状态都按角色返回。 -响应会明确带上 `characterId`、`relationshipStage` 和 `currentMood`，前端不要把这些状态写回其他角色的本地缓存。 - ## 12. Tip Attribution 只有 Tip 订单使用角色归属： @@ -196,14 +167,3 @@ GET /api/user/stats?characterId=maya-tan ``` Tip 订单必须携带 `recipientCharacterId`。VIP 和积分充值会忽略该字段。 - -## 13. Failures - -| HTTP | `detail.errorCode` | Meaning | Frontend action | -| ---: | --- | --- | --- | -| 403 | `CHARACTER_DISABLED` | 角色或对应能力未开放 | 禁用输入并刷新角色目录 | -| 404 | `CHARACTER_NOT_FOUND` | 角色 ID 不存在 | 清理本地旧角色 ID，回角色列表 | -| 409 | `CHARACTER_MISMATCH` | 消息或双参数属于不同角色 | 不重试、不扣费，刷新当前角色历史 | -| 503 | `CHARACTER_STATE_UNAVAILABLE` | 角色会话状态暂不可用 | 保留输入并稍后重试 | - -新前端的角色业务请求必须显式携带角色 ID。应用入口未指定角色时选择 Elio；显式错误、停用或不匹配的角色不会回退 Elio。