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

263 lines
11 KiB
C#
Raw Permalink 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.Linq;
using System.Net.Sockets;
using System.Text;
using System.Text.Json;
using System.Threading;
using System.Threading.Tasks;
namespace YuncangTrace.LocalService.Services.Scan;
/// <summary>
/// 一条扫码通道 = 一台已纳入管理的扫码设备(原 AndroidScanCenter 的 Channel)。
///
/// 绑定键是 **MAC**(设备 DHCP,IP 会变),`LastIp` 只是「最后一次见到」的缓存。
/// 通道**不再区分团购/散单**——团散在「工作台」上区分。
/// </summary>
public sealed class ScanChannel
{
/// <summary>设备 MAC(12 位十六进制,大写)</summary>
public string Mac { get; set; } = string.Empty;
/// <summary>通道号(添加时分配最小空号,之后固定;上报时就是 channelId)</summary>
public int Number { get; set; }
/// <summary>显示名(默认取设备 HostName,可改)</summary>
public string Name { get; set; } = string.Empty;
/// <summary>最后一次见到的 IP</summary>
public string LastIp { get; set; } = string.Empty;
/// <summary>
/// 设备型号(UDP 发现应答的 Type / CustomerID)。
/// <c>AndroidStation</c> = 安卓扫描通道:桌面端识别到条码后需要通知它播报「扫码成功」。
/// </summary>
public string Model { get; set; } = string.Empty;
/// <summary>设备 TCP 端口(设备当服务端;桌面端用 8087,避开 Android 中控的 8086)</summary>
public int TcpPort { get; set; } = ScanProtocol.TcpPort;
/// <summary>
/// 设备上我们实际用的 SOCK 条目名。
///
/// 默认是 <see cref="ScanProtocol.SockName"/>(packcenter);但设备最多只能放 3 条条目,
/// 满了时会**复用一条非保留条目**(把它的名字拿去改成 8087),那时这里记的就是被复用的名字。
/// </summary>
public string SockName { get; set; } = string.Empty;
/// <summary>扫码枪是否静音(现场偏好,暂只记录)</summary>
public bool Muted { get; set; }
public long AddedAtMs { get; set; } = DateTimeOffset.Now.ToUnixTimeMilliseconds();
// ---------------- 运行时状态(不落盘) ----------------
/// <summary>TCP 连接状态</summary>
[System.Text.Json.Serialization.JsonIgnore]
public bool Connected { get; set; }
/// <summary>最近一条条码</summary>
[System.Text.Json.Serialization.JsonIgnore]
public string LastCode { get; set; } = string.Empty;
/// <summary>最近条码时间</summary>
[System.Text.Json.Serialization.JsonIgnore]
public DateTime? LastCodeAt { get; set; }
[System.Text.Json.Serialization.JsonIgnore]
public string DisplayName => string.IsNullOrWhiteSpace(Name) ? (string.IsNullOrEmpty(Mac) ? "(未知)" : Mac) : Name.Trim();
/// <summary>上报给服务端的 channelId(用通道号,稳定且短)</summary>
[System.Text.Json.Serialization.JsonIgnore]
public string ChannelId => Number.ToString();
/// <summary>是否安卓扫描通道(只有它需要收到「扫码成功」通知去播报)</summary>
[System.Text.Json.Serialization.JsonIgnore]
public bool IsAndroidStation => ScanDeviceKind.IsAndroidStation(Model);
}
/// <summary>通道配置读写(普通模式 `%LOCALAPPDATA%\YuncangTrace\channels.json`;服务模式 `%ProgramData%\YuncangTrace\channels.json`)</summary>
public static class ChannelStore
{
private static string Dir => AgentPaths.DataRoot;
private static string FilePath => AgentPaths.ChannelsFile;
private static readonly JsonSerializerOptions Options = new()
{
WriteIndented = true,
Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
};
/// <summary>读通道列表(读不到返回空列表,绝不抛)</summary>
public static List<ScanChannel> Load()
{
try
{
if (!File.Exists(FilePath)) return new List<ScanChannel>();
var list = JsonSerializer.Deserialize<List<ScanChannel>>(File.ReadAllText(FilePath), Options)
?? new List<ScanChannel>();
NormalizeNumbers(list);
MigratePort(list);
return list;
}
catch (Exception ex)
{
AppLog.Write($"[scan] 读取通道配置失败:{ex.Message}");
return new List<ScanChannel>();
}
}
/// <summary>保存通道列表(只落盘持久字段,运行时状态由 JsonIgnore 排除)</summary>
public static void Save(IEnumerable<ScanChannel> channels)
{
try
{
Directory.CreateDirectory(Dir);
File.WriteAllText(FilePath, JsonSerializer.Serialize(channels.ToList(), Options));
}
catch (Exception ex)
{
AppLog.Write($"[scan] 保存通道配置失败:{ex.Message}");
}
}
/// <summary>老数据/缺号的数据补齐通道号(分配最小空号,删掉的不复用)</summary>
private static void NormalizeNumbers(List<ScanChannel> list)
{
var used = new HashSet<int>(list.Where(item => item.Number > 0).Select(item => item.Number));
foreach (var channel in list.Where(item => item.Number <= 0))
{
var number = 1;
while (used.Contains(number)) number++;
channel.Number = number;
used.Add(number);
}
}
/// <summary>分配最小的空号</summary>
public static int NextNumber(IEnumerable<ScanChannel> channels)
{
var used = new HashSet<int>(channels.Select(item => item.Number));
var number = 1;
while (used.Contains(number)) number++;
return number;
}
/// <summary>
/// 旧配置里存的是 8086(早期跟 Android 中控共用的端口)→ 改成桌面端自己的端口。
/// 改了之后设备上还没这条条目,靠「连不上时自愈」自动建。
/// </summary>
private static void MigratePort(List<ScanChannel> list)
{
var migrated = list.Where(item => item.TcpPort != ScanProtocol.TcpPort).ToList();
if (migrated.Count == 0) return;
foreach (var channel in migrated)
{
AppLog.Write($"[scan] 通道 {channel.Number} 端口 {channel.TcpPort} → {ScanProtocol.TcpPort}(不再与 Android 中控的 8086 共用)");
channel.TcpPort = ScanProtocol.TcpPort;
}
Save(list);
}
/// <summary>通道号上限(与原中控一致:现场是工位号,量级几十)</summary>
public const int MaxNumber = 50;
/// <summary>某个号是否已被别的通道占用(<paramref name="exceptMac"/> 用于「改自己」时排除自己)</summary>
public static ScanChannel? FindByNumber(IEnumerable<ScanChannel> channels, int number, string? exceptMac = null)
{
return channels.FirstOrDefault(item => item.Number == number
&& (exceptMac is null || !item.Mac.Equals(exceptMac, StringComparison.OrdinalIgnoreCase)));
}
}
/// <summary>扫码链路用到的常量(与设备固件一致)</summary>
public static class ScanProtocol
{
/// <summary>UDP 发现 / JCMD 端口(设备监听)</summary>
public const int UdpPort = 48899;
/// <summary>
/// 设备侧 TCP 监听端口(设备当服务端,把串口数据推给连上来的人)。
///
/// ⚠️ 不用 8086:那是 Android 中控(条目 `scancenter`)在用的。同一台设备上
/// 两条连接都往串口写,设置会互相覆盖(Android 那边重连时会把静音顶掉)。
/// 桌面端用**自己的条目名 + 自己的端口**,互不干扰。
/// </summary>
public const int TcpPort = 8087;
/// <summary>广播报文(`ConnectMode` 必须是 Forbidden:只发现,不改设备服务器配置)</summary>
public const string BroadcastPayload =
"{\"Agent\":0,\"Type\":\"EP_Tool\",\"PasswordEn\":0,\"ServPort\":0,\"Version\":\"3.1.3f\","
+ "\"ConnectMode\":\"Forbidden\",\"Zone\":\"EPort\",\"ServEn\":1,\"ServAddr\":\"0.0.0.0\",\"ClientEn\":0}";
// JCMD 命令号
/// <summary>读配置(10003→10004)</summary>
public const int CidGetConfig = 10003;
/// <summary>读运行状态(10001→10002):只有它回来的 SOCK 条目才带 `ClientIP`</summary>
public const int CidGetState = 10001;
/// <summary>写配置(10005→10006,增量;SOCK 段是整条写)</summary>
public const int CidSetConfig = 10005;
/// <summary>把配置落 flash(10017→10018):不落盘的话一次重载就丢(原中控已实测)</summary>
public const int CidSaveFlash = 10017;
public const int CidDoRestart = 20003;
/// <summary>桌面端自己的 SOCK 条目名(不能跟 Android 的 `scancenter` 重名)</summary>
public const string SockName = "packcenter";
/// <summary>条码合法性(与原中控一致:去空白后 4~64 位,不含控制字符)</summary>
public static string? CleanBarcode(string? raw)
{
if (string.IsNullOrWhiteSpace(raw)) return null;
// 设备每 ~0.7s 推一帧 `04 D0 00 00 FF 2C`:控制字节会被当分帧清掉,
// 但结尾那个 0x2C(',')是可打印字符,会粘在紧接着的条码前面,
// 现场出现的就是 `,6901028011778`。条码本体不会以非字母数字开头/结尾,
// 所以首尾的非字母数字一律削掉(**中间的保留**,GS1 内部可能有 `-` `/`)。
var text = raw.Trim();
text = System.Text.RegularExpressions.Regex.Replace(text, "^[^0-9A-Za-z]+", string.Empty);
text = System.Text.RegularExpressions.Regex.Replace(text, "[^0-9A-Za-z]+$", string.Empty);
if (text.Length is < 4 or > 64) return null;
if (text.Any(ch => char.IsControl(ch))) return null;
return text;
}
/// <summary>
/// 收一个 UDP 包,带**真实超时**。
///
/// ⚠️ `UdpClient.Client.ReceiveTimeout` 只对**同步** `Receive` 生效,
/// `ReceiveAsync` 完全不看它 —— 设备不回应时会一直挂着(自愈/读配置就卡死在那里)。
/// </summary>
/// <returns>收到返回字节;超时返回 null(调用方据此当“没应答”处理)</returns>
public static async Task<byte[]?> ReceiveWithTimeoutAsync(UdpClient udp, int timeoutMs,
CancellationToken ct = default)
{
using var cts = CancellationTokenSource.CreateLinkedTokenSource(ct);
cts.CancelAfter(timeoutMs);
try
{
var received = await udp.ReceiveAsync(cts.Token).ConfigureAwait(false);
return received.Buffer;
}
catch (OperationCanceledException) when (!ct.IsCancellationRequested)
{
return null; // 超时
}
}
/// <summary>UTF-8 无 BOM 字节(UDP/TCP 报文都用它)</summary>
public static byte[] Utf8(string text) => new UTF8Encoding(false).GetBytes(text);
}