简介
浏览器里的设备调试台，纯静态前端，没有上位机要装、没有后端要起。打开网页、选设备、连上，就能看原始报文、手动发命令、看实时曲线。
一个标签页，一根线，跟设备直接对话。
适用场景
- 临时调一块 Modbus RTU 板子，不想装厂家几百 MB 的上位机
- 进车间带个 HART 调制解调器，笔记本插上就是 HART 调试工具
- 新设备走 WebSocket 或 MQTT，想边看流量边看曲线
- 把链接发给同事，比发
setup.exe 省事
- 内部协议没有现成工具，用 自定义设备 页面拼一个，不用写代码
不适合长时间数据采集、生产监控或 SCADA，这是个调试工具。
内置设备
| 设备 | 传输 | 默认参数 | 说明 |
|---|
| Modbus RTU | 串口 | 9600 8N1 | 读写保持 / 输入寄存器 |
| HART | 串口 | 1200 8O1 | 设备搜索、通用命令、PV/SV/TV/QV、仪表设置与校正 |
| WebSocket | WebSocket | — | JSON / HEX / Modbus 报文调试 |
| MQTT | MQTT over WS | — | 发布订阅、QoS、保留消息、统计 |
| AOMaster | 串口 | 115200 8N1 | 4-20 mA / 0-10 V 信号源 |
| MicroScope Power | WebUSB | — | 小电流波形采集（硬件 · 固件） |
| 自定义设备 | 任意 | — | 发送模板 + 解析规则，无需写代码 |
切换设备时，通讯方式和默认参数会跟着切换。
主要功能
- 收发调试：毫秒时间戳，HEX / 文本显示切换，暂停滚动，收发字节统计，日志保存为 .txt。
- Modbus RTU：一问一答收发，超时与异常码诊断；寄存器表支持 16 / 32 位整数和 Float32 等多种格式。
- HART：地址扫描、通用命令、PV/SV/TV/QV 轮询，仪表参数设置与输入输出校正；应答超时和响应码诊断，写操作发送前确认。
- 自定义设备：常用指令库（导入导出、定时发送），文本转义，CRC16 / SUM8 / XOR8 校验；发送模板支持
{value} 等占位符，解析支持正则、JSON 路径、HEX 偏移和 Modbus 载荷。
- 实时曲线：多曲线显示，CSV 导入导出。
- 其它：中英文界面、深浅色主题，可下载离线包使用。
快速开始
开发时不用构建，起一个静态服务即可：
python3 -m http.server 4173
用 Chrome / Edge 打开 http://localhost:4173。
构建发布版本：
npm install
npm run build
npm run preview
构建脚本是 scripts/build.mjs（基于 esbuild），产物在 _site/。
离线使用
适合拷到笔记本、工控机或现场环境里用，无需联网。
- 下载：每次推送到
main 后，在 Actions → Offline package 最新一次运行里下载 modusignal-offline-<版本>.zip；打 v* 标签的版本在 Releases 下载。
- 运行：解压后双击
start-modusignal.bat（Windows）或运行 start-modusignal.sh（macOS / Linux），会自动起服务并打开浏览器。
- 自己打包：
npm install 后运行 npm run build:offline，产物在 _release/。
浏览器要求
| 功能 | 浏览器 |
|---|
| 串口（Web Serial） | Chrome / Edge 89+，需要 HTTPS 或 localhost |
| WebUSB | Chrome / Edge，需要 HTTPS 或 localhost |
| WebSocket、MQTT over WebSocket | 现代浏览器均可 |
Firefox 和 Safari 不支持 Web Serial / WebUSB，串口和 WebUSB 设备用不了，其它功能正常。
开发
设备层和传输层分开：加一个新设备通常就是在 src/devices/ 写驱动、在 src/device-registry.js 注册、在 pages/devices/ 加页面。
测试：npm test。
参与
项目在持续迭代。需要新设备但不方便自己写驱动的，提一个 issue，附上协议文档、报文样例和默认连接参数即可。也欢迎 PR 增加设备或修复驱动。
许可证
Apache License 2.0。
如果 modusignal 帮你省下了一个下午跟厂家上位机较劲的时间，点个 star 能让更多人看到它。
