Genshin Impact祈愿记录导出工具技术解析

工具概述

Genshin Impact Wish History Exporter是一款基于Electron框架开发的Windows 64位应用程序，专门用于提取和保存《原神》游戏中的祈愿历史记录数据。该工具通过两种方式获取游戏数据：解析游戏日志文件或通过代理方式获取认证密钥(authKey)，进而访问游戏官方的祈愿历史API接口。

核心功能解析

数据获取机制

1. 认证密钥获取：

   • 通过监控游戏日志文件自动提取authKey
   • 或采用代理方式拦截游戏通信获取认证信息

2. API数据请求：

   • 使用获取的authKey向米哈游官方API发起请求
   • 按分页方式获取完整的祈愿历史记录

3. 数据存储方案：

   • 自动将数据保存在工具所在目录的userData文件夹中
   • 采用增量更新机制，新获取的数据会与本地已有记录智能合并

多语言支持

工具内置国际化方案，所有界面文本存储在src/i18n目录下的JSON文件中。开发者可以：

1. 通过修改对应语言的JSON文件实现界面翻译
2. 支持随时提交翻译修正
3. 自动根据系统语言选择显示文本

数据恢复功能详解

对于已有Excel格式祈愿记录的用户，可通过在线服务转换为工具兼容的JSON格式：

1. 转换服务提供以下核心功能：

   • Excel到JSON格式转换
   • 基于结束日期去重处理
   • UID验证确保数据准确性

2. 使用流程：

   • 上传Excel文件并填写正确UID
   • 选择Excel使用的语言版本
   • 下载转换后的JSON文件
   • 将文件放入工具的userData目录即可恢复数据

使用指南

基础使用步骤

1. 环境准备：

   • 下载工具压缩包并解压
   • 确保系统为Windows 64位环境

2. 数据获取：

   • 启动《原神》游戏客户端
   • 打开游戏内的祈愿历史页面
   • 运行工具点击"Load data"按钮

3. 结果查看：

   • 成功获取数据后会显示完整祈愿统计
   • 包含各卡池的抽卡分布和概率分析

多账号管理

工具支持同时管理多个游戏账号数据：

1. 点击界面上的"+"按钮创建新账号槽位
2. 切换游戏账号并打开祈愿页面
3. 在对应槽位点击加载按钮
4. 各账号数据独立存储互不干扰

开发指南

环境搭建

1. 安装Node.js环境
2. 使用yarn安装依赖：

   yarn install
   

开发命令

• 开发模式运行：

  yarn dev
  

• 生产环境构建：

  yarn build
  

技术架构

1. 前端框架：Electron + Vue.js
2. 通信协议：HTTPS API调用
3. 数据格式：JSON结构化存储
4. 构建工具：Webpack

安全提示

1. 所有数据仅在本地处理，不会上传至任何服务器
2. authKey仅在内存中使用，不会长期存储
3. 建议仅从可信来源获取工具程序

典型问题解决方案

1. 数据加载失败：

   • 确认游戏祈愿页面已打开
   • 检查网络连接是否正常
   • 尝试重启工具和游戏客户端

2. 数据显示不全：

   • 多次点击加载按钮确保获取全部分页
   • 检查userData目录是否有写入权限

3. 多账号切换：

   • 确保每个槽位对应不同的游戏账号
   • 切换账号后刷新游戏祈愿页面

该工具为《原神》玩家提供了便捷的祈愿记录分析和存档功能，通过技术手段实现了游戏数据的本地化管理和可视化展示，是进行抽卡概率分析和历史记录保存的理想选择。