Files
SakuraHub/README.md
T
2026-11-16 20:45:22 +08:00

3.1 KiB
Raw Blame History

Sakura Downloader(樱云下载器)

个人媒体采集、本地图库管理与跨设备云同步系统。

端 角色
Windows 桌面端 采集与整理中枢
Sakura Cloud 数据与账号中心
Android 客户端 跨设备阅读与提醒

成品文件(releases/)

文件 说明 大小(约)
releases/sakuradownloader.exe Windows 桌面端,双击即用 ~68 MB
releases/app-release.apk Android 客户端(调试签名,适合自测) ~54 MB

构建产物来源:

  • EXE:dist/sakuradownloader.exe → 复制到 releases/
  • APK:sakura_mobile/build/app/outputs/flutter-apk/app-release.apk → 复制到 releases/

文档索引

文档 面向读者 内容
使用说明-桌面版与安卓版.md 终端用户 登录、下载、云同步、手机端操作
docs/项目功能交付书.md 产品 / 验收 功能模块、架构、API、代码索引
docs/项目文档.md 开发者 环境、目录、构建、部署、开发流程
项目文件/BUILD.md 开发者 EXE / APK 打包细节与排错

快速开始(源码)

桌面端

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
python main.py

云端(可选)

pip install -r sakura_cloud/requirements.txt
uvicorn sakura_cloud.main:app --reload

移动端(开发)

cd sakura_mobile
flutter pub get
flutter run

一键打包

# 桌面 EXE
scripts\build_desktop_exe.bat

# Android APK(需 JDK 17+,仓库内 tools\flutter 与 tools\android-sdk)
scripts\build_mobile_android.bat

# 打包后复制到 releases/
scripts\copy_release_artifacts.bat

# 或依次执行 EXE + APK + 复制
scripts\build_all.bat

技术栈摘要

  • 桌面:Python 3.8+、CustomTkinter、SQLite、Playwright(X 插件)
  • 云端:FastAPI、PostgreSQL、JWT
  • 移动:Flutter、Riverpod、Dio

目录结构(精简)

Pixiv/
├── main.py                 # 桌面入口
├── pixiv_app/              # 桌面核心(GUI、下载、图库、云同步)
├── plugins/                # Pixiv / X 等插件
├── sakura_cloud/           # 云端 API、docker-compose、Alembic
├── sakura_mobile/          # Flutter 安卓端
├── releases/               # 可分发成品(EXE / APK)
├── docs/                   # 交付书、开发文档
├── scripts/                # 构建与依赖安装脚本
├── tools/                  # 辅助脚本(如代码统计)
└── 项目文件/               # 迭代与专题说明

许可与说明

  • APK 当前为 调试签名,仅供个人测试,不宜直接上架分发。
  • 使用 X 插件前需安装 Playwright Chromium(见 项目文件/BUILD.md)。
  • 会话与图库数据默认保存在 %LOCALAPPDATA%\PixivDownloader(打包版)。

最后构建:2026-06-05