从本地到上线：部署前要检查什么

01先分清你在部署什么

本站的交互演示运行在浏览器，资料固定，没有后端或模型接口。Python 示例运行在本地命令行。这两种形态都不是一个已经接入企业资料的生产服务。

静态网站可以由 Nginx 直接提供；模型调用需要服务端保护密钥，并对请求做鉴权、限流与超时处理。不要把 API Key 写进前端 JavaScript、公开仓库或教程截图。

02动手：独立预览一个静态页面

开始前：先跑通Python Demo与资料缺失练习。本节需要 Python 和命令行基础，不需要本站源码、模型密钥或服务器。目标是分清：文件存在、浏览器能打开、正式上线，是三个不同的检查。

新建一个空目录 demo-site，在其中创建 index.html，用 UTF-8 保存以下完整内容。Windows 请确认文件名不是 index.html.txt。

<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>回复草稿检查页</title>
</head>
<body>
  <main>
    <h1>回复草稿检查页</h1>
    <p>固定资料展示 · 无模型调用</p>
    <h2>试用几天？</h2>
    <p>体验版试用期为 7 天。</p>
    <p>资料出处：D01 · 产品试用规则</p>
    <p>请人工检查后使用；本页不会发送回复。</p>
  </main>
</body>
</html>

在 demo-site 的上一级目录打开终端，运行：

python -m http.server 8080 --bind 127.0.0.1 --directory demo-site

Windows 若使用 py，把命令开头的 python 换成 py。保持终端运行，在浏览器打开 http://127.0.0.1:8080/。应看到「回复草稿检查页」、7 天和 D01；中文应正常显示。这里的草稿手工写在 HTML 中，不会执行上一课的 Python 函数。

若提示端口已占用，把命令中的 8080 改成另一个空闲端口，例如 8081，浏览器地址也同步修改。若首页出现文件目录列表而不是检查页，先检查目录和 index.html 文件名。

03上线检查

先完成本地验收

1. 打开首页，核对中文、7 天、D01 和人工确认说明。打开浏览器开发者工具的「网络」，刷新页面，首页请求应返回 200。
2. 访问 http://127.0.0.1:8080/missing.html，应返回 404；这表示文件不存在，不是「资料不足」状态。使用了其他端口时同步修改地址。
3. 把 HTML 中的「7 天」临时改成「14 天」，保存并刷新，确认浏览器显示新文字，再改回 7 天。这只是虚构教学资料，练习的是确认实际发布文件发生变化。
4. 回到运行服务器的终端，按 Ctrl+C 停止服务，再刷新浏览器。需要确认网络请求失败；缓存中还显示旧画面，不代表服务仍运行。

完成标准：能解释首页为什么是 200、缺失文件为什么是 404，以及为什么打开这个页面并没有把 Python Demo 变成在线问答服务。

准备正式上线时再检查

• 静态文件交给正式 Web 服务器或静态托管服务；发布副本只放准备公开的文件。不要把源码目录、私人资料或密钥一起上传。
• 用真实域名检查有效 HTTPS、资源加载、手机排版、站内链接与真正返回 404 的错误页。
• 若接入真实问答服务，另行验证正常命中、资料缺失、空输入和超长输入；静态页面不能证明模型接口或鉴权已完成。
• 发布前备份旧副本，写清恢复步骤；发布后核对实际页面和文件。失败时先恢复，而不是把失败提示改成成功。

本站维护者使用的 build.py 属于本站构建流程，不是本节练习的前置文件。跑通本地预览也不代表已配置域名、证书或完成生产部署。

04下一阶段的工程工作

真实模型服务还需要记录请求耗时、错误类别、Token 使用和模型成本，避免把敏感问题原文默认写入日志。先用一组固定评测问题比较修改前后的效果，再逐步放开使用范围。

语义检索、工具调用、模型评测和生产监控为后续规划。当前教程只覆盖最小示例及部署检查，不承诺生产级交付。