NAS下载器应用V1.0（615版本）产品需求文档

文档信息

项目	内容
文档版本	v1.0
对应版本	下载器应用 V1.0（615版本）
文档类型	产品需求文档（PRD）
更新日期	2026-04-28
适用对象	产品 / 设计 / 前端 / 服务端 / 客户端 / 测试 / 运维
关联文档	[[我的笔记/NAS需求文档/下载器/NAS下载器应用需求规划文档]]、[[我的笔记/NAS需求文档/下载器/NAS下载器详细需求文档]]、[[我的笔记/NAS需求文档/下载器/下载器功能清单_下载器功能清单_按版本分组.csv]]、[[我的笔记/NAS需求文档/下载器/NAS下载器PRD模块拆解表]]

一、产品概述

1.1 产品定位

NAS 下载器是面向 NAS 原生场景的系统应用，目标是在 NAS 侧承接主流资源获取需求，形成“下载 → 存储 → 管理 → 消费”的闭环体验。

V1.0（615版本）重点解决“先把核心下载链路跑通且足够稳定”的问题，覆盖：

BT 种子下载
私有 PT 种子下载
Magnet 磁力链下载
HTTPS 直链下载
同品牌分享链接下载 / 转存
Web / App 远程管理核心链路

1.2 版本目标

核心目标

建立品牌自有原生下载器能力，摆脱对第三方工具的强依赖。
打通下载、通知、文件管理、分享体系的最小闭环。
让普通用户能低门槛完成任务创建，让 PT 用户能安全使用。

体验目标

普通用户可在 3 步内完成常见任务创建。
任务状态、错误原因、保存位置可清晰查看。
Web / App 与 NAS 端任务状态保持一致。

稳定性目标

下载服务支持常驻运行。
设备重启后任务可恢复。
失败场景有明确错误提示和可重试路径。

1.3 核心设计原则

默认可用：不要求普通用户理解复杂协议细节。
PT 友好：私有 PT 默认安全，不踩站规风险。
结果清晰：状态、速度、日志、目录、错误都可解释。
原生闭环：下载完成后可直接通知并打开目录。
多端一致：Web / App / NAS 本地使用统一任务模型。

二、版本范围

2.1 V1.0（615）纳入范围

任务接入与创建

统一创建入口
资源类型自动识别
保存目录选择
重复任务检测

下载协议能力

torrent 解析
文件级选择下载
私有 PT 识别
PT 安全模式
做种规则
分享率与上传统计
Tracker 状态
通用 Tracker 列表
magnet 解析
元数据拉取
元数据超时提示
HTTPS 直链下载
重定向处理
断点续传
文件名识别
同名冲突策略
品牌分享链接识别
提取码校验
文件列表展示
转存模式
下载模式
分享异常提示

任务管理

状态导航
任务搜索
批量操作
总速率展示
通用详情
日志展示

系统设置

默认下载目录
并发控制
全局限速
监听端口（含 TCP/uTP）

通知与联动

完成通知
失败通知
打开目录

远程管理

Web 端任务管理
App 远程添加链接任务
App 查看任务状态

2.2 不纳入 V1.0（615）

以下能力不属于 615 上线范围：

分时段限速
UPnP / NAT-PMP
最大 Peer / 最大连接数
临时目录 / 完成目录分离
监听目录自动建任务
App 上传 torrent
自动整理与媒体刷新
NAS 内部统一服务调用接口
下载服务 CLI 能力
RSS 自动订阅
API / Webhook 开放能力
下载后规则动作 / 规则引擎
外部下载器统一管理

三、目标用户与核心场景

3.1 目标用户

用户类型	特征	核心诉求
普通家庭用户	常下载影视、软件、压缩包	添加简单、稳定可下、手机可管
BT/PT 进阶用户	关注 Tracker、做种、分享率、连接参数	PT 不踩坑、做种可控、错误可排查
品牌生态用户	频繁使用品牌分享链接	一键转存 / 下载到 NAS

3.2 核心使用场景

用户从 Web/NAS 本地/App 发起下载任务。
系统自动识别资源类型并展示对应配置。
用户选择保存目录，按需选择文件和模式。
任务进入下载 / 获取元数据 / 做种 / 完成等状态。
用户在任务列表或详情页中查看进度、错误、日志并执行控制操作。
下载完成后，系统发送通知并支持打开目录。

四、信息架构与页面范围

4.1 页面结构

text
下载器 V1.0（615）
├─ 首页 / 任务列表页
├─ 添加任务弹窗
├─ 任务详情页
├─ 设置页
└─ 通知与联动

4.2 页面目标

页面	页面目标
首页 / 任务列表页	快速查看任务状态并完成高频操作
添加任务弹窗	用统一入口完成所有任务创建
任务详情页	提供排障、细节查看与操作能力
设置页	配置目录、并发、限速、网络和做种规则
通知与联动	及时感知任务结果并进入文件消费链路

4.3 页面功能项定义

以下为 V1.0（615版本）必须交付的页面级功能项边界。第五章按能力域展开细化，本节用于明确“每个页面具体要有什么”。

4.3.1 首页 / 任务列表页

功能项	具体定义	备注
添加任务入口	页面主按钮，进入添加任务弹窗	Web / NAS 本地必须支持；App 远程入口见 4.3.6
状态导航	全部、下载中、做种中、已完成、已暂停、错误	支持展示各状态任务数量
总速率概览	展示全局下载速度、上传速度	用于判断下载服务当前运行状态
任务列表展示	展示任务名称、类型、状态、进度、大小、下载速度、上传速度、保存目录摘要、最近错误摘要	列表字段需适配不同任务类型
任务类型标识	区分 BT、PT、magnet、HTTPS、品牌分享链接	PT 任务需突出“PT / 安全模式”标识
搜索	支持按任务名称搜索	搜索结果需保留状态导航筛选条件
单任务操作	暂停、恢复、删除、查看详情、打开目录	打开目录仅在有有效保存目录时展示
批量操作	批量暂停、批量恢复、批量删除、批量删除任务并删除文件	删除文件需二次确认
空状态	无任务时展示添加任务引导	引导用户从统一入口创建任务
错误状态提示	错误任务在列表中展示可读错误摘要	点击进入详情查看日志和错误码

4.3.2 添加任务弹窗

功能项	具体定义	备注
链接输入	支持粘贴 magnet、HTTPS、品牌分享链接	App V1.0 优先支持链接输入
`.torrent` 上传	支持上传 torrent 文件并解析	Web / NAS 本地必须支持；App 上传 torrent 不纳入 615
资源类型识别	自动识别 BT / PT / magnet / HTTPS / 品牌分享链接	识别失败需提示非法资源
解析结果展示	展示资源名称、总大小、文件列表、任务类型	magnet 可先进入元数据获取状态
文件选择	BT / PT / magnet 元数据成功后支持文件级勾选；品牌分享支持文件级选择	HTTPS 单文件无需文件树
保存目录选择	必选；默认继承系统默认下载目录	无写权限时禁止创建
分享提取码输入	品牌分享链接需要时展示提取码输入区	提取码错误允许重新输入
下载 / 转存模式展示	品牌分享链接需展示当前采用“转存”或“下载”	不满足转存条件时自动降级为下载
同名冲突处理	HTTPS 支持跳过、覆盖、自动重命名	BT/PT/magnet 重点检测重复任务
创建前校验	校验格式、目录权限、空间、重复任务、PT 风险	校验失败需阻止创建并说明原因
创建结果反馈	创建成功后关闭弹窗并在列表出现任务；失败时停留弹窗展示原因	创建后任务进入统一任务模型

4.3.3 任务详情页

功能项	具体定义	备注
基础信息	任务名称、任务类型、当前状态、保存目录、创建时间、开始时间、完成时间	首屏必须可见任务名称、状态、进度、主要操作
进度与速度	已下载、已上传、总大小、进度、下载速度、上传速度	PT / 做种任务需展示上传相关信息
主要操作	暂停、恢复、删除、打开目录、重试	删除文件需二次确认
文件列表	展示任务包含文件、大小、下载状态	多文件任务支持查看选择结果
BT / PT 信息	展示 Tracker 列表、Tracker 状态、分享率、上传量、做种时长	PT 需展示“PT 安全模式已启用”
magnet 元数据状态	展示元数据获取中、成功、失败 / 超时状态	失败时支持重试
HTTPS 信息	展示原始 URL、最终 URL、文件名、是否支持断点续传	重定向后的最终 URL 需可查看
品牌分享信息	展示分享状态、提取码校验结果、转存 / 下载模式、异常原因	异常需区分过期、取消、无权限、资源失效
错误详情	展示错误码、错误描述、最近错误摘要	错误码需与 6.3 对齐
日志	展示最近日志或错误记录	日志不得暴露 token、提取码等敏感信息

4.3.4 设置页

功能项	具体定义	备注
默认下载目录	配置新任务默认保存目录	保存前需校验目录可写
并发控制	配置最大同时下载任务数、最大同时做种任务数	超出上限的任务进入等待状态
全局限速	配置全局下载限速、上传限速	支持不限速状态
监听端口	配置下载服务监听端口	覆盖 TCP / uTP 基础配置
做种规则	配置无限做种、按分享率停止、按做种时长停止	新任务默认继承全局策略
通用 Tracker 列表	配置公开 BT 可追加的通用 Tracker	私有 PT 不继承公共 Tracker
权限控制	普通用户不可修改管理员专属配置	无权限时置灰或隐藏入口
保存与生效反馈	设置保存后提示成功 / 失败，并实际作用于新任务或全局调度	影响已有任务的配置需明确说明

4.3.5 通知与联动

功能项	具体定义	备注
完成通知	任务完成后发送系统通知	通知可进入任务详情或打开目录
失败通知	任务失败后发送系统通知	通知需指向任务详情，便于查看错误原因
打开目录	从列表、详情、通知进入文件管理目标目录	目录不存在或无权限时需提示
通知内容	展示任务名称、结果状态、关键原因或入口动作	失败通知需包含可读错误摘要
多端同步	Web / App / NAS 本地均应能感知任务结果	通知形态可按端差异实现

4.3.6 Web / App / NAS 本地页面差异

终端	V1.0 必须支持	V1.0 不要求
Web	查看任务列表、创建链接任务、上传 torrent、查看详情、暂停 / 恢复 / 删除、设置管理	无
NAS 本地	查看任务列表、创建链接任务、上传 torrent、查看详情、暂停 / 恢复 / 删除、打开目录、设置管理	无
App	远程添加 magnet / HTTPS / 品牌分享链接、查看任务列表、查看任务详情、暂停 / 恢复、查看错误	App 上传 torrent、完整高级设置管理

五、详细功能需求

5.1 任务接入与创建

5.1.1 统一创建入口

同一入口支持链接粘贴和 .torrent 上传。
自动识别资源类型并切换到对应处理流程。
入口位于首页显著位置，Web / App / NAS 本地一致遵循统一任务模型。

5.1.2 资源类型自动识别

输入内容	识别结果
`magnet:?`	磁力链任务
`https://品牌分享域名/...`	分享链接任务
`https://其他域名/...`	HTTPS 任务
上传 `.torrent`	BT / PT 任务

5.1.3 保存目录选择

创建任务前必须选择保存目录。
若用户无写权限，则禁止创建并提示。
新任务默认继承系统设置中的默认下载目录。

5.1.4 重复任务检测

检测相同资源或同名文件冲突。
HTTPS 场景下支持跳过 / 覆盖 / 自动重命名。
BT/PT 与 magnet 场景下需避免重复创建同一任务。

5.1.5 创建前校验

校验项	规则
资源格式	必须为系统可识别类型
目录权限	用户需具备写权限
重复任务	必须明确提示处理策略
空间检查	剩余空间明显不足时预警
PT 风险	私有 PT 自动启用安全模式

5.1.6 验收标准

用户可从单一入口创建五类任务。
普通用户可在 3 步内完成常见任务创建。
识别结果准确，错误输入有明确提示。

5.2 BT / PT 下载能力

5.2.1 torrent 解析

支持解析种子名称、总大小、文件列表、private 标记。
多文件 torrent 支持文件级勾选下载。

5.2.2 私有 PT 识别

若 torrent 包含 private 标记，则识别为 PT 任务。
PT 任务在列表与详情页需有明显标识。

5.2.3 PT 安全模式

自动关闭 DHT / PEX / LSD。
禁止追加公共 Tracker。
保留原始 Tracker 顺序。
默认保留做种能力。
详情页需展示“PT 安全模式已启用”。

5.2.4 做种规则

支持无限做种。
支持按分享率停止。
支持按做种时长停止。
新任务默认继承全局做种策略。

5.2.5 分享率与上传统计

展示 ratio、上传量、做种时长。
统计口径需与下载引擎一致。

5.2.6 Tracker 状态

展示 Tracker 列表、连接状态、响应情况。
支持手动重新 announce。
公开 BT 支持通用 Tracker 列表。
私有 PT 不继承公共 Tracker。

5.2.7 验收标准

公开 BT、私有 PT 均可成功创建与执行。
私有 PT 不得默认启用破坏站规的配置。
文件级选择下载可生效。

5.3 磁力链下载能力

5.3.1 magnet 解析

支持通过 magnet 链接创建任务。
创建后进入元数据获取流程。

5.3.2 元数据拉取

从 DHT / Tracker 获取种子元数据。
拉取成功后可展示文件列表并支持选择性下载。

5.3.3 元数据超时提示

元数据获取失败或超时时，需给出明确提示。
支持用户重试。

5.3.4 验收标准

磁力链可成功进入元数据获取流程。
元数据成功后能展示文件信息。
失败时错误提示清晰可重试。

5.4 HTTPS 下载能力

5.4.1 HTTPS 直链下载

支持通过 HTTPS 链接直接创建下载任务。
覆盖软件包、压缩包、普通文件下载场景。

5.4.2 重定向处理

支持 301 / 302 / 307 等常见重定向。
重定向后的最终 URL 需可在详情页查看。

5.4.3 断点续传

若服务端支持 Range，请求中断后支持续传。
若不支持断点续传，需明确提示。

5.4.4 文件名识别

依据响应头或 URL 自动识别文件名。
识别结果用于创建任务和文件展示。

5.4.5 同名冲突策略

支持跳过。
支持覆盖。
支持自动重命名。

5.4.6 验收标准

HTTPS 下载在重定向场景下行为正确。
同名文件冲突处理符合用户选择。
中断场景下可正确续传或清晰提示不支持。

5.5 品牌分享链接能力

5.5.1 品牌分享链接识别

识别品牌域名并进入分享流程。
非品牌域名按普通 HTTPS 处理。

5.5.2 提取码校验

支持公开分享、提取码分享、登录态分享。
提取码错误时允许重新输入。

5.5.3 文件列表展示

展示分享内容。
支持文件级选择。

5.5.4 转存模式

优先支持服务端转存到目标目录。
满足条件时优先走转存链路以节省带宽。

5.5.5 下载模式

当不满足转存条件时，自动降级为下载任务。
用户需感知当前使用的是“转存”还是“下载”。

5.5.6 分享异常提示

链接过期
分享取消
无权限
提取码错误
资源失效

以上异常都需结构化提示。

5.5.7 验收标准

用户可通过品牌分享链接完成转存或下载。
提取码、权限、过期状态清晰可见。
分享异常场景能准确区分并提示。

5.6 任务管理

5.6.1 首页 / 任务列表

状态导航

支持以下分类：

全部
下载中
做种中
已完成
已暂停
错误

任务搜索

支持按任务名称搜索。
应具备快速定位能力。

批量操作

支持批量暂停。
支持批量恢复。
支持批量删除任务。
支持删除任务并删除文件。

总速率展示

首页需展示总下载速度和总上传速度。
反映当前系统总体运行状态。

5.6.2 任务详情页

通用详情

需展示：

任务名称
任务类型
当前状态
保存目录
创建时间 / 开始时间 / 完成时间
已下载 / 已上传 / 进度 / 速度
最近错误摘要

日志展示

展示最近日志或错误记录。
支持用于用户自助排障和客服排障。

5.6.3 验收标准

100 条任务列表加载时间 < 2 秒。
用户可完成看任务、控任务、查错误、开目录四类核心操作。
详情页首屏必须展示任务名称、状态、进度、主要操作按钮。

5.7 系统设置

5.7.1 默认下载目录

配置新任务默认保存目录。
新建任务自动继承。

5.7.2 并发控制

支持配置最大同时下载任务数。
支持配置最大同时做种任务数。
超过上限的任务进入等待状态。

5.7.3 全局限速

支持设置全局下载限速。
支持设置全局上传限速。

5.7.4 监听端口

提供监听端口设置。
支持 TCP / uTP 基础配置。

5.7.5 做种与 Tracker 基础设置

支持全局做种规则配置。
支持通用 Tracker 列表配置。
私有 PT 不继承公共 Tracker。

5.7.6 验收标准

管理员可完成目录、并发、限速、端口、做种规则等核心设置。
设置保存后能实际生效。
普通用户不可修改管理员专属配置。

5.8 通知与联动

5.8.1 完成通知

下载完成后发送系统通知。
支持从通知进入对应任务详情或结果入口。

5.8.2 失败通知

下载失败后发送通知。
通知需指向详情页，便于定位失败原因。

5.8.3 打开目录

下载完成后支持直接跳转文件管理。
提升下载结果消费效率。

5.8.4 验收标准

完成与失败场景均能触发通知。
点击“打开目录”可正确跳转到文件管理目标目录。

5.9 远程管理

5.9.1 Web 端任务管理

支持查看列表。
支持查看详情。
支持创建任务。
支持暂停 / 恢复 / 删除任务。

5.9.2 App 远程添加链接任务

支持在 App 中添加 magnet / HTTPS / 品牌分享链接任务。
创建后任务需同步出现在统一任务列表。

5.9.3 App 查看任务状态

支持 App 查看任务列表与详情。
任务状态需与 Web 一致。

5.9.4 验收标准

App 远程添加链接任务后，5 秒内可在任务列表看到。
Web / App / NAS 本地状态一致。
移动端优先保障“创建任务、看进度、看错误、暂停恢复”。

六、统一任务模型与状态定义

6.1 统一任务模型

字段	说明
task_id	任务唯一 ID
task_type	`bt` / `pt` / `magnet` / `https` / `share_link`
name	任务名称
status	任务状态
progress	下载进度
size_total	总大小
downloaded_size	已下载大小
upload_size	已上传大小
download_speed	当前下载速度
upload_speed	当前上传速度
ratio	分享率
save_path	保存目录
error_code	错误码
error_message	错误描述
owner	所属用户

6.2 任务状态

状态	说明
waiting	等待中
metadata_fetching	获取元数据中
downloading	下载中
seeding	做种中
paused	已暂停
verifying	校验中
completed	已完成
failed	失败
invalid	资源失效
permission_denied	权限不足
removed	已删除

6.3 错误码建议

错误码	场景	说明
DL-001	链接非法	资源格式无法识别
DL-002	目录无权限	目标目录不可写
DL-003	磁盘空间不足	无法继续下载
DL-004	资源不存在	404 / 分享失效
DL-005	认证失败	401 / 提取码错误
DL-006	网络超时	请求超时或 Tracker 超时
DL-007	元数据获取失败	magnet / torrent 元数据拉取失败
DL-008	PT 风险配置	私有 PT 命中风险配置
DL-009	文件冲突	同名文件处理失败
DL-010	内部服务异常	下载服务或分享服务异常

七、非功能需求

7.1 性能

支持至少 200 个历史任务展示。
支持至少 20 个活跃任务并发（按机型分级）。
列表与详情主要操作反馈时间 < 2 秒。

7.2 稳定性

系统重启后任务自动恢复。
下载服务异常退出后自动拉起。
断网恢复后支持自动重试。

7.3 安全性

分享链接权限、提取码、登录态必须校验。
日志中避免暴露 token、提取码等敏感信息。
PT 风险配置需二次确认。

7.4 可维护性

核心流程需可埋点、可观测。
错误码需可定位到具体链路。
最近日志需可查看。

八、依赖与风险

8.1 核心依赖

依赖项	说明
下载引擎	提供 BT/PT/magnet 下载执行能力
HTTP 下载模块	提供直链下载、重定向、续传能力
分享系统接口	提供品牌分享识别、提取码校验、转存能力
文件系统权限	目录可写、文件冲突、删除与打开目录联动
统一任务模型	支撑多端一致展示与操作
通知中心	发送完成/失败通知
文件管理应用	支持打开目录联动
Web / App 统一 API	支撑远程管理一致性

8.2 主要风险

风险项	风险描述	应对方式
私有 PT 支持	错误默认配置可能影响用户站点考核	默认 PT 安全模式，隔离公共 Tracker
分享链接下载/转存	依赖分享系统接口与权限模型	V1 聚焦公开分享 / 提取码 / 登录态三类核心场景
下载引擎稳定性	大量任务可能拖垮低配机型	机型分级控制并发与默认限速
HTTPS 兼容性	不同站点对重定向、续传支持差异大	增加能力探测和明确提示
多端状态同步	Web / App / NAS 本地状态不一致	使用统一任务模型和统一接口层

九、验收口径

9.1 版本验收清单

V1.0（615版本）需至少完成以下上线能力：

五类任务接入：BT / 私有 PT / magnet / HTTPS / 品牌分享链接
添加任务弹窗完整可用
任务列表、任务详情完整可用
PT 安全模式生效
做种规则、分享率、Tracker 状态可查看
HTTPS 重定向、断点续传、同名冲突策略可用
分享链接转存 / 下载双模式可用
设置页可配置目录、并发、限速、端口、做种规则
完成/失败通知与打开目录可用
Web / App 远程管理主链路可用

9.2 测试重点

公开 BT 与私有 PT 的配置隔离。
magnet 元数据获取超时与重试。
HTTPS 重定向、断点续传、同名冲突。
分享链接的提取码、过期、无权限、转存失败。
重启恢复、磁盘不足、中文文件名、多文件任务。
Web / App / NAS 本地状态一致性。

十、版本结论

下载器应用 V1.0（615版本）的定位不是一次性补齐全部高级能力，而是：

先把 核心下载链路 做稳定；
先把 PT 安全和品牌分享闭环 做成差异化；
先把 列表、详情、设置、通知、远程管理 这些高频基础体验打牢。

后续 730 及更高版本再逐步补齐高级网络配置、自动整理、内部服务调用、CLI、自动化与开放能力。