# 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` 文件进行调整。
```csharp
// 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进行配置：

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

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

```json
{
  "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. **清理完成**: 清理临时目录，显示完成状态后退出。

## 🎯 使用场景

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

---

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