# 视频云同步与内容合集设计方案 ## 目标 让 X、小红书、抖音采集到的视频和图片一样进入 Sakura Cloud,并能在手机端与 Web 端查看。云端对每个用户的视频总占用做 30GB 上限,Web 端从“后台列表”调整为适合阅读、看视频、浏览插画的内容合集。 ## 云端设计 - 复用现有 `upload / sync / gallery / files` 链路,不新增数据库表,不改变 API 返回结构。 - 视频仍作为 `Artwork` 保存,`content_type=video`,`mime_type=video/*`,文件实体复用 `FileBlob` 与 `UserFile`。 - 上传接口允许 `resource_type=video`,视频文件进入 `uploads/videos/{user_id}/{year}/{month}`。 - 新增配置: - `MAX_VIDEO_UPLOAD_SIZE_MB=2048`:单个视频默认最大 2GB。 - `VIDEO_STORAGE_LIMIT_GB=30`:单用户视频总空间上限 30GB。 - 配额计算以当前登录用户为准,从 `UserFile -> FileBlob` 统计该用户所有 `mime_type LIKE 'video/%'` 的文件大小。命中上限时返回 `413`,不会创建上传会话。 - 已存在文件秒传时同样检查该用户的视频总配额,防止跨用户复用文件绕过限制。 ## 桌面端采集同步设计 - `SyncManager` 根据 MIME 与 `content_type` 判断上传资源类型: - 小说:`novel` - 视频:`video` - 其他:`image` - X 手动预览下载和关注作者同步共用云端同步逻辑,视频文件下载成功后自动同步 metadata。 - WebUI 通用插件下载路径也接入云同步,因此小红书、抖音插件只要返回 `files=[{type: "video"}]`,就能自动上传云端。 - 小红书插件补充 DOM 视频解析,支持从 `video/source` 标签提取直接视频地址;搜索结果进入详情下载时也同时处理 `images + videos`。 - 抖音插件已有视频文件抽取与下载逻辑,本方案复用其 `Resource.files` 输出,不重写下载器。 ## 手机端设计 - `Artwork` 模型补充 `mimeType`、`fileSize`、`isVideo` 与 `primaryMediaPath`。 - 图库页新增视频筛选,视频卡片显示播放叠层,不再伪装成普通插画。 - 视频详情页展示视频封面、标题、作者、MIME、大小,并提供: - 播放视频 - 下载到本地 - 收藏 - 为避免新增播放器依赖导致构建不稳定,当前采用“受保护下载到本地后调用系统播放器”的方式。 - Android 通过 FileProvider 暴露 Sakura 下载目录中的临时读取 URI,不暴露任意路径。 ## Web 端内容合集设计 - 普通用户首页改为内容合集: - 顶部概览:用户、空间、视频额度、最近内容。 - 视频区:16:9 视频卡片,播放标记,显示作者与大小。 - 插画区:缩略图网格。 - 漫画区:阅读列表入口。 - 小说区:阅读列表入口。 - 在线搜索与提醒中心作为主操作入口。 - 页面复用现有 API: - `/me/gallery?content_type=video` - `/me/gallery?content_type=illust` - `/me/gallery?content_type=manga` - `/novels/series` - CSS 使用现有粉白主题、8px 圆角和响应式网格,手机浏览时自动改为单列。 ## 安全与边界 - 不上传第三方平台 Cookie、Token 或浏览器登录态。 - 云端只保存视频文件与作品 metadata。 - 视频配额按当前登录用户统计,避免水平越权。 - 文件读取继续走现有 `/files` 和 gallery ownership 校验。 - Android FileProvider 只给外部播放器一次性读取 URI,不暴露数据库或任意文件系统路径。 ## 验收点 - X、小红书、抖音插件下载视频后,云同步开启时视频可进入 cloud gallery。 - 超过 30GB 视频总配额时,上传初始化返回 413。 - 手机端图库可以筛选视频,视频详情可以下载并调用系统播放器查看。 - Web 普通用户首页能看到视频、插画、漫画、小说四类内容入口。 - 现有图片、漫画、小说同步与阅读入口保持可用。