HoYo.Gacha 抽卡记录转换终极指南从 Excel 手账到 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如果你是原神、星穹铁道或绝区零的玩家大概都经历过同一件事抽卡记录记在 Excel 里、截图里、备忘录里换一台电脑就全部断档。抽卡记录转换的核心就是把散落的数据收拢成一套通用格式。本文以开源工具 HoYo.Gacha 为例用一条完整流程带你完成从 Excel 手账到UIGF 标准JSON 文件的转换一次标准化终身可复用。第一幕从一次换电脑说起为什么你的抽卡数据会乱还原现场Excel 手账的三大软肋很多玩家习惯用 Excel 记账日期一列、物品一列、星级一列。看起来井井有条但真到用的时候处处碰壁格式不统一——有人记2025/1/1有人记2025年1月1日还有人只写元旦。字段不全——缺卡池类型、缺保底计数事后无法回溯。无法互通——想换个抽卡分析工具对方要的是 JSON你的数据却困在.xlsx里。数据一旦困住价值就打折了概率算不准、保底说不清、换工具就要重记一遍。三种方言认识 UIGF 标准与它的兄弟格式要打破孤岛先要认识市面上常见的三种语言名称全称适用游戏一句话理解UIGF 标准统一可交换抽卡记录格式原神 / 星穹铁道 / 绝区零 等抽卡数据的普通话SRGF星穹铁道抽卡记录标准崩坏星穹铁道星铁专属的早期标准CSV逗号分隔值通用最朴素的表格交换格式HoYo.Gacha 同时支持 UIGF v2.0~v3.0经典版与 v4.0~v4.2新版、SRGF v1.0以及 CSV 导出。这意味着无论你的记录来自哪种工具都有通道可以汇入同一个仓库。第二幕认识引擎HoYo.Gacha 的导入导出转换器一张表看懂支持的格式打开 HoYo.Gacha进入账号的转换器入口你会看到导入Importer和导出Exporter两个对话框。它们的格式支持范围各不相同格式方向支持游戏可用版本Classic UIGF导入 导出原神v2.0 ~ v3.0Classic SRGF导入 导出星穹铁道v1.0UIGF新版导入 导出原神 / 星铁 / 绝区零 / 奇迹仙踪v4.0 ~ v4.2CSV仅导出全部—技巧提示跨游戏合并记录时优先选新版 UIGF。它用一个 JSON 文件就能装下多个游戏、多个账号的数据是真正的全家桶格式。导出与导入的分工导出Exporter把本地数据库里的记录翻译成指定格式的文件输出到你自己选的文件夹。导入Importer把别人或旧工具导出的标准文件读回本地数据库自动去重、补全。两者共同构成了进得来、出得去的闭环这正是数据流通的关键。转换选项pretty、minimized 是什么意思导出时你会看到几个开关别被英文吓到选项含义建议Pretty输出美化排版的 JSON方便人读排查问题时打开Minimized精简字段只保留最小必要信息追求文件体积时打开Without Columns导出 CSV 时不带表头与特定工具对接时使用⚠️注意警告Minimized 会省略物品名、类型等冗余字段如果接收方工具依赖这些字段请保持关闭。第三幕备料把 Excel 整理成可转换的规范数据对照这份字段清单检查你的表格转换前先确认你的 Excel 里有没有这些关键列。缺了它们转换后必然出问题抽卡时间——建议统一为YYYY-MM-DD HH:mm:ss格式物品名称——如神里绫华夜兰星级——纯数字3 / 4 / 5不要写五星卡池类型——角色、武器、常驻、新手等UID——账号归属标识一个文件只属于一个账号技巧提示在 Excel 中预先设置数据验证限定时间和星级列的输入格式能大幅降低后续转换的错误率。三步体检透视表、去重、时间格式化建议在转换前花三分钟做一次体检用数据透视表统计各星级数量和游戏内记录比对确认没有整行遗漏。用删除重复项清理明显的重复行。全选时间列统一单元格格式为yyyy-mm-dd hh:mm:ss。从 Excel 出发的三条路径怎么选路径适用场景说明A. 官方接口直取记录长期在游戏内、Excel 已过时在工具中拉取官方数据权威且完整B. Excel 手工补录早年手账想抢救按字段清单整理后逐批录入工具C. CSV 中转数据在第三方表格工具里先另存为 CSV再按标准对齐导入进阶玩法路径 A 是效率最高的——HoYo.Gacha 能直接读取浏览器缓存生成抽卡链接并拉取全量记录相当于把官方账本直接搬回家比任何手工表格都可靠。第四幕实战从手账到 UIGF 标准 JSON 的完整流程第一步确认账号与记录归属在工具中先确保账号存在且 UID 正确。UID 是整条流程的锚点——导出文件会写入 UID导入时也会校验 UID 一致性任何错位都会导致失败。第二步选择导出格式与版本按你的目标选择导出格式只玩原神、要兼容老工具 →Classic UIGF v2.2 或 v2.3多游戏合并、面向新生态 →新版 UIGF v4.2需要二次加工数据 →CSV选定格式后选择目标文件夹工具会自动生成类似HoYo.Gacha_Uigf_100000000_20260814_132800.json的规范命名文件。第三步导出并验证 JSON 质量导出完成后建议做三件事验证质量打开 JSON检查info区的时间戳、version是否正确。抽查几条记录的time、rank_type、gacha_type。对比导出前后的记录总数确认零丢失。⚠️注意警告转换前务必备份原始 Excel建议用另存为创建副本再操作给回滚留一条后路。第五幕反向操作把标准文件导入你的数据仓库导入前的版本兼容检查导入时工具会先解析文件头部声明的版本号再与自身支持范围比对。超出范围的版本会直接拒绝并给出明确提示。因此收到别人的文件时先确认文件是 UIGF 还是 SRGF版本号是否在支持列表内UID 是否与你的目标账号一致冲突处理遇到重复记录怎么办导入对话框里有个SaveOnConflict冲突保存策略选项这是防重复的关键选项行为适用场景Nothing遇到重复 ID 直接跳过只想补漏不想动旧数据Update用新数据覆盖旧记录从别的工具迁入以新文件为准技巧提示第一次迁移建议选 Nothing跑完看统计数字再决定是否需要更新。导入后的完整性验证导入完成会弹出成功提示与变更条数。随后刷新记录列表核对总数是否与源文件条数吻合各卡池分类数量是否正常最新一条记录时间是否合理。确认无误后你的数据仓库就完成了吞并后续所有分析都会自动基于合并后的全集进行。第六幕原理拆解转换引擎内部的三层翻译官不懂原理也能用工具但懂了原理出问题时你能自己判断根源。HoYo.Gacha 的转换引擎位于tauri/src/business/converters.rs本质上是三个翻译官接力工作解析层听懂每一种方言这一层负责读取文件识别它是 UIGF、SRGF 还是 CSV并理解各自的字段结构。不同版本的 UIGF 字段要求不同——例如 v2.2 要求必须提供name和item_type而 v2.3 起改为必须提供item_id。解析层就像翻译官先听出对方说的是哪种话。映射层字段对齐与类型转换解析之后进入映射把源格式的字段逐一对应到内部统一的GachaRecord结构。这里有个典型的智能行为——卡池类型映射原神的角色活动2会被映射为标准的角色活动类型避免同一卡池在不同工具里被算成两种东西。校验层UID、时区与必填字段的层层把关最后是质量关卡转换引擎会逐条检查UID 校验格式合法且与账号一致时区换算按记录所在服务器的时区统一换算避免跨服时间差必填字段缺失关键字段的记录会报错并给出游标位置方便你定位问题行。进阶玩法导出时工具还会借助内置元数据把物品名翻译成你偏好的语言如英文界面导出英文名这一步在映射层自动完成无需手工替换。第七幕避坑手册三大高频问题的排查决策树问题一格式报错文件打不开或解析失败文件本身是否损坏用 Excel/WPS 尝试打开原文件能正常打开则排除损坏。表格结构是否规范确认第一行是表头且表头与标准字段对应。存在合并单元格或空行取消合并、删除空行后重试。仍失败用另存为 CSV中转一次再尝试导入。问题二转换后数据丢失或数量不符字段是否全部映射对照第三幕的字段清单检查 Excel 是否有未对齐的列。是否存在隐藏行/列取消隐藏后重新转换隐藏内容不会被读取。文件是否过大将 Excel 拆分为多个小文件分批转换逐批核对计数。问题三导入失败或记录错乱JSON 格式是否合法用任意 JSON 校验工具检查括号、引号与编码必须为 UTF-8。UIGF 版本是否匹配确认文件的version字段在工具支持范围内。UID 是否一致文件内 UID 与目标账号 UID 不同会直接拒绝导入。第八幕最佳实践可以直接照抄的行动清单数据管理黄金清单每次转换前备份原始 Excel另存为副本勿在原文件上操作。用数据透视表核对各星级总条数。统一时间格式删除重复项。每次转换后4. 对比转换前后记录总数。 5. 抽查时间戳、星级、卡池类型三个关键字段。 6. 将 UIGF 目标文件按日期归档保存。版本选择与长期维护版本选择面向新工具生态 → 新版 UIGF v4.2。需要兼容老工具 → Classic UIGF v2.2/v2.3。星铁老数据 → SRGF v1.0。长期维护4. 定期建议每版本更新后从官方接口刷新记录。 5. 每年导出一次 UIGF 全量备份存到不同介质。 6. 迁移电脑时同步带走本地数据库文件与最新导出文件。到这里你已经拥有了一条完整的数据流水线Excel 手账或官方数据 → HoYo.Gacha 本地仓库 → UIGF 标准 JSON。跨工具共享、跨游戏合并、概率分析、历史追溯全都建立在标准格式这一块地基上。记住数据标准化是第一步也是回报率最高的一步——现在就打开 HoYo.Gacha导出你的第一份 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考