原神祈愿记录导出完整指南:5 分钟备份全部抽卡历史并生成统计报告
【免费下载链接】genshin-wish-exportEasily export the Genshin Impact wish record.项目地址: https://gitcode.com/GitHub_Trending/ge/genshin-wish-export
游戏里的祈愿记录只保留最近 6 个月,早期出货的五星会随时间悄悄消失。genshin-wish-export 是一个基于 Electron 的免费开源桌面工具,通过读取游戏日志或代理模式拿到访问祈愿 API 的 authKey,自动拉取全部祈愿记录并永久保存在本地,同时算出每个池子的抽数、出货率与保底进度。
快速上手
获取
普通用户下载发布页的打包文件,解压后双击即可运行,要求 Windows 64 位系统,不需要任何开发环境。想从源码跑起来的话:
git clone https://link.gitcode.com/i/71fd55958ab63c5674208ff66b3496af cd genshin-wish-export && yarn install && yarn start启动与首次加载
- 先启动《原神》,打开任意一个祈愿池的"历史记录"页面
- 回到工具点击"加载数据"
- 几秒后所有池子按角色活动祈愿、武器活动祈愿、常驻祈愿、新手祈愿分组显示
💡 小贴士:第 1 步不能省。工具本身没有你的身份信息,authKey 来自游戏访问祈愿 API 时留下的日志(或代理抓包),游戏不打开祈愿页,它就读不到凭据。以后刷新数据点"更新数据"即可,新记录会自动与本地userData文件夹里的旧数据合并,离线也能查看。
核心功能逐项拆解
数据落盘后,工具做的第二件事是把记录变成一组能直接读的统计。
祈愿统计报告
每个祈愿池独立统计,指标逐行列在池子下方,无需任何操作,加载完成即自动计算。
- 总抽数:该池子累计抽取次数,是所有百分比的分母
- 已累计 N 抽未出5星:距离上一次五星又抽了多少次,对照 90 抽大保底看剩余空间(新手祈愿池无保底,不显示此项)
- 5星 / 4星 / 3星 数量与占比:按你的真实数据算出的各星级次数和比例,五星数量悬浮可见"角色 : N / 武器 : N"的拆分
- 5星历史记录:按时间顺序列出
角色名[间隔抽数],每次出金是谁、第几抽出的一目了然 - 5星平均出货次数:所有五星间隔的平均值,最直观的抽卡成本指标
配合饼图还能看到每个池子里角色与武器的占比,被喂了多少武器不用猜。
导出 Excel
点"导出Excel"生成 .xlsx 文件,每个祈愿池单独一个工作表,共 7 列:
- 时间:单次抽取的时间
- 名称:角色或武器名
- 类别:角色 / 武器
- 星级:3 / 4 / 5
- 总次数:在该池的累计第几次抽取
- 保底内:距上次五星后的第 N 抽,出五星后归零重新计
- 备注:角色活动祈愿池标注"祈愿2",区分复刻后的第二个卡池
拿到什么:一份按星级上色的完整备份,既能长期存档,也能导入第三方分析工具继续深挖。
UIGF 标准导入导出
设置页的"导入/导出"区域支持 UIGF v4.1 和 v3.0 两个版本:选择版本后点"导出数据"生成标准 JSON,v4.1 可勾选"导出全部账号"、可选"可读"格式;点"导入数据"则能把别的工具导出的 UIGF 文件收进本地。拿到什么:一份不锁死在任何工具里的标准数据,换软件接着用。
与游戏内记录的对比
| 维度 | 游戏内祈愿记录 | genshin-wish-export |
|---|---|---|
| 数据保留范围 | 仅最近 6 个月 | 全部历史,永久存在本地userData |
| 统计能力 | 无,逐页手动翻 | 总抽数、出货率、保底、平均出货自动算 |
| 导出备份 | 不支持 | Excel + UIGF 标准 JSON |
| 多账号 | 切换账号反复翻看 | 加号添加,独立保存互不干扰 |
| 隐私 | 记录依赖游戏服务器 | 数据全在自己机器上 |
官方记录负责"让你看最近的",这个工具负责"永久存档并替你算账",是两件事。
进阶用法
数据能用了,下面几个场景能帮你把它用得更顺手。
多账号管理
点账号旁的"+"号添加新账号,游戏里切换账号并重新打开祈愿历史页面,再点一次"加载数据"。每个账号的记录按 UID 独立保存,主号小号的运气对比随时可查。
代理模式兜底
日志里取不到 authKey 时,在设置里开启"代理模式",工具会临时设置系统代理来捕获游戏请求。如果工具中途异常退出导致代理残留,点"关闭系统代理"一键清理,不影响正常上网。
界面语言切换
设置里提供 13 种语言,默认跟随系统语言。想补充或修正翻译,直接改 src/i18n/ 目录下对应的 JSON 文件即可。
修复近 6 个月的数据
设置里打开"获取完整数据"再点"更新数据",工具会重新拉取 6 个月内全部记录,覆盖其中的错误数据。
常见问题与排错
- 日志里拿不到认证信息、加载失败→ 设置里切到"代理模式",按提示重新打开游戏祈愿历史页面
- 这个工具安全吗?→ MIT 协议开源,代码透明可查;只读取游戏日志里访问祈愿 API 的认证信息,不修改任何游戏文件,authKey 在本地配置里加密存储
- 收费吗?需要什么权限?→ 完全免费;读日志、设代理都是普通用户权限,不需要 Root
- 支持哪些平台?→ 正式打包版为 Windows 64 位;源码提供
build:linux、build:mac构建脚本,可自行打包 - 提示"身份认证已过期"→ 多为缓存问题:关闭游戏,用工具打开缓存文件夹删除
Cache_Data,重启游戏并重新打开祈愿历史页面,再点"更新数据"
工具本身不复杂:把官方只保留 6 个月的窗口,变成一份永久保存在本地、随时能算账的完整抽卡档案。如果你也想给自己的抽卡生涯留一份完整记录,克隆 https://link.gitcode.com/i/71fd55958ab63c5674208ff66b3496af 或直接下载发布页的打包文件,打开游戏祈愿页,点"加载数据"就行。
【免费下载链接】genshin-wish-exportEasily export the Genshin Impact wish record.项目地址: https://gitcode.com/GitHub_Trending/ge/genshin-wish-export
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考