CHANGELOG

Unreleased

[新增] 管理后台支持配置素材管理上游地址，并支持为每个用户配置独立的上游 API Key。
[新增] 新增素材组与云端素材管理 REST API（/api/v1/asset-groups、/api/v1/assets）。
[新增] 素材创建失败时自动触发上游补偿删除，避免产生孤儿数据。
[新增] 素材组级联删除返回上游删除成功/失败数量统计，支持区分 404（可忽略）与 5xx（应中断）。
[优化] Handler 层改为 struct 依赖注入，更新接口同时支持 POST 与 PUT。
[优化] 分页参数统一归一化，pageSize 超过 500 时自动截断。
[优化] 服务层错误统一使用 sentinel error（ErrUnauthorized、ErrGroupNotFound），Handler 不再依赖字符串匹配判断权限。
[新增] 素材库页面支持 Tab 切换"本地素材"与"云端素材组"。
[新增] 云端素材组前端：左侧列表、新建素材组弹窗、素材上传弹窗、卡片网格、详情 Drawer。
[新增] 素材上传后自动轮询上游处理状态（每 3 秒刷新，2 分钟超时）。
[新增] 未配置上游 API Key 时云端素材组 Tab 显示友好提示。
[新增] 视频生成页面支持从云端素材库选择 Active 状态素材作为参考图。
[新增] 素材选择 Modal 按素材组过滤，仅展示状态为"可用"的云端素材。
[修复] asset_groups 与 tob_assets 表新增 upstream_id 字段，修正所有上游查询/更新/删除操作使用上游 numeric ID（此前误用本地自增 ID）。
[修复] 删除素材组时级联删除组内素材，上游 404 忽略、5xx 记录错误但不中断，确保本地素材和组始终被清理，返回统计信息告知用户上游删除结果。
[修复] 前端新建素材组成功后自动刷新素材组列表。
[修复] 视频页素材选择器仅展示 Image 类型素材，防止用户误选 Video/Audio 素材。
[修复] 非 Seedance 模型下使用 asset:// 引用且无预览 URL 时，前端给出明确报错提示。
[优化] 上游配置缺失错误统一使用 sentinel error，前端按稳定文案识别，不再依赖模糊字符串匹配。
[优化] 上游 client 缓存 baseURL，减少重复读取 settings 的数据库查询。
[修复] 素材管理前端 API (tob-assets.ts) 所有请求补充用户 token，解决 401/403 未登录错误。
[基础设施] 项目默认端口整体迁移：前端 3000→3001，后端 8080→8081；Docker Compose、Render、开发代理与文档同步更新。
[优化] Dockerfile 最终运行阶段改为 node:22-alpine，Go 后端启用 CGO_ENABLED=0 静态编译，显著减小镜像体积。
[修复] Alpine 镜像补充安装 tzdata，修复 Go time.LoadLocation 在 Alpine 下因缺少时区数据而 panic 的问题。
[修复] 为所有 GORM string 类型的索引/主键/唯一索引字段显式指定 type:varchar(64)，修复 MySQL utf8mb4 字符集下默认 varchar(255) 导致索引长度超过 767 bytes 的问题。