借助网络配置,控制Modbus工具的日志显示,避免卡死界面
|
# 码神工具(XCoder)功能清单
> 版本:v1.0 | 日期:2026-11-11
> 对应需求:[需求文档](/NewLife/XCoder/Blob/master/Doc/需求文档.md) | 方案:[架构设计](/NewLife/XCoder/Blob/master/Doc/架构设计.md) | 视觉:[界面设计](/NewLife/XCoder/Blob/master/Doc/界面设计/index.html)
> 状态标记:✅ 已完成 | 🟡 部分完成 | 🔧 规划中 | ⏸ 暂缓/占位 | ❌ 未开始 | ❓ 待确认 | — 不适用
> 初始状态:全部功能点为 ❌(尚未开始实现)。
**拆分规则**:桌面端单进程,不拆前后端;**同一工具在不同平台实现路径不同**时按平台拆分(CAN / USB / 声卡 / IP 设置 / 语音助手 / 安装包);纯托管工具跨平台行为一致,不拆分。
## 拆分决策表
| 需求项 | 原因 | 拆分结果 |
|--------|:----:|---------|
| CAN 调试 | 多平台 | IND-1a Windows(厂商 DLL)/ IND-1b Linux(SocketCAN)/ IND-1c macOS(厂商驱动) |
| USB 设备 | 多平台 | IND-6a Windows(WMI)/ IND-6b Linux(sysfs)/ IND-6c macOS(system_profiler) |
| 声卡测试 | 多平台 | IND-7a Windows(WASAPI/SAPI 栈)/ IND-7b Linux(ALSA/PulseAudio)/ IND-7c macOS(CoreAudio) |
| IP 设置 | 多平台 | IND-8a Windows(netsh)/ IND-8b Linux(nmcli)/ IND-8c macOS(networksetup) |
| 语音助手 | 多平台 | EFF-7a Windows(SAPI)/ EFF-7b Linux(espeak)/ EFF-7c macOS(say) |
| 安装包与分发 | 多平台 | OPS-5 Windows / OPS-6 Linux(含信创 x64/arm64 + LoongArch 新世界)/ OPS-7 macOS |
> 未列出的需求项为单一功能点,跨平台行为一致。
>
> LoongArch 新世界复用 Linux 适配器(SocketCAN / ALSA / sysfs / nmcli / Secret Service / espeak),不新增适配器拆分;打包与验证独立记为 OPS-6/OPS-8。真机不可用或能力缺失时按平台能力矩阵置灰。
---
## APP 桌面外壳
### 父需求:主界面与导航
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| APP-1 | 工作台首页(Hero / 统计 / 快捷入口 / 工具网格) | 前端 | ✅ | ✅ | ✅ | 首页布局与搜索筛选、动态计数均有单测;新增无头 UI 测试验证卡片渲染与搜索过滤 |
| APP-2 | 工具注册表(显式注册 + 平台可用性) | 后端 | ✅ | ✅ | ✅ | 37 个工具已登记且全部可打开(tools/smoke-tools.ps1 冒烟 37/37) |
| APP-3 | 标签工作区(单实例复用、切换、关闭、滚动) | 前端 | ✅ | ✅ | ✅ | 无头 UI 测试验证:打开工具→工作区可见→标签新增→内容填充→重复打开不新增;工具页统一可伸缩布局,窗口最大化时面板与多行输入框跟随放大(无头布局断言覆盖全部工具页);标签右键菜单提供关闭自身/其他/左侧/右侧/全部(越界命令自动禁用、关闭活动标签后回最近标签、全关后回工作台并同步侧栏)与标签↔浮窗互迁,由无头 UI 测试覆盖 |
| APP-4 | 浮动窗口(与标签互迁、记忆几何、置顶) | 前端 | ✅ | ✅ | ✅ | 同一实例保状态;位置与尺寸记忆完成(含越界/极端尺寸校验),10 项单测已跑通 |
| APP-5 | 命令面板(全局快捷键、模糊搜索、最近使用) | 前端 | ✅ | ✅ | ✅ | 快捷键/搜索/回车可用;首页「最近使用」区块与记录持久化完成(8 条上限,9 项单测) |
| APP-7 | 统一状态栏(真实状态、切标签切换数据源) | 前端 | ✅ | ✅ | ✅ | 无头 UI 测试验证:状态栏工具名与打开状态随标签切换;未知工具键不改状态 |
| APP-13 | 外壳空间管理(侧栏折叠 / 工作区顶栏收起 / 专注模式 / 全屏) | 前端 | ✅ | ✅ | ✅ | 侧栏 216↔64 图标轨(Ctrl+B、偏好持久化)、工作区顶栏收起、专注模式(Ctrl+Shift+F,Esc 退出)、F11 全屏;6 项无头 UI 测试 + 2 项偏好单测 |
> 父需求状态:❌
### 父需求:主题、设置与运行环境
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| APP-6 | 主题系统(浅色/深色/跟随系统 + 强调色跟随系统 + 高对比度 + 控制台深色) | 前端 | ✅ | ❌ | ✅ | 令牌已接入,强调色与高对比度由系统设置驱动(运行时覆盖令牌、取消即回落),控制系统标题栏跟随主题并支持运行中切换即时换色;控制台深色待随工具迁移 |
| APP-8 | 设置中心(主题/语言/快捷入口/浮动行为/目录/更新) | 前端 | ✅ | ✅ | ✅ | 主题/11 语言/目录/凭据/在线更新/快捷入口/外壳行为(托盘常驻、浮动置顶)均完成;12 项单测 |
| APP-9 | 单实例 + 托盘常驻 + 全局热键 | 后端 | ✅ | ✅ | ✅ | 命名管道单实例 + 托盘菜单 + 关窗收进托盘 + 左键单击(含双击)托盘图标唤回主窗口 + **全局热键唤醒(Windows 线程级 RegisterHotKey,不子类化窗口)**;热键可配置(默认 Ctrl+Alt+Shift+X),实机实测隐藏后按键可唤回;12 项单测 |
| APP-10 | 多语言(Auto + 11 种,词表机制) | 前端 | ✅ | ✅ | ✅ | 已接入 NewLife.Core `Localization`:Auto 跟随系统为默认 + 11 种显式语言持久化;外壳、设置中心、命令面板、浮动窗口、工具卡片及全部工具窗口/工具页静态文案通过 `{loc:Tr}` 即时切换;1015 条键 × 10 语言,全部语言均已完整翻译(仅 `Modbus TCP`、`ID` 等通用术语保留原文);状态/日志经 `LocalizedTextConverter` + `Translate` 按整串、前缀与动态模板翻译;平台能力、文件选择器、DBC 表头、API 服务发现表头与工具选项一并覆盖;Auto 在模块加载时捕获系统语言并恢复,显式语言同步 CurrentUICulture;语言下拉按当前语言显示名称,设置页重新显示补刷动态文案;`FontUI`/`FontMono` 按语言切换 CJK 字体。17 项多语言单测 + 3 项字体单测 + 13 项 UI 测试 |
| APP-11 | 配置与日志目录、敏感信息加密存储 | 后端 | 🟡 | ✅ | ✅ | 跨平台目录 + 跪敏 + **Windows DPAPI 优先**、其它平台 AES-256 本机绑定(带算法前缀,旧数据兼容);Linux/macOS 的系统钥匙串(Secret Service/Keychain)未接;13 项单测 |
| APP-12 | 在线更新(检查/下载/提示,失败不阻断) | 后端 | ✅ | ✅ | ✅ | 清单解析 + 版本比较 + 下载到缓存 + exe/msi 直接运行安装包 + 打开下载页(14 项单测,含本地 HTTP 实测) |
> 父需求状态:❌
---
## DEV 开发与数据
### 父需求:数据与接口
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| DEV-1 | 数据建模(连接/模型导入、表字段索引、实体与 DDL 生成) | 前端+逻辑 | ✅ | ✅ | ✅ | 窗口可用;SQLite 临时库实测读表结构(表名/字段/主键)与实体代码生成(输出 .cs 含字段属性);3 项集成测试 |
| DEV-2 | 数据同步(源目标、表勾选、字段映射、差异预览、执行) | 前端+逻辑 | ✅ | ✅ | ✅ | SQLite → SQLite 同步实测(表结构与数据);并发现 Sync 为追加写入,界面已提示;3 项集成测试 |
| DEV-3 | SQL 工作台(架构树、编辑执行、结果表格、导出) | 前端+逻辑 | ✅ | ✅ | ✅ | 架构浏览(表/视图下拉自动填 SQL)、带注释查询识别、执行、结果表格与 CSV 导出完成;13 项单测已跑通 |
| DEV-4 | API 调试(RPC 连接、Action、参数、交互日志) | 前端+逻辑 | ✅ | ✅ | ✅ | 本机 Remoting 回环实测调用返回正确(含未知 Action 报错);参数支持 JSON 对象与纯文本;3 项集成 + 校验单测 |
| DEV-5 | API 发现(局域网扫描与接口信息) | 前端+逻辑 | ✅ | ✅ | ✅ | 广播 + 目标 IP(单 IP / CIDR / 范围,多目标去重)探测;表格按原版字段完整展示 Id/Name/LocalIP/MachineName/FileVersion/OS/RemoteIP/Time/Code/Address,列宽可拖拽;选中行展示原始应答;广播应答回落到设备自报地址、同一设备多条应答归并;StarAgent 自动补充编码与服务器;支持停止、复制、导出 CSV 与转入 API 调试;本机 UDP 回环实测(9 项)+ 无头 UI 测试校验全部列与单元格文本 |
| DEV-6 | Redis 管理(库/键浏览、值编辑、命令、危险保护) | 前端+逻辑 | ✅ | ✅ | ✅ | 库/键浏览 + 值保存 + Key 删除 + 原始命令(PING/DBSIZE)+ 测试连接均已接通;本机 Redis(WSL redis-server)真实验证 7 项:PING、写读往返、搜索命中/不命中、删除与重复删除、字段串联 |
> 父需求状态:❌
### 父需求:文本与安全
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| DEV-7 | 正则表达式(匹配/替换/捕获组/右键模板) | 前端+逻辑 | ✅ | ✅ | ✅ | 匹配结果按行表格列出(序号/值/行/索引/长度),选中行自动高亮原文;右侧分组表显示组号/组名/值/成功标记,选中分组再展开多次捕获,捕获行同样联动高亮原文;替换结果写入右侧结果框;2 秒超时;正则框与输入框右键可插入正则模板/测试内容模板(内置 13 个模板,带 # 注释的模板自动启用忽略空白);15 项单测 + 4 项无头 UI 测试 |
| DEV-8 | 加密解密(摘要/编码/RSA/URL 等 34 命令) | 前端+逻辑 | ✅ | ✅ | ✅ | 34 个命令(摘要 8 / 带密钥摘要 4 / 编码 12 / RSA 4 / 实用 6),左侧命令栏 + 搜索过滤 + 原文/密码/结果纵向流水线;原文与密码均支持字符串/HEX/Base64,结果按三种表示分组并可单条回填原文,上下互换自动切换输入格式;25 项单测 + 3 项无头 UI 测试 |
| DEV-9 | 对称加密(AES/DES 等) | 前端+逻辑 | ✅ | ✅ | ✅ | AES-256 / DES,CBC+PKCS7;5 项单测 |
| DEV-10 | MD5 解密(本地优先 + 在线接口) | 前端+逻辑 | ✅ | ✅ | ✅ | 本地常用表 + 在线反查(适配站点新页面结构、带 UA,实测命中 hello world);离线时自动回退;8 项单测 |
| DEV-11 | 文件编码(探测/预览/转换) | 前端+逻辑 | ✅ | ✅ | ✅ | BOM+UTF8/GB18030 探测,转换自动 .bak;6 项单测 |
> 父需求状态:❌
---
## NET 网络与通信
### 父需求:网络与协议调试
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| NET-1 | 网络调试(TCP/UDP 客户端与服务端、HEX 日志) | 前端+逻辑 | ✅ | ✅ | ✅ | 收发链路回环实测(TCP 双向 / UDP / HEX 报文原样到达)+ 报文容错解析;15 项单测与集成测试 |
| NET-2 | 消息调试(协议组装、收发、解析) | 前端+逻辑 | ✅ | ✅ | ✅ | 复用统一报文构建/日志格式,Remoting 回环实测动作调用链路;窗口层未逐步点验 |
| NET-3 | MQTT 客户端(连接、发布/订阅、主题树、日志) | 前端+逻辑 | ✅ | ✅ | ✅ | 本机 Broker 回环实测连接/订阅/发布/断开均正常,主题通配符校验与 QoS 归一化已测;2 项集成 + 15 项校验单测 |
| NET-4 | SSH 工具(终端、命令、密钥/密码、会话) | 前端+逻辑 | ✅ | ✅ | ✅ | 真实主机联调通过(WSL openssh-server + ed25519 密钥):连接、命令输出、stderr 记日志、断开后提示、私钥缺失/地址非法提示共 5 项 |
| NET-5 | Modbus TCP(主站读写、轮询) | 前端+逻辑 | ✅ | ✅ | ✅ | 主站改用自研 MBAP(原 IoT 驱动运行时报 `SessionBase.set_MaxAsync` 缺失);从站接真实服务;新增周期轮询(间隔可调)+ 轮询次数显示;主从回环读写与轮询共 4 项实测 |
| NET-6 | Modbus RTU(串口主站、CRC、报文日志) | 前端+逻辑 | ✅ | ✅ | ✅ | WSL 下用 socat 造虚拟串口对,主站读保持寄存器(FC03)、写单寄存器(FC06)、ViewModel 连接读写均实测通过(3 项);配套 `tools/rtu-pty.sh` 一键造口 |
| NET-7 | 串口调试(枚举、参数、收发、HEX/文本) | 前端+逻辑 | ✅ | ✅ | ✅ | WSL 虚拟串口对实测:对端发数据能收到并记日志、HEX 下发 01 AB CD 字节原样到达、中文文本按 UTF-8 下发、未打开/非法 HEX 有提示(5 项) |
| NET-8 | 网络语音播报(向终端下发播报消息) | 前端+逻辑 | ✅ | ✅ | ✅ | UDP 组播监听 + 自测下发 + devnotify JSON 兼容;本地 TTS 真实合成已验(SAPI 两个音色、导出 WAV 80 KB 且头部正确);累计 16 项单测(含转义/空文本/输出文件参数) |
> 父需求状态:❌
---
## IND 工业与设备
### 父需求:CAN 调试
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| IND-1a | CAN 调试(Windows,厂商 DLL:ZLG/PCAN/ControlCAN) | 适配器 | 🟡 | ✅ | ✅ | 通道抽象 + 发送/接收界面 + 虚拟回环已就绪;ZLG/PCAN DLL 绑定待接(11 项共用单测) |
| IND-1b | CAN 调试(Linux,SocketCAN) | 适配器 | ✅ | ✅ | ✅ | AF_CAN 原始套接字通道落地(自动探测 can*/vcan*、sysfs 读 ifindex、开启自发自收);WSL vcan0 实测收发标准帧与扩展帧、关闭后发送报错(5 项) |
| IND-1c | CAN 调试(macOS,厂商驱动) | 适配器 | 🟡 | ✅ | ✅ | 通道抽象与虚拟回环可用,厂商驱动待接;无驱动时界面显式提示 |
> 父需求状态:❌
### 父需求:总线与 I/O
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| IND-2 | CAN DBC 查看器(DBC 解析、信号解码、J1939) | 前端+逻辑 | ✅ | ✅ | ✅ | Intel/Motorola、有符号与物理值换算;8 项单测 |
| IND-3 | Modbus Master(批量读写、设备模板) | 前端+逻辑 | ✅ | ✅ | ✅ | 单/批量读写(03/04/06/16)+ 4 个设备模板;回环集成测试;12 项单测 |
| IND-4 | Modbus Slave(从站模拟) | 前端+逻辑 | ✅ | ✅ | ✅ | 03/04/06/16 + 异常码,回环集成测试;5 项单测 |
| IND-5 | I/O 控制(Modbus I/O 读写与监控) | 前端+逻辑 | ✅ | ✅ | ✅ | 串口 I/O 窗口已迁移;Modbus TCP 线圈读写服务(01/02/05)+ 7 项单测已跑通 |
> 父需求状态:❌
### 父需求:系统设备
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| IND-6a | USB 设备(Windows,WMI) | 适配器 | ✅ | ✅ | ✅ | 平台诊断页枚举(CIM JSON 解析)+ 旧窗口均可用;实测非空 |
| IND-6b | USB 设备(Linux,sysfs) | 适配器 | ✅ | ✅ | ✅ | sysfs 枚举实现 + 解析单测;平台诊断页可直接看结果 |
| IND-6c | USB 设备(macOS,system_profiler) | 适配器 | ✅ | ✅ | ✅ | system_profiler 枚举 + 解析单测;未在 Mac 真机验证
| IND-7a | 声卡测试(Windows,WASAPI) | 适配器 | ✅ | ✅ | ✅ | 平台诊断页枚举(Win32_SoundDevice)+ 旧窗口录音回放均可用;音频链路统一走 NewLife.Audio(WASAPI 枚举/采集/播放、端点音量与混音格式),NAudio 依赖已移除 |
| IND-7b | 声卡测试(Linux,ALSA/PulseAudio) | 适配器 | ✅ | ✅ | ✅ | arecord 枚举 + 解析单测;录音播放需真实 ALSA 环境
| IND-7c | 声卡测试(macOS,CoreAudio) | 适配器 | ✅ | ✅ | ✅ | system_profiler SPAudioDataType 枚举 + 解析单测;未在 Mac 真机验证 |
| IND-8a | IP 设置(Windows,netsh) | 适配器 | ✅ | ✅ | ✅ | 旧窗口 + 平台诊断页命令生成/执行均可用(netsh 实测) |
| IND-8b | IP 设置(Linux,nmcli) | 适配器 | ✅ | ✅ | ✅ | nmcli 命令生成 + sudo 前缀 + IPv4/掩码校验;执行需真机确认 |
| IND-8c | IP 设置(macOS,networksetup) | 适配器 | ✅ | ✅ | ✅ | networksetup 命令生成 + 计划格式化;授权提示由系统弹窗负责 |
> 父需求状态:❌
---
## EFF 效率工具
### 父需求:图像与目录
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| EFF-1 | 图标水印(批量处理、水印、尺寸/格式转换) | 前端+逻辑 | ✅ | ✅ | ✅ | 单图水印/预览/ICO 生成(已有)+ 目录批量处理(SkiaSharp 缩放·水印·转格式,13 项单测) |
| EFF-2 | 磁盘星图(磁盘墙/树图/大小/数量/类型分布/导出/删除) | 前端+逻辑 | ✅ | ✅ | ✅ | 磁盘墙 + 可下钻树图(按类型着色、1MB 估算态逐步“撑大”、下钻缩放转场);后台并行枚举、单次目录枚举、增量原子聚合、取消与复用;按卷二进制持久缓存(版本号/原子替换,无文件监控),缓存命中直接按真实大小参与布局并在后台复核更新;实心/斜纹/时钟区分已完成、统计中、缓存复核,目录与文件用图标+类型徽标区分;右键删除默认回收站(Windows Shell / macOS 废纸篓 / Linux gio·freedesktop Trash),永久删除二次勾选;CSV 导出沿用原口径;进入目录先实时枚举子项与文件出框架,再套缓存大小,最后并行统计;删除确认后立即关框,状态条忙碌、完成后右下角提示,大目录不阻塞界面;删除进行中仍可继续确认其他条目并按队列依次后台执行,前序删除已带走的目标自动跳过;右侧“最大的文件”支持双击默认打开,右键打开所在目录或复制路径;右侧“可清理”卡片展示回收站与常见临时/缓存目录,有具体路径的项提供打开目录入口,行内操作经二次确认后清空/清理,完成后重算清理项、磁盘可用空间并在目标节点已加载时重扫;另列出 NuGet 包缓存/下载缓存(空间紧张时提示迁移)与 Linux journal 日志、/var/log 轮转归档(只删旧归档);磁盘星图相关单测共 85 项(扫描/缓存/删除/清理/日志归档/布局/分类),UI 测试覆盖磁盘墙、缓存布局、删除/清理确认与命中测试;设计稿 `13-磁盘星图.html` |
> 父需求状态:❌
### 父需求:地理信息
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| EFF-3 | 坐标转换(WGS84/GCJ02/BD09 互转、批量) | 前端+逻辑 | ✅ | ✅ | ✅ | 单点+批量;6 项单测 |
| EFF-4 | GPS 辅助(数据解析、HEX 转浮点、轨迹) | 前端+逻辑 | ✅ | ✅ | ✅ | NMEA(RMC/GGA,含校验和与定位状态)+ HEX↔单精度双向 + 合并坐标 + 轨迹里程;20 项单测 |
| EFF-5 | 地图接口(地理/逆地理编码、路径规划) | 前端+逻辑 | ✅ | ✅ | ✅ | 三服务商调用(高德/百度/腾讯)+ 接口 Key 本机 AES 加密配置(用户 Key 优先,可清除回默认)+ 打码显示;7 项单测 |
> 父需求状态:❌
### 父需求:媒体与设备
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| EFF-6 | 手机备份(adb 备份/整理,风险确认) | 前端+逻辑 | ✅ | ✅ | ✅ | adb 设备检测(解析 devices -l)+ 目录拉取 + 整机 .ab 备份 + 按拍摄时间归类整理(可选的移动模式);缺 adb 时给安装提示;11 项单测 |
| EFF-7a | 语音助手(Windows,SAPI) | 适配器 | ✅ | ✅ | ✅ | PowerShell + SAPI 执行朗读,支持音色/语速/音量与导出 WAV(实测生成 PCM16 单声道 WAV);11 项单测 |
| EFF-7b | 语音助手(Linux,espeak) | 适配器 | ✅ | ✅ | ✅ | espeak 命令构建+转义+执行路径完成;缺依赖时提示安装 espeak-ng |
| EFF-7c | 语音助手(macOS,say) | 适配器 | ✅ | ✅ | ✅ | say 命令构建+音色参数+导出音频执行路径完成 |
| EFF-8 | 梅尔频谱(采集、计算、可视化) | 前端+逻辑 | ✅ | ✅ | ✅ | 纯托管实现(不依赖第三方音频库,三平台一致):RIFF/WAVE 8/16/24/32 位与 float32 解码、基 2 FFT、梅尔滤波器组、对数梅尔谱 + 音量曲线 + CSV 导出;17 项单测 |
> 父需求状态:❌
---
## OPS 平台适配与发布
### 父需求:平台能力层
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| OPS-1 | 平台抽象层(串口/CAN/音频/USB/网络配置/凭据/进程接口 + 能力声明) | 后端 | ✅ | ✅ | ✅ | 能力声明 + CAN 通道抽象 + 设备枚举(USB/声卡/网卡)+ 网卡配置计划;平台诊断页有无头 UI 测试验证能力列表与命令生成(累计 450+ 项单测/集成/UI 测试) |
| OPS-2 | Windows 平台实现 | 后端 | ✅ | ✅ | ✅ | CIM 枚举(USB/声卡/网卡)+ netsh 配置命令实测可用 |
| OPS-3 | Linux 平台实现(x64/arm64,含 LoongArch 新世界复用) | 后端 | 🟡 | ✅ | ✅ | WSL 实测:USB sysfs、网卡 `ip -o -4 addr show`、声卡 arecord 均真实跑通(修复了外部命令在 Linux 拿不到输出的缺陷,此前平台诊断全空);SocketCAN/串口/RTU/Redis/SSH 均已实机验证;仅 nmcli 配置写入与 LoongArch 真机待验收 |
| OPS-4 | macOS 平台实现 | 后端 | ❌ | ❌ | ❌ | XCoderMac 并行维护,不共享代码;可参考其服务实现 |
> 父需求状态:❌
### 父需求:分发与质量
| 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 |
|------|------|:----:|:----:|:----:|:----:|------|
| OPS-5 | Windows 打包(自包含 + 安装包,x64/arm64) | 后端 | 🟡 | ✅ | ✅ | win-x64 自包含 zip 79.3 MB 产物直接启动;**win-arm64 交叉发布构建已验证**(227 MB);安装包(需 Inno Setup)与 arm64 实机运行待补 |
| OPS-6 | Linux 打包(AppImage + deb/rpm,含 UOS/麒麟与 LoongArch 新世界) | 后端 | 🟡 | ✅ | ✅ | linux-x64 自包含 tar.gz 实测(51 MB)+ WSL Xvfb 启动自检通过;新增 `tools/pack-deb.sh`(dpkg-deb,无需 fpm/联网)打成 **41 MB deb**,WSL 内 `dpkg -i` 安装到 /opt/xcoder、`/usr/bin/xcoder` 快捷命令与菜单项就位、安装后启动自检通过;AppImage/rpm 与 loongarch64 待验 |
| OPS-7 | macOS 打包(.app + DMG + 签名公证) | 后端 | 🟡 | 🟡 | ✅ | `tools/pack-macos.sh` 生成 .app + Info.plist + zip,支持 CODESIGN_ID 签名;DMG 与公证待补 |
| OPS-8 | 测试体系(单测 + 无头 UI 冒烟 + QEMU/macOS CI + 真机联调清单) | 后端 | 🟡 | ✅ | ✅ | 单元/集成测试 **541 项** + 无头 UI 18 项 + 冒烟 37/37 + verify.ps1 一键验证;**新增 CI `test-linux` job**(ubuntu:依赖安装 + 单测 + tar.gz/deb 打包自检),与本机 WSL 验证环境一致;QEMU 与 macOS CI 待建 |
> 父需求状态:❌
---
## 统计
### 子功能统计
| 模块 | 标识 | 功能点数 | 实现完成 | 测试通过 | 注释覆盖 | 综合完成率 |
|------|------|:-------:|:--------:|:--------:|:--------:|:---------:|
| 桌面外壳 | APP | 13 | 12 | 13 | 13 | 92% |
| 开发与数据 | DEV | 11 | 11 | 11 | 11 | 100% |
| 网络与通信 | NET | 8 | 8 | 8 | 8 | 100% |
| 工业与设备 | IND | 16 | 14 | 16 | 16 | 88% |
| 效率工具 | EFF | 10 | 10 | 10 | 10 | 100% |
| 平台与发布 | OPS | 8 | 3 | 5 | 6 | 38% |
| **总计** | **6** | **66** | **58** | **66** | **64** | **88%** |
### 父需求完成度
| 父需求 | 子项数 | 已完成 | 状态 | 说明 |
|--------|:-----:|:-----:|:----:|------|
| 主界面与导航 | 7 | 7/7 | ✅ | APP-1/2/3/4/5/7/13 均已实现,并由无头 UI 测试覆盖视图构造、标签与状态栏交互、侧栏折叠与专注模式 |
| 主题、设置与运行环境 | 6 | 6/6 | ✅ | APP-6/8/9/10/11/12 均可用(主题 7 项、设置 12 项、热键 12 项、下载 14 项单测);仅 APP-11 的 Linux/macOS 系统钥匙串未接 |
| 数据与接口 | 6 | 6/6 | ✅ | DEV-1/2/3/4/6 已完成(SQLite 集成实测 + Remoting 回环 + Redis 真实读写);DEV-5 支持目标 IP 点对点探测(UDP 回环实测) |
| 文本与安全 | 5 | 5/5 | ✅ | DEV-7/8/9/11 已完成;DEV-10 本地常用表 + 在线反查均已落地(在线页面结构变更已适配) |
| 网络与协议调试 | 8 | 8/8 | ✅ | NET-1/2/3/4/5/6/7/8 全部完成:收发回环、MQTT Broker 回环、Modbus TCP 主从轮询、虚拟串口 RTU/串口回环、真实 SSH 主机、本地 TTS 真实合成(SAPI 两个音色、导出 WAV 80 KB) |
| CAN 调试 | 3 | 1/3 | 🟡 | 通道抽象/界面/虚拟回环 + Linux SocketCAN(vcan0 实测)已完成;Windows 厂商 DLL 与 macOS 驱动待接 |
| 总线与 I/O | 4 | 4/4 | ✅ | IND-2/3/4/5 全部完成 |
| 系统设备 | 9 | 9/9 | ✅ | USB/声卡/IP 三平台均已实现枚举与配置命令,Windows 实测通过,Linux/macOS 待真机确认 |
| 图像与目录 | 2 | 2/2 | ✅ | EFF-1 图标水印(含目录批量处理)、EFF-2 磁盘星图(含 CSV 导出)均完成 |
| 地理信息 | 3 | 3/3 | ✅ | EFF-3 坐标转换、EFF-4 GPS(NMEA/HEX/轨迹)、EFF-5 地图接口(Key 可配置)均完成 |
| 媒体与设备 | 5 | 4/5 | 🟡 | EFF-6 手机备份(adb 拉取/整机备份/整理)、EFF-7a/b/c 语音助手、EFF-8 梅尔频谱均完成;仅剩真机与 Mac 语音验证 |
| 平台能力层 | 4 | 3/4 | 🟡 | OPS-1 抽象层、OPS-2 Windows、OPS-3 Linux(WSL 实测通)均落地;仅 OPS-4 macOS 待验 |
| 分发与质量 | 4 | 3/4 | 🟡 | OPS-8 单测+无头 UI 测试+冒烟脚本完成;OPS-5/6:win-x64/arm64 交叉构建、linux-x64 tar.gz 与 **deb 包(安装后启动自检通过)** 均已实测;仅 Windows 安装包、AppImage/rpm、DMG 与 loongarch64 待补 |
> 父需求完成度是功能真正可用的唯一指标;M5 退场 WinForms 前,全部父需求必须为 ✅。
---
## 待修复项
> 消费型工单:只放未修条目,修完即删(历史由提交信息与代码注释承载)。四要素 = 是什么问题 / 危害 / 修改方向 / 修改后的遗憾。
| 编号 | 级别 | 是什么问题 | 危害 | 修改方向 | 修改后的遗憾 |
|------|------|-----------|------|---------|-------------|
| IMP-UI-1 | 建议 | 21 个旧 `Views/*Window.axaml` 工具页搬进标签后没有页面标题与说明,只有控件堆叠;新式 `Tools/*View.axaml` 有 `sectionTitle` + 说明段 | 同一外壳里两种页面观感割裂;用户不知当前页该按什么顺序操作 | 逐页迁移到 `Tools/*` 新骨架(标题 → 说明 → 面板 → 状态行),旧窗口文件保留给浮动窗口使用 | 迁移页数多、每页需回归一次;迁移期新旧两套页面并存 |
| IMP-UI-2 | 建议 | `usb`、`audio` 的列表/详情区在无数据时是空白面板,没有空态文案与下一步动作 | 用户分不清「没扫到设备」还是「页面坏了」 | 加空态提示(如“未枚举到设备,点刷新重新扫描”)并在空态里放主操作按钮 | 需要为空态新增文案键,多语言词表再增 10 份 |
| IMP-UI-3 | 建议 | `redis` 的「Key 搜索」、`map` 第二行的 `wgs84` 下拉没有正式标签;`network` 左栏「本地」下拉宽度远小于「远程」输入 | 搜索条件与坐标系的含义要猜;同列控件宽度不一致显得没排过版 | 补语义标签(坐标系统 / 搜索键名),同列控件统一拉伸或统一固定宽度 | 新增 2 个文案键;部分页面需重排一行 |
| IMP-UI-4 | 建议 | `icon` 左栏固定 272px 且无滚动,窗口变矮或字号放大时底部「生成 ICO」被挤出可视区 | 关键操作按钮不可达 | 左栏套 ScrollViewer 或用 `MinHeight` + 自动高度 | 左栏出现滚动条,视觉上略窄 |
| IMP-UI-5 | 建议 | `mel` 主表格与底部日志条都用固定高度,窗口变小时主表格被压到几乎不可见 | 小窗口下无法看频谱 | 主表格改 `*` 行、日志条固定 `MinHeight` | 小窗口时日志区需要滚动查看 |
| IMP-DEV-1 | 建议 | 正则批量文件替换只存在于未接线的旧 `Views/RegexWindow.axaml`,`Tools/Regex` 工具页没有入口 | 用户在正则页找不到批量替换,旧窗口的目录选择与文件过滤能力实际不可达 | 把旧窗口的目录 + 文件过滤 + 批量替换迁入 `Tools/Regex` 工具页,并补预览/备份 | 工具页会多一块批量替换面板,需再增一轮 UI 与文件写入安全验证 |
---
## 收口记录(已决策不处理,只增不删)
> 与「待修复项」(消费型,修完即删)相对:以下为**明确决定暂不处理**的项,附理由与解冻条件;后续扫描不再重复报告。
| 项 | 位置 | 处置与理由 |
|----|------|-----------|
| Linux/macOS 系统钥匙串(APP-11 余项) | `Services/CredentialStore.cs` | 暂不接:Linux 需 Secret Service(D-Bus)、macOS 需 Keychain(Security.framework),均需平台 P/Invoke;Windows 已用 DPAPI,其它平台用 AES-256 本机绑定(已带算法前缀,后续可平滑切换) |
| 无头 UI 测试(窗口级回归) | `Tests/XCoder.App.UiTests` | 已落地:Avalonia 12.1.1 的 `Avalonia.Headless` + 进程内共享会话(不引 xunit v3),覆盖 37 个工具视图构造与外壳标签/状态栏/搜索交互 |
| Inno Setup / linuxdeploy / fpm / 签名公证(OPS-5/6/7 余项) | `tools/` | 环境依赖:本机无对应工具链与证书。**已补** `tools/pack-deb.sh`(dpkg-deb 手打,无需 fpm/联网)并在 WSL 实测安装可用;Inno Setup、AppImage、rpm、DMG 与 loongarch64 仍需工具链到位后实跑 |
| Linux / macOS / LoongArch 真机验证(OPS-3/4、IND-1b/6/7/8) | 平台适配层 | **Linux 已用 WSL 实测**(USB sysfs / ip / arecord / SocketCAN / 串口 / RTU / Redis / SSH);macOS 与 LoongArch 无真机,代码路径与解析单测就绪 |
| 真实硬件联调(CAN 厂商 DLL、Modbus 设备、局域网 API 广播) | IND-1a/1c、NET-5、DEV-5 | 环境依赖:ZLG/PCAN 厂商 DLL 与 macOS 驱动需硬件;Modbus 已用本机从站回环实测,API 发现已支持目标 IP 点对点探测。串口/RTU/Redis/SSH 已在 WSL 真实验证(见上) |
| 实时录音采集(EFF-8 余项) | `ViewModels/MelSpectrumViewModel.cs` | 依赖已具备:声卡链路统一到 NewLife.Audio 后可直接采集;当前仍只做文件导入 → 频谱计算 → CSV 导出,实时采集待排期 |
| 本地语音试听(NET-8)的 Linux/macOS 分支 | `Tools/Voice/SpeechCommandBuilder.cs` | 已验 Windows SAPI 真实合成(导出 WAV);Linux espeak-ng / macOS say 命令已就绪但本机无引擎,属环境依赖 |
---
(完)
|