原神数据管理与抽卡记录分析：零基础掌握全流程解析

核心价值：为何需要专业的抽卡数据工具？

在《原神》的冒险旅程中，祈愿系统是获取强力角色与武器的核心途径。但游戏原生界面仅提供有限的历史记录查看功能，如何系统追踪抽卡概率、规划资源投入、分析获取规律？genshin-wish-export作为一款基于Electron开发的专业工具，通过本地日志解析与API数据获取技术，为玩家提供完整的抽卡数据管理解决方案，让每一次祈愿都有数据支撑。

环境适配与快速部署：如何让工具在你的设备上高效运行？

系统兼容性检查

该工具专为Windows 64位系统优化，兼容Windows 10/11操作系统。运行前需确保系统已安装.NET Framework 4.5及以上版本，以支持日志解析功能。对于 macOS 用户，可通过Wine环境实现兼容运行。

一键部署流程

1. 从仓库克隆项目代码

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

2. 进入项目目录并安装依赖

cd genshin-wish-export
yarn install

3. 启动应用程序

yarn dev

实战小贴士：国内用户可配置npm镜像加速依赖安装：npm config set registry https://registry.npmmirror.com

模块化操作：从数据获取到可视化分析的全流程

基础数据获取模块：如何安全获取祈愿记录？

前置准备

确保《原神》客户端处于运行状态，并已打开祈愿历史记录界面。工具需要通过读取游戏进程内存或日志文件获取临时认证信息（authKey），此过程完全在本地完成，不会上传任何个人数据。

数据加载步骤

1. 启动genshin-wish-export工具，点击主界面"更新数据"按钮
2. 工具将自动扫描游戏日志目录（默认路径：C:\Program Files\Genshin Impact\Genshin Impact Game\GenshinImpact_Data\webCaches\Cache\Cache_Data）
3. 成功识别后显示"数据加载完成"提示，此时系统已获取最近6个月的祈愿记录

高级分析模块：如何从数据中发现规律？

成功加载数据后，工具将展示三个核心分析面板：

该界面包含三大祈愿池的可视化分析：

• 角色活动祈愿：显示限定角色池的抽卡分布，包含5星角色获取概率、平均出金次数等关键指标
• 常驻祈愿：统计武器与角色的获取比例，帮助玩家判断保底机制触发时机
• 新手祈愿：针对初始20抽的资源投入产出比分析

每个面板均包含：

• 扇形图：直观展示不同星级物品的获取比例
• 数据统计区：总抽卡次数、5星保底计数器、各星级物品占比
• 历史记录：已获取的高价值物品列表及获取时间

实战小贴士：定期点击"导出Excel"按钮备份数据，文件将保存至userData目录，格式兼容主流表格软件

进阶方案：多账号管理与数据安全策略

多账号同步方案

对于拥有多个游戏账号的玩家，工具提供便捷的账号切换功能：

1. 点击主界面"+"按钮添加新账号
2. 切换账号后重新加载数据即可实现隔离存储
3. 所有账号数据保存在本地SQLite数据库中，路径为src/main/db/data.db

数据备份与恢复机制

工具内置双重备份策略：

• 自动备份：每次数据更新后生成时间戳备份
• 手动导出：支持Excel与JSON两种格式的完整数据导出

数据恢复可通过两种方式实现：

1. 从本地备份目录选择历史版本恢复
2. 使用官方数据恢复网页导入Excel文件（需通过yarn build-web构建本地网页服务）

常见故障诊断：解决工具使用中的技术难题

数据加载失败

问题表现：点击"更新数据"后提示"未找到游戏日志"

解决方案：

1. 确认游戏已启动并打开祈愿历史界面
2. 检查游戏安装路径是否为默认位置，非默认路径需在src/main/config.js中手动配置
3. 尝试以管理员身份运行工具

数据不完整

问题表现：部分历史祈愿记录缺失

解决方案：

1. 游戏日志仅保留最近30天数据，超过此期限的记录需通过之前的备份恢复
2. 检查防火墙设置，确保工具具有读取游戏目录的权限
3. 尝试清理游戏缓存后重新获取数据（路径：C:\Program Files\Genshin Impact\Genshin Impact Game\GenshinImpact_Data\webCaches）

二次开发指南：定制你的专属分析工具

开发环境搭建

# 安装开发依赖
yarn install

# 启动热重载开发模式
yarn dev

# 构建生产版本
yarn build

核心模块解析

• 数据获取：src/main/getData.js实现日志解析与API请求逻辑
• 数据处理：src/main/UIGFJson.js负责数据格式转换
• 界面渲染：src/renderer/main.js控制前端交互逻辑

功能扩展建议

1. 添加自定义祈愿分析算法：修改src/renderer/utils.js中的统计函数
2. 集成云同步功能：通过src/main/gists.js扩展数据上传能力
3. 开发新的数据可视化组件：基于src/renderer/components/PieChart.vue进行扩展

社区支持：加入原神数据爱好者生态

贡献代码

1. Fork项目仓库
2. 创建特性分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add some amazing feature'
4. 推送分支：git push origin feature/amazing-feature
5. 提交Pull Request

问题反馈

如遇到功能缺陷或使用问题，请通过项目Issue系统提交详细报告，包含：

• 工具版本号
• 操作系统信息
• 问题复现步骤
• 相关日志文件（位于src/main/logs/目录）

常见问题速查

Q: 工具是否会修改游戏文件？
A: 不会，工具仅读取日志文件和内存临时数据，不会对游戏本体进行任何修改。

Q: 数据存储位置在哪里？
A: Windows系统默认路径为C:\Users\用户名\AppData\Roaming\genshin-wish-export

Q: 能否导出超过6个月的历史记录？
A: 受游戏API限制，工具最多只能获取最近6个月数据，建议定期备份以保留完整历史。

Q: 支持哪些祈愿池类型？
A: 支持角色活动祈愿、武器活动祈愿、常驻祈愿和新手祈愿四种类型的数据分析。