bettergi-scripts-list/repo/js/日志分析工具/README.md
this-Fish fb9fe10ee8
日志分析工具20260913 (#3653)
* 日志分析工具20260913

* Add files via upload
2026-09-14 09:53:15 +08:00

368 lines
No EOL
14 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# BetterGI 日志分析工具
一个用于分析 Better Genshin Impact 自动化工具日志的网页工具,支持拖放操作、多种显示模式和丰富的快捷键功能。
**在线地址**: https://this-fish.github.io/Read_BetterGI_Log/index.html
## 🌟 核心功能
### 日志解析
- 📁 **拖放分析** - 直接拖拽日志文件到页面即可分析
- 📱 **移动端支持** - 手机/平板设备专用上传界面
- 🔄 **多文件合并** - 自动按时间顺序合并多个日志文件
- ⏰ **智能时间解析** - 自动处理跨日日志和时间推算
### 数据可视化
- 📊 **详细统计** - 复活次数、重试次数、卡死点坐标等完整数据
- 🎯 **坐标追踪** - 查看死亡前最近的X/Y轴坐标
- ⚡ **实时高亮** - 鼠标悬停行高亮,清晰指示当前查看行
- 🌓 **主题切换** - 自动/手动切换亮色/暗色主题(00:00~06:30时自动暗色主题)
### 交互功能
- ⌨️ **丰富快捷键** - 20+个快捷键覆盖所有操作
- 🔍 **智能筛选** - 按任务名称关键字筛选显示
- 📈 **数据聚焦** - 隐藏零统计任务,专注问题分析
- 📤 **导出分享** - 静态模式方便截图和分享分析结果
## 🚀 快速开始
### 基本使用
1. **打开工具** - 访问上述在线地址
2. **上传日志** - 拖放BetterGI日志文件(文件名以`better-genshin-impact`开头)
- BetterGI日志文件所在位置如下
- C:\你BGI所安装的目录\BetterGI\log
- 或使用BGI打开目录
- <img width="905" height="599"src="https://github.com/user-attachments/assets/615087a5-eead-4eb8-8028-4bfe74d9b8ff" />
3. **查看分析** - 工具自动解析并显示统计信息
### 移动设备使用
1. 点击"选择日志文件"按钮
2. 选择日志文件后自动解析
3. 使用底部功能按钮控制显示选项
## ⌨️ 快捷键大全
### 显示控制
| 快捷键 | 功能说明 | 状态指示 |
|--------|----------|----------|
| `T` | 切换时间列显示/隐藏 | 右下角提示 |
| `Y` | 切换统计列显示/隐藏 | 右下角提示 |
| `U` | 切换表格格式(新版/旧版) | 右下角提示 |
| `I` | 切换拾取物列显示/隐藏 | 右下角提示 |
| `J` | 隐藏/显示零统计任务 | 右下角提示 |
| `H` | 任务名称/配置组筛选(支持排除配置组) | 左上角提示 |
| `P` | 进入/退出导出模式 | 左上角提示 |
| `[` | 进入/退出自由编辑网页模式 | 无 |
| `数字键4` | 只显示指定时间范围内的日志记录 | 左上角提示 |
### 视图操作
| 快捷键 | 功能说明 |
|--------|----------|
| `~` | 切换亮色/暗色主题 |
| `R` | 重置所有弹窗位置 |
| `W` | 页面上滚 |
| `S` | 页面下滚 |
| `G` | 打开/关闭配置组导航 |
| `Alt + F` | 切换全屏模式 |
| `.` | 新标签页打开工具 |
| `Alt + L` | 显示/隐藏功能按钮区 |
| `F2` | 快速打开上传文件 |
### 计算工具
| 快捷键 | 功能说明 |
|--------|----------|
| `6` | 计算原神下次60体力时间 |
| `7` | 计算原神下次40体力时间 |
| `8` | 计算自定义体力时间(输入:现在体力,目标体力,体力CD分钟) |
| `9` | 计算时间距离现在多久 |
| `右2` | 计算日期+3天 |
| `右3` | 计算两个时间点间隔 |
| `右5` | 计算N天后的日期 |
| `右7` | 计算原神下次120体力时间 |
| `右8` | 计算HH.MM后的时间 |
| `右9` | 计算时间+46小时后 |
| `M` | 统计指定拾取物拾取数量 |
### 排序与筛选
| 快捷键 | 功能说明 |
|--------|----------|
| `Alt + I` | 切换拾取物显示顺序(按数量合并/按拾取顺序) |
| `O` | 进入拾取效率模式(计算指定拾取物的秒/个效率) |
| 点击“开始时间”旁边的排序按钮(↓) | 切换按读取顺序 / 按时间排序(最近的在前) |
| 点击“耗时”旁边的排序按钮(↕) | 切换耗时升序 / 降序 |
| `ESC` | 在快速导航/筛选模式中退出 |
| `H`(在筛选模式中) | 退出筛选模式 |
> **排序按钮图标含义**:
> - **↓**:按读取顺序(默认)
> - **↑**:按时间排序(最近在前)
> - **↕**:未激活状态,点击后进入耗时排序
> - **↑(耗时列)**:耗时升序(小到大)
> - **↓(耗时列)**:耗时降序(大到小)
### 鼠标操作
| 操作 | 功能说明 |
|------|----------|
| 点击配置组标题 | 折叠/展开该配置组 |
| 点击坐标单元格 | 固定/取消固定坐标弹窗 |
| 双击坐标单元格 | 重置弹窗位置到单元格中间 |
| 拖拽弹窗标题栏 | 移动弹窗位置(拖拽时自动固定) |
| 点击弹窗关闭按钮(×) | 关闭弹窗 |
## 📊 数据列说明
### 基本信息
- **任务名称** - 地图追踪任务或脚本名称
- **开始时间** - 任务开始执行的时间
- **结束时间** - 任务完成或中断的时间
- **耗时** - 任务执行总时长
### 统计指标
- **复活次数** - 前往七天神像复活的次数(红色≥2次)。
- **小数-0.9表示**:当前角色血量过低、返回七天神像回血
- **重试次数** - 路线重试次数(红色≥2次)
- **注意**:当只有重试次数而无卡死或复活时,任务名称会变为红色
- **疑似卡死** - 卡死脱离尝试次数(可查看坐标)
- **过远跳过** - 距离过远跳过的路径点(红色≥2次)
- **战斗超时** - 战斗超时次数(红色≥1次)
- **传送失败** - 传送失败重试次数(红色≥3次)
### 交互功能
- **悬停查看** - 鼠标悬停统计数字显示详细信息
- **双击重置** - 双击单元格重置弹窗位置
- **点击固定** - 点击单元格固定/取消固定弹窗
## 🎯 高级功能
### H键 - 任务筛选模式
```
输入格式:包含关键字(多个用逗号分隔) /- 排除配置组关键字(多个用逗号分隔)
示例:蒙德,璃月/-钓鱼,采集 (包含「蒙德、璃月」,排除配置组名称含「钓鱼、采集」的配置组)
只排除:/-钓鱼,采集
只包含:蒙德,璃月
```
- 使用 `/-` 分隔包含和排除部分
- 多关键字逗号分隔,不区分大小写
- 筛选时自动隐藏所有拾取物行
- 左上角显示当前筛选状态
### O键 - 拾取效率模式
按下 `O` 键后,输入要计算效率的拾取物名称(多个用逗号分隔,如 `甜甜花,薄荷`),工具将:
- 计算每个任务中指定拾取物的总数量
- 按 **“秒/个”** 的效率排序(效率高的排在前)
- 在耗时列下方显示具体数值(如 `3.5秒/1个`)
- 没有拾取物的任务排在后,不显示效率
再次按 `O` 键退出效率模式,恢复原排序。
### 数字键4 - 时间筛选模式
按下数字键4后,会显示两个时间输入框:
第一个输入框(开始时间):留空则默认为当天00:00:00
第二个输入框(结束时间):默认为当前时间
时间格式要求:2026/01/22 18:59:00
- **功能说明**:仅显示指定时间范围内的日志记录
- **主要用途**:配合`M`键统计指定时间内的拾取物数量
- **注意事项**:与`H`键筛选功能冲突,不能同时使用
- **退出方式**:再次按下`数字键4`键或`H`键退出时间筛选模式
### J键 - 零统计任务隐藏
- 自动隐藏所有异常统计值为零的任务
- 帮助聚焦有问题任务
- 与筛选模式协同工作
### P键 - 导出静态模式
- 所有弹窗内容内联显示
- 方便截图和保存分享
- 使用浏览器"另存为"功能导出
### G键 - 配置组导航功能
- **快速访问** - 按G键或点击右上角「📋 导航」按钮打开导航面板
- **智能搜索** - 输入配置组名称关键词实时筛选匹配项
- **排除搜索** - 在“排除配置组...”输入框中输入关键词,可隐藏不想看到的配置组
- **总时长统计** - 导航面板底部显示当前可见配置组的累计耗时
- **精准跳转** - 点击搜索结果直接滚动到对应配置组位置
- **便捷控制** - 点击右上角开关按钮或按ESC键关闭导航
#### 操作指引
1. **开启导航** - 按 `G` 键或点击页面右上角「📋 导航」按钮
2. **搜索目标** - 在搜索框输入配置组名称(支持部分匹配)
3. **排除干扰** - 在排除框输入关键词,隐藏不关注的配置组
4. **快速跳转** - 从搜索结果列表中选择要查看的配置组
5. **关闭面板** - 点击右上角导航开关或按 `ESC` 键退出
---
## 🔧 高级设置
### URL 参数控制初始状态
您可以通过在网址后添加参数来预设工具的初始状态(所有参数大小写兼容):
| 参数 | 说明 | 示例 |
|------|------|------|
| `C=1` | 强制暗色主题(优先级高于自动时间判断) | `index.html?C=1` |
| `C=0` | 强制亮色主题 | `index.html?C=0` |
| `LBox=true` | 在电脑端强制显示上传功能按钮区(默认隐藏) | `index.html?LBox=true` |
多个参数可以组合使用,例如:`index.html?C=1&LBox=true`
---
## 🎨 界面说明
### 表格格式
**旧版格式**(默认)
- 单行显示完整任务信息
- 适合详细数据分析
**新版格式(BGI现版格式)**(按U切换)
- 任务信息分两行显示
- 适合快速浏览
### 特殊事件检测
工具自动检测并标记以下种特殊事件,按错误类型分类:
| 事件类型 | 颜色标记 | 事件说明 |
|----------|----------|----------|
| **自动恢复事件** | | |
| 自动吃药恢复 | 🟢 绿色 | 自动处理红血状态 |
| 自动领取派遣任务 | 🟠 橙色 | 正常功能执行 |
| **暂停与中断事件** | | |
| 快捷键暂停 | 🟣 粉色 | 用户手动暂停 |
| 窗口焦点异常 | 🟣 粉色 | 游戏窗口失去焦点 |
| 切换区域失败 | 🟣 粉色 | 游戏区域切换失败 |
| **用户配置错误** | 🔧 | |
| 路径文件丢失 | 🔴 红色 | 配置文件缺失 |
| 未匹配战斗脚本 | 🔴 红色 | 战斗脚本配置错误 |
| 战斗策略错误 | 🔴 红色 | 策略脚本语法错误 |
| 缺少元素采集角色 | 🔴 红色 | 队伍缺少对应元素角色 |
| 缺少纳西妲角色 | 🔴 红色 | 队伍缺少纳西妲角色 |
| **BGI运行时错误** | 🐛 | |
| 队伍角色识别失败 | 🔴 红色 | 角色识别功能异常 |
| 未能返回主界面 | 🔴 红色 | 界面导航失败 |
| 切换队伍失败 | 🔴 红色 | 队伍切换功能异常 |
| 自动重启bgi | 🔴 红色 | 调度器任务出现未预期的异常,自动重启bgi |
| **网络与地图问题** | 🌐 | |
| 打开地图失败 | 🔴 红色 | 地图功能异常 |
| 传送点不存在 | 🔴 红色 | 传送点识别问题 |
| 识别大地图失败 | 🔴 红色 | 地图定位失败 |
| **用户主动操作** | 👤 | |
| 脚本异常结束 | 🔴 红色 | 任务被异常中断 |
| **其他** | | |
| 缺少脚本指定角色 | 蓝紫色 | 路径中的简易策略脚本存在着队伍中没有的角色的提示 |
**计数显示**:同一事件多次发生时会显示次数,如"快捷键暂停 (3)"
## 📱 移动端适配
### 专用界面
- 触摸友好的大按钮设计
- 自适应屏幕尺寸的布局
- 简化的操作流程
### 功能按钮区
6个核心功能按钮:
1. 🌓 主题切换
2. ⏰ 时间列控制
3. 📊 统计列控制
4. 📦 拾取物控制
5. 📤 导出模式
6. 🔍 异常任务筛选
## 🔧 技术规格
### 支持格式
- **日志版本**: BetterGI 0.64.0
- **文件命名**: `better-genshin-impact` 开头
- **日期识别**: 自动从文件名解析日期
- **编码支持**: UTF-8 文本格式
### 性能特性
- 💾 客户端本地处理,无数据上传
- 📈 虚拟滚动支持大数据量
- 🔄 实时响应式布局
## ❓ 常见问题
### 数据解析问题
**Q: 为什么有些任务显示"进行中"?**
A: 日志中任务没有正常结束记录,可能是脚本被中断。
**Q: 坐标信息为什么有时缺失?**
A: 只有在卡死或复活前有坐标记录时才会显示。
**Q: 时间显示异常怎么办?**
A: 工具会自动处理跨日情况,如仍有问题请检查日志完整性。
### 功能使用问题
**Q: 如何分享分析结果?**
A: 使用P键进入导出模式,然后用浏览器"另存为"保存HTML文件。或截图分享
**Q: 筛选模式如何退出?**
A: 再次按下H键即可退出筛选模式。
**Q: 弹窗位置乱了怎么办?**
A: 按R键重置所有弹窗位置,或双击单元格重置单个弹窗。
### 移动端问题
**Q: 手机上传文件失败?**
A: 确保文件命名格式是`better-genshin-impact日期.log`。
**Q: 移动端按钮显示不全?**
A: 横屏模式可获得更好体验。
## 📋 更新日志
### 20260913
- 修改重试次数觸發羅輯
- 補充 41.执行脚本时发生异常: "Index was outside the bounds of the array."觸發條件
### 20260912
- 增加錯誤&其他訊息
- 加入黑名单(鋤地一條龍)
- 执行地图追踪时候发生错误: "不存在的角色编号"
### 20260909
- 增加了一些功能
### 20260908
- 增加錯誤&其他訊息
- 执行脚本时发生异常: "Index was outside the bounds of the array."
### 20260904
- M鍵 统计拾取物 支援 全角逗号、英文逗号、空白字符
- 增加錯誤&其他訊息
- 视角转动超时
### 20260903
- 适配部分日志
- 检测路线文件格式错误(鋤地一條龍2.13.0)
### 20260830
- 适配部分BGI0.64.0日志
- 38.已达到总运行限时(采集CD管理3.1.0)
### 20260829
- 修改"路线多次卡死,放弃此路线!警告"觸發羅輯
- 适配部分BGI0.64.0日志
- 队伍資訊增加 是否有開啟光柱拾取模式
### 20260808、20260809、20260824
- 适配部分BGI0.63.0日志
### 20260801
- 适配部分日志
- 检测到复苏按钮,点击 or 复苏完成
### 20260730
- 终点坐标异常,不记录放入J键隐藏零统计被隐藏關鍵字中
- 适配部分日志
- 接近限制时间,等待X分钟
*更早版本包含基础日志解析和显示功能及其他功能*
## 📞 技术支持
### 注意事项
- 🔒 工具完全在浏览器本地运行,无数据上传
- 📝 仅支持简体模式下所输出的BetterGI日志档
- ⚠️ 分析结果仅供参考,不保证100%准确
---
*最后更新: 2026-09-13*
*适配 BetterGI 0.64.0 版本*