桌面端补上「通道改名」:已添加的通道不用再删了重加
之前通道一旦添加就只能删掉再添加来改名,而删除会让服务器软删该通道、 解绑工作台,还容易把通道号换掉。 - 扫码通道页新增「重命名」按钮(选中一行才可用),弹 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:
parent
fd2ed16033
commit
ed063db9f4
@ -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 台已添加)`)。
|
||||
|
||||
@ -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);
|
||||
|
||||
39
desktop/Views/RenameChannelWindow.xaml
Normal file
39
desktop/Views/RenameChannelWindow.xaml
Normal 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>
|
||||
53
desktop/Views/RenameChannelWindow.xaml.cs
Normal file
53
desktop/Views/RenameChannelWindow.xaml.cs
Normal 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;
|
||||
}
|
||||
@ -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}"
|
||||
|
||||
@ -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;
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user