From 59c73169e1447b85517063bf7b537a19cfcf4d03 Mon Sep 17 00:00:00 2001 From: "DESKTOP-L8OUL9F\\gfl0034" <1003614916@qq.com> Date: Thu, 24 Sep 2026 23:58:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(media):=20=E5=BE=AE=E8=B0=83=E5=AA=92?= =?UTF-8?q?=E4=BD=93=E8=AF=B4=E6=98=8E=E4=B8=8E=20OpenAPI=20=E6=8F=8F?= =?UTF-8?q?=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/media.md | 7 ++++--- internal/transport/http/docs/openapi.yaml | 6 ++++-- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/media.md b/docs/media.md index 4372388..5ea1d2a 100644 --- a/docs/media.md +++ b/docs/media.md @@ -15,8 +15,8 @@ | 时机 | 位置 | 行为 | |------|------|------| | 申请上传凭证 | `upload/logic.CreateCredential` → `checkDeclaredSize` | 按 `purpose` 校验声明 `size`；超限默认 **打 Warn 日志**，`media.user_reject=true` 时返回 `40005` | -| 广场发帖 | `square/logic.publish` → `checkPublishMedia` | 用客户端声明的图/视频宽高与 size 校验；同上 | -| 朋友圈发帖 | `moment/logic.publish` → `checkPublishMedia` | 同上 | +| 广场发帖 | `square/logic.publish` → `checkMediaMeta` | 用客户端声明的图/视频宽高与 size 校验；同上 | +| 朋友圈发帖 | `moment/logic.publish` → `checkMediaMeta` | 同上 | 主压缩仍在 **App 上传前**；服务端不把用户文件再压一遍（除非开启拒收）。 @@ -36,6 +36,7 @@ ## 部署注意 -- 视频压缩依赖主机 **`ffmpeg`**（`media.ffmpeg_path`，默认 `ffmpeg`）。 +- 视频压缩依赖主机 **`ffmpeg`**（`media.ffmpeg_path`，默认 `ffmpeg`）。运行镜像 `Dockerfile` 已 `apk add ffmpeg`。 - 迁移：`migrations/0026_square_bot_rss.sql`（`source` / `source_url` / `expires_at` + `t_square_bot_links`）。 - Seed：`go run ./cmd/seed -config configs/config.yaml` 确保 `bot001@spark.bot`… 存在。 +- 错误码：`40005` / `media_oversized`（`media.user_reject=true` 时拒凭证或发帖）。 diff --git a/internal/transport/http/docs/openapi.yaml b/internal/transport/http/docs/openapi.yaml index b660645..ae17563 100644 --- a/internal/transport/http/docs/openapi.yaml +++ b/internal/transport/http/docs/openapi.yaml @@ -3262,8 +3262,10 @@ components: 12 SYNC_MESSAGES 13 SYNC_MESSAGES_FINISH 14 KICK 15 DELETE_MESSAGE EnvelopeCode: type: string - enum: ["0", "40001", "40002", "40003", "40004", "40101", "40102", "40301", "40401", "40402", "40901", "42901", "42902", "42903", "49901", "50001", "50002", "50003", "50301", "50401"] - description: envelope.code。成功为 "0" + enum: ["0", "40001", "40002", "40003", "40004", "40005", "40101", "40102", "40103", "40301", "40401", "40402", "40901", "42901", "42902", "42903", "49901", "50001", "50002", "50003", "50301", "50401"] + description: | + envelope.code。成功为 "0"。 + `40005` media_oversized：媒体分辨率/体积超限（开启 media.user_reject 时拒收）。 Envelope: type: object required: [code, msg, request_id, data]