07 / SERIAL WORKBENCH
串口调试台
支持串口连接、文本与 HEX 收发、日志过滤、定时发送和文件保存。
● 串口数据本地处理 · 不上传 · 可选自动保存正在检测 Web Serial 支持情况…
连接配置
未连接设备接在运行浏览器的电脑上。系统需能识别串口，其他串口软件应先释放端口。演示只生成示例日志，不连接设备或发送命令。
高级 · 信号线控制
仅点击“应用信号”时设置勾选值。DTR / RTS 可能接到设备复位或启动脚；硬件流控时不手动设置 RTS。打开端口时的默认电平也取决于系统与驱动。部分适配器不支持信号控制。
接收监视器
未连接 · 实时视图筛选与高亮
用 | 分隔多个筛选词，按纯文本匹配。筛选只影响视图和文本导出；原始字节保持不变。
文本保留最近 5,000 行，原始数据保留最近 8 MiB 或 4,096 块（先到为限）；画面最多显示 1,500 行。
自动保存到本地文件
正在检测本地文件写入能力…
未启用自动保存
只记录启用后的真实串口数据，不回填缓存或演示。暂停画面、筛选和清屏不影响自动保存；取消勾选或断开串口会完成最后一笔提交。文本按行记录，未换行内容在提交时标记为“片段”；原始模式逐字节保存 RX，不含时间戳或 TX。
单文件模式追加已有内容；按时间模式在所选目录生成带本地时间及其时区偏移、会话标识和序号的新文件，遇到重名会另取名字。请勿同时用其他程序编辑。状态中的“已提交”表示写入流已关闭成功。强制关闭网页、浏览器崩溃或休眠可能丢失尚未提交的数据，离开前请取消勾选并等待“保存已结束”。例如 10:20 启用、间隔 60 分钟，会在约 11:20、12:20 切换文件，并非整点切换。后台调度可能推迟切换，恢复后不补建休眠期间的空白文件。大文件频繁提交可能变慢，可缩短分文件间隔。
保存与导出
导出当前缓存。文本导出遵循显示选项与筛选；HEX 模式导出完整缓存中的匹配 HEX 行。BIN 不加时间戳、不转换编码；JSON 保留每块方向、接收 / 发送时间与 HEX。清空或刷新后缓存无法恢复，长时间采集可开启自动保存。
使用说明与能力边界
优先使用桌面 Chrome / Edge，通过 HTTPS 或 localhost 打开。网页只访问你授权的本机串口，不访问远程主机。手机及不支持 Web Serial 的浏览器仍可体验演示。页面不上传串口数据，不写入 localStorage / IndexedDB。自动保存默认关闭，仅在你选择并授权的本地文件或目录中记录；命令不自动保存。
网页、文件名、自动保存及导出统一使用浏览器本地时间并标注时区偏移（如 +08:00，文件名为 +0800）。文件名记录文件创建或导出的时间，日志记录浏览器观察到数据的时间，不是设备硬件时间戳。USB 和系统会合并数据，HEX 分块不代表协议帧。文本按 CR / LF 分行，超长行每 4,096 字符拆分；控制字符按显示选项处理，不提供完整 VT100 终端仿真。暂停画面仍继续接收并受缓存上限约束；关闭网页、电脑休眠或拔出设备会中断采集。
发送完成表示浏览器写入操作完成，不等于设备已执行命令。串口断开后，未结束的文本行会补入记录。Framing / Parity 等读取告警在浏览器提供新读流时尝试继续接收；告警位置可能缺失字节，同类提示按计数合并，不代表错误已被修复。默认勾选“隐藏接收告警日志”，日志窗口、复制和筛选文本导出不显示这类 SYS 摘要；取消勾选可恢复查看。顶部告警提示与计数、自动保存中的告警摘要，以及停止接收等错误提示始终保留。文本保存会标记接收中断，原始 BIN 只保留实际收到的字节。正常的 NUL（0x00）不会被当作读取错误。文本视图默认隐藏仅含 NUL 的接收行；取消“隐藏纯 NUL 接收行”并勾选“控制字符可见”可显示为 <00>。该过滤同时适用于复制和筛选文本导出，不影响 HEX 视图、告警计数、原始导出及自动保存；含正常文字的行仍然保留。若适配器不支持所选波特率、流控或信号线，页面会显示操作错误。