告别手动整理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 表格、随手导出的 CSV、截图式的备忘录……数据越多越不敢换工具。因为一旦换历史记录就全断了。HoYo.Gacha 这样的开源抽卡管理工具之所以值得一试核心就在于它把散乱原始数据转换成 UIGF 行业标准格式——一个通用 JSON 规范。数据一旦标准化就能自由地导出、备份、换工具甚至跨游戏汇总分析。下面这份数据搬家指南用 3 步帮你完成这件事。搬家的念头是从什么时候冒出来的多数人的抽卡记录是这样的第一份 Excel 表头是时间、名称、星级第二份换了个工具导出列变成了gacha_type、item_id第三份干脆只有截图。想算一下总抽数得三个文件来回对想导入新工具对不起格式不认。这种状态叫数据孤岛——不是没数据而是数据被困在各自的小屋里谁也进不去你也带不走。而 UIGF统一抽卡记录格式就像一栋标准化的新公寓所有房间有统一的户型、统一的编号、统一的门牌规则。无论你来自哪份 Excel 还是哪个旧工具搬进这栋楼之后大家就都说同一种语言了。旧屋和新屋到底差在哪一张表看懂别急着操作先直观感受一下标准化改了什么。左边是你手头常见的表格右边是 UIGF 标准里的字段你的 Excel 习惯UIGF 标准字段说明时间2025/10/22 13:07timeISO 8601 格式时间戳统一到带时区的时间跨服不乱星级金/紫/五星rank_type数字 5 / 4 / 3用数字编码代替口语描述卡池角色UP池gacha_typeuigf_gacha_type301 / 302官方编码 标准编码双字段名字雷神/芙宁娜item_iditem_name物品 ID 为主键名字只是翻译⚠️ 当心直接复制粘贴永远搬不成。因为 Excel 里的五星是给眼睛看的而标准格式需要的是给程序读的数值和编码。这一步的差异就是标准化的全部意义。第一次搬家踩的坑直接复制粘贴的代价我最初以为转换就是把表复制进 JSON 里结果换工具导入时收到一串错误RequiredField、InvalidVersion。后来才明白问题出在三件小事上时间格式不统一有的写了2025/10/22 13:07有的是Oct 22 2025标准格式要求统一的时间戳星级写成了金色传说而不是数字5最坑的是时区——UIGF 记录里带region_time_zone导入时会自动换算成服务器时区而手动整理的表格根本没有这回事一对比就乱了。 小贴士手工翻译永远赶不上规则化转换。人眼能容忍歧义程序不能而标准化就是提前把所有歧义变成规则。专业搬家队的 3 步走把记录整齐搬进 UIGFHoYo.Gacha 的导入导出Converters模块就是一支专业搬家队。你只需要记住三步。第 1 步清点行李让所有记录先有家可归先把散落的 Excel / CSV 统一导出成 JSON。HoYo.Gacha 支持把账户下的记录导出为 CSV 表格方便你在 Excel 里核对同时它也内置了旧版数据迁移功能能把历史版本数据库里的记录无缝并入新库。✅ 自检项清点前后先记下当前总记录数后面用作核对基准。第 2 步选对搬运方式导出标准格式在导出对话框里选择格式工厂Classic UIGF / Classic SRGF经典单游戏格式支持 UIGF v2.0 ~ v3.0、SRGF v1.0适合原神、星穹铁道的玩家UIGF新一代多账号格式支持 v4.0 ~ v4.2可把多个游戏、多个账号的抽卡记录装进同一个 JSON 文件CSV给需要继续在表格软件里折腾的用户兜底。导出时可以顺手勾选美化输出Pretty让 JSON 可读或精简输出Minimized减小文件体积。第 3 步入住新家随时欢迎其他数据回来标准化不只是搬出去还得能搬回来。导入对话框支持读取上述所有格式并且提供冲突处理选项遇到重复记录可以选择不处理或更新导入进度条会实时显示走到哪一步。这意味着你完全可以用它作为数据中心任何工具导出的标准文件都能回到这里继续累积。 小贴士想长期保存就固定用 UIGF v4.x 导出想跟老工具互通选 v2.2 这种兼容性更广的版本。搬完别急着关门收尾 3 项自检搬完家第一件事不是躺下而是确认没有丢行李。✅ 数量核对导入后记录的条数与导出前是否一致这是最直接的没丢东西证明。✅ 字段抽查挑几条五星记录检查time是否仍是你所在时区的时间、rank_type是否为数字、卡池类型编码是否与游戏内一致。✅ 编码验证用任意 JSON 校验工具确认文件语法合法再确认文件以 UTF-8 保存避免中文乱码。⚠️ 当心任何转换前先给原始文件做一份备份。标准化的意义是可回滚前提是你手里有原稿。住进新家之后你的数据第一次真正属于你现在你可以做以前做不到的事了把原神、星穹铁道、绝区零的抽卡记录合并进同一份 UIGF 文件跨游戏对比抽卡概率换任何支持 UIGF 的工具时直接导入再也不用从零开始把导出的 JSON 按日期归档三年后还能完整复盘每一次抽卡。数据标准化最大的价值不是格式本身而是选择权——当你手里的数据随时能走、随时能回工具才真正为你服务。想亲自动手可以先把项目拉下来体验git clone https://gitcode.com/gh_mirrors/ho/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），仅供参考
