终极HoYo.Gacha使用指南：一键管理原神与崩坏星穹铁道抽卡记录的完整教程 🎮

HoYo.Gacha是一款强大的非官方开源工具，专为原神和崩坏：星穹铁道玩家设计，提供抽卡记录的全面管理与深度分析功能。通过直观的界面和智能分析工具，玩家可以轻松追踪抽卡历史、计算概率统计，并生成可视化报告，让每一次抽卡都尽在掌握。

📋 快速开始：3步完成项目搭建

1️⃣ 一键获取项目源码

首先通过Git命令克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/ho/HoYo.Gacha

进入项目目录：

cd HoYo.Gacha

2️⃣ 安装必备依赖

项目采用Rust后端与TypeScript前端的混合架构，需安装以下依赖：

• Node.js (v16+)
• Rust开发环境 (1.60+)
• pnpm包管理器

安装前端依赖：

pnpm install

3️⃣ 启动应用程序

开发模式启动（带热重载）：

pnpm tauri dev

构建生产版本（生成可执行文件）：

pnpm tauri build

🚀 核心功能详解

抽卡记录自动同步与导入

工具支持多种记录获取方式：

• 自动嗅探：通过分析游戏日志文件自动获取抽卡记录
• URL导入：输入游戏内抽卡记录链接一键同步
• 文件导入：支持UIGF/SRGF等标准格式文件导入

核心实现位于：src-tauri/src/business/gacha_fetcher.rs，通过异步任务拉取并解析抽卡数据，确保记录的完整性和实时性。

可视化数据分析仪表盘 📊

应用提供多维度数据统计：

• 抽卡次数累计与保底计算
• 角色/武器获取概率分布
• 时间轴视图展示抽卡规律
• 历史UP池覆盖度分析

图：HoYo.Gacha生成的原神武器抽卡概率分布热力图

多账号管理与数据隔离 🔒

支持添加多个游戏账号，每个账号数据独立存储：

• 账号信息加密保存
• 快速切换不同账号视图
• 支持跨设备数据同步（需手动导出导入）

账号管理模块实现于：src-tauri/src/models/account.rs，采用安全的KV存储方案保护用户数据。

⚙️ 高级配置指南

自定义数据存储路径

默认数据存储位置为系统默认文档目录，可通过修改配置文件自定义路径：

// src-tauri/src/business/data_folder_locator.rs
pub fn get_data_folder() -> PathBuf {
    // 修改此处自定义数据存储路径
    dirs_next::document_dir().unwrap().join("HoYoGachaData")
}

抽卡记录导出与备份

支持多种格式导出：

• JSON格式（完整数据）
• CSV表格（可用于Excel分析）
• 图片报告（PNG格式可视化图表）

导出功能实现位于：src-tauri/src/business/gacha_convert.rs，支持UIGF v4和SRGF v1等主流标准格式。

🛠️ 常见问题解决

无法获取抽卡记录？

1. 确保游戏日志文件路径正确
2. 检查网络连接（在线同步需要）
3. 尝试手动导入抽卡记录文件

数据统计异常？

1. 清除缓存数据：src-tauri/src/business/disk_cache.rs
2. 重新导入最新的抽卡记录
3. 检查应用版本，更新到最新版

📁 项目结构解析

HoYo.Gacha/
├── src/                 # 前端React应用
│   ├── pages/Gacha/     # 抽卡记录页面
│   └── components/      # UI组件库
└── src-tauri/           # Rust后端
    ├── src/business/    # 核心业务逻辑
    │   ├── gacha_fetcher.rs  # 抽卡记录获取
    │   └── gacha_convert.rs  # 数据转换
    └── src/database/    # 数据存储模块

核心业务逻辑集中在src-tauri/src/business/目录，包含抽卡记录的获取、转换、分析等关键功能实现。前端界面采用现代化React组件架构，提供流畅的用户体验。

🌟 为什么选择HoYo.Gacha？

• 完全本地运行：所有数据存储在本地设备，保护隐私安全
• 多游戏支持：同时兼容原神与崩坏：星穹铁道
• 开源免费：源代码完全开放，无任何功能限制
• 持续更新：活跃的开发社区，不断添加新功能与优化体验

通过HoYo.Gacha，玩家可以摆脱手动记录抽卡的繁琐，用数据驱动每一次抽卡决策，让游戏体验更加理性与高效。立即开始使用，开启你的智能抽卡管理之旅吧！