lgou2w/HoYo.Gacha：安装一个非官方的工具，用于管理和分析你的 miHoYo莱卡记

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

技术分析：lgou2w/HoYo.Gacha

项目背景与痛点

在 miHoYo 的多款游戏如《原神》、《崩坏：星穹铁道》和《绝区零》中，抽卡机制是玩家的核心体验之一。然而，历代游戏中的抽卡系统并没有为玩家提供详细的记录和分析工具，玩家难以全面了解自己的抽卡历史和概率。lgou2w 的 HoYo.Gacha 项目正好填补了这一空白，提供了一个非官方的工具，用于管理和分析 miHoYo 游戏中的抽卡记录。

核心技术揭秘

HoYo.Gacha 项目的核心在于其技术架构和技术栈的选择，以及数据的收集、处理和展示。项目采用的语言和技术栈包括 Python、Flask、SQLAlchemy。项目整体架构简单清晰，数据流也十分明确。

技术架构概述如下：

graph TD A[用户登录] --> B[获取抽卡记录] B --> C{"数据验证"} C -->|"通过"| D[处理统计数据] C -->|"失败"| E[返回错误信息] D --> F[展示统计结果]

项目的主要设计思想体现了数据驱动的开发原则。通过分析用户的操作和需求，HoYo.Gacha 提供了灵活的数据收集机制和高效的统计分析功能。其中最核心的部分在于数据收集和处理，通过用户提供的 OAuth 令牌，项目的后端服务器获取用户的抽卡记录，并存储在 SQLite 数据库中，随后进行数据分析和结果展示。

数据处理过程中，核心算法主要涉及数据清洗、统计分析等环节。通过这些算法，项目能够为用户提供诸多有价值的信息，如不同角色或武器的出现概率、抽卡次数与获取目标物品的关系等。

功能亮点与差异

与其他类似工具相比，HoYo.Gacha 的特点在于其开源特性、跨平台支持以及灵活的数据分析功能。开源意味着用户可以对项目进行修改和扩展，以满足特定需求；跨平台则意味着用户无需绑定特定的操作系统，可以在任何支持 Python 的平台上运行该项目。此外，数据分析功能的独特之处还在于其可靠性和全面性，涵盖了多种游戏中的抽卡历史，并能够提供详细的统计结果。

应用场景与落地建议

家庭玩家或具有一定编程能力的爱好者可以利用 HoYo.Gacha 改善自己的游戏体验。在生产环境中使用这一项目时，需要注意保护用户信息的安全性。由于项目涉及 OAuth 令牌和用户数据，建议开发者在集成或修改项目时，确保所有敏感信息在传输和存储时都经过加密。此外，还需要定期更新依赖库，防范潜在的安全威胁。适合的应用场景包括数据分析、游戏行为研究和增强用户体验等。

综合评价

HoYo.Gacha 为 miHoYo 游戏带来了宝贵的抽卡记录分析工具。该项目存在着显著的优势，比如开源、跨平台支持以及丰富的数据分析功能等。然而，其劣势也不少，例如安全性问题以及潜在的数据处理瓶颈。总体来说，这是一款充满潜力的项目，值得社区持续关注与改进。

HoYo.Gacha

一个非官方的工具，用于管理和分析你的 miHoYo 抽卡记录。

无需任何本地代理服务器。只需读取 Chromium 硬盘缓存文件并请求 API 端点。

An unofficial tool for managing and analyzing your miHoYo gacha records.

No need for any local proxy server. Just read the Chromium disk cache file and request the API endpoint.

Logo

✨ 功能 / Features

🎮 支持 原神 Genshin Impact、崩坏：星穹铁道 Honkai: Star Rail 和 绝区零 Zenless Zone Zero.
📁 支持游戏的多个账号。获取游戏的抽卡链接。 Support multiple accounts for the game. Get the gacha url.
📦 支持获取抽卡数据并保存到本地数据库。 Support fetch gacha data and saving it to the local database.
🔄 支持导入或导出的数据交换文件格式。 Support data exchange file formats for import or export.
- UIGF 统一可交换抽卡记录标准：v2.0, v2.1, v2.2, v2.3, v2.4, v3.0, v4.0, v4.1, v4.2
- SRGF 星穹铁道抽卡记录标准：v1.0
- CSV 逗号分隔值。（仅导出）

⚡️ 重要变化 / Important changes

应用标识符 (App Identifier): com.lgou2w.hoyo.gacha -> com.lgou2w.hoyo.gacha.v1。
数据库文件 (Database File ): HoYo.Gacha.db -> HoYo.Gacha.v1.db。

Important 重要

从 v1.2.0 版本开始，应用更新不再是强制性的。但是，为了确保更好的用户体验和安全修复，请及时下载并更新到最新版。

Starting with version 1.2.0, application updates are no longer mandatory. However, to ensure a better user experience and security fixes, please download and update to the latest version promptly.

📥 下载 / Download

确保您的设备满足以下要求：

Ensure your device meets the following requirements:

Windows 10 x64 v1809 (17763+) 及更高版本。
WebView2 Runtime 121+ 及更高版本。

请在此仓库 Releases 下载最新版。

Please download the latest version from this repository Releases.

‼️ 注意 / Notice

程序会在 运行目录 自动创建名为 HoYo.Gacha.v1.db 的数据库文件。此文件中包含了 您的所有本地账号 和 全部的抽卡记录 数据。请确保在 移动程序本体文件 或 迁移操作系统 时不要遗漏此数据库文件！

The program will automatically create a database file named HoYo.Gacha.v1.db in the Run Directory. This file contains all your local accounts and all gacha records data. Please make sure not to miss this database file when moving the program or migrating the operating system!

🚀 迁移 / Migration

从 v0 迁移 / Migrating from v0

打开新版本工具应用。点击应用左下角齿轮状的 设置 按钮，找到顶部的 数据库迁移 栏，点击右侧的 迁移 按钮。选择并打开旧版本数据库 HoYo.Gacha.db 文件，等待迁移自动完成。

Open the new version of the tool app. Click the gear-shaped Settings button in the lower left corner of the app, find the Database Migration bar at the top, and click the Migrate button on the right. Select and open the old version database HoYo.Gacha.db file and wait for the migration to complete automatically.

💞 赞助商 / Sponsorship

感谢以下赞助商对本项目的支持！

HoYo.Gacha is currently using sponsored software from the following service providers:

	Netlify provides document and home page hosting service.
	Free code signing on Windows provided by SignPath.io, certficate by SignPath Foundation

📜 协议 / License

Note 注意

MIT OR Apache-2.0 | 仅供个人学习交流使用。请勿用于任何商业或违法违规用途。

MIT OR Apache-2.0 | For personal study and communication use only. Please do not use it for any commercial or illegal purposes.

This software will not ask you for any account password information about ©miHoYo account, nor will it collect any user data. The generated data (including but not limited to usage data, Gacha data, UID information, etc.) are all stored locally by the user.

HoYo.Gacha

技术解读

技术分析：lgou2w/HoYo.Gacha

项目背景与痛点

核心技术揭秘

功能亮点与差异

应用场景与落地建议

综合评价

关于

简要分析

语言占比

Release

贡献者

HoYo.Gacha

✨ 功能 / Features

⚡️ 重要变化 / Important changes

📥 下载 / Download

‼️ 注意 / Notice

🚀 迁移 / Migration

从 v0 迁移 / Migrating from v0

💞 赞助商 / Sponsorship

📜 协议 / License

🗃 部分资源 / Some assets

评论

HoYo.Gacha

技术解读

技术分析：lgou2w/HoYo.Gacha

项目背景与痛点

核心技术揭秘

功能亮点与差异

应用场景与落地建议

综合评价

相关仓库

关于

简要分析

语言占比

Release

贡献者

HoYo.Gacha

✨ 功能 / Features

⚡️ 重要变化 / Important changes

📥 下载 / Download

‼️ 注意 / Notice

🚀 迁移 / Migration

从 v0 迁移 / Migrating from v0

💞 赞助商 / Sponsorship

📜 协议 / License

🗃 部分资源 / Some assets

评论