liufumingren 53da30f733 feat(label-scan): 多码同框全部解出 + 条码历史判断新码/最后出现
一帧里只认第一个解码成功的条码,两张面单并排时必然只报旧码、漏掉新码
(角点顺序由检测器决定,跟哪张是新面单无关)。改成:

- 一帧的每个候选都解,不再解出第一个就停;同帧两个新码都上报,不压帧不投票;
- 新增条码历史(旧→新,最多 4 个):本帧解出的每个码都刷新「最后出现时间」;
  历史里没有的码立即上报,已有一律只刷新在场、不重复建档/播报;
- 多码同框时上报/续期的是「最后出现的那个」,不是检测器先解出来的那个;
  一直看得见的码不重排(避免每帧互相顶掉导致上报抖动),离开又回来的挪到末尾;
- 超过 45 秒没再出现的码淘汰(与「面单离开」同一阈值),再出现按新码上报。

排障新增 agent-status.json 的 LabelScan.Items[].RecentCodes(历史,旧→新)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 23:04:29 +08:00

435 lines
16 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.Collections.Generic;
using System.IO;
using System.Text.Json;
using System.Threading;
namespace YuncangTrace.LocalService.Services;
/// <summary>后台服务的配置(`%ProgramData%\YuncangTrace\agent.json`,由桌面端写入)</summary>
public sealed class AgentConfig
{
/// <summary>后端根地址(例如 http://127.0.0.1:7300)</summary>
public string ServerBaseUrl { get; set; } = "";
/// <summary>设备**长期 JWT**(默认 365 天,服务上报扫码用)</summary>
public string DeviceToken { get; set; } = "";
/// <summary>刷新令牌(服务在访问令牌快过期时自动续期)</summary>
public string RefreshToken { get; set; } = "";
public string DeviceSn { get; set; } = "";
public int DeviceId { get; set; }
public int SubjectId { get; set; }
// ---------------- NTP(服务以 LocalSystem 运行,改系统时间不需要 UAC) ----------------
public bool NtpEnabled { get; set; } = true;
public string NtpServer { get; set; } = "ntp.aliyun.com";
public int NtpIntervalMinutes { get; set; } = 30;
/// <summary>写入时间(排查用)</summary>
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>后台服务的令牌文件(`agent-token.json`;服务自动续期后更新)</summary>
public sealed class AgentToken
{
public string DeviceToken { get; set; } = "";
public string RefreshToken { get; set; } = "";
public DateTime? ExpiresAt { get; set; }
public DateTime? RefreshExpiresAt { get; set; }
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>后台服务的运行状态(桌面端只读展示)</summary>
public sealed class AgentStatus
{
public bool Running { get; set; }
public string Version { get; set; } = "";
public string DeviceSn { get; set; } = "";
public int SubjectId { get; set; }
public string UploadStatus { get; set; } = "";
public string ChannelSyncStatus { get; set; } = "";
public int PendingRecords { get; set; }
public List<AgentChannelStatus> Channels { get; set; } = new();
public string? LastError { get; set; }
/// <summary>取流子进程(--hik-worker)状态;没有取流能力时 <see cref="AgentHikStatus.Available"/> 为 false</summary>
public AgentHikStatus Hik { get; set; } = new();
/// <summary>面单识别配置的拉取状态(只拉配置,识别 worker 还没接)</summary>
public AgentLabelScanStatus LabelScan { get; set; } = new();
/// <summary>工作台 OSD 字幕(把「摄像头名 + 运单号」写进录像机通道名)</summary>
public AgentOsdStatus Osd { get; set; } = new();
public string NtpLastSyncAt { get; set; } = "";
public double NtpLastOffsetSeconds { get; set; }
public double NtpRoundTripMs { get; set; }
public DateTime? NtpServerTime { get; set; }
/// <summary>当前访问令牌到期时间</summary>
public DateTime? TokenExpiresAt { get; set; }
/// <summary>刷新令牌到期时间</summary>
public DateTime? RefreshTokenExpiresAt { get; set; }
/// <summary>最近一次续期时间</summary>
public DateTime? LastTokenRefreshAt { get; set; }
/// <summary>最近一次续期失败原因(成功则 null)</summary>
public string? LastTokenRefreshError { get; set; }
/// <summary>最近一次成功心跳时间</summary>
public DateTime? LastHeartbeatAt { get; set; }
/// <summary>最近一次心跳失败原因(成功则 null)</summary>
public string? LastHeartbeatError { get; set; }
/// <summary>累计丢弃的日志行数(日志文件被占用/磁盘满时增长,用于现场判断「日志是否完整」)</summary>
public int LogDropped { get; set; }
/// <summary>最近一次丢日志的时间</summary>
public DateTime? LogLastDroppedAt { get; set; }
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>服务里某条通道的**运行时状态**(连接/最近条码),桌面端据此显示在线离线</summary>
public sealed class AgentChannelStatus
{
public string Mac { get; set; } = "";
public bool Connected { get; set; }
public string LastIp { get; set; } = "";
public string LastCode { get; set; } = "";
public DateTime? LastCodeAt { get; set; }
}
/// <summary>
/// 取流子进程的运行时状态(桌面端/客服排障用)。
///
/// <see cref="Available"/> 为 false 只表示"取不到视频",**扫码/上报照常工作**。
/// </summary>
public sealed class AgentHikStatus
{
/// <summary>SDK 与 ffmpeg 是否就位(自检结果)</summary>
public bool Available { get; set; }
/// <summary>worker 进程当前是否已连接</summary>
public bool Connected { get; set; }
/// <summary>HCNetSDK.dll 所在目录(找不到为 null)</summary>
public string? SdkDir { get; set; }
/// <summary>ffmpeg.exe 路径(找不到为 null)</summary>
public string? FfmpegPath { get; set; }
/// <summary>成片根目录</summary>
public string VideoRoot { get; set; } = "";
/// <summary>连续失败熔断到什么时候(null = 未熔断)</summary>
public DateTime? BlockedUntil { get; set; }
/// <summary>最近一次失败原因</summary>
public string? LastError { get; set; }
/// <summary>最近一次自检时间</summary>
public DateTime? ProbedAt { get; set; }
}
/// <summary>一路面单摄像头的运行状态(桌面端只读展示)</summary>
public sealed class AgentLabelCameraStatus
{
public int WorkstationId { get; set; }
public int CameraId { get; set; }
public string WorkstationName { get; set; } = "";
public string CameraName { get; set; } = "";
public string ChannelId { get; set; } = "";
public string ChannelName { get; set; } = "";
/// <summary>工作台 → 摄像头 → 上报通道(**不含密码**)</summary>
public string Summary { get; set; } = "";
/// <summary>识别中 / 启动中… / 异常 / 已停止</summary>
public string StateText { get; set; } = "";
public string LastCode { get; set; } = "";
/// <summary>首次识别时间(记录真正用的时间,不会随重复命中刷新)</summary>
public DateTime? LastCodeAt { get; set; }
/// <summary>最近一次命中时间(只用于看摄像头是否在扫)</summary>
public DateTime? LastHitAt { get; set; }
/// <summary>当前码流(主/子 + 分辨率)</summary>
public string StreamText { get; set; } = "";
/// <summary>最近一帧解码耗时(毫秒,含倾斜补偿)</summary>
public double LastDecodeMs { get; set; }
/// <summary>最近一帧 CV 定位耗时(毫秒,不含解码)</summary>
public double LastCvMs { get; set; }
/// <summary>最近一帧走的路径(ROI / 退避跳过 / 整帧 / 扫角…)</summary>
public string LastPath { get; set; } = "";
/// <summary>ROI 连续解失败次数(≥3 时进入隔帧退避)</summary>
public int RoiFailStreak { get; set; }
/// <summary>同一个码连续解出的次数(≥3 时进入稳态退避)</summary>
public int SteadyHits { get; set; }
/// <summary>从管道读到的总帧数(ffmpeg 实际产出)</summary>
public long FramesRead { get; set; }
/// <summary>按 DecodeFps 限速后丢弃的帧数</summary>
public long FrameThrottled { get; set; }
/// <summary>解码循环处理的帧总数</summary>
public long FramesDecoded { get; set; }
/// <summary>等新帧耗时(毫秒)</summary>
public double LastWaitMs { get; set; }
/// <summary>两次取帧之间的完整周期(毫秒)</summary>
public double LastLoopMs { get; set; }
/// <summary>最近一帧自动定位到的条码区域(ROI w x h;未定位时为空文案)</summary>
public string RoiText { get; set; } = "";
/// <summary>条码历史(旧 → 新,最多 4 个;末尾是最后出现的那个)</summary>
public string RecentCodes { get; set; } = "";
/// <summary>最近一帧「透视矫正 + ZXing 解码」耗时(毫秒)</summary>
public double RoiRatio { get; set; }
/// <summary>最近一次取到帧时积压了几帧(0=实时;&gt;0 说明解码跟不上、旧帧被丢弃)</summary>
public long FrameLag { get; set; }
/// <summary>累计丢弃的旧帧数</summary>
public long FrameDropped { get; set; }
public long Hits { get; set; }
public string? LastError { get; set; }
}
/// <summary>
/// 面单摄像头识别的整体状态(配置拉取 + 每路运行状态)。
/// 文案里不含录像机密码。
/// </summary>
public sealed class AgentLabelScanStatus
{
public bool Pulled { get; set; }
public DateTime? PulledAt { get; set; }
public string Revision { get; set; } = "";
public string StatusText { get; set; } = "";
public string? Error { get; set; }
/// <summary>每路的运行状态(最近条码、状态、错误)</summary>
public List<AgentLabelCameraStatus> Items { get; set; } = new();
/// <summary>服务端给的提示(例如工作台没绑本机通道)</summary>
public List<string> Warnings { get; set; } = new();
}
/// <summary>
/// 工作台 OSD 字幕状态(agent-status.json;桌面端/排障用,**不含密码**)
/// </summary>
public sealed class AgentOsdStatus
{
public bool Enabled { get; set; }
public DateTime? PulledAt { get; set; }
public string Revision { get; set; } = "";
public string? Error { get; set; }
public string StatusText { get; set; } = "";
/// <summary>每路摄像头当前 OSD 文本 / 最近写入时间 / 错误</summary>
public List<AgentOsdCameraStatus> Items { get; set; } = new();
}
/// <summary>一路摄像头的 OSD 状态</summary>
public sealed class AgentOsdCameraStatus
{
public int WorkstationId { get; set; }
public string WorkstationName { get; set; } = "";
public int CameraId { get; set; }
public string CameraName { get; set; } = "";
public int ChannelNo { get; set; }
/// <summary>最后一次确认写入的文本(空 = 还没写过)</summary>
public string Text { get; set; } = "";
public DateTime? UpdatedAt { get; set; }
public string? LastError { get; set; }
}
/// <summary>桌面端 → 后台服务的一次性命令(写文件,服务每秒轮询)</summary>
public sealed class AgentCommand
{
public DateTime? TriggerUploadAt { get; set; }
public DateTime? ClearRecordsAt { get; set; }
public string? ClearChannelId { get; set; }
public DateTime? ReloadChannelsAt { get; set; }
public DateTime? NtpSyncAt { get; set; }
public string? NtpServer { get; set; }
/// <summary>请求后台服务立即用刷新令牌续期访问令牌(测试/排障用)</summary>
public DateTime? RefreshTokenAt { get; set; }
}
/// <summary>服务发现到的设备(写文件供桌面端展示;只保留必要字段)</summary>
public sealed class AgentDiscoveredDevice
{
public string Mac { get; set; } = "";
public string Ip { get; set; } = "";
public string HostName { get; set; } = "";
public string Model { get; set; } = "";
public string Firmware { get; set; } = "";
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>
/// agent.json / agent-status.json / agent-command.json 的读写。
///
/// 两个进程(桌面端 + 服务)会同时读写这些文件,所以:
/// - 读:<c>FileShare.ReadWrite</c>,读到一半也不会抛;
/// - 写:先写 <c>.tmp</c> 再原子替换,避免对方读到半截 JSON。
/// </summary>
public static class AgentFiles
{
private static readonly JsonSerializerOptions Options = new()
{
WriteIndented = true,
Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
};
public static AgentConfig? LoadConfig() => Read<AgentConfig>(AgentPaths.ConfigFile);
public static void SaveConfig(AgentConfig config)
{
config.UpdatedAt = DateTime.Now;
Write(AgentPaths.ConfigFile, config);
}
public static AgentToken? LoadToken() => Read<AgentToken>(AgentPaths.TokenFile);
public static void SaveToken(AgentToken token)
{
token.UpdatedAt = DateTime.Now;
Write(AgentPaths.TokenFile, token);
}
public static void ClearToken()
{
try
{
if (File.Exists(AgentPaths.TokenFile)) File.Delete(AgentPaths.TokenFile);
}
catch
{
// 删不掉不影响下次开启(会覆盖写)
}
}
public static AgentStatus? LoadStatus() => Read<AgentStatus>(AgentPaths.StatusFile);
public static void SaveStatus(AgentStatus status)
{
status.UpdatedAt = DateTime.Now;
Write(AgentPaths.StatusFile, status);
}
public static AgentCommand? LoadCommand() => Read<AgentCommand>(AgentPaths.CommandFile);
public static void SaveCommand(AgentCommand command) => Write(AgentPaths.CommandFile, command);
/// <summary>追加一条命令(保留还没被服务取走的其它命令)</summary>
public static void QueueCommand(Action<AgentCommand> apply)
{
var command = LoadCommand() ?? new AgentCommand();
apply(command);
SaveCommand(command);
}
/// <summary>服务执行完命令后清掉文件(下一条命令不会重复执行)</summary>
public static void ClearCommand()
{
try
{
if (File.Exists(AgentPaths.CommandFile)) File.Delete(AgentPaths.CommandFile);
}
catch
{
// 删不掉下次也只是重复执行一遍(幂等)
}
}
public static List<AgentDiscoveredDevice> LoadDiscovered()
=> Read<List<AgentDiscoveredDevice>>(AgentPaths.DiscoveredFile) ?? new List<AgentDiscoveredDevice>();
public static void SaveDiscovered(List<AgentDiscoveredDevice> devices)
=> Write(AgentPaths.DiscoveredFile, devices);
public static DateTime? FileTime(string path)
{
try
{
return File.Exists(path) ? File.GetLastWriteTimeUtc(path) : null;
}
catch
{
return null;
}
}
private static T? Read<T>(string path) where T : class
{
try
{
if (!File.Exists(path)) return null;
// FileShare.Delete 不能少:写方是「先写 .tmp 再原子替换」,
// 替换时要求目标文件允许删除共享,否则这边读着的那一瞬间写方会「拒绝访问」。
using var stream = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite | FileShare.Delete);
using var reader = new StreamReader(stream);
var text = reader.ReadToEnd();
return string.IsNullOrWhiteSpace(text) ? null : JsonSerializer.Deserialize<T>(text, Options);
}
catch
{
return null;
}
}
private static void Write<T>(string path, T value)
{
var json = JsonSerializer.Serialize(value, Options);
// 对方(桌面端界面)会频繁读同一个文件,原子替换偶尔会撞上「拒绝访问」:
// 这里重试几次,不要因为一次碰撞就丢掉这轮状态。
for (var attempt = 1; ; attempt++)
{
try
{
var dir = Path.GetDirectoryName(path);
if (!string.IsNullOrEmpty(dir)) Directory.CreateDirectory(dir);
var temp = path + ".tmp";
File.WriteAllText(temp, json);
File.Move(temp, path, overwrite: true);
return;
}
catch (Exception ex) when (attempt < 5 && ex is IOException or UnauthorizedAccessException)
{
Thread.Sleep(20);
}
catch (Exception ex)
{
AppLog.Write($"[agent] 写文件失败({path}):{ex.Message}");
return;
}
}
}
}