# CAN 全局应答器 + 硬件调试页多设备并发 — 设计规格

日期：2026-11-09
状态：已与用户逐节确认
关联基线：CAN 模拟器 TCP 服务化 + 统一 `CanDeviceDriver`（已完成，47 单测通过）

## 1. 需求

两个独立特性：
- **特性一（应答器）**：当前"自动响应"仅在"有第二个节点且该节点开了自动响应"时才回复。
  用户需要：客户端单独发一条请求，模拟器就能自动回复，无需第二节点。
- **特性二（多设备并发调试）**：硬件调试页(DeviceDebug)当前单设备单会话，
  用户需要同时在多个 Tab 里调试多个 CAN 设备，各自独立会话与维护租约。

## 2. 已确认决策

| 点 | 结论 |
|---|---|
| 应答器语义 | 总线级开关，把发送帧回显给发送者（回波），无需第二节点 |
| 应答内容 | 回显同帧（相同帧ID+数据），来源标记 `RESPONDER` |
| 应答器开关入口 | 服务窗口每总线一个复选框；并支持命令 `BUS_ECHO:ON/OFF` |
| 与节点自动响应关系 | 二者独立并存，互不触发、互不干扰，用户按需开启 |
| 多设备形态 | DeviceDebug 改为 TabControl，每 Tab 一个 `DeviceDebugTab`，各自独立会话 |
| 一会一设备 | 设备下拉只列未打开设备；已打开则聚焦其 Tab，不重复开会话 |
| 会话生命周期 | 加入→OpenSession(ReadOnly)；关 Tab→CloseSession(经 token 缓存复用正常释放维护租约) |
| 设备范围 | 通用（CAN/电源/PLC 同结构），主场景多个 CAN；复用 `LoadPanel(kind)` |

## 3. 特性一设计：总线级应答器

### 3.1 CanBusSimulator
- 新增 `public bool EchoResponderToSender { get; set; }`（默认 false）。
- `OnNodeFrameSent` 路由末尾：若 `EchoResponderToSender` 且源节点存在，
  复制该帧投递回**源节点自身**（`sourceNode.ReceiveFrame(echoCopy)`，直接调用绕过"不回源"），
  回显帧 `SourceNodeId = "RESPONDER"`，`Timestamp = now`，`FrameId/Data` 同原帧。
- 与现有 `SendAutoResponse`（接收节点回复别人）互不影响：应答器面向"发送者回环"，
  节点自动响应面向"接收者答复"。

### 3.2 命令与 UI
- `CanCommandExecutor` 增加 `BUS_ECHO` 查询：`BUS_ECHO:ON|OFF` 设置 `_bus.EchoResponderToSender`；
  裸 `BUS_ECHO` 查询当前状态，返回 `OK:BUS_ECHO:ON|OFF`。
- 服务窗口 `MainWindow` 每总线节点行/工具区加"应答器"复选框，绑定 `CanBusSimulator.EchoResponderToSender`。
- 传输/驱动层零改动：命令走既有 `QUERY:` 通道（Local 直发 / Broker 经 RPC 到宿主再转 TCP）。

### 3.3 数据流
```
客户端 SEND:0x100:AA → 服务端路由 → (应答器开) 回显帧 EV:RECV:0x100:AA:...:RESPONDER
   → 同一 TCP 连接推送回发送节点 → 客户端 DriverFrameReceived 上屏（来源 RESPONDER）
```
无额外轮询；与节点自动响应同用一路事件模型，不产生重复行（来源不同）。

## 4. 特性二设计：DeviceDebug 多标签多会话

### 4.1 结构
```
DeviceDebug（壳）
 ├─ 顶栏：设备下拉(仅未打开设备) + [加入调试] + [关闭当前页]
 └─ TabControl
     └─ DeviceDebugTab × N（新 UserControl，自带独立会话）
          · 绑定自身 CurrentDeviceId / ConnectionState / SessionState / Reservation / CanEnter|ExitMaintenance
          · panelContainer：LoadPanel(kind)（CAN→CanDebugPanel 壳；PowerSupply；PLC）
          · 自身操作日志
          · 进入/退出维护只作用于本设备会话（sessionId 复用 token，逻辑沿用 DebugSessionManager）
```

### 4.2 会话与租约
- `DebugSessionManager` **不改**：`_activeSessions` 已按 sessionId、`GetActiveSessionByDevice`
  按设备支持多设备并发会话。
- 每 `DeviceDebugTab` 持有一个 sessionId，调用 `OpenSession/RequestMaintenance/ActivateMaintenance/
  CloseSession`，各自资源键为自身 deviceId → 不同设备租约天然独立、无冲突。
- 关闭 Tab 必须 `CloseSession`（正常释放维护租约，杜绝 Token 泄漏型"第二次进维护失败"）。
- 同设备不可能出现两个 Tab（下拉过滤 + 聚焦既有 Tab 拦截）。

### 4.3 迁移与影响面
- `DeviceDebug.xaml`：把现"信息栏+维护按钮+panelContainer+操作日志"整体移入 `DeviceDebugTab`；
  DeviceDebug 顶层改为 顶栏 + TabControl。
- `DeviceDebug.xaml.cs`：拆分——壳负责设备列表/加入/关闭 Tab 路由；
  原单会话状态机方法迁入 `DeviceDebugTab.xaml.cs`（每个 Tab 一个实例）。
- 对外契约（插件入口 `InitFinish`、`ForceRefreshForTest`）保留在壳上，行为不变。
- 现有 CAN 通道事件接收、应答器、Broker 代理均复用，无回退。

## 5. 测试策略
- 单测（应答器）：`SimulatorServerCoreTests` 增例——开 `BUS_ECHO:ON` 后单节点 `SEND` 收到
  来源 `RESPONDER` 的回显；关后无回显；与节点自动响应并存时来源区分正确、无重复帧。
- 单测（命令）：`BUS_ECHO:ON/OFF/查询` 走通 `CanCommandExecutor`；Broker 经 RPC 亦生效。
- DeviceDebug 多会话为 UI 重构，以 MSBuild 编译 + 手动验收覆盖：
  同时开 CAN-001/002/003 三个 Tab，各自进入维护互不阻塞；关闭某 Tab 后其设备可再次进入维护
  （证明租约正确释放）；应答器开启后任一 Tab 单独发帧即收到回显 RX。
- 回归：现有 47 单测保持全绿。

## 6. 构建与约束
- 沿用 VS 完整版 MSBuild 编译 WPF 链路（不加 /p:Platform=x64）；
  服务端核心可用 dotnet。
- 不引入新外部依赖；应答器仅在 CanSimulator 库与执行器内扩展，Broker/驱动层不动。