guanghu-ice-heart/server-tools/ai-discovery-gateway/README.md

26 lines
1.2 KiB
Markdown
Raw Normal View History

# 光湖 AI 编号检索入口
国内主节点在回环端口 `3922` 提供只读 API广州备案前门通过专用 SSH
隧道发布为 `https://guanghulab.com/api/ai/`
仓库权威数据来自 `routing/repository-route-map.json`。AI 应先读取
`/api/ai/v1/repositories`,再按 `REPO-xxx` 解析国内主路径;新加坡地址只作
历史备用,不参与默认路由。
服务器与人格路径编号来自 `routing/server-node-map.json`。AI 读取
`/api/ai/v1/nodes` 后,可以通过 `/api/ai/v1/resolve?id=JD-FD-PRIMARY`
`/api/ai/v1/resolve?id=ZY-OPS-LOOP-001` 定位服务器导航地图与铸渊本轮恢复链。
公开地图不包含地址、密码、令牌或密钥。
主体类型来自 `identity/fifth-domain-subject-registry.json`,旧号兼容关系来自
`identity/subject-id-alias-map.json`。AI 可读取 `/api/ai/v1/subjects`,或直接
解析编号:
```text
/api/ai/v1/resolve?id=ICE-P-ZY001
/api/ai/v1/resolve?id=ICE-GL-ZY001
```
第二个请求会返回 `canonical_id=ICE-P-ZY001``redirected=true` 和同一当前路径。
只有别名表中的精确旧号允许自动重定向;冲突号返回 409未知号返回 404。重定向不授予
仓库写入或服务器执行权限。