SuperAPI AI 工具集

gateway-proxy-debug

部署与运维

查看项目

更新于 10-16 05:53

技能介绍

用途:当包装层能访问沙箱,但 /gateway 路由、HTML 注入、WebSocket 或 token 传递出问题时,用该技能定位并修复。

主要能力:按“证据优先”收集信息,包括浏览器 URL 与失败请求路径、GET /api/status、GET /api/admin/sandbox-diag、过滤 proxy./gateway./sandbox.port_/token. 的 GET /api/admin/logs,以及 /gateway/* 网络追踪、WebSocket 升级与 POST /api/status 心跳。要求区分应用鉴权、部署保护绕过、gateway token 与 AI Gateway 鉴权,且不得把 gateway token 粘贴进产物。

使用方式:画路径图 browser -> wrapper auth -> /gateway route -> ensure sandbox running -> fresh gateway token -> sandbox port URL -> OpenClaw gateway -> HTML injection -> WebSocket rewrite -> heartbeat POST /api/status,把每条边标记为未知、验证通过或验证失败,再按常见故障拆分排查。

常见故障:等待页正常但沙箱未就绪;沙箱请求前代理鉴权失败;端口 URL 缓存过期需失效;gateway token 过期或未注入;HTML 注入失败或脚本格式错误;WebSocket URL 改写指向错误源/路径;心跳缺失导致沙箱超时。

修复边界:主文件 src/app/gateway/[[...path]]/route.ts;辅助 src/server/proxy/{proxy-route-utils,htmlInjection,waitingPage}.ts;生命周期依赖 src/server/sandbox/lifecycle.ts、src/server/public-url.ts;测试为代理/HTML 注入测试及心跳交互的生命周期测试;文档见 lat.md/sandbox-lifecycle.md、docs/architecture.md、docs/deployment-protection.md。

验证:先跑聚焦测试,再运行 node scripts/verify.mjs --steps=test,typecheck 与 lat check;UI/WebSocket 修复需在浏览器验证或冒烟检查 HTML 含注入脚本且 WebSocket 到达沙箱。其他细节资料暂未提供。