packServer/desktop/Services/Agent/HikWorkerProtocol.cs
liufumingren 290f29e547 跨公司取流:云端边缘任务通道 + 三级降级
场景:查询机 A 和打包仓库 B 在不同网络,B 没有公网 IP。
B 只能主动出站,所以云端从不反向连它 —— 复用设备出站链路做任务通道。

云端(backend)
- 新增 edge_task 服务:Redis List 做队列、短 TTL 存结果,
  多实例共享,不依赖 sticky session
- POST /api/scanner/tasks/poll:设备长轮询领任务(挂 20 秒,
  有任务立刻返回,没任务 204)
- POST /api/scanner/tasks/:id/result:设备回结果
- POST /api/web/edge/check:查询机问「这段有没有录像」,
  云端按主体选出在线扫码服务 → 下发 check → 等结果(默认 8 秒)
- 不阻塞共享 Redis 连接:任务用短间隔轮询而非 BLPOP
  (egg-redis 是共享连接,阻塞命令会卡住其它请求)

桌面端(desktop)
- AgentHost 新增边缘任务循环:长轮询领任务 → 交 worker 执行 → 回结果,
  与扫码链路完全解耦,异常只退避重试
- worker 新增 check 能力(复用 HikPlaybackService.CheckAsync)
- ApiClient 长轮询单独用不限时客户端(共享 HttpClient 的 15 秒超时会掐断)

三级降级(桌面端校验)
1. 局域网有设备管理服务 → 交给它(共用 NVR 会话池)
2. 没有 → 问云端;云端确认有录像时**隐藏预览、只显示下载**
   (跨网拉流成本高,短片段/下载更合适)
3. 云端也判断不了 → 本机自己校验(仓库内操作员的常规路径)

实测(真实 NVR 192.168.8.241 通道 34)
  设备心跳 → 领任务 → worker 校验 → 回结果 → 网页拿到结论
  端到端 2.17 秒(其中 NVR 拉流约 2 秒)

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

143 lines
5.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.Buffers.Binary;
using System.IO;
using System.Text.Json;
using System.Threading;
using System.Threading.Tasks;
namespace YuncangTrace.LocalService.Services;
/// <summary>
/// 服务主进程 ↔ <c>--hik-worker</c> 子进程的管道协议。
///
/// 为什么单独开子进程跑海康:HCNetSDK 是原生库,**访问越界会直接杀掉进程**
/// (0xC0000005),放主进程里等于把扫码收码/上报一起带走。
/// 隔离后 worker 崩了只需重启它,扫码链路无感。
///
/// 传输格式:<c>[4 字节小端长度][UTF-8 JSON]</c>。
/// 选命名管道而不是本机端口:不占端口、管道断开即知对端已死、ACL 天然限制访问者。
/// </summary>
public sealed record HikWorkerRequest(string Id, string Op, JsonElement? Payload)
{
public static HikWorkerRequest Create(string op, object? payload = null)
{
var element = payload is null
? (JsonElement?)null
: JsonSerializer.SerializeToElement(payload, HikWorkerJson.Options);
return new HikWorkerRequest(Guid.NewGuid().ToString("N"), op, element);
}
}
/// <summary>worker 的响应;<see cref="Data"/> 由调用方按 <see cref="Op"/> 自行反序列化</summary>
public sealed record HikWorkerResponse(string Id, bool Ok, string? Error, JsonElement? Data);
/// <summary>管道消息的读写(长度前缀 + JSON),两端共用</summary>
public static class HikWorkerPipe
{
/// <summary>管道名(服务单实例,固定名即可)</summary>
public const string PipeName = "YuncangTrace.HikWorker";
/// <summary>单条消息上限(流计划带十几个通道也远小于这个值)</summary>
private const int MaxMessageBytes = 8 * 1024 * 1024;
public static async Task WriteAsync<T>(Stream stream, T payload, CancellationToken ct)
{
var json = JsonSerializer.SerializeToUtf8Bytes(payload, HikWorkerJson.Options);
var header = new byte[4];
BinaryPrimitives.WriteInt32LittleEndian(header, json.Length);
await stream.WriteAsync(header, ct).ConfigureAwait(false);
await stream.WriteAsync(json, ct).ConfigureAwait(false);
await stream.FlushAsync(ct).ConfigureAwait(false);
}
/// <summary>读一条消息;对端正常关闭返回 null</summary>
public static async Task<T?> ReadAsync<T>(Stream stream, CancellationToken ct) where T : class
{
var header = new byte[4];
if (!await ReadExactAsync(stream, header, ct).ConfigureAwait(false)) return null;
var length = BinaryPrimitives.ReadInt32LittleEndian(header);
if (length is <= 0 or > MaxMessageBytes)
{
throw new InvalidDataException($"管道消息长度非法:{length}");
}
var buffer = new byte[length];
if (!await ReadExactAsync(stream, buffer, ct).ConfigureAwait(false))
{
throw new EndOfStreamException("管道消息被截断");
}
return JsonSerializer.Deserialize<T>(buffer, HikWorkerJson.Options);
}
private static async Task<bool> ReadExactAsync(Stream stream, byte[] buffer, CancellationToken ct)
{
var offset = 0;
while (offset < buffer.Length)
{
var read = await stream.ReadAsync(buffer.AsMemory(offset), ct).ConfigureAwait(false);
if (read == 0) return offset > 0 ? throw new EndOfStreamException("管道消息被截断") : false;
offset += read;
}
return true;
}
}
/// <summary>统一的序列化选项(两端必须一致,否则时间/枚举会解析出偏差)</summary>
public static class HikWorkerJson
{
public static readonly JsonSerializerOptions Options = new()
{
PropertyNameCaseInsensitive = true,
// 中文警告/错误直接可读,不转 \uXXXX
Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
};
}
/// <summary>worker 支持的操作名(两端共用,避免拼错)</summary>
public static class HikWorkerOps
{
/// <summary>自检:返回 SDK / ffmpeg 是否就绪、录像根目录</summary>
public const string Probe = "probe";
/// <summary>校验某时段有没有录像(真拉一小段)</summary>
public const string Check = "check";
/// <summary>按流计划下载并合并</summary>
public const string Download = "download";
/// <summary>优雅退出</summary>
public const string Shutdown = "shutdown";
}
/// <summary>
/// 局域网发现用的端口(与 17300/17301 同族,但独立进程独立端口)。
///
/// - <see cref="UdpQuery"/>:收桌面端的广播询问(**询问-应答**,不是主动公告);
/// - <see cref="Http"/>:取流健康端点,桌面端用一次 TCP 连接就能判定"是否同 LAN"。
/// </summary>
public static class HikWorkerPorts
{
/// <summary>可用 <c>YUNCANG_EDGE_UDP_PORT</c> 临时覆盖(同机并行跑两个实例测试时用)</summary>
public static int UdpQuery { get; } = Resolve("YUNCANG_EDGE_UDP_PORT", 17310);
/// <summary>可用 <c>YUNCANG_EDGE_HTTP_PORT</c> 临时覆盖</summary>
public static int Http { get; } = Resolve("YUNCANG_EDGE_HTTP_PORT", 17311);
private static int Resolve(string name, int fallback)
{
var raw = Environment.GetEnvironmentVariable(name);
return int.TryParse(raw, out var port) && port is > 0 and < 65536 ? port : fallback;
}
}
/// <summary>局域网询问/应答的报文(两端共用)</summary>
public static class HikWorkerDiscovery
{
public const string QueryType = "edge.query";
public const string ReplyType = "edge.reply";
}