小红书小工具上传：ZIP 结构与问题检查

先确认：上传的是运行包

小红书小工具 ZIP 应包含可离线运行的页面与资源。本指南采用 Start Fast 当前离线交付规范，具体文件类型、体积限制与发布资格请以提交时的官方页面为准。

tool.zip
├── index.html
├── main.js
├── style.css
└── assets/
    └── cover.png

解压后的顶层直接看到 index.html。如果先看到 dist/ 或项目名称文件夹，再进入才能找到入口，就多套了一层目录。应压缩目录内的文件，而不是目录本身。

检查资源与交互脚本

• 页面中的脚本、图片、样式和字体应随包提供，使用如 ./assets/cover.png 的相对路径。
• 按本期交付规则，将脚本写入独立 .js 文件，通过 <script src="./main.js"></script> 加载；用事件监听绑定按钮。
• 不要依赖在线 CDN、接口请求、内联事件或动态执行代码。构建工具的源码不能直接代替运行产物。
• 移除 node_modules、.git、构建配置与 source map。发布说明、运营图片和 README 单独保存。
• 压缩图片、删掉未使用资源；平台尺寸和包体限制可能调整，提交时重新确认。

遇到上传或运行问题，从症状排查

找不到入口或打开白屏

先检查 ZIP 是否多套目录、入口名称是否正确、引用文件是否存在。核对文件名大小写与路径，不要只在电脑本地确认。

界面有了，按钮点不动

检查脚本是否加载，是否使用内联事件、模块脚本或容器不支持的能力。向编辑器反馈“在哪一页、点了什么、期望什么”，保留错误信息以便定位。

图片或字体消失

检查是否仍引用在线地址，或资源路径以 / 开头。把资源纳入包内并改为相对引用。

网页正常，真机异常

检查屏幕安全区、键盘遮挡、返回与保存动作。浏览器和平台容器的能力不同，不能只依赖网页预览。

提交前的最后一轮检查

1. 在编辑器修复阻断项，重新导出最终版本；不要用检查前的旧包。
2. 解压确认入口与资源；从开始到结果完成一次核心交互。
3. 准备名称、简介、图标和真实截图，避免使用无授权品牌或素材。
4. 在小红书官方入口核对资格、字段及最新要求，按页面流程提交。
5. 保存所提交 ZIP 的版本和反馈，在 Android 与 iOS 实际容器内验证。