3步实现原神祈愿数据自由：从记录到分析的全功能工具指南

抽卡记录丢失？概率统计困难？多设备数据不同步？genshin-wish-export作为一款基于Electron开发的专业原神祈愿记录导出工具，通过双重数据采集机制、标准化格式处理和多维度可视化分析，为玩家提供从数据获取到决策支持的完整解决方案，让每一次抽卡都有迹可循。

核心功能解析

数据采集：双重机制保障记录完整 🔍

工具采用日志解析与代理捕获的双重数据获取方案，确保在不同游戏环境下都能稳定采集祈愿记录。日志解析模式通过读取游戏本地日志文件自动提取抽卡数据，适用于大多数常规场景；而代理模式则通过系统代理捕获API请求，解决特殊环境下的数据获取难题。

实操场景：当玩家启动工具后，程序会自动检测游戏安装路径，优先尝试通过数据获取核心模块读取游戏日志文件中的authKey信息。若日志解析失败（如日志文件损坏或权限问题），工具会自动切换至代理模式，通过系统代理捕获祈愿API请求，确保数据获取成功率。

数据标准化：UIGF规范确保跨工具兼容 📊

工具内置符合UIGF（通用祈愿数据格式）标准的处理引擎，将原始抽卡数据转换为标准化格式，支持与社区其他分析工具无缝对接。通过UIGF处理模块实现数据的导入导出，确保玩家数据在不同平台间自由流转。

实操场景：玩家可随时将采集的祈愿记录导出为UIGF格式文件，该文件可直接导入到Excel或其他数据分析工具中。同时，工具也支持导入其他来源的UIGF格式数据，实现多设备数据合并，保持记录的完整性和连续性。

数据可视化：直观呈现抽卡概率与趋势 📈

通过交互式图表直观展示抽卡统计数据，包括各卡池出货率、五星保底计算、抽卡周期分析等关键指标。玩家可通过可视化组件快速掌握自己的抽卡规律，为原石规划提供数据支持。

实操场景：在工具主界面，玩家可以清晰看到各类型卡池的五星、四星物品获取概率分布，系统会自动计算当前保底进度，并预测下次五星物品的获取所需抽数，帮助玩家制定更合理的抽卡策略。

多格式导出：满足不同分析需求 📑

支持将祈愿数据导出为Excel、JSON等多种格式，满足不同玩家的使用习惯。通过Excel导出模块生成的表格文件包含详细的抽卡时间、物品类型、星级等信息，便于深度数据分析。

实操场景：重度玩家可导出Excel文件进行离线分析，通过数据透视表功能追踪长期抽卡趋势；休闲玩家则可选择导出JSON格式文件进行备份，确保数据不会因设备更换而丢失。

技术透视

为什么选择Electron框架？

项目采用Electron框架开发，主要基于以下优势：首先，Electron允许使用Web技术栈（HTML/CSS/JavaScript）构建跨平台桌面应用，大大降低了开发成本；其次，Electron提供了丰富的系统API，能够实现日志读取、系统代理等底层操作，这对祈愿数据采集至关重要；最后，Electron应用可打包为Windows、macOS和Linux版本，满足不同平台玩家的需求。

多语言适配框架

工具支持13种语言界面切换，通过国际化配置实现界面文本、提示信息和导出内容的多语言支持。系统会根据用户系统语言自动选择合适的界面语言，也允许用户手动切换，确保全球玩家都能获得良好的使用体验。

玩家指南

快速上手三步骤

1. 安装与启动
   从项目仓库克隆代码：git clone https://gitcode.com/GitHub_Trending/ge/genshin-wish-export，安装依赖后启动应用，工具会自动检测游戏安装路径。

2. 数据采集
   点击主界面"获取数据"按钮，工具优先尝试日志解析模式。若失败，根据提示切换至代理模式，按指引完成代理设置后即可捕获祈愿数据。

3. 查看与导出
   数据采集完成后，在主界面查看抽卡统计图表，如需导出数据，点击"导出"按钮选择所需格式（Excel或UIGF JSON），文件将保存至系统下载目录。

高级功能解锁

多账号管理：通过界面顶部的账号切换功能，可管理多个游戏账号的祈愿记录，适合拥有多个角色的玩家。

自定义分析：在"设置"界面开启"高级统计"选项，可查看各角色/武器的获取时间分布、抽卡周期分析等深度数据。

数据备份与恢复：定期通过"备份数据"功能创建本地备份，更换设备时可通过"导入数据"功能恢复历史记录。

常见问题解决

Q1: 无法获取数据怎么办？
A1: 首先检查游戏是否正常关闭（需完全退出游戏），然后尝试重启工具。若问题依旧，切换至代理模式获取数据，具体步骤可参考官方文档docs/README.md。

Q2: 导出的Excel文件乱码如何解决？
A2: 这通常是由于Excel默认编码设置导致，可在导出时选择"UTF-8编码"选项，或使用WPS等其他表格软件打开文件。

Q3: 工具支持云同步吗？
A3: 当前版本暂不支持云同步功能，但可通过手动导出UIGF文件并保存至云盘实现数据备份，未来版本将考虑加入云同步功能。

适配不同类型玩家

休闲玩家：使用默认设置即可满足基本记录需求，定期导出Excel文件备份数据，无需复杂操作。

重度玩家：开启"自动同步"和"高级统计"功能，结合Excel深度分析抽卡规律，优化原石使用效率。

数据党：通过UIGF格式导出数据，结合Python或R语言进行自定义分析，挖掘抽卡概率背后的数学规律。

通过这款功能全面的原神祈愿记录工具，无论是普通玩家还是数据爱好者，都能轻松实现对祈愿数据的有效管理与深度分析，让每一颗原石都用在刀刃上。