# 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](使用说明-桌面版与安卓版.md) | 终端用户 | 登录、下载、云同步、手机端操作 | | [docs/项目功能交付书.md](docs/项目功能交付书.md) | 产品 / 验收 | 功能模块、架构、API、代码索引 | | [docs/项目文档.md](docs/项目文档.md) | 开发者 | 环境、目录、构建、部署、开发流程 | | [项目文件/BUILD.md](项目文件/BUILD.md) | 开发者 | EXE / APK 打包细节与排错 | ## 快速开始(源码) ### 桌面端 ```powershell python -m venv .venv .\.venv\Scripts\activate pip install -r requirements.txt python main.py ``` ### 云端(可选) ```powershell pip install -r sakura_cloud/requirements.txt uvicorn sakura_cloud.main:app --reload ``` ### 移动端(开发) ```powershell cd sakura_mobile flutter pub get flutter run ``` ## 一键打包 ```powershell # 桌面 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 ## 目录结构(精简) ```text 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*