diff --git a/backend/scripts/deploy/publish-desktop.cjs b/backend/scripts/deploy/publish-desktop.cjs index 76f153c..1612af8 100644 --- a/backend/scripts/deploy/publish-desktop.cjs +++ b/backend/scripts/deploy/publish-desktop.cjs @@ -178,6 +178,14 @@ function main() { const versionJson = JSON.parse(fs.readFileSync(versionPath, 'utf8')); + // --notes 要穿过 shell/powershell 两层命令行,中文偶尔会被按 GBK 解一遍(上一次发布就是乱码)。 + // 这里用 node 里这份(Unicode 一定正确)覆盖写回,保证客户端更新弹窗里的说明不乱码。 + if (options.notes && versionJson.releaseNotes !== options.notes) { + versionJson.releaseNotes = options.notes; + fs.writeFileSync(versionPath, JSON.stringify(versionJson, null, 2), 'utf8'); + console.log('更新说明已按 UTF-8 重新写入 version.json'); + } + // version.json 里有 downloadUrlExe 就必须把 EXE 一起传上去,否则新客户端拿到的是 404 const packages = []; if (fs.existsSync(msiPath)) packages.push(msiPath); diff --git a/desktop/README.md b/desktop/README.md index cdaf8b6..c233c80 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -798,9 +798,10 @@ xstack 只做一遍。实测(本机 i5-12400 + UHD 730,机器同时在跑别 | 安装 / 卸载 | 开启 / 关闭设备服务时用 `runas` 提权(**各弹一次 UAC**),之后日常使用无 UAC | | 升级 | 新版本启动后检测服务副本版本,提示更新(一次 UAC) | | 日志 | `%ProgramData%\YuncangTrace\agent\logs\log_*.txt` | -| 日志策略 | 按天一个文件,**自动保留 14 天**;状态文件改为「内容变化才写 + 30 秒保活」(不再每 2 秒重写);面单压着扫码器时同一个码每 5 分钟才记一行 | +| 日志策略 | 按天一个文件,**自动保留 14 天**;状态文件改为「内容变化才写 + 30 秒保活」(每帧都变的诊断计数器不算变化,不再 2.5 次/秒重写);面单压着扫码器时同一个码每 5 分钟才记一行 | | 手动排障 | `sc query YuncangTraceAgent` / `sc start|stop YuncangTraceAgent` | | 调试 | `YuncangTrace.LocalService.exe --agent-run`(不经 SCM,直接跑后台循环) | +| 单实例 | `Global\YuncangTraceAgent.instance`:服务/manual 双开会被第二个实例直接拒绝(不重复拉流、不抢写 `agent-status.json`、不抢 hik-worker 管道) | > **退出登录不会关闭设备服务**:服务模式下只清登录态,设备令牌和 `agent.json` 保留,扫码继续上报。 > 要停止必须走「服务 → 关闭设备服务」。 @@ -895,7 +896,8 @@ xstack 只做一遍。实测(本机 i5-12400 + UHD 730,机器同时在跑别 顶部状态行显示 `已拉取 N 路 · 时间`,底部的黄字是服务端提示(例如「摄像头找不到录像机」「录像机没有保存密码」)。 数据来源:服务模式下由**后台服务**拉配置 + 识别,界面读 `agent-status.json` 的 `LabelScan` -(后台服务每 **400ms** 写一轮、界面每 **300ms** 轮询一次,识别到就是几百毫秒内能看到); +(后台服务每 **400ms** 检查一轮状态、**内容变化才写**文件、界面每 **300ms** 轮询一次,识别到就是几百毫秒内能看到; +`FramesRead` / `LastWaitMs` 这类每帧都变的排障计数器不参与「变化即写」的判据,只随 30 秒保活写回去); 普通模式下直接读本进程 `ScanService.LabelScan`。 #### 配置拉取(`LabelScanMonitor`) @@ -945,7 +947,9 @@ ffmpeg(RTSP, tcp) → 灰度 rawvideo 帧 → 读帧线程只留最新一帧( 3. 两个码都在历史里时,上报/续期的是**最后出现的那个**,不是检测器先解出来的那个; 已有的码只更新时间、不重排,避免同框两码每帧互相顶掉导致上报抖动。 - 同一张面单连续命中节流到 500ms 一次:足够维持「在场」状态,又不会刷上报; -- 断流自动重连(3 秒),连续失败按 3/10 次节流打日志;不影响扫码枪链路。 +- 断流自动重连:**3 秒起、按 2 的幂退避到 60 秒**,连续失败按 3/10 次节流打日志; + 连上后要稳定跑够 30 秒才算恢复(连上就断的话间隔会一直涨,不会每 3 秒重拉一次 ffmpeg); + **内存不足(OutOfMemory / Cannot allocate memory)固定等 60 秒**再试,别在系统已经吃紧时反复申请内存。不影响扫码枪链路。 排障字段(`agent-status.json` 的 `LabelScan.Items[]`): diff --git a/desktop/Services/Agent/AgentHost.cs b/desktop/Services/Agent/AgentHost.cs index 21c49e3..30d0053 100644 --- a/desktop/Services/Agent/AgentHost.cs +++ b/desktop/Services/Agent/AgentHost.cs @@ -3,6 +3,7 @@ using System.Collections.Generic; using System.IO; using System.Linq; using System.Text.Json; +using System.Text.Json.Nodes; using System.Threading; using System.Threading.Tasks; using YuncangTrace.LocalService.Services.Scan; @@ -42,6 +43,16 @@ public static class AgentHost { AgentPaths.MachineMode = true; AgentPaths.IsServiceProcess = true; + + // 一台机器只允许一个后台扫码服务:两个实例会同时拉两套面单摄像头(内存/带宽翻倍)、 + // 同时写 agent-status.json(后写的撞上「拒绝访问」)、同时抢 hik-worker 命名管道。 + using var instanceLock = TryAcquireInstanceLock(); + if (instanceLock is null) + { + AppLog.Write("[agent] 已有另一个后台服务实例在运行,本进程直接退出(不重复拉流、不抢写状态文件)"); + return; + } + AppLog.Write("[agent] 后台扫码服务启动"); try @@ -99,6 +110,59 @@ public static class AgentHost private static string Version => typeof(AgentHost).Assembly.GetName().Version?.ToString() ?? "1.0.0"; + /// + /// 后台服务单实例锁。 + /// + /// 服务跑在 Session 0、手动 --agent-run 跑在用户会话,而 Local\ 是按会话隔离的 + /// (根本抓不到这种"同机双实例"),所以优先用 Global\。 + /// 普通用户没有 SeCreateGlobalPrivilege 时会拿不到对象:这时只要服务已安装且在跑, + /// 就同样判定为"已有实例";否则退化成 Local\,至少挡住同一会话内的重复启动。 + /// + private static Mutex? TryAcquireInstanceLock() + { + foreach (var name in new[] { @"Global\YuncangTraceAgent.instance", @"Local\YuncangTraceAgent.instance" }) + { + Mutex mutex; + try + { + mutex = new Mutex(initiallyOwned: false, name); + } + catch (UnauthorizedAccessException) + { + if (IsAgentServiceRunning()) return null; + continue; + } + + try + { + if (mutex.WaitOne(TimeSpan.Zero)) return mutex; + } + catch (AbandonedMutexException) + { + return mutex; // 上一个实例没释放就退出了:这个锁现在归我们 + } + + mutex.Dispose(); + return null; // 对象建得出来但抢不到 → 确实有实例在跑 + } + + // 两个命名空间都建不了(极端权限情况):不阻塞启动,交一个空锁占位 + return new Mutex(); + } + + private static bool IsAgentServiceRunning() + { + try + { + using var service = new System.ServiceProcess.ServiceController(ServiceInstaller.ServiceName); + return service.Status != System.ServiceProcess.ServiceControllerStatus.Stopped; + } + catch + { + return false; // 没安装 / 查不到:当作没有 + } + } + private static async Task RunCoreAsync(AgentConfig config, CancellationToken ct) { // 用内存里的设置喂给 DeviceService:它只用到 DeviceToken / DeviceSn / SubjectId / Enabled @@ -374,7 +438,9 @@ public static class AgentHost nextNtpAt = DateTime.UtcNow.AddMinutes(Math.Max(config.NtpIntervalMinutes, 5)); } - // ⑦ 状态:内容变化才写,30 秒没变化保活写一次(避免每 2 秒重写文件) + // ⑦ 状态:内容变化才写,30 秒没变化保活写一次。 + // 每帧都在变的诊断计数器(FramesRead / LastWaitMs…)不参与比较 —— + // 否则 400ms 一轮里几乎每轮都在重写文件(2.5 次/秒),对现场机械盘是纯磨损。 { var status = BuildStatus(scan, device, config, ntp, hikStatus); status.TokenExpiresAt = JwtUtil.Expiry(settings.DeviceToken); @@ -385,7 +451,7 @@ public static class AgentHost status.LastHeartbeatError = lastHeartbeatError; status.UpdatedAt = default; // 签名忽略时间戳 - var signature = JsonSerializer.Serialize(status); + var signature = StatusSignature(status); if (signature != lastStatusJson || DateTime.UtcNow - lastStatusWriteAt >= StatusKeepAlive) { @@ -552,6 +618,47 @@ public static class AgentHost }; } + /// + /// 状态文件的「内容签名」:剔掉每帧都变的诊断计数器,只留真正值得立刻让界面看到的变化。 + /// + /// 400ms 一轮里这些计数器几乎每轮都是新值,参与比较就等于每 400ms 重写一次状态文件 + /// (2.5 次/秒、一天二十万次),对现场机械盘毫无意义。诊断字段靠 30 秒保活写回去。 + /// + private static string StatusSignature(AgentStatus status) + { + var node = JsonSerializer.SerializeToNode(status)!.AsObject(); + + if (node[nameof(AgentStatus.LabelScan)] is JsonObject labelScan + && labelScan[nameof(AgentLabelScanStatus.Items)] is JsonArray items) + { + foreach (var item in items.OfType()) + { + foreach (var name in VolatileLabelFields) item.Remove(name); + } + } + + return node.ToJsonString(); + } + + /// 面单识别里每帧都会变的排障字段(不参与状态文件的「变了就写」判据) + private static readonly string[] VolatileLabelFields = + { + nameof(AgentLabelCameraStatus.FramesRead), + nameof(AgentLabelCameraStatus.FrameThrottled), + nameof(AgentLabelCameraStatus.FramesDecoded), + nameof(AgentLabelCameraStatus.LastWaitMs), + nameof(AgentLabelCameraStatus.LastLoopMs), + nameof(AgentLabelCameraStatus.FrameLag), + nameof(AgentLabelCameraStatus.FrameDropped), + nameof(AgentLabelCameraStatus.LastDecodeMs), + nameof(AgentLabelCameraStatus.LastCvMs), + nameof(AgentLabelCameraStatus.LastPath), + nameof(AgentLabelCameraStatus.RoiFailStreak), + nameof(AgentLabelCameraStatus.SteadyHits), + nameof(AgentLabelCameraStatus.RoiText), + nameof(AgentLabelCameraStatus.RoiRatio), + }; + /// /// 边缘任务循环:长轮询领任务 → 交给 worker 执行 → 回结果。 /// diff --git a/desktop/Services/Agent/HikWorker.cs b/desktop/Services/Agent/HikWorker.cs index 9cd4364..e9e9828 100644 --- a/desktop/Services/Agent/HikWorker.cs +++ b/desktop/Services/Agent/HikWorker.cs @@ -24,6 +24,9 @@ namespace YuncangTrace.LocalService.Services; /// public static class HikWorker { + /// 管道连续建不起来多少次就退出(约 4~5 分钟,交给主进程的熔断逻辑处理) + private const int MaxPipeFailures = 12; + /// worker 入口;返回进程退出码 public static async Task RunAsync(CancellationToken ct) { @@ -55,6 +58,7 @@ public static class HikWorker _ = Task.Run(() => RunLanResponderAsync(ct), CancellationToken.None); _ = Task.Run(() => edgeHttp.RunAsync(download, playback, ct), CancellationToken.None); + var pipeFailures = 0; try { while (!ct.IsCancellationRequested) @@ -68,12 +72,27 @@ public static class HikWorker NamedPipeServerStream.MaxAllowedServerInstances, PipeTransmissionMode.Byte, PipeOptions.Asynchronous); + pipeFailures = 0; } catch (Exception ex) { - // 管道建不起来通常是被占用/权限问题:等一会再来,不能退出 - AppLog.Write($"[hik-worker] 创建管道失败(3 秒后重试):{ex.Message}"); - if (!await DelayAsync(TimeSpan.FromSeconds(3), ct).ConfigureAwait(false)) break; + // 管道建不起来通常是被占用/权限问题(另一个实例已经用这个管道名, + // 而且它的 ACL 不放行我们)。3 秒一次地重试会永远刷日志, + // 所以逐步退避到 30 秒;一直建不起来就退出,别留一个抢不到管道的空 worker 常驻。 + pipeFailures++; + if (pipeFailures >= MaxPipeFailures) + { + AppLog.Write($"[hik-worker] 创建管道连续失败 {pipeFailures} 次,退出:{ex.Message}"); + return 3; + } + + var seconds = Math.Min(3 * Math.Pow(2, Math.Min(pipeFailures - 1, 4)), 30); + if (pipeFailures <= 3 || pipeFailures % 10 == 0) + { + AppLog.Write($"[hik-worker] 创建管道失败({seconds:0} 秒后重试):{ex.Message}"); + } + + if (!await DelayAsync(TimeSpan.FromSeconds(seconds), ct).ConfigureAwait(false)) break; continue; } diff --git a/desktop/Services/Scan/LabelScanWorker.cs b/desktop/Services/Scan/LabelScanWorker.cs index c749442..8d7691d 100644 --- a/desktop/Services/Scan/LabelScanWorker.cs +++ b/desktop/Services/Scan/LabelScanWorker.cs @@ -293,7 +293,15 @@ public sealed class LabelScanWorker : IDisposable internal sealed class LabelCameraRunner { private const int ConnectTimeoutMs = 6000; - private const int ReconnectDelayMs = 3000; + + /// 断流重连的起始间隔 + private const int MinReconnectDelayMs = 3000; + + /// 断流重连的最大间隔(指数退避上限) + private const int MaxReconnectDelayMs = 60_000; + + /// 连上后至少稳定跑这么久才算「恢复正常」,失败计数才清零 + private const long StableStreamMs = 30_000; /// /// 解码帧率:面单放进去会停住,8fps 足够(主码流单帧解码+识别约 15~45ms,吃得下)。 @@ -551,6 +559,9 @@ internal sealed class LabelCameraRunner while (!ct.IsCancellationRequested) { Process? process = null; + long connectedAt = 0; + var delayMs = MinReconnectDelayMs; + try { SetState("starting", null); @@ -560,9 +571,9 @@ internal sealed class LabelCameraRunner Runtime.StreamText = stream.Text; process = StartFfmpeg(stream); _process = process; + connectedAt = Environment.TickCount64; SetState("running", null); if (attempts > 0) AppLog.Write($"[label-scan] {Runtime.Summary} 已重新连上码流({stream.Text})"); - attempts = 0; DecodeLoop(process, stream, ct); if (ct.IsCancellationRequested) break; @@ -574,12 +585,17 @@ internal sealed class LabelCameraRunner } catch (Exception ex) { + // 只有「连上并稳定跑够 StableStreamMs」才算恢复:连上就断说明故障还在, + // 退避要继续涨,否则每 3 秒拉起一次 ffmpeg / 探测一轮,机器越紧张越缓不过来。 + if (connectedAt > 0 && Environment.TickCount64 - connectedAt >= StableStreamMs) attempts = 0; + attempts++; - SetState("error", ex.Message); + delayMs = NextReconnectDelayMs(attempts, ex); + var note = $"(第 {attempts} 次失败,{delayMs / 1000} 秒后重试)"; + SetState("error", ex.Message + note); if (attempts <= 3 || attempts % 10 == 0) { - AppLog.Write($"[label-scan] {Runtime.Summary} 识别失败({ex.Message}),{ReconnectDelayMs / 1000} 秒后重试" - + (attempts > 1 ? $";已重试 {attempts} 次" : string.Empty)); + AppLog.Write($"[label-scan] {Runtime.Summary} 识别失败({ex.Message}){note}"); } } finally @@ -590,7 +606,7 @@ internal sealed class LabelCameraRunner try { - await Task.Delay(ReconnectDelayMs, ct).ConfigureAwait(false); + await Task.Delay(delayMs, ct).ConfigureAwait(false); } catch (OperationCanceledException) { @@ -601,6 +617,38 @@ internal sealed class LabelCameraRunner SetState("stopped", null); } + /// + /// 断流重连间隔:3 秒起按 2 的幂退避到 60 秒。 + /// + /// 内存不足时固定按最长间隔等:每次重连都要新建 ffmpeg + 三块整帧缓冲, + /// 内存已经不够时 3 秒重试一次只会把系统按得更死(2026-11-18 现场那次死循环)。 + /// + internal static int NextReconnectDelayMs(int attempts, Exception error) + { + if (IsMemoryPressure(error)) return MaxReconnectDelayMs; + + var shift = Math.Min(Math.Max(attempts - 1, 0), 5); + return Math.Min(MinReconnectDelayMs << shift, MaxReconnectDelayMs); + } + + private static bool IsMemoryPressure(Exception error) + { + for (Exception? e = error; e is not null; e = e.InnerException) + { + if (e is OutOfMemoryException) return true; + + var message = e.Message; + if (message.Contains("Cannot allocate memory", StringComparison.OrdinalIgnoreCase) + || message.Contains("not enough memory", StringComparison.OrdinalIgnoreCase) + || message.Contains("内存不足", StringComparison.Ordinal)) + { + return true; + } + } + + return false; + } + /// /// 选码流 + 找到可用的 RTSP 序号 + 拿分辨率。 /// diff --git a/desktop/Services/Scan/ScanRecordStore.cs b/desktop/Services/Scan/ScanRecordStore.cs index bf57eb0..40a723a 100644 --- a/desktop/Services/Scan/ScanRecordStore.cs +++ b/desktop/Services/Scan/ScanRecordStore.cs @@ -203,7 +203,17 @@ public static class ScanRecordStore return; } - var list = JsonSerializer.Deserialize>(File.ReadAllText(FilePath), Options); + // 共享读:服务模式下面单/扫码记录是后台服务在写,桌面端这边读的一瞬间 + // 对方正好在替换文件(File.Move 覆盖)也不会失败,更不会误判成「空库」。 + string text; + using (var stream = new FileStream(FilePath, FileMode.Open, FileAccess.Read, + FileShare.ReadWrite | FileShare.Delete)) + using (var reader = new StreamReader(stream)) + { + text = reader.ReadToEnd(); + } + + var list = JsonSerializer.Deserialize>(text, Options); if (list is null) return; _items = list.Where(item => !string.IsNullOrWhiteSpace(item.Code)).ToList(); @@ -715,8 +725,9 @@ public static class ScanRecordStore Directory.CreateDirectory(Dir); var temp = FilePath + ".tmp"; File.WriteAllText(temp, json); - File.Copy(temp, FilePath, overwrite: true); - File.Delete(temp); + // 先写 .tmp 再原子替换:对方(桌面端)正在读的时候也只是看到旧内容, + // 不会撞上「文件被另一个进程占用」;File.Copy 覆盖会拿独占句柄,正是之前刷错的来源。 + File.Move(temp, FilePath, overwrite: true); } catch (Exception ex) { diff --git a/desktop/YuncangTrace.LocalService.csproj b/desktop/YuncangTrace.LocalService.csproj index 95517c2..8611f0e 100644 --- a/desktop/YuncangTrace.LocalService.csproj +++ b/desktop/YuncangTrace.LocalService.csproj @@ -42,7 +42,7 @@ http://127.0.0.1:7300 https://packs.example.com - 1.0.162 + 1.0.164 云仓视频溯源软件 云仓 云仓视频溯源软件(本机服务)