桌面端补上「通道改名」:已添加的通道不用再删了重加

之前通道一旦添加就只能删掉再添加来改名,而删除会让服务器软删该通道、
解绑工作台,还容易把通道号换掉。

- 扫码通道页新增「重命名」按钮(选中一行才可用),弹 RenameChannelWindow:
  只改名字、通道号不动
- ScanService.RenameChannelAsync:名字落本机 channels.json 后用普通推送同步服务器
  (POST /api/scan/channels 按 channelId 更新 channelName,不走 replace 全量对账);
  名字没变就不推服务器
- 可选「同时把名称写入设备」(SYS.HostName,默认勾选,设备 IP 未知时禁用):
  与添加通道一致,写失败只提示、不回滚本机改名
- 服务模式下本机只写通道文件,后台服务发现文件变化会自己重载并重连
- 删除通道按钮同样改成「选中才可用」,避免点了没反应

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-10-23 21:39:28 +08:00
parent fd2ed16033
commit ed063db9f4
6 changed files with 205 additions and 2 deletions

View File

@ -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 台已添加)`)。

View File

@ -285,6 +285,54 @@ public sealed class ScanService
return new AddChannelResult(channel, true, message, ensure.Kind);
}
/// <summary>
/// 改已添加通道的名字(不用先删再添加)。
///
/// - 本机先落盘并同步服务器:`POST /api/scan/channels` 按 `channelId` 更新 `channelName`,
/// 所以这里用普通推送(**不用** `replace`,改名不涉及删通道);
/// - <paramref name="writeToDevice"/> 为 true 时顺手写设备 `SYS.HostName`(与添加通道一致),
/// 写失败**不回滚**本机改名:设备名只影响设备面板/其他上位机看到的叫法,不影响收码;
/// - 名字没变就不推服务器,只按需补写设备名。
/// </summary>
public async Task<RenameChannelResult> RenameChannelAsync(ScanChannel channel, string name, bool writeToDevice,
Action<string>? 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);
}
/// <summary>删除通道</summary>
public void RemoveChannel(ScanChannel channel)
{
@ -670,3 +718,6 @@ public sealed record AddChannelResult(
bool Ok,
string Message,
TcpServerEnsureKind EnsureKind = TcpServerEnsureKind.AlreadyReady);
/// <summary>改通道名的结果(<see cref="Message"/> 是给用户看的一句话)</summary>
public sealed record RenameChannelResult(bool Ok, string Message);

View File

@ -0,0 +1,39 @@
<Window x:Class="YuncangTrace.LocalService.RenameChannelWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="重命名通道"
Height="380" Width="460"
ResizeMode="NoResize"
WindowStartupLocation="CenterOwner"
Background="{StaticResource BgBrush}"
FontFamily="Microsoft YaHei UI, Segoe UI"
FontSize="13">
<Border Background="White" BorderBrush="{StaticResource LineBrush}" BorderThickness="1"
CornerRadius="10" Margin="18" Padding="18">
<DockPanel>
<TextBlock DockPanel.Dock="Top" Text="重命名扫码通道" FontSize="15" FontWeight="SemiBold" />
<TextBlock x:Name="ChannelText" DockPanel.Dock="Top" FontSize="12"
Foreground="{StaticResource MutedBrush}" Margin="0,4,0,12" TextWrapping="Wrap" />
<StackPanel DockPanel.Dock="Bottom" Orientation="Horizontal" HorizontalAlignment="Right" Margin="0,14,0,0">
<Button Content="取消" Padding="14,5" IsCancel="True" Click="Cancel_Click" />
<Button x:Name="OkButton" Content="保存" Padding="14,5" Margin="8,0,0,0" IsDefault="True"
Background="{StaticResource BrandBrush}" Foreground="White" BorderThickness="0"
Cursor="Hand" Click="Ok_Click" />
</StackPanel>
<StackPanel>
<TextBlock Text="通道名" FontWeight="SemiBold" Margin="0,0,0,4" />
<TextBox x:Name="NameBox" Height="28" Padding="6,3" VerticalContentAlignment="Center"
MaxLength="32" />
<TextBlock Text="只改名字,通道号不动;服务器会按通道号更新名称(工作台里看到的也是新名字)"
FontSize="12" Foreground="{StaticResource MutedBrush}" Margin="0,4,0,14" TextWrapping="Wrap" />
<CheckBox x:Name="WriteDeviceBox" Content="同时把名称写入设备(SYS.HostName)" IsChecked="True"
VerticalContentAlignment="Center" />
<TextBlock Text="与添加通道时一致:写进设备后,设备面板和其他上位机看到的也是这个名字;写失败不影响本机改名"
FontSize="12" Foreground="{StaticResource MutedBrush}" Margin="0,4,0,0" TextWrapping="Wrap" />
</StackPanel>
</DockPanel>
</Border>
</Window>

View File

@ -0,0 +1,53 @@
using System.Windows;
using YuncangTrace.LocalService.Services.Scan;
namespace YuncangTrace.LocalService;
/// <summary>
/// 「重命名通道」弹窗:只改**名字**(通道号是现场认工位的号,改名不动它)。
///
/// 名字既落在本机通道配置里(并同步服务器),也可以顺手写进设备 `SYS.HostName`
/// —— 与添加通道时的处理一致,写失败不影响本机改名。
/// </summary>
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();
};
}
/// <summary>用户填的新名字(确定后有值)</summary>
public string ChannelName { get; private set; } = string.Empty;
/// <summary>是否同时把名字写进设备</summary>
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;
}

View File

@ -22,6 +22,7 @@
<Button x:Name="MuteButton" Content="静音" Padding="10,3" Margin="8,0,0,0" Click="Mute_Click" />
<Button x:Name="ConfigButton" Content="读取设备配置" Padding="10,3" Margin="8,0,0,0" Click="ReadConfig_Click" />
<Button x:Name="RawCommandButton" Content="串口指令…" Padding="10,3" Margin="8,0,0,0" Click="RawCommand_Click" />
<Button x:Name="RenameButton" Content="重命名" Padding="10,3" Margin="8,0,0,0" Click="Rename_Click" />
<Button x:Name="RemoveButton" Content="删除通道" Padding="10,3" Margin="8,0,0,0" Click="Remove_Click" />
</StackPanel>
<TextBlock x:Name="ChannelStatusText" DockPanel.Dock="Right" Foreground="{StaticResource MutedBrush}"

View File

@ -146,6 +146,8 @@ public partial class ScanTabView : UserControl
var current = ChannelList.SelectedItem as ChannelRow;
MuteButton.Content = current is not null && current.Source.Muted ? "恢复蜂鸣" : "静音";
MuteButton.IsEnabled = current is not null;
RenameButton.IsEnabled = current is not null;
RemoveButton.IsEnabled = current is not null;
}
/// <summary>重新渲染通道列表(保持选中项)</summary>
@ -359,6 +361,50 @@ public partial class ScanTabView : UserControl
: $"通道 {row.Number}「{row.DisplayName}」已恢复蜂鸣(重新下发设置中)";
}
/// <summary>
/// 重命名已添加的通道。
///
/// 以前改名只能「删掉再添加」:服务器上的通道会被软删、工作台绑定被解绑,
/// 现场还容易把通道号换掉。这里直接改名并同步(按通道号更新名称),设备名可选一并写入。
///
/// 服务模式下真正连设备的是后台服务:本机只落 `channels.json`,
/// 服务发现文件变了会自己重新加载并重连(见 `AgentHost`)。
/// </summary>
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;