准备 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；案例结果为原文记录的实测结果。