内容
# NexusLinkStudio
面向通信调试、协议验证、自动化测试与 AI 辅助联调的桌面工作台。
[](https://github.com/RRQM/NexusLinkStudio)
[](https://github.com/RRQM/NexusLinkStudio)
[](https://github.com/RRQM/NexusLinkStudio)
[](https://dotnet.microsoft.com/)
[](https://avaloniaui.net/)
[](https://touchsocket.net/)
[](https://qm.qq.com/q/QYRKIcHqkq)
[GitHub](https://github.com/RRQM/NexusLinkStudio) · [Gitee](https://gitee.com/RRQM_Home/NexusLinkStudio)
NexusLinkStudio 不是一个只负责“打开端口、发送文本、看看回包”的传统调试助手。它更像一个可以长时间陪在开发现场的通信实验室:支持 TCP、UDP、串口、命名管道、MQTT、HTTP、Modbus 等常见通信场景,内置消息录制、回放、筛选、预设消息、自动回复、变量管理、数据适配器、通信流程图、MCP 服务等能力,让协议调试从一次性的手工操作,变成可复现、可沉淀、可自动化、可由 AI 协作的工作流。
项目基于 .NET、Avalonia、TouchSocket 与 TouchSocketPro 构建,采用模块化架构,提供现代化桌面 UI、可保存的配置文件、可扩展的通信组件和面向 AI 工具的 MCP 接口。
## 能力图标


















## 为什么选择 NexusLinkStudio
- 多协议一站式调试:TCP Client、TCP Service、UDP Session、Serial Port、Named Pipe Client、Named Pipe Server、MQTT Client、MQTT Broker、HTTP Client、Modbus Master、Modbus Slave 等模块统一在一个工作台内。
- 不只是收发消息:通信页内置消息录制、录制文件管理、消息回放、组合筛选、变量视图、预设消息、自动回复、循环发送和日志导出等调试闭环能力。
- 面向真实项目:配置可保存为独立文件,调试数据可录制,流程可以复用,适合长期维护协议、设备、产线、网关、上位机、嵌入式和 IoT 项目。
- TouchSocket 技术栈加持:通信能力基于 TouchSocket / TouchSocketPro,覆盖高性能 Socket、串口、Modbus、MQTT、命名管道、HTTP 与 MCP。
- AI 友好:内置 MCP Server,可以把当前打开的通信组件、变量、预设消息、自动回复、数据适配器、实时报告和通信快照暴露给外部 AI 客户端。
- 可扩展:支持全局数据适配器和脚本数据适配器,支持插件包导入,适合把团队内部协议、解析规则和调试模板沉淀下来。
- 现代桌面体验:基于 Avalonia 的跨平台 UI 技术栈,带有自研控件、通知/Toast、文件浏览器、可停靠布局、主题与本地化基础设施。
## 功能总览
### 通信调试
NexusLinkStudio 将不同协议的调试体验统一成相似的工作流:配置连接参数、启动连接或服务、发送消息、观察收发、记录现场、筛选问题、回放验证。
已实现的通信页面包括:
| 模块 | 能力 |
| --- | --- |
| TCP Client | 连接 TCP 服务端,发送/接收消息,支持适配器、预设消息、自动回复、录制回放、变量视图 |
| TCP Service | 启动 TCP 服务端,管理客户端连接,支持广播、定向发送、单个/批量剔除客户端、连接统计 |
| UDP Session | 绑定本地端点,向指定目标发送 UDP 数据,适合无连接协议与设备广播场景 |
| Serial Port | 串口收发调试,支持接收编码、变量、预设消息、录制回放与筛选 |
| Named Pipe Client | 命名管道客户端调试 |
| Named Pipe Server | 命名管道服务端调试 |
| MQTT Client | MQTT 连接、订阅、发布与消息调试 |
| MQTT Broker | 本地 MQTT Broker 服务端调试 |
| HTTP Client | HTTP 请求调试与配置保存 |
| Modbus Master | Modbus 主站变量读写、地址搜索、自动执行、消息跟踪 |
| Modbus Slave | Modbus 从站数据区、变量分组、请求响应调试 |
每个通信配置都可以保存为独立文件,便于复用、共享和版本管理。
### 消息录制与回放
调试现场最怕“刚刚那个包怎么来的”。NexusLinkStudio 提供了面向通信消息的录制和回放能力:
- 可在通信页面启动/停止消息录制。
- 录制文件默认保存到应用目录下的 `MessageRecordings`。
- 支持按协议使用专属录制扩展名,例如 TCP、UDP、串口、MQTT、HTTP、Modbus 等。
- 可管理录制文件:刷新、重命名、导出、打开所在位置、移入回收站。
- 支持从一个或多个录制源读取消息并按时间线排序。
- 支持仅查看、回放发送流量、回放接收流量等模式。
- 支持立即回放、固定间隔、按原始时间间隔回放。
- 支持速度倍率、暂停、恢复、停止、清空和进度统计。
这让通信调试从“现场看一眼”变成“可以复盘、可以演示、可以回归验证”的过程。
### 消息筛选
当通信日志开始变长,能不能快速找到关键消息非常重要。NexusLinkStudio 提供统一的消息筛选入口:
- 按消息内容搜索。
- 按消息标签搜索。
- 按发送、接收、系统、协议专用类型过滤。
- 按开始日期和结束日期过滤。
- 支持组合筛选。
- 筛选状态下仍会跟随新消息增量更新。
Modbus 等模块还提供专用消息类型筛选键,方便按功能码、主站/从站业务消息定位问题。
### 预设消息
很多协议调试会反复发送相同命令。NexusLinkStudio 提供预设消息设计器,可维护常用消息模板,并在通信页直接选择发送。
预设消息支持多种动态模板:
- 日期
- 时间
- 日期时间
- 时间戳
- GUID
- 换行
- 输入参数
这让“登录包、心跳包、查询包、控制命令、异常命令”等常用报文可以被清晰整理,而不是散落在聊天记录、文本文件或临时笔记里。
### 自动回复
自动回复适合模拟设备、模拟服务端、构造协议应答或做简单闭环测试。
NexusLinkStudio 提供自动回复设计器,支持:
- 统一维护自动回复规则。
- 为不同通信模块启用自动回复。
- 根据触发条件匹配消息。
- 返回固定内容或由脚本逻辑生成回复。
- 在 TCP、UDP、串口、命名管道、MQTT、Modbus 等调试流程中复用自动应答能力。
当你需要模拟一个还没写好的设备、复现一个异常服务端、或者让客户端程序跑完联调流程时,这个能力会非常省时间。
### 变量视图
通信调试不只有“消息”,很多时候还需要观察协议中的“状态”和“数据点”。NexusLinkStudio 在多个通信页面中加入了变量视图:
- 支持变量分组。
- 支持变量新增、编辑、删除。
- 支持变量值更新与运行时管理。
- 支持与通信消息、MCP 工具、Modbus 变量读写等能力结合。
Modbus 模块提供更专业的变量体验:
- 线圈
- 离散输入
- 保持寄存器
- 输入寄存器
- 读写操作
- 数据格式显示
- 自动执行
- 地址搜索
- 可拖拽分组布局
### 数据适配器
真实 TCP 协议往往不是“一行文本一个包”,而是粘包、分包、固定长度、分隔符、JSON 帧、自定义帧头等复杂形态。NexusLinkStudio 提供全局数据适配器配置能力,用来处理通信数据边界。
内置适配器包括:
- `BetweenAnd`:按起止标记截取数据包。
- `FixedSize`:按固定长度分包。
- `Period`:按结束符或分隔符分包。
- `Json`:按 JSON 数据包识别。
- `script`:通过 C# 脚本动态编译 TouchSocket 数据处理适配器。
脚本数据适配器可以编写完整 C# 源码,并动态编译为可回收程序集。系统会检查编译错误、类型是否存在、是否继承 `SingleStreamDataHandlingAdapter`、是否可实例化等问题。对于自定义二进制协议、特殊帧格式、厂商私有协议,这是非常强的扩展点。
### 通信流程图
通信流程图用于把多个通信组件串成可执行流程,适合描述和验证“发送 -> 接收 -> 判断 -> 输出结果”的调试过程。
当前流程图内置节点包括:
- 开始
- 通讯器
- 发送
- 接收
- 结果
它适合把手工联调步骤变成更清晰的流程表达,也方便后续做回归、演示和 AI 协助分析。
### 通讯组态与实时报告
项目中还包含:
- 通讯组态:用于搭建面向通信数据的可视化/组态页面。
- 实时报告:用于把实时数据、调试结果和现场状态组织成报告视图。
这些能力让 NexusLinkStudio 不只停留在“调试工具”,而是逐渐具备“通信工作台”和“现场观察台”的形态。
### 快捷工具
NexusLinkStudio 内置多个开发调试中常用的小工具:
- 字符串转换
- JSON 格式化
- Base64 编解码
- URL 编解码
- GUID 生成
- 时间戳转换
- 哈希计算
- 输出窗口
- 终端入口
这些工具放在同一个工作台里,可以减少调试时在多个小软件、网页和脚本之间来回切换。
## AI 与 MCP
NexusLinkStudio 内置 MCP Server,名称为 `NexusLinkStudio.McpServer`。当 MCP 服务启动后,外部 AI 客户端可以通过 MCP 与当前工作台协作。
已提供的 MCP 能力覆盖:
- 通信组件列表与能力描述。
- 当前打开标签页信息。
- TCP、UDP、串口、命名管道、MQTT、Modbus 等组件的启动、停止、配置、发送消息与快照读取。
- 通信变量新增、删除与描述。
- 预设消息列表、模板列表、创建、更新、删除。
- 自动回复配置、匹配与变更。
- 全局数据适配器列表、定义查询、保存、删除、验证。
- 脚本数据适配器 Prompt 模板获取。
- 实时报告相关工具。
- 通信流程图运行与快照。
这意味着你可以让 AI 做一些以前只能人工完成的事,例如:
- “帮我新建一个 TCP 客户端配置并连接到 127.0.0.1:7789。”
- “根据这段协议说明生成一个脚本数据适配器。”
- “读取最近 50 条 Modbus 消息,帮我判断哪个寄存器异常。”
- “把这些常用命令整理成预设消息。”
- “创建自动回复规则,用来模拟设备握手流程。”
NexusLinkStudio 的目标不是让 AI 取代调试人员,而是让 AI 能真正进入调试现场,理解当前打开的连接、变量、报文和配置。
## 配置文件与扩展名
NexusLinkStudio 的核心配置都可以落盘保存。常见扩展名如下:
| 类型 | 扩展名 |
| --- | --- |
| TCP 客户端配置 | `.tcpclient` |
| TCP 服务端配置 | `.tcpservice` |
| UDP 会话配置 | `.udpsession` |
| 串口配置 | `.serialport` |
| 命名管道客户端配置 | `.namedpipeclient` |
| 命名管道服务端配置 | `.namedpipeserver` |
| MQTT 客户端配置 | `.mqttclient` |
| MQTT Broker 配置 | `.mqttbroker` |
| HTTP 客户端配置 | `.httpclient` |
| Modbus 主站配置 | `.modbusmaster` |
| Modbus 从站配置 | `.modbusslave` |
| 通信流程图 | `.communicationflowdiagram` |
| 通讯组态 | `.communicationhmi` |
| 实时报告 | `.livereport` |
消息录制文件与配置文件分开保存。录制文件默认目录为 `MessageRecordings`,并按通信类型使用专属扩展名,方便长期归档和回放。
## 技术栈
- .NET 10
- C# preview
- Avalonia 12
- CommunityToolkit.Mvvm
- TouchSocket 4
- TouchSocketPro Modbus
- TouchSocket.Mcp
- LiveChartsCore
- LiveMarkdown.Avalonia
- AvaloniaEdit / TextMate
- NLog
## 获取与使用
NexusLinkStudio 目前不是开源软件,但可以免费使用。
你可以通过项目主页获取发布信息、使用说明和后续更新:
- GitHub: https://github.com/RRQM/NexusLinkStudio
- Gitee: https://gitee.com/RRQM_Home/NexusLinkStudio
如果你希望反馈问题、提出建议、交流使用场景或关注新版本,可以优先通过 GitHub / Gitee 仓库入口进行。
## 适合谁使用
NexusLinkStudio 特别适合:
- 物联网、工业控制、设备通信、上位机、网关、边缘计算项目开发者。
- 需要调试 TCP、UDP、串口、Modbus、MQTT、HTTP、命名管道的工程师。
- 需要模拟客户端、服务端、设备端、Broker 或从站的测试人员。
- 需要录制现场通信、复盘问题、做回归验证的团队。
- 希望让 AI 参与协议配置、报文分析、自动回复和适配器生成的开发者。
- 已经使用或计划使用 TouchSocket 技术栈的 .NET 开发者。
## 项目特点
### 统一但不粗糙
不同协议有不同的细节,但 NexusLinkStudio 尽量保持一致的操作方式:连接配置、消息区、发送区、录制回放、筛选、变量、保存配置。这让你在 TCP、串口、UDP、MQTT、Modbus 之间切换时,不需要重新学习一套界面。
### 可复现
配置文件、录制文件、预设消息、自动回复、数据适配器都可以保存。调试经验不会只存在于某次会话里,也不会只存在于某个人脑子里。
### 可自动化
通信流程图、自动回复、循环发送、变量自动执行、MCP 工具把手工步骤逐步抽象成可自动运行、可由外部工具调用的能力。
### 可扩展
内置适配器解决常见分包问题,脚本适配器解决特殊协议问题,插件管理为后续扩展模块留下空间。
### AI 原生协作
很多工具只是把 AI 当聊天窗口,而 NexusLinkStudio 更进一步:把通信组件、配置、消息、变量和适配器暴露为 MCP 工具,让 AI 能操作真实上下文。
## 路线方向
项目仍在快速开发中,当前重点方向包括:
- 完善更多通信协议与工业协议调试能力。
- 强化通信流程图与自动化测试能力。
- 继续扩展 MCP 工具,让 AI 能更深入地参与协议分析和配置生成。
- 优化通讯组态、实时报告与变量可视化体验。
- 沉淀更多内置数据适配器与脚本适配器模板。
- 改进插件机制,让团队能力可以更方便地分发和复用。
## 授权说明
NexusLinkStudio 目前免费提供给用户使用,但软件本身不开源。未经授权,请不要反编译、逆向、二次打包、修改后分发,或将其作为其他产品的一部分重新发布。
如果你有企业集成、定制开发、商业合作、离线分发或特殊授权需求,可以通过项目主页联系作者。
## 作者与交流
- 作者:若汝棋茗
- QQ:505554090
- QQ 群:[点击加入交流](https://qm.qq.com/q/QYRKIcHqkq)
## 相关链接
- GitHub: https://github.com/RRQM/NexusLinkStudio
- Gitee: https://gitee.com/RRQM_Home/NexusLinkStudio
- TouchSocket: https://touchsocket.net/
---
如果你正在做通信调试,NexusLinkStudio 希望成为那种“打开以后就能一直放在旁边”的工具:能发包,也能记录现场;能看日志,也能沉淀流程;能手动验证,也能让 AI 参与下一步。