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

14 KiB
Raw Permalink Blame History

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开头)
  1. 查看分析 - 工具自动解析并显示统计信息

移动设备使用

  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 版本