SuperAPI AI 工具集

itch-publish

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:把游戏构建发布到 itch.io 页面并持续更新。页面在浏览器中创建,上传全部通过 itch.io 命令行工具 butler 完成,核心命令是 butler push;butler 会与上一次构建做差异比较,只上传变化的部分。

主要能力:创建/更新 itch.io 项目页;安装并登录 butler;用 butler push 上传构建、选择 channel 名称、为上传设置版本、发布 jam/demo/正式构建。触发词包括 butler push、butler login、channels、.itch.toml、publish on itch、upload to itch。

基本流程:在 itch.io/game/new 创建项目页,设置项目类型(本地构建保持 Downloadable,浏览器可玩游戏选 HTML)及定价/可见性(未就绪可设 Draft);从 itchio.itch.io/butler 下载 butler 并加入 PATH,执行 butler login(打开浏览器授权),用 butler version 验证;为了 CI 可使用 BUTLER_API_KEY。准备可移植的构建文件夹(玩家实际运行的文件,不要多余内容),推送文件夹或该文件夹的单个 .zip。推送命令:butler push <dir> <user>/<game>:<channel>,首次推送上传全部,之后推送到同一 channel 只上传差异。channel 名决定平台标签,如 win/windows→Windows、linux→Linux、mac/osx→macOS、android→Android,命名用小写加短横线。可用 --userversion 1.2.0 或 --userversion-file build.txt 指定版本;butler status <user>/<game> 查看 channel 与构建,butler push-preview 预览改动。

限制与注意:不要推安装程序(会破坏补丁和自动更新,且可能需要管理员权限),推解压后的可运行文件夹;不要推高度压缩包,否则补丁巨大;只含一个 .zip 的文件夹会被自动解压,除非用 --no-auto-unzip;HTML5 游戏需把页面 Kind 设为 HTML 并标记 channel 可在浏览器游玩,二者不会自动完成;--hidden 仅对新 channel 有效;channel 拼写错误会产生重复槽位;itch.io 拒绝未压缩总大小超过 30 GB 的构建;CI 日志泄露 BUTLER_API_KEY 需立即撤销。CI/CD、broth 自动安装、完整参数与更新检查 API 见 references/butler-ci.md。