Files
SakuraHub/docs/代码审计报告.md
2026-11-16 20:45:22 +08:00

411 lines
27 KiB
Markdown
Raw Permalink 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.
# 代码审计报告
> 审计日期:2026-06-16
> 审计范围:全项目(Flutter 移动端 30 个文件 + Python 桌面端 16 个文件 + Cloud 后端 10 个文件 + 5 个插件)
> 发现总数:111 项(Critical 9 / High 20 / Medium 46 / Low 36)
---
## 目录
1. [Critical(紧急修复)](#一critical紧急修复)
2. [High(高危)](#二high高危)
3. [Medium(中危)](#三medium中危)
4. [Low(低危)](#四low低危)
5. [跨模块问题汇总](#五跨模块问题汇总)
6. [修复优先级建议](#六修复优先级建议)
---
## 一、Critical(紧急修复)
### C1. Cloud 后端:JWT 密钥使用已知默认值
- **文件:** `sakura_cloud/core/config.py:29`
- **代码:** `jwt_secret_key: str = Field(default="change-this-secret-in-production", min_length=16)`
- **问题:** 默认 JWT 密钥是公开的占位字符串。如果运维人员忘记设置 `JWT_SECRET_KEY` 环境变量,任何知道此默认值的人都可以伪造任意用户的 JWT token,获得完全未授权访问。
- **修复:** 生产环境启动时检测是否为默认值,若是则拒绝启动并输出明确错误信息。不使用带默认值的 `Field`,改用 `Field(default=None)` 并在启动时校验。
### C2. 笔趣阁插件:硬编码 AES 密钥和 IV
- **文件:** `plugins/biquge/plugin.py:60-67`
- **代码:**
```python
TOKEN_SECRET = "book@token.html"
TOKEN_MD5 = hashlib.md5(TOKEN_SECRET.encode("utf-8")).hexdigest()
TOKEN_IV = TOKEN_MD5[:16].encode("utf-8")
TOKEN_KEY = TOKEN_MD5[16:].encode("utf-8")
```
- **问题:** AES 密钥和 IV 从硬编码字符串经 MD5 派生,任何人看到源代码即可解密和伪造 API token。固定 IV 下的 CBC 模式使相同明文产生相同密文,可被已知明文攻击。这不是加密,是混淆。
- **修复:** 每次加密使用随机 IV(`os.urandom(16)`),密钥从用户配置或安全随机源派生。
### C3. 小红书插件:`--no-sandbox` 禁用 Chromium 安全沙箱
- **文件:** `plugins/xiaohongshu/plugin.py:361`
- **代码:** `"args": ["--disable-blink-features=AutomationControlled", "--no-sandbox"]`
- **问题:** `--no-sandbox` 完全禁用 Chromium 沙箱,浏览器进程以完整 OS 权限运行。小红书的页面是不受信任的外部内容——如果渲染引擎存在漏洞被利用,攻击者获得主机系统的无限制访问权。
- **修复:** 移除 `--no-sandbox`。如果必须在 Docker/root 环境运行,使用 `--cap-add=SYS_ADMIN` 或配置 seccomp profile,而非全局禁用沙箱。
### C4. Cloud 后端:数据库默认凭据 `sakura:sakura`
- **文件:** `sakura_cloud/core/config.py:17`
- **代码:** `database_url: str = "postgresql+psycopg://sakura:sakura@localhost:5432/sakura_cloud"`
- **问题:** 默认数据库用户名和密码都是 `sakura`。如果部署时未覆盖 `DATABASE_URL`,数据库对任何能访问 `localhost:5432` 的人开放。
- **修复:** 同 C1——生产环境启动时检测默认值并拒绝启动。
### C5. Cloud 后端:MinIO 默认凭据 `minioadmin:minioadmin`
- **文件:** `sakura_cloud/core/config.py:24-25`
- **代码:** `minio_access_key: str = "minioadmin"` / `minio_secret_key: str = "minioadmin"`
- **问题:** 这是 MinIO 官方默认凭据。如果 MinIO 端点暴露在网络上,任何人可以访问所有用户存储的文件。
- **修复:** 同上——启动时检测是否为默认值,若是则拒绝启动。
### C6. 桌面端:云同步 API 使用明文 HTTP
- **文件:** `pixiv_app/gui/app.py:54`
- **代码:** `DEFAULT_CLOUD_API = "http://api.kunkunxiaomao.top:8000"`
- **问题:** 使用 HTTP 而非 HTTPS。用户凭据(邮箱、密码、access token)和上传文件内容以明文在网络上传输。同一网络上的攻击者可通过被动嗅探截获所有认证凭据和文件数据。
- **修复:** 改为 `http://api.kunkunxiaomao.top`(如果服务器支持 HTTPS)。最差情况下至少做出显式警告。
### C7. Flutter:`_initialized` 标志在 Firebase 初始化成功前设置
- **文件:** `sakura_mobile/lib/src/core/push_notifications.dart:27-29`
- **代码:** `_initialized = true` 在 `await Firebase.initializeApp()` **之前**设置
- **问题:** 如果 `Firebase.initializeApp()` 抛出异常,`_initialized` 已经是 `true`,导致后续 `initialize()` 调用全部命中 `if (_initialized) return` 的 early return,Firebase 永远无法重试初始化。推送功能永久失效,无任何提示。
- **修复:** 将 `_initialized = true` 移到 `await Firebase.initializeApp()` 成功之后。
### C8. Flutter:`recentUpdatesOnly` 是死开关(dead UI switch)
- **文件:** `sakura_mobile/lib/src/pages/tabs/gallery_tab.dart:32,120`
- **问题:** `recentUpdatesOnly` 状态变量控制哪个 Chip 显示"已选中",但 `_load()` 方法从未将其作为查询参数传给 API。用户看到的"最近更新"筛选切换实际上没有任何效果。
- **修复:** 在 `_load()` 中将 `recentUpdatesOnly` 转换为对应的 API 参数,或者移除该 Chip。
### C9. 桌面端:ProxyPool 的多线程数据竞争
- **文件:** `pixiv_app/core/proxy_pool.py:193,272-273,278-279`
- **问题:**
1. `ProxyPool.current_index` 的读取(line 272)和递增(line 273)之间无锁保护,`ThreadPoolExecutor` 的多个 worker 同时调用 `get_proxy()` 时产生重复或跳跃的索引
2. `ProxyPool.working_proxies` 被 `mark_failed()` 的 `.remove()` 修改,而其他线程可能正在迭代它——可抛出 `ValueError` 或不一致迭代
3. `ProxyInfo.fail_count` 和 `success_count` 的非原子递增在 `ThreadPoolExecutor` 16 个 worker 并行调用 `verify_proxy()` 时静默丢失计数
- **修复:** 使用 `threading.Lock` 保护所有对 `working_proxies`、`current_index` 的写操作,`fail_count`/`success_count` 改用 `threading` 安全计数或原子操作。
---
## 二、High(高危)
### H1. Cloud 后端:用户登录无限流 → 可暴力破解
- **文件:** `sakura_cloud/api/v1/endpoints/auth.py:56-76`
- **问题:** `/login` 端点无限流(`admin_login_rate_limit_per_minute` 只用于 admin 端点)。攻击者可无限制尝试密码组合进行暴力破解。
- **修复:** 对 `/login`、`/register`、`/token/refresh` 增加速率限制(如每 IP 每分钟 5 次)。
### H2. Cloud 后端:用户注册无限流 + 信息泄露
- **文件:** `sakura_cloud/api/v1/endpoints/auth.py:24-53`
- **问题:** `/register` 端点无限流。409 响应明确区分"用户名已存在"和"邮箱已存在",可用于枚举已注册用户。
- **修复:** 加速率限制。错误消息统一为"注册失败,请检查输入"。
### H3. Cloud 后端:存储配额未强制执行
- **文件:** `sakura_cloud/api/v1/endpoints/gallery.py:223`、`sync.py:86-141`
- **问题:** `default_storage_limit_bytes` 在 config 中定义了(line 108-109),但在创建 artwork 和同步 metadata 时**从未检查** `current_user.storage_used` 是否超过配额。用户可以上传无限制的数据。
- **修复:** 在 `gallery.py` 和 `sync.py` 的写入路径中增加 `if current_user.storage_used + new_size > limit: raise HTTPException(413)`。
### H4. Cloud 后端:Logout 不撤销 token
- **文件:** `sakura_cloud/api/v1/endpoints/auth.py:79-81`
- **问题:** `/logout` 只返回 `{"ok": True}`,不做任何 token 撤销操作。access token 在其自然过期(最长 24 小时)前持续有效。用户登出后无法阻止 token 被盗用。
- **修复:** Logout 时递增 `user.token_version`,使当前所有 token 立即失效。
### H5. Cloud 后端:Refresh token 轮转不撤销旧 token
- **文件:** `sakura_cloud/api/v1/endpoints/auth.py:84-104`
- **问题:** 交换 refresh token 时签发新的 access + refresh token,但旧的 refresh token 未失效。如果 refresh token 被盗,攻击者和合法用户都可以持续刷新——直到某人重新登录(才会 bump `token_version`)。
- **修复:** 实现 refresh token 轮转——每次使用时废弃旧 token 并签发新的。
### H6. 桌面端 & Flutter:敏感凭据多处明文存储
|| 位置 | 凭据类型 | 存储方式 |
||------|---------|---------|
|| `pixiv_app/core/auth.py:36-41` | Pixiv cookie | JSON 文件明文 |
|| `plugins/pixiv/plugin.py:42-43` | Pixiv cookie | 内存明文 |
|| `plugins/x/plugin.py:76` | X/Twitter cookies | `x_cookies.json` 明文 |
|| `plugins/ao3/plugin.py:687-688` | AO3 cookie | 内存明文 |
|| `plugins/xiaohongshu/plugin.py:386-404` | 小红书 cookies | `xiaohongshu_cookies.json` 明文 |
|| `pixiv_app/core/proxy_pool.py:67-68` | Quake API key | `app_session_file()` JSON 明文 |
|| `sakura_mobile/lib/src/core/session.dart:44-47` | Access token | SharedPreferences 明文 |
- **修复:** 生产环境使用操作系统密钥链(Windows DPAPI / macOS Keychain / Android Keystore)。最低限度应对配置文件设置受限的文件权限。
### H7. Flutter:小说阅读页面翻页不节流 → API 洪泛
- **文件:** `sakura_mobile/lib/src/pages/novel_reader_page.dart:787-790`
- **问题:** `onPageChanged` 对**每次翻页**同步调用 `updateNovelProgress(currentNovel.id, page)`。快速翻页时数十上百个 API 请求瞬间发出,压垮服务器并浪费电量/带宽。
- **修复:** 增加 500ms 防抖,只发送最终位置。
### H8. Flutter:探索页从"插画"tab 点搜索 → 打开"小说"模式
- **文件:** `sakura_mobile/lib/src/pages/tabs/gallery_tab.dart:398-399`
- **问题:** 用户在"图片"(illust)tab 点击在线搜索时,代码 `widget.fixedContentType != 'manga'` 为真,传入 `UnifiedSearchMode.novel`。从图片页搜索却打开了小说搜索模式。
- **修复:** 将 explore mode 与 gallery content type 解耦。默认为 manga 模式(漫画源更多)。或增加一个独立的选择器。
### H9. Flutter:Session 构造器中异步工作不可 await
- **文件:** `sakura_mobile/lib/src/core/session.dart:44-47`
- **问题:** `SessionController()` 构造器中调用异步 `_load()`,但构造器不能 `async`。Provider 观察者先看到默认 loading 态再被 `_load()` 完成后的 `notifyListeners()` 更新。Provider 初始化异常无法被外部捕获。
- **修复:** 使用 Riverpod 的 `FutureProvider` 或 `AsyncNotifier`,或将初始化方法显式暴露给 widget tree 调用。
### H10. Flutter:`_validateStoredSession` 静默吞所有异常
- **文件:** `sakura_mobile/lib/src/core/session.dart:159`
- **问题:** `catch (_)` 捕获所有异常返回 `null`,不记录日志。网络故障或服务器宕机时用户被静默登出,无任何提示。
- **修复:** 最低限度 `debugPrint(e)`。更好:区分网络错误(可恢复)和认证错误(需重新登录),并显示对应 UI。
### H11. Cloud 后端:JWT 缺少 `aud`/`iss` 声明验证
- **文件:** `sakura_cloud/core/security.py:23-32,53-62`
- **问题:** Token 创建时不设置 `aud`(受众)和 `iss`(签发者),`decode_token` 也不验证。如果同一 JWT 密钥被意外共享,一个服务的 token 可在另一个服务中复用。
- **修复:** 创建 token 时设置 `aud="sakura-cloud"`,解码时验证。
### H12. 小红书插件:代理凭据暴露在 URL 字符串中
- **文件:** `plugins/xiaohongshu/plugin.py:107-110`
- **问题:** `ProxyConfig.url` 属性将明文用户名密码嵌入 URL:`"https://user:pass@host:port"`。如果这个 URL 字符串被记录到 Playwright 调试日志、异常堆栈或错误消息中,凭据泄露。
- **修复:** 通过 Playwright 的 `proxy` context 选项分别传入 `username`/`password`(lines 368-371 已部分正确),`.url` 属性不包含凭据。
### H13. Flutter:默认 API URL 用 HTTP 明文
- **文件:** `sakura_mobile/lib/src/core/api_client.dart:9`
- **代码:** `const defaultCloudApi = 'http://api.kunkunxiaomao.top:8000'`
- **问题:** 与桌面端 C6 相同——明文 HTTP 传输所有凭据和内容。
- **修复:** 改为 HTTPS。
### H14. Flutter:Push notification token refresh 监听器持有过期凭据
- **文件:** `sakura_mobile/lib/src/core/push_notifications.dart:66-83`
- **问题:** `onTokenRefresh.listen` 捕获注册时的 `baseUrl` 和 `accessToken`。如果用户后续登录其他服务器或换号,监听器仍用旧凭据,导致 push 注册静默失败(line 79 catch 吞错)。
- **修复:** 每次 token 刷新时从当前 provider 读取最新凭据。
### H15. 桌面端:SQLite 跨线程共享缺少显式锁
- **文件:** `pixiv_app/core/library.py:29`
- **代码:** `check_same_thread=False` 允许跨线程共享连接,"当有锁保护时"——但锁的保护由调用者负责且不一致。
- **问题:** `TaskQueue`(`enqueue.py:232`)将连接传给多个 `ThreadPoolExecutor` worker,没有外部锁。WAL 模式下 SQLite 通常能处理,但高并发写入时仍可能 `SQLITE_BUSY`。
- **修复:** 改用连接池(如 `sqlite3` 的 URI 模式 `file:path?mode=rw`),或每个 worker 使用独立连接。
### H16. 桌面端:画廊同步对每个文件行新开 DB 连接(O(N) 连接泛滥)
- **文件:** `pixiv_app/gui/app.py:2175-2184`
- **问题:** `_sync_pixiv_rows` 中**每个文件行**都调用 `sqlite3.connect(DEFAULT_LIBRARY_DB)` → 查询 → `close()`。100 个文件同步 = 100 次 DB 打开/关闭循环。性能低下且在高负载下可能触及 OS 文件描述符上限。
- **修复:** 复用单个连接或将查询批量化。
### H17. Cloud 后端:用户登录无限流(跨所有端点)
- **问题范围:** `/login`(auth.py:56)、`/register`(auth.py:24)、`/token/refresh`(auth.py:84)、所有 gallery 端点、所有 novel 端点、所有 sync 端点——除 admin 外**无一有限流**。
- **修复:** 全局应用 rate limiting 中间件(如 `slowapi` 或自定义中间件)。
### H18. Cloud 后端:`--no-sandbox` 同样存在于 X 插件
- **文件:** `plugins/x/plugin.py`(Playwright 启动参数)
- **问题:** 与 C3 相同风险。X/Twitter 页面同样是不受信任的外部内容。
- **修复:** 移除或至少评估必要性。
### H19. 桌面端:N+1 查询模式在关注作者同步中
- **文件:** `pixiv_app/core/gallery_service.py:547-561`
- **问题:** `sync_followed_artists` 对每个关注的作者创建 → 查询 → 关闭独立的 `PixivLibrary` 实例。50 个作者 = 100+ 次 DB 打开/关闭。
- **修复:** 使用池化或缓存的连接。
### H20. Flutter:多个页面存在静默吞错 → 空列表
|| 文件 | 位置 | 模式 |
||------|------|------|
|| `novels_tab.dart` | 63-67 | `.catchError((_) => <dynamic>[])` |
|| `api_client.dart` | 532 | `_readCache` catch 返回 null |
|| `providers.dart` | 17-21 | `initializeIfFirstRun()` 的 future 被丢弃 |
- **影响:** API 失败时用户看到空书架/空画廊/空收藏,无法区分"真的没数据"和"加载失败了"。
- **修复:** 区分 error 状态并在 UI 中显示错误提示和重试按钮。
---
## 三、Medium(中危)
### 后端
| # | 文件 | 行号 | 问题 |
|---|------|------|------|
| M1 | `sakura_cloud/main.py` | 130-131 | asyncio background task 无引用监控,异常静默死亡 |
| M2 | `sakura_cloud/api/middleware.py` | 77 | `img-src https: http:` 完全取消 CSP 图片保护 |
| M3 | `sakura_cloud/api/middleware.py` | 79 | `style-src 'unsafe-inline'` 可被 XSS 利用 |
| M4 | `sakura_cloud/core/config.py` | 31 | access token 有效期 24h 过长,token 被盗后窗口大 |
| M5 | `sakura_cloud/core/config.py` | 56-58 | FCM 默认启用但无有效凭据,运行时报错 |
| M6 | `sakura_cloud/core/config.py` | 18 | Redis 默认 URL 无密码认证 |
| M7 | `sakura_cloud/api/v1/endpoints/gallery.py` | 324-332 | 删除 artwork 时文件不清理 → 磁盘孤儿文件累积 |
| M8 | `sakura_cloud/api/v1/endpoints/novels.py` | 53-73 | GET 请求触发 DB 写操作(`_resolve_novel_storage_path`),违反 REST 幂等性 |
| M9 | `sakura_cloud/api/v1/endpoints/files.py` | 39 | 缩略图生成同步阻塞 FastAPI 事件循环 |
| M10 | `sakura_cloud/api/v1/endpoints/sync.py` | 38,100,138 | metadata dict 无大小限制 → 数据库 bloat 攻击 |
| M11 | `sakura_cloud/api/v1/endpoints/sync.py` | 37,99,138 | tags 列表无长度/元素限制 → 数据库 bloat 攻击 |
| M12 | `sakura_cloud/api/v1/endpoints/auth.py` | 9 | 密码复杂度仅 `min_length=8`,弱密码可过 |
| M13 | `pixiv_app/core/downloader.py` | 46-48 | 文件名未做长度限制,Windows MAX_PATH 260 字符溢出导致 OSError |
| M14 | `pixiv_app/core/downloader.py` | 476,502,537 | 大量 `except Exception: continue` 静默丢错,生产调试不可能 |
| M15 | `pixiv_app/core/downloader.py` | 690,901-945 | 每个作品创建新 `requests.Session()`(无 keep-alive),100 作品 = 100 次 TLS 握手 |
| M16 | `pixiv_app/core/gallery_service.py` | 399-414 | `_create_sync_manager` 在 3 个文件中重复实现 |
| M17 | `pixiv_app/core/origin_follow_sync.py` | 103 | `asyncio.run()` 在可能已有 event loop 的同步上下文中调用 |
| M18 | `pixiv_app/core/proxy_pool.py` | 213 | 代理测试时 `verify=False`,代理自身可 MITM 注入虚假成功结果 |
| M19 | `pixiv_app/core/auth.py` | 36-41 | `SessionStore.load()` 用裸 `except Exception` 吞所有异常(JSON 损坏、权限错误等) |
| M20 | `pixiv_app/core/gallery_service.py` | 79-81 | tag 筛选用 `JOIN`(非 `LEFT JOIN`),孤儿 `artwork_tags` 行导致作品静默遗漏 |
| M21 | `pixiv_app/core/downloader.py` | 698 | `int(detail.get("pageCount") or 0)` 遇非数字字符串抛 `ValueError` |
### 插件
| # | 文件 | 行号 | 问题 |
|---|------|------|------|
| M22 | `plugins/pixiv/plugin.py` | 243-244 | 文件名从 URL 提取,URL 编码的 `%2F` 可绕过 `rsplit` 做路径穿越 |
| M23 | `plugins/x/plugin.py` | 217-218,386 | 每次操作启动新 Playwright browser context,无复用 → 资源耗尽 |
| M24 | `plugins/biquge/plugin.py` | 845-867 | Playwright page 实例缓存跨操作复用,一次失败污染后续 |
| M25 | `plugins/ao3/plugin.py` | 503-506 | EPUB 解压无 zip bomb 防护,压缩炸弹可 OOM |
| M26 | `plugins/ao3/plugin.py` | 92-96 | `Retry-After` 头无上限,`Retry-After: 999999999` 可使插件休眠 ~31 年 |
| M27 | `plugins/xiaohongshu/plugin.py` | 377 | `headless=False` 在服务器/无 GUI 环境运行失败 |
| M28 | `plugins/xiaohongshu/plugin.py` | 480-588 | `page.evaluate()` 执行不受信任页面的 JS,结果未经域名验证 |
| M29 | `plugins/xiaohongshu/plugin.py` | 630-648 | 下载图片时转发页面所有 cookies 给图片 CDN(含第三方追踪 cookie) |
### Flutter
| # | 文件 | 行号 | 问题 |
|---|------|------|------|
| M30 | `api_client.dart` | 440-502 | `translateText()` 每次调用创建并销毁新的 Dio 实例 |
| M31 | `api_client.dart` | 518-535 | `_readCache<T>` 泛型类型不安全——声称返回任何 T 但 SharedPreferences 只存 JSON 基本类型 |
| M32 | `providers.dart` | 17-21 | `sourceManager.initializeIfFirstRun()` 是 async 但返回值被丢弃 |
| M33 | `app.dart` | 24 | 硬编码 Windows 字体 `Microsoft YaHei UI`,iOS/macOS/Linux 回退不一致 |
| M34 | `gallery_tab.dart` | 269-278 | 收藏/取消收藏触发全量列表重载(`_refresh()`),非单项更新 |
| M35 | `gallery_tab.dart` | 336-367 | 批量下载用 `for` + 顺序 `await`,无并发无进度 |
| M36 | `login_page.dart` | 141 | TabBarView 高度硬编码 430px,不同屏幕尺寸下可能裁剪或留白 |
| M37 | `novel_reader_page.dart` | 17-32 | 14 个可变实例字段——翻页设置(字号/行高/主题)在每次页面跳转时丢失 |
| M38 | `novel_detail_page.dart` | 67 | 硬编码 `430`px 滚动偏移到目录区,不随内容高度自适应 |
| M39 | `reminder_center_page.dart` | 22-35 | `results[0]! as Map` 等不安全类型强转,API 返回异常形状时抛 `TypeError` |
| M40 | `profile_tab.dart` | 403 | `logout()` 是 async 但 button onPressed 丢弃返回的 Future |
| M41 | `profile_tab.dart` + `reminder_center_page.dart` | 44-97 | 提醒时间设置逻辑完全重复两份 |
| M42 | `favorites_page.dart` | 51-54 | 每次点击 artwork 都重新执行 O(n) 的 `buildMangaCollections` |
| M43 | `novels_tab.dart` | 461 | epoch 0 作为时间戳兜底 → 显示"53 年前",无意义 |
| M44 | `manga_collections.dart` | 59 | 不同 null-author 作者的同名作品被错误合并为同一合集 |
### Cloud 后端(补充)
| # | 文件 | 行号 | 问题 |
|---|------|------|------|
| M45 | `sakura_cloud/main.py` | 123-126 | 启动时 digest 发送失败仅打日志,无告警 |
| M46 | `sakura_cloud/core/security.py` | 54-59 | `decode_token` 冗余手动检查 `exp`,且未设 clock skew 容差 |
---
## 四、Low(低危)
### 后端
| # | 文件 | 行号 | 问题 |
|---|------|------|------|
| L1 | `sakura_cloud/main.py` | 113-131 | startup 事件阻塞事件循环,无就绪探针/超时 |
| L2 | `sakura_cloud/api/middleware.py` | 32-42 | debug 模式 CSP `connect-src` 开放 `localhost:*`(所有本地端口) |
| L3 | `sakura_cloud/api/deps.py` | 29 | `str(user_id)` 对 None 产生字面字符串 `"None"` |
| L4 | `sakura_cloud/api/deps.py` | 34 | `token_version` 比较中,双方都为 0/None 时通过,旧 token 缺少 `tv` 声明不被拒绝 |
| L5 | `sakura_cloud/core/config.py` | 89-103 | `json.loads()` 在 field validator 中内联 import,不标准 |
| L6 | `sakura_cloud/api/v1/endpoints/auth.py` | 79-81 | logout 不递增 `token_version` |
| L7 | `sakura_cloud/api/v1/endpoints/gallery.py` | 51-97 | `ILIKE` + `plainto_tsquery` 用户输入无长度限制 → 可能触发慢查询 |
| L8 | `sakura_cloud/api/v1/endpoints/files.py` | 32 | `original_name` 用户可控 → 下载附件名可用于社工 |
| L9 | `sakura_cloud/api/v1/endpoints/sync.py` | 25 | SHA256 字段只验证长度不验证 hex 字符 |
| L10 | `sakura_cloud/api/v1/endpoints/sync.py` | 144-157 | 设备注册无每用户数量上限 |
| L11 | `pixiv_app/core/downloader.py` | 40 | `PixivRequestError` 继承 `RuntimeError` 而非 `Exception`(语义不当) |
| L12 | `pixiv_app/core/downloader.py` | 233 | `str(user_id).isdigit()` 中 `user_id` 可能为 None → `str(None)` = `"None"` |
| L13 | `pixiv_app/core/downloader.py` | 700,709,771 | 同一 artwork 三次调用 `ensure_artwork_stub`(`INSERT OR IGNORE`,无害但浪费) |
| L14 | `pixiv_app/core/gallery_service.py` | 588-613 | 同一 artwork 多次同步中重复创建 alert |
| L15 | `pixiv_app/core/x_media_service.py` | 522-523 | `datetime.now()` 无时区 → 跨时区对比可能偏差一天 |
| L16 | `pixiv_app/gui/app.py` | 1153-1157 | 小红书页缩进不一致(7 空格,PEP 8 违规) |
| L17 | `sakura_cloud/core/security.py` | 54-59 | `decode_token` 的 `exp` 手动检查与 `jwt.decode` 内建检查重复 |
### 插件
| # | 文件 | 行号 | 问题 |
|---|------|------|------|
| L18 | `plugins/x/plugin.py` | 414 | 下载缓存 JSON 暴露本地绝对路径结构 |
| L19 | `plugins/x/plugin.py` | 463-475 | 文件类型仅凭 URL 子串匹配判断,无 MIME 验证 |
| L20 | `plugins/biquge/plugin.py` | 135,360-361 | `requests.Session()` 无连接池限制 |
| L21 | `plugins/xiaohongshu/plugin.py` | 375-376 | 浏览器 profile 跨会话共享,可能积累旧 cookies 泄漏 |
### Flutter
| # | 文件 | 行号 | 问题 |
|---|------|------|------|
| L22 | `app.dart` | 11-16 | `ColorScheme.fromSeed()` 在 build 中创建(实际仅一次,低影响) |
| L23 | `artwork_detail_page.dart` | 264-265 | `showDialog` 异常抛出时 TextEditingController 泄漏 |
| L24 | `online_manga_reader_page.dart` | 101-103 | 源 headers 直接传给 `Image.network`,第三方源可能捕获凭据 |
| L25 | `novel_reader_page.dart` | 78,330 | `Future.microtask` 在 widget 可能已 dispose 的上下文中执行 |
| L26 | `novels_tab.dart` | 446,461 | 时间戳兜底使用 epoch 0 → 显示"53 年前" |
| L27 | `explore_page.dart` | 186-222 | `_openItem` 从 provider 同步读取 source,可能搜完源已被删除 |
| L28 | `source_manager.dart` | 86-96 | `initializeIfFirstRun()` 的 initialized flag 在可能失败的 `load()` 之后无条件设为 true |
| L29 | `source_manager.dart` | 242-260 | 从 JSON 导入时,源的 id 由 name+URL 的 codeUnit 求和生成——不同源可能碰撞 |
| L30 | `legado_engine.dart` | 167-200 | `_encodeKeyword` 对非 UTF-8/GBK 编码的平台通道调用无超时 |
---
## 五、跨模块问题汇总
| 问题类别 | 涉及模块 | 严重程度 |
|---------|---------|:--------:|
| **凭据明文存储** | 桌面端 + 5 个插件 + Flutter | Critical/High(7 处) |
| **HTTP 明文传输** | 桌面端 API + Flutter API | Critical/High(2 处) |
| **默认密码/密钥** | Cloud config(JWT、DB、MinIO、Redis) | Critical/High(4 处) |
| **无限流** | Cloud 全部用户端点 | High(17+ 端点) |
| **存储配额未执行** | Cloud gallery + sync | High(2 处) |
| **静默吞错 → 空列表** | Flutter + 桌面 downloader + session | High/Medium(10+ 处) |
| **线程安全** | 桌面 ProxyPool + SQLite + counter | Critical/Medium(3 处) |
| **资源泄漏** | 桌面 DB 连接 + Flutter Dio × translate + X 插件 browser | High/Medium(3 处) |
| **Token 生命周期** | Cloud auth(logout、refresh、expiry、version) | High/Medium(5 处) |
| **插件安全** | `--no-sandbox` + 硬编码密钥 + zip bomb + URL 路径穿越 | Critical/Medium(5 处) |
| **Flutter 状态管理** | FutureBuilder 模式 + async 构造器 + provider 初始化 | High/Medium(5 处) |
---
## 六、修复优先级建议
### 第一轮(立即修复,1–3 天)
| 顺序 | ID | 问题 | 工时 |
|:----:|:---|------|:----:|
| 1 | C1,C4,C5 | Cloud 默认凭据:JWT 密钥 + DB 密码 + MinIO 凭据 | 1h |
| 2 | C3,H18 | 移除 `--no-sandbox`(小红书 + X 插件) | 1h |
| 3 | C6,H13 | HTTP → HTTPS(桌面端 + Flutter) | 2h |
| 4 | C9 | ProxyPool 多线程数据竞争(加锁) | 2h |
| 5 | C7 | Firebase 初始化 flag 移到成功之后 | 10m |
| 6 | C2 | 笔趣阁 AES 密钥改为随机 IV + 安全随机密钥 | 2h |
| 7 | H1,H2,H17 | Cloud 端全局速率限制 | 4h |
| 8 | H3 | 存储配额强制执行 | 2h |
### 第二轮(本周内,3–5 天)
| 顺序 | ID | 问题 | 工时 |
|:----:|:---|------|:----:|
| 9 | H4,H5 | Token 撤销(logout + refresh rotation) | 4h |
| 10 | H16 | 云同步 O(N) DB 连接改为复用连接 | 2h |
| 11 | H15 | SQLite 跨线程连接池化 | 3h |
| 12 | H7 | 小说翻页 API 增加 500ms 防抖 | 1h |
| 13 | H8 | 探索页"插画→小说"模式修复 | 1h |
| 14 | C8 | gallery_tab `recentUpdatesOnly` 死开关修复 | 1h |
| 15 | H19 | 关注作者同步 N+1 查询优化 | 3h |
| 16 | H20 | 多处静默吞错 → 显式错误状态 UI | 4h |
| 17 | M8 | GET novel 路径解析触发的 DB 写操作改为 lazily 计算 | 2h |
### 第三轮(下一迭代)
| 顺序 | 类别 | 内容 | 工时 |
|:----:|------|------|:----:|
| 18 | 凭据加密 | 7 处明文凭据改为 OS 密钥链存储 | 8h |
| 19 | CSP | CSP 策略加固(nonce/hash 替代 unsafe-inline) | 4h |
| 20 | 测试 | 为 Critical/High 项编写回归测试 | 8h |
| 21 | Flutter 重构 | AsyncNotifier 替代 FutureBuilder(feed_tab, gallery_tab, novels_tab) | 8h |
| 22 | 插件审计 | 对全部 5 个插件的网络/文件访问权做沙箱化评估 | 4h |
---
> **审核范围确认:** Flutter 移动端 30 个 Dart 文件 × Python 桌面端 16 个文件 × Cloud 后端 10 个端点文件 × 5 个插件 × 中间件/配置/安全模块。合计约 65 个源文件,发现 111 个问题。