Files
SakuraHub/产品说明文档.md
T
2026-11-16 20:45:22 +08:00

6.6 KiB
Raw Blame History

樱云下载器(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. 用户价值

  1. 集中管理:Pixiv / X 的插画、漫画、小说统一采集入库,告别散落收藏。
  2. 本地资产:下载内容落在本地图库,带搜索、标签、作者、收藏体系。
  3. 多端同步:桌面采集,手机阅读,进度、收藏、提醒全端同步。
  4. 追更提醒:关注作者有新作,每日定时汇总提醒,不再手动刷动态。
  5. 离线阅读:小说自动分页、进度记忆,适合长期追更连载。

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 项目总览与快速开始