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