- 后端: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>
127 lines
6.0 KiB
C#
127 lines
6.0 KiB
C#
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;
|
||
}
|