下载与解压
客户端负责下载、断点续传、限速、解压、完成后操作和日志记录。服务端负责生成下载链接,并根据文件来源返回本地文件流或 OpenList 跳转。
下载链路
本地文件源
text
客户端请求下载链接
→ Sena 返回短期签名下载 URL
→ 客户端下载 Sena 服务端文件流
→ 内置 7zip-zstd 解压到本机下载目录OpenList 文件源
text
客户端请求下载链接
→ Sena 获取 OpenList 签名并返回 302
→ OpenList 返回网盘 / CDN 直链
→ 客户端直接下载最终文件OpenList 下载默认不占用 Sena 服务端大文件带宽。只有在兼容性排查时才建议考虑服务端代理模式。
安装目录
点击下载后会先弹出「下载游戏」窗口:确认下载版本,并可临时选择安装目录(默认使用下载设置里的下载目录)。解压产物写入所选目录。
aria2 与回退
Windows、Linux 和 Android 客户端都内置 aria2,优先使用多连接分片下载:
- 遇到 OpenList / CDN 对多连接不友好时,会自动降低分片数。
- 网盘来源会按来源类型使用浏览器 UA 并做降级重试。
- aria2 不可用或下载失败时,回退到 Dart 分片 / 流式下载。
任务控制
| 操作 | 说明 |
|---|---|
| 暂停 | 停止当前网络请求,保留已下载部分 |
| 继续 | 使用 Range 或 aria2 控制文件继续下载 |
| 取消 | 停止任务并清理临时文件 |
| 限速 | 下载设置中以 KB/s 配置,0 表示不限速 |
| 并发 | 下载设置中配置最大同时下载数,超出任务排队等待 |
下载进度会节流刷新,避免频繁写入本地状态。Android 通知也会按固定间隔更新。
解压与完成操作
下载完成后客户端使用内置 7zip-zstd 解压(Windows / Linux / Android)。Android 版本使用按 16 KB page 对齐构建的 arm64 二进制,以兼容 Android 15 及以后使用 16 KB 内存页的设备。
解压前会先用 7-Zip 的只读列表模式确认压缩包可读,再开始解压:
- 列表失败 → 判定下载不完整或源文件损坏,不再盲目重新下载
- 7-Zip 退出码
1(仅警告,例如时间戳/权限/额外数据)视为成功,并在日志中记录警告 - 完整性错误时会先用单线程重试一次解压,避免误触发数 GB 的重新下载
- 如果仍然失败,点击任务的「重试」会丢弃损坏的临时文件并重新下载,不会反复解压同一份坏文件
- 临时文件使用纯 ASCII 名称;Android 的 7zz 静态链接 libc++,不依赖设备或 Flutter 提供的
libc++_shared.so - Android 下载前会检查目标目录剩余空间,解压前再检查一次;空间不足会直接提示,不会先下载几 GB 再失败
- 解压超时按压缩包大小动态计算(30 分钟起,最长 4 小时),不再固定 30 分钟
- 启动时会清理超过 3 天、且不属于当前任务的旧
.tmp_*临时文件
版本如果预设了解压密码,解压时会自动使用;有密码但解压失败时会弹窗提示。失败原因会区分「压缩包格式无效/不完整」「内容校验失败」「存储空间不足」「没有写入权限」「解压组件与设备不兼容」,并附带 7-Zip 原始错误首行,方便定位。
桌面端完成后可执行:
- 解压到下载目录
- 打开目标文件夹
- 创建快捷方式(Windows)
- 导入为 Steam 非 Steam 游戏(Windows / Linux)
- 推送到 LunaBox 或 ReinaManager 下载入库
Android 端需要提前授予「所有文件访问」权限,否则无法稳定解压到共享存储。
排障提示
- OpenList 下载卡住时,查看日志中的
download request/download redirect/aria2 download记录。 - 下载失败并提示压缩包损坏时,点任务上的「重试」即可,客户端会丢弃损坏文件重新下载,不需要手动删除任务。
- CDN 对多连接不友好时,客户端会降低 aria2 分片数并在必要时回退。
- 若下载报 401,通常是 token 过期或服务端重置,需要重新登录。