3步搞定数据格式转换：把散落的抽卡记录统一成UIGF标准JSON

3步搞定数据格式转换把散落的抽卡记录统一成UIGF标准JSON【免费下载链接】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当你的抽卡记录散落在游戏截图、第三方工具导出的CSV、以及旧软件的历史备份里时数据格式转换就不再是极客专属的技术活而是每个老玩家都该掌握的整理术。这篇文章从一个真实换工具场景讲起带你拆解抽卡记录标准化UIGF标准的原理、步骤与常见坑。一、先看痛点三份记录三种语言小林玩原神三年抽卡记录分散在三个地方手机里几百张抽卡截图、某个旧工具导出的CSV表、以及手动整理的幸运值Excel笔记。换新分析工具时对方只认UIGF标准的JSON文件他瞬间傻眼——这就是典型的数据孤岛问题。统一格式的价值有三保底进度、五星出货率等分析才有计算基础换工具、换设备时记录可无损迁移本地留档防账号注销、防记录丢失。而UIGF统一抽卡记录格式正是米哈游系游戏原神、星穹铁道、绝区零社区共同约定的JSON标准相当于抽卡数据的普通话。二、逆向拆解标准JSON到底长什么样与其空谈标准不如先看成品。一份UIGF v2.2文件只有两个大块区块作用关键字段info文件头信息uid、uigf_version、export_time、export_applist记录数组id、gacha_type、item_id、name、rank_type、time、count其中time采用 ISO 8601 格式的时间戳rank_type用数值表示星级4/5gacha_type是约定好的卡池编码。这些翻译规则就是整个转换链路的灵魂。从成品反推每条记录至少要经过抓取/读取 → 清洗 → 字段映射 → 校验 → 落库五道工序下面逐一展开。三、看懂链路数据从哪里来如何变成标准JSON第一类源头游戏官方抽卡接口。工具通过你登录后获取的抽卡链接直接从官方日志接口拉取数据相关实现见crates/url_scraper/。这类数据最完整自带id、gacha_type、item_id、rank_type等原始字段只需补上uigf_gacha_type等派生字段即可。第二类源头其他工具的导出文件。可能是旧版UIGF、星铁SRGF、甚至只有两列的简易CSV。此时最关键的就是字段映射——可以把它理解为一位翻译官卡池编码翻译原神官方的302角色池2在UIGF里要映射为301角色池不同游戏编码体系各不相同名称↔ID互译工具借助内置元数据crates/metadata/把物品名称翻译成item_id或反过来把ID翻译成你熟悉的语言时区换算记录里的时间要按服务器时区统一换算避免歪了8小时的错觉字段补全缺失的count默认补1缺失的item_type从元数据反查。转换完的记录会先写入本地数据库见tauri/src/database/migrations/形成你自己的抽卡数据中心之后导出成任何格式都只是视图问题。四、动手实操导入与导出的完整步骤在工具的转换器入口前端源码app/pages/Gacha/components/Converters/里导入和导出是两条对称流程。导入一份UIGF/SRGF/CSV文件选择要导入的文件选择文件格式支持UIGF v2.x~v4.x、SRGF v1.0、CSV等设定冲突时怎么处理——是跳过、保留现有还是覆盖确认后观察进度条完成后会提示本次新增或变更了多少条记录。导出标准JSON选择输出文件夹选择格式与版本UIGF可选v2.2、v2.3、v4.x等按需开关pretty美化缩进、minimized精简输出导出完成后可勾选自动打开文件快速检查。结果验证清单✅ 对比转换前后的记录总数防止丢数据✅ 抽查时间戳是否符合 ISO 8601、星级是否为数值✅ 检查info.uid与账号是否一致。 小提示导出文件名会自动带上应用名_格式_uid_时间戳的后缀方便多账号归档。五、翻车自查常见问题与备份策略转换出错不可怕可怕的是不知道错在哪。按这张表排查现象可能原因处理方式提示版本不支持文件是过老的UIGF v1.x用支持v2.0的工具重新导出提示uid不一致文件属于另一账号核对info.uid按账号分别导入导入后记录数变少存在隐藏行/列或字段缺失检查原文件完整性先转CSV再试时间对不上时区未统一确认导出的region_time_zone正确⚠️ 任何转换前建议遵守原始文件中间文件目标文件三级备份原件不动转换产物按日期归档每周做一次全量备份存到不同位置。遇到个别坏数据时宁可跳过该条也不要让整批失败。六、进阶玩法从转一次到一直转跨游戏整合原神、星穹铁道、绝区零的记录统一转成UIGF放进一个数据仓库用同一套逻辑做跨游戏对比分析批量与自动化多账号、多文件可批量导入导出结合定时任务可实现新记录自动备份深度分析有了标准化数据保底概率、角色获取周期、资源投入产出比等分析才真正有据可依。想亲自体验这套流程可克隆项目本地运行git clone https://gitcode.com/gh_mirrors/ho/HoYo.Gacha写在最后从Excel表格、CSV截图到UIGF标准JSON数据格式转换的本质不是翻译一次文件而是建立起一套可持续的记录管理体系。抓住标准先行、映射清晰、备份兜底三个要领无论是Excel转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），仅供参考