Skip to content

SHOU-Launcher v1.3.0 · dxy

Choose a tag to compare

View all tags
@Moeary Moeary released this 22 Oct 02:50
v1.3.0
c8c0a75
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v1.3.0 · dxy

首次 v1.3.0 Release 于 2026-10-21 因设置页 XAML 事件绑定错误撤回。按维护者要求，修复版继续使用 v1.3.0：重新发行时先将旧源码归档为 archive/v1.3.0-withdrawn-20261021，再将正式标签指向通过验证的 main 源码，并替换原发行包。

正式包基于合并后的 main，使用 Release 配置构建 Windows x64 自包含程序。最终源码 SHA、SDK 与 SHA-256 以包内 BUILD-INFO.txt、旁置校验文件和 GitHub Release 为准。

首次启动与语言

  • 首次启动直接进入软件，不再弹出需要点击同意的启动器免责声明确认；协议与许可说明仍可在关于页查看。
  • 不再弹出“启用遥测数据收集”询问；新配置默认关闭遥测，可在设置中主动开启，不自动代替用户同意。
  • 新配置默认使用简体中文（zh-CN），初始化配置之前也使用中文。已有用户明确设置的其他语言或“跟随系统”保持原值，可在语言设置中修改。

Java 证书修复

  • 设置 → Java 新增已发现 JDK/JRE 的证书检查、单项/批量修复和备份恢复；按 SHA-256 指纹移除本次事件撤信任的 G3 根与已知泄露中间证书，不按名称删除其他 CA。
  • 补充 16 张泄露中间证书（含交叉签名）的 Java 阻止名单；新下载的 Java 默认在任务完成前自动检查并修复，可在设置中关闭。
  • 修改前备份并校验，恢复时拒绝覆盖后续更新。特殊密码、损坏、系统链接和权限问题会明确报告；修复失败保留下载文件。
  • 规则、依据、格式兼容性和使用边界见 Java 证书修复。

首页

  • 设置 → 个性化 → 首页定制：分别隐藏社团介绍/顶部提示与服务器切换，得到更简洁的首页。
  • 隐藏服务器切换时始终只启动游戏，不沿用此前的社团服选择。
  • 支持多选本地图片替换轮播，并可恢复内置实景。图片在本地加载，不上传；失效图片跳过，全部失效时恢复内置实景。轮播开关仍在背景设置中。
  • 启动时社团更新日志提示、游戏启动时的小知识提示保留各自现有开关。

下载源

设置 → 游戏管理 → 自定义下载源与优先级：以 Minecraft 游戏本体｜Mod / 整合包｜Mod Loader 三个横向标签页切换，每页只展示与编辑本类下载源。切换保留各页未保存的编辑；“恢复本页默认”只重置当前分类，点击“保存下载源设置”统一保存三个分类，对新任务生效；已打开的加载器列表可手动刷新。

数值越小越优先，默认 BMCLAPI (0) → 社团镜像 (100) → 官方 (200) → 其他 (300)。不支持某类内容的源自动跳过。关闭优先级功能后可继续使用旧版下载源选项。

  • 社团源使用 SHOU-MCMirror 格式，默认根地址 https://minecraft.aaron212.com；清单为 /metadata/version_manifest_v2.json，资源为 /upstream/resources.download.minecraft.net。
  • 接受少于 200 项的有效清单。请求特定版本而源未收录、网络错误、JSON 损坏时继续下一个源。
  • 社团镜像只提供部分 Minecraft 版本，不提供 Java、Mod、加载器或服务端。Mod 和加载器使用自己的源；未知下载地址保留原始地址。
  • 版本 JSON 经镜像重写后哈希不同，备用版本 JSON 按版本 ID 查询，避免把重写哈希拼成官方路径。客户端、依赖库、资源索引和资源文件支持源地址转换与回退。
  • 自定义源可选 BMCLAPI 兼容、SHOU-MCMirror 或 URL 前缀替换。前缀替换要求镜像返回与原接口兼容的数据；API、Maven 与文件 CDN 可分别建规则。示例：https://meta.fabricmc.net → https://mirror.example/fabric-meta。源不代理登录与认证。
  • Mod 查询中的写入/POST 接口仍遵循调用方原有的官方/镜像许可，不把账户、RPC 密钥发给自定义源。

aria2 RPC

设置 → 游戏管理 → aria2 RPC：填写地址、Secret，测试连接，再保存并启用。Secret 使用启动器现有加密配置存储。

自行安装并启动外部 aria2，例如（请自行替换密钥）：

aria2c --enable-rpc=true --rpc-listen-all=false --rpc-listen-port=6800 --rpc-secret=YOUR_SECRET

默认连接 http://127.0.0.1:6800/jsonrpc。仅将文件下载交给 aria2，元数据请求仍由启动器处理。镜像按顺序使用；下载速度、代理和全局并发由 aria2 自身配置管理。

  • 取消任务会暂停本启动器创建的任务，保留 .aria2.part 和 .aria2 控制文件；再次下载到相同路径时接管并续传，完成后由启动器校验，再移入目标路径。
  • 若 aria2 重启，保留分片和控制文件后可重新提交续传；不要清理它们。损坏文件不进入游戏目录，会保留为 .invalid-* 供诊断，下次重新下载。
  • RPC 连接失败时明确报错；启用状态下不悄悄改用内部下载器。RPC 断开时可能无法发送暂停，外部任务会保留，可连接后重试。
  • 远程 aria2 需要与启动器共享相同的输出路径；“RPC 连接成功”本身不代表远程文件可被本机读取。
  • 不启动、安装、关闭或修改用户已有的 aria2 服务，不操作其他路径的任务。

实现依据：aria2 官方 RPC 文档。

配色

  • 爱弥斯配色：粉白主色，悬停、内存指示和局部表面使用蓝色，包含深色版本。
  • 高雅人士配色：黑白与金黄强调，包含深色版本。
  • 浅色与深色可分别选择配色；旧主题索引与用户选择保持兼容，默认嘉然配色不强制迁移。

验证与限制

  • Release x64 编译通过；保留既有可空引用、NuGet 与单文件反射等警告。
  • 加入证书修复后的全量离线测试：351 项，350 通过、1 跳过、0 失败。跳过项为平台不支持的 ChaCha20 硬件测试；包含真实 JDK keytool 的 JKS/PKCS12 互操作。
  • 新增下载源回归 5 项、RPC 回归 5 项、两套深浅色板完整性与正文对比度回归 1 项。
  • 首次发行的上述核心测试未实际加载启动器设置页面，未能覆盖本次故障。修复后增加独立 PCL.Launcher.Test：以 STA 线程加载真实应用资源、八个页面/控件的编译 XAML，并执行绑定后的轮播重置、三个源子页的增删/切换/独立重置/统一保存、RPC 保存与证书修复设置回调；同时模拟英文系统界面语言，验证中文默认值和手动改选语言。修复前能复现原事件绑定错误。测试配置目录与用户数据隔离。
  • Conduit Build 在上传候选包前必须通过 WPF 设置页及 Java 证书专项（含真实 keytool）回归，报告一并保存在 test-results artifact。
  • 使用真实 aria2 1.37.0 与本机 HTTP 服务验证 404 备用源、取消暂停、重连续传、非零 HTTP Range 请求及最终 SHA-256 一致。
  • 真实社团清单与重写后的客户端/资源索引/依赖 URL 已核对；未用用户账户进行登录或完整 Minecraft 安装、启动及联机测试。自定义镜像仍需维护者保证接口兼容性。

aria2 冒烟检查可复现（输出目录必须不存在）：

dotnet run --project scripts/conduit/Aria2Smoke/Aria2Smoke.csproj -c Release -- D:/Tools/aria2c.exe artifacts/aria2-smoke-new

候选构建须记录源码 SHA、SDK、架构、配置与 SHA-256。正式发布流程与微软 Client ID 注入见 BUILD.md。

本次重新发行的产物

  • 修复与启动体验变更已通过 PR #6、PR #7 合并到 main；旧标签源码保存在 archive/v1.3.0-withdrawn-20261021。
  • 源码：c8c0a75229acac7e3fc1e156d2b14a0dd24ba3d7，干净工作区；.NET SDK 10.0.401；Release / win-x64 / self-contained。
  • 最终 main 的 CI 通过；本地核心回归 350 通过、1 硬件测试跳过，WPF 设置页回归通过。实际发布 EXE 在隔离配置中启动并加载八个页面，验证中文默认值、遥测关闭、无遥测/免责声明询问与三类源标签页。
  • SHOU-Launcher-v1.3.0-tests.zip 包含最终测试报告、产物冒烟记录及构建信息。未进行账户登录、完整游戏安装/启动/联机测试；产物未作 Authenticode 签名。
  • 此次复用 v1.3.0 标签并替换全部旧附件；曾下载旧包者请重新下载，并以以下 SHA-256 核对。
9c2e74f376f5d52da7e40753523e3110227b6dc81958b7107500c81bb9eb12be  SHOU-Launcher-win-x64.zip
24339643aff4a89abed26f6481c2d74a0a1be3e92793a68ff2aa5bc6ffe19011  SHOU-Launcher-v1.3.0-tests.zip
Assets 6
Loading