原神抽卡记录导出指南:5分钟拿回你的完整祈愿历史
【免费下载链接】genshin-wish-exportEasily export the Genshin Impact wish record.项目地址: https://gitcode.com/GitHub_Trending/ge/genshin-wish-export
你是不是也算过某次出五星用了几抽,结果转头就忘了保底计数?genshin-wish-export(原神抽卡记录导出工具)是一款免费开源的抽卡记录导出工具,它从游戏本地数据自动采集你的全部祈愿历史,不用输入账号密码,适合想弄清"每个池子抽了多少发、离保底还差多少"的玩家。
它是什么,凭什么选它
一句话定位:这是一个基于 Electron 的小工具,唯一的工作是把你的原神祈愿历史完整搬出来,整理成能看懂的数字和图表。不截图、不手记、不做表格公式。
| 对比项 | 手动截图记账 | 用本工具 |
|---|---|---|
| 数据来源 | 逐屏截图、手抄条目 | 一键读取完整祈愿历史 |
| 统计结果 | 自己数五星个数,容易算错 | 自动算出平均出金次数与保底进度 |
| 产出格式 | 截图加手账,难以整理 | 标准 Excel 加 UIGF 规范 JSON |
| 账号规模 | 多个账号容易记混 | 多账号独立存放,一键切换 |
| 长期留存 | 散落在相册和表格 | 本地合并存储,随时增量更新 |
- 不碰密码:通过读取游戏本地日志获取访问祈愿接口所需的 authKey,全程不涉及你的账号密码。
- 双通道获取:日志解析失败时自动切换代理模式,提高一次拿全数据的概率。
- 本地归档:数据只存在工具目录下的 userData 文件夹里,重跑不会重复、不会丢。
- 规范且多语言:数据兼容 UIGF 祈愿格式,界面内置 12 种语言可选。
🎯 核心能力详解:抽卡记录导出全流程
第一步:如何完成原神抽卡记录导出
场景:新池子开档前,你想补全"从入坑到现在"的完整记录。
原理:
- 工具从游戏本地日志里读出调用官方祈愿 API 所需的 authKey;
- 日志通道不可用时,自动改用系统代理模式兜底;
- 新记录会与本地已有数据合并保存,重复执行不会乱。
操作:
- 登录游戏,进入祈愿页面,点击下方的"历史记录"按钮;
- 保持游戏开着,启动工具;
- 点击左上角"加载数据";
- 看到读取完成的提示后,主界面即出现统计结果。
第二步:如何看懂三个卡池的统计
场景:抽卡前你要决定原石投进哪个池子。
原理:
- 角色活动、常驻、新手三个祈愿独立成块,互不混算;
- 每块给出总抽数、各星级数量与占比、五星历史(条目名后括号是当时距上一发金几抽);
- "5星平均出货次数"直接反映你该池子的真实效率。
操作:
- 数据加载后,看主界面三个区块的饼图与数字;
- 红色数字行是五星记录,逐个对照名称确认出货对象;
- 用"总抽数减五星次数乘间隔"估算当前保底位置;
- 右上角"设置"可切换界面语言。
第三步:如何导出抽卡记录到Excel
场景:想把记录发给朋友,或留底做长期分析。
原理:
- 内置 Excel 引擎,把全部条目按行导出,含时间、物品、星级、卡池等字段;
- 本地数据同时遵循 UIGF 规范,数据格式定义里能查到对应 schema。
操作:
- 数据加载完成后,点击绿色"导出Excel"按钮;
- 选择保存位置,等待文件生成;
- 用表格软件打开核对行数与最后一行时间;
- 需要更深分析时,可搭配第三方网页分析工具使用(README 有说明)。
第四步:如何管理多账号的抽卡数据
场景:你有一个主号加若干小号,或者帮朋友代抽。
原理:
- "+"按钮新增账号槽位,每个槽位独立存储;
- 游戏内切换账号后重新加载,新数据只并入当前槽位;
- 切换账号视图只需点击对应标签,互不干扰。
操作:
- 点工具左上角"+"添加新账号;
- 在游戏内切换到该账号并打开祈愿历史;
- 回到工具点"加载数据";
- 之后在主界面标签间切换查看各自记录。
第五步:如何从旧Excel恢复抽卡记录
场景:重装系统或换新电脑后,本地数据不在了,但手头还有旧 Excel。
原理:
- 项目提供了一个在线转换工具(地址见 README),把 Excel 还原成 JSON;
- 转换时需确认 UID 与导出时使用的语言正确,否则会错行。
操作:
- 打开转换工具,上传旧 Excel 文件;
- 选择当时导出使用的语言,填入正确 UID;
- 下载生成的 JSON 文件;
- 把它复制进工具的 userData 文件夹,重启工具即恢复。
🚀 实战:从0到跑通
新手推荐直接下载预编译包解压使用;想自己跑源码的话,在 Windows 64 位环境下执行:
git clone https://gitcode.com/GitHub_Trending/ge/genshin-wish-export cd genshin-wish-export yarn install yarn dev首次使用清单(预编译包同样适用):
- 解压并运行工具,或执行上面的
yarn dev; - 登录游戏,进入祈愿页并点开"历史记录";
- 回到工具点"加载数据",等待读取完成;
- 核对主界面:三个池子的总抽数、五星历史是否齐全;
- 顺手点一次"导出Excel",确认文件正常生成。
看到三块饼图和总抽数出现,就说明整条链路跑通了。
进阶玩法
自定义统计维度
Excel 在手,"某月五星率""不同 UP 池效率对比"这类统计用任意表格工具即可完成。想直接筛本地数据也不难:
// 只保留五星条目 records.filter(r => r.rank_type === '5')按 time 字段再切时间范围,就能算任意周期的出金率。
数据备份与二次开发
备份就是整份复制 userData 文件夹;想加一种语言,改 多语言目录里的 JSON 并提交 Pull Request 即可,这是项目接受贡献最多的入口。
谁在用,效果如何
月卡党
- 背景:每月固定月卡加活动原石,抽不起试错
- 之前:凭感觉下池子,经常保底前原石见底
- 之后:先查工具里的保底进度,再决定投哪个池
- 效果:不再"碎保底",每笔原石的去处有记录
抽卡数据创作者
- 背景:定期发布抽卡统计内容
- 之前:手动截图整理表格,一套数据半天
- 之后:导出 Excel 后数字直接可引用
- 效果:整理时间从半天压到十分钟以内
多账号玩家
- 背景:主号加两个小号
- 之前:各账号保底进度全靠脑子记
- 之后:三个账号槽位,切换标签即看
- 效果:哪个号快触发保底一目了然,资源分配有据可依
❓ 常见问题
需要输入 UID 或密码吗?不需要。工具靠读取本地日志拿 authKey,调用的是官方祈愿接口,全程不询问你的密码。
数据会被上传吗?不会。祈愿数据只保存在本地 userData 文件夹,正常使用没有上传动作。
换电脑后数据还在吗?在。把旧机器的 userData 文件夹拷到新机器对应位置即可;只剩旧 Excel 的话,走上面的恢复流程。
加载数据必须联网吗?是。拿到 authKey 后要联网调用官方接口取记录;日志通道不通时会自动转代理模式,该模式依赖系统代理生效。
支持哪些系统?预编译包面向 Windows 64 位;项目同样提供 macOS 与 Linux 的构建脚本,可自行编译。
界面能改成自己的语言吗?可以,内置 12 种语言,在设置里切换;要新增语言就修改src/i18n/下对应 JSON 文件。
排错速查
| 现象 | 处理办法 |
|---|---|
| 点"加载数据"没反应 | 确认游戏已登录且祈愿历史页面开着,再试一次 |
| 数据不是最新的 | 游戏里重新打开祈愿历史,回工具点"更新数据" |
| 日志通道读取失败 | 看工具是否已转代理模式,并确认系统代理可用 |
| 新账号数据并进了旧账号 | 先点"+"建账号槽,再切游戏账号重新加载 |
| 恢复 Excel 后数据错乱 | 核对 UID 与导出语言是否选对,重新转换 |
| 界面显示外语 | 在系统语言或工具设置里改回中文 |
🌟 最后,它值在哪
- 记录完整:一次补全从入坑到现在的祈愿历史,不再靠回忆。
- 保底可见:三个池子各自离保底多少抽,打开就是答案。
- 数据归你:本地存储加 Excel 备份,换机器、重装都不怕。
- 格式规范:UIGF 标准让记录能被其它分析工具直接接手。
项目后续的方向:
- 持续维护 UIGF 格式兼容与多语言支持
- 欢迎翻译、统计逻辑、界面体验三类贡献
现在就打开原神,点一下"历史记录",五分钟后你手里会有第一份完整的抽卡记录导出。
【免费下载链接】genshin-wish-exportEasily export the Genshin Impact wish record.项目地址: https://gitcode.com/GitHub_Trending/ge/genshin-wish-export
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考