diff --git a/desktop/README.md b/desktop/README.md index ca6d49c..115df90 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -718,10 +718,11 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command" | 自愈 | `ScanService.HealAsync` | 通道连续 3 次连不上 → 回查设备 SOCK 条目,被删/被改就重建(每台设备 60s 最多一次) | | 收条码 | `Services/Scan/ChannelConnection.cs` | 每条通道一条 **TCP 出向连接**到设备 `:8087`(设备当服务端),按 CR/LF 切行,断线 5s 重连;设备每 ~0.7s 推的 6 字节二进制帧(`04 D0 00 00 FF 2C`)会被忽略,不污染条码行 || 扫码枪设置 | `Services/Scan/ScannerCommands.cs` | 连上后一次写 28 字节:**连续扫描 + 识别间隔 0s + 静音状态**(9+9+10,静音那两条是 10 字节,校验位照抄)。写失败不影响收码。扫码枪自己重启会丢设置,靠“每次重连都下发”自动兜住 | | 静音 | `ScanService.SetMuted` | **只存本地 + 让连接重走一遍**(关 socket → 立即重连 → 整条设置重下发)。不在现有 socket 上补写指令:Android 侧实测“字节发出去了但枪没执行”时无法判断 | +| 改名 | `ScanService.RenameChannelAsync`(通道页「重命名」) | 已添加的通道**直接改名**,不用删了再添加(删除会让服务器软删该通道并解绑工作台、通道号还可能变)。名字落本机 `channels.json` + 普通推送同步服务器(`POST /api/scan/channels` 按 `channelId` 更新 `channelName`),可选同时写设备 `SYS.HostName`(写失败不回滚本机改名)。服务模式下本机只落文件,后台服务发现文件变了会自己重载 | | 串口指令调试 | `Views/ScannerCommandWindow`(通道页「串口指令…」) | 发任意 **HEX 字节**透传给扫码枪,预填四条常用指令(静音/恢复蜂鸣/连续扫描/间隔 0s)。换批枪后指令集不同时现场自己试,不用发版 | | 假死看门狗 | `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/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`(续费)后自动恢复并补传 | @@ -745,11 +746,23 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command" 真机验证(`192.168.9.204`,E10C 1.41.1):`写设备配置 SYS:0` → `保存到 flash:0` → 广播里的 `HostName` 立即变成新名字 → `通道 1(工位 9)已连接 192.168.9.204:8087`。 +### 重命名通道 + +`扫码通道 → 选中一行 → 重命名`:只改**名字**,通道号不动(通道号是现场认工位的号)。 + +- 名字先落本机 `channels.json`,再用**普通推送**同步服务器(`channelId` 不变,服务器按 id 更新 + `channel_name`);不走 `replace` 全量对账,所以不会误删别的通道、也不会解绑工作台; +- 「同时把名称写入设备(`SYS.HostName`)」默认勾选(与添加通道一致),设备 IP 未知时该选项不可用; + 写失败**只提示**,本机改名照样生效(设备名只影响设备面板/其他上位机看到的叫法,不影响收码); +- 名字没变就只按需补写设备名,不白刷一次服务器; +- 服务模式:桌面端只写通道文件,后台服务发现文件时间变了会重新加载并重连 + (日志 `[agent] channels.json 已变更,重新加载通道`)。 + ### 界面 - 主窗口改成页签:**打包查询** / **扫码通道**(后者仅在「设备服务」开启后出现)。 查到条码(协议唤起或通道扫码)时**默认切回「打包查询」页签**并自动查询。 - 扫码通道页:**每个区块的状态与按钮都在各自标题行上**。 - - 「扫码通道」标题行:状态(`扫码服务运行中 · 通道 N 个(在线 M)` + 通道同步状态 + 待上传条数)+ `重连全部` / `静音`(选中行切换,已静音时叫「恢复蜂鸣」)/ `读取设备配置` / `删除通道`; + - 「扫码通道」标题行:状态(`扫码服务运行中 · 通道 N 个(在线 M)` + 通道同步状态 + 待上传条数)+ `重连全部` / `静音`(选中行切换,已静音时叫「恢复蜂鸣」)/ `读取设备配置` / `重命名` / `删除通道`(后三个都要先选中一行); 通道列表有「状态」「静音」两列; **没有「同步通道」按钮** —— 通道增删/启停都会自动上传并回查确认; - 「发现到的设备」标题行:`开始扫描`(**开关**,打开后常驻发现:每 3s 探测、socket 一直收,直到手工停止)+ `添加为通道` + 状态(`正在扫描… 未添加 N 台` / `发现 N 台未添加的设备(另有 M 台已添加)`)。 diff --git a/desktop/Services/Scan/ScanService.cs b/desktop/Services/Scan/ScanService.cs index db71d98..117a3f5 100644 --- a/desktop/Services/Scan/ScanService.cs +++ b/desktop/Services/Scan/ScanService.cs @@ -285,6 +285,54 @@ public sealed class ScanService return new AddChannelResult(channel, true, message, ensure.Kind); } + /// + /// 改已添加通道的名字(不用先删再添加)。 + /// + /// - 本机先落盘并同步服务器:`POST /api/scan/channels` 按 `channelId` 更新 `channelName`, + /// 所以这里用普通推送(**不用** `replace`,改名不涉及删通道); + /// - 为 true 时顺手写设备 `SYS.HostName`(与添加通道一致), + /// 写失败**不回滚**本机改名:设备名只影响设备面板/其他上位机看到的叫法,不影响收码; + /// - 名字没变就不推服务器,只按需补写设备名。 + /// + public async Task RenameChannelAsync(ScanChannel channel, string name, bool writeToDevice, + Action? stage = null, CancellationToken ct = default) + { + var trimmed = (name ?? string.Empty).Trim(); + if (trimmed.Length == 0) return new RenameChannelResult(false, "通道名不能为空"); + + var oldName = channel.DisplayName; + var renamed = !trimmed.Equals((channel.Name ?? string.Empty).Trim(), StringComparison.Ordinal); + + if (renamed) + { + channel.Name = trimmed; + SaveChannels(); + Changed?.Invoke(); + RequestChannelSync(); + AppLog.Write($"[scan] 通道 {channel.Number} 改名:「{oldName}」→「{trimmed}」"); + } + + var note = string.Empty; + if (writeToDevice) + { + if (string.IsNullOrWhiteSpace(channel.LastIp)) + { + note = "(不知道该设备 IP,设备名没写入)"; + } + else + { + stage?.Invoke($"正在把设备名「{trimmed}」写入设备…"); + var ok = await WriteHostNameAsync(channel.LastIp, trimmed, ct).ConfigureAwait(false); + note = ok ? ",并已写入设备" : "(设备名写入失败,不影响收码)"; + } + } + + var message = renamed + ? $"通道 {channel.Number} 已改名:「{oldName}」→「{trimmed}」{note}" + : $"通道 {channel.Number} 名称未变{note}"; + return new RenameChannelResult(true, message); + } + /// 删除通道 public void RemoveChannel(ScanChannel channel) { @@ -670,3 +718,6 @@ public sealed record AddChannelResult( bool Ok, string Message, TcpServerEnsureKind EnsureKind = TcpServerEnsureKind.AlreadyReady); + +/// 改通道名的结果( 是给用户看的一句话) +public sealed record RenameChannelResult(bool Ok, string Message); diff --git a/desktop/Views/RenameChannelWindow.xaml b/desktop/Views/RenameChannelWindow.xaml new file mode 100644 index 0000000..e95d87a --- /dev/null +++ b/desktop/Views/RenameChannelWindow.xaml @@ -0,0 +1,39 @@ + + + + + + + +