3.9 KiB
3.9 KiB
视频云同步与内容合集设计方案
目标
让 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 普通用户首页能看到视频、插画、漫画、小说四类内容入口。
- 现有图片、漫画、小说同步与阅读入口保持可用。