使用说明

从一条分享链接到磁盘上的一个文件，中间其实有好几步。这篇把每一步说清楚， 包括哪些地方容易卡住、卡住了通常是什么原因。

一条分享链接的完整旅程#

1. 复制链接。任何地方复制的都行 —— 聊天记录、浏览器、别的应用。带提取码的链接也直接复制， 应用会尽量自己识别出来。
2. 切回应用。如果剪贴板里有可识别的链接，解析页会主动提示"粘贴"，点一下就好； 没有提示也可以手动贴进去。
3. 解析。应用去问网盘"这个分享里有什么"。
4. 浏览。分享可能是一整个文件夹。解析成功后你会看到里面的文件和目录，可以逐层进去挑。
5. 取直链。选中要下的文件后，应用向网盘换取一个可以直接下载的地址。 这一步是网盘权限的关键：没有登录就拿不到可用的直链，这也是下面要讲登录的原因。
6. 下载。直链交给下载引擎，任务出现在「下载」页，可以暂停、继续、删除、打开。

登录#

为什么一定要登录：网盘对未登录访客只开放很小一部分内容 —— 看得见文件名，却拿不到能用的下载地址。 登录之后才有权限换取直链、浏览完整目录。

下载#

普通 HTTP/HTTPS 直链和网盘取到的直链走同一套下载流程：分片并发、断点续传、失败重试。 暂停后继续会按磁盘上真实写完的字节接着下，而不是从头再来。

链接如果指向 .m3u8（HLS 清单），会走 HLS 下载路径：解析清单、并发下载分片、必要时解密。 它是下载能力，不是播放器 —— 把整个流下成本地文件，不做实时播放。

并发是可以调的，但不建议拉满。应用把连接数上限装配为 16、诊断档位上限 64， 网盘服务端普遍有风控，线程越多反而越容易触发限速。

文件存到哪里#

默认是设备的公共 Download 目录，和浏览器下载的地方是同一个。这个默认值在大多数设备上不用改。

如果你希望换个目录，应用里可以指定。这里有个 Android 版本的差别值得知道：

• Android 10 及以下：走传统文件路径，授予存储权限即可。
• Android 11 及以上：系统对公共目录有"分区存储"限制。用默认的 Download 目录不需要额外授权； 想写到自己指定的目录，需要在系统设置里给应用开「所有文件访问」。

不开也能用 —— 下载引擎会自动退到应用自己的外部私有目录，只是那个目录别的应用不容易访问。

认证与备份#

网盘凭证（Cookie、token 之类）用 Android Keystore 加密后存在本地数据库里， 密钥本身不可导出，只在这台设备上有效。

换设备时不必一个个重新登录：「设置 → 导出网盘认证」会把认证信息打包加密成一个文件， 在新设备上导入即可。导出时会要求你设一个口令，这个口令没有找回途径 —— 文件是用它派生的密钥加密的，忘了就只能重新登录一遍。

权限都用在什么地方#

应用申请的权限不多，每一个都有明确的用途：

换引擎#

设置里有下载引擎的选项。默认的 TurboDL 覆盖绝大多数场景； 磁力、BT 这类它做不了的任务需要先导入 Gopeed 内核。 这些选择各自适合什么、有什么代价，写在下载引擎里。