Files
SakuraHub/docs/视频云同步与内容合集设计方案.md
2026-11-16 20:45:22 +08:00

3.9 KiB
Raw Permalink Blame History

视频云同步与内容合集设计方案

目标

让 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 普通用户首页能看到视频、插画、漫画、小说四类内容入口。
  • 现有图片、漫画、小说同步与阅读入口保持可用。