開始前的準備

選擇接入路線

Combos 是瀏覽器原生（H5）遊戲平台，玩家打開連結即可進入遊戲。CLI 接入上傳的是能在瀏覽器運行的靜態網頁成品，通常整理在名為 dist 的目錄中。dist 是本教程統一使用的成品目錄名稱；自己的輸出目錄可以叫 build 等其他名稱，上傳時填寫實際路徑即可。

你的專案	先準備什麼	對應章節
已經能運行的 H5 成品	包含 index.html 和全部網頁資源的目錄	發布與更新：通用發佈流程
直接 HTML + JavaScript	整理入口 HTML、JS、CSS 和資源；無需編譯	準備 H5 成品
Vite / Webpack 等工程	用專案自己的建置指令生成靜態成品	準備 H5 成品
Unity 遊戲	使用 Unity 原生 WebGL 匯出整個成品目錄	Unity 原生匯出
Roblox 遊戲	先在瀏覽器引擎中重實現或適配資產、人物與玩法	Roblox 遊戲移植

使用哪種製作工具不改變最後的交付格式。安裝 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                # 發佈後自動生成，記錄當前遊戲綁定

名稱	含義	本教程的例子
專案根目錄	整個工程所在的資料夾；先讓終端機進入這裡	桌面 Move to Combos/native-h5
`./dist`	`./` 是終端機當前目錄；因此它指當前目錄下的 dist	在 native-h5 根目錄執行上傳，讀取 native-h5/dist
`http://127.0.0.1:8000/`	本機 HTTP 服務提供的地址；只在相應服務運行時可用	本機瀏覽器試玩地址，不是發佈連結
Combos 分享連結	上傳後返回的線上地址	發給玩家試玩，不依賴本機預覽服務

進入目錄時，可以在 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 --version`
需替換參數	先換成自己的路徑、標題、封面或設備，再執行	`cd "/你的项目完整路径"`
僅本案例	用於跟做此案例；接入自己的遊戲時按自己的工程調整	BoatAttack 固定 commit、Ball Game 坐標
原始碼對照	解釋案例如何實現；不是終端機指令，也不是通用遷移腳本	Lua 的 Touched 與 JavaScript 接觸回調

來源：Combos 開發者接入指南。原文核對日期：2026-10-08，CLI v1.14.2；案例結果來自原文記錄的實測。