什么项目可以直接上传？

项目必须是只依赖浏览器运行的纯静态网页。普通 HTML、CSS、JavaScript、图片、字体可以直接上传；React、Vue、Vite 等项目必须先构建，只上传 dist 等构建产物。ZIP 解压后的根目录必须包含 index.html。

• 资源路径应使用相对路径，例如 ./assets/app.js，避免 /assets/app.js、本机磁盘路径和 localhost。
• 不能依赖需要持续运行的 Node.js、Python、PHP、数据库、WebSocket 服务或私有后端。
• 不要把 API Key、密码、Token 写入前端文件；任何访问者都能查看网页源代码。
• 公开且允许跨域的第三方 API 可以使用，但断网、限流或接口变化会影响功能。
• 应用数据若使用 localStorage，只保存在当前浏览器，换设备或清除数据后会消失；Bookdock 不负责云同步。

可能需要新窗口打开的功能

摄像头、麦克风、剪贴板、OAuth 登录、弹窗、浏览器全屏和部分下载功能可能在隔离预览中受限。前台始终提供“新窗口打开”作为兼容方式。

上传前自检

1. 解压后根目录存在 index.html，而不是再套一层不必要目录。
2. 用静态服务器打开构建产物，检查页面跳转、刷新、图片和字体。
3. 打开浏览器控制台，确认没有 JavaScript 错误和资源 404。
4. 确认没有 .env、源码密钥、node_modules 或只供开发使用的配置。
5. 说明是否联网、使用哪些第三方 API，以及是否需要摄像头等权限。