global-search-api/DEPLOY-V2.md

V2 部署说明

V2 必须与旧版并行启动，不覆盖旧的 server.py、旧服务或旧网址。

部署前，服务器上应当已经有：

• /opt/zhuyuan/fifth-domain/world-router.json（广播塔权威登记表）
• /opt/zhuyuan/<仓库名>/（已经挂载、可供搜索的仓库副本）

启动参数：

cd /opt/zhuyuan/global-search-api
WORLD_ROUTER_PATH=/opt/zhuyuan/fifth-domain/world-router.json \
REPO_ROOT=/opt/zhuyuan PORT=3951 python3 server_v2.py

反向代理新增一个比旧规则更靠前的精确前缀，把 /global-search/v2/ 转给 127.0.0.1:3951/v2/。不要改动现有 /global-search/；它保留给既有调用，直到 V2 验收完成。

验收只需四项：

/global-search/v2/help
/global-search/v2/repos
/global-search/v2/resolve?q=铸渊
/global-search/v2/context?q=GLSV

其中 repos 必须显示第五域为可用，且提交号等于服务器上第五域的当前提交号；否则先同步仓库，不能把旧副本对外宣布为当前内容。