docs/prds/settings/about/README.md
本目录下的文档覆盖「设置 → 关于」页面的全部功能。 基于静态代码分析和动态 UI 验证综合整理,经 DA 质疑和 Tester 反馈修正定稿。
| 模块文件 | 功能点数 | 编号范围 |
|---|---|---|
| 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 |