如何发布 ZIP 网页应用
使用 GemiGo 发布 ZIP 网页应用，了解可直接发布的静态文件与需要构建的源码项目之间的区别。
先分清 ZIP 中的内容
已构建的静态网站包含 HTML 入口和其引用的资源。源码项目包含源文件，并可能声明构建脚本。GemiGo 直接发布静态文件，对声明构建步骤的受支持源码项目先执行构建。
1. 准备文件
把应用入口、资源和构建配置放在一起。源码项目需要包含构建脚本和依赖声明。不要打包 node_modules、私有密钥或含 Secrets 的环境文件，并确认输出可在浏览器运行。
2. 上传并发布
打开「发布应用」，选择 ZIP 并上传压缩包，按提示登录和发布。查看构建与部署状态。构建失败时，依据错误提示修正源码，再尝试发布。
3. 检查线上网站
成功后打开生成的链接，测试导航、资源加载和外部集成。可以分享链接，也可以通过项目设置继续更新。前端部署不会自动运行后端服务。
什么时候直接粘贴 HTML？
应用全部包含在单个 HTML 文档中时，直接粘贴可以省去打包。需要多份本地资源或源码构建时使用 ZIP。已有仓库也可以选择 GitHub 发布入口。
动手试一次：加法练习
这个示例由 GemiGo 编写，可离线运行，包含检查答案和换题功能，不调用外部接口。先在浏览器试用，再下载并通过相应发布入口上传。它是练习发布流程的示例，不承诺学习效果。
可直接发布的 ZIP 文件结构
addition.zip
├── index.html
└── styles.css这个 ZIP 的根目录就是网站根目录，不需要构建。index.html 用 <link rel="stylesheet" href="./styles.css"> 引用同一目录中的样式。上传 ZIP 后，检查样式和练习按钮。自己的图片可放入 assets/，在 HTML 中使用 ./assets/image.png 这样的相对路径。文件名大小写必须一致。
图片、样式或脚本加载不出来？
先直接打开资源的网址。如果返回 404，检查压缩包中的目录与引用路径；C:\、/Users/ 和 file:// 都是电脑本地路径，不能作为发布后的图片地址。没有 404 但页面空白时，查看浏览器控制台：外部 API 可能拒绝跨域请求，或网络请求需要登录。上传前删除私有凭据。
React、Vite 等源码要怎么打包？
已构建网站：先在本地执行项目的构建命令，将输出目录中的文件打包，例如把 dist/ 里面的 index.html 和 assets/ 放到 ZIP 根目录。源码发布：包含 package.json、依赖声明、源码和所需配置，由受支持的构建流程生成静态输出。构建成功但深层链接打不开时，检查应用路由和资源基础路径。