为 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。同版本号的其他构建也可能不兼容；本工具只接受下列完整指纹。

恢复原版下载页的版本列表加载器，以及版本修改页的原版卡片。整合包安装限制仍保留。本工具不修改微软登录、正版校验、主题、下载地址或账号逻辑；网络故障、下载源故障和未来版本兼容性需分别处理。

校验不匹配时请保留原文件，不要删除校验或强制套用偏移量。此工具不会自动下载或更新启动器。

该版公开源码的 ModSecret.vb 中 RestrictMcDownload = True；原版下载页因此初始化为直接抛出异常的“关闭下载”加载器，版本修改页也会折叠原版卡片。原有下载实现仍在二进制中。

这是一个编译期常量，直接修改常量元数据无法撤销已内联的调用处。本工具在已验证构建中做两处等长 IL 修补，复用原下载模块，保留 PE、资源和其他方法布局。详见 验证记录。

• 不执行或以程序集加载所选启动器；只按字节读取、验证和写入新文件。
• 修复前校验大小、完整 SHA-256 和原始指令；修复后及写入后再次校验完整 SHA-256。
• 输出使用 FileMode.CreateNew，已有文件不会被覆盖。生成前会重新读取并验证输入，防止选择后文件发生变化。
• 工具不联网、不修改注册表、hosts、代理、游戏、账号或配置，无自动更新和遥测。关于页的赞助链接只在用户点击时打开浏览器。
• 工具使用 Windows/.NET 自带组件，没有运行时第三方库。构建不下载依赖。测试样本下载脚本和 GitHub Actions 会联网，仅用于开发验证。
• 本仓库不附带官方或已修复的启动器。发行 EXE 来自本仓库源码重新编译，没有使用参考工具的 EXE。

本工具未进行代码签名。安全软件可能显示未知发布者；文件指纹用于检查下载完整性，不能独立证明软件没有恶意行为。可以审查源码并自行构建。对于来源不明的参考 EXE，本项目没有运行，也不作无病毒保证。

在 Windows PowerShell 中进入源码目录：

powershell -NoProfile -ExecutionPolicy Bypass -File .\build.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\test.ps1 -DownloadOfficialFixture
powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1

构建输出位于 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，仅用于验证，不进入工具发行包。

$tool = Join-Path $PWD 'dist\PCL下载修复补丁.exe'
$process = Start-Process -FilePath $tool `
  -ArgumentList '--check "D:\PCL\PCL2.exe"' -Wait -PassThru
$process.ExitCode

$process = Start-Process -FilePath $tool `
  -ArgumentList '--patch "D:\PCL\PCL2.exe" "D:\PCL\PCL.第三方原版下载修复.exe"' -Wait -PassThru
$process.ExitCode

--check：0=支持的原文件，2=已修复，1=不支持或读取失败。--patch：0=成功，1=失败。参数错误返回 64。命令行模式不弹出修复窗口，错误信息写入已连接的控制台；自动化应等待进程并读取返回码。

仓库只包含独立工具源码、构建脚本、测试和许可文件。外层的上游源码、参考工具、原始 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。