导入和预览问题

先看错误发生在哪一步：文件还没有导入，检查文件；本地能看到、交互不工作，检查预览环境；正式网站或共享链接打不开，检查链接和发布状态。

文件导入失败

页面提示或现象	如何处理
ZIP 无法读取	先在本机解压检查，再重新压缩为普通 ZIP；不要只把其他压缩格式改名为 .zip。
根目录需要非空 index.html	确认文件名和大小，打开所选输出目录时应直接看到首页。制作 ZIP 时，建议选中输出目录内的文件和子目录压缩，让第一层直接出现 index.html。
项目需要服务端运行环境	上传静态构建或导出结果。需要服务端渲染、API、数据库的部分请放在单独的后端。
文件过多或体积超限	删除源码、依赖目录和不需要的构建文件，压缩大图片，再按页面当前限制重试。ZIP 体积小不代表解压后符合限制。
HTML 编码异常或显示乱码	将 HTML 保存为 UTF-8，加入 <meta charset="utf-8"> 后重新上传。

修正后重新选择文件。单个 HTML 可以点「编辑代码」调整；应等错误消失、预览内容更新且「生成预览链接」可用，再继续。

图片或样式缺失

1. 多文件网站请上传整个输出目录或 ZIP，单独上传 HTML 不会带上旁边的图片和 CSS。
2. 保留相对路径，例如 images/cover.jpg；不要引用自己电脑上的 C:\...、/Users/... 或 file://...。
3. 核对文件名大小写，避免 Cover.jpg 与 cover.jpg 不一致。
4. 本地预览禁用网络请求，外部资源要在生成的共享链接中检查。

按钮、动画或接口在本地不工作

本地预览禁用 JavaScript 和网络请求。先检查静态布局，再生成共享链接，在新窗口检查实际交互。如果共享链接也异常，检查浏览器控制台和网络请求，确认前端 API 地址、HTTPS 和跨域设置。

浏览器能访问到的代码都不能保存私密 API 密钥、数据库密码或其他凭证。这些应放在单独的后端。

显示“暂时无法显示网页预览”

这是控制台的内嵌预览提示，需要与网站本身的状态分开判断：

1. 点击「打开网站」，在新窗口打开当前链接。
2. 新窗口正常：返回控制台点击「重试预览」。浏览器、网站的嵌入安全策略或网络可能限制内嵌显示；不要为此移除网站安全响应头。
3. 新窗口也失败：临时预览先检查截止时间；正式域名先检查站点是否仍在发布或已停止。等待中的操作继续查看原状态。
4. 仍不能恢复时，记录完整提示和发生时间后联系支持。

临时预览到期后不能作为长期地址使用。需要长期访问，请绑定域名并正式发布。

联系支持时提供什么

通过联系页面或 ticket@nameslink.com 提供：发生时间与时区、操作步骤、浏览器及版本、错误原文、输入类型（HTML / ZIP / 文件夹）、大致文件数与体积，以及脱敏截图。有站点或操作 ID 时在私密工单中附上。

不要发送账号密码、登录授权链接、API 密钥、验证码或整份未经检查的私有源码。如果需要提交复现文件，先制作一个删除秘密信息后仍可复现问题的最小示例。