产物包格式与 8MB 限制

小工具最终要打成一种平台能接纳的「包」。GenUI 对包形态、体积、文件类型都有明确限制，提交前必须达标。

两种包形态

1. 单 HTML 文件：整个小工具就是一个 index.html，所有 CSS/JS 内联其中。适合轻量工具。
2. ZIP 压缩包：多文件工程打成 ZIP，解压后根目录必须有 index.html。适合资源较多的工具。

实战中的两个工具都采用了单 HTML 形态（二维码生成器约 79KB、万象云档速查约 64KB），把库代码、样式、数据全部内联进一个文件，最省事也最不容易踩资源路径的坑。

入口与目录约定

• 产物入口必须是根目录的 index.html（单文件形态），或 ZIP 解压后根目录的 index.html。
• 若用多文件，资源建议平铺在 static/ 下，避免过深的嵌套目录导致路径问题。

8MB 体积上限

产物（单 HTML 或 ZIP）总大小不得超过 8MB。这对「内置数据 + 内联库」的轻工具完全够用，但如果你打算塞入大量图片或长视频，就要警惕。万象云档 440 本数据快照仅 29.8KB，说明轻量数据完全不成问题。

文件后缀白名单

包内所有文件必须落在白名单后缀内，否则会被拒：

html  css  js  png  jpg  gif  webp  svg  woff  woff2  json

任何不在列表里的类型（如 .exe、.zip 内的非白名单文件、.mp4 等）都会违规。

ZIP 格式要求

如果使用 ZIP 形态，必须用标准 deflate 压缩，不要用非标准或加密压缩，否则平台解包可能失败。普通 zip -r 默认即是 deflate，一般无需特别处理。

小结

产物格式三句话记住：入口是根目录 index.html、体积 ≤ 8MB、文件后缀在白名单内。单 HTML 内联是最稳的形态，能单文件就别 ZIP。