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;
///
/// 一条扫码通道 = 一台已纳入管理的扫码设备(原 AndroidScanCenter 的 Channel)。
///
/// 绑定键是 **MAC**(设备 DHCP,IP 会变),`LastIp` 只是「最后一次见到」的缓存。
/// 通道**不再区分团购/散单**——团散在「工作台」上区分。
///
public sealed class ScanChannel
{
/// 设备 MAC(12 位十六进制,大写)
public string Mac { get; set; } = string.Empty;
/// 通道号(添加时分配最小空号,之后固定;上报时就是 channelId)
public int Number { get; set; }
/// 显示名(默认取设备 HostName,可改)
public string Name { get; set; } = string.Empty;
/// 最后一次见到的 IP
public string LastIp { get; set; } = string.Empty;
/// 设备 TCP 端口(设备当服务端;桌面端用 8087,避开 Android 中控的 8086)
public int TcpPort { get; set; } = ScanProtocol.TcpPort;
///
/// 设备上我们实际用的 SOCK 条目名。
///
/// 默认是 (packcenter);但设备最多只能放 3 条条目,
/// 满了时会**复用一条非保留条目**(把它的名字拿去改成 8087),那时这里记的就是被复用的名字。
///
public string SockName { get; set; } = string.Empty;
/// 是否启用(停用就不连、不上报)
public bool Enabled { get; set; } = true;
/// 扫码枪是否静音(现场偏好,暂只记录)
public bool Muted { get; set; }
public long AddedAtMs { get; set; } = DateTimeOffset.Now.ToUnixTimeMilliseconds();
// ---------------- 运行时状态(不落盘) ----------------
/// TCP 连接状态
[System.Text.Json.Serialization.JsonIgnore]
public bool Connected { get; set; }
/// 最近一条条码
[System.Text.Json.Serialization.JsonIgnore]
public string LastCode { get; set; } = string.Empty;
/// 最近条码时间
[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();
/// 上报给服务端的 channelId(用通道号,稳定且短)
[System.Text.Json.Serialization.JsonIgnore]
public string ChannelId => Number.ToString();
}
/// 通道配置读写(普通模式 `%LOCALAPPDATA%\YuncangTrace\channels.json`;服务模式 `%ProgramData%\YuncangTrace\channels.json`)
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,
};
/// 读通道列表(读不到返回空列表,绝不抛)
public static List Load()
{
try
{
if (!File.Exists(FilePath)) return new List();
var list = JsonSerializer.Deserialize>(File.ReadAllText(FilePath), Options)
?? new List();
NormalizeNumbers(list);
MigratePort(list);
return list;
}
catch (Exception ex)
{
AppLog.Write($"[scan] 读取通道配置失败:{ex.Message}");
return new List();
}
}
/// 保存通道列表(只落盘持久字段,运行时状态由 JsonIgnore 排除)
public static void Save(IEnumerable channels)
{
try
{
Directory.CreateDirectory(Dir);
File.WriteAllText(FilePath, JsonSerializer.Serialize(channels.ToList(), Options));
}
catch (Exception ex)
{
AppLog.Write($"[scan] 保存通道配置失败:{ex.Message}");
}
}
/// 老数据/缺号的数据补齐通道号(分配最小空号,删掉的不复用)
private static void NormalizeNumbers(List list)
{
var used = new HashSet(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);
}
}
/// 分配最小的空号
public static int NextNumber(IEnumerable channels)
{
var used = new HashSet(channels.Select(item => item.Number));
var number = 1;
while (used.Contains(number)) number++;
return number;
}
///
/// 旧配置里存的是 8086(早期跟 Android 中控共用的端口)→ 改成桌面端自己的端口。
/// 改了之后设备上还没这条条目,靠「连不上时自愈」自动建。
///
private static void MigratePort(List 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);
}
/// 通道号上限(与原中控一致:现场是工位号,量级几十)
public const int MaxNumber = 50;
/// 某个号是否已被别的通道占用( 用于「改自己」时排除自己)
public static ScanChannel? FindByNumber(IEnumerable channels, int number, string? exceptMac = null)
{
return channels.FirstOrDefault(item => item.Number == number
&& (exceptMac is null || !item.Mac.Equals(exceptMac, StringComparison.OrdinalIgnoreCase)));
}
}
/// 扫码链路用到的常量(与设备固件一致)
public static class ScanProtocol
{
/// UDP 发现 / JCMD 端口(设备监听)
public const int UdpPort = 48899;
///
/// 设备侧 TCP 监听端口(设备当服务端,把串口数据推给连上来的人)。
///
/// ⚠️ 不用 8086:那是 Android 中控(条目 `scancenter`)在用的。同一台设备上
/// 两条连接都往串口写,设置会互相覆盖(Android 那边重连时会把静音顶掉)。
/// 桌面端用**自己的条目名 + 自己的端口**,互不干扰。
///
public const int TcpPort = 8087;
/// 广播报文(`ConnectMode` 必须是 Forbidden:只发现,不改设备服务器配置)
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 命令号
/// 读配置(10003→10004)
public const int CidGetConfig = 10003;
/// 读运行状态(10001→10002):只有它回来的 SOCK 条目才带 `ClientIP`
public const int CidGetState = 10001;
/// 写配置(10005→10006,增量;SOCK 段是整条写)
public const int CidSetConfig = 10005;
/// 把配置落 flash(10017→10018):不落盘的话一次重载就丢(原中控已实测)
public const int CidSaveFlash = 10017;
public const int CidDoRestart = 20003;
/// 桌面端自己的 SOCK 条目名(不能跟 Android 的 `scancenter` 重名)
public const string SockName = "packcenter";
/// 条码合法性(与原中控一致:去空白后 4~64 位,不含控制字符)
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;
}
///
/// 收一个 UDP 包,带**真实超时**。
///
/// ⚠️ `UdpClient.Client.ReceiveTimeout` 只对**同步** `Receive` 生效,
/// `ReceiveAsync` 完全不看它 —— 设备不回应时会一直挂着(自愈/读配置就卡死在那里)。
///
/// 收到返回字节;超时返回 null(调用方据此当“没应答”处理)
public static async Task 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; // 超时
}
}
/// UTF-8 无 BOM 字节(UDP/TCP 报文都用它)
public static byte[] Utf8(string text) => new UTF8Encoding(false).GetBytes(text);
}