Higgsfield CLI浏览器游戏发布：ZIP上传、Marketplace上架与3D动画目录，终端完成游戏上线

2026/11/3 2:22:18

【免费下载链接】cli

Higgsfield CLI

项目地址：https://gitcode.com/gh_mirrors/cli419/cli

Higgsfield CLI 是一款终端工具，本次更新的浏览器游戏发布功能让你无需打开网页后台，就能完成三件事：ZIP 上传游戏包、Marketplace 一键上架、3D 动画目录检索。无论你是独立开发者还是创意玩家，只需几条命令，就能在终端里把游戏从"本地压缩包"变成"线上可玩作品"。本文带你走完整套流程 🎮

一、30秒安装 Higgsfield CLI

开始前先装好工具。任选一种方式（跨平台都支持，Windows 用户建议用 npm）：

# 方式一：npm（推荐，跨平台） npm install -g @higgsfield/cli # 方式二：Homebrew（macOS / Linux） brew install higgsfield-ai/tap/higgsfield

安装脚本 install.sh 会自动校验下载包、写入higgsfield/higgs命令，并尽量创建hf快捷命令。安装完成后登录账号：

higgsfield auth login

二、ZIP 上传：部署一个浏览器游戏

游戏包格式要求很简单，一个 ZIP 压缩包，根目录里包含index.html，再加上logic.js（纯前端逻辑）或server.js（带服务端逻辑）二选一即可。

上传并部署只需一条命令：

higgsfield game deploy ./game.zip \ --title "Space Runner" \ --description "Fast arcade survival game" \ --thumbnail https://cdn.example/cover.png \ --favicon https://cdn.example/icon.png \ --json

参数	作用
`--title`	游戏标题
`--description`	一句话介绍
`--thumbnail`	封面图 URL
`--favicon`	站点图标 URL
`--json`	输出机器可读 JSON（含`game_id`，后面会用到）

🔁想更新同一款游戏？在命令后追加--game-id <game_id>，即可覆盖部署新版本，无需重新建档。

三、Marketplace 上架：让全世界发现你的游戏

注意一个关键细节：部署（deploy）≠ 上架（publish）。deploy 只是把游戏跑起来，上架到 Marketplace 是一个独立动作，这样你可以先内部测试、满意后再公开展示：

higgsfield game publish <game_id> --name "Space Runner" --json

执行成功后，你的游戏就会出现在 Higgsfield Marketplace 中，等待玩家点击开局 ✨

四、3D 动画目录：给你的角色挑动作

做 3D 游戏时，角色需要走路、出拳、战斗等动作。Higgsfield 内置了一个预制（rigged）3D 动画目录，先浏览、再选用：

# 按关键词搜索，比如找"走路"动作 higgsfield preset list animation-action --query walk # 按分组 + 分类精确筛选（格斗/出拳） higgsfield preset list animation-action --group Fighting --category Punching --json

从结果里记下animation_action_id，配合 3D 生成模型即可让角色动起来。相关参数（如--animation_action_id、--enable_animation）的详细定义，可查看 MODELS.md 中3d_rigging与image_to_3d两节的参数表。💪

五、常见问题快速排查

现象	解决办法
`Session expired`/`Not authenticated`	Token 有效期较短，重新执行`higgsfield auth login`
`Unknown model "<name>"`	执行`higgsfield model list`查看当前可用模型目录
deploy 报错 ZIP 不合规	检查根目录是否同时包含`index.html`和`logic.js`/`server.js`