news 2026/3/20 14:31:18

Excel抽卡记录无损转换JSON全流程指南：从数据拯救到深度分析

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Excel抽卡记录无损转换JSON全流程指南：从数据拯救到深度分析

Excel抽卡记录无损转换JSON全流程指南：从数据拯救到深度分析

【免费下载链接】HoYo.Gacha✨ An unofficial tool for managing and analyzing your miHoYo gacha records. (Genshin Impact | Honkai: Star Rail) 一个非官方的工具，用于管理和分析你的 miHoYo 抽卡记录。（原神 | 崩坏：星穹铁道）项目地址: https://gitcode.com/gh_mirrors/ho/HoYo.Gacha

在《原神》《崩坏：星穹铁道》等游戏中，抽卡记录是玩家重要的游戏数据资产。许多玩家通过Excel表格手动记录抽卡历史，但这些非结构化数据无法直接被专业分析工具识别。本文将系统讲解如何将Excel抽卡记录无损转换为标准化JSON格式，帮助玩家盘活历史数据，解锁专业级抽卡分析能力。

一、问题诊断：抽卡数据的困境与破局

1.1 常见数据痛点分析

抽卡记录在Excel中通常面临三大问题：格式混乱（无统一表头）、数据残缺（缺少关键字段）、兼容性差（无法导入分析工具）。这些问题导致宝贵的抽卡数据无法发挥应有价值。

1.2 数据健康度检测清单

在转换前需检查Excel文件是否包含以下核心字段：

  • ✅ 抽卡时间（精确到秒）
  • ✅ 物品名称（角色/武器全称）
  • ✅ 稀有度（星级）
  • ✅ 卡池类型（角色/武器/活动限定）
  • ❌ 缺少上述任意字段将影响转换质量

1.3 典型错误案例

❌时间格式错误："2023/12/1" 应标准化为 "2023-12-01 15:30:22"
❌名称不规范："胡桃(1命)" 应简化为 "胡桃"
❌缺少唯一标识：未记录卡池ID导致无法区分不同时期的UP池

二、解决方案：数据重生路径设计

2.1 转换架构设计

采用"三阶段翻译"模型实现数据标准化：

  1. 语法解析：将Excel表格结构转换为机器可识别的中间格式
  2. 语义映射：建立字段对应关系（如"品质"→"rarity"）
  3. 格式生成：输出符合UIGF标准的JSON文件

2.2 格式解剖图

UIGF v2.2标准核心字段解析：

{ "info": { // 元数据区 "uid": "123456789", // 玩家ID "lang": "zh-cn", // 语言代码 "export_time": 1672502400 // 导出时间戳 }, "list": [ // 抽卡记录数组 { "time": "2023-12-01 15:30:22", // 抽卡时间 "name": "胡桃", // 物品名称 "item_type": "角色", // 类型 "rank_type": "5", // 星级 "gacha_type": "301", // 卡池类型ID "id": "1672502400000" // 唯一记录ID } ] }

2.3 数据安全防护网

  • 🔒原始数据备份：转换前务必另存Excel文件为".xlsx.bak"
  • 🔒校验机制：启用MD5校验确保转换前后数据一致性
  • 🔒增量转换：对大型文件采用分片处理，避免内存溢出

三、实战操作：三步式转换执行

3.1 准备阶段 ⌛10分钟

  1. 环境配置

    • 安装Node.js环境（v16+）
    • 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/ho/HoYo.Gacha
    • 安装依赖：cd HoYo.Gacha && pnpm install

  2. Excel预处理

    • 删除合并单元格和空行
    • 标准化表头为：时间、名称、类型、星级、卡池
    • 保存为".xlsx"格式（不支持".xls"旧格式）

3.2 执行阶段 ⌛5分钟

  1. 使用HoYo.Gacha转换工具

    # 启动转换服务 pnpm run convert:excel # 按照提示选择Excel文件 # 选择输出格式为"UIGF v2.2" # 设置输出路径（默认为./output）

  2. 替代工具选项

    • 工具A：Excel2UIGF在线转换器
      ✅ 优点：无需安装，支持拖放操作
      ❌ 缺点：单次转换限制10MB，不支持批量处理

    • 工具B：Python脚本转换器
      ✅ 优点：可自定义字段映射，适合开发者
      ❌ 缺点：需要基础编程知识

    • 工具C：Google Sheets插件
      ✅ 优点：云端处理，支持多人协作
      ❌ 缺点：依赖网络，隐私敏感数据不建议使用

3.3 验证阶段 ⌛3分钟

  1. 基础验证

    • 使用JSON在线校验工具检查语法合法性
    • 核对记录总数是否与Excel一致
    • 随机抽查10条记录的字段完整性

  2. 深度校验

    # 使用项目内置验证工具 pnpm run validate:uigf --file ./output/uigf.json

    ✅ 验证通过提示：Validation passed: 1250 records detected
    ❌ 常见错误：Error: Missing required field 'gacha_type' in record 45

四、数据修复：残缺记录的挽救方案

4.1 时间戳修复

当Excel中仅记录日期无具体时间时，可使用批量填充：

# 公式示例：在空白时间列输入 =A2 & " 12:00:00" # 将日期列A2转换为标准时间格式

4.2 卡池类型补全

通过物品名称和获取时间反推卡池类型：

  1. 从项目src/assets/images/GenshinImpact/Character/目录获取角色发布时间
  2. 使用VLOOKUP函数匹配卡池信息
  3. 批量填充卡池类型ID

4.3 名称标准化

处理别名和简称问题：

// 简易映射示例（可在转换工具中配置） const nameMap = { "胡堂主": "胡桃", "公子": "达达利亚", "雷神": "雷电将军" }

五、价值延伸：从数据到决策

5.1 批量转换技巧

处理多账号/多游戏记录：

# 批量转换脚本示例 for file in ./excel/*.xlsx; do pnpm run convert:excel --input "$file" --output ./output/$(basename "$file" .xlsx).json done

5.2 抽卡数据分析入门

  1. 保底概率计算

    // 计算当前保底计数 const countUntilPity = 90 - lastFiveStarIndex;

  2. 角色获取成本分析

    • 统计特定五星角色的平均抽数
    • 计算不同时期卡池的出货率差异

  3. 可视化报告生成使用HoYo.Gacha内置的分析功能生成：

    • 抽卡时间分布热力图
    • 星级分布饼图
    • 保底触发频率折线图

5.3 格式对比表

格式优点缺点适用场景
Excel易编辑、可视化强结构松散、工具不兼容手动记录阶段
GWE中间格式、转换灵活非标准格式、用途单一格式转换过程
UIGF v2.2标准化、工具兼容广可读性差、需专用工具查看长期存储和分析

知识加油站💡
UIGF格式由"原神抽卡记录统一格式"组织维护，最新版本为v2.3，增加了对崩坏：星穹铁道的支持。建议定期更新转换工具以获得最佳兼容性。

通过本文方法，你不仅能完成抽卡记录的格式转换，更能建立完整的数据管理流程。这些标准化数据将为你的游戏策略提供有力支持，让每一次抽卡都更加理性和高效。

【免费下载链接】HoYo.Gacha✨ An unofficial tool for managing and analyzing your miHoYo gacha records. (Genshin Impact | Honkai: Star Rail) 一个非官方的工具，用于管理和分析你的 miHoYo 抽卡记录。（原神 | 崩坏：星穹铁道）项目地址: https://gitcode.com/gh_mirrors/ho/HoYo.Gacha

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/3/18 19:15:36

YOLOE支持多语言提示吗？英文之外还能怎么用

YOLOE支持多语言提示吗？英文之外还能怎么用 你刚在终端里敲下 python predict_text_prompt.py --names person dog cat，YOLOE瞬间框出了图像中所有目标——但等等，如果把 cat 换成中文“猫”，模型还识得吗？当你的业务场…

作者头像 李华
网站建设 2026/3/20 6:00:03

轻量级无广告开源小说阅读器：ReadCat全场景使用指南

轻量级无广告开源小说阅读器：ReadCat全场景使用指南 【免费下载链接】read-cat 一款免费、开源、简洁、纯净、无广告的小说阅读器 项目地址: https://gitcode.com/gh_mirrors/re/read-cat 在数字阅读日益普及的今天，一款真正以用户体验为核心的阅…

作者头像 李华
网站建设 2026/3/13 6:29:12

ncmppGui使用指南：解锁网易云音乐ncm文件的全方位解决方案

ncmppGui使用指南：解锁网易云音乐ncm文件的全方位解决方案 【免费下载链接】ncmppGui 一个使用C编写的转换ncm文件的GUI工具 项目地址: https://gitcode.com/gh_mirrors/nc/ncmppGui 当你在网易云音乐下载了喜爱的歌曲，却发现这些ncm格式文件无法…

作者头像 李华
网站建设 2026/3/14 5:04:20

HashCheck完全指南：从入门到精通的文件校验实践手册

HashCheck完全指南：从入门到精通的文件校验实践手册 【免费下载链接】HashCheck HashCheck Shell Extension for Windows with added SHA2, SHA3, and multithreading; originally from code.kliu.org 项目地址: https://gitcode.com/gh_mirrors/ha/HashCheck …

作者头像 李华
网站建设 2026/3/14 22:51:41

解锁日志分析高效定位秘诀：从入门到精通的实战指南

解锁日志分析高效定位秘诀：从入门到精通的实战指南 【免费下载链接】glogg A fast, advanced log explorer. 项目地址: https://gitcode.com/gh_mirrors/gl/glogg 你是否曾遇到在海量日志中艰难搜寻关键错误信息的困境？是否因日志格式混乱而错失系…

作者头像 李华