# 樱云下载器 — 优化方案与功能规划 > 版本:2.1.0-draft | 日期:2026-06-24 > 基于代码审计报告、产品文档、CHANGELOG 及全仓库源码分析制定 --- ## 目录 1. [优先级定义](#0-优先级定义) 2. [P0 — 安全与基础设施(必须修)](#1-p0--安全与基础设施) 3. [P1 — 核心体验缺陷(尽快修)](#2-p1--核心体验缺陷) 4. [P2 — 功能完善与增强](#3-p2--功能完善与增强) 5. [P3 — 体验优化与锦上添花](#4-p3--体验优化与锦上添花) 6. [P4 — 长期架构演进](#5-p4--长期架构演进) 7. [实施路线图](#6-实施路线图) --- ## 0. 优先级定义 | 等级 | 含义 | 建议时间 | |------|------|---------| | **P0** | 安全漏洞 / 数据风险 / 系统崩溃 | 1 周内 | | **P1** | 核心功能阻断或严重缺陷 | 2–4 周 | | **P2** | 功能缺口 / 重要增强 | 1–2 月 | | **P3** | 体验优化 / 锦上添花 | 按需排期 | | **P4** | 架构演进 / 平台扩展 | 中长期规划 | --- ## 1. P0 — 安全与基础设施 > 来源:代码审计报告 Critical 项 + 其他发现 ### 1.1 JWT 密钥强制生产配置 - **现状**:`sakura_cloud/core/config.py` 中 `jwt_secret_key` 默认值为 `"change-this-secret-in-production"`,任何人都可伪造 JWT - **方案**:启动时检测是否为已知默认值,若是则拒绝启动并输出明确的错误信息,引导运维设置 `JWT_SECRET_KEY` 环境变量 - **影响范围**:`sakura_cloud/core/config.py`、`sakura_cloud/core/security.py` ### 1.2 数据库凭据与 MinIO 凭据硬编码 - **现状**: - PostgreSQL 默认凭据 `sakura:sakura` - MinIO 默认凭据 `minioadmin:minioadmin` - **方案**:同 JWT 策略——启动时检测默认值,若未被覆盖则拒绝启动;为 MinIO 增加随机密码生成脚本 - **影响范围**:`sakura_cloud/core/config.py`、部署文档 ### 1.3 桌面端 → 云端启用 HTTPS - **现状**:`DEFAULT_CLOUD_API = "http://api.kunkunxiaomao.top:8000"` 使用明文 HTTP,用户凭据和文件明文传输 - **方案**: - 短期:支持 HTTP 但增加显式警告弹窗("当前使用非加密连接,凭据可能被窃取") - 长期:服务器配置 SSL 证书(Let's Encrypt / 自签名),客户端默认改为 HTTPS,初次连接时做证书校验引导 - **影响范围**:`pixiv_app/gui/app.py`、`pixiv_app/core/cloud_sync.py`、云端 nginx/Caddy 配置 ### 1.4 登录接口限流 - **现状**:`/api/v1/auth/login` 无限流,可暴力破解 - **方案**:对 `/login`、`/register`、`/token/refresh` 增加 IP 级别速率限制(如每分钟 5 次),使用 Redis 或内存计数器实现 - **影响范围**:`sakura_cloud/api/v1/endpoints/auth.py`、新增限流中间件 ### 1.5 笔趣阁插件 AES 密钥随机化 - **现状**:`plugins/biquge/plugin.py` 中 AES 密钥和 IV 从硬编码字符串经 MD5 派生,固定 IV 下的 CBC 模式可被已知明文攻击 - **方案**: - 每次加密使用随机 IV(`os.urandom(16)`),与密文一起传输 - 密钥从用户配置或安全随机源派生,而非硬编码 - **影响范围**:`plugins/biquge/plugin.py` ### 1.6 Chrome `--no-sandbox` 移除 - **现状**:小红书插件使用 `--no-sandbox` 禁用 Chromium 沙箱,浏览器以完整 OS 权限运行不受信任的外部内容 - **方案**:移除 `--no-sandbox`。若在 Docker/root 环境下必须使用,改为配置 `--cap-add=SYS_ADMIN` 或 seccomp profile - **影响范围**:`plugins/xiaohongshu/plugin.py` ### 1.7 Firebase 初始化竞态修复 - **现状**:`push_notifications.dart` 中 `_initialized = true` 在 `await Firebase.initializeApp()` **之前**设置,若初始化失败则永久不再重试 - **方案**:将 `_initialized = true` 移到 `await Firebase.initializeApp()` 成功之后 - **影响范围**:`sakura_mobile/lib/src/core/push_notifications.dart` ### 1.8 ProxyPool 多线程数据竞争 - **现状**:`current_index` 无锁读写、`working_proxies` 并发修改、`fail_count`/`success_count` 非原子递增 - **方案**:引入 `threading.Lock` 保护所有对共享数据的写操作;或将 `current_index` 改为 `itertools.cycle` + 原子计数器 - **影响范围**:`pixiv_app/core/proxy_pool.py` ### 1.9 敏感文件 `.gitignore` 完善 - **现状**:`.env.cloud.example` 已提供模板,但不清楚 `.env` 是否在 `.gitignore` 中;会话文件 `app_session.json` 可能被误提交 - **方案**:在 `.gitignore` 中显式添加 `*.env`(除 `.example`)、`app_session.json`、`runtime/`、`*.db`、`*.key` - **影响范围**:`.gitignore` --- ## 2. P1 — 核心体验缺陷 > 来源:代码审计报告 High/Medium 项 + 已知 bug + 功能缺口 ### 2.1 手机端 `recentUpdatesOnly` 死开关修复 - **现状**:`gallery_tab.dart` 中 `recentUpdatesOnly` 状态变量只控制 Chip 高亮,从未作为 API 参数传入 `_load()`,切换无实际效果 - **方案**:在 `_load()` 中将 `recentUpdatesOnly` 转换为 `order=updated_at` 或后端新增 `recent_only` 查询参数;或如果后端暂时不支持,先移除该 Chip - **影响范围**:`sakura_mobile/lib/src/pages/tabs/gallery_tab.dart` ### 2.2 Legado 书源搜索引擎完善 - **现状**:6 个默认种子源 `searchUrl` / `searchListRule` 全为 null,CSS 选择器解析不支持 class/ID/属性选择器,GBK 编码无容错 - **方案**(分两步): - **2.2a 引擎层**:扩展 CSS 选择器支持 class(`.classname`)、ID(`#id`)、属性(`[attr=val]`)、后代(`A B`)选择器;GBK 解码增加容错参数 - **2.2b 源数据层**:用真实可用的书源 JSON 替换默认种子源,或提供从 Legado 仓库一键导入的引导流程 - **影响范围**:`legado_rule_parser.dart`、`legado_engine.dart`、`source_manager.dart` ### 2.3 手机端发现页滚动卡死修复 - **现状**:发现页 Feed 向上滚动时可能卡在底部 - **方案**:排查 `feed_tab.dart` 中的 `ScrollController` 和分页加载逻辑,确保加载更多后正确更新 `hasMore` 状态,以及 `ListView` 的 `addPostFrameCallback` 不产生死循环 - **影响范围**:`sakura_mobile/lib/src/pages/tabs/feed_tab.dart` ### 2.4 Web 管理后台页面完善 - **现状**:普通用户 Web 端详情页已从占位改为真实加载,但管理后台可能仍有死角 - **方案**: - 完成管理员端用户管理、内容审核、统计面板页面 - 普通用户端确保图片/漫画/小说三种内容类型均有完整的列表+详情页 - **影响范围**:`sakura_admin_web/` ### 2.5 云同步上传失败队列与断点续传 - **现状**:`SAKURA_CLOUD_V1_STATUS.md` 明确标注"上传失败队列与断点恢复细节"尚未完成 - **方案**: - 桌面端新增 `sync_failures` 表记录上传失败的文件,支持自动/手动重试 - 上传分片支持断点续传(保存已上传分片索引) - 云端 `upload/complete` 接口增加分片校验 - **影响范围**:`pixiv_app/core/cloud_sync.py`、`sakura_cloud/api/v1/endpoints/upload.py` ### 2.6 Alembic 数据库迁移完善 - **现状**:SAKURA_CLOUD_V1_STATUS 标注 Alembic 迁移尚未完成 - **方案**:补全所有模型的 Alembic migration 脚本,确保 `alembic upgrade head` 一键建库;新增 CI 中检查迁移一致性 - **影响范围**:`sakura_cloud/migrations/` ### 2.7 手机端 App 正式签名 - **现状**:APK 使用调试签名,不适合正式分发;README 和用户手册均强调此限制 - **方案**: - 生成正式 keystore - 更新 `sakura_mobile/android/app/build.gradle.kts` 签名配置 - 文档更新,区分 debug/release 构建流程 - **影响范围**:`sakura_mobile/android/`、构建脚本 ### 2.8 桌面端 Cookie 过期自动检测与提醒 - **现状**:Pixiv Cookie 过期后抓取静默失败,用户需手动排查 - **方案**: - 在每次抓取前自动检测会话有效性(已有「检测会话」按钮逻辑,改为自动调用) - Cookie 将过期或已过期时弹窗提醒并引导重新导入 - **影响范围**:`pixiv_app/core/auth.py`、`pixiv_app/gui/app.py` ### 2.9 下载失败自动重试与错误分类 - **现状**:`runtime/executor.py` 已有基本重试与错误分类,但未区分限流(429)、临时故障(5xx)、权限错误(403/404) - **方案**: - 429 → 自动退避重试(指数退避 + 抖动) - 5xx → 有限重试(最多 2 次) - 403/404 → 不重试,直接标记失败 - 失败原因写入 `download_tasks` 表便于排查 - **影响范围**:`pixiv_app/runtime/executor.py`、`pixiv_app/tasks/models.py` ### 2.10 图库搜索性能优化 - **现状**:图库 SQLite 查询在大数据量下(数万条作品)可能变慢,标签模糊搜索使用 `LIKE '%keyword%'` 无法走索引 - **方案**: - 对 `artworks.title`、`artists.name`、`tags.name` 建立索引 - 标签搜索改为 FTS5 全文索引 - 云端的 `gallery` 查询为 `include_total` 参数已有优化,进一步对 `artworks.created_at`、`artworks.artist_id` 建立联合索引 - **影响范围**:`pixiv_app/core/library.py`、`sakura_cloud/models/artwork.py` --- ## 3. P2 — 功能完善与增强 ### 3.1 手机端推送通知(FCM) - **现状**:Firebase 已集成但推送链路不完整;当前"每日提醒"仅是应用内摘要,非系统级推送 - **方案**: - 完成 FCM token 注册与服务端对接 - 云端提醒生成后通过 FCM 发送系统通知 - 点击通知直接跳转到对应内容 - 用户可配置"仅 Wi-Fi 下推送"、"免打扰时段" - **影响范围**:`sakura_mobile/lib/src/core/push_notifications.dart`、`sakura_cloud/services/push.py` ### 3.2 插件市场在线对接 - **现状**:`PluginMarketClient` 为占位类,仅支持本地文件系统发现插件 - **方案**: - 云端提供 `/api/v1/plugins/` 端点(列表、下载、版本检查) - 桌面端「插件管理」面板增加"在线市场"标签页 - 支持一键安装/更新/卸载 - 插件版本兼容性检查 - **影响范围**:`pixiv_app/core/plugin/market.py`、`pixiv_app/gui/plugin_panel.py`、`sakura_cloud/` 新增端点 ### 3.3 视频下载与播放支持 - **现状**:X/Twitter 插件可抓取视频文件,但本地图库和缩略图墙未针对视频做优化;手机端无视频播放页 - **方案**: - 缩略图墙增加视频缩略图(自动截取首帧或使用平台提供的 thumbnail) - 手机端新增视频播放页(基于 `video_player` 插件) - 图库列表支持视频类型筛选 - **影响范围**:`pixiv_app/core/gallery_service.py`、`sakura_mobile/` 新增页面 ### 3.4 阅读进度跨设备同步 - **现状**:手机端小说阅读器记录阅读进度,但仅本地存储(`online_reading_history.dart`) - **方案**: - 云端新增 `/api/v1/reading-progress/` 端点(GET/PUT) - 手机端在进度变更时自动上报云端 - 桌面端缩略图墙也可展示阅读进度 - 多设备间同账号自动同步阅读位置 - **影响范围**:`sakura_mobile/lib/src/core/online_reading_history.dart`、`sakura_cloud/` 新增端点 ### 3.5 内容合集 / 专辑功能 - **现状**:作品可以按作者、标签归类,但没有用户自定义合集的能力 - **方案**: - 桌面端和手机端均支持创建"合集",将任意作品(图片/漫画/小说)归入合集 - 合集支持排序、封面设置、备注 - 云端同步合集数据 - **影响范围**:`pixiv_app/core/library.py`(新增表)、`sakura_cloud/models/`(新增模型)、`sakura_mobile/` 新增页面 ### 3.6 漫画连续阅读模式增强 - **现状**:手机端已有漫画分组与连续阅读,但体验可以更流畅 - **方案**: - 左右滑动翻页(当前可能仅支持上下滚动) - 预加载下一页/上一页(当前页 ± 2 页) - 阅读进度条(当前页/总页数) - 双击缩放、长按保存 - **影响范围**:`sakura_mobile/lib/src/pages/online_manga_reader_page.dart` ### 3.7 批量导出功能 - **现状**:用户可通过缩略图墙浏览,但无法批量导出原图 - **方案**: - 缩略图墙增加"批量选择 → 导出原图"功能 - 支持按作者/标签/收藏筛选后全选导出 - 导出格式:原图 ZIP 包或保持目录结构 - **影响范围**:`pixiv_app/core/gallery_service.py`、缩略图墙前端模板 ### 3.8 X (Twitter) 作者时间线监控 - **现状**:X 插件支持抓取作者媒体和单个推文,但缺少"监控作者新推文"的主动检测 - **方案**: - 桌面端新增"X 监控"面板,可添加监控的 X 用户名 - 定时轮询作者时间线,检测新推文 → 自动下载 → 写入云端关注提醒 - 与现有每日提醒系统打通 - **影响范围**:`plugins/x/`、`pixiv_app/core/x_media_service.py` ### 3.9 下载内容去重增强 - **现状**:`download_tasks` 表有 `fingerprint` 唯一约束,`artwork_files.content_hash` 字段已预留但默认空字符串 - **方案**: - 下载完成后计算文件 SHA256 并写入 `content_hash` - 新下载前先检查 `content_hash` 是否已存在,跳过重复文件 - 缩略图墙可展示"重复文件"列表,支持清理 - **影响范围**:`pixiv_app/core/downloader.py`、`pixiv_app/core/library.py` ### 3.10 代理池健康度评分 - **现状**:代理有 `fail_count` / `success_count` 但仅用于简单标记失败 - **方案**: - 引入代理健康度评分(成功率、响应延迟、可用性百分比) - 代理按健康度排序,优先使用高分代理 - 健康度过低的代理自动移出池 - 代理池 UI 展示健康度统计 - **影响范围**:`pixiv_app/core/proxy_pool.py` --- ## 4. P3 — 体验优化与锦上添花 ### 4.1 桌面端深色模式 - **现状**:GUI 锁定 `ctk.set_appearance_mode("light")` - **方案**:增加"外观"设置项——浅色 / 深色 / 跟随系统;`customtkinter` 原生支持 `dark` 模式,改动极小 - **影响范围**:`pixiv_app/gui/app.py` ### 4.2 缩略图墙 UI 现代化 - **现状**:缩略图墙是本地 WebUI(Jinja2 模板),功能齐全但 UI 风格较为基础 - **方案**: - 引入轻量 CSS 框架(如 Pico.css 或 Water.css)美化 - 支持网格/列表视图切换 - 图片懒加载(当前可能一次性加载所有缩略图) - 虚拟滚动(大量作品时性能优化) - **影响范围**:`pixiv_app/core/gallery_service.py`、模板文件 ### 4.3 手机端首页个性化配置 - **现状**:发现页展示"最近浏览的图片/漫画/小说"和"更新提醒" - **方案**: - 用户可选择发现页展示哪些模块(图片/漫画/小说/提醒) - 支持拖拽排序模块 - "继续阅读"模块(直接从上次阅读位置进入) - **影响范围**:`sakura_mobile/lib/src/pages/tabs/feed_tab.dart` ### 4.4 下载速度与流量统计 - **现状**:桌面端有进度条但无历史统计 - **方案**: - 记录每次下载的文件大小、耗时 - 主界面增加"本次会话下载量"和"总计下载量"统计 - 可查看每日/每周下载量趋势图(可选,使用 matplotlib) - **影响范围**:`pixiv_app/gui/app.py`、`pixiv_app/core/library.py` ### 4.5 国际化(i18n)支持 - **现状**:GUI 和手机端 UI 均为中文硬编码 - **方案**: - 桌面端:提取所有 UI 字符串到 JSON 语言文件,支持中文/英文/日文 - 手机端:使用 Flutter `intl` / `easy_localization` 实现多语言 - 优先完成英文翻译以扩大用户群 - **影响范围**:全局 UI ### 4.6 错误日志收集与诊断 - **现状**:日志分散在 `日志/` 目录和终端输出,排查问题需手动翻找 - **方案**: - 桌面端增加"一键导出诊断包"按钮(日志 + 配置 + 数据库状态摘要,压缩为 ZIP) - 手机端增加"上传诊断日志"功能 - 云端增加错误聚合面板(按错误类型/时间统计) - **影响范围**:`pixiv_app/`、`sakura_mobile/`、`sakura_cloud/` ### 4.7 桌面端系统托盘与后台运行 - **现状**:关闭 GUI 窗口即退出程序 - **方案**: - 最小化到系统托盘(使用 `pystray` 或 `customtkinter` 配合系统托盘库) - 托盘菜单:显示/隐藏窗口、开始/停止抓取、退出 - 下载完成后托盘气泡提示 - **影响范围**:`pixiv_app/gui/app.py` ### 4.8 自动更新检查 - **现状**:用户需手动关注 releases 目录获取新版本 - **方案**: - 桌面端启动时检查云端最新版本号 - 有新版本时提示下载,可选"自动下载 → 下次启动替换" - 手机端同理(检查 APK 版本号) - **影响范围**:`pixiv_app/gui/app.py`、`sakura_mobile/lib/src/app.dart`、`sakura_cloud/` 新增版本检查端点 --- ## 5. P4 — 长期架构演进 ### 5.1 桌面端从 CustomTkinter 迁移到更现代化的 GUI 框架 - **理由**:CustomTkinter 功能有限,深色模式、动画、富文本等支持较弱;Windows 11 下风格略显过时 - **候选方案**: - **Tauri (Rust + Web 前端)**:体积小、性能好、现代 UI,但需重写全部 Python 逻辑为 Rust 或通过 sidecar 通信 - **Electron + Python 后端**:重用现有 Python 下载引擎,Electron 负责 UI,但体积大(~150MB+) - **PySide6 / PyQt6**:纯 Python 方案,迁移成本最低,支持 QSS 样式和丰富控件 - **Flet (Flutter for Python)**:用 Python 写 Flutter UI,可与现有 Flutter 移动端共享设计语言 - **建议**:优先评估 **Flet**(与 Flutter 移动端风格统一、纯 Python)或 **PySide6**(迁移成本最低)。不宜急于重写,等 P0/P1 完成后评估 ### 5.2 iOS 客户端 - **理由**:当前仅支持 Android,iOS 用户无法使用 - **方案**: - Flutter 跨平台特性使得 iOS 适配成本较低(大部分 Dart 代码可复用) - 需额外处理:iOS 文件系统权限、后台任务限制、APNs 推送替代 FCM - 需要 Apple Developer Program 账号($99/年)用于签名分发 - **影响范围**:`sakura_mobile/ios/`(生成)、`sakura_mobile/lib/`(少量平台适配) ### 5.3 Web 端 PWA(渐进式 Web 应用) - **理由**:桌面端 EXE 体积大(~68MB),部分用户只希望轻量浏览 - **方案**: - 将缩略图墙升级为 PWA(Service Worker + 离线缓存 + 可安装到桌面) - 或单独开发 `sakura_web` 前端项目替代当前 `sakura_admin_web` - **影响范围**:`sakura_admin_web/` 或新建 `sakura_web/` ### 5.4 分布式爬虫完善 - **现状**:`distributed_crawler/` 目录有 Master-Worker 架构但尚不完整 - **方案**: - 补全 Worker 节点注册、心跳、任务分配 - Master 面板(Web UI)展示各 Worker 状态和任务进度 - Docker Compose 一键部署 Master + N Workers - **影响范围**:`distributed_crawler/` ### 5.5 AI 辅助功能 - **理由**:PaddleOCR 已集成,可在其基础上扩展更多 AI 能力 - **方案**: - **AI 标签自动生成**:对下载的图片使用轻量视觉模型(如 MobileNet/EfficientNet)自动打标签 - **翻译增强**:手机端小说翻译当前仅支持"当前页翻译",可升级为整本翻译 + 双语对照 - **图片去重**:基于感知哈希(pHash/dHash)的相似图片检测 - **内容安全扫描**:对上传至云端的内容进行自动安全审核(NSFW 检测) - **影响范围**:`pixiv_app/core/ocr.py`、`sakura_cloud/services/ocr.py` ### 5.6 多用户/家庭共享 - **现状**:云同步为单用户设计,无分享功能 - **方案**: - 云端新增"家庭组"/"共享空间"概念 - 用户可邀请其他账号加入共享空间 - 共享空间内的内容(图库/小说/漫画)成员均可访问 - 权限控制:管理员/编辑/只读 - **影响范围**:`sakura_cloud/` 新增模型与端点、手机端新增分享页面 --- ## 6. 实施路线图 ### 第一阶段:安全加固(第 1–2 周) ``` P0-1 JWT 密钥强制生产配置 ████████░░░░░░░░ 1d P0-2 数据库/MinIO 凭据强制覆盖 ████████░░░░░░░░ 1d P0-3 HTTPS 支持 + 警告 ████████████░░░░ 1.5d P0-4 登录接口限流 ████████░░░░░░░░ 1d P0-5 笔趣阁 AES 随机化 ████░░░░░░░░░░░░ 0.5d P0-6 Chrome --no-sandbox 移除 ████░░░░░░░░░░░░ 0.5d P0-7 Firebase 初始化竞态修复 ████░░░░░░░░░░░░ 0.5d P0-8 ProxyPool 线程安全 ████████░░░░░░░░ 1d P0-9 .gitignore 完善 ████░░░░░░░░░░░░ 0.5d ──────────────────────────────────────────────────────── 小计约 7.5 人天 ``` ### 第二阶段:体验修复(第 3–6 周) ``` P1-1 手机端死开关修复 ████░░░░░░░░░░░░ 0.5d P1-2 Legado 搜索引擎完善 ████████████████ 4d P1-3 发现页滚动卡死 ████████░░░░░░░░ 2d P1-4 Web 管理后台完善 ████████████░░░░ 3d P1-5 上传失败队列 + 断点续传 ████████████████ 4d P1-6 Alembic 迁移 ████████░░░░░░░░ 2d P1-7 正式签名 ████░░░░░░░░░░░░ 1d P1-8 Cookie 过期自动检测 ████████░░░░░░░░ 2d P1-9 下载失败重试优化 ████████░░░░░░░░ 2d P1-10 图库搜索性能 ████████████░░░░ 3d ──────────────────────────────────────────────────────── 小计约 23.5 人天 ``` ### 第三阶段:功能增强(第 7–14 周) ``` P2-1 FCM 推送通知 ████████████████ 5d P2-2 插件市场在线对接 ████████████████ 5d P2-3 视频下载与播放 ████████████░░░░ 4d P2-4 阅读进度跨设备同步 ████████████░░░░ 4d P2-5 内容合集/专辑 ████████████████ 5d P2-6 漫画连续阅读增强 ████████░░░░░░░░ 3d P2-7 批量导出 ████████████░░░░ 4d P2-8 X 作者时间线监控 ████████████░░░░ 4d P2-9 下载去重增强 ████████░░░░░░░░ 3d P2-10 代理池健康度评分 ████████░░░░░░░░ 3d ──────────────────────────────────────────────────────── 小计约 40 人天 ``` ### 第四阶段及以后(按需排期) ``` P3-1 深色模式 ████░░ 1d P3-2 缩略图墙 UI 现代化 ██████ 2d P3-3 首页个性化 ██████ 2d P3-4 下载统计 ████░░ 1.5d P3-5 国际化 ██████ 3d P3-6 错误诊断包 ██████ 2d P3-7 系统托盘 ██████ 2d P3-8 自动更新 ██████ 2d P4-X 长期架构演进 TBD ──────────────────────────────────────────────────────── 小计约 15.5 人天 ``` ### 关键里程碑 | 里程碑 | 时间 | 交付物 | |--------|------|--------| | **M1: 安全基线** | 第 2 周末 | 所有 P0 项修复完成,安全审计复测通过 | | **M2: 体验基线** | 第 6 周末 | 所有 P1 项修复完成,核心链路无阻断 | | **M3: 功能补全** | 第 14 周末 | P2 主要项完成,推送/插件市场/跨设备进度同步可用 | | **M4: 体验升级** | 第 20 周末 | P3 项完成,深色模式/国际化/自动更新上线 | --- ## 附录:已完成功能清单(便于对照) | 模块 | 已具备能力 | |------|-----------| | **桌面端** | 多平台抓取、Cookie/密码登录、插件系统、本地图库 SQLite、缩略图墙 WebUI、云同步、代理池、任务队列 + 增量同步、OCR | | **云端** | FastAPI REST API、JWT 认证、图库/小说/文件 CRUD、关注管理、每日提醒摘要、分片上传、健康检查 | | **手机端** | 登录注册、发现/图片/漫画/书架/我的 五个标签页、小说阅读器(分页/收藏/翻译/进度)、漫画分组阅读、书源管理+Legado 引擎、在线搜索、FCM(部分) | | **插件** | Pixiv、X/Twitter、小红书、笔趣阁、长佩文学、AO3 | | **DevOps** | 一键构建 EXE/APK、Docker Compose 部署、Alembic 迁移 | --- *本文档由代码审计报告、产品文档、CHANGELOG、SAKURA_CLOUD_V1_STATUS 及全仓库源码分析综合生成,供开发排期与需求评审参考。*