13 KiB
樱云同步使用说明(桌面版与安卓版)
更新时间:2026-06-05
1. 成品文件位置
建议直接使用 releases/ 目录下的成品:
releases/sakuradownloader.exereleases/app-release.apk使用说明-桌面版与安卓版.md(本文件,位于项目根目录)
对应原始产物来源如下:
- Windows EXE 来源:
dist/sakuradownloader.exe - Android APK 来源:
sakura_mobile/build/app/outputs/flutter-apk/app-release.apk
说明:
releases/app-release.apk与sakura_mobile/build/app/outputs/flutter-apk/app-release.apk为同一构建产物;重新打包后请运行scripts\copy_release_artifacts.bat同步到releases/。- 当前 Android
release包仍然是调试签名,适合自测和个人使用,不建议直接用于正式分发或上架。
2. 这个项目现在能做什么
这个项目目前可以分成两部分来理解:
- 桌面端
sakuradownloader.exe负责登录、抓取、下载、整理本地图库、打开缩略图墙、关注作者,以及把内容同步到云端。 - 安卓端
app-release.apk负责登录同一个云端账号后,在手机上浏览图片、漫画、小说、收藏、阅读进度和提醒。
一句话版本:
- 桌面端更像“采集和整理中枢”
- 安卓端更像“个人阅读器”
3. Windows 桌面版使用方法
3.1 启动
双击 releases/sakuradownloader.exe 即可启动。
如果你只是想直接用成品,优先用 releases/ 里的 EXE,不需要再去 dist 里找。
3.2 登录 Pixiv
桌面端支持两种方式:
Cookie 登录账号密码登录
当前项目里更推荐 Cookie 登录,也是代码里明确提示的稳定方案。
推荐流程:
- 在已经登录 Pixiv 的浏览器里,用
Get cookies.txt之类的插件导出txt或json - 打开桌面端
- 在“登录方式”卡片里保持
Cookie 登录 - 点击
导入 cookies.txt / json - 导入后可点击
检测会话 - 确认没问题后点击
保存会话
补充说明:
账号密码登录仍可尝试,但 Pixiv 额外验证、二步验证或风控时更容易失败。- 如果后续抓取突然失效,优先重新导入一次最新 Cookie。
3.3 下载 Pixiv 内容
桌面端主界面有“抓取目标”卡片,核心是三项:
平台模式目标
Pixiv 常用模式:
作者全部作品目标里可以填作者 ID,也可以直接贴任意该作者作品链接,程序会自动反查作者。作品 / 漫画目标里填作品 ID 或作品链接。文章 / 小说目标里填小说 ID、小说链接,或者小说系列链接。关键词目标里填关键词,程序先搜索再下载。
常见输入例子:
- 作者 ID
- Pixiv 作品链接
- Pixiv 小说链接
- 小说系列链接
操作步骤:
- 选择
平台 = Pixiv - 选择合适的
模式 - 在
目标输入框里填 ID 或链接 - 点击
开始抓取 - 等待右侧日志和进度完成
下载后的内容会进入本地图库,同时写入本地数据库,后续缩略图墙、收藏和作者视图都会用到这些数据。
3.4 打开缩略图墙
桌面主界面有一个明显按钮:
打开缩略图墙
点它后,程序会在本机启动一个本地服务,并用浏览器打开本地图库页面。
默认本地地址通常是:
http://127.0.0.1:8765
如果端口被占用,程序会自动尝试 8766 或 8767。
缩略图墙适合做这些事:
- 浏览本地图片和漫画
- 默认不显示小说
- 搜索标题、作者、简介
- 按标签筛选
- 查看作者
- 收藏作品
- 进入“关注同步”页维护关注作者
- 进入“X 关注”页维护 X 作者
3.5 在缩略图墙里关注作者
“每日提醒”要先有“关注作者”这一步。
当前仓库里,明确可见的关注入口在桌面端缩略图墙。
有两种常用方式:
- 方式一:在作品详情里点
关注作者 - 方式二:进入
关注同步页,手动填写作者 ID,再点添加关注
关注同步 页面里还能做两件事:
- 导入
Pixiv Cookie - 点击
同步关注作者
注意:
- 当前这套“关注同步”页面还是围绕 Pixiv 作者 ID 和 Pixiv Cookie 做的。
- 另外已经新增了
X 关注区域,可以手动添加 X 用户名并做同步。
3.6 云同步
如果你想让手机端看到桌面端内容,必须用到云同步。
桌面端左侧有 云同步 卡片,使用方法如下:
- 勾选
启用 Sakura Cloud 同步 - 点击
账号管理 - 在弹窗里登录或注册云端账号
- 登录成功后,云同步凭证会自动保存
- 回到主界面后可以点
测试连接
项目当前代码里写死的默认云端地址是:
http://api.kunkunxiaomao.top:8000
登录成功并开启云同步后:
- 新下载完成的 Pixiv 内容会自动上传到 Sakura Cloud
- 手机端登录同一个账号后就能刷新看到内容
4. Android 安卓版使用方法
4.1 安装
安装 releases/ 目录下的 APK:
releases/app-release.apk
如果系统拦截安装,按 Android 的常规流程允许“未知来源应用安装”即可。
再次提醒:
- 当前 APK 是调试签名,不适合正式上架,只适合自测和个人使用。
4.2 登录
安卓端打开后会先进入登录/注册页。
使用方法:
- 用和桌面端云同步相同的账号登录
- 如果没有账号,可以先注册
- 注册成功后不会自动登录,需要回到登录页手动登录一次
只有登录同一个云端账号,桌面端同步上去的图片、漫画、小说、收藏和提醒才能在手机上看到。
4.3 安卓端底部导航
当前底部共有 5 个页签:
发现图片漫画书架我的
各页作用如下。
4.4 发现页
发现 页更像首页和动态页,主要展示:
- 最近浏览的图片
- 最近浏览的漫画
- 最近阅读的小说
- 更新提醒
如果你开启了“每日提醒”,提醒摘要会出现在这里的 更新提醒 区域。
4.5 图片页
图片 页展示云端同步过来的插画内容。
可以做的操作包括:
- 看缩略图列表
- 点进详情
- 收藏 / 取消收藏
- 下载到本地
- 编辑图片信息
- 删除图片
4.6 漫画页
漫画 页现在是按漫画分组进入,不再是单张图散着看。
实际体验上会更像:
- 先看到一组漫画入口
- 点进去后连续浏览整组内容
- 支持整组下载
这也是当前项目里已经调整过的重点之一。
4.7 书架页
书架 页现在是三列彩色方块风格。
特点:
- 固定三列
- 系列小说会优先按书名归档
- 单篇小说也能单独展示
- 点击系列后会先弹出章节选择
- 阅读记录会影响排序,最近看的更靠前
4.8 小说阅读页
小说阅读器已经改成更适合长期阅读的样子,主要能力有:
- 自动分页
- 记住当前阅读进度
- 收藏 / 取消收藏
- 当前页翻译
- 原文 / 译文切换
- 底部阅读设置面板
- 系列章节列表切换
阅读页右上角常用功能:
- 收藏
- 翻译当前页
- 删除小说
底部阅读设置面板支持:
字体大小行高背景色章节切换
如果是系列小说,底部面板里会直接列出章节,点一下就能切换。
4.9 我的页
我的 页负责这些内容:
- 用户资料
- 云端空间占用
- 我的收藏
- 收藏图片
- 收藏小说
- 每日更新提醒
- 退出登录
其中“每日更新提醒”就在这里设置开关和时间。
5. 每日提醒功能的真实使用链路
这一节我按当前仓库里的真实实现来写,不按想象写。
5.1 先说结论
当前“每日提醒”不是手机本地闹钟,也不是系统级推送通知。
它更准确的工作方式是:
- 云端保存你关注作者产生的更新 alert
- 云端到点后把这些未读 alert 汇总成一条“每日摘要提醒”
- 手机端在
发现页的更新提醒区域把它显示出来
也就是说:
- 它是“云端摘要提醒”
- 不是“手机本地定时弹通知”
5.2 开关位置
安卓端位置:
- 登录后进入
我的 - 找到
每日更新提醒 - 打开开关
- 点
提醒时间 HH:MM选择时间 - 需要看最近提醒或已关注作者时,点
打开提醒中心
当前支持保存的字段包括:
- 是否开启
- 小时
- 分钟
- 时区
默认时区是:
Asia/Shanghai
5.3 提醒真正依赖什么
要让提醒真正有内容,至少要满足下面这些条件:
- 你已经在桌面端维护了“关注作者”
- 桌面端已经登录并启用了云同步
- 手机端和桌面端用的是同一个云端账号
- 关注作者确实有新内容进入了云端 alert 流程
- 到了你设定的提醒时间
如果只是把手机上的提醒开关打开,但桌面端没有把作者更新同步进云端,那么手机端不会凭空出现提醒。
5.4 推荐使用步骤
按当前代码,最稳妥的使用顺序建议这样走:
- 在桌面端登录 Pixiv,优先用 Cookie
- 在桌面端启用
云同步,并登录 Sakura Cloud 账号 - 打开
缩略图墙 - 在作品详情里点
关注作者,或者在关注同步页面手动添加关注 - 如果要同步 X,就到
X 关注区域添加用户名后再点同步 X 关注 - 让关注作者的新作品经过桌面端下载,并同步到云端
- 在手机端登录同一个云端账号
- 到
我的页打开每日更新提醒,或者直接进入提醒中心 - 设定提醒时间
- 到点后去
发现页查看更新提醒
5.5 当前代码里已经确认到的事实
我在仓库里确认到了下面几件事:
- 手机端“我的”页明确有
每日更新提醒开关和时间选择 - 手机端“发现”页明确会展示
更新提醒 - 云端会每 5 分钟检查一次提醒摘要
- 云端启动时也会先跑一次提醒摘要检查
- 云端只会给已开启提醒的用户生成摘要
- 同一天内已经发过一次摘要,就不会重复生成同一天第二条摘要
摘要标题格式类似:
每日 09:00 更新提醒
摘要正文内容类似:
- 你关注的作者有多少条新动态
- 这些动态来自哪些平台
- 还会尽量带上最近几个作者名字
5.6 一个很重要的现实限制
虽然手机端文案写的是:
Pixiv / X 博主
现在仓库里已经同时接通了 Pixiv 和 X 的关注管理:
- 桌面端既有 Pixiv 风格的作者关注,也有 X 关注同步入口
- 桌面端向云端写入 follow / alert 的代码路径也已经覆盖 Pixiv 和 X
换句话说:
- 后端模型和提醒摘要对
Pixiv / X是通用设计 - 但当前仓库里我真正看到的、已经接上的前端入口和 alert 创建链路,主要落在 Pixiv
所以更稳妥的理解是:
- 现在请把“每日提醒”当成
Pixiv / X 关注作者更新摘要来使用 - X 的判新依赖作者时间线,稳定性通常比纯媒体页更好
5.7 关于“同步关注作者”按钮的补充说明
缩略图墙里的 同步关注作者 按钮,当前明确作用是:
- 用已保存的 Pixiv Cookie 去拉取关注作者的新作品
- 把新作品下载到本地图库
同步 X 关注会按时间线检查 X 作者的新动态,并把结果写到云端 follow / alert
当前我能明确确认的提醒写入路径,是:
- 桌面端 Pixiv / X 内容在云同步过程中
- 如果作者已经在本地关注列表里
- 程序就会向云端写入 follow 和 update alert
因此更稳妥的使用建议是:
- 把
同步关注作者当作“本地补新”功能 - 把
同步 X 关注当作“X 作者新动态补新”功能 - 把“真正用于手机提醒的数据来源”理解为“已经被桌面端同步进云端的更新记录”
6. 常见问题
6.1 桌面端登录失败怎么办
优先做这几件事:
- 改用
Cookie 登录 - 重新导出最新 cookies.txt
- 重新导入后再点
检测会话
账号密码登录不是不能用,但稳定性不如 Cookie。
6.2 手机端登录了还是没内容
通常优先排查下面几点:
- 桌面端是否启用了
云同步 - 桌面端是否真的登录了云端账号
- 下载是否已经完成
- 下载完成后是否已经同步到云端
- 手机和桌面是否是同一个账号
6.3 每日提醒开了却看不到提醒
按顺序检查:
- 是否已经在桌面端关注了作者
- 是否有新作品真的进入云端
- 是否已经超过你设置的提醒时间
- 手机端是否登录同一账号
- 是否去
发现页看更新提醒
再强调一次:
- 这不是手机本地闹钟
- 开关打开后不会立刻弹系统通知
- 它是云端汇总后的应用内提醒
6.4 安卓安装被拦截
这是常见现象,尤其是未上架、未正式签名的测试包。
当前处理方式通常是:
- 允许未知来源安装
- 再重新安装一次
6.5 Android 包能不能直接拿去正式发给别人
不建议。
原因很直接:
- 当前
app-release.apk仍是调试签名 - 更适合自测或小范围个人使用
- 如果要正式分发,最好重新做正式 keystore 和正式签名
7. 当前版本的整理结果
分发成品时,建议使用 releases/ 目录:
releases/sakuradownloader.exereleases/app-release.apk
用户手册位于项目根目录:使用说明-桌面版与安卓版.md