企业官网建设流程全解析

genshin-wish-export 原神祈愿记录导出：从打开工具到导出 Excel 的实操指南

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

genshin-wish-export 是一个基于 Electron 的原神祈愿记录导出工具，它通过读取游戏日志或代理模式拿到访问祈愿 API 所需的认证信息，再把账号内完整的祈愿历史拉取下来，最终产出一份带样式、分祈愿池的 Excel 表格（.xlsx）。它只运行在 Windows 64 位系统上，所有数据都保存在工具目录的userData文件夹里，新记录会自动与本地旧记录合并，不会重复也不会覆盖。

下载、解压与运行

整个过程不需要安装任何运行环境：

1. 从发布页下载最新版压缩包，解压到任意目录。
2. 双击主程序运行工具。
3. 打开原神客户端（工具需要从游戏的祈愿记录里取认证信息，游戏不打开就拿不到数据）。

工具首次启动时会按系统语言显示界面，如果语言不对，可以在"选项 → 设置"里切换，可选语言对应 i18n 翻译目录下的 13 个 JSON 文件（简繁中文、日、韩、英、德、法、西、俄、葡、印尼语、越南语、泰语）。

第一次拿到数据：打开游戏记录，再点"加载数据"

这是完整的首次流程，顺序不能反：

1. 进入游戏祈愿界面，点击"历史记录"，等待页面加载出抽卡列表。
2. 切回工具窗口，点击"加载数据"按钮。
3. 界面上会滚动显示"正在获取角色活动祈愿第 N 页"之类的进度，全部完成后进入预览状态。

工具先尝试读取游戏日志中的认证 URL，读不到时会自动回退到代理模式（临时改写系统代理，抓一次请求后自动还原）；如果日志方式一直失败，也可以在"选项"菜单里手动输入 URL。

预览页会按祈愿池分块展示：每个池子一张星级占比饼图，下方列出总抽数、当前未出 5 星的抽数、5 星历史记录和 5 星平均出货次数。角色活动祈愿、武器活动祈愿、常驻祈愿、新手祈愿各占一块。

导出 Excel：表格长什么样、文件存在哪

点击"导出Excel"按钮，会弹出保存对话框。默认文件名是原神祈愿记录_年月日_时分秒.xlsx，位置在系统下载目录。表格的具体内容可以在 表格生成代码里看到：

• 一个祈愿池一个工作表：角色活动祈愿、武器活动祈愿、常驻祈愿、新手祈愿各自独立，表头行冻结。
• 七列字段：时间、名称、类别、星级、总次数、保底内、备注。"总次数"是该池累计抽数，"保底内"是距上次出 5 星以来的抽数，抽到 5 星后归零。
• 按星级着色：3 星灰色、4 星紫色、5 星橙色，且 4 星以上加粗，扫一眼就能定位大保底。
• 备注列标注祈愿：角色活动池里的武器池（Wish 2）记录会单独标出。
• 列宽会随游戏语言自动调整，非中文语言时名称列会更宽。

数据存在哪、怎么恢复

每个账号的数据保存在工具目录的userData文件夹中，文件名为gacha-list-你的UID.json。数据获取与合并逻辑会处理去重：每次拉取新记录时，以记录 ID 为锚点与本地旧数据比对，只追加真正新增的部分，所以多次点击"加载/更新数据"不会产生重复行。

这意味着：

• 备份：直接复制userData文件夹即可，JSON 文件自包含。
• 恢复：把gacha-list-UID.json放回新电脑上工具的userData文件夹。
• 从 Excel 恢复：如果手里只有之前导出的 Excel，可以访问网页 genshin-gacha-export.danmu9.com 上传文件，填正确的 UID、选 Excel 使用的语言，还能指定截止时间去除重复数据，下载 JSON 后复制到userData文件夹即完成恢复。

多账号导出和其它常用设置

多个 UID：点击"加载数据"按钮旁的加号按钮新增一个账号，切游戏账号 → 打开祈愿历史记录 → 工具再点一次"加载数据"。多个账号并存后，界面右上角会出现 UID 下拉框，随时切换要查看/导出的账号。

日志类型（设置里）：可选自动、国服、外服，简体中文环境下还有云原神选项，用于指定从哪个客户端的日志文件取认证 URL，双端并存时比较有用。

获取完整数据：默认只增量拉取本地没有的记录；开启后点"更新数据"会完整重拉 6 个月内的全部记录，适合用来修复历史记录中的错误数据，代价是耗时明显变长。

代理模式 / 输入 URL：读日志失败时的两条手动通道，在"选项"下拉菜单里。

UIGF 导入/导出：设置页支持按统一可交换抽卡记录标准（UIGF 3.0 / 4.1）导入和导出 JSON，导出时可勾选"全部账号"，这让数据可以喂给其它遵循同一标准的抽卡分析工具，而不是被锁在这个工具里。

常见问题 FAQ

数据具体存在哪个目录？工具所在目录下的userData文件夹，每个 UID 一个gacha-list-UID.json文件，直接复制整个文件夹就是完整备份。

提示"身份认证已过期"怎么办？回到游戏里重新打开祈愿历史记录，再点"更新数据"。如果反复失败，用工具给出的"解决办法"：打开游戏网页缓存文件夹，删除Cache_Data文件夹，重启游戏打开记录页后再试。

读不到游戏日志、拿不到认证 URL？改用"选项"菜单里的"代理模式"（工具会临时占用系统代理抓一次请求），或"输入URL"手动粘贴带 authkey 的完整链接。

6 个月之前的数据还能拿到吗？不能。游戏侧 API 只提供最近 6 个月的记录，所以越早开始定期"加载数据 + 导出 Excel"，本地历史越完整。

进一步分析与二次开发

导出 Excel 之后，如果想要更复杂的概率统计与期望分析，可以用 genshin-gacha-analyzer 这类项目对导出的数据做二次加工；UIGF 格式导出的 JSON 也可直接被同类工具消费。

想改代码的话，项目使用 Electron + Vue 3 + Vite，核心逻辑集中在 src/main/（数据、代理、Excel 生成），界面在 src/renderer/：

git clone https://gitcode.com/GitHub_Trending/ge/genshin-wish-export cd genshin-wish-export yarn install yarn dev # 开发模式；yarn build 可构建出可运行的程序

翻译想改进的话，改 src/i18n/下对应语言的 JSON 即可提交 PR。

工具本身很薄，价值在于把"游戏只保留 6 个月记录"这个限制变成了本地永久存档。建议现在就跑一遍完整流程：打开游戏记录 → 加载数据 → 导出 Excel，然后把userData文件夹加进你的同步或备份范围，之后每次大保底前后点一下"更新数据"就足够。

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