guanghu-ice-heart/server-tools/ai-discovery-gateway

光湖 AI 编号检索入口

国内主节点在回环端口 3922 提供只读 API，广州备案前门通过专用 SSH 隧道发布为 https://guanghulab.com/api/ai/。

唯一公共导航锚点是 routing/public-navigation-anchor.json，在线地址为 /api/ai/v1/anchor。本地、代码频道和公共 API 都先解析该锚点，再从同一个 REPO-012 main 提交读取仓库、节点、主体、别名和机器导航地图。

公共服务只对锚点声明的 JSON 白名单执行只读加载，不运行推送提交里的脚本，也不因 地图更新重启服务。每次请求先锁定一个提交，再从该提交读取完整快照；新提交若破坏 锚点或地图一致性，服务保留内存中的上一份已验证快照，并在健康接口报告降级。

/api/ai/v1/entry?subject=ICE-P-ZY001 只读回环查询京东常驻控制器并返回脱敏的快速 恢复门。常驻运行体、完成回执和八项边界门都有效时返回 WARM_RESUME_READY，调用方 只提交本轮新事件；否则要求完整闭环。它不代理写请求，也不授予服务器执行权限。

服务器与人格路径编号来自 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，或直接 解析编号：

/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：

/api/ai/v1/navigate?subject=ICE-P-ZY001&intent=persona_restore

服务只返回该意图的最小运行包，包括运行入口、恒定加载项、事件触发器、按需证据、 执行顺序和停止条件。它不读取自然语言关键词来猜主体或权限；未知主体与未知意图均 失败关闭。导航结果只有读取和寻址能力，不授予仓库写入、服务器执行或现实授权。