XLogger 使用指南 — 手把手教你玩转日志速查

XLogger 是一款纯前端、即开即用的 Android 日志速查工具：在浏览器里打开网页，选择或拖入日志文件，即可按关键词、时间、级别等条件过滤，并支持多色高亮、在当前结果中搜索、查看原始上下文和 AI 分析。所有解析与过滤都在本地完成，日志不会上传，无泄露风险。 支持电脑与手机浏览器使用。

下面按真实使用顺序，从打开页面到看完日志，一步步说明每个功能怎么用。

一、打开页面与整体布局

1. 用浏览器打开 XLogger 的访问地址（例如部署后的域名或本地开发地址）。

2. 页面大致分为：

- 顶部：标题栏（XLogger 简介）。

- 左侧：文件管理 + 规则列表（可收起，见后文）。

- 中间偏右：过滤条件栏 → 工具栏 → 日志展示区（上：原始日志上下文，下：过滤后日志）。

- 底部：状态栏（已选文件数、当前关键词/TAG 等）。

首次使用时左侧会显示「暂无文件」，需要先添加日志。

二、添加日志文件（第一步：把日志“放进”工具）

所有操作在左侧「文件管理」区域完成。

2.1 上传单个或多个文件

• 点击 「选择文件」，在弹窗中选一个或多个 .log / .txt 文件，确认后会自动解析并加入列表。
• 若选中的文件名已存在，会提示是否覆盖；选「确定」则用新文件覆盖旧数据。

2.2 上传整个文件夹

• 点击 「选择文件夹」，选中一个文件夹。
• 会将该文件夹内支持的日志文件（如 .log、.txt）全部加入并解析，适合一次导入多份日志。

2.3 拖拽上传

• 将本地的一个或多个日志文件（或文件夹）直接拖进左侧文件管理区域，松手即可。
• 支持与「选择文件」相同的格式，拖入后同样会解析并加入列表。

2.4 压缩包（.zip / .tgz / .tar.gz / .gz）

• 支持直接选择或拖入压缩包。
• 工具会流式解压，自动识别其中的日志类文本文件并逐个解析、加入列表；非日志文件会跳过。

2.5 文件列表与勾选

• 文件按日志时间（或修改时间）排序显示，可勾选/取消勾选。
• 底部状态栏会显示「已选择 N 个文件」；只有被勾选的文件会参与后续的过滤与展示。
• 可点击某一行的 × 删除该文件；使用「删除全部」会清空所有文件（有二次确认）。

添加并勾选好文件后，中间主区域会显示这些文件的汇总日志；接下来用「规则」或「过滤条件」缩小范围。

三、规则列表（可选：一键套用常用过滤）

规则用来保存常用关键词（或 TAG 等），点一下就能应用到过滤条件，无需每次手输。

3.1 使用已有规则

• 在左侧 「规则列表」 中，每条规则显示：名称、TAG/关键词、描述。
• 点击某条规则：会将该规则的「关键词」填入过滤条件并立即生效，主区域会显示按该关键词过滤后的日志；当前选中的规则会高亮。

3.2 新增一条规则

• 点击规则列表标题右侧的 「+」。
• 在出现的表单中填写：

- 分析类型/名称：如「语音 Trace」。

- TAG（支持正则）：如 SpeechTrace 或正则表达式。

- 描述：可选，方便以后辨认。

• 点击 「保存」 写入；若名称与已有规则重复，会提示「已存在同名规则」，需改名称后再保存。

3.3 编辑与删除规则

• 每条规则右侧有 铅笔（编辑） 和 ×（删除）。
• 编辑：点铅笔，改完名称/TAG/描述后点「保存」。
• 删除：点 ×，确认后即删除。

3.4 导入 JSON 规则（批量）

• 点击 「导入JSON」，会弹出输入框。
• 在输入框中粘贴 JSON 数组，每项需包含 name、tag、description（可为空），例如：

```json

[

{ "name": "规则A", "tag": "TAG1", "description": "描述A" },

{ "name": "规则B", "tag": "TAG2", "description": "" }

]

```

• 选择：

- 追加：在现有规则后面新增，与已有规则同名的会跳过并在弹框内提示。

- 替换：先清空当前所有规则，再写入 JSON 中的规则。

• 保存后列表会刷新，规则即可像上面一样点击使用。

四、设置过滤条件（第二步：缩小要看的日志范围）

过滤条件在主区域顶部的「过滤条件栏」里设置；支持关键词、排除词、时间、级别、PID/TID、上下文行数等。设置完后要点 「搜索」 才会生效。

4.1 搜索关键词（主过滤）

• 在 「搜索关键词（支持多行，Ctrl+Enter 搜索）」 输入框中输入一个或多个关键词（每行一个）。
• Ctrl+Enter 可快捷应用当前过滤并搜索。
• 右侧两个小按钮：

- Aa：点击切换「大小写敏感」；右键点击切换「全字匹配」。

- 正则：点击开启/关闭「正则表达式」；开启后关键词按正则解析（如 error|warn 表示匹配 error 或 warn）。

• 输入框右侧 × 可清空关键词。

4.2 排除关键词

• 在 「排除:」 后的输入框里填写不希望出现的词；符合「搜索关键词」但包含「排除关键词」的日志行会被过滤掉。

4.3 时间范围

• 开始时间 / 结束时间：格式为 MM-DD HH:mm:ss.SSS（如 12-15 17:36:57.935），只保留该时间范围内的日志。
• 分钟 + 「时间差」：填好一个开始或结束时间，再填分钟数，点「时间差」可自动算出另一个时间，方便按“某时刻前后 N 分钟”筛选。

4.4 日志级别

• 点击 V / D / I / W / E 可多选；只显示所选级别的日志。再次点击同一级别可取消选择。

4.5 PID / TID

• 在 PID、TID 输入框中填入数字，可只显示对应进程/线程的日志。

4.6 上下文行数

• 上下文(行数) 中的「前」「后」表示：在每条命中日志的前/后各带出多少行一起显示（用于看前后文），如前 5 后 5。

4.7 应用与清除

• 设置好上述任意条件后，点击 「搜索」 按钮（或关键词框内 Ctrl+Enter）应用过滤，主区域下方会显示过滤后的日志。
• 若有任意已应用的条件，会出现 「清除」 按钮，点击可一键清空所有过滤条件。

五、查看过滤后的日志（主区域下半部分）

过滤生效后，主区域下半部分会显示「过滤后日志」列表，并带有关键词颜色图例和在当前结果中搜索。

5.1 过滤结果列表

• 每条日志以行形式展示（时间、PID、TID、级别、TAG、内容等）。
• 若过滤关键词是正则且含有 |（如 A|B|C），不同子表达式会对应不同颜色：顶部图例会标出「关键词颜色：」与各子式的颜色，列表中匹配到的片段会以对应颜色的背景标出。

5.2 在当前结果中搜索（仅标记、不减少行）

• 同一行右侧有 「在当前结果中搜索（仅标记）……」 输入框。
• 输入内容后，不会再过滤掉任何行，只会在当前已显示的日志中：

- 把匹配到的文字用红色背景标出；

- 右侧 「上一个」「下一个」 会在这些命中之间跳转并滚动到对应行（仅滚动下方列表，页面不跳动）。

• 右侧会显示当前命中序号，如 2/5。

5.3 关键词颜色图例与搜索栏同一行

• 「关键词颜色」图例与「在当前结果中搜索」、上一个/下一个、序号在同一行：左侧是图例（关键词多时可横向滚动，不压过输入框），右侧固定是搜索框和按钮。

六、查看原始日志上下文（主区域上半部分）

主区域上半部分是「原始日志上下文」：用来看某一行过滤结果在原始文件里前后的完整内容。

6.1 如何看到上下文

• 在下方「过滤后日志」列表中点击某一行。
• 上方会展示该行对应文件中的整份原始日志，并自动定位到该行（直接跳转，无长滚动动画）。
• 便于确认时间顺序、前后代码或其它线程的日志。

6.2 收起/展开原始日志区域

• 展开时：中间有一条可拖拽的分隔条，右侧有 「收起原始日志」 按钮；点击后上方区域收起，下方过滤结果区域会变大，方便专注看过滤结果。
• 收起后：中间会变成 「展开原始日志」 按钮；点击即可重新展开上方区域。
• 分隔条支持鼠标拖拽或触摸拖拽调整上下比例；拖拽时无过渡动画，松手后比例即固定。

七、主区域工具栏（搜索、折行、复制、导出）

在「过滤条件栏」下方、日志区域上方，有一排工具栏：

7.1 搜索日志内容（过滤显示的行）

• 「搜索日志内容……」：在此输入词后，会在当前已过滤出的日志行中再做一次筛选，只保留内容/标签/原始行中包含该词的行（可理解为“在结果里再搜一次”）。
• 右侧 ↑ / ↓ 为「上一个」「下一个」命中，方便在结果间跳转；旁边数字为当前匹配到的行数。

7.2 折行

• 折行 按钮：开启后，过长日志行会自动换行，避免横向滚动。

7.3 统计与复制、导出

• 总计 / 过滤 / 显示：分别表示「总条数」「过滤后条数」「当前显示条数」（若用了「搜索日志内容」则显示会 ≤ 过滤）。
• 复制：复制当前显示的全部日志（原始行文本）到剪贴板。
• 导出：将当前显示的全部日志下载为一个 .txt 文件。

八、左侧面板的收起与展开

• 左侧「文件管理 + 规则列表」占一定宽度；若希望主区域更宽，可点击左侧边缘的 ◀ / ▶ 按钮。
• ◀：收起左侧面板，只保留一条竖条和箭头。
• ▶：再次点击可展开左侧面板，恢复文件管理与规则列表。

九、AI 分析（可选）

• 右下角有 「AI 分析」 按钮。
• 在已选择文件并应用过滤后，点击可打开 AI 分析面板，基于当前选中的文件 + 当前过滤结果进行智能分析（需配置后端或 API）；具体能力以实际接入的 AI 服务为准。

十、底部状态栏

• 底部会显示：

- 已选择 N 个文件；

- 当前生效的关键词、TAG（若有）。

• 便于随时确认「当前在看哪些文件、用什么条件过滤」。

使用场景速览

小结

XLogger 的前端功能按使用顺序可以概括为：

1. 左侧：添加/管理文件（选文件、选文件夹、拖拽、压缩包）→ 可选使用规则列表（点击规则、新增、编辑、删除、导入 JSON）。

2. 顶部过滤区：设关键词、排除、时间、级别、PID/TID、上下文 → 点「搜索」应用。

3. 主区域：上看「原始日志上下文」（点下方某行即定位）、下看「过滤后日志」；可收起上方以放大下方；中间条可拖拽或触摸调整比例。

4. 过滤结果区：关键词多色高亮、在当前结果中搜索（红底标记 + 上一个/下一个）、关键词图例与搜索同一行。

5. 工具栏：搜索日志内容、折行、复制、导出。

6. 左侧可收起以腾出空间；右下角可进行 AI 分析（若已配置）。

所有解析与过滤均在本地完成，日志不离开本机，适合对隐私和合规有要求的团队使用。支持电脑与手机浏览器，触摸操作（如拖拽分隔条、收起/展开）均已适配。