企业官网建设流程全解析

genshin-wish-export 完整指南：3 步自动获取并导出原神抽卡记录

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

你的原神抽卡记录能保存多久？genshin-wish-export 是一款基于 Electron 的开源工具，它自动获取官方祈愿 API 所需的 authKey，把完整抽卡历史归档到本地，支持 Excel、UIGF、本地 JSON 三种导出格式。

📊 核心能力一览

工具围绕一条主线工作：把游戏内的祈愿记录取出来、看明白、带出去。

抽卡记录自动获取与本地存档

它能自动拿到调用官方 API 所需的 authKey，并把每次抓到的记录合并保存到本地 userData 文件夹。获取方式有两条：默认从游戏日志文件读取（自动识别国服、外服日志路径，也能识别云原神日志）；日志里取不到有效 URL 时，可切换"代理模式"，临时把系统代理指向本地 mitmproxy（端口 8325）捕获请求。每次抓取都会按记录 id 与本地数据合并去重，保存前旧文件还会自动备份到 backup 子文件夹，数据不会被覆盖丢失。

加载完成后，界面按祈愿类型展示星级分布饼图与 5 星历史记录。

星级分布与 5 星出货统计

每个祈愿类型（角色活动祈愿、武器活动祈愿、集录祈愿、常驻祈愿等）都有一组独立统计：

多账号管理与多格式数据导出

多个 UID 的数据存放在同一个窗口里，每个账号独立保存为 gacha-list-UID.json，点击加号按钮即可添加新账号，右上角下拉框随时切换。导出格式有三种：Excel 包含时间、名称、类别、星级、总次数、保底内、备注 7 列，并按星级着色；UIGF JSON 支持 v3.0 与 v4.1 两个版本，导出前用 schema 校验，导入同样会先校验再合并。界面内置 13 种语言包，可在设置页切换。

切换到英文后，祈愿池名称与统计指标会跟随语言包显示。

💻 安装与首次运行

在 Windows 64 位系统上，按下面 3 步完成首次数据获取。

1. 获取工具。有 Node.js 环境的话，克隆源码并以开发模式运行：

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

或者从项目 release 页面下载预编译包，解压后直接运行，无需配置任何环境。 2. 打开原神，进入"祈愿历史记录"页面并保持停留，这是读取 authKey 的前提。 3. 点击工具主界面的"加载数据"按钮，日志区会逐页显示抓取进度，完成后进入统计界面。

之后想导出时，点"导出Excel"即可保存当前账号的记录；管理多个账号时先切换 UID 再操作。

🎯 适用人群与典型场景

它主要面向三类玩家，使用情境都很具体。

• 保底追踪者：每个卡池结束后查看"5 星历史记录"与"当前未出 5 星抽数"，按剩余次数规划下个池子的投入。
• 多账号玩家：主号、小号各自独立存档互不覆盖，用主界面的加号按钮逐个补录。
• 跨工具数据用户：导出 UIGF v4.1 JSON 后导入其他社区统计工具，item_id 由 UIGF 官方字典自动匹配。

🔧 进阶技巧与常见问题

先给几条提升体验的技巧，再列出高频报错的排查方法。

技巧：

1. 记录里出现 6 个月以内的错误数据时，在设置页开启"获取完整数据"，再点"更新数据"会重新拉取 6 个月内全部记录。
2. 数据随时可以恢复：直接导入本地 gacha-list-UID.json 或之前导出的 UIGF JSON 均可，导入前会把现有数据再备份一次。
3. 检测到新版本后，点"直接更新"按钮重启工具即可生效，不用等下次手动启动。

🧩 技术栈与同类对比

前端与桌面端都采用成熟开源方案，代码结构紧凑。

• Electron：桌面应用底座，主进程负责日志读取、代理设置与 API 分页抓取
• Vue 3 + Element Plus：界面代码位于 src/renderer/，按钮、对话框、下拉菜单均为独立组件
• ECharts：绘制每个祈愿池的星级分布饼图
• Vite + electron-builder：开发热更新与发布打包，build 脚本覆盖 win、macOS、Linux 三平台
• ExcelJS + ajv：生成带样式的 Excel，导入 JSON 时按 UIGF schema 校验

与常见的网页版祈愿记录工具相比，可验证的差异集中在三点：数据全部落在本地 userData 文件夹，不经过第三方服务器；导出格式有 Excel、UIGF v3.0/v4.1、本地 JSON 三种；同一窗口可存放多个账号并自由切换。

🤝 参与社区

项目采用 MIT 协议开源，贡献路径按门槛从低到高有三条。

1. 反馈问题：遇到 bug 或有功能建议，先到项目里提交 issue，描述清楚系统和现象即可。
2. 完善翻译：语言包集中在 src/i18n/ 目录，每种语言一个独立 JSON 文件，发现翻译不准可以直接修改后提 Pull Request，README 明确欢迎这类贡献。
3. 改界面或加统计：UI 组件在 src/renderer/components/ 下，本地用yarn dev就能跑起来验证改动效果。

结尾行动清单：

1. 运行工具，在游戏里打开祈愿历史页面。
2. 点"加载数据"，获取第一份抽卡记录。
3. 导出 Excel 或 UIGF JSON，留一份本地备份。

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