6.6 KiB
6.6 KiB
樱云下载器(Sakura Downloader)产品说明文档
版本:V1.0 更新日期:2026-11-05 文档类型:产品说明
1. 产品概述
1.1 产品名称
樱云下载器(Sakura Downloader)
1.2 产品定位
一款面向个人创作者与插画/漫画/小说爱好者的个人媒体采集、本地图库管理与跨设备云同步系统。
产品覆盖从「内容采集 → 本地整理 → 云端存储 → 多端阅读」的完整链路,解决用户在 Pixiv、X(Twitter)等平台收藏作品后"散落各处、难以管理、换设备看不了"的问题。
1.3 一句话描述
桌面端是"采集与整理中枢",云端是"数据与账号中心",手机端是"个人阅读器"。
2. 产品架构
| 端 | 载体 | 角色 |
|---|---|---|
| Windows 桌面端 | sakuradownloader.exe |
登录、抓取、下载、本地图库管理、云同步 |
| Sakura Cloud 云端 | FastAPI 服务 | 账号体系、媒体存储、关注与提醒数据 |
| Android 移动端 | app-release.apk |
跨设备浏览、阅读、收藏、提醒查看 |
数据流向:
Pixiv / X 平台
│ (桌面端抓取下载)
▼
本地图库(SQLite + 本地文件)
│ (云同步上传)
▼
Sakura Cloud(媒体 + 账号 + 关注/提醒数据)
│ (同账号拉取)
▼
Android 客户端(图片 / 漫画 / 小说 / 收藏 / 提醒)
3. 核心功能
3.1 桌面端(采集与整理中枢)
3.1.1 账号登录
- 支持 Cookie 登录(推荐,稳定)与 账号密码登录 两种方式。
- 支持导入
cookies.txt/json格式的会话文件,可一键检测与保存会话。
3.1.2 内容抓取下载
通过「平台 + 模式 + 目标」三项配置发起抓取:
| 模式 | 目标输入 |
|---|---|
| 作者全部作品 | 作者 ID 或任意该作者的作品链接(自动反查作者) |
| 作品 / 漫画 | 作品 ID 或作品链接 |
| 文章 / 小说 | 小说 ID、小说链接或小说系列链接 |
| 关键词 | 关键词(先搜索后下载) |
下载内容自动进入本地图库并写入数据库。
3.1.3 缩略图墙(本地图库)
程序在本机启动本地服务(默认 http://127.0.0.1:8765,端口占用时自动切换 8766/8767),在浏览器中提供:
- 本地图片/漫画浏览(默认不含小说)
- 标题、作者、简介搜索;按标签筛选
- 作者主页、收藏功能
- 「关注同步」页:维护 Pixiv 关注作者、导入 Cookie、一键同步关注作者新作品
- 「X 关注」页:手动添加 X 用户名并同步时间线新动态
3.1.4 云同步
- 勾选启用 Sakura Cloud 同步,登录/注册云端账号后自动保存凭证。
- 登录成功后,新下载内容自动上传云端,手机端同账号即可查看。
- 关注作者的新作品会写入云端 follow / alert 记录,作为提醒数据来源。
3.2 云端(数据与账号中心)
- 账号注册/登录(JWT 鉴权)、媒体存储与访问。
- 关注(follow)与更新 alert 数据管理。
- 每日提醒摘要:每 5 分钟检查一次,对已开启提醒的用户,将当日未读更新汇总为一条应用内"每日摘要提醒",同一天不重复生成。
3.3 Android 端(个人阅读器)
| 页签 | 功能 |
|---|---|
| 发现 | 最近浏览的图片/漫画/小说、更新提醒摘要展示 |
| 图片 | 云端插画列表、详情、收藏、下载、编辑、删除 |
| 漫画 | 按漫画分组进入,整组连续浏览、整组下载 |
| 书架 | 三列彩色方块,系列小说按书名归档,章节选择,按阅读记录排序 |
| 我的 | 用户资料、云端空间占用、收藏、每日提醒设置、退出登录 |
小说阅读器
- 自动分页、进度记忆、收藏/取消收藏
- 当前页翻译、原文/译文切换
- 字体大小、行高、背景色、章节切换等阅读设置
- 系列小说章节列表直接切换
每日更新提醒
- 开关位于「我的」页,可设置提醒时间(默认时区 Asia/Shanghai)。
- 形式为云端汇总的应用内提醒,展示在「发现」页"更新提醒"区域,不是系统级推送通知。
- 生效前提:桌面端已维护关注作者并启用云同步,双端使用同一账号,且关注作者有新内容进入云端。
4. 技术栈
| 模块 | 技术 |
|---|---|
| 桌面端 | Python 3.8+、CustomTkinter、SQLite、Playwright(X 插件) |
| 云端 | FastAPI、PostgreSQL、JWT、Docker Compose、Alembic |
| 移动端 | Flutter、Riverpod、Dio |
5. 分发成品
| 文件 | 说明 | 大小(约) |
|---|---|---|
releases/sakuradownloader.exe |
Windows 桌面端,双击即用 | ~68 MB |
releases/app-release.apk |
Android 客户端(调试签名,适合自测) | ~54 MB |
6. 用户价值
- 集中管理:Pixiv / X 的插画、漫画、小说统一采集入库,告别散落收藏。
- 本地资产:下载内容落在本地图库,带搜索、标签、作者、收藏体系。
- 多端同步:桌面采集,手机阅读,进度、收藏、提醒全端同步。
- 追更提醒:关注作者有新作,每日定时汇总提醒,不再手动刷动态。
- 离线阅读:小说自动分页、进度记忆,适合长期追更连载。
7. 已知限制
- Android APK 当前为调试签名,仅供个人测试与自用,不宜正式上架分发。
- 「账号密码登录」在遇到 Pixiv 额外验证、二步验证或风控时成功率较低,推荐 Cookie 登录。
- 每日提醒为云端应用内摘要提醒,非手机系统级推送,不会弹系统通知。
- 提醒数据链路目前主要落在 Pixiv 侧;X 关注已有同步入口,判新依赖作者时间线,稳定性相对更好,但整体仍建议以"Pixiv / X 关注作者更新摘要"的预期使用。
- 使用 X 插件前需安装 Playwright Chromium(见
项目文件/BUILD.md)。 - 会话与图库数据默认保存在
%LOCALAPPDATA%\PixivDownloader(打包版)。
8. 配套文档
| 文档 | 面向读者 |
|---|---|
| 使用说明-桌面版与安卓版.md | 终端用户:登录、下载、云同步、手机端操作 |
| docs/项目功能交付书.md | 产品 / 验收:功能模块、架构、API、代码索引 |
| docs/项目文档.md | 开发者:环境、目录、构建、部署 |
| 项目文件/BUILD.md | 开发者:EXE / APK 打包细节与排错 |
| README.md | 项目总览与快速开始 |