genshin-wish-export跨平台数据导出全流程指南

genshin-wish-export是一款基于Electron开发的跨平台数据管理工具，专为原神玩家设计，支持在Windows、macOS和Linux系统上导出、分析祈愿记录，实现本地化数据管理与多终端同步。

功能解析：核心能力与技术原理

核心功能概览：从数据获取到分析呈现

genshin-wish-export通过两种方式获取游戏数据：读取本地游戏日志或通过代理模式捕获authKey，随后调用官方API获取完整祈愿记录。工具将数据存储在本地userData文件夹，支持自动合并更新，并提供可视化统计与多格式导出功能。

技术架构解析：本地数据安全保障

工具采用Electron框架实现跨平台运行，所有数据处理均在本地完成，不涉及云端存储。核心数据流程包括：日志解析/代理捕获→API请求→数据校验→本地存储→可视化展示。数据存储采用JSON格式，确保兼容性与可迁移性。

常见问题速解：若工具无法获取authKey，请确保原神已打开祈愿历史页面，网络连接正常。可尝试重启游戏和工具，或检查防火墙设置是否阻止工具网络访问。

场景化应用：新手友好的操作流程

快速上手：三步完成数据导出

准备工作：确保已安装原神客户端并登录账号，打开游戏内祈愿历史记录页面。

执行操作：

1. 启动genshin-wish-export工具
2. 点击主界面"更新数据"按钮
3. 等待数据加载完成后，点击"导出Excel"

验证结果：检查工具所在目录是否生成包含祈愿记录的Excel文件，文件命名格式为wish-history-YYYYMMDD.xlsx。

常见问题速解：导出的Excel文件为空？请确认游戏内祈愿历史已加载完毕，工具需要读取完整的历史记录页面数据。

多账号管理：切换与数据隔离

准备工作：确保已创建多个原神账号，并记住账号切换顺序。

执行操作：

1. 在工具主界面点击"+"按钮添加新账号配置
2. 切换至原神客户端，登出当前账号并登录新账号
3. 打开新账号的祈愿历史页面，返回工具点击"更新数据"

验证结果：在工具设置中查看账号列表，确认新账号数据已单独存储，切换账号时统计数据随之更新。

常见问题速解：切换账号后数据混乱？工具通过独立配置文件区分账号，若出现数据混合，可在userData目录手动重命名对应账号的JSON文件。

系统适配：环境准备与部署方案

环境准备：跨平台依赖配置

Windows系统：

• 准备工作：确保安装.NET Framework 4.5以上版本
• 执行操作：无需额外依赖，直接运行预编译版本

macOS系统：

• 准备工作：安装Xcode Command Line Tools
• 执行操作：xcode-select --install

Linux系统：

• 准备工作：安装Node.js (v14+)和依赖库
• 执行操作：

  → sudo apt update
  → sudo apt install nodejs npm libnss3 libgconf-2-4
  → sudo npm install -g yarn
  

常见问题速解：Linux下启动报错缺少依赖？使用ldd命令检查缺失的共享库，例如ldd Genshin-Wish-Export | grep not。

部署方案：源码构建与预编译版本选择

预编译版本（推荐新手）：

1. 访问项目发布页面下载对应系统版本
2. 解压至任意目录
3. 双击可执行文件启动

源码构建（开发者选项）：

1. 克隆项目仓库

   → git clone https://gitcode.com/GitHub_Trending/ge/genshin-wish-export
   

2. 安装依赖

   → cd genshin-wish-export
   → yarn install
   

3. 构建对应系统版本

   → yarn build:win64  # Windows
   → yarn build:mac     # macOS
   → yarn build:linux   # Linux
   

常见问题速解：构建失败？检查Node.js版本是否符合要求（v14+），删除node_modules目录后重新执行yarn install。

进阶技巧：高效管理与无缝迁移

数据备份策略：自动化与手动备份结合

准备工作：创建专用备份目录，建议使用云同步文件夹。

执行操作：

1. 自动备份：在工具设置中启用"自动备份"，设置备份频率
2. 手动备份：定期复制userData目录到安全位置，目录路径：
   • Windows: %APPDATA%/genshin-wish-export
   • macOS: ~/Library/Application Support/genshin-wish-export
   • Linux: ~/.config/genshin-wish-export

验证结果：检查备份目录是否包含最新的data.json和账号配置文件。

常见问题速解：备份文件过大？可删除logs子目录，仅保留数据文件。

跨平台数据同步：多终端一致体验

准备工作：确保所有设备已安装相同版本的工具，且网络可达同一文件共享服务。

执行操作：

1. 选择同步方案：云同步（如Dropbox）或本地网络共享
2. 将userData目录设置为同步文件夹
3. 在其他设备上配置相同的同步路径

验证结果：在不同设备上启动工具，确认显示相同的祈愿记录和统计数据。

常见问题速解：同步冲突？启用工具的"冲突解决"功能，选择保留最新版本或合并数据。

genshin-wish-export作为开源跨平台工具，为原神玩家提供安全可靠的祈愿数据管理方案，支持多系统部署、数据本地化存储和多终端同步，是深度分析抽卡历史的理想选择。