準備 H5 成品

直接 HTML + JavaScript：無需編譯

操作位置： 自己的 H5 專案目錄。

操作： 把 index.html、JS、CSS、圖片和其他資源放進 dist，並讓 HTML 正確引用這些檔案。沒有外部資源時也可以只有一個包含程式碼的 index.html。

成功現象： dist 根部直接有 index.html；按發布與更新啓動 HTTP 服務後能運行。

dist/
├── index.html
├── main.js
├── style.css
└── assets/        # 僅在遊戲使用資源時存在

無需 npm install 或 npm run build。這裡的 JS 就是瀏覽器運行的程式；本教程星星衝刺的免建置版位於原始碼附件裡的 plain/dist。如果自己的成品路徑是 plain/dist，上傳時使用 --dir ./plain/dist。

請把當前遊戲整理成可直接運行的靜態 HTML + JS 成品，放到 dist。檢查入口引用的 JS、CSS 和資源都能通過相對路徑載入。啓動 HTTP 預覽並告訴我地址，驗證主要玩法後按[發布與更新](/docs/integration/publishing)發佈。

Vite / Webpack 工程：使用自己的建置指令

操作位置： 有 package.json 的工程根目錄。

操作： 按專案 README 和 package.json 安裝依賴、開發和建置。Vite 專案設置相對 base；Webpack 使用專案自己的相對 publicPath 配置。下面指令僅適用於附件中提供的 Vite 工程。

成功現象： 建置成功，生成 dist/index.html 和完整資源；preview 打開的是最終成品。

npm ci
npm run dev
# 开发检查完成后停止 dev，再构建：
npm run build
npm run preview

import { defineConfig } from 'vite';
export default defineConfig({ base: './' });

本教程兩個 Vite 工程要求 Node.js 20.19+ 或 22.12+，實操使用 25.7.0。自己的專案以自身版本要求為準。npm run dev 用於開發，npm run build 生成成品，npm run preview 驗證成品；這些腳本名稱由專案定義，不是所有 H5 專案都必須有。

React、Vue 是界面框架，Vite、Webpack 是建置工具；可以使用，也可以直接編寫 HTML + JS。完成成品驗證後，統一按發布與更新上傳、線上試玩和更新。完整跟做範例見H5 · 星星衝刺。

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