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;
}