HoYo.Gacha：一个跨平台miHoYo游戏抽卡记录管理工具

HoYo.Gacha是一个功能强大的非官方工具，专门用于管理和分析米哈游（miHoYo）旗下多款游戏的抽卡记录，包括《原神》、《崩坏：星穹铁道》和《绝区零》。该工具采用现代化的技术栈构建，提供了便捷的抽卡数据管理和分析体验。

项目技术架构

HoYo.Gacha采用了Tauri框架构建，这是一个结合了Rust后端和Web前端技术的跨平台桌面应用开发框架。项目的主要技术特点包括：

• 前端技术：使用React + TypeScript + Vite构建用户界面，采用Fluent UI设计系统
• 后端技术：Rust语言提供核心业务逻辑和数据存储能力
• 数据库：SQLite本地数据库存储用户抽卡记录和账号信息
• 跨平台：支持Windows、macOS和Linux系统

核心功能特性

多游戏支持

支持miHoYo旗下三款热门游戏：

• 原神（Genshin Impact）
• 崩坏：星穹铁道（Honkai: Star Rail）
• 绝区零（Zenless Zone Zero）

数据管理功能

• 自动获取抽卡数据：通过读取Chromium硬盘缓存文件直接获取抽卡记录，无需本地代理服务器
• 多账号管理：支持管理同一游戏的多个账号
• 本地数据库存储：所有数据安全存储在本地HoYo.Gacha.v1.db文件中
• 数据迁移工具：提供从旧版本(v0)到新版本(v1)的平滑迁移功能

数据交换格式支持

支持多种标准化的数据交换格式：

• UIGF（统一可交换抽卡记录标准）：v2.0到v4.1版本
• SRGF（星穹铁道抽卡记录标准）：v1.0版本
• CSV格式导出功能

安全性和隐私保护

HoYo.Gacha高度重视用户隐私和安全：

• 不收集敏感信息：不会索要miHoYo账户的账号密码信息
• 本地数据存储：所有数据（包括抽卡记录、UID信息等）均保存在用户本地
• 开源透明：MIT OR Apache-2.0双协议开源，代码可审查

项目结构解析

项目采用模块化设计，主要包含以下核心模块：

• 前端界面层：基于React的现代化用户界面
• 业务逻辑层：Rust实现的核心业务处理
• 数据存储层：SQLite数据库管理
• 工具函数库：通用工具和辅助功能

开发与构建

项目使用pnpm作为包管理器，支持完整的开发工作流：

# 开发模式
pnpm dev

# 构建发布版本
pnpm build

# 代码检查和测试
pnpm lint
pnpm test

使用场景

HoYo.Gacha适用于以下场景：

• 抽卡记录分析：统计和分析历史抽卡数据
• 抽卡策略规划：基于历史数据制定更明智的抽卡策略
• 数据备份和迁移：在不同设备间同步抽卡记录
• 社区分享：导出标准化格式数据与他人分享

安装和使用

用户可以从项目的GitHub Releases页面下载预编译的安装包，支持Windows、macOS和Linux系统。安装后首次运行会自动创建本地数据库文件，用户可以通过导入功能将已有的抽卡数据导入到工具中。

该项目是miHoYo游戏玩家的得力助手，提供了专业级的抽卡数据管理和分析功能，同时保证了用户数据的安全性和隐私性。