From b135ef09d4de017cc0cd0acf8244af3b1470439d Mon Sep 17 00:00:00 2001 From: liufumingren Date: Fri, 23 Oct 2026 23:28:21 +0800 Subject: [PATCH] =?UTF-8?q?=E6=89=AB=E7=A0=81=E4=B8=8A=E6=8A=A5=E9=9D=99?= =?UTF-8?q?=E9=BB=98=E7=AA=97=E5=8F=A3=E4=BB=8E=205=20=E5=88=86=E9=92=9F?= =?UTF-8?q?=E6=94=B9=E6=88=90=205=20=E7=A7=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 有积压时上报循环每秒检查一次(空闲仍 30 秒保活),保证「最后一次扫描 + 5 秒」就能上报;时间被刷新则重新计时并再次上报。 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- desktop/README.md | 8 ++++---- desktop/Services/DeviceService.cs | 19 ++++++++++++++----- desktop/Services/Scan/ScanRecordStore.cs | 21 ++++++++++++--------- desktop/Services/Scan/ScanService.cs | 2 +- desktop/Views/ScanRecordsView.xaml.cs | 4 ++-- 5 files changed, 33 insertions(+), 21 deletions(-) diff --git a/desktop/README.md b/desktop/README.md index 115df90..4db3dac 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -723,8 +723,8 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command" | 假死看门狗 | `ScanService.WatchdogLoopAsync` | 每 30s:连接看着在线但 **60s 没字节** → 回查设备侧 `SOCK.ClientIP`(CID 10001 才有)→ 本机 IP 不在里面就强制重连(设备断电重启时 TCP 不发 FIN,`ReadAsync` 会永久挂住) | | IP 变化 | `ScanService.ApplyDiscoveredIps` | 每次发现结果回来就刷新各通道 `LastIp`,变了立即用新地址重连(DHCP 续租后不会卡在旧 IP) || 通道配置 | `Services/Scan/ChannelStore.cs` | `%LOCALAPPDATA%\YuncangTrace\channels.json`(服务模式:`%ProgramData%\YuncangTrace\channels.json`),通道号取最小空号、删除后不复用;**不再有团购/散单字段**(团散在「工作台」区分) | | 编排 | `Services/Scan/ScanService.cs` | 启动→连接**全部**通道(没有启用/停用开关,加了就连);**通道一旦变动(增/删/改名)自动同步到服务器**:`POST /api/scan/channels`(增删带 `replace: true`,全量对账;改名只是更新名称)→ `GET /api/scan/channels` 回查确认 → 缺了就退避重试(1s→30s)直到服务器真的有;**删除通道会让服务器软删该通道并解绑工作台**(`removed` / `unbound`),删到 0 个也会推空列表 | -| 扫码记录 | `Services/Scan/ScanRecordStore.cs` | `%LOCALAPPDATA%\YuncangTrace\scan-records.json`(服务模式:`%ProgramData%\YuncangTrace\scan-records.json`),每个通道最多 5000 条;**先落本地、服务器确认后才标「已上传」**,没确认的一直重试,断网不丢;连续扫描只刷新「最近一次扫到的时间」;**扫到后 5 分钟没再扫到同一个码才上报**,上报的就是最后一次扫描时间;同一运单 24 小时内再次扫到会**重新激活同一条本地记录**(不新增行),下一轮上报覆盖服务器记录 | -| 上报队列 | `Services/DeviceService.cs` | 条码静默满 5 分钟后后台攒批(50 条/批)推 `POST /api/scan/records`,失败不标记、指数退避重发(服务端按 设备+通道+条码+秒 精确去重;**同一运单 24 小时内只保留一条,后上报的新时间会覆盖旧记录的时间与工作台快照**)。**主体过期/停用或令牌失效 → 暂停推送**(保留本地积压、不做无意义重试),暂停期间每 60 秒只发一次心跳;心跳返回 `subject.expired=false`(续费)后自动恢复并补传 | +| 扫码记录 | `Services/Scan/ScanRecordStore.cs` | `%LOCALAPPDATA%\YuncangTrace\scan-records.json`(服务模式:`%ProgramData%\YuncangTrace\scan-records.json`),每个通道最多 5000 条;**先落本地、服务器确认后才标「已上传」**,没确认的一直重试,断网不丢;连续扫描只刷新「最近一次扫到的时间」;**扫到后 5 秒没再扫到同一个码才上报**,上报的就是最后一次扫描时间;同一运单 24 小时内再次扫到会**重新激活同一条本地记录**(不新增行),下一轮上报覆盖服务器记录 | +| 上报队列 | `Services/DeviceService.cs` | 条码静默满 5 秒后后台攒批(50 条/批)推 `POST /api/scan/records`(有积压时上报循环每秒醒一次,空闲 30 秒),失败不标记、指数退避重发(服务端按 设备+通道+条码+秒 精确去重;**同一运单 24 小时内只保留一条,后上报的新时间会覆盖旧记录的时间与工作台快照**)。**主体过期/停用或令牌失效 → 暂停推送**(保留本地积压、不做无意义重试),暂停期间每 60 秒只发一次心跳;心跳返回 `subject.expired=false`(续费)后自动恢复并补传 | ### 添加通道(设备名 + 通道号) @@ -781,8 +781,8 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command" [scan] 扫码服务已启动,通道 1 个 [scan] 通道已同步到服务器并确认:1 个 [scan] 通道 1(模拟扫码枪)已连接 127.0.0.1:8087 -[scan] 通道 1 扫码:TESTCH-BARCODE-9001(5 分钟未再扫到后上报) -(5 分钟后) +[scan] 通道 1 扫码:TESTCH-BARCODE-9001(5 秒未再扫到后上报) +(5 秒后) [scan] 已上报扫码 1 条 ``` 数据库 `scan_records` 里 `channel_id=1`、`device_sn=MINGREN`;工作台可绑定通道 `1/模拟扫码枪`。 diff --git a/desktop/Services/DeviceService.cs b/desktop/Services/DeviceService.cs index 111a2d9..98cba16 100644 --- a/desktop/Services/DeviceService.cs +++ b/desktop/Services/DeviceService.cs @@ -40,6 +40,11 @@ public sealed class DeviceService private const int PauseUnauthorized = 2; private static readonly TimeSpan PauseProbeInterval = TimeSpan.FromSeconds(60); + // 静默窗口只有 5 秒,所以有积压时上报循环每秒醒一次(本地列表扫描,开销可忽略); + // 没积压时 30 秒保活一次,别空转。 + private static readonly TimeSpan UploadBusyInterval = TimeSpan.FromSeconds(1); + private static readonly TimeSpan UploadIdleInterval = TimeSpan.FromSeconds(30); + private readonly object _pauseGate = new(); private int _pauseState = PauseNone; private string _pauseMessage = string.Empty; @@ -250,7 +255,7 @@ public sealed class DeviceService /// ① 先落本地(连续扫描只刷新「最近一次扫描时间」)→ ② 唤醒后台上报循环 → /// ③ 服务器 2xx 确认后才把记录标成已上传,否则按退避重试。 /// - /// **延迟上报**:扫到后 5 分钟没再扫到同一个码才真正上报(见 + /// **延迟上报**:扫到后 5 秒没再扫到同一个码才真正上报(见 /// ),上报的是最后一次扫描时间。 /// /// true = 一次新的扫码事件(连续扫描的重复帧返回 false,界面不用重查) @@ -270,12 +275,12 @@ public sealed class DeviceService { if (ShouldLogTouched(channel, barcode)) { - AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(更新最近扫描时间;5 分钟内不再重复记录)"); + AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(更新最近扫描时间;5 秒内不再重复记录)"); } } else { - AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(5 分钟未再扫到后上报)"); + AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(5 秒未再扫到后上报)"); } if (!Enabled) return true; @@ -340,7 +345,8 @@ public sealed class DeviceService } /// - /// 后台上报循环:有信号或每 30 秒检查一次,把**静默满 5 分钟**的待上传记录攒批推送。 + /// 后台上报循环:有信号、有积压时每秒检查一次(空闲时 30 秒), + /// 把**静默满 5 秒**的待上传记录攒批推送。 /// /// 失败时**不标记**那批记录,等退避(1s→2s→5s→10s→30s 封顶)后重发; /// 服务端按 设备+通道+条码+秒 去重、同一运单 24 小时内覆盖成最新时间, @@ -355,7 +361,10 @@ public sealed class DeviceService { try { - await _uploadSignal.WaitAsync(TimeSpan.FromSeconds(30), ct).ConfigureAwait(false); + // 静默期只有 5 秒:有待上传记录时每秒回来看一次, + // 否则「最后一次扫描 + 5 秒」会被拖到下一次 30 秒保活才上报。 + var wait = ScanRecordStore.PendingCount() > 0 ? UploadBusyInterval : UploadIdleInterval; + await _uploadSignal.WaitAsync(wait, ct).ConfigureAwait(false); } catch (OperationCanceledException) { diff --git a/desktop/Services/Scan/ScanRecordStore.cs b/desktop/Services/Scan/ScanRecordStore.cs index c235744..752da5e 100644 --- a/desktop/Services/Scan/ScanRecordStore.cs +++ b/desktop/Services/Scan/ScanRecordStore.cs @@ -99,11 +99,11 @@ public readonly record struct ScanAddResult(ScanAddKind Kind, ScanRecordItem? It /// - **通道回放**:现场要能翻「这台设备刚才扫了什么」,不能只留一条「最近条码」; /// - **连续扫描去重**:同一个码每 ~80ms 报一次,只刷新「最近一次扫到的时间」, /// 不新增记录(所以「A A A B A」记成 A、B 两条,A 的时间是最后一次扫到的时刻); -/// - **延迟上报**:扫到后 (5 分钟)内没再扫到才进上报队列, +/// - **延迟上报**:扫到后 (5 秒)内没再扫到才进上报队列, /// 上报的是**最后一次**扫描时间。面单一直放在扫码器上时,时间会一直往后刷, /// 直到面单被贴走/拿开,这才是包裹真正离开工作台的时刻; /// - 同一个码在 24 小时内再次扫到时会**复用/重新激活同一条本地记录**(不新增行), -/// 5 分钟静默后重新上报,**服务器侧覆盖**原来那条记录的时间和工作台快照 +/// 5 秒静默后重新上报,**服务器侧覆盖**原来那条记录的时间和工作台快照 /// (不再像旧版本那样「24 小时内重复的不上报」)。 /// /// 全部操作加锁:调用方既有收条码的连接线程,也有界面线程和上报重试线程。 @@ -116,8 +116,11 @@ public static class ScanRecordStore /// /// 延迟上报的静默窗口:扫到后这么久没再扫到同一个码,才允许上报。 /// 连续扫描时每次扫到都会把时间往后推,所以上报的是「最后一次扫描」。 + /// + /// ⚠️ 这个值要和 DeviceService 上报循环的轮询间隔一起看: + /// 静默期只有 5 秒,循环必须更频繁地检查,否则上报会被拖到下一次唤醒。 /// - public static readonly TimeSpan SettleDelay = TimeSpan.FromMinutes(5); + public static readonly TimeSpan SettleDelay = TimeSpan.FromSeconds(5); /// /// 同一运单在本地复用同一条记录的窗口(与后端的合并窗口一致:24 小时)。 @@ -227,7 +230,7 @@ public static class ScanRecordStore /// 返回 (界面不用重查,避免刷屏); /// - 同一个码还有一条没上报的记录(例如 A B A)→ 刷新那条的时间,返回 ; /// - 同一个码 24 小时内**已经上报过**、现在又被扫到(扫码枪范围大 / 两个面单轮流被扫)→ - /// **重新激活原来那条**(不新增行),静默 5 分钟后再上报覆盖服务器记录; + /// **重新激活原来那条**(不新增行),静默 5 秒后再上报覆盖服务器记录; /// - 其它情况新建一条记录。 /// public static ScanAddResult Add(string channelId, string channelName, string code, DateTime scannedAt) @@ -282,7 +285,7 @@ public static class ScanRecordStore else { // 已经上报过的同一条码(24 小时内)→ 重新激活原来那条, - // 静默 5 分钟后再上报,后端会覆盖成最新扫描时间 + 工作台快照。 + // 静默 5 秒后再上报,后端会覆盖成最新扫描时间 + 工作台快照。 var uploaded = _items .Where(item => item.ChannelId.Equals(key, StringComparison.OrdinalIgnoreCase) && item.Code.Equals(text, StringComparison.Ordinal) @@ -349,7 +352,7 @@ public static class ScanRecordStore /// /// 扫码枪范围太大时,两个面单会轮流被扫:A 刚上报完、过一会儿又被扫到。 /// 这时不新增本地行,而是把原来那条改回「待上传」并刷新时间, - /// 静默 5 分钟后再上报 —— 后端会把同一条记录覆盖成最新扫描时间。 + /// 静默 5 秒后再上报 —— 后端会把同一条记录覆盖成最新扫描时间。 /// private static void Reopen(ScanRecordItem item, DateTime scannedAt, string channelName) { @@ -364,7 +367,7 @@ public static class ScanRecordStore /// /// 可以上报的一批(按写入顺序,头进头出)。 /// - /// **默认只返回静默满 (5 分钟)的记录**:扫到后 5 分钟内又扫到同一个码, + /// **默认只返回静默满 (5 秒)的记录**:扫到后 5 秒内又扫到同一个码, /// 会被刷新,这条就继续等,不会提前上报。 /// public static List Pending(int limit) => Pending(limit, SettleDelay); @@ -394,7 +397,7 @@ public static class ScanRecordStore } } - /// 已经静默满 5 分钟、可以真正上报的条数 + /// 已经静默满 5 秒、可以真正上报的条数 public static int ReadyCount() { var cutoff = DateTime.Now - SettleDelay; @@ -464,7 +467,7 @@ public static class ScanRecordStore } } - /// 总条数 / 待上传条数(界面统计用;含还在 5 分钟静默期的记录) + /// 总条数 / 待上传条数(界面统计用;含还在 5 秒静默期的记录) public static (int Total, int Pending) Stats() { lock (Gate) diff --git a/desktop/Services/Scan/ScanService.cs b/desktop/Services/Scan/ScanService.cs index 117a3f5..0b7f410 100644 --- a/desktop/Services/Scan/ScanService.cs +++ b/desktop/Services/Scan/ScanService.cs @@ -701,7 +701,7 @@ public sealed class ScanService /// - 记录库只把「最近扫描时间」刷到最新,不新增记录; /// - 这里只在**新扫码事件**(换了条码 / 已上报过的码又扫到)时通知界面, /// 否则订阅者会被连续扫描刷屏。订阅者**只能做展示**,不能据此发起运单查询。 - /// 真正的上报在扫到后 5 分钟没再扫到同一个码时才做(时间取最后一次扫描)。 + /// 真正的上报在扫到后 5 秒没再扫到同一个码时才做(时间取最后一次扫描)。 /// private void OnBarcode(ScanChannel channel, string code) { diff --git a/desktop/Views/ScanRecordsView.xaml.cs b/desktop/Views/ScanRecordsView.xaml.cs index da71bd1..438c9e4 100644 --- a/desktop/Views/ScanRecordsView.xaml.cs +++ b/desktop/Views/ScanRecordsView.xaml.cs @@ -154,7 +154,7 @@ public partial class ScanRecordsView : UserControl var (allTotal, pending) = ScanRecordStore.Stats(); var ready = ScanRecordStore.ReadyCount(); var status = $"{scope}:共 {total} 条 · 全部 {allTotal} 条 · 待上传 {pending} 条"; - if (pending > ready) status += $"({pending - ready} 条静默中,满 5 分钟自动上报)"; + if (pending > ready) status += $"({pending - ready} 条静默中,满 5 秒自动上报)"; if (IsAgentMode) { @@ -244,7 +244,7 @@ public partial class ScanRecordsView : UserControl if (ScanRecordStore.ReadyCount() == 0) { - StatusText.Text = "记录还在 5 分钟静默期(等最后一次扫描后再上报),稍后会自动上传"; + StatusText.Text = "记录还在 5 秒静默期(等最后一次扫描后再上报),稍后会自动上传"; return; }