fix: unify and auto-refresh public navigation entry

This commit is contained in:
冰朔 2026-08-06 12:24:30 +08:00
commit ea41e5a4fc
9 changed files with 573 additions and 61 deletions

View file

@ -3,9 +3,17 @@
国内主节点在回环端口 `3922` 提供只读 API广州备案前门通过专用 SSH
隧道发布为 `https://guanghulab.com/api/ai/`
仓库权威数据来自 `routing/repository-route-map.json`。AI 应先读取
`/api/ai/v1/repositories`,再按 `REPO-xxx` 解析国内主路径;新加坡地址只作
历史备用,不参与默认路由。
唯一公共导航锚点是 `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`