Resprite 命令行导出（CLI）：实验性 CLI 工具快速开始
CLI 是什么
Resprite DA v1.30.0+ 引入了一个实验性的命令行工具（CLI）——可以在不打开 Resprite GUI 的情况下，把已保存的 .resprite 工程批量导出为各种格式。
适合什么场景
- 构建管线自动化：CI/CD 里自动把 Resprite 工程导出为精灵表、PNG、JSON 元数据，然后交给游戏引擎构建。
- 批量处理：一次性把一整个文件夹里的 20 个
.resprite工程全部导出。 - 无人值守：服务器上跑（不依赖显示卡）。
CLI 目前标记为实验性——接口可能在未来版本调整。iOS 端不支持（CLI 是 DA 版特性）。
快速开始
CLI 的安装位置在 Resprite DA 版的安装目录下。在桌面端 Resprite 菜单 ▸ 帮助 ▸ CLI 快速开始 里有完整指引。
基本用法
resprite-cli export --input "path/to/project.resprite" --output "path/to/export/" --format spritesheet核心参数
| 参数 | 说明 | 示例 |
|---|---|---|
--input | 要导出的 .resprite 文件路径 | input/hero.resprite |
--output | 导出目标目录 | output/spritesheets/ |
--format | 导出格式 | png / spritesheet / gif / aseprite / psd / json |
--scale | 放大倍数 | 2 |
--clip | 只导出某个 Clip | --clip "Idle" |
--config | JSON 配置文件路径（批量任务） | --config export-config.json |
批量导出 JSON 配置
更复杂的导出场景可以写一份 JSON 配置文件，Resprite CLI 一次性执行：
{
"tasks": [
{
"input": "input/hero.resprite",
"output": "output/",
"format": "spritesheet",
"scale": 2,
"splitByClip": true
},
{
"input": "input/ui.resprite",
"output": "output/",
"format": "png",
"scale": 1,
"eachFrame": false
}
]
}调用：
resprite-cli export --config export-config.jsonCLI vs GUI 导出
| 对比 | CLI | GUI（菜单 ▸ 导出） |
|---|---|---|
| 可用平台 | DA 版（桌面 / Android） | 全平台 |
| 批量 | ✅ 自然支持 | ⚠️ 需逐文件手动 |
| 自动化 | ✅ 可接入 CI/CD | ❌ 不行 |
| 参数精细度 | ⚠️ 略有限（部分 GUI 参数 CLI 不支持） | ✅ 最全 |
| 进度查看 | ✅ 命令行实时进度条 | ✅ 对话框进度条 |
CLI 目前不读取 GUI 里的导出设置——每次都需要独立指定参数。如果你在 GUI 里习惯了一套导出参数（比如精灵表的帧间距、放大倍数、拆分规则），用 CLI 时需要重新在 JSON 里配。
CLI 的更多功能
除了导出，Resprite CLI 还支持：
| 功能 | 命令 | 说明 |
|---|---|---|
| 工程检查 | resprite-cli check | 检查 .resprite 工程是否有问题（损坏、元数据缺失等） |
| 预演（Dry Run） | --dry-run | 不实际导出，只打印如果导出会做什么 |
| 批量任务 | --config | JSON 配置文件驱动 |
一个实际场景
你在做一个独立游戏，角色动画用 Resprite 画了 12 个 .resprite 工程。你希望每次构建游戏时自动把这 12 个工程导出为精灵表 PNG + JSON：
- 写一份 JSON 配置，列出 12 个输入文件、统一的导出参数（放大倍数、按 Clip 拆分、命名规则）。
- 构建脚本里加一行
resprite-cli export --config build-config.json。 - 每次构建自动执行，12 个 Resprite 工程全部导出为精灵表。
整个过程你不需要打开 Resprite——完全自动化。
边界提示
- CLI 是实验性功能，接口可能变动。升级 Resprite 版本后记得检查 CLI 参数是否仍然有效。
- CLI 不支持所有 GUI 选项——某些高级导出参数（比如 GIF 抖动强度、拼豆图纸水印）CLI 目前还做不到。
- iOS 端不支持 CLI——CLI 是桌面 / Android 独占功能。
功能可能随版本变化，CLI 持续完善。以官方最新 CLI 快速开始文档为准。