feat: 添加 Analytics 分析功能（行为追踪、错误码、协议更新）

docs/protocols/models/users.md

@@ -12,6 +12,7 @@ Base URL: `/api/v1/users`
 |---|---|---|
 | GET | `/me` | 获取当前用户信息 |
 | PATCH | `/me` | 更新当前用户信息 |
+| POST | `/me/avatar` | 上传头像图片并更新头像地址 |
 | POST | `/search` | 搜索用户 |
 | GET | `/{user_id}` | 获取指定用户信息 |
 
@@ -106,7 +107,31 @@ Base URL: `/api/v1/users`
 
 ---
 
-## 4) GET `/{user_id}`
+## 4) POST `/me/avatar`
+
+上传头像（`multipart/form-data`）。
+
+### Request
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `file` | file | 是 | 图片文件（`image/jpeg` / `image/png` / `image/webp`） |
+
+### Response
+
+```json
+{
+  "url": "https://..."
+}
+```
+
+说明：
+- 上传成功后后端会同步更新当前用户 `avatar_url`。
+- 文件大小上限由后端配置 `storage.avatar.max_size_mb` 控制。
+
+---
+
+## 5) GET `/{user_id}`
 
 获取指定用户信息。