SheetJS
解析游戏策划表格,把配置数据批量接入资产与代码流程。
🧠 在 AI 创作链路中的位置
承接 AI 生成或策划维护的数据表,将其转换为可用游戏数据。
所属阶段:🔗 工作流 · 传统工具,负责把 AI 产物打磨/接入到可交付的管线里
工具介绍
开源 JavaScript 表格库,可读取、写入 Excel 等表格格式,适合把策划表、角色数值和本地化表批量导入游戏管线。跨平台运行,可用于清理生成式 AI 输出的结构化数据,但需自行处理字段校验与导出映射。
核心能力
- 解析多种表格格式
- 批量读取表格数据
- 写入结构化工作表
- 支持跨平台运行
- 便于接入自动化脚本
👍 优点
- 开源且部署灵活
- 适合批处理表格
- 易于接入现有管线
⚠️ 局限
- 缺少完整数据校验
- 需自行设计字段映射
典型使用场景
- 导入角色属性配置表
- 转换批量本地化文本
- 整理 AI 生成资产清单
- 导出测试数据记录
使用教程
- 1
准备运行环境
安装 Node.js 18 或更高版本,新建项目目录并执行 npm init -y,再通过 npm install xlsx 安装 SheetJS。
- 2
读取表格文件
新建 convert.js,使用 xlsx 的 readFile 方法加载本地 .xlsx 或 .csv 文件,并用 sheet_to_json 将首个工作表转成对象数组。
- 3
检查字段与数据
先打印转换结果的前几行,确认表头、中文字段、空值及数据类型;若首行不是表头,可在读取时设置 header: 1。
- 4
批量修改配置
遍历对象数组,按字段筛选或更新配置,例如将 status 改为 enabled;同时处理缺失字段,避免直接覆盖不存在的属性。
- 5
导出 JSON 和 CSV
使用 json_to_sheet 创建工作表,通过 book_new、append_sheet 和 writeFile 导出 .xlsx;CSV 可直接用 sheet_to_csv 后写入文件。
- 6
接入项目流程
将脚本加入 package.json 的 scripts,接收输入和输出路径参数,再通过 npm run 命令重复处理运营提供的配置文件。
💡 实用技巧
- 用 sheet_to_json 检查实际表头
- 统一日期和数字字段类型
- 大型表格可按文件分批处理
- 商业场景需确认授权范围
⚠️ 常见坑
- 不要默认第一张表就是目标数据
- 公式与格式不会完整保留
完整图文教程:SheetJS 入门:批量转换游戏配置表
📖 同类工具怎么选
本分类负责把 AI 生成的视频、地图、数值表和资源包转化为可编辑、可校验、可集成的工程资产。应按目标引擎、资产格式、自动化程度与可回溯性选型,并先统一目录、命名和数据规范,再衔接生成、编辑、验证与发布流程。
阅读《AI游戏资产与关卡管线总览》同类工具推荐
FFmpeg
批量转码与裁切 AI 视频素材,快速生成可交付的宣发内容。
DaVinci Resolve
精剪、调色并交付 AI 生成的宣传片与游戏实机视频。
Tiled 地图编辑器
承接 AI 生成的瓦片与场景,搭建可交付的二维游戏地图
World Machine
把 AI 生成的地形思路转成高度图,服务大型场景制作
Hammer 关卡编辑器
把 AI 生成的关卡方案搭成空间结构,并接入 Source 2 制作管线。
JSON Schema 校验器
校验 AI 生成的游戏配置数据,提前拦截格式与字段错误。
AssetStudio
导出游戏资源供 AI 提取、重制或作为生成参考。
AssetRipper
还原 Unity 游戏资源,为 AI 改作与资产研究提供素材。