NAS下载器测试用例清单

关联文档：[[我的笔记/NAS需求文档/下载器/NAS下载器详细需求文档]]、[[我的笔记/NAS需求文档/下载器/NAS下载器前后端接口清单]]

一、测试范围

V1 核心范围：

• BT 种子
• 私有 PT 种子
• Magnet 磁力链
• HTTPS 下载
• 品牌分享链接下载/转存
• 任务列表/详情/设置/通知
• Web/App 远程管理

---

二、冒烟用例

编号	模块	用例标题	预期结果	优先级
SMK-001	任务创建	可成功创建 BT 任务	任务进入下载流程	P0
SMK-002	任务创建	可成功创建 Magnet 任务	进入元数据获取/下载流程	P0
SMK-003	HTTPS	可成功创建 HTTPS 任务	文件开始下载	P0
SMK-004	分享链接	可成功解析品牌分享链接	展示文件列表	P0
SMK-005	列表管理	列表可展示任务状态	状态正确展示	P0
SMK-006	任务操作	暂停/恢复/删除可用	操作成功	P0
SMK-007	设置	可保存基础设置	设置生效	P0
SMK-008	通知	下载完成后收到通知	通知成功展示	P0

---

三、详细测试用例

3.1 任务创建

编号	前置条件	操作步骤	预期结果
CT-001	用户已登录且目录可写	打开添加任务弹窗	弹窗成功打开
CT-002	无	输入 magnet 链接	自动识别为 magnet
CT-003	无	输入普通 https 链接	自动识别为 https
CT-004	无	输入品牌分享链接	自动识别为分享链接
CT-005	有 torrent 文件	上传公开种 torrent	识别为 BT，展示文件列表
CT-006	有私有种 torrent	上传私有种 torrent	识别为 PT，展示 PT 安全模式提示
CT-007	目录无权限	选择不可写目录创建任务	禁止创建并提示
CT-008	已存在相同任务	再次创建同资源任务	弹出重复任务策略提示
CT-009	磁盘空间不足	创建大文件任务	创建前或创建后明确预警

3.2 BT / PT 下载

编号	前置条件	操作步骤	预期结果
BT-001	公开 BT 资源可用	创建公开 BT 任务	正常连接 Peer 并下载
BT-002	私有 PT 资源可用	创建 PT 任务	默认关闭 DHT/PEX/LSD
BT-003	私有 PT 任务	查看详情页	PT 标签和安全模式提示可见
BT-004	私有 PT 任务	检查 tracker 配置	未注入公共 Tracker
BT-005	BT 多文件种子	仅选择部分文件下载	仅下载选中文件
BT-006	下载完成的 BT 任务	触发校验	进入 verifying 后状态正确
BT-007	做种规则为 ratio=2	达到分享率	自动停止做种
BT-008	tracker 异常	手动 reannounce	tracker 状态刷新

3.3 Magnet 磁力链

编号	前置条件	操作步骤	预期结果
MG-001	可用 magnet 链接	创建任务	进入 metadata_fetching
MG-002	元数据可拉取	等待完成	成功展示名称/文件列表
MG-003	无效 magnet	创建任务	提示链接非法或元数据失败
MG-004	网络受限	拉取元数据超时	提示超时并支持重试

3.4 HTTPS 下载

编号	前置条件	操作步骤	预期结果
HP-001	可用 HTTPS 链接	创建任务	下载开始
HP-002	链接 302 跳转	创建任务	可正确跳转并下载
HP-003	服务端支持 Range	下载过程中中断再恢复	任务可续传
HP-004	目标目录存在同名文件	创建任务	弹出冲突策略
HP-005	资源 404	创建任务	提示资源不存在
HP-006	资源 403	创建任务	提示无权限
HP-007	SSL 异常	创建任务	提示证书异常

3.5 品牌分享链接

编号	前置条件	操作步骤	预期结果
SH-001	有公开分享链接	输入链接	可展示文件列表
SH-002	有提取码分享链接	输入错误提取码	提示提取码错误
SH-003	有提取码分享链接	输入正确提取码	校验通过并展示文件列表
SH-004	分享支持转存	选择转存模式	资源直接落到目标目录
SH-005	分享仅支持下载	选择下载模式	创建真实下载任务
SH-006	分享已过期	输入链接	提示已过期
SH-007	分享被取消	输入链接	提示资源失效
SH-008	用户无权限	输入链接	提示无权限或引导登录

3.6 任务列表与详情

编号	前置条件	操作步骤	预期结果
LS-001	存在多状态任务	切换左侧筛选	列表内容正确变化
LS-002	存在任务	搜索任务名	正确返回匹配结果
LS-003	选中多个任务	执行批量暂停	所有任务暂停
LS-004	存在失败任务	查看列表	可看到错误摘要
LS-005	打开任务详情	查看概览/文件/日志	信息完整可见
LS-006	PT 任务详情	查看 tracker 页签	tracker 状态和分享率可见

3.7 设置与通知

编号	前置条件	操作步骤	预期结果
ST-001	管理员登录	修改默认下载目录	保存成功并生效
ST-002	普通用户登录	访问设置页	仅可见权限范围内内容
ST-003	设置全局下载限速	开始下载任务	速度受限生效
ST-004	设置分时段限速	到达指定时间段	新速度策略生效
ST-005	任务下载完成	观察通知中心	收到完成通知
ST-006	任务失败	观察通知中心	收到失败通知

3.8 远程管理与一致性

编号	前置条件	操作步骤	预期结果
RM-001	Web 已登录	创建 magnet 任务	App/Web 都可见
RM-002	App 已登录	创建 https 任务	Web 列表同步出现
RM-003	App 中暂停任务	Web 端观察	状态同步为 paused
RM-004	Web 中删除任务	App 端观察	任务同步消失

3.9 稳定性与异常

编号	前置条件	操作步骤	预期结果
EX-001	正在下载任务	重启下载服务	任务可恢复
EX-002	正在下载任务	重启整机	任务可恢复
EX-003	下载中磁盘写满	继续下载	提示空间不足并停止
EX-004	长时间做种	持续运行 24h+	状态稳定，无异常泄漏
EX-005	中文文件名资源	下载并完成	文件名显示和保存正确

---

四、性能测试建议

编号	场景	指标要求
PF-001	100 条任务列表加载	< 2 秒
PF-002	20 个活跃任务并发	系统可用，无明显卡顿
PF-003	WebSocket 高频状态更新	前端不卡顿、状态无错乱
PF-004	10GB+ 文件续传	恢复成功，数据不损坏

---

五、回归测试重点

每次版本回归至少覆盖：

• BT / PT / Magnet / HTTPS / 分享链接 五类创建
• 暂停 / 恢复 / 删除 / 重试
• PT 安全模式
• 分享链接提取码和过期
• Web/App 状态同步
• 重启恢复

---

六、上线前验收项

• P0 功能用例全部通过
• P0 阻断级 Bug 为 0
• PT 专项用例全部通过
• 分享链接专项用例全部通过
• Web/App 一致性通过
• 稳定性测试通过
• 性能测试达到基线