Sync temporary service reference docs

服务参考_临时/Brisk API接口与示例文档.md

@@ -289,9 +289,38 @@ curl -X POST "https://brisk.lightyears.ltd/api/archives/slot/1/upload" \
 - `content_size_bytes`
 - `content_checksum`
 - `like_count`
+- `today_like_count`
+- `liked_by_me`
+- `like_reset_at`
 - `visit_count`
 - `updated_at`
 
+点赞接口说明：
+
+- 点赞按 `Asia/Shanghai` 自然日分周期
+- 同一玩家对同一空间同一天重复点赞时：
+  - 接口仍返回成功
+  - `created=false`
+  - `like_count` 与 `today_like_count` 不会继续增加
+- `DELETE /like` 只会撤销当前周期内的那一次点赞
+- 支持给自己的空间点赞
+
+点赞列表说明：
+
+- `GET /api/spaces/{player_id}/likes`
+- `GET /api/spaces/by-login/likes`
+- 支持可选查询参数 `scope`
+  - `history`：历史点赞记录，默认值
+  - `cycle`：当前周期内的点赞记录
+- `limit` 最大返回 `100`
+
+最近访问列表说明：
+
+- `GET /api/spaces/me/visits`
+- 支持可选查询参数 `limit`
+- 默认返回 `50` 条
+- 单次最大返回 `100` 条
+
 上传表单字段：
 
 - `base_version`：用于乐观锁；首次上传可传 `0`
@@ -332,6 +361,26 @@ curl -X POST "https://brisk.lightyears.ltd/api/spaces/by-login/like?login_provid
   -H "Authorization: Bearer <token>"
 ```
 
+按第三方身份查询当前周期点赞列表示例：
+
+```bash
+curl "https://brisk.lightyears.ltd/api/spaces/by-login/likes?login_provider=tap&login_user_id=tap_user_10001&scope=cycle&limit=20" \
+  -H "Authorization: Bearer <token>"
+```
+
+点赞返回示例：
+
+```json
+{
+  "liked": true,
+  "created": true,
+  "liked_by_me": true,
+  "like_count": 128,
+  "today_like_count": 17,
+  "like_reset_at": "2026-04-22T00:00:00+08:00"
+}
+```
+
 ## 10. 后台项目与配置
 
 ### 10.1 项目