# 光湖全局检索 API V2

V2 是给外部通用 AI 的公开只读入口。它先读取第五域广播塔登记的 `world-router.json`，再决定该去哪个仓库、哪个人格体路径或哪份 GLS 架构资料。

## 先找路，再读文件

```text
GET /v2/resolve?q=铸渊
GET /v2/context?q=GLSV
GET /v2/search?repo=fifth-domain&q=HLDP
GET /v2/file?repo=fifth-domain&path=gls/GLS-ENTRY.hdlp
```

`/v2/repos` 会列出八个登记仓库，并明确显示某仓库是否已经挂载到检索服务器。每一份结果都会带上仓库提交号，避免把旧副本误当成当前内容。

## 边界

- V2 只有 `GET` / `OPTIONS`，没有写入、提交、握手或公开密码入口。
- 服务器部署、拉取与重启不属于这里，仍由“光湖系统安全验证（GLSV）”处理。
- `world-router.json` 的权威来源是第五域广播塔；服务器通过 `WORLD_ROUTER_PATH` 或 `/opt/zhuyuan/fifth-domain/world-router.json` 读取它。

## 启动（服务器）

```bash
WORLD_ROUTER_PATH=/opt/zhuyuan/fifth-domain/world-router.json \
REPO_ROOT=/opt/zhuyuan PORT=3951 python3 server_v2.py
```

反向代理建议把公开的 `/global-search/v2/` 指到该进程，并保留旧版 `/global-search/` 原样运行，直到 V2 验收完成。

具体的并行上线与验收步骤见 `DEPLOY-V2.md`。