# 媒体压缩与检测

> App 端主压缩；服务端对用户路径做检测，对机器人路径强制压缩后写对象存储。

## 规格（与 App 对齐）

| 类型 | 最长边 | 体积参考 |
|------|--------|----------|
| 普通图片（广场/朋友圈等） | ≤ **1080** | ≤ 10 MiB |
| 视频 | ≤ **720** | ≤ 100 MiB |
| 头像 | ≤ **200×200** | ≤ 2 MiB |

## 检测点（用户上传）

| 时机 | 位置 | 行为 |
|------|------|------|
| 申请上传凭证 | `upload/logic.CreateCredential` → `checkDeclaredSize` | 按 `purpose` 校验声明 `size`；超限默认 **打 Warn 日志**，`media.user_reject=true` 时返回 `40005` |
| 广场发帖 | `square/logic.publish` → `checkMediaMeta` | 用客户端声明的图/视频宽高与 size 校验；同上 |
| 朋友圈发帖 | `moment/logic.publish` → `checkMediaMeta` | 同上 |

主压缩仍在 **App 上传前**；服务端不把用户文件再压一遍（除非开启拒收）。

## 机器人压缩点

| 时机 | 位置 | 行为 |
|------|------|------|
| RSS 配图 | `squarebot` Tick → `attachMedia` → `MediaCompressor.FetchImage` → `objectstore.Put` | 下载后压到 ≤1080，再写入 `perm/square/image/` |
| 机器人视频路径 | `PrepareVideoAsset` / `FetchVideo` | ffmpeg 压到 ≤720（部署需 `ffmpeg`） |
| 机器人头像 | `FetchAvatar` / `PrepareBotAvatar` | ≤200×200 |

开关：`media.bot_compress`（默认 true）。关闭时机器人帖仍发文字摘要+链接，不拉配图。

## 配置

见 `configs/config.yaml` 的 `media:` 与 `square_bot:`。

## 部署注意

- 视频压缩依赖主机 **`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` 时拒凭证或发帖）。