packServer/desktop/Services/UpdateChecker.cs
liufumingren 11ebb33966 feat(extension): 插件配置集中管理 + 桌面端策略安装 + 跨网下载修复
- 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension;
  插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效)
- 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成)
- 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布
- 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证);
  跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe
- 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包),
  nginx 对 /download/extension/updates.xml 关缓存

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:26 +08:00

127 lines
6.0 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

using System;
using System.Net.Http;
using System.Text.Json;
using System.Text.RegularExpressions;
using System.Threading;
using System.Threading.Tasks;
namespace YuncangTrace.LocalService.Services;
/// <summary>发现的新版本(来自后端静态 `version.json`)</summary>
/// <param name="Version">新版本号(如 1.0.1)</param>
/// <param name="DownloadUrl">
/// 安装包地址:优先 EXE(`/download/desktop/YuncangTraceSetup-x.y.z.exe`),
/// 没有 EXE 字段时退回 MSI(老客户端的唯一格式)
/// </param>
/// <param name="Md5">安装包 MD5(可用于下载后校验)</param>
/// <param name="Size">安装包字节数(0 = 未知)</param>
/// <param name="Notes">更新说明(可为空)</param>
public sealed record UpdateInfo(string Version, string? DownloadUrl, string? Md5, long Size, string? Notes);
/// <summary>
/// 自动更新检查:请求后端的静态 `GET /download/version.json`,与当前程序版本比对。
///
/// `version.json` 由 `desktop/installer/build.ps1` 生成,内容形如:
/// <code>
/// { "version": "1.0.1", "downloadUrl": "https://站点/download/YuncangTraceSetup-1.0.1.msi",
/// "md5": "…", "size": 56712345, "publishedAt": "…", "buildId": "…", "releaseNotes": "…" }
/// </code>
///
/// ⚠️ 缓存是这里最容易踩的坑(Egg 的 static 生产默认强缓存一年):
/// - URL 带 `?t=毫秒时间戳`;
/// - 请求头带 `no-cache`;
/// - 后端 `middleware/download.js` 对 version.json 回 `no-store` 并去掉 ETag/Last-Modified。
/// 三层都做,是为了兼容中间可能存在的代理 / CDN。
/// </summary>
public static class UpdateChecker
{
/// <summary>版本信息地址(跟当前构建环境的后端地址走)</summary>
public static string VersionUrl(string serverBaseUrl)
=> serverBaseUrl.TrimEnd('/') + "/download/version.json";
/// <summary>
/// 从下载地址里解析安装包版本:`.../YuncangTraceSetup-1.0.3.msi` / `.exe` → <c>1.0.3</c>;解析不到返回 null。
/// </summary>
public static Version? PackageVersionOf(string? downloadUrl)
{
if (string.IsNullOrWhiteSpace(downloadUrl)) return null;
var match = Regex.Match(downloadUrl, @"YuncangTraceSetup-(\d+(?:\.\d+){1,3})\.(?:msi|exe)", RegexOptions.IgnoreCase);
return match.Success && Version.TryParse(match.Groups[1].Value, out var version) ? version : null;
}
/// <summary>
/// 检查是否有更新。
/// </summary>
/// <returns>有新版本返回它;已是最新 / 请求失败 / 数据不合法都返回 <c>null</c></returns>
public static async Task<UpdateInfo?> CheckAsync(
string serverBaseUrl,
Version current,
CancellationToken cancellationToken = default)
{
var url = $"{VersionUrl(serverBaseUrl)}?t={DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()}";
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(8) };
using var request = new HttpRequestMessage(HttpMethod.Get, url);
request.Headers.TryAddWithoutValidation("Cache-Control", "no-cache, no-store");
request.Headers.TryAddWithoutValidation("Pragma", "no-cache");
using var response = await http.SendAsync(request, HttpCompletionOption.ResponseContentRead, cancellationToken)
.ConfigureAwait(false);
if (!response.IsSuccessStatusCode) return null;
var json = await response.Content.ReadAsStringAsync(cancellationToken).ConfigureAwait(false);
using var doc = JsonDocument.Parse(json);
var root = doc.RootElement;
if (!root.TryGetProperty("version", out var versionEl)) return null;
var text = versionEl.GetString();
if (string.IsNullOrWhiteSpace(text)) return null;
if (!Version.TryParse(text.Trim(), out var remote)) return null;
if (remote <= current) return null;
// 优先 EXE 安装包:MSI 依赖 Windows Installer,现场有电脑装不了(服务禁用/安全软件拦截)。
// 老客户端不认 downloadUrlExe,仍走 downloadUrl(= MSI),两条路都能升级。
var useExe = root.TryGetProperty("downloadUrlExe", out var exeUrl)
&& !string.IsNullOrWhiteSpace(exeUrl.GetString());
var downloadUrl = useExe
? exeUrl.GetString()
: root.TryGetProperty("downloadUrl", out var d) ? d.GetString() : null;
// 防御:version.json 的 version 可能和下载包本身不一致(配错、或发版时漏传包)。
// 若包里的版本并不比当前新,提示了也装不上去 → 会无限弹窗,直接忽略。
var packageVersion = PackageVersionOf(downloadUrl);
if (packageVersion is not null && packageVersion <= current) return null;
// ⚠️ 校验值必须跟**实际下载的那个包**对应:
// version.json 里 `md5`/`size` 是 MSI 的,`md5Exe`/`sizeExe` 才是 EXE 的;
// 以前不管下哪个都取 `md5`,于是下 EXE、拿 MSI 的哈希去比 → 每次升级都报「MD5 不一致」。
var md5 = useExe
? GetString(root, "md5Exe") ?? null
: GetString(root, "md5") ?? null;
var size = useExe
? GetLong(root, "sizeExe") ?? 0
: GetLong(root, "size") ?? 0;
return new UpdateInfo(
text.Trim(),
downloadUrl,
md5,
size,
root.TryGetProperty("releaseNotes", out var n) ? n.GetString() : null);
}
/// <summary>读字符串字段(不存在/类型不对返回 null)</summary>
private static string? GetString(JsonElement root, string name)
=> root.TryGetProperty(name, out var element)
&& element.ValueKind == JsonValueKind.String
&& !string.IsNullOrWhiteSpace(element.GetString())
? element.GetString()
: null;
/// <summary>读整数字段(不存在/类型不对返回 null)</summary>
private static long? GetLong(JsonElement root, string name)
=> root.TryGetProperty(name, out var element) && element.TryGetInt64(out var value) ? value : null;
}