genshin-wish-export：原神祈愿记录导出与抽卡数据分析完整教程

【免费下载链接】genshin-wish-exportEasily export the Genshin Impact wish record.项目地址: https://gitcode.com/GitHub_Trending/ge/genshin-wish-export

想查某个五星到底抽了几次才出货，游戏里的祈愿记录却只给个列表，没有汇总统计，手动记档又不现实。genshin-wish-export 是一款 Windows 桌面小工具：它从游戏日志里拿到访问祈愿记录接口所需的 authKey，帮你把完整抽卡历史导出成 Excel，并算出每个卡池的五星概率和平均出货次数。

🚀 首次加载抽卡数据的完整步骤

1. 拿到代码并构建程序

git clone https://gitcode.com/GitHub_Trending/ge/genshin-wish-export cd genshin-wish-export yarn install

yarn build

构建脚本在 package.json 的 scripts 里定义，产物可直接运行。

2. 先去游戏里打开祈愿历史记录页面

authKey 相当于访问祈愿记录接口的一把钥匙，而钥匙是从"你打开过抽卡记录"这一刻产生的日志里读取的。所以必须先在游戏内打开任意一个卡池的祈愿历史记录，再回来点"加载数据"，否则工具会提示未找到游戏日志。

3. 点击"加载数据"，然后导出第一份 Excel

读取完成后，界面会按卡池分别画出饼图和统计数字。接着点"导出Excel"选择保存位置，生成的文件以"原神祈愿记录"为前缀，每种祈愿类型对应一个工作表，列为时间、名称、类别、星级、总次数、保底内、备注，共 7 列。

🔧 它替你解决了什么问题

钥匙会自动换，不用手动折腾场景：authKey 是一次性凭证，隔一段时间就会失效，手动复制粘贴非常麻烦。 能力：工具优先从游戏日志里直接提取 authKey；读不到有效地址时，可以切到代理模式，由本地代理服务器（设置里默认自动）在重新打开记录页面时截获。 收益：你只管在游戏里点开一次抽卡记录，剩下的读取、翻页、保存全由工具完成。

历史不会被"刷新"掉场景：每次重新拉取数据，你担心旧记录被新记录覆盖。 能力：所有数据都落在工具当前目录下的userData文件夹；每次拿到新祈愿记录时，会先和已有数据合并再写入磁盘。 收益：反复加载也不会丢历史，存档只增不减。

两种格式带走数据场景：想把抽卡明细交给自己或第三方工具做进一步分析。 能力：除了 Excel 工作簿（时间、名称、类别、星级、总次数、保底内、备注 7 列），设置里还提供 UIGF 统一可交换抽卡记录标准的导入/导出，格式校验文件见 src/schema/。 收益：数据可以脱离这个工具独立使用，迁移到其它支持 UIGF 的工具时不丢信息。

界面说你的母语场景：想换英文或其他语言看统计。 能力：13 个语言包都在 src/i18n/ 目录下，从简体中文、English 到 日本語、한국어；缺翻译的词条会回退显示简体中文。 收益：设置里切换语言即可，界面、Excel 表头、日志提示跟着一起换。

📊 逐张读图：每个卡池的出货情况长这样

上图是简体中文界面的真实运行截图（窗口标题 v0.5.4），覆盖角色活动祈愿、常驻祈愿、新手祈愿三个卡池，顶部标注"上次数据更新时间为：2021/3/8上午10:26:04"。带你逐块看：

• 角色活动祈愿：时间跨度 2020/9/28～2021/3/2，共464 抽，已累计 2 抽未出 5 星。五星 7 个（1.51%）、四星 56 个（12.07%）、三星 401 个（85.42%），5 星平均出货次数为66。5 星历史记录逐个列出出货位置：迪卢克[9]、琴[68]、可莉[71]、甘雨[7]、迪卢克[71]、胡桃[9]——方括号里的数字就是距离上一次五星又抽了多少次。
• 常驻祈愿：共144 抽，五星 1 个（0.69%），即天穹之翼，第 80 抽出，5 星平均出货次数为80。
• 新手祈愿：共20 抽，五星 0 个（0%），四星 3 个（15%）、三星 17 个（85%）。

换到英文界面，布局和数字口径完全一致：

💡 进阶玩法

多账号管理与 UID 切换场景：你有主号和练小号，想在一个界面里对比两个账号的抽卡记录。 操作：点"加载数据"旁的"+"按钮登记一个新账号；游戏里切到该账号并打开祈愿历史记录页面；再点一次"加载数据"。之后用右上角的账号下拉框在不同 UID 之间来回切换。

修复近期记录错误场景：某段时间的记录抽数对不上、星级标错，想重拉一遍校准。 操作：进入"设置"打开"获取完整数据"开关，再点"更新数据"，工具会完整获取 6 个月内所有抽卡记录并与本地数据合并，覆盖掉错误的那部分。

用 UIGF 格式把数据搬到别的工具场景：你换了另一款支持 UIGF 的记录工具，不想重新手填。 操作：在"设置"里点 UIGF 的"导出数据"（首次导出需要等待一小会儿），需要全部账号就勾选"导出全部账号"；在目标工具里反向导入即可。

❓ 常见问题

问：我的 Mac / Linux 能装吗？不能。这是一个基于 Electron 的 Windows 64 位桌面程序，当前源码版本 0.12.1，MIT 协议开源，其他系统无法运行。

问：数据存在哪里，会丢吗？存在工具所在目录下的userData文件夹里。每次获取新记录都会先和已有数据合并再保存，历史只增不减，不用担心被覆盖。

问：提示"身份认证已过期"怎么办？先回到游戏里重新打开一次抽卡历史记录，再点"更新数据"。仍然报错就走工具"解决办法"按钮里的 6 步指引：关闭游戏窗口 → 点"打开缓存文件夹" → 删掉Cache_Data文件夹 → 重启游戏并再次打开祈愿记录 → 回来点"更新数据"。另外，若之前用过代理模式且工具异常退出，"设置"里的"关闭系统代理"可以清理残留的系统代理配置。

📮 结语

genshin-wish-export 把游戏里的抽卡历史变成了可核对的数据和可存档的 Excel 文件，五星出货次数与各卡池概率都能精确到每一次。现在就打开游戏的祈愿历史记录页面，点一下"加载数据"，查看属于你的第一份完整祈愿统计。更多使用说明见 README.md。

【免费下载链接】genshin-wish-exportEasily export the Genshin Impact wish record.项目地址: https://gitcode.com/GitHub_Trending/ge/genshin-wish-export