跳到主要内容

公开站点 Smoke Check

状态：Active / 发布新鲜度检查

什么时候用​

每次知识库内容修复、导航修复或部署排障后使用。npm run build 和 GitHub Actions 成功只证明静态站点能构建，不证明公开域名已经提供最新内容。

前置条件​

  • 已在本地通过 npm run verify:kb。
  • 已在本地通过 npm run build。
  • 已记录本次期望公开可见的提交 SHA 或唯一内容片段。

步骤​

  1. 检查构建链：确认最新 GitHub Actions run 成功，且对应提交是本次待发布提交。
  2. 检查 Railway origin：对 https://fin-tec-ai.up.railway.app/ 加 cache-busting query 请求目标路径。
  3. 检查自定义域名：对 https://labs-fintecai-gov.topquant.org/ 加同一 query 请求目标路径。
  4. 读取响应头：记录 last-modified、etag、cache-control 和 HTTP 状态码。
  5. 读取正文探针：用一个本次提交新增或删除的唯一文本片段做 curl | rg 检查。
  6. 对比 origin 与自定义域名：如果 origin 已更新而自定义域名未更新，按 CDN / 反代缓存处理；如果两者都旧，按 Railway 部署链处理。

验证​

至少保留三类证据：

curl -sSI 'https://fin-tec-ai.up.railway.app/<path>/?v=<commit-sha>'
curl -sSI 'https://labs-fintecai-gov.topquant.org/<path>/?v=<commit-sha>'
curl -fsSL 'https://fin-tec-ai.up.railway.app/<path>/?v=<commit-sha>' | rg '<unique-current-fragment>'

完成标准：目标路径在 origin 和自定义域名都返回 2xx，正文包含当前片段，不再包含本次修复删除的旧片段。

回滚​

如果公开站点仍旧：

  1. 不要修改知识库正文来迎合旧站点。
  2. 先把问题归类为部署新鲜度问题。
  3. 用上一节证据区分 GitHub Actions、Railway origin、自定义域名缓存三段。
  4. 只在确认仓库内容确实错误时回到内容修复流程。