抽卡记录格式转换实战5 步把散落的记录统一成 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换了一台电脑换了一个管理工具结果发现旧工具导出的文件新工具根本不认。原神的记录还躺在 A 工具里崩坏星穹铁道的在 B 工具里绝区零的则孤零零待在一个旧版 JSON 中……这种数据孤岛几乎是每个抽卡记录玩家的通病。所谓抽卡记录格式转换就是把散落在各种格式里的记录统一成一种约定好的结构——UIGF 标准 JSON让数据从此在工具之间自由流动。本文以开源工具 HoYo.Gacha 为例带你完整走一遍导入 → 标准化 → 导出 → 校验的全流程全程不需要写一行代码。快速上手4 步先跑通一遍先别管那些概念跟着做一遍最小流程你会立刻获得成就感启动工具添加账号选择游戏原神 / 星穹铁道 / 绝区零等填入你的游戏 UID。打开导入 · 导出在游戏页面的工具栏中找到这个入口点击导入。选择旧记录文件选中你之前导出的 JSON 文件工具会自动完成格式识别与字段映射。导出 UIGF 文件切到导出选择 UIGF 格式与版本点一下按钮一个标准 JSON 文件就诞生了。✅ 一句话版添加账号 → 导入旧记录 → 导出 UIGF → 打开检查。整个过程 3 分钟无需任何技术背景。分步精讲把每个环节做到心中有数第 1 步认清楚四种格式再动手先给新手补个背景知识。所谓标准化通俗讲就是给抽卡记录定一套通用语言。市面上常见的交换格式有四种格式版本适用游戏可导入可导出UIGF新版v4.0 / v4.1 / v4.2多游戏、多账号合一✅✅UIGF旧版v2.0 ~ v3.0仅原神✅✅SRGFv1.0仅崩坏星穹铁道✅✅CSV逗号分隔各游戏通用❌✅仅导出 打一个比方UIGF 是国际通用货币走到哪个工具都能兑换SRGF 是星铁专属的区域代币CSV 则是 Excel 最喜欢的记账表格方便你拉进表格做二次分析。新版 UIGF 最强的能力是一文件装多游戏把全家桶记录塞进一个 JSON。第 2 步添加账号给格式转换打好地基你可能奇怪导入数据而已为什么非要先添加账号因为每条抽卡记录都归属于某个游戏 某个 UID。工具要用 UID 做身份校验确保 A 账号的记录不会混进 B 账号。在添加账号时你需要选择游戏、填写 UID必要时指定游戏数据目录。这一步就像给每批货物贴上收货人标签后面的转换才不会乱套。⚠️ 注意如果你直接导入一个 UID 与当前账号不一致的文件工具会明确报错提示不会悄悄吞掉数据。第 3 步抽卡记录导入把旧文件读进本地数据库导入界面一共就四个选项跟着做即可选择文件挑选你手头的 UIGF / SRGF JSON 文件。选择格式按文件的来源选择对应格式工具会自动过滤出可识别的文件类型。选择语言某些格式导入时需要你指定记录语言如中文工具会据此匹配物品名称。处理冲突遇到已存在的记录时选不处理跳过或选更新覆盖旧数据。导入过程中有进度条实时反馈完成后会提示本次导入了几条记录。你不需要关心底层怎么映射字段——工具会自动完成卡池类型编码转换、时间戳解析、时区换算等脏活累活。第 4 步UIGF 文件生成步骤——选格式、选版本、定细节导出是本次流程的高潮重点盯三个选择格式追求兼容性选 UIGF新版只想给原神单游戏存档可选 UIGF旧版想做表格分析就选 CSV。版本新版本如 v4.2信息更全但旧工具未必支持。如果你还要把文件导回某个老工具建议降级选择 v2.2 这类通用版本。细节开关勾选美化数据让 JSON 缩进清晰、便于阅读勾选最小化数据会省略可选字段文件更小CSV 模式下还能决定第一行要不要列名。导出成功后文件会以应用名_格式_UID_时间戳的方式命名例如HoYo.Gacha_Uigf_100123456_20260814_133000.json。这个命名规则自带时间戳天然适合归档备份。第 5 步三步完成 UIGF 数据校验导出不等于结束花一分钟验收成果查结构用任意文本编辑器打开 JSON确认包含info文件头信息和list记录数组两个主体。对数量对比导出前后记录的条数确保一条没丢、一条没多。抽查字段随意挑几条核对时间格式、星级数值、卡池类型编码是否正常。 其实最省心的做法是把导入校验当成第一道防线把导出当作第二道防线。HoYo.Gacha 在导入时会自动检查 UID 一致性、必填字段、版本支持范围导出的文件本身就按标准生成双重保障下出错的概率很低。新手常犯的 5 个错误这些坑几乎人人踩过提前绕开能省不少时间没添加账号就直接导入——工具找不到归属自然拒绝处理。先建账号再导数据。版本选错——导出 v4.2 后想塞回只支持旧版的工具结果报不支持该版本。需要兼容老工具时主动降级版本。语言没选对——导致导入后物品名变成英文或乱码。导入前看清语言选项。拿 CSV 当导入源——CSV 是只出不进的格式只能用于导出分析别指望用它恢复记录。不做备份就批量操作——大规模导入前先把原文件复制一份存到别处。格式转换再可靠也不如双保险踏实。⚠️ 注意涉及大批量导入、跨工具迁移时请务必备份原始文件。这是所有转换操作的第一原则。进阶玩法让数据标准化成为日常习惯跑通基础流程后你可以尝试这些进阶姿势跨游戏数据整合把原神、星铁、绝区零、千星奇域四款游戏的记录全部导入后一次性导出成一个多游戏 UIGF 文件建立你自己的抽卡数据仓库。CSV Excel 深度分析导出 CSV 后用数据透视表做保底概率统计、角色获取周期分析——Excel 不当源文件而是当分析工具正合适。定期备份流水线利用导出文件名自带的日期时间戳按每月一导的节奏归档让每一次导出都变成一次免费快照。数据库一键迁移如果你从旧版本工具升级可在设置里找到数据库迁移选择旧数据库文件即可无缝搬家避免历史记录失联。收尾总结回到开头的问题换工具就丢数据、多游戏记录散落成孤岛——这些痛点的根源都是抽卡记录格式转换这一步没做好。把数据标准化成 UIGF 标准 JSON等于给所有记录找到了通用语言从此换工具、换设备、跨游戏分析都不再是障碍。现在就去试试打开 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），仅供参考
` 生成的数字序列是从 **1 开始（包含）**，到 **6 结束（不包含）** 的整数序列)
