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 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/desktop/Views/RenameChannelWindow.xaml.cs b/desktop/Views/RenameChannelWindow.xaml.cs
new file mode 100644
index 0000000..c4d00a4
--- /dev/null
+++ b/desktop/Views/RenameChannelWindow.xaml.cs
@@ -0,0 +1,53 @@
+using System.Windows;
+using YuncangTrace.LocalService.Services.Scan;
+
+namespace YuncangTrace.LocalService;
+
+///
+/// 「重命名通道」弹窗:只改**名字**(通道号是现场认工位的号,改名不动它)。
+///
+/// 名字既落在本机通道配置里(并同步服务器),也可以顺手写进设备 `SYS.HostName`
+/// —— 与添加通道时的处理一致,写失败不影响本机改名。
+///
+public partial class RenameChannelWindow : Window
+{
+ public RenameChannelWindow(ScanChannel channel)
+ {
+ InitializeComponent();
+
+ var ip = string.IsNullOrWhiteSpace(channel.LastIp) ? "IP 未知" : channel.LastIp;
+ ChannelText.Text = $"通道 {channel.Number} · {channel.Mac} · {ip}";
+ NameBox.Text = channel.DisplayName;
+
+ // 设备 IP 未知就写不进去,别给用户一个必然失败的勾选框
+ WriteDeviceBox.IsEnabled = !string.IsNullOrWhiteSpace(channel.LastIp);
+ WriteDeviceBox.IsChecked = WriteDeviceBox.IsEnabled;
+
+ Loaded += (_, _) =>
+ {
+ NameBox.Focus();
+ NameBox.SelectAll();
+ };
+ }
+
+ /// 用户填的新名字(确定后有值)
+ public string ChannelName { get; private set; } = string.Empty;
+
+ /// 是否同时把名字写进设备
+ public bool WriteToDevice => WriteDeviceBox.IsChecked == true;
+
+ private void Ok_Click(object sender, RoutedEventArgs e)
+ {
+ var name = (NameBox.Text ?? string.Empty).Trim();
+ if (name.Length == 0)
+ {
+ MessageBox.Show(this, "通道名不能为空", "重命名通道", MessageBoxButton.OK, MessageBoxImage.Information);
+ return;
+ }
+
+ ChannelName = name;
+ DialogResult = true;
+ }
+
+ private void Cancel_Click(object sender, RoutedEventArgs e) => DialogResult = false;
+}
diff --git a/desktop/Views/ScanTabView.xaml b/desktop/Views/ScanTabView.xaml
index dfcb388..cb82fe4 100644
--- a/desktop/Views/ScanTabView.xaml
+++ b/desktop/Views/ScanTabView.xaml
@@ -22,6 +22,7 @@
+
重新渲染通道列表(保持选中项)
@@ -359,6 +361,50 @@ public partial class ScanTabView : UserControl
: $"通道 {row.Number}「{row.DisplayName}」已恢复蜂鸣(重新下发设置中)";
}
+ ///
+ /// 重命名已添加的通道。
+ ///
+ /// 以前改名只能「删掉再添加」:服务器上的通道会被软删、工作台绑定被解绑,
+ /// 现场还容易把通道号换掉。这里直接改名并同步(按通道号更新名称),设备名可选一并写入。
+ ///
+ /// 服务模式下真正连设备的是后台服务:本机只落 `channels.json`,
+ /// 服务发现文件变了会自己重新加载并重连(见 `AgentHost`)。
+ ///
+ private async void Rename_Click(object sender, RoutedEventArgs e)
+ {
+ if (ChannelList.SelectedItem is not ChannelRow row) return;
+
+ var dialog = new RenameChannelWindow(row.Source) { Owner = Window.GetWindow(this)! };
+ if (dialog.ShowDialog() != true) return;
+
+ RenameButton.IsEnabled = false;
+ try
+ {
+ var result = await _scan.RenameChannelAsync(
+ row.Source, dialog.ChannelName, dialog.WriteToDevice,
+ stage => Dispatcher.Invoke(() => { ChannelStatusText.Text = stage; }));
+
+ Refresh();
+ ChannelStatusText.Text = result.Message;
+
+ if (!result.Ok)
+ {
+ MessageBox.Show(Window.GetWindow(this)!, result.Message, "重命名通道",
+ MessageBoxButton.OK, MessageBoxImage.Warning);
+ }
+ }
+ catch (Exception ex)
+ {
+ ChannelStatusText.Text = $"重命名失败:{ex.Message}";
+ MessageBox.Show(Window.GetWindow(this)!, $"重命名失败:{ex.Message}", "重命名通道",
+ MessageBoxButton.OK, MessageBoxImage.Error);
+ }
+ finally
+ {
+ UpdateSelectionButtons();
+ }
+ }
+
private void Remove_Click(object sender, RoutedEventArgs e)
{
if (ChannelList.SelectedItem is not ChannelRow row) return;