liufumingren 46e4f12802 desktop: 取流子进程隔离 + 局域网询问应答 + 跨网下载
把海康取流从扫码服务主进程拆到 --hik-worker 子进程,原生 SDK 崩溃
不再连带扫码收码;新增局域网询问-应答与跨网下载通道。

隔离与守护
- 新增 HikWorker(子进程):独占 HCNetSDK 与 NVR 会话池
- 新增 HikWorkerSupervisor(主进程):懒启动、管道通信、
  5 分钟内失败 3 次熔断 10 分钟
- 管道协议为 [4 字节长度][JSON],进程退出即知,不占端口
- ServiceInstaller 复制 native(HCNetSDK/ffmpeg),先删后拷,
  避免 SDK 升级残留旧 DLL;安装时放行 TCP 17311 / UDP 17310

局域网询问-应答(不是主动公告)
- UDP 17310 收询问,只回同 subjectId;带了 nvrHosts 时先实测可达,
  连不上就不应答,让查询机继续走本机
- 应答带 TCP 17311,查询机一次连接即可判定是否同 LAN

跨网下载
- TCP 17311 提供 /health、/probe、/download、/download/{id}
- 除 /health 外均要求 X-Edge-Subject 且与配置主体一致
- 成片在传输完成后立即删除,另有 done 10 分钟 / failed 15 分钟
  TTL 兜底,避免现场磁盘被临时文件吃满

桌面端选路
- DownloadAsync 先探 NVR 8000(600ms):通则沿用原有本机直连,
  不通才广播找取流服务,取回后落到本机录像目录
- DownloadByPlanAsync 拆分:不查库、不需要用户令牌,
  供只有设备令牌的服务端复用

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 22:48:09 +08:00

282 lines
9.6 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;
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();
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; }
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 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;
using var stream = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
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)
{
try
{
var dir = Path.GetDirectoryName(path);
if (!string.IsNullOrEmpty(dir)) Directory.CreateDirectory(dir);
var temp = path + ".tmp";
File.WriteAllText(temp, JsonSerializer.Serialize(value, Options));
File.Move(temp, path, overwrite: true);
}
catch (Exception ex)
{
AppLog.Write($"[agent] 写文件失败({path}):{ex.Message}");
}
}
}