higgsfield-game-generation

Higgsfield 游戏生成

创建一款完整、可玩的网页游戏并提供 URL，或仅制作所需的游戏素材。Higgsfield CLI 负责生成、发现 3D 动作、部署以及可选的市场发布。

初始化

开始前：

1. 如果无法使用 higgsfield，请安装它：

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

2. 如果 higgsfield account status 报告会话已过期或缺失，请让用户运行 higgsfield auth login，然后在用户确认后继续。
3. 对于完整游戏，在生成素材前确认 higgsfield game deploy --help 可正常运行。这是交付能力检查。
4. 定位已安装的此技能目录，并显式设置该目录：

   export GAME_SKILL="/absolute/path/to/higgsfield-game-generation"
   test -f "$GAME_SKILL/scripts/pipeline.py"
   python3 "$GAME_SKILL/scripts/pipeline.py" --help
   

   切勿凭记忆重新创建捆绑脚本。

确定请求路径

• 完整可玩游戏 — 按照下方完整工作流操作。
• 仅素材 — 阅读 references/stylization.md，然后阅读对应素材参考文件。不要部署游戏。
• 仅设计 — 阅读 references/game-design-system.md；返回所需的设计产物和素材清单。
• 迭代现有游戏 — 检查提供的源文件，保留其架构和未更改的素材，修改清单，重新构建、验证，并使用现有游戏 ID 重新部署。
• 预告片或宣传视频 — 使用 higgsfield-generate，而非此技能。
• 原生移动端／桌面端／主机运行环境 — 说明此技能交付的是浏览器游戏；除非用户提供了其他工具链，否则提供网页版本。

完整游戏工作流

1. 规划

首先完整阅读 references/game-design-system.md。确定游戏配置、交付场景、核心循环、胜负和重启机制、性能预算、输入方式以及语言处理方式。

创建 design/assets.csv，每种视觉或音频素材占一行：

id,role,type,description,size/ratio,style line ref,source

如果 Players 不是 solo，则阅读 references/multiplayer.md。本地同屏多人游戏仍由客户端处理；在线多人游戏需要平台服务器模块。

制作任何视觉内容（包括程序化 canvas 美术）前，先阅读 references/stylization.md。确定一个 STYLE FORMULA，并将其逐字节插入每条视觉提示词中。如果需求已指定风格，说明该公式后继续。如果有多种实质不同的风格都适用，请提供简洁选项并等待用户选择。

清单和 STYLE FORMULA 确定前，不得编写游戏代码或生成视觉内容。

2. 生成素材并构建

同时启动相互独立的生成任务，然后在任务运行期间编写游戏。首次使用前，检查每种模型的契约：

higgsfield model list --json
higgsfield model get <job_type>
higgsfield generate create <job_type> ... --wait --json

媒体标志接受本地路径或之前的上传／任务 ID。串联任务时，将任务 JSON 保存在项目文件中；不要在面向用户的回复中输出 ID。

阅读与清单中每一行对应的参考文件：

素材	必需的参考文件
静态精灵、背景、UI	references/stylization.md
精灵图集／2D 动画	references/2d-animation.md
可重复地面、墙壁、图块、PBR 贴图	references/textures.md
任何 3D 模型或动画	references/3d-animation.md
音乐、SFX、语音	references/audio.md

选择 3D 动画时：

higgsfield preset list animation-action --query walk --json
higgsfield preset list animation-action --group Fighting --category Punching --json

有多个动作适用时，展示其预览 URL 并让用户选择。检查目标模型架构后，再将所选整数作为 --animation_action_id 传入。

最后阅读 references/build-game.md，但必须在编写游戏代码前完成。将源文件打包为 ZIP，其中包含 index.html 和且仅有一个根目录代码模块（logic.js 或 server.js）。使用相对素材路径，并在交付的项目中保留 design/assets.csv。

生成失败时最多重试两次。之后，使用效果最佳的有效结果并在代码中补足，或如实修改清单。

3. 验证并交付

通过 HTTP（而非 file://）在本地运行游戏：

python3 -m http.server 8000

验证完整游戏循环、重新开始、资源缺失、控制台错误、自适应画布、通过 event.code 支持非拉丁键盘布局、移动端适用时的纯触屏操作、已声明的手柄控制、固定时间步行为，以及适用时在两个会话中测试多人游戏。

从包含必需根目录文件的目录打包：

zip -r /absolute/path/to/game.zip . -x '*.DS_Store' 'node_modules/*' '.git/*'
higgsfield game deploy /absolute/path/to/game.zip \
  --title "<public title>" \
  --description "<player-facing description>" \
  --thumbnail "<optional https 16:9 image URL>" \
  --favicon "<optional https 1:1 image URL>" \
  --json

更新时，添加 --game-id <existing_game_id>；更新失败后绝不可省略此参数，否则会创建另一个游戏。

部署会创建可玩 URL。发布到公共市场是单独的外部操作，必须有用户明确意图：

higgsfield game publish <game_id> \
  --name "<optional listing name>" \
  --description "<optional listing description>" \
  --cover-url "<optional https 16:9 URL>" \
  --logo-url "<optional https 1:1 URL>" \
  --json

重新打开返回的可玩 URL，并重复关键冒烟测试流程。交付 CLI 返回的 URL；绝不可手动构造 URL。

参考资料顺序

对于完整游戏：

1. references/game-design-system.md
2. Players 不是 solo 时，使用 references/multiplayer.md
3. references/stylization.md
4. 条件适用的资源参考资料
5. references/build-game.md

完整阅读每份选定的参考资料。不要加载无关的参考资料。

仅在所属流程需要时打开以下辅助参考资料：

• references/client-reference.md — 在线客户端协议。
• references/kernel-reference.md — 平台房间内核契约。
• references/logic-reference.md — 回合制／事件驱动规则模块。
• references/meshy-api.md — 仅用于原始 Meshy 备用方案。
• references/meshy-input-rules.md — 提交任何图像转 3D 任务前必须阅读。
• references/procedural-animation.md — 非人形程序化骨骼绑定。

UX 规则

• 使用与用户相同的语言；生成提示词使用英语。
• 面向用户的进度更新应简短，并描述游戏，而非内部关卡、阶段编号、任务 ID 或工具机制。
• 只在答案会实质性改变游戏时提问。不要把无关问题合并提问。
• 为生成资产和程序化资产保持统一的视觉系统。
• 不要在聊天中索要密钥。只有在原生 Higgsfield 3D 模型不可用时，原始 Meshy 备用方案才可使用用户配置的环境密钥。
• 除非用户要求发布到市场，否则不要公开发布。

输出

• 仅设计：用户要求的设计产物以及 design/assets.csv。
• 仅资产：可用文件／结果 URL 及其清单角色。
• 完整游戏：经验证的可玩 URL、一句话游戏玩法摘要；仅在明确发布时提供市场 URL。