Lemon串口监控（Lemon Serial Monitor）

简体中文 | English

我做 Lemon串口监控（Lemon Serial Monitor），就是想有一款 MIT 开源、允许商业使用的 Windows x64 只读串口监控和 COM 端口监控工具，用来做 COM 端口抓包、串口嗅探和串口通信分析。内核过滤驱动只复制已经发生的读、写和控制事件，桌面程序本身不打开、也不占用被监控的 COM 端口；WPF 界面、CLI 和 MCP 可用于人工查看、自动化和 AI 辅助软硬件调试。兼容目标包括 Windows 10/11 x64 和 Windows Server 2019/2022/2025 x64；Server Core 只安装无界面组件，具体验证边界见下文。

当前版本为 0.1.1，采用 MIT 许可证。个人使用、商业使用及盈利，以及修改、再分发、再许可和销售均获允许；分发本软件的副本或实质性部分时，必须保留 Copyright (c) 2026 qingningmneg 和 MIT 许可声明。

直接下载 LemonSerialMonitor-Setup-x64.exe

下载后请先根据对应 Release 中的 SHA256SUMS.txt 核对安装包。

下载与安装

正式安装包发布在 GitHub 的 Releases 页面，文件名为：

LemonSerialMonitor-Setup-x64.exe

安装时不需要打开 PowerShell：

1. 双击安装包。
2. 阅读并接受“本地测试证书使用说明”。
3. 选择桌面程序安装位置。
4. 点击“安装”，在 Windows 提示时允许管理员权限。
5. 如果安装程序提示重启，请先保存工作，再按提示重启；重启后再打开软件。

当前驱动使用本地测试证书，不是微软正式发布签名。安装程序会自动核对安装包、导入随包公钥证书，并在需要时启用 Windows TESTSIGNING。它不会关闭安全启动，也不会修改 BitLocker。安全启动处于开启状态时，安装会停止。

测试证书要等安装程序取得管理员权限后才能导入，因此第一次双击时，Windows 仍可能显示 SmartScreen 或“未知发布者”。0.1.1 的发布文件有本地测试签名，但没有微软信任链，也没有 RFC 3161 公共时间戳；请只从本项目 Release 下载并先核对 SHA256SUMS.txt。

0.1.1 不支持覆盖已有的新式安装。更新前先停止监控并备份数据，使用旧版本完整卸载，按提示重启后再安装新版。

完整说明见 安装与卸载。

完整操作手册可直接查看或保存：PDF 版、Word 版。

兼容目标系统

• Windows 10 x64
• Windows 11 x64
• Windows Server 2019 x64（桌面体验 / Server Core）
• Windows Server 2022 x64（桌面体验 / Server Core）
• Windows Server 2025 x64（桌面体验 / Server Core）

Server Core 不安装 WPF 桌面程序，只安装驱动、后台服务、AI/命令行接口和文档。x86、ARM64、未知 Windows Server 构建以及安全启动开启的环境会被安装程序拒绝。

0.1.0 历史基线已在 Windows 11 x64 实机完成图形安装、重启、服务冷启动、桌面连接、JSON CLI 和 MCP；当时的候选验证链还完成了前一候选的完整卸载以及该代码候选的干净安装。没有接入串口设备时，后台服务仍会保持运行；点击“刷新端口”后，端口列表为空、驱动显示暂不可用属于正常状态，接入真实设备后再刷新即可。这是 0.1.0 的历史证据，不是 0.1.1 新增验收结果。

0.1.0 历史基线中的 Windows Server 2022/2025 仅在 GitHub 托管桌面 runner 完成平台识别、托管测试和安装契约检查，没有装载内核驱动；Server Core 只有组件布局契约测试，Server 2019 自托管任务未执行。0.1.1 没有新增任何 Server 实机或虚拟机的驱动安装、重启、捕获、AI、卸载端到端验收，所以这些版本是兼容目标，不是已完成硬件认证。具体范围见 0.1.1 发布说明。

与常规串口终端/助手的区别

| 方面 | Lemon串口监控 | 常规串口终端/助手的典型方式 | | --- | --- | --- | | COM 端口关系 | 桌面界面不打开或取得被监控 COM 端口的所有权；内核过滤驱动复制已经发生的读写活动。 | 通常由工具直接打开 COM 端口并参与通信。 | | 数据方向 | 只读监控，不主动发送、注入或重放数据。 | 通常可以主动发送数据。 | | AI 辅助调试 | 通过受保护的本机 CLI/MCP 分页读取捕获事件，用于 AI 辅助软硬件调试。 | 是否提供本机自动化或分页接口取决于具体工具。 |

主要功能

• 不由桌面程序占用 COM 端口，监控一个或多个串口的 Read、Write 和配置控制事件。
• 列表、Dump、终端三种查看方式。
• 显示时间、进程、端口、方向、操作码、状态、长度、标志、HEX 和文本。
• HEX 与文本循环查找；HEX 支持 ?? 单字节通配符。
• 多行选择后可复制为空格 HEX、紧凑 HEX、文本、C 数组、Python bytes、TSV、CSV 或 JSON。
• Ctrl+C 使用当前复制格式；Ctrl+Shift+C 只复制连续的空格 HEX 数据。
• 会话自动写入受保护的本机数据库；停止后可导出 CSV、TXT 或 RAW。
• 本机 AI 接口支持状态、端口、开始/暂停/继续/停止、会话列表、分页读取、等待新事件、导出和协议描述。
• AI 接口提供标准 MCP stdio 服务，不开放 HTTP 端口，也不接受发送、注入、重放或任意文件访问。
• 图形化完整卸载；按受保护安装记录精确移除本软件文件、服务、驱动、过滤器、证书和数据。

三分钟开始监控

1. 打开原来使用串口的业务软件，让它正常连接设备。
2. 打开 Lemon串口监控，点击“刷新端口”。
3. 勾选要看的 COM 端口，填写一个会话文件名，例如 board-test.db。
4. 点击“开始”。
5. 让原业务软件真正发送或读取数据。
6. 在“列表”“Dump”“终端”之间切换查看。
7. 结束时先点击“停止”，再按需要复制或导出。

如果列表没有数据，先确认已经点了“开始”，并确认原业务软件在“开始”之后确实对同一个 COM 端口发生了读写。监控工具不会主动向设备发送数据。

没有连接串口设备时，刷新后看到“服务已连接”、端口列表为空、驱动暂不可用是正常现象，不表示后台服务启动失败。

完整界面说明见 操作指南，问题处理见 故障排查。

AI 接入

安装后的 AI 客户端默认位于：

C:\Program Files\Lemon串口监控\ai\Lemon.SerialMonitor.AI.exe

如果安装时选择了其他位置，请使用实际路径。

命令行快速检查：

& 'C:\Program Files\Lemon串口监控\ai\Lemon.SerialMonitor.AI.exe' status --json
& 'C:\Program Files\Lemon串口监控\ai\Lemon.SerialMonitor.AI.exe' ports --json

MCP 配置示例：

{
  "mcpServers": {
    "lemon-serial-monitor": {
      "command": "C:\\Program Files\\Lemon串口监控\\ai\\Lemon.SerialMonitor.AI.exe",
      "args": ["mcp"]
    }
  }
}

详细接入步骤见 AI 接入指南，命令、工具、字段和完整性规则见 AI 接口参考。

数据与卸载

会话和导出文件默认保存在受保护的 %ProgramData% 数据目录中。卸载程序会明确提示：完整卸载会永久删除本软件产生的全部会话、导出、设置、日志和 AI 状态。需要保留的数据必须先导出或备份。

可以从“设置 → 应用 → 已安装的应用 → Lemon串口监控 → 卸载”进入完整卸载。卸载程序会先关闭本软件桌面程序、AI 客户端和后台服务；只有 Windows 内核仍在使用驱动、启动策略需要恢复或文件仍被系统锁定时，才会安排重启后继续清理并再次核验残留。

从源码构建

仓库已经包含生成安装包所需的已验收 DOCX/PDF 手册。源码构建还需要 Visual Studio 2022、WDK、Spectre 库、.NET SDK、Pester 和 Inno Setup 6.7.3。构建、签名、测试与安装包命令见 构建说明。

安全边界和威胁模型见 安全说明，版本变化见 0.1.1 发布说明。

开源许可证

Lemon串口监控由 qingningmneg 以 MIT 许可证 开源。MIT 允许个人使用和商业使用，也允许修改、再分发、再许可和销售；分发本软件的副本或实质性部分时，必须保留 Copyright (c) 2026 qingningmneg 和 MIT 许可声明。本软件按“原样”提供，不附带任何明示或默示担保；完整条款以 LICENSE 为准。

独立实现

本项目的代码、协议、会话格式、安装流程和界面均为独立实现，不包含其他串口软件的二进制、图标、商标、私有代码或素材。