[yciu]

变更说明

#84 将固件专用地址和固定服务列表项带入了设备选择、端点解析及来源占用。这个后续 PR 按照维护者的建议，把串口协议与桥接入口分别注册，宿主只处理传输地址和设备能力。

• 新增 IConnectionProvider，由 SerialConnectionProvider 注册串口协议/波特率，BridgeConnectionProvider 注册桥接协议。工厂按顺序延迟创建，失败后释放连接；宿主可注入自己的协议集合。
• 默认注册集中于 NintendoSwitchConnections.cs。保留原生串口 115200 → 9600 → pokeldn 921600 的探测顺序、公开串口接口和原有测试接缝。
• 桥接使用 tcp://主机:端口，不再固定服务地址。串口枚举只返回物理端口；GUI 通过现有 controller_profile 保存显式桥接地址并保留在设备列表中，CLI 同时支持 --port 和 --profiles。
• 通用 ConnectionEndpoint 统一串口路径、主机名大小写、结尾斜杠及 IPv6 等价写法，规范化后的地址共享来源占用锁。占用冲突在打开第二个连接前拒绝。
• Core/GUI 移除固件名称分支和专用提示；离线命令仍按连接能力拒绝。

默认桥接适配器仍实现官方 pokeldn.pad.service JSON 行协议，服务负责 BLE 扫描和连接。其他消息协议需要注册对应适配器；本次没有声称任意 TCP 服务均可兼容，也没有实现操作系统直连 BLE。

地址迁移

#84 的入口	调整后
pokeldn:COM3 / pokeldn:/dev/ttyUSB0	COM3 / /dev/ttyUSB0
pokeldn://service / pokeldn (BLE 服务)	显式配置 tcp://127.0.0.1:47800，Transport = TcpBridge

旧专用地址不再解析。GUI 当前通过配置文件设置桥接端点，自动连接只扫描物理串口。完整用法及协议扩展契约见通用设备连接文档。

关联 Issue

后续于已合并的 #84，回应其中维护者提出的通用串口协议与蓝牙桥接建议。没有单独的提案 Issue；本 PR 保持草稿，供维护者复核具体接口及迁移方式，不将该建议视为对本实现的批准。

基于当前 dev：26538600fce7fa3269744a17e23bb59ce3192ca7。

变更类型

• 功能 / 架构类调整（回应 feat(device): 完善 pokeldn 串口控制并支持 ESP32-S3 服务连接 #84 的维护反馈，具体方案待复核）
• 文档 / 其他

人工审核声明

代码和自动化验证由 Codex 辅助完成，未代替提交者确认逐行人工审核。

• 我已逐行审核本 PR 的全部代码（包括 AI 生成的部分），理解并认可每一处改动
• 我对本 PR 内容负责，它不是全由 Agent 决策产出

自查清单

• Release 构建通过
• dotnet test EasyCon2.slnx -c Release --no-restore 通过
• dotnet format EasyCon2.slnx --verify-no-changes --no-restore 无差异
• 新增 NUnit 回归测试
• 同步连接架构、配置及旧地址迁移文档

验证方式

Windows / .NET SDK 10.0.403，全量 1,904 通过、182 跳过、0 失败，另有 29 项显式测试未选择运行；构建保留现存警告。跳过项主要依赖本机未安装的 C99 编译器、OCR 模型或其他平台环境。

新增 21 项测试，覆盖自定义协议注册、延迟探测与失败释放、桥接不误探测串口、TCP 地址校验、GUI/CLI 配置读写及桥接选择刷新。原有占用锁测试改为通用地址等价形式，服务协议测试改为经默认注册和真实本机 TCP 入口连接模拟服务。设备项目共 65 项全部通过，既有输入映射和 GUI 回归通过。

实机边界：用户确认早期适配构建的 ESP32E 可控制 NS；此次通用化构建尚未实机复测，ESP32-S3 仍待实测。当前固件的休眠唤醒限制仍见 pokeldn 说明。

[ca1e]

整体是个高质量提交，已具有插件化改造能力。代码层面符合"基础通用功能"设计目标，后续可继续完善GUI配置面和插件级适配方案。