Skip to content

Latest commit

 

History

History
142 lines (97 loc) · 8.08 KB

README.md

File metadata and controls

142 lines (97 loc) · 8.08 KB

OODD.LogTailMonitor

一款 Windows 桌面日志查看器:像 tail -f 一样盯住正在写入的日志文件,几百 MB 的文件也能打开就看见尾巴。为本地排障、值班盯盘和大文件翻阅而做。

暗色主题主界面

功能

大文件不等待

  • 首屏只读文件末尾,打开几百 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,增加一种语言就是多放一个词典文件。
  • 不收费、无广告、不联网、不收集信息,日志与配置全部留在本机。

浅色主题

下载

到 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
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 指向一个目录,所有配置与日志都会写进那里。

命令行

LogTailMonitor.exe "D:\logs\app.log" "D:\logs\gateway.log"

已启动时再执行,会把文件转发给现有窗口打开。

从源码构建

需要 Windows、.NET SDK 8,以及 WPF 桌面开发工作负载(Visual Studio 2022 可选)。

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 里的压缩包同口径:

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 文件,并说明你做出的修改即可。软件按「现状」提供,不含任何明示或暗示的担保。

随包发布的第三方库均为 MIT 等宽松许可,完整清单与主页链接见程序「工具 ▸ 关于」。

反馈

发现 bug 或有建议,请到 Issues 提交,附上系统版本、程序版本和复现步骤。

关于页


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: self-contained or framework-dependent, x64 or x86. Unzip and run — no installer. Licensed under Apache 2.0; free for personal and commercial use.