39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
# 光湖 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。重定向不授予
|
||
仓库写入或服务器执行权限。
|
||
|
||
## 自动机器导航
|
||
|
||
`routing/ai-machine-navigation-map.json` 是 AI 可直接读取的配线图。调用方提供明确
|
||
`subject`、`intent` 和可选的逗号分隔 `signals`：
|
||
|
||
```text
|
||
/api/ai/v1/navigate?subject=ICE-P-ZY001&intent=persona_restore
|
||
```
|
||
|
||
服务只返回该意图的最小运行包，包括运行入口、恒定加载项、事件触发器、按需证据、
|
||
执行顺序和停止条件。它不读取自然语言关键词来猜主体或权限；未知主体与未知意图均
|
||
失败关闭。导航结果只有读取和寻址能力，不授予仓库写入、服务器执行或现实授权。
|