# NoteSerial

**Repository Path**: hupo510/note-serial

## Basic Information

- **Project Name**: NoteSerial
- **Description**: 像文本编辑器一样查看串口日志，带高级搜索和转义功能，支持lua和python语言插件
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-29
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NoteSerial简介 [gitee](https://gitee.com/hupo510/note-serial) [github](https://github.com/Hupo510/note-serial)
NoteSerial是一款用于Windows平台的串口日志查看工具，可以像VScode一样搜索查找日志，支持Lua和Python脚本插件，同时作者独创了一些特色工具，工具采用C语言原生GUI开发，安装包仅1MB大小，小巧而强大。

# 功能汇总
NoteSerial具体功能如下：（部分还在开发完善中，敬请期待）
| 功能 | 描述 | 完成情况 |
| ---- | --- | ------ |
| 日志着色器 | 根据规则对日志进行着色 | ✔ |
| 日志查找器 | 类似VScode对日志进行查找搜索 | ✔ |
| 日志结果展示器 | 将日志的查找结果所在行全部提取到独立窗口进行展示，并能通过双击展示内容同步定位原日志 | ✔ |
| 日志手动颜色标记 | 右键菜单可对选中文本进行颜色标记 | ✔ |
| 正则表达式查找 | 采用非std的正则库，优化提高匹配速度 | ✔ |
| 清理串口端口占用功能 | 清理系统的串口端口占用，释放更多的端口，新设备将重新分配端口号 | ✔ |
| 数据发送功能 | 单条和多条的发送功能，添加Esc转义功能（支持\r\n\x等）| ✔ |
| HEX格式显示功能 | 可将接收到的串口内容转换为HEX格式并显示 | 仅部分实现 |
| 日志文件拖入打开 | 支持将文件拖入到日志窗口进行打开查看 | ✔ |
| Lua和Python脚本插件| 支持Exe <-> Lua <-> Python的调用逻辑 | ✔ |
| 滚动标记栏 | 标记栏显示当前光标，查找结果所在位置等信息 | ✔ |
| 选中注释功能 | 选中文本右键调用脚本进行格式转换注释 | ✔ |
| 独立的文档查看器 | 将文件拖入图标或者程序窗口打开一个新的日志查看器 | ✔ |
| 全部结果展示器迭代搜索功能 | 结果展示窗口可支持搜索功能，且能无限迭代创建新的子结果展示窗口 | ✔ |
| 本地英汉词典翻译 | 添加本地英汉词典翻译的Python插件实现 | ✔ |

# LUA脚本说明
+ [Lua内部模块及函数说明文档](./LuaDoc.md)
+ Lua的工作目录请打开软件点击右下角的`管理`->`打开AppData文件夹`，在打开的文件夹中的script子目录下
+ lua或python脚本插件请放到script子目录下，python最好以模块文件夹的形式组织，init.lua为模块的入口文件，编写初始化与注册的代码，程序会自动扫描加载
+ python扩展需要宿主机中有安装python环境，且python版本必须大于3.7版本，程序会自动扫描Path环境变量中的首个python.exe路径，作为python解释器。

# 截图

主界面:

![](./images/Snipaste_2025-06-29_14-57-26.jpg)

查找栏：

![](./images/Snipaste_2025-06-29_14-59-37.jpg)

查找结果展示窗口：

![](./images/Snipaste_2025-06-29_15-01-02.jpg)

手动颜色标记：

![](./images/Snipaste_2025-06-29_15-03-10.jpg)

全部结果展示器迭代套娃式展开并搜索

![](./images/Snipaste_2026-01-21_17-49-04.png)

选中文本右键注释转换功能

![](./images/Snipaste_2026-01-21_17-56-04.png)

选中文本右键执行本地本地英汉词典翻译

![](./images/Snipaste_2026-02-03_11-28-33.png)