1244026418 / PCL-Download-Fix

# PCL下载修复补丁（第三方）
为 **PCL 2.99.0.0 指定正式版构建**生成恢复 Minecraft 原版下载的启动器副本。Windows 图形界面，离线运行，不覆盖原启动器。
**下载最新使用包** · 查看使用说明 · 验证记录
这是第三方独立制作的工具，非 PCL 官方发布。PCL 原作者为 **龙腾猫跃**，欢迎赞助原作者。
第三方补丁作者：**胧月_MongLoon** · GitHub · Bilibili。
## 使用
1. 从本项目 Release 下载标为 **使用包（含 EXE 和使用说明）** 的附件 `PCL-Download-Fix-v1.1.2.zip`，完整解压到本地。
2. 运行 **PCL下载修复补丁.exe**，选择原来的 PCL 启动器 EXE，也可以拖入窗口。启动器还在 ZIP 中时，请先解压。
3. 显示校验通过后，点击“生成修复副本”，以新文件名保存到**原启动器所在目录**。
4. 关闭原启动器，运行新生成的副本，即可进入原版下载页面。
还原时，关闭修复副本并运行保留的原启动器即可。不要同时运行两个启动器。保存在原目录有助于继续使用该目录下原有的配置和游戏路径；工具本身不会迁移配置。
运行环境：Windows 10/11、.NET Framework 4.8。无需管理员权限或安装开发工具。发行包中的 `.exe.config` 请与 EXE 一起保留。
详细步骤、常见问题和文件用途均在 **使用说明.txt** 中。普通用户请下载上面的完整使用包；GitHub 自动生成的 `Source code` 附件只有源码。
## 支持范围
截至 2026-10-20，已核实上游最新正式版为 2.99.0.0。**同版本号的其他构建也可能不兼容**；本工具只接受下列完整指纹。
| 文件 | 字节数 | SHA-256 |
| --- | ---: | --- |
| 原启动器 | 5980160 | `6B6E1260CB5A1D6A303855F1C60CAB3D0BC1AEBBA7E40A964180188B271E7386` |
| 修复副本 | 5980160 | `98B494DD68B953988F445BFC29485C7D2014D472D8A7A685488A136FEA4D3F5F` |
恢复原版下载页的版本列表加载器，以及版本修改页的原版卡片。整合包安装限制仍保留。本工具不修改微软登录、正版校验、主题、下载地址或账号逻辑；网络故障、下载源故障和未来版本兼容性需分别处理。
校验不匹配时请保留原文件，不要删除校验或强制套用偏移量。此工具不会自动下载或更新启动器。
## 为什么这样修复
该版公开源码的 `ModSecret.vb` 中 `RestrictMcDownload = True`；原版下载页因此初始化为直接抛出异常的“关闭下载”加载器，版本修改页也会折叠原版卡片。原有下载实现仍在二进制中。
这是一个编译期常量，直接修改常量元数据无法撤销已内联的调用处。本工具在已验证构建中做两处等长 IL 修补，复用原下载模块，保留 PE、资源和其他方法布局。详见 验证记录。
## 安全与可审查性
- 不执行或以程序集加载所选启动器；只按字节读取、验证和写入新文件。
- 修复前校验大小、完整 SHA-256 和原始指令；修复后及写入后再次校验完整 SHA-256。
- 输出使用 `FileMode.CreateNew`，已有文件不会被覆盖。生成前会重新读取并验证输入，防止选择后文件发生变化。
- 工具不联网、不修改注册表、hosts、代理、游戏、账号或配置，无自动更新和遥测。关于页的赞助链接只在用户点击时打开浏览器。
- 工具使用 Windows/.NET 自带组件，没有运行时第三方库。构建不下载依赖。测试样本下载脚本和 GitHub Actions 会联网，仅用于开发验证。
- 本仓库不附带官方或已修复的启动器。发行 EXE 来自本仓库源码重新编译，没有使用参考工具的 EXE。
本工具未进行代码签名。安全软件可能显示未知发布者；文件指纹用于检查下载完整性，不能独立证明软件没有恶意行为。可以审查源码并自行构建。对于来源不明的参考 EXE，本项目没有运行，也不作无病毒保证。
## 自行构建与验证
在 Windows PowerShell 中进入源码目录：
 [code] 
构建输出位于 `dist`，中文名称、版本与打包文件名由 `project.json` 管理。编译器采用 Windows 自带的 .NET Framework `csc.exe`，无需 SDK/NuGet。默认测试中间文件在 `F:\temp\codex-pcl-download-repair\tests`；没有 F 盘时，请显式传入适合自己的 `-WorkDirectory`。已有原启动器时可用 `-OriginalLauncher "D:\PCL\PCL2.exe"` 替代下载。测试不会启动样本启动器。
Framework 编译器会生成时间戳和模块标识，重复构建的工具 EXE 指纹可能不同；修复输出的指纹固定。GitHub Actions 会从源码构建，下载锁定提交的官方样本并执行集成测试，成功后上传发行包。
可选静态 IL 审计代码在 `tests/VerifyLauncherIl.cs`，需要开发者自行提供 dnlib 4.5.0，仅用于验证，不进入工具发行包。
## 命令行
 [code] 
`--check`：0=支持的原文件，2=已修复，1=不支持或读取失败。`--patch`：0=成功，1=失败。参数错误返回 64。命令行模式不弹出修复窗口，错误信息写入已连接的控制台；自动化应等待进程并读取返回码。
## GitHub 构建与发布
仓库只包含独立工具源码、构建脚本、测试和许可文件。外层的上游源码、参考工具、原始 ZIP、测试样本和修复启动器不会上传。
仓库包含 `.github/workflows/build.yml`：推送或手动触发后生成使用包与源码包。推送与 `project.json` 版本一致的标签，例如 `v1.1.2`，成功通过验证的构建会自动创建中文 GitHub Release；发布说明来自 `RELEASE_NOTES.md`。
GitHub 首页保留标准 `README.md` 方便直接显示。GitHub 下载附件使用稳定的英文文件名和中文标题；解压后的发行包使用 **PCL下载修复补丁.exe**、**使用说明.txt**、**验证记录.md**、**许可与来源.md** 和 **源码** 文件夹。本地打包仍生成中文 ZIP 文件名。请在分发时保留 `PCL-LICENCE.txt`、署名和第三方声明。
## 许可与来源
独立工具代码采用 MIT；PCL 的内容与相关权利见 PCL-LICENCE.txt。来源、参考范围与署名见 NOTICE.md。