jq
用命令行筛选转换 JSON,串起 AI 资产管线。
🧠 在 AI 创作链路中的位置
转换 AI 产出的结构化数据,使其符合游戏管线要求。
所属阶段:🔗 工作流 · 传统工具,负责把 AI 产物打磨/接入到可交付的管线里
工具介绍
免费开源的命令行 JSON 处理器,可通过简洁查询表达式筛选字段、重排结构、批量转换和输出数据。适合处理 AI 或引擎产生的角色、物品、对话与任务数据,并能接入 Shell、CI 和批处理流程,完成可复现的资产整理。
核心能力
- 表达式筛选 JSON 字段
- 批量重排与转换数据
- 支持命令行管道组合
- 便于接入自动化流程
👍 优点
- 批处理效率高
- 可复现且易自动化
- 跨平台可用
⚠️ 局限
- 学习表达式有门槛
- 大型嵌套数据调试不便
典型使用场景
- 整理 AI 对话数据
- 转换物品与任务配置
- 批量导出模型元数据
- 接入资产校验脚本
使用教程
- 1
安装并检查 jq
前往官网 jq 官网下载对应系统版本,或通过 Homebrew、Chocolatey 安装;终端运行 jq --version,确认命令可用。
- 2
准备 JSON 输入
将示例数据保存为 data.json,根节点可以是对象或数组。执行 jq . data.json,检查语法并熟悉 jq 的标准输出。
- 3
筛选目标字段
用点号读取对象字段,如 jq .user.name data.json;数组使用方括号和索引,如 jq .players[0].id data.json。
- 4
过滤数组元素
使用选择器匹配条件,例如 jq '.items[] | select(.level > 10) | .name' data.json;管道符表示把上一步结果交给下一步。
- 5
映射与重组数据
使用对象和数组构造新结构,例如 jq '{names: [.users[].name], count: (.users | length)}' data.json,生成精简结果。
- 6
接入管道并保存
将 curl 获取的接口数据交给 jq,如 curl -s https://example.com/api | jq '.data[] | {id, name}';用重定向保存为 result.json。
💡 实用技巧
- 先运行 jq . 验证输入格式
- 用 --arg 传入外部变量
- 用 -r 直接输出纯文本
- 复杂查询拆成多段管道
⚠️ 常见坑
- 单引号可避免 Shell 提前解析表达式
- 点号访问对象,数组索引从零开始
完整图文教程:jq 入门:从安装到提取 JSON
📖 同类工具怎么选
本分类负责把 AI 生成的视频、地图、数值表和资源包转化为可编辑、可校验、可集成的工程资产。应按目标引擎、资产格式、自动化程度与可回溯性选型,并先统一目录、命名和数据规范,再衔接生成、编辑、验证与发布流程。
阅读《AI游戏资产与关卡管线总览》同类工具推荐
FFmpeg
批量转码与裁切 AI 视频素材,快速生成可交付的宣发内容。
DaVinci Resolve
精剪、调色并交付 AI 生成的宣传片与游戏实机视频。
Tiled 地图编辑器
承接 AI 生成的瓦片与场景,搭建可交付的二维游戏地图
World Machine
把 AI 生成的地形思路转成高度图,服务大型场景制作
Hammer 关卡编辑器
把 AI 生成的关卡方案搭成空间结构,并接入 Source 2 制作管线。
JSON Schema 校验器
校验 AI 生成的游戏配置数据,提前拦截格式与字段错误。
AssetStudio
导出游戏资源供 AI 提取、重制或作为生成参考。
AssetRipper
还原 Unity 游戏资源,为 AI 改作与资产研究提供素材。