# OODD.LogTailMonitor **Repository Path**: OODD-DevNet/OODD.LogTailMonitor ## Basic Information - **Project Name**: OODD.LogTailMonitor - **Description**: 单机实时日志跟踪工具:像 tail -f 一样持续盯住日志文件,追加、滚动、切换文件都不用重新打开,专注本地排障场景。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-02 - **Last Updated**: 2026-11-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # OODD.LogTailMonitor 一款 Windows 桌面日志查看器:像 `tail -f` 一样盯住正在写入的日志文件,几百 MB 的文件也能打开就看见尾巴。为本地排障、值班盯盘和大文件翻阅而做。 ![暗色主题主界面](screenshots/main-dark.png) ## 功能 **大文件不等待** - 首屏只读文件末尾,打开几百 MB 的日志不用等它读完;更早的内容按页向前加载。 - 「跟随尾部」模式最多驻留 5000 行,超出部分自动卸载、需要时再从文件读回;「严格分页」模式一次只驻留一页,超大文件最省内存。 - 文件持续追加时视图自动跟随;检测到日志滚动(改名/重建)或截断会从新文件末尾继续跟踪,历史页保留。 **编码识别** - 自动识别 UTF-8、GBK、Big5、UTF-16 等常见编码,判不出来才退回 UTF-8;状态栏可随时手动改,按新编码重新分页。 - 单行超长时按上限截断显示,不会因为一条异常堆栈把界面拖死。 **关键词规则** - 预置 error / warning / success 三条规则,可增删改;支持正则、区分大小写、整行底色与命中子串色、启用开关。 - 规则自上而下匹配,第一条命中的规则决定整行颜色;写错的正则会标出原因,不影响其它规则。 - 「只看命中」在显示层过滤,内核仍保留全部行;命中计数、上一处 / 下一处逐条跳转。 - 规则持久化在 `keywords.json`,重启后继续生效。 **定位与浏览** - Ctrl+G 定位:纯数字是行号,`p12` 是第 12 页,`0x1F4` / `512b` / `1.5mb` 是字节偏移。 - 上一页 / 下一页 / 加载更早 / 回到底部;手动上滚会自动脱离跟随,点「回到底部」恢复。 - 多文件标签一次打开,标签头单行滚动不折行;新行入场有短暂高亮,忙时能看出哪些是新来的。 **Windows 集成** - 可注册到资源管理器右键菜单(写 HKCU,不需要管理员权限),选中多个日志文件一步全部打开。 - 单实例:程序已开着时,再次双击日志会用现有窗口打开,不重复起进程。 - 复制选中行、在资源管理器中定位文件、窗口置顶、字号调整、自动折行。 **界面** - 浅色 / 暗色 / 高对比三套主题,切换即时生效,不重建窗口。 - 简体中文 / English 双语,词条在 `lang/*.json`,增加一种语言就是多放一个词典文件。 - 不收费、无广告、不联网、不收集信息,日志与配置全部留在本机。 ![浅色主题](screenshots/main-light.png) ## 下载 到 [Releases](https://github.com/OODD-DevNet/OODD.LogTailMonitor/releases) 下载 `v1.0.0.0`。程序没有安装包,压缩包解压到任意目录,双击 `LogTailMonitor.exe` 即用;删除目录即卸载。 | 压缩包 | 架构 | 是否需要 .NET | | --- | --- | --- | | `LogTailMonitor-1.0.0.0-win-x64-self-contained.zip` | x64(绝大多数电脑) | 不需要,运行时已打包 | | `LogTailMonitor-1.0.0.0-win-x86-self-contained.zip` | x86(32 位) | 不需要,运行时已打包 | | `LogTailMonitor-1.0.0.0-win-x64-framework-dependent.zip` | x64 | 需要 [.NET 8 Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/8.0) | | `LogTailMonitor-1.0.0.0-win-x86-framework-dependent.zip` | x86(32 位) | 需要 .NET 8 Desktop Runtime | - 自包含包体积大(一百多 MB),拷到没有装 .NET 的机器上直接能跑。 - 框架依赖包只有几 MB,机器上已装 .NET 8 Desktop Runtime 时选它。 - 不确定选哪个就选 `win-x64-self-contained`;32 位系统或 32 位进程环境选 `win-x86`。 **系统要求**:Windows 10(1607 及以上)/ Windows 11,x64 或 x86。程序未做代码签名,首次运行 SmartScreen 可能提示「Windows 已保护你的电脑」,选「更多信息 → 仍要运行」即可。 ## 使用 1. 解压压缩包,运行 `LogTailMonitor.exe`。 2. 点「选择文件(可多选)」;也可以用「打开方式」选择本程序,或从命令行把文件路径传进来。 3. 想从资源管理器右键直接打开:菜单「工具 ▸ 注册右键菜单」,之后选中日志右键「用日志监控打开」。 4. 菜单「外观」切换主题和语言;「文件 ▸ 打开配置目录」直达配置与日志目录。 常用操作: | 操作 | 方式 | | --- | --- | | 定位行号 / 页码 / 字节偏移 | Ctrl+G,或工具栏「定位」框 | | 添加关键词规则 | 工具栏关键词框回车,或「规则管理」 | | 只看命中行 | 工具栏「只看命中」 | | 跳转到上一处 / 下一处命中 | 工具栏「▲ 上一处」「▼ 下一处」 | | 跟随 / 冻结画面 | 工具栏「继续监控」开关 | | 复制一行 | 选中行,右键「复制选中行」 | ### 配置与便携模式 默认配置目录:`%APPDATA%\LogTailMonitor\` - `settings.json`:主题、语言、字号、驻留上限、轮询间隔等。 - `keywords.json`:关键词规则。 - `logs\`:程序自身运行日志。 把配置放到程序目录旁边做绿色便携版:设置环境变量 `LOGTAILMONITOR_HOME` 指向一个目录,所有配置与日志都会写进那里。 ### 命令行 ```bat LogTailMonitor.exe "D:\logs\app.log" "D:\logs\gateway.log" ``` 已启动时再执行,会把文件转发给现有窗口打开。 ## 从源码构建 需要 Windows、[.NET SDK 8](https://dotnet.microsoft.com/download/dotnet/8.0),以及 WPF 桌面开发工作负载(Visual Studio 2022 可选)。 ```bat git clone https://github.com/OODD-DevNet/OODD.LogTailMonitor.git cd OODD.LogTailMonitor dotnet build LogTailMonitor.sln -c Release dotnet test LogTailMonitor.Tests\LogTailMonitor.Tests.csproj -c Release ``` 发布与 Release 里的压缩包同口径: ```bat dotnet publish LogTailMonitor\LogTailMonitor.csproj -c Release -r win-x64 --self-contained true -o publish\win-x64-sc dotnet publish LogTailMonitor\LogTailMonitor.csproj -c Release -r win-x86 --self-contained true -o publish\win-x86-sc dotnet publish LogTailMonitor\LogTailMonitor.csproj -c Release -r win-x64 --self-contained false -o publish\win-x64-fd dotnet publish LogTailMonitor\LogTailMonitor.csproj -c Release -r win-x86 --self-contained false -o publish\win-x86-fd ``` WPF 自包含发布不能裁剪(`PublishTrimmed` 与 XAML 反射不兼容),所以自包含包就是完整的运行时体积。 项目结构: - `LogTailMonitor/Core`:分页读取内核、编码画像、行边界与行号索引、追加与滚动侦测。 - `LogTailMonitor/Services`:设置、关键词规则、单实例转发、右键菜单注册、主题与本地化、关于页信息。 - `LogTailMonitor/Views`、`ViewModel`:WPF 界面。 - `LogTailMonitor.Tests`:xUnit 测试,覆盖读取内核、关键词引擎、单实例通信、UI 通道成本与主题渲染等。 ## 许可 以 [Apache License 2.0](LICENSE) 发布。可以免费使用、修改、商用和二次开发后重新分发;保留原始版权声明与 `LICENSE` 文件,并说明你做出的修改即可。软件按「现状」提供,不含任何明示或暗示的担保。 随包发布的第三方库均为 MIT 等宽松许可,完整清单与主页链接见程序「工具 ▸ 关于」。 ## 反馈 发现 bug 或有建议,请到 [Issues](https://github.com/OODD-DevNet/OODD.LogTailMonitor/issues) 提交,附上系统版本、程序版本和复现步骤。 ![关于页](screenshots/about-light.png) --- ## English summary OODD.LogTailMonitor is a Windows desktop log viewer for large files and live tailing. It opens multi-hundred-megabyte logs immediately by reading the tail first and paging older content on demand, detects common encodings (UTF-8, GBK, Big5, UTF-16), highlights and filters keyword rules with hit-by-hit navigation, follows a file while it keeps growing, opens many files in tabs, and registers an Explorer context-menu entry. The UI ships light, dark and high-contrast themes in Chinese and English. Download the portable `v1.0.0.0` builds from [Releases](https://github.com/OODD-DevNet/OODD.LogTailMonitor/releases): self-contained or framework-dependent, x64 or x86. Unzip and run — no installer. Licensed under Apache 2.0; free for personal and commercial use.