using System; using System.Collections.Generic; using System.Linq; using System.Text.Json; using System.Threading; using System.Threading.Tasks; using YuncangTrace.LocalService.Services.Scan; namespace YuncangTrace.LocalService.Services; /// /// 后台扫码服务的运行主体(LocalSystem)。 /// /// 职责: /// 1. 读 %ProgramData%\YuncangTrace\agent.json 里的**长期设备令牌**,跑扫码 TCP 收码 + 上报循环; /// 2. 监视 channels.json(桌面端改通道后自动重连); /// 3. 定时 NTP 校时(LocalSystem 改系统时间不需要 UAC); /// 4. 把运行状态写进 agent-status.json,桌面端只读展示; /// 5. 执行桌面端写进 agent-command.json 的一次性命令(立即上传 / 清空记录 / 立即校时)。 /// /// 与桌面端**完全解耦**:桌面端退出、用户注销都不影响这里。 /// public static class AgentHost { /// 状态写盘保活间隔(内容没变也最多 30 秒写一次) private static readonly TimeSpan StatusKeepAlive = TimeSpan.FromSeconds(30); private sealed class NtpState { public string LastSyncAt { get; set; } = ""; public double OffsetSeconds { get; set; } public double RoundTripMs { get; set; } public DateTime? ServerTime { get; set; } public string? Error { get; set; } } public static async Task RunAsync(CancellationToken ct) { AgentPaths.MachineMode = true; AgentPaths.IsServiceProcess = true; AppLog.Write("[agent] 后台扫码服务启动"); try { while (!ct.IsCancellationRequested) { var config = AgentFiles.LoadConfig(); if (config is null || string.IsNullOrWhiteSpace(config.ServerBaseUrl) || string.IsNullOrWhiteSpace(config.DeviceToken)) { AppLog.Write("[agent] 还没有可用配置(等待桌面端「开启设备服务」写入 agent.json)"); AgentFiles.SaveStatus(new AgentStatus { Running = false, Version = Version, LastError = "没有配置(agent.json 缺失或缺少设备令牌)", }); if (!await DelayAsync(TimeSpan.FromSeconds(3), ct).ConfigureAwait(false)) break; continue; } try { await RunCoreAsync(config, ct).ConfigureAwait(false); } catch (OperationCanceledException) { break; } catch (Exception ex) { AppLog.Write($"[agent] 运行失败:{ex.Message}"); AgentFiles.SaveStatus(new AgentStatus { Running = false, Version = Version, DeviceSn = config.DeviceSn, SubjectId = config.SubjectId, LastError = ex.Message, }); if (!await DelayAsync(TimeSpan.FromSeconds(5), ct).ConfigureAwait(false)) break; } } } finally { AgentFiles.SaveStatus(new AgentStatus { Running = false, Version = Version }); AppLog.Write("[agent] 后台扫码服务停止"); } } private static string Version => typeof(AgentHost).Assembly.GetName().Version?.ToString() ?? "1.0.0"; private static async Task RunCoreAsync(AgentConfig config, CancellationToken ct) { // 用内存里的设置喂给 DeviceService:它只用到 DeviceToken / DeviceSn / SubjectId / Enabled var settings = new AppSettings { ServerBaseUrl = config.ServerBaseUrl, SubjectId = config.SubjectId, DeviceId = config.DeviceId, DeviceSn = config.DeviceSn, DeviceServiceEnabled = true, DeviceToken = config.DeviceToken, NtpEnabled = config.NtpEnabled, NtpServer = config.NtpServer, NtpSyncIntervalMinutes = config.NtpIntervalMinutes, }; var api = new ApiClient(config.ServerBaseUrl); // 服务不需要用户令牌(激活/停用由桌面端做),只用长期设备令牌上报 var session = new Session { ServerBaseUrl = config.ServerBaseUrl }; var device = new DeviceService(api, settings, session); var scan = new ScanService(device); var ntp = new NtpState(); // 令牌以 agent-token.json 为准(服务续期后会更新它),没有才退回 agent.json var storedToken = AgentFiles.LoadToken(); var refreshToken = !string.IsNullOrWhiteSpace(storedToken?.RefreshToken) ? storedToken!.RefreshToken : config.RefreshToken; if (!string.IsNullOrWhiteSpace(storedToken?.DeviceToken)) { settings.DeviceToken = storedToken!.DeviceToken; } var nextRefreshAt = DateTime.MinValue; DateTime? lastTokenRefreshAt = null; string? lastTokenRefreshError = null; var nextHeartbeatAt = DateTime.MinValue; DateTime? lastHeartbeatAt = null; string? lastHeartbeatError = null; var configTime = AgentFiles.FileTime(AgentPaths.ConfigFile); var channelsTime = AgentFiles.FileTime(AgentPaths.ChannelsFile); var nextNtpAt = config.NtpEnabled ? DateTime.UtcNow : DateTime.MaxValue; var lastStatusJson = string.Empty; var lastStatusWriteAt = DateTime.MinValue; try { device.EnsureUploadLoop(); await scan.StartAsync().ConfigureAwait(false); scan.StartDiscovery(); // 常驻发现:设备 DHCP 换 IP 时能自己重连 AppLog.Write($"[agent] 扫码已启动:{scan.Channels.Count} 个通道" + $"(SN {config.DeviceSn},主体 {config.SubjectId})"); while (!ct.IsCancellationRequested) { if (!await DelayAsync(TimeSpan.FromSeconds(1), ct).ConfigureAwait(false)) break; // ① 配置变了(换令牌 / 换服务器 / 改 NTP)→ 外层重建链路 var newConfigTime = AgentFiles.FileTime(AgentPaths.ConfigFile); if (newConfigTime != configTime) { AppLog.Write("[agent] agent.json 已变更,重建扫码链路"); break; } // ② 通道配置变了(桌面端增删/改静音)→ 重新加载并连接 var newChannelsTime = AgentFiles.FileTime(AgentPaths.ChannelsFile); if (newChannelsTime != channelsTime) { channelsTime = newChannelsTime; AppLog.Write("[agent] channels.json 已变更,重新加载通道"); scan.Stop(); await scan.StartAsync().ConfigureAwait(false); scan.StartDiscovery(); // 文件里就是完整通道列表:按全量对账再推一次, // 桌面端那边推送失败(离线/未登录)时也能保证服务器跟着删/加。 scan.RequestChannelSync(replace: true); } // ③ 桌面端的一次性命令 var command = AgentFiles.LoadCommand(); if (command is not null) { AgentFiles.ClearCommand(); // 手动续期(测试/排障):不管剩多少天都立即换一次 if (command.RefreshTokenAt is not null) { var refreshed = await TryRefreshTokenAsync(api, config.DeviceSn, refreshToken) .ConfigureAwait(false); if (refreshed is not null) { settings.DeviceToken = refreshed.Token; refreshToken = refreshed.RefreshToken; AgentFiles.SaveToken(new AgentToken { DeviceToken = refreshed.Token, RefreshToken = refreshed.RefreshToken, ExpiresAt = JwtUtil.Expiry(refreshed.Token), }); lastTokenRefreshAt = DateTime.Now; lastTokenRefreshError = null; nextRefreshAt = DateTime.MinValue; } else { lastTokenRefreshError = "手动续期失败(详见日志)"; } } await ApplyCommandAsync(command, device, scan, config, ntp).ConfigureAwait(false); if (command.ReloadChannelsAt is not null) { channelsTime = AgentFiles.FileTime(AgentPaths.ChannelsFile); } if (command.NtpSyncAt is not null && config.NtpEnabled) { nextNtpAt = DateTime.UtcNow.AddMinutes(Math.Max(config.NtpIntervalMinutes, 5)); } } // ④ 令牌自动续期:访问令牌剩不到 7 天(或已过期)时用刷新令牌换新 if (!string.IsNullOrWhiteSpace(refreshToken) && DateTime.Now >= nextRefreshAt) { var expiresAt = JwtUtil.Expiry(settings.DeviceToken); var needRefresh = expiresAt is null || expiresAt.Value - DateTime.Now < TimeSpan.FromDays(7); if (needRefresh) { var refreshed = await TryRefreshTokenAsync(api, config.DeviceSn, refreshToken) .ConfigureAwait(false); if (refreshed is not null) { settings.DeviceToken = refreshed.Token; refreshToken = refreshed.RefreshToken; AgentFiles.SaveToken(new AgentToken { DeviceToken = refreshed.Token, RefreshToken = refreshed.RefreshToken, ExpiresAt = JwtUtil.Expiry(refreshed.Token), }); lastTokenRefreshAt = DateTime.Now; lastTokenRefreshError = null; nextRefreshAt = DateTime.MinValue; } else { lastTokenRefreshError = "自动续期失败(10 分钟后重试)"; nextRefreshAt = DateTime.Now.AddMinutes(10); // 失败 10 分钟后再试(别每分钟刷日志) } } else { nextRefreshAt = DateTime.Now.AddMinutes(30); // 还没到窗口,半小时后复查 } } // ⑤ 设备心跳:每 60 秒一次,让后端 last_seen_at 反映「后台服务还在」 if (DateTime.UtcNow >= nextHeartbeatAt) { try { await api.HeartbeatAsync(settings.DeviceToken, ct).ConfigureAwait(false); if (lastHeartbeatAt is null) { AppLog.Write("[agent] 设备心跳已开始(每 60 秒)"); } else if (lastHeartbeatError is not null) { AppLog.Write("[agent] 设备心跳已恢复"); } lastHeartbeatAt = DateTime.Now; lastHeartbeatError = null; } catch (OperationCanceledException) { throw; } catch (Exception ex) { // 只在第一次失败时记日志,恢复时再记一行,避免每 30 秒刷屏 if (lastHeartbeatError is null) { AppLog.Write($"[agent] 设备心跳失败:{ex.Message}"); } lastHeartbeatError = ex.Message; // 401 = 令牌过期/被撤销,下一轮让续期逻辑先试一下 if (ex is ApiException { StatusCode: 401 }) { nextRefreshAt = DateTime.MinValue; } } finally { nextHeartbeatAt = DateTime.UtcNow.AddSeconds(60); } } // ⑥ NTP if (config.NtpEnabled && DateTime.UtcNow >= nextNtpAt) { await SyncNtpAsync(config.NtpServer, ntp).ConfigureAwait(false); nextNtpAt = DateTime.UtcNow.AddMinutes(Math.Max(config.NtpIntervalMinutes, 5)); } // ⑦ 状态:内容变化才写,30 秒没变化保活写一次(避免每 2 秒重写文件) { var status = BuildStatus(scan, device, config, ntp); status.TokenExpiresAt = JwtUtil.Expiry(settings.DeviceToken); status.RefreshTokenExpiresAt = AgentFiles.LoadToken()?.RefreshExpiresAt; status.LastTokenRefreshAt = lastTokenRefreshAt; status.LastTokenRefreshError = lastTokenRefreshError; status.LastHeartbeatAt = lastHeartbeatAt; status.LastHeartbeatError = lastHeartbeatError; status.UpdatedAt = default; // 签名忽略时间戳 var signature = JsonSerializer.Serialize(status); if (signature != lastStatusJson || DateTime.UtcNow - lastStatusWriteAt >= StatusKeepAlive) { AgentFiles.SaveStatus(status); lastStatusJson = signature; lastStatusWriteAt = DateTime.UtcNow; SaveDiscovered(scan); } } } } finally { scan.Stop(); device.StopUploadLoop(); AgentFiles.SaveStatus(BuildStatus(scan, device, config, ntp, running: false)); AppLog.Write("[agent] 扫码链路已停止"); } } private static async Task ApplyCommandAsync(AgentCommand command, DeviceService device, ScanService scan, AgentConfig config, NtpState ntp) { if (command.TriggerUploadAt is not null) { AppLog.Write("[agent] 收到命令:立即上传"); device.TriggerUpload(); } if (command.ClearRecordsAt is not null) { var removed = ScanRecordStore.Clear(command.ClearChannelId); AppLog.Write($"[agent] 收到命令:清空扫码记录 {removed} 条" + (string.IsNullOrWhiteSpace(command.ClearChannelId) ? "" : $"(通道 {command.ClearChannelId})")); } if (command.ReloadChannelsAt is not null) { AppLog.Write("[agent] 收到命令:重新加载通道"); scan.Stop(); await scan.StartAsync().ConfigureAwait(false); scan.StartDiscovery(); } if (command.NtpSyncAt is not null) { var server = string.IsNullOrWhiteSpace(command.NtpServer) ? config.NtpServer : command.NtpServer!; AppLog.Write("[agent] 收到命令:立即校时"); await SyncNtpAsync(server, ntp).ConfigureAwait(false); } } private static async Task TryRefreshTokenAsync(ApiClient api, string sn, string refreshToken) { try { var result = await api.RefreshDeviceTokenAsync(sn, refreshToken).ConfigureAwait(false); var expiresAt = JwtUtil.Expiry(result.Token); AppLog.Write($"[agent] 设备令牌已续期(新到期 {expiresAt?.ToString("yyyy-MM-dd HH:mm:ss") ?? "未知"})"); return result; } catch (Exception ex) { AppLog.Write($"[agent] 设备令牌续期失败:{ex.Message}"); return null; } } private static async Task SyncNtpAsync(string server, NtpState state) { try { var result = await ClockSyncService.SyncAsync(server).ConfigureAwait(false); state.LastSyncAt = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"); state.OffsetSeconds = result.Offset.TotalSeconds; state.RoundTripMs = result.RoundTrip.TotalMilliseconds; state.ServerTime = result.ServerTime.LocalDateTime; state.Error = null; AppLog.Write(result.Offset.Duration() < ClockSyncService.MinimumAdjust ? $"[agent] NTP 校时:{server} 偏差 {result.Offset.TotalSeconds:+0.00;-0.00} 秒(在误差范围内,未调整)" : $"[agent] NTP 校时完成:{server} 偏差 {result.Offset.TotalSeconds:+0.00;-0.00} 秒," + $"往返 {result.RoundTrip.TotalMilliseconds:0} ms"); } catch (Exception ex) { state.Error = $"NTP 校时失败:{ex.Message}"; AppLog.Write($"[agent] NTP 校时失败({server}):{ex.Message}"); } } private static AgentStatus BuildStatus(ScanService scan, DeviceService device, AgentConfig config, NtpState ntp, bool running = true) { return new AgentStatus { Running = running && scan.Running, Version = Version, DeviceSn = config.DeviceSn, SubjectId = config.SubjectId, UploadStatus = scan.UploadStatus, ChannelSyncStatus = scan.ChannelSyncStatus, PendingRecords = ScanRecordStore.PendingCount(), Channels = scan.Channels.Select(channel => new AgentChannelStatus { Mac = channel.Mac, Connected = channel.Connected, LastIp = channel.LastIp, LastCode = channel.LastCode, LastCodeAt = channel.LastCodeAt, }).ToList(), LastError = ntp.Error, NtpLastSyncAt = ntp.LastSyncAt, NtpLastOffsetSeconds = ntp.OffsetSeconds, NtpRoundTripMs = ntp.RoundTripMs, NtpServerTime = ntp.ServerTime, }; } private static void SaveDiscovered(ScanService scan) { var devices = scan.DiscoveredDevices .Select(item => new AgentDiscoveredDevice { Mac = item.Mac, Ip = item.Ip, HostName = item.HostName, Model = item.Model, Firmware = item.Version, }) .ToList(); AgentFiles.SaveDiscovered(devices); } private static async Task DelayAsync(TimeSpan delay, CancellationToken ct) { try { await Task.Delay(delay, ct).ConfigureAwait(false); return true; } catch (OperationCanceledException) { return false; } } }