纠正清智创游官网游戏下载线上路由

移除错误的独立主站 vhost 配置
补充官网现役 vhost 的精确下载接口 snippet
同步线上排障说明与回归测试

docs/【开发运维】本地开发验证与生产运维-2026-05-15.md

@@ -6,11 +6,14 @@
 
 ### 清智创游官网独立域名路由
 
-清智创游官网 `tsingnovagames.com` / `www.tsingnovagames.com` 的首页静态资源位于同一 Web 根目录的 `/home/`，首页“游戏引擎”入口按同源请求 `/api/client-downloads`。生产 Nginx 必须让这两个域名进入包含 `/api` 反代的主站 `server block`，并把该域名根路径重写到 `/home/`；否则页面可以打开，但接口会被静态站点直接返回 HTML 404，前端显示“暂时无法获取下载信息，请稍后重试”。
+清智创游官网 `tsingnovagames.com` / `www.tsingnovagames.com` 使用独立的 Nginx 配置 `/etc/nginx/conf.d/tsingnova-games.conf`，静态根目录是 `/srv/genarrative/corporate-site-current`；主站模板 `deploy/nginx/genarrative.conf` 不应重复声明这两个域名。官网首页按同源请求 `/api/client-downloads`，因此应在现役官网 HTTPS `server` 中 include `deploy/nginx/snippets/tsingnova-client-downloads.conf`，只代理这个精确路径到 `genarrative_api`，不要把整个 `/api` 交给官网静态站点兜底。
 
-`Genarrative-Server-Provision` 在 `SERVER_NAME=genarrative.world`（或 `www.genarrative.world`）且使用 `production-https` 时会自动补入这两个官网别名，并渲染 `/home/` 根路径兼容规则。修改后需重新执行一次正式服务器配置发布并 reload Nginx，不要只重启 api-server：
+线上修复或排障后必须确认的是**生效配置**而不是仓库模板：
 
 ```bash
+sudo nginx -T | grep -n -A45 -B5 'server_name tsingnovagames.com'
+sudo nginx -t
+sudo systemctl reload nginx
 curl -fsS -D ~/data/tmp/tsingnova-client-download.headers \
   https://tsingnovagames.com/api/client-downloads \
   -o ~/data/tmp/tsingnova-client-download.json
@@ -18,7 +21,7 @@ jq . ~/data/tmp/tsingnova-client-download.json
 grep -i '^cache-control: no-store' ~/data/tmp/tsingnova-client-download.headers
 ```
 
-验收必须同时满足：接口返回 `200 application/json`，响应包含 `downloads` 与 `unavailablePlatforms`，并带 `Cache-Control: no-store`；`https://tsingnovagames.com/` 仍返回官网首页。若接口仍返回 Nginx 404，优先检查 `nginx -T` 中 `server_name` 是否包含上述两个域名以及 `/api` location 是否指向 `genarrative_api`。
+验收必须同时满足：接口返回 `200 application/json`，响应包含 `downloads` 与 `unavailablePlatforms`，并带 `Cache-Control: no-store`；`https://tsingnovagames.com/` 仍返回官网首页。若 API 直连 `http://127.0.0.1:8082/api/client-downloads` 是 `200`、官网域名仍是 `404`，说明官网 vhost 没有 include 下载 snippet，不能靠 reload 旧配置解决。
 
 ## 构建回归的隔离与发布文件权限