liufumingren f8aa4c4899 feat(工作台): 成员扫码登入、面单摄像头与虚拟通道
- 工作台成员扫码登入:workstation_login_records 记录谁在什么时候登入/下线了哪台工作台,
  超时(团购 1h / 散单 30min)由 schedule/workstation_idle_offline 自动下线;
  运单查询的 packers 取当时的登入成员
- 面单摄像头识别:workstation_cameras.is_label_camera + service/label_scan 下发本机该跑的识别配置,
  设备端(桌面端 LabelScan 工作线程)按配置做面单识别并上报
- 虚拟通道 CAM-<工作台id>:工作台没接扫码枪时,面单摄像头那一路顶替扫码枪上报,records 规则按 ws_type 区分
- 桌面端:新增 LabelScanMonitor/LabelScanWorker/ScanDeviceKind 与面单预览页,扫描通道支持改名,静默窗口 5s

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:19:24 +08:00

399 lines
14 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();
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>最近一帧「透视矫正 + 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>桌面端 → 后台服务的一次性命令(写文件,服务每秒轮询)</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;
}
}
}
}