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

26 lines
1.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 光湖 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。重定向不授予
仓库写入或服务器执行权限。