logHunter
一个强大的 VSCode 插件，用于在项目中搜索关键词并使用颜色高亮显示结果。支持多配置文件管理、灵活的搜索选项、链式搜索和直观的结果展示。
功能特性
- 多配置文件管理 - 创建和管理多个关键词配置文件（Profile），不同项目可使用不同的关键词集合
- 灵活的关键词配置 - 为每个关键词设置自定义颜色和搜索选项
- 强大的搜索选项 - 支持大小写敏感、全词匹配、正则表达式模式
- 链式搜索 - 使用正则表达式提取关键词，然后进行二次搜索
- 关键词启用/禁用 - 快速切换关键词的激活状态，无需删除
- 自定义搜索结果视图 - 专用的搜索结果编辑器，带有语法高亮和颜色标记
- 快速导航 - 双击搜索结果即可跳转到源文件的对应位置
- 智能颜色对比 - 自动根据背景颜色调整文字颜色（黑色/白色）以确保可读性
- 搜索结果去重 - 同一行的重复结果自动合并
- 高效搜索 - 使用 ripgrep 进行快速文件搜索，支持并发处理
安装
从 VSCode 扩展市场安装：
- 打开 VSCode
- 点击左侧活动栏的扩展图标
- 搜索 "logHunter"
- 点击安装按钮
使用方法
侧边栏说明
logHunter 在侧边栏提供三个独立的面板：
- Profiles - 管理所有配置文件（Profile）
- Keywords - 显示当前激活配置文件中的关键词
- Chained Keywords - 显示当前激活配置文件中的链式关键词
1. 创建配置文件（Profile）
- 点击侧边栏的 logHunter 图标
- 在 Profiles 面板中，点击工具栏的
+ 按钮
- 输入配置文件名称
- 新配置文件会自动激活
2. 添加关键词
- 确保已在 Profiles 面板选中要使用的配置文件
- 在 Keywords 面板中，点击工具栏的
+ 按钮
- 输入关键词
- 选择一个高亮颜色（支持自定义颜色）
3. 链式搜索（Chained Search）
链式搜索允许你使用两个步骤来搜索复杂的日志模式：
- 第一步：提取关键词 - 使用正则表达式从日志中提取关键词
- 第二步：搜索关键词 - 使用提取的关键词进行正常搜索
添加链式关键词
- 在 Chained Keywords 面板中，点击工具栏的
+ 按钮
- 填写以下信息：
- 名称：链式关键词的显示名称
- 提取正则：用于提取关键词的正则表达式
- 替换模式：使用
$1, $2 等引用捕获组的替换模式
- 颜色：高亮颜色
- 大小写敏感：是否区分大小写
示例
假设你有以下 Android 崩溃日志：
10813 10532 E AndroidRuntime: FATAL EXCEPTION: main
10814 10533 E AndroidRuntime: Process: com.example.app, PID: 10813
你可以配置链式搜索：
- 提取正则：
(\d+)\s+(\d+)\s+E\s+AndroidRuntime:.*FATAL
- 替换模式：
$1 $2 E AndroidRuntime:
这会提取出 10813 10532 E AndroidRuntime:，然后用这个文本进行搜索。
提取关键词查看
当链式搜索执行时，提取的关键词会显示在 VSCode 的输出面板中：
- 点击菜单：
查看 → 输出
- 在输出面板右侧下拉菜单中选择：
logHunter
- 你会看到类似以下内容：
========================================
Chained Search: 你的链式关键词名称
Extracted 3 keywords:
Pattern: (\d+)\s+E\s+AndroidRuntime: → $1
----------------------------------------
1. 10813
2. 10532
3. 10814
========================================
这可以帮助你验证提取规则是否正确工作。
4. 编辑关键词
普通关键词
在 Keywords 面板中，右键点击关键词可选择：
- Toggle Keyword - 启用/禁用关键词
- Change Color - 更改高亮颜色
- Toggle Case Sensitive - 切换大小写敏感
- Toggle Whole Word - 切换全词匹配
- Toggle Regex - 切换正则表达式模式
- Delete Keyword - 删除关键词
链式关键词
在 Chained Keywords 面板中，右键点击链式关键词可选择：
- Toggle Chained Keyword - 启用/禁用链式关键词
- Edit Chained Keyword - 编辑链式关键词配置
- Delete Chained Keyword - 删除链式关键词
- Search Chained Keyword - 单独搜索此链式关键词
5. 搜索关键词
- 确保已打开一个文件夹或工作区
- 点击任意面板中的搜索按钮（放大镜图标）
- 等待搜索完成
- 普通关键词会直接搜索
- 链式关键词会先提取关键词，然后进行搜索
- 查看搜索结果面板，所有结果会显示在同一个窗口中
- 双击任意结果行即可跳转到源文件的对应位置
注意：
- 只有启用的普通关键词和链式关键词会被搜索
- 搜索结果会合并显示在同一个窗口中
- 链式搜索会先提取关键词，提取的关键词会显示在输出面板中
6. 管理配置文件
在 Profiles 面板中：
- 切换配置：点击非活跃的配置文件名称，或右键选择 "Switch to Profile"
- 重命名配置：右键点击配置文件，选择 "Rename Profile"
- 删除配置：右键点击配置文件，选择 "Delete Profile"
- 创建新配置：点击工具栏的
+ 按钮
7. 搜索选项说明
普通关键词选项
- Case Sensitive（大小写敏感）：区分大小写进行匹配
- Whole Word（全词匹配）：只匹配完整的单词
- Regex（正则表达式）：使用正则表达式模式进行高级匹配
链式关键词选项
- 提取正则：用于匹配和提取内容的正则表达式
- 使用括号
() 创建捕获组
- 例如：
(\d+)\s+(\d+)\s+E\s+AndroidRuntime:.*FATAL
- 替换模式：使用捕获组组成搜索关键词
- 使用
$1, $2, ... 引用捕获组
- 例如：
$1 $2 E AndroidRuntime:
- 大小写敏感：提取时是否区分大小写
许可证
MIT License
版本历史
- v1.3.0 - 新增链式搜索功能，支持正则提取和二次搜索
- v1.2.0 - 分离 Profiles 和 Keywords 面板，优化侧边栏布局
- v1.1.0 - 使用 ripgrep 进行高性能搜索，优化搜索性能
- v1.0.0 - 初始版本发布
| |
