wehub-resource-sync
60 lines
3.4 KiB
Markdown
60 lines
3.4 KiB
Markdown
# 设置页 → 关于 & 检查更新 PRD 索引
|
|
|
|
> 本目录下的文档覆盖「设置 → 关于」页面的全部功能。
|
|
> 基于静态代码分析和动态 UI 验证综合整理，经 DA 质疑和 Tester 反馈修正定稿。
|
|
|
|
## 模块文件
|
|
|
|
| 模块文件 | 功能点数 | 编号范围 |
|
|
| ------------------------------------ | -------- | --------------- |
|
|
| [about-update.md](./about-update.md) | 12 | F-ABOUT-01 ~ 12 |
|
|
|
|
**总计：12 个独立功能点**
|
|
|
|
## 功能点总表
|
|
|
|
| 编号 | 标题 | 状态 | 验证方式 |
|
|
| ---------- | ------------------------------------ | ------ | ----------------- |
|
|
| F-ABOUT-01 | 应用信息展示 | 已实现 | 静态 + 动态 |
|
|
| F-ABOUT-02 | 检查更新入口 | 已实现 | 静态 + 动态 |
|
|
| F-ABOUT-03 | 预发布版本开关 | 已实现 | 静态 + 动态 |
|
|
| F-ABOUT-04 | 更新检查（双路径） | 已实现 | 静态 + 动态(部分) |
|
|
| F-ABOUT-05 | 更新可用 — 版本信息与下载触发 | 已实现 | 仅静态 |
|
|
| F-ABOUT-06 | 自动更新下载与安装 | 已实现 | 仅静态 |
|
|
| F-ABOUT-07 | 手动下载更新 | 已实现 | 仅静态 |
|
|
| F-ABOUT-08 | 更新错误处理与恢复 | 已实现 | 仅静态 |
|
|
| F-ABOUT-09 | 更新弹窗状态机 | 已实现 | 静态 + 动态(部分) |
|
|
| F-ABOUT-10 | 外部链接导航 | 已实现 | 静态 + 动态 |
|
|
| F-ABOUT-11 | 问题报告 | 已实现 | 静态 + 动态 |
|
|
| F-ABOUT-12 | 更新弹窗的其他触发方式与启动自动检查 | 已实现 | 仅静态 |
|
|
|
|
## 状态统计
|
|
|
|
| 状态 | 数量 |
|
|
| -------- | ------ |
|
|
| 已实现 | 12 |
|
|
| **合计** | **12** |
|
|
|
|
## 已知局限
|
|
|
|
| # | 功能点 | 局限描述 |
|
|
| --- | ------------- | ------------------------------------------------------ |
|
|
| 1 | F-ABOUT-03 | 弹窗已打开时修改预发布开关不会立即生效（useMemo 缓存） |
|
|
| 2 | F-ABOUT-04 | 当前版本非法 semver 时静默返回"已是最新" |
|
|
| 3 | F-ABOUT-04 | 双路径串行执行，路径 A 超时会导致总耗时超过 60 秒 |
|
|
| 4 | F-ABOUT-06/07 | 下载中关闭弹窗无取消机制，重开后进度丢失 |
|
|
| 5 | F-ABOUT-07 | 服务器未返回 Content-Length 时进度条显示 0% |
|
|
| 6 | F-ABOUT-10 | "问题报告"与外部链接视觉无差异；链接打开失败无用户提示 |
|
|
| 7 | F-ABOUT-11 | 截图无文件大小限制 |
|
|
| 8 | F-ABOUT-12 | 启动自动检查与手动检查并发时事件可能互相干扰 |
|
|
|
|
## 建议验证策略
|
|
|
|
| 功能范围 | E2E 可执行率 | 建议补充 |
|
|
| ------------- | ------------ | ------------------------- |
|
|
| F-ABOUT-01~04 | ~40% | 单元测试覆盖双路径逻辑 |
|
|
| F-ABOUT-05~08 | 0% | 集成测试 + 组件测试 |
|
|
| F-ABOUT-09 | ~25% | 组件测试覆盖各状态渲染 |
|
|
| F-ABOUT-10~11 | ~50% | Mock IPC 验证链接调用 |
|
|
| F-ABOUT-12 | 0% | 集成测试 mock autoUpdater |
|