开始前的准备

选择接入路线

Combos 是浏览器原生（H5）游戏平台，玩家打开链接即可进入游戏。CLI 接入上传的是能在浏览器运行的静态网页成品，通常整理在名为 dist 的目录中。dist 是本教程统一使用的成品目录名称；自己的输出目录可以叫 build 等其他名称，上传时填写实际路径即可。

使用哪种制作工具不改变最后的交付格式。安装 Combos CLI 不要求 Node.js、Unity 插件或 SDK；Vite 工程需要 Node.js，Unity 导出需要 Unity 官方 Web Build Support，这些属于各自项目的制作环境。

认识项目目录、dist 和浏览器地址

my-game/                      # 项目根目录：打开终端的位置
├── 源文件或引擎工程/          # 用来继续开发，保留在自己的环境
├── dist/                      # 网页成品：上传这个目录的内容
│   ├── index.html             # 浏览器入口
│   └── JS、CSS、图片、模型等   # 或 Unity 的 Build / TemplateData 等
├── cover.png                  # 封面图，首次创建游戏时使用
└── combos.json                # 发布后自动生成，记录当前游戏绑定

进入目录时，可以在 Codex 中打开整个项目文件夹并使用它的终端，也可以使用系统终端。macOS / Linux 使用下面的 cd；Windows PowerShell 使用 Set-Location。将引号里的路径替换成自己的项目完整路径，有空格也保留引号。

cd "/你的项目完整路径"
pwd
ls

Set-Location "C:\你的项目完整路径"
Get-Location
Get-ChildItem

成功现象： 终端显示自己的项目路径，文件列表中能看到 dist 和 cover.png。如果还没有 dist，先按所选路线构建。路径写错时先修正当前目录，再执行后面的命令。

在 Codex 里制作，文件在哪里？

本机 Codex / Cursor 通常在所选工作目录里生成和修改文件。它是制作入口，生成的 HTML、JavaScript、模型和 dist 仍然是项目文件。让 Agent 明确告诉你项目路径、构建方式和成品路径，再进行发布。

如果使用云端 Coding 环境，文件可能位于云端工作区。可以在同一个有 CLI 的环境中构建和上传，也可以把工程下载到自己的电脑后构建和上传。云端的 127.0.0.1 不等于自己电脑的 127.0.0.1；使用该工具提供的预览入口，或下载后启动本地服务验证。

请检查当前工作区里的这个游戏，并告诉我：
1. 项目的完整路径和进入项目的方式。
2. 它是直接 HTML + JS，还是需要用构建工具或引擎导出。
3. 如何生成包含 index.html 的完整网页成品，以及成品目录路径。
4. 如何启动预览、在哪个浏览器地址打开，并检查主要玩法。
完成检查后再按[发布与更新](/docs/integration/publishing)发布到 Combos。

分清可以执行的命令和案例代码

来源：Combos 开发者接入指南 。原文核对日期：2026-10-08，CLI v1.14.2；案例结果为原文记录的实测结果。