pikasTech-unidesk/.agents/skills/unidesk-sub2api/references/troubleshooting.md

排障入口

Sub2API 排障先按失败层分流，不要把公网边缘、运行面健康、账号池调度和本机 Codex 配置混成一个处理面。

• api.pikapython.com 502/503、Pod/容器健康、NetworkPolicy、wait-postgres、受控 apply/sync 超时：读 troubleshooting-runtime.md。
• Codex pool、sentinel、账号冻结/恢复、WebUI account test、统一 key、上游错误分类、WSv2、本机 Codex profile：读 troubleshooting-accounts.md。
• FRP、Caddy、PK01 shared Caddy managed block、public URL、edge timeout/502：读 troubleshooting-public.md。

分层 closeout 必须只输出 HTTP status、模型数量、marker、account id/group id、key fingerprint、对象名和 presence；不得打印完整 key、token、password 或 Secret .data。