CheckDownload - 智能文件更新器

这是一个C#编写的高效、智能的文件更新与下载工具。它被设计用于自动比较本地文件与服务器上的文件清单，并只下载有变动或缺失的文件，同时具备诸多高级功能以确保更新过程的稳定与顺畅。

核心功能

• MD5校验更新：通过比较本地与远程服务器上的 md5.json 文件，精确识别需要更新的文件，实现增量更新，节省带宽和时间。
• 多下载源支持：
  • 阿里云OSS：作为主要的稳定文件存储。
  • 123网盘：作为备用下载链路，通过动态生成鉴权URL进行下载。
• 智能基准目录检测：程序能够根据 md5.json 中的文件结构，自动定位项目的主目录，确保即使程序被移动到子文件夹内，文件也能被更新到正确的位置。
• 并发下载与失败重试：
  • 支持多线程并发下载，大幅提升下载效率。
  • 内置下载失败自动重试机制，应对临时的网络波动。
• IP直连与DNS容灾：当通过域名访问下载服务器失败时，程序会自动尝试通过备用DNS服务解析IP地址，并直接使用IP进行连接，极大地提高了在复杂网络环境下的下载成功率。

高级特性与处理逻辑

• 智能解压 tim.7z：
  • 精确进程控制：在更新完成后，如果找到 tim.7z 压缩包，程序会先将其内容解压到一个临时隔离目录。
  • 条件判断：仅当在解压内容中检测到 tim.dll 时，程序才会去关闭正在运行的 tim.exe 进程，以避免文件占用。
  • 安全覆盖：完成上述检查和操作后，再将所有文件移动到最终的目标位置。这个过程避免了不必要地中断用户正在运行的程序。
• 自动设置管理员权限：对于从 tim.7z 中解压出的所有 .exe 可执行文件，程序会自动在Windows注册表中为其添加"以管理员身份运行"的兼容性设置，确保这些程序拥有足够的权限来正常工作。
• 处理文件占用：
  • 自动解锁：在移动文件时，如果目标文件被占用，程序会先尝试等待1秒后重试。
  • 下次启动时替换：如果文件仍然被占用，程序会自动创建一个批处理脚本 (.bat)，该脚本会在主程序退出后运行，从而在系统下次启动或空闲时完成文件的替换。
• 特定进程的自动关闭：
  • 在下载任何 .exe 文件之前，程序会先查找并结束同名的正在运行的进程。
  • 如果更新列表中包含 tim.dll，程序会提前结束 tim.exe 进程，以防止文件锁定。
• 数据库文件豁免：程序在进行文件比较时，会自动跳过 .db 和 .db3 结尾的数据库文件，防止因这些文件频繁变动而导致的错误更新。
• 启动稳定性：修复了在程序启动阶段可能因目录路径未初始化而导致的严重错误 (ArgumentNullException)，确保了程序的健壮性。

用户界面

• 实时进度显示：通过进度条、已完成数量/总数以及 已下载总量(实时速度) 的形式清晰地展示更新进度。已下载总量会包含已存在于临时目录的有效文件，速度则只计算运行时下载的部分。
• 简洁的状态反馈：界面会以 下载:文件名... 的格式显示当前任务，过长的文件名会被自动截断，避免信息刷屏。
• 友好的错误提示：当发生严重错误时，会弹出简明扼要的错误信息窗口，而不是难以理解的完整堆栈跟踪。
• 自动定位与退出：窗体启动时会自动停靠在屏幕右下角，更新完成后会自动关闭，对用户干扰极小。

配置

程序的核心参数（如最大并发下载数、重试次数等）可以通过 App.config 文件进行调整。

// App.config 示例
<appSettings>
    <add key="MaxConcurrentDownloads" value="4" />
    <add key="MaxDownloadRetries" value="2" />
</appSettings>

这个工具集成了多种故障处理和智能逻辑，旨在提供一个无人值守、高度自动化的文件更新体验。

🚀 主要功能

📥 多源下载支持

• 123盘云存储: (UID: 1826795402, Path: /1826795402/KeyAuth) 支持主备域名自动切换，提供高可用性下载服务。
• 阿里云OSS: 备用下载源，确保文件下载的可靠性。
• 智能DNS解析: 使用多个DNS服务器提高域名解析成功率。

🔄 智能更新机制

• MD5完整性验证: 下载前后进行MD5校验，确保文件完整性。
• 增量更新: 仅下载已变更的文件，节省带宽和时间。
• 断点续传支持: 通过检查本地临时文件实现，若文件已存在且MD5匹配，则跳过下载。
• 并发下载: 可配置的多线程并发下载，显著提升下载速度。

🛡️ 文件处理与安全

• 文件占用处理: 智能检测并处理被占用的文件，并创建延迟替换脚本。
• 临时文件管理: 自动清理临时文件，保持系统整洁。
• 路径智能识别: 基于MD5数据自动识别项目基准目录。

📦 自动解压功能

• 7z格式支持: 内置7z解压引擎，支持多种压缩格式。
• 自动权限设置: 解压后自动为exe文件设置管理员运行权限。
• 多架构兼容: 自动选择32位/64位解压库，适配不同运行环境。

🔧 错误处理与重试

• 多次重试机制: 下载失败自动重试，可配置重试次数。
• 异常处理: 完善的异常捕获和处理机制。
• 状态实时显示: 实时显示下载进度、状态和错误信息。

🏗️ 技术架构

核心组件

• .NET Framework: 基于稳定的.NET Framework构建。
• 异步编程: 全面采用async/await模式，确保UI响应性。
• 多线程下载: 使用SemaphoreSlim控制并发数量。
• 资源嵌入: 将依赖库嵌入程序，实现单文件部署。

依赖库

• Aliyun.OSS.SDK: 阿里云对象存储服务支持。
• Newtonsoft.Json: JSON数据处理。
• SevenZipExtractor: 7z压缩文件解压支持。

📋 配置说明

应用程序配置

程序支持通过App.config进行配置：

<appSettings>
  <!-- 最大并发下载数量 -->
  <add key="MaxConcurrentDownloads" value="4" />
  <!-- 最大下载重试次数 -->
  <add key="MaxDownloadRetries" value="2" />
</appSettings>

MD5文件格式

程序使用JSON格式的MD5文件来管理文件版本：

{
  "version": "1.0.0",
  "data": {
    "program.exe": "5d41402abc4b2a76b9719d911017c592",
    "lib/library.dll": "098f6bcd4621d373cade4e832627b4f6"
  }
}

🔄 工作流程

1. 启动检查: 程序启动时清理旧的更新文件 (.new 后缀)。
2. 下载MD5: 从云存储下载最新的MD5文件。
3. 文件比较: 对比本地文件与在线MD5，识别需要更新的文件。
4. 并发下载: 使用多线程下载需要更新的文件到临时目录。
5. 完整性验证: 验证下载文件的MD5值。
6. 文件替换: 将新文件移动到目标位置，对被占用文件创建替换脚本。
7. 7z解压: 自动检测并解压tim.7z文件（如果存在）。
8. 权限设置: 为解压的exe文件设置管理员运行权限。
9. 清理完成: 清理临时目录，显示完成状态后退出。

🎯 使用场景

• 软件自动更新: 为桌面应用程序提供自动更新功能。
• 文件同步: 在不同设备间同步文件和配置。
• 游戏更新: 游戏客户端的增量更新和补丁分发。

---

注意: 本程序需要网络连接以下载更新文件。首次运行时可能需要较长时间来下载所有必要的文件。