抽卡记录标准化终极指南3步完成UIGF导入导出与跨工具迁移【免费下载链接】HoYo.Gacha✨ 一个非官方的工具用于管理和分析你的 miHoYo 抽卡记录。原神 | 崩坏星穹铁道 | 绝区零An unofficial tool for managing and analyzing your miHoYo gacha records. (Genshin Impact | Honkai: Star Rail | Zenless Zone Zero)项目地址: https://gitcode.com/gh_mirrors/ho/HoYo.Gacha你的抽卡历史是不是也散落在好几个工具里有的在手机截图里有的躺在某个网页分析站还有一份是几年前导出的乱码 Excel。把散落的数据统一成一份标准的 UIGF 文件是每一个深度玩家的刚需。HoYo.Gacha正是为此而生的开源工具它负责抓取、清洗、存储和转换你的 miHoYo 抽卡记录让抽卡记录标准化这件事变成三步就能搞定的日常操作。当你的抽卡历史碎成三块拼图某天你心血来潮想统计一下自己到底为哪个角色花得最多。结果你发现原神的数据在旧电脑的备份文件里星穹铁道的数据在某个网页工具上绝区零的数据干脆只剩手机截图。更尴尬的是这些工具导出的文件格式各不相同——有的叫json有的叫csv有的导出来一看字段全对不上。你想把三个游戏的数据合并起来做一次跨游戏对比分析却被格式问题卡在了第一关。这不是你的问题是数据孤岛的锅。每一条抽卡记录本身都在只是它们被锁在了不同的格式和不同的工具里谁也读不了谁。而破解这道锁的钥匙就是一套所有工具都认可的开放数据标准——UIGF。为什么值得花一下午整理你的抽卡数据把散落的记录标准化收益远比看着整齐大得多效率统一格式后导入导出都是秒级操作再也不用手工复制粘贴整理表格。安全本地数据库 标准文件双备份换电脑、重装系统都不怕记录丢失。可扩展数据一旦标准化就能接入任何支持 UIGF 的分析工具、统计脚本甚至自己写程序做深度挖掘。一句话标准化的抽卡数据才是真正属于你的数据。3步搞定抽卡记录标准化全流程完整流程可以拆成准备 → 执行 → 验证三步每一步都不需要你懂编程。第1步安装工具确认账号数据就绪先在 Releases 页面下载 HoYo.Gacha 的安装包Windows 10 x64 及以上即可。如果想从源码自己构建也可以直接克隆仓库到本地git clone https://link.gitcode.com/i/54ee858d03e82a93ded941743f94e8c0安装完成后程序会在运行目录自动创建名为HoYo.Gacha.v1.db的数据库文件——这是你的数据心脏里面保存着全部账号信息和抽卡记录迁移系统或移动程序时务必带上它。启动工具后先做两件准备添加账号进入抽卡记录页面点击新增账号选择游戏类型原神 / 星穹铁道 / 绝区零填入你的 UID。工具会自动校验 UID 是否合法并识别对应的服务器。确认游戏数据目录工具会尝试定位游戏的本地数据文件夹。如果你重装过游戏可能需要手动指定路径。技巧提示如果你是从旧版v0迁移过来的用户直接在设置页找到数据库迁移选择旧版HoYo.Gacha.db文件即可一键迁移旧数据无缝衔接。第2步一键抓取记录完成UIGF导入导出这是整个流程的核心分三个动作动作一抓取抽卡记录。HoYo.Gacha 最大的卖点是无需本地代理服务器。它直接读取游戏浏览器内核Chromium的磁盘缓存文件从中还原出抽卡链接再向官方 API 请求数据。整个过程不需要你手动复制任何链接点一下获取就能把某个账号的全部记录拉下来并按卡池类型分页抓取进度一目了然。动作二导入历史数据。如果你手里已有其他工具导出的 UIGF / SRGF 文件直接在导入窗口选择文件。工具支持UIGF v2.0 至 v4.2以及SRGF v1.0导入时自动做版本识别、UID 一致性校验和字段补全那些缺 name、缺 item_id的老文件也能被智能修复后入库。动作三导出标准文件。在账号列表里选择目标账号点击导出就能得到一份标准 JSON 文件。导出时你可以选择UIGF 版本v2.x经典单账号格式或 v4.x多账号合并格式。语言偏好导出的物品名称自动转换为 zh-cn / zh-hant / en-us。输出风格紧凑型或美化型pretty方便阅读或压缩体积。更妙的是UIGF v4.x 支持把原神、星穹铁道、绝区零三个游戏的多账号记录合并进同一个文件——这正是你跨游戏数据仓库的第一步。第3步用4道检查确认数据无损导出完成后不要急着关掉程序花一分钟做四道检查数量核对对比工具中显示的记录总数与导出文件中的list条数两者必须一致。UID 一致性UIGF 文件头部info.uid应与账号 UID 完全匹配工具在导入时也会强制校验这一点。时间戳格式抽卡时间应为yyyy-MM-dd HH:mm:ss格式时区信息通过region_time_zone字段保留保证跨时区不出错。星级与卡池类型抽查几条五星记录确认rank_type3/4/5和gacha_type编码与游戏内一致。要点总结准备阶段确认数据库文件安全执行阶段抓取→导入→导出三连验证阶段四道检查锁定数据无损——这就是一次标准的抽卡记录转换闭环。拆开引擎看看转换是如何一步步发生的你可能好奇一个 JSON 文件在工具内部到底经历了什么其实它背后是一条清晰的三层管线数据解析层读取器的任务是把不同来源UIGF、SRGF、CSV的文件反序列化成统一的内部记录结构GachaRecord。每一张卡池、每一条记录都被解析成包含uid、gacha_type、item_id、time等字段的标准对象。数据转换层这里发生最关键的字段映射。比如原神的老版本卡池类型400角色活动祈愿2会被自动映射为标准的301导入时还会根据 UID 判断服务器再结合文件里的region_time_zone把时间换算回服务器时区。元数据映射层工具内置了一份物品元数据可在线更新它把抽象的item_id还原成可读的角色名 / 武器名和物品类别。即使原文件缺失名称字段工具也能通过元数据自动补全——这也是它导入老文件时智能修复的底气。用一句话概括解析层把别人的格式变成统一的格式转换层把混乱的编码变成标准的编码元数据层把冰冷的ID变成看得懂的名字。三层各司其职转换才稳定可靠。高频踩坑自检表症状-原因-对策转换流程再顺也难免遇到意外。以下是社区里最常遇到的几类问题按症状 → 原因 → 对策列出症状1导入提示 UID 不一致原因文件中的uid与你当前选择的账号不匹配或者文件本身被改动过。对策核对文件头部的info.uid确认是同一账号的数据如果文件来自二手渠道建议重新导出。症状2提示 不支持的 UIGF 版本原因文件版本高于工具支持范围或版本号格式写错比如少了v前缀。对策升级到最新版工具或用支持导出该版本的原始工具重新导出一次。症状3导出后记录数量对不上原因抓取时部分卡池类型未同步比如联动机、Bangboo 池或本地数据库已有重复记录。对策在抓取页面确认所有卡池类型都已抓取完毕开启数据库去重选项后再导出。症状4导入老文件后物品名称缺失原因旧版本 UIGF 文件v2.0–v2.2依赖name字段若文件本身没有名称信息则无法补全。对策先更新工具内置元数据再重新导入名称通常能通过item_id自动映射回来。⚠️警告标注任何导入导出操作前务必先备份HoYo.Gacha.v1.db数据库文件。这个文件一旦损坏或丢失你的全部抽卡记录将无法恢复。进阶玩法批量、自动与跨游戏数据仓库当你跑通基础流程后可以试试这些进阶姿势多账号批量导出如果你的账号众多UIGF v4.x 的多项目合并格式一次就能导出所有账号无需逐个操作。跨游戏数据仓库把原神、星穹铁道、绝区零的 UIGF 文件统一存放配合自己写的统计脚本就能做跨游戏的角色获取周期对比、资源投入分析。结合分析生态因为输出的是标准 UIGF 文件你可以无缝切换到其他支持 UIGF 的网页分析站或开源统计工具互相印证数据。自动化备份养成习惯每次抽卡后顺手导出一次 UIGF 文件并同步到云端。本地数据库 云端标准文件双保险。技巧提示导出时建议勾选美化输出pretty这样文件可读性更好用文本编辑器直接查看、抽查都很方便。收尾你的抽卡数据整理行动清单从今天开始把抽卡记录标准化变成肌肉记忆。照这个清单走一遍下载并安装最新版 HoYo.Gacha确认HoYo.Gacha.v1.db数据库文件的安全存放位置添加所有账号并确认 UID 与服务器正确完成一次全量抓取覆盖所有卡池类型将旧工具的历史文件导入数据库导出标准 UIGF 文件并完成数量、UID、时间、星级四道检查将 UIGF 文件备份到云端或其他介质在日历上设置每月一次的例行同步提醒还记得开头那个数据碎成三块拼图的你吗现在只要打开 HoYo.Gacha点几下所有记录就整齐地躺在标准化的 UIGF 文件里——跨工具、跨游戏、跨设备随取随用。数据是你的把它们握在自己手里。【免费下载链接】HoYo.Gacha✨ 一个非官方的工具用于管理和分析你的 miHoYo 抽卡记录。原神 | 崩坏星穹铁道 | 绝区零An unofficial tool for managing and analyzing your miHoYo gacha records. (Genshin Impact | Honkai: Star Rail | Zenless Zone Zero)项目地址: https://gitcode.com/gh_mirrors/ho/HoYo.Gacha创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
