借助网络配置,控制Modbus工具的日志显示,避免卡死界面
智能大石头 authored at 2021-12-11 22:09:19
16.27 KiB
XCoder
# 码神工具技术栈评估与迁移路线图 > 版本:v1.0 | 日期:2026-11-11 > 关联:[需求文档](/NewLife/XCoder/Blob/master/Doc/需求文档.md) | [功能清单](/NewLife/XCoder/Blob/master/Doc/功能清单.md) | [架构设计](/NewLife/XCoder/Blob/master/Doc/架构设计.md) | [界面布局方案对比](/NewLife/XCoder/Blob/master/Doc/界面布局方案对比.md) --- ## 1. 评估目标与硬约束 | 约束 | 内容 | |------|------| | 平台覆盖 | Windows 10/11(含 Server 2019+)、macOS(arm64 必须,x64 尽量)、主流 Linux 桌面(Ubuntu/Debian LTS、Fedora)、国产信创 Linux(UOS/麒麟 x64/arm64;LoongArch 新世界 ABI 2.0) | | 显示环境 | 非 100% 缩放的高分屏、多显示器混合 DPI、Windows 远程桌面(RDP) | | 硬件能力 | 串口、CAN、Modbus、音频设备、USB、网卡配置、语音合成,目标平台尽量支持(LoongArch 复用 Linux) | | 部署形态 | 离线自包含安装,不能依赖用户预装运行时;信创环境无法联网装组件 | | 团队能力 | 以 C#/.NET 为主,Avalonia/WPF 有实践经验;无前端专职人员 | | 存量资产 | WinForms 30 个工具;Avalonia 26 个窗口 + VM;macOS 外壳与打包脚本 | > LoongArch 旧世界 ABI 1.0 不在 v1 范围;后续按客户需求单独评估。 --- ## 2. 候选方案概览 | 代号 | 方案 | 形态 | |------|------|------| | A | 维持 WinForms | 单平台,MDI | | B | WPF 重写 | 单平台,XAML | | C | **Avalonia 12 单代码库** | 多平台,Skia 渲染 | | D | Uno Platform | 三平台(WinUI XAML + Skia/WASM) | | E | .NET MAUI | Windows/macOS/移动端,**无 Linux 桌面** | | F | Photino / Blazor Hybrid(WebView + 本地后端) | 三平台,HTML 界面 | | G | Tauri + Web 前端 | 三平台,Rust 宿主 | | H | GTK# | Linux 优先 | --- ## 3. 维度矩阵 评分:✅ 满足 / ⚠️ 有条件 / ❌ 不满足。 | 维度 | A WinForms | B WPF | **C Avalonia** | D Uno | E MAUI | F WebView | G Tauri | H GTK# | |------|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:| | 跨平台覆盖(含 UOS/麒麟 arm64、LoongArch 新世界) | ❌ | ❌ | ✅ | ⚠️ | ❌ 无 Linux 桌面 | ⚠️ | ⚠️ | ⚠️ | | 高 DPI / RDP 表现 | ❌ 现存问题 | ⚠️ | ✅ | ✅ | ⚠️ | ✅ | ✅ | ⚠️ | | 硬件原生访问 | ✅ | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ 需桥接 | ⚠️ 需桥接 | ✅ | | 信创 / 离线部署(含 LoongArch 新世界) | ✅(仅 Win) | ⚠️(仅 Win) | ✅ | ⚠️ | ❌ | ⚠️ 依赖系统 WebView | ⚠️ | ⚠️ | | 包体与启动 | ✅ | ✅ | ✅(AOT 可裁剪) | ⚠️ | ❌ | ⚠️ 双进程 | ✅ | ⚠️ | | 复用存量资产 | ✅ 100% | ❌ | ✅ 26 窗口;Mac 外壳可参考 | ⚠️ 需重写 XAML | ❌ | ⚠️ | ⚠️ | ❌ | | 开发效率(团队 C#) | ✅ | ✅ | ✅ | ⚠️ | ⚠️ | ⚠️ 双栈 | ❌ Rust | ⚠️ | | AOT / 单文件 | ⚠️ | ❌ | ✅ | ✅ | ⚠️ | ❌ | ✅ | ⚠️ | | 生态与文档 | ⚠️ 停更 | ✅ | ✅ | ⚠️ | ⚠️ | ✅ | ✅ | ❌ | | 综合结论 | 淘汰 | 淘汰 | **首选** | 备选 | 淘汰 | 备选(局部) | 淘汰 | 淘汰 | > LoongArch 新世界依赖 Loongnix .NET 10 运行时,以及 SkiaSharp 3.119.4 / HarfBuzzSharp 8.3.1.3 的 `linux-loongarch64` 原生库;旧世界 ABI 1.0 另行评估。 **淘汰理由** - **A WinForms**:不解决跨平台,也不解决 RDP 缩放;`AutoScaleMode.Dpi` + 字体度量链在多显示器混合 DPI 下必然出问题。 - **B WPF**:仅 Windows;无 AOT;已有的 WPF 版仍是半成品,迁移等于再走一遍老路。 - **D Uno**:能力强但工具链与调试体验弱于 Avalonia,Linux 侧实际仍走 Skia;学习与踩坑成本高。 - **E MAUI**:不支持 Linux 桌面,直接出局。 - **G Tauri**:宿主是 Rust,团队栈不匹配;开发与调试链路长。 - **H GTK#**:生态与文档薄弱,Windows/macOS 体验一致性差;已有尝试停滞。 --- ## 4. Avalonia 与 WebView 方案深度对比 | 对比项 | C Avalonia 单进程 | F WebView + 本地后端 | |--------|-------------------|----------------------| | 渲染与缩放 | Skia 矢量渲染,逻辑像素布局,DPI 无关;窗口缩放与 RDP 下比重绘稳定 | 浏览器排版天然 DPI 无关,最稳 | | 界面表达力 | XAML 样式可做到卡片/圆角/阴影,复杂富文本与超大表格需自研或第三方 | HTML/CSS 表达力最强,表格、日志、Markdown、图表现成方案多 | | 迭代速度 | 改 XAML 即时预览;但控件样式细节需打磨 | 设计与实现同源,改 CSS 即见效 | | 运行时依赖 | 无外部依赖,自包含单文件(含原生 Skia) | Windows 依赖 WebView2 运行时(Server 2019 需预装);Linux 依赖 WebKitGTK 版本(信创发行版差异大);macOS 依赖系统 WebKit | | 信创 / ARM64 / LoongArch | 官方支持 linux-x64 / linux-arm64 自包含发布;linux-loongarch64(新世界)由 Loongnix .NET 10 + SkiaSharp 3.119.4 原生库支持,需按厂商运行时发布 | WebKitGTK 在 UOS/麒麟 arm64 上版本碎片化,难以保证 | | 硬件访问 | 同进程 P/Invoke,零延迟 | 需后端进程桥接(串口、CAN、文件对话框均跨进程) | | 分发体积 | 约 60~90MB(自包含,可裁剪) | 后端运行时 + 前端资源 + 系统 WebView,总体相近但多一层 | | 进程与调试 | 单进程,断点直达 | 双进程,需同时调试前端与后端 | | 安全面 | 仅本地文件与设备 | 需要本地 HTTP/IPC 端点,存在端口与权限面 | | 与存量资产关系 | 直接复用 26 窗口;Mac 外壳可参考 | 26 窗口作废,工具 UI 全部重写 | | 结论 | **首选** | **不作外壳**;个别重面板(Monaco 编辑器、图表)可作为可选嵌入 | --- ## 5. 结论与推荐 **推荐 C:Avalonia 12 + .NET 10,单一代码库。** 四条理由: 1. **唯一能同时满足信创与多平台离线的方案**:自包含发布不依赖系统 WebView,`linux-x64/arm64/loongarch64`(新世界)、`osx-x64/arm64`、`win-x64/arm64` 全齐。 2. **存量资产可用**:XCoderAv 26 个工具窗口 + VM 直接成为新产品的起点;macOS 打包流程可参考 XCoderMac,但两边不共享代码(XCoderMac 由另一位开发者并行维护);WebView 方案等于把最贵的部分推倒重来。 3. **高 DPI 与 RDP 问题从根上解决**:Skia 以逻辑像素统一渲染,不再依赖 GDI+ 字体度量;窗口缩放、系统缩放变化只触发重排,不糊不串位。 4. **与团队能力匹配**:C#/XAML/MVVM 一条链路,硬件访问同进程,测试可用 Avalonia.Headless 做无头冒烟。 **关于"WebView 更好看"的回应**:本方案的 HTML 原型是**设计稿**,不是产品代码;在 XAML 中通过语义令牌与样式可以达到同等视觉效果(见[设计说明](/NewLife/XCoder/Blob/master/Doc/界面设计/设计说明.md)的令牌↔XAML 映射)。如果将来某个面板(如 SQL 编辑器)确实需要 Monaco,可在该工具内部嵌 WebView,而不把整个外壳押上去。 **推荐版本线**:`net10.0`;Avalonia 12.x;CommunityToolkit.Mvvm 8.x;保留 `IsAotCompatible`,发布阶段评估 NativeAOT(先保证 `PublishTrimmed` + 自包含可用)。LoongArch 新世界使用 Loongnix 提供的 .NET 10 运行时(厂商/社区构建,不是 Microsoft tier-1 官方 RID),发布说明中需明确标注。 ### 5.1 LoongArch 可行性结论 - **新世界 ABI 2.0 可行**:Avalonia 12.1.1 依赖 SkiaSharp 3.119.4 与 HarfBuzzSharp 8.3.1.3,两个 `NativeAssets.Linux` 包均包含 `runtimes/linux-loongarch64/native`;Loongnix 提供 .NET 10.0.14 runtime 与 SDK 10.0.114。 - **旧世界 ABI 1.0 不在 v1 范围**:官方 SkiaSharp 3.119.4 的 LoongArch 原生库为新世界;旧世界需 OnceMi 3.119.0 或自编译,且与 Avalonia 12 的 SkiaSharp 版本存在匹配风险。旧世界客户后续单独评估。 - **信创需求**:已有明确客户/招标要求,目标为新世界 ABI 2.0;具体客户信息不入库,验收以客户实际环境为准。 - **验证资源**:已确认可获取龙芯 3A5000/3A6000 级真机与 Mac 真机;QEMU 用于日常冒烟,真机用于串口/CAN/音频/USB/网卡等硬件验收;未验收的能力按能力矩阵置灰。 - **构建**:优先 x64 交叉发布 + QEMU 冒烟 + 龙芯真机验证;需要 LoongArch SDK 时使用 Loongnix SDK 或真机。官方 x64 SDK 对 `linux-loongarch64` RID 的识别需在 Spike 中确认。 --- ## 6. 硬件能力的跨平台路径 | 能力 | 实现路径 | 说明 | |------|----------|------| | 串口 | `System.IO.Ports` | Linux 检测 `dialout` 组权限并给出修复命令 | | CAN | Windows:厂商 DLL(ControlCAN/ZLG/PCAN,复用 A1Lib 嵌入资源);Linux:SocketCAN(`AF_CAN` + `libsocketcan` 可选);macOS:厂商 mac 驱动 | 统一 `ICanBus`,通道枚举与帧格式归一 | | Modbus | 纯托管(NewLife.Modbus / NewLife.ModbusRTU) | 串口底层走 `ISerialPortService` | | 音频 | 优先 `NewLife.Audio`;不足再落 WASAPI / ALSA / CoreAudio | 梅尔频谱只依赖采集 + FFT(MathNet) | | USB 枚举 | Windows WMI;Linux sysfs;macOS `system_profiler -json` | 只读为主,不涉及驱动安装 | | 网卡配置 | Windows `netsh`;Linux `nmcli`;macOS `networksetup` | 全部走命令封装 + 权限检测 + 回滚 | | 凭据 | Windows DPAPI;Linux Secret Service;macOS Keychain | 参考现有 `MacKeychainSecrets` 实现,不直接共享代码 | | 语音合成 | Windows SAPI;Linux espeak;macOS `say` | 缺失时提示安装命令 | | 摄像头 | 暂缓(DirectShow / V4L2 / AVFoundation 成本高) | 见需求文档暂缓清单 | > LoongArch 新世界复用 Linux 行:串口走 `System.IO.Ports`、CAN 走 SocketCAN、音频走 ALSA/PulseAudio、USB 走 sysfs、网卡走 `nmcli`、凭据走 Secret Service、语音合成走 espeak;真机不可用或能力缺失时按平台能力声明置灰。 --- ## 7. 为什么前三次尝试没成(以及这次的机制) | 根因 | 表现 | 本次对策 | |------|------|----------| | 业务逻辑锁在 Form 里 | 换 UI 就得重写业务 | 工具契约最小化(View + VM + 服务),迁移时先搬逻辑再改壳 | | 每个技术栈各复制一份 | WPF / Avalonia / WinForms 三套并存,互不同步 | 单代码库单工程,旧栈归档 | | 手工菜单列表丢掉了自动发现 | 新工具忘记加菜单 | 显式 `ToolRegistry` 单点注册 + 单测校验数量一致 | | 没有设计系统 | 每个窗口各写样式,间距混乱 | 语义令牌 + 全局样式 + 界面原型先行 | | 没有验收标准 | 界面能开就算完成 | 三维状态 + 每批 UI 冒烟断言 + 真机联调清单 | | 没有长期 owner | 半成品无人收尾 | 里程碑与退场条件写死在路线图 | --- ## 8. 迁移路线图 > 目标:**一次到位**——同一版本发布 Windows / Linux x64+arm64 / LoongArch 新世界 / macOS;发布标准按“平台能力矩阵”执行:纯托管工具全平台一致,硬件类工具按真机验证情况声明可用性,未验证的置灰并说明原因。执行上分批切换,WinForms 全程兜底。 ### M0 设计与方案定稿(本次交付) - 产出:需求文档、功能清单、架构设计、技术栈评估、界面方案对比、HTML 原型与设计说明(当前已完成)。 - DoD:用户确认技术栈、界面风格、路线图三项。 ### M0.5 平台风险 Spike(约 2~3 周,进入 M1 前) - LoongArch 新世界:Loongnix .NET 10 SDK/runtime + Avalonia 12.1.1;龙芯真机跑 Headless/X11 冒烟、deb/rpm 离线安装、串口/CAN/音频/USB/网卡验收,QEMU 作为 CI 补充。 - macOS:Apple Developer Program 账号、GitHub Actions macOS runner、Developer ID 签名 + 公证 + stapling 的 hello-world 流水线;Mac 真机跑串口/CAN/音频/USB/输入法验收。 - DoD:两个 Spike 均跑通;若 LoongArch 失败,回到范围/栈决策,不进入 M1。 ### M1 工程骨架 + 6 个纯托管工具(约 3~4 周) - 工程改造:`XCoderAv` → `XCoder.App`,net10.0,命名空间统一,删除旧导航;接入 MS.DI、日志、配置。 - 外壳:侧栏 / 顶栏 / 工作台首页 / 标签 / 浮动窗口 / 命令面板 / 状态栏 / 主题切换 / 设置中心雏形。 - 工具:正则、加密解密、文件编码、坐标转换、GPS 辅助、磁盘星图(逻辑纯托管、无硬件依赖)。 - DoD:目标平台可运行(Windows / Linux x64+arm64 / LoongArch 新世界 / macOS);标签与浮动迁移保状态;UI 冒烟覆盖 6 个工具与主题切换。 ### M2 工具分批迁移(每批 4~6 个,约 12~16 周) - 批次顺序建议: 1. 网络与协议(网络调试、消息调试、MQTT、SSH、Modbus TCP/RTU、串口、语音播报) 2. 数据与接口(数据建模、SQL 工作台、数据同步、API 调试、API 发现、Redis) 3. 工业与 I/O(CAN DBC、Modbus Master/Slave、I/O 控制) 4. 效率与媒体(图标水印、地图接口、手机备份、语音助手、梅尔频谱) - 每批 DoD:功能对等清单逐项勾选、异常路径验证、危险操作确认与恢复、UI 冒烟断言、功能清单三维更新。 ### M3 硬件平台层(约 6~8 周,可与 M2 并行) - 抽象层 + 目标平台实现:Windows / Linux x64+arm64 / LoongArch 新世界(复用 Linux)/ macOS;覆盖串口、CAN、音频、USB、网卡配置、凭据、语音合成。 - 每平台设备验证清单;真机不可用或能力缺失时按能力矩阵置灰;无可用能力时显式提示;权限修复指引(dialout、Keychain 授权、UAC)。 ### M4 打包与分发(约 4~6 周) - Windows:自包含 + 安装包(x64/arm64),升级与卸载验证。 - Linux:AppImage + deb/rpm(x64/arm64),UOS/麒麟实测;桌面图标与文件关联。 - LoongArch 新世界:deb/rpm + 自带 Loongnix .NET 10 运行时;龙芯真机安装冒烟 + 串口/CAN/音频/USB/网卡验收;QEMU 作为 CI 补充。 - macOS:`.app` + DMG + Developer ID 签名 + 公证;GitHub Actions macOS runner 出包;Mac 真机验收串口/CAN/音频/USB/输入法,能力缺失时按矩阵置灰。 - DoD:目标平台干净环境安装、启动、升级、回退通过;能力矩阵与发布说明一致。 ### M5 退场与收敛(约 2 周) - WinForms 版冻结(只修安全缺陷),最终归档;WPF / GTK# / XCoder40 / XCoderMac 目录归档或删除。 - 全量回归 + 文档回收(需求/清单/架构与代码对齐)+ 发布说明。 **汇总工作量**:单人约 32~42 周(含 M0.5 与 LoongArch 新世界);若需旧世界,预留 36~46 周;龙芯与 Mac 真机已确认可获取,验收按 M0.5/M4 执行;两人全职并行约 5~6 个月可交付 Beta。 --- ## 9. 旧工程处置 | 工程 | 处置 | 时机 | |------|------|------| | `XCoder/`(WinForms) | 保留至 M5,冻结后归档到 `legacy/` | M5 | | `XCoderAv/` | 已改造为 `XCoder.App`(M1 完成) | 已完成 | | `XCoderMac/` | **保留不动**,由另一位开发者继续迭代;工作台外壳与视觉已在 `XCoder.App/Shell` 重新实现,不共享代码 | 长期 | | `CrazyCoder/`(WPF) | 归档到 `legacy/`,不再维护 | M5 | | `XCoderLinux/`(GTK#) | 归档到 `legacy/` | M5 | | `XCoder40/` | 删除(无自有源码) | M5 | | `A1Lib/` / `A2Lib/` | A1Lib 原生资源保留供 Windows 平台层引用;A2Lib 随 WinForms 版归档 | M3/M5 | --- ## 10. 关键风险与观察点 - **M1 改造期回归**:26 个工具窗口改 UserControl 时,先做临时宿主兼容(承载 `Window.Content`),再逐个改造,避免一次性大爆。 - **Avalonia 12 版本稳定性**:锁定版本,升级走单独分支 + 全量 UI 冒烟。 - **信创验证**:尽早拿到 UOS/麒麟 x64 与 arm64 机器;AppImage 自带依赖优先验证。 - **LoongArch 真机验收**:龙芯真机已确认可获取,M0.5/M3 验收串口/CAN/音频/USB/网卡与 deb/rpm 离线安装;QEMU 只做 CI 冒烟,不替代真机。 - **LoongArch 旧世界**:ABI 1.0 与官方 SkiaSharp 3.119.4 不匹配;v1 不承诺,客户要求时单独评估。 - **macOS 真机验收**:CI 负责签名/公证,Mac 真机负责串口/CAN/音频/USB/输入法验收;未验收工具置灰。 - **Apple 账号周期**:组织账号需 D-U-N-S,提前申请,避免阻塞 M4。 - **LoongArch 构建链**:官方 x64 SDK 对 `linux-loongarch64` RID 的识别、运行时注入、离线包大小需在 M0.5 验证。 - **字体与本地化**:11 种语言下按钮/标签长度差异,原型按最长文案留位,实现时禁止省略号外溢。 --- (完)