Skip to content

下载与解压 ​

客户端负责下载、断点续传、限速、解压、完成后操作和日志记录。服务端负责生成下载链接,并根据文件来源返回本地文件流或 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 过期或服务端重置,需要重新登录。

Released under the AGPL v3 License.