一帧里只认第一个解码成功的条码,两张面单并排时必然只报旧码、漏掉新码 (角点顺序由检测器决定,跟哪张是新面单无关)。改成: - 一帧的每个候选都解,不再解出第一个就停;同帧两个新码都上报,不压帧不投票; - 新增条码历史(旧→新,最多 4 个):本帧解出的每个码都刷新「最后出现时间」; 历史里没有的码立即上报,已有一律只刷新在场、不重复建档/播报; - 多码同框时上报/续期的是「最后出现的那个」,不是检测器先解出来的那个; 一直看得见的码不重排(避免每帧互相顶掉导致上报抖动),离开又回来的挪到末尾; - 超过 45 秒没再出现的码淘汰(与「面单离开」同一阈值),再出现按新码上报。 排障新增 agent-status.json 的 LabelScan.Items[].RecentCodes(历史,旧→新)。 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
435 lines
16 KiB
C#
435 lines
16 KiB
C#
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=实时;>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;
|
||
}
|
||
}
|
||
}
|
||
}
|