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盘云存储: 支持主备域名自动切换，提供高可用性下载服务
• 阿里云OSS: 备用下载源，确保文件下载的可靠性
• 智能DNS解析: 使用多个DNS服务器提高域名解析成功率

🔄 智能更新机制

• MD5完整性验证: 下载前后进行MD5校验，确保文件完整性
• 增量更新: 仅下载已变更的文件，节省带宽和时间
• 断点续传: 支持网络中断后继续下载，提高下载成功率
• 并发下载: 可配置的多线程并发下载，显著提升下载速度

🛡️ 文件处理与安全

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

📦 自动解压功能

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

🔧 错误处理与重试

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

🏗️ 技术架构

核心组件

• .NET Framework 4.7.2: 基于稳定的.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",
    "config/settings.ini": "5e40d4c123456789abcdef1234567890"
  }
}

🔄 工作流程

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

🎯 使用场景

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

🛠️ 开发特性

网络优化

• 静态HttpClient: 避免套接字耗尽问题
• 连接池复用: 提高网络请求效率
• 超时控制: 合理的超时设置，避免长时间等待

内存管理

• 流式处理: 大文件下载使用流式处理，控制内存占用
• 及时释放: 及时释放不再使用的资源
• 临时文件: 合理使用临时文件，避免内存溢出

用户体验

• 进度显示: 实时显示下载进度和文件信息
• 状态反馈: 详细的状态信息和错误提示
• 窗口定位: 智能定位到屏幕右下角，不影响用户操作

📈 性能特点

• 高效下载: 多线程并发下载，充分利用网络带宽
• 智能重试: 失败文件智能重试，提高成功率
• 资源节约: 仅下载变更文件，节省网络流量
• 快速启动: 优化的启动流程，快速进入工作状态

🔒 安全性

• MD5验证: 确保文件在传输过程中没有被篡改
• 用户权限: 在当前用户权限下操作，避免权限滥用
• 临时目录: 使用用户临时目录，避免权限问题
• 异常处理: 完善的异常处理，避免程序崩溃

📝 版本历史

最新版本特性

• ✅ 添加7z自动解压功能
• ✅ 支持解压后程序自动设置管理员权限
• ✅ 优化多线程下载性能
• ✅ 增强错误处理和重试机制
• ✅ 改进用户界面和状态显示
• ✅ 过滤 .db / .db3 数据库文件，避免占用导致失败
• ✅ 更新列表或压缩包中出现 tim.dll 时，自动结束 tim.exe 后替换
• ✅ 所有文件匹配与进程检测均采用大小写不敏感逻辑，避免大小写差异造成的更新失败
• ✅ 精简 Status_Box 文本，并在失败时弹窗展示核心错误信息

🤝 技术支持

如需技术支持或报告问题，请联系开发团队。

---

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