# V2 部署说明

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

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

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

启动参数：

```bash
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 验收完成。

验收只需四项：

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

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