# U8 Chat 常见问题 · 上传说明（给运维 / 开发）

整理时间：2026-09-28
交付人：产品（金）

## 一、要上传什么

压缩包：`常见问题-上传用.zip`（在桌面），解压后是 **2 个文件**：

| 文件 | 说明 |
|---|---|
| `index.html` | 「U8 Chat 常见问题」页面。纯静态：无后端、无外部依赖（不加载任何 CDN / 字体 / 统计脚本）、不写任何数据 |
| `新用户注册下载教程.mp4` | 页面里嵌的新用户注册下载教程视频（76 秒 / 15MB / H.264 + AAC） |

⚠️ **这两个文件必须放在服务器上同一个目录里**。页面里是按相对路径引用视频的，只传 html 会导致视频打不开（黑框）。

## 二、放哪里 / 访问地址

- 建议新建一个独立目录，例如 `/www/<站点>/faq/`（具体路径按你们服务器规范定）。
- **不要**放在需要登录或鉴权的目录里——这个页面的用途是发到群里，客服和会员要能直接打开。
- 上传后访问地址形如：`https://<域名>/faq/index.html`
- 建议走 **https**。页面里的「复制网址」按钮在 https 下走系统剪贴板；http 下页面有兜底方案也能复制，但 https 更稳。

## 三、服务器侧注意点

1. 该目录允许直接访问 `index.html`；如果站点默认文档里包含 `index.html`，地址可以直接写成 `https://<域名>/faq/`，更短更好发。
2. `.mp4` 的 MIME 用 `video/mp4`，静态服务器默认即可；`.html` 用 `text/html; charset=utf-8`（页面是 UTF-8，中文不能乱码）。
3. 视频需要支持 **Range 请求**（nginx / Apache 默认支持），否则进度条不能拖动。
4. 缓存建议：`index.html` 不缓存或短缓存（以后改文案要立即生效）；`新用户注册下载教程.mp4` 可以长缓存。
5. 如果服务器对**中文文件名**有编码问题（表现为视频 404），把 `新用户注册下载教程.mp4` 改名为 `video.mp4`，并同步把 `index.html` 里的 `新用户注册下载教程.mp4` 改成 `video.mp4` —— **两处必须一起改**。

## 四、上传后请帮忙验一下（3 条）

1. 手机浏览器打开链接：正常显示「U8 Chat 常见问题」，顶部有搜索框，随便输「卡顿」能筛出对应问题。
2. 「三、邀请【新用户】注册并建立联络的流程」里的视频：能播放、能拖进度条。
3. 卡片一、二旁边的「复制网址」按钮：点一下显示「已复制 ✓」，粘贴出来是正确的网址。

## 五、以后改文案

所有文案都直接写在 `index.html` 里（没有脚本生成、没有 md 源文件）。改完重新上传覆盖 `index.html` 就行，视频不用动。

## 六、以后更新（第二次起走这套）

FAQ 的内容以后会随时调整（新增常见问题、改口径）。**更新只需要替换 `index.html` 一个文件，视频不用动**：

1. 产品把新的 `index.html` 交给你（会打成 `常见问题-更新包-日期.zip`，里面只有 `index.html`）。
2. 覆盖服务器上原来那个 `index.html`（**路径不变、文件名不变**，`新用户注册下载教程.mp4` 保持原样不动）。
3. 覆盖后确认：打开线上链接，能看到这次改动的那句话；视频还能正常播放。

建议覆盖前把旧文件留个备份（例如改名 `index.html.bak`，或存到上一级目录），万一新版本有问题可以立刻回滚。

⚠️ **`index.html` 请设置成不缓存或很短缓存（no-cache）**。否则文案改了，群里的人打开看到的还是旧内容，会以为没更新。

> 如果要**换视频**：视频文件和 `index.html` 里引用的文件名必须保持一致，两个一起替换、一起上传。

### 附：给运维的转发模板（产品每次改完会连附件一起发）

> 麻烦把附件里的 `index.html` 覆盖到服务器 `/faq/` 目录里原来那个 `index.html`，文件名和路径不变，视频不用动。
> 覆盖后帮我看一下：① 手机打开链接页面正常、中文不乱码；② 能搜到这次改动的内容；③ 视频还能播放。

## 七、附：本地文件位置（三处，以仓库正本为准）

| 位置 | 用途 | 说明 |
|---|---|---|
| `文档/常见问题/`（本仓库） | **正本** | `index.html` + `新用户注册下载教程.mp4`，已纳入版本控制，可追溯历史 |
| `~/Desktop/常见问题/` | 桌面副本 | 内容与正本一致，方便直接打包 |
| `文档/常见问题.zip` | ⚠️ **过时归档，勿用于上线** | 早期打的一个中间包，内含的 `index.html` 为旧版本（18192 字节，正式版为 18965 字节），且夹带 `__MACOSX` 等 macOS 垃圾文件。仅作留档，**不要解压后直接上传** |

打包给运维时，请从「正本」目录重新打包，并确认：

- 包内 `index.html` 为当前版本（与仓库中的文件字节数一致）
- 包内不包含 `__MACOSX/`、`.DS_Store` 等 macOS 附加文件
- 压缩包命名沿用 `常见问题-上传用.zip`（首次）或 `常见问题-更新包-<日期>.zip`（后续更新）