Files
SakuraHub/docs/优化方案与功能规划.md
T
2026-11-16 20:45:22 +08:00

508 lines
25 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 樱云下载器 — 优化方案与功能规划
> 版本: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 及全仓库源码分析综合生成,供开发排期与需求评审参考。*