diff --git a/README.md b/README.md
index bed3dda..ff34a1e 100644
--- a/README.md
+++ b/README.md
@@ -81,7 +81,7 @@ packService/
- [x] **顶栏下载入口(2026-10-29)**:所有页面右上角都有「桌面端 / Android 扫码台」下载按钮(**不看权限**),
版本号读 `/download/version.json` 与 `/download/android_client/version.json`,没发布过安装包时按钮置灰
- [x] **工作台 OSD 字幕(2026-11-01)**:设备服务按工作台把「摄像头名 + 运单号」写进每路摄像头的 OSD
- (= 录像机通道名,录像/回放都带);运单号没变不重写,连续 60 秒没扫到还原成工作台名;
+ (= 录像机通道名,录像/回放都带);运单号没变不重写,连续 60 秒没扫到还原成摄像头名;
配置由 GET /api/scanner/workstations 下发(详见 [desktop/README.md](desktop/README.md) 的「工作台 OSD 字幕」)
- [ ] 扩展:目标地址换成真实打包视频页(现在指向百度占位)—— 在扩展「设置」里改「目标地址模板」即可,需要真实地址
diff --git a/backend/app/controller/device/scan.js b/backend/app/controller/device/scan.js
index 3b025d6..b2ed1eb 100644
--- a/backend/app/controller/device/scan.js
+++ b/backend/app/controller/device/scan.js
@@ -115,7 +115,7 @@ class ScanController extends Controller {
*
* 只返回绑定了本机扫码通道的工作台,每项带 `channels`(本机通道)与 `cameras`
* (摄像头名 / 录像机通道号 / 录像机凭据)。设备端据此把「摄像头名 + 运单号」
- * 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成工作台名称。
+ * 写进对应通道的 OSD(= 录像机通道名),1 分钟没有扫码就还原成摄像头自己的名字。
*/
async workstations() {
const { ctx } = this;
diff --git a/desktop/README.md b/desktop/README.md
index 1f280c8..ecfb8df 100644
--- a/desktop/README.md
+++ b/desktop/README.md
@@ -917,7 +917,7 @@ ffmpeg(RTSP, tcp) → 灰度 rawvideo 帧 → 读帧线程只留最新一帧(
| --- | --- |
| 扫到运单号(扫码枪 / 面单识别,连续重复命中都算「在扫」) | 该工作台**所有摄像头**:`摄像头名 + 空格 + 运单号`(如 `2号线面单 SF1164748936737`) |
| **运单号没变** | **不重写**(连续扫描只续在场计时) |
-| 连续 **60 秒**没有任何命中 | 全部还原成**工作台名称** |
+| 连续 **60 秒**没有任何命中 | 全部还原成**摄像头自己的名字**(摄像头没名字才退回工作台名) |
- 配置来源:`GET /api/scanner/workstations`(设备令牌)——只下发**绑了本机扫码通道**的工作台,
每项带本机通道、全部绑定摄像头(名称 / 录像机通道号 / 录像机凭据);
@@ -930,11 +930,11 @@ ffmpeg(RTSP, tcp) → 灰度 rawvideo 帧 → 读帧线程只留最新一帧(
录像机只是把配置分别转给各摄像头,实测两路并发读改写 20 次全部成功、其余字段零差异),
但**同一通道**必须串行(「读整包 → 改 → 写回」会互相覆盖,批内已按通道去重);
写完一批还有待写的会立刻接着来,不会空等;失败按 5s→10s→20s→40s→60s 退避;
- 配置里被移除的摄像机会先还原一次工作台名再忘掉;
+ 配置里被移除的摄像机会先还原一次摄像头名再忘掉;
- 状态在 `agent-status.json` 的 `Osd`(每路摄像头的当前文本 / 最近写入时间 / 错误,**不含密码**)。
> ⚠️ 改通道名 = 改录像机上的通道名:NVR 本机界面、其他客户端、以及我们「拉取通道」读到的名字都会变。
-> 服务停止时**不主动清 OSD**(下次启动会按配置还原成工作台名);要动态的长文本字幕只能本地 `ffmpeg drawtext`。
+> 服务停止时**不主动清 OSD**(下次启动会按配置还原成摄像头名);要动态的长文本字幕只能本地 `ffmpeg drawtext`。
### 摄像头识别结果 → 记录 + 安卓播报通知
diff --git a/desktop/Services/Scan/OsdText.cs b/desktop/Services/Scan/OsdText.cs
index 441df5d..3b8ecbb 100644
--- a/desktop/Services/Scan/OsdText.cs
+++ b/desktop/Services/Scan/OsdText.cs
@@ -8,7 +8,7 @@ namespace YuncangTrace.LocalService.Services.Scan;
/// OSD 文本拼装(录像机通道名,GBK,最多 字节)。
///
/// 现场要求:扫到运单号后,把「摄像头名 + 空格 + 运单号」写到该工作台所有摄像头的 OSD;
-/// 没扫码时还原成工作台名称。设备只认 GBK 且字段只有 31 字节——
+/// 没扫码时还原成**摄像头自己的名字**。设备只认 GBK 且字段只有 31 字节——
/// **运单号必须完整**(它才是取证要看的),所以超长时先压摄像头名,压完还超才截运单号。
///
internal static class OsdText
diff --git a/desktop/Services/Scan/ScanService.cs b/desktop/Services/Scan/ScanService.cs
index 437589d..1441756 100644
--- a/desktop/Services/Scan/ScanService.cs
+++ b/desktop/Services/Scan/ScanService.cs
@@ -87,7 +87,7 @@ public sealed class ScanService
_device = device;
LabelScan = new LabelScanMonitor(device, (channelId, code, wsType, afterAbsence) =>
ReportCameraScanAsync(channelId, ChannelNameOf(channelId), code, wsType, afterAbsence));
- // 工作台 OSD 字幕:扫码/识别命中 → 写「摄像头名 + 运单号」,1 分钟没扫 → 还原工作台名
+ // 工作台 OSD 字幕:扫码/识别命中 → 写「摄像头名 + 运单号」,1 分钟没扫 → 还原摄像头名
Osd = new WorkstationOsdService(device);
ScanActivity += (channelId, code, at) => Osd.OnScanActivity(channelId, code, at);
// 扫码枪那条路也要按「通道 → 工作台类型」决定记录规则(散单取第一次、团购取最后一次)
diff --git a/desktop/Services/Scan/WorkstationOsdService.cs b/desktop/Services/Scan/WorkstationOsdService.cs
index 7425026..6bccc30 100644
--- a/desktop/Services/Scan/WorkstationOsdService.cs
+++ b/desktop/Services/Scan/WorkstationOsdService.cs
@@ -66,19 +66,19 @@ public sealed class OsdSnapshot
/// 规则(现场约定):
/// 1. 扫到运单号(扫码枪或面单识别,连续重复命中都算)→ 该工作台所有摄像头 OSD = `摄像头名 + 空格 + 运单号`;
/// 2. **运单号没变就不重写**(每次写设备配置要 1~3 秒,还会刷配置区);连续命中只续「在场」计时;
-/// 3. 连续 **60 秒**没有任何命中 → 全部还原成**工作台名称**;
+/// 3. 连续 **60 秒**没有任何命中 → 全部还原成**摄像头自己的名字**(不是工作台名);
/// 4. 配置(工作台/摄像头/通道)由服务端下发,启动拉一次 + 每 1 分钟兜底 + 收到通知立即拉。
///
/// 实现要点:
/// - 设备写入走**后台批量队列**(不堵扫码线程):不同通道**并行**下发(一批最多 4 路),
/// 同一通道保证串行(同一通道的「读整包 → 改 → 写回」会互相覆盖);
/// - 每次写之前重新算目标文本,避免把过期的运单号写上去;
-/// - 写失败按 5s→10s→…→60s 退避,不刷日志;配置里移除的摄像头会**还原一次**工作台名再忘掉;
+/// - 写失败按 5s→10s→…→60s 退避,不刷日志;配置里移除的摄像头会**还原一次**摄像头名再忘掉;
/// - 文本超过 31 字节(GBK)时优先保运单号,压摄像头名(见 )。
///
public sealed class WorkstationOsdService : IDisposable
{
- /// 多久没命中就还原成工作台名称(现场约定 1 分钟)
+ /// 多久没命中就还原成摄像头名(现场约定 1 分钟)
private static readonly TimeSpan IdleReset = TimeSpan.FromMinutes(1);
/// 配置兜底拉取间隔(变更靠服务端通知立即生效)
@@ -143,7 +143,7 @@ public sealed class WorkstationOsdService : IDisposable
}
}
- /// 停止工作线程与定时器(**不主动清 OSD**:下次启动会按配置还原成工作台名)
+ /// 停止工作线程与定时器(**不主动清 OSD**:下次启动会按配置还原成摄像头名)
public void Stop()
{
CancellationTokenSource? cts;
@@ -438,7 +438,7 @@ public sealed class WorkstationOsdService : IDisposable
return TimeSpan.FromSeconds(Math.Min(seconds, 60));
}
- /// 当前该显示什么:有扫码(60 秒内)是「摄像头名 + 运单号」,否则是工作台名称
+ /// 当前该显示什么:有扫码(60 秒内)是「摄像头名 + 运单号」,否则还原成**摄像头名**
private static string DesiredText(WorkstationState workstation, CameraState camera, DateTime now)
{
var active = workstation.LastActivityAt is DateTime at
@@ -447,7 +447,17 @@ public sealed class WorkstationOsdService : IDisposable
return active
? OsdText.Combine(camera.Camera.Name, workstation.LastCode)
- : workstation.WorkstationName;
+ : IdleText(camera.Camera.Name, workstation.WorkstationName);
+ }
+
+ ///
+ /// 空闲/退役时要写回去的文本:**摄像头自己的名字**(现场约定)。
+ /// 摄像头没有名字时才退回工作台名——写空会把通道名清掉,反而更容易看错。
+ ///
+ private static string IdleText(string? cameraName, string? fallback)
+ {
+ var name = OsdText.Combine(cameraName, null);
+ return name.Length > 0 ? name : OsdText.TruncateGbk(fallback, OsdText.MaxBytes);
}
private void Apply(ParsedConfig parsed, string reason)
@@ -489,16 +499,18 @@ public sealed class WorkstationOsdService : IDisposable
}
}
- // 被移除的摄像头:还原成它原来所属工作台的名称(best-effort),然后忘掉
+ // 被移除的摄像头:还原成它自己的名字(best-effort),然后忘掉
foreach (var pair in _cameras)
{
if (nextCameras.ContainsKey(pair.Key)) continue;
var state = pair.Value;
if (string.IsNullOrEmpty(state.LastText)) continue;
- if (string.Equals(state.LastText, state.WorkstationName, StringComparison.Ordinal)) continue;
- _retired.Enqueue(new RetiredWrite(state.Camera, state.WorkstationName));
+ var idle = IdleText(state.Camera.Name, state.WorkstationName);
+ if (string.Equals(state.LastText, idle, StringComparison.Ordinal)) continue;
+
+ _retired.Enqueue(new RetiredWrite(state.Camera, idle));
}
_workstations = nextWorkstations;