chore: sync worktree changes - update protocols, trellis workspace, and config

This commit is contained in:
qzl
2026-04-23 16:04:04 +08:00
parent eeed737949
commit dcb0eb4c65
13 changed files with 519 additions and 40 deletions
+13
View File
@@ -215,12 +215,18 @@ data: {"event_id":"6f0d...","occurred_at":"2026-03-30T07:00:00Z","user_id":"..."
"occurred_at": "datetime",
"user_id": "uuid",
"message_id": "uuid",
"event_type": "INBOX_MESSAGE_CREATED | INBOX_MESSAGE_READ_CHANGED | INBOX_MESSAGE_STATUS_CHANGED | INBOX_SNAPSHOT_REQUIRED",
"op": "created | read_changed | status_changed | snapshot_required",
"version": 1743313300000,
"data": {}
}
```
说明:
- SSE 帧的 `event:` 行与 payload 内 `event_type` 当前实现保持一致。
- 客户端可优先使用 SSE `event`,也可在 payload 内读取 `event_type` 做调试或补偿。
### Delta 约定
- `created`:
@@ -275,3 +281,10 @@ data: {"event_id":"6f0d...","occurred_at":"2026-03-30T07:00:00Z","user_id":"..."
- 对 `message_type=calendar`,前端必须按 `content.type` 严格分发:`invite | updated | deleted`。
- 若 `content` 缺少协议必填字段(`schema_version/item/actor/summary`,以及 `updated` 的 `changes`),前端必须进入协议异常展示路径。
- 禁止将协议异常消息兜底渲染为“默认日历邀请”或其他正常业务消息。
---
## Compatibility Strategy
- 策略:`backward-compatible`
- 本次仅补全文档遗漏字段 `event_type`,不改变现有 SSE wire 协议。
+8 -1
View File
@@ -43,7 +43,7 @@ Base URL: `/api/v1/users`
字段说明:
- `id`: 用户唯一标识符 (UUID)
- `username`: 用户名,3-30 字符
- `username`: 用户名,当前后端更新接口约束为最大 30 字符(最小长度未在 API 层强制)
- `phone`: E.164 格式手机号,可为 null
- `avatar_url`: 头像 URL,可为 null
- `bio`: 个人简介,最大 200 字符,可为 null
@@ -142,3 +142,10 @@ Base URL: `/api/v1/users`
### Response
`UserContext` 对象。
---
## Compatibility Strategy
- 策略:`backward-compatible`
- 本次仅修正文档约束描述与实现一致,不改变接口字段与响应结构。