fix(Server): AppType filtering, WebRootPath, and new patch package (#43)

* fix(Server): AppType filtering, WebRootPath, and new patch package

- Use IWebHostEnvironment.WebRootPath instead of AppDomain.BaseDirectory
  to correctly locate wwwroot in both dev and publish scenarios
- Filter patches by request.AppType to avoid returning mismatched updates
- Remove hardcoded call counter to allow repeated test runs
- Add patch_20260529221936.zip with matching SHA256 hash
- Update csproj to copy patch_*.zip to output directory

* feat(Server): 完善升级服务器，支持全量/差分升级包

ISSUE: src/Server 仅是一个硬编码模拟服务器，不支持：
  - versions.json 动态加载
  - AppType/Platform/ProductId 过滤
  - VersionChain / CrossVersion 升级模式
  - 基于 SHA256 的文件下载（断点续传）
  - ClientTest/UpgradeTest 端到端升级流程

CHANGES:
  Server:
    重写 Program.cs，从 versions.json 动态加载包元数据
    新增 /Upgrade/ 和 /Update/ 双路由兼容
    新增 GET /File/Download/{hash} 下载端点（支持 Range）
    新增请求日志中间件
    新增 8 个升级包（Client/Upgrade × 全量/差分 × 多版本）

  DTOs:
    VerifyDTO 新增 UpgradeMode 字段
    VerificationResultDTO 新增 UrlExpireTimeUtc/UpgradeMode/
    IsCrossVersion/FromVersion/ToVersion 字段

  脚本:
    generate_packages.ps1 — 从 content 目录生成升级包
    finalize_packages.ps1 — 整合差分/模拟包并生成 versions.json
    create_versions_json.ps1 — 重建 versions.json

  Content:
    从 content_client/content_upgrade 移除 GeneralUpdate.*.dll，
    避免升级包覆盖运行时 DLL 导致 IPC 解密失败

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: JusterZhu

src/Server/DTOs/VerificationResultDTO.cs

@@ -3,17 +3,17 @@ namespace ServerSample.DTOs;
 public record VerificationResultDTO
 {
     /// <summary>
-    /// 用于更新结果上报
+    /// 记录 ID，用于更新结果上报
     /// </summary>
     public int RecordId { get; set; }
-    
+
     /// <summary>
     /// 包名称
     /// </summary>
     public string? Name { get; set; }
 
     /// <summary>
-    /// 补丁包hash值
+    /// 补丁包 SHA256 哈希值
     /// </summary>
     public string? Hash { get; set; }
 
@@ -27,40 +27,68 @@ public record VerificationResultDTO
     /// </summary>
     public string? Url { get; set; }
 
+    /// <summary>
+    /// 签名 URL 过期时间 (UTC)
+    /// </summary>
+    public DateTime? UrlExpireTimeUtc { get; set; }
+
     /// <summary>
     /// 版本号
     /// </summary>
     public string? Version { get; set; }
 
     /// <summary>
-    /// 应用类型
+    /// 应用类型: 1=Client(主应用), 2=Upgrade(升级器)
     /// </summary>
     public int? AppType { get; set; }
 
     /// <summary>
-    /// 平台
+    /// 系统平台: 1=Windows, 2=Linux, 3=macOS
     /// </summary>
     public int? Platform { get; set; }
 
     /// <summary>
-    /// 产品id
+    /// 产品 ID
     /// </summary>
     public string? ProductId { get; set; }
 
     /// <summary>
     /// 是否强制更新
     /// </summary>
     public bool? IsForcibly { get; set; }
-    
+
     /// <summary>
-    /// 文件格式
+    /// 文件格式（如 .zip）
     /// </summary>
-    public string Format { get; set; } = string.Empty;
+    public string? Format { get; set; }
 
     /// <summary>
-    /// 文件大小
+    /// 文件大小（字节）
     /// </summary>
     public long? Size { get; set; }
-    
+
+    /// <summary>
+    /// 是否冻结（冻结的包不参与更新）
+    /// </summary>
     public bool? IsFreeze { get; set; }
+
+    /// <summary>
+    /// 升级模式: 1=VersionChain, 2=CrossVersion
+    /// </summary>
+    public int? UpgradeMode { get; set; }
+
+    /// <summary>
+    /// 是否为跨版本升级包
+    /// </summary>
+    public bool? IsCrossVersion { get; set; }
+
+    /// <summary>
+    /// 跨版本升级的源版本号
+    /// </summary>
+    public string? FromVersion { get; set; }
+
+    /// <summary>
+    /// 跨版本升级的目标版本号
+    /// </summary>
+    public string? ToVersion { get; set; }
 }

src/Server/DTOs/VerifyDTO.cs

@@ -3,27 +3,32 @@ namespace ServerSample.DTOs;
 public class VerifyDTO
 {
     /// <summary>
-    /// 版本号
+    /// 客户端当前版本号
     /// </summary>
     public string? Version { get; set; }
 
     /// <summary>
-    /// 应用类型
+    /// 应用类型: 1=Client(主应用), 2=Upgrade(升级器)
     /// </summary>
     public int? AppType { get; set; }
 
     /// <summary>
-    /// 应用密钥
+    /// 应用密钥，用于服务端验证
     /// </summary>
     public string? AppKey { get; set; }
 
     /// <summary>
-    /// 系统平台
+    /// 系统平台: 1=Windows, 2=Linux, 3=macOS
     /// </summary>
     public int? Platform { get; set; }
 
     /// <summary>
-    /// 所属产品分支id
+    /// 所属产品分支 ID
     /// </summary>
     public string? ProductId { get; set; }
+
+    /// <summary>
+    /// 升级模式: 1=VersionChain(逐版本链式升级), 2=CrossVersion(跨版本升级)
+    /// </summary>
+    public int? UpgradeMode { get; set; }
 }