Files
SakuraHub/docs/视频云同步与内容合集设计方案.md
T

70 lines
3.9 KiB
Markdown
Raw Normal View History

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