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

71 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 视频云同步与内容合集设计方案
## 目标
让 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 普通用户首页能看到视频、插画、漫画、小说四类内容入口。
- 现有图片、漫画、小说同步与阅读入口保持可用。