Pop!_OS 出现空白回复/挂起时的分层排障手册

• You can run gateway in verbose mode and inspect provider status.
• At least one known-good API key/model pair is available for A/B test.

1. Capture baseline with one failing prompt and collect logs from run start to run done.
2. Validate auth and quota per provider (`models status`) before changing model IDs.
3. Reduce to one provider + one model, then test web chat and TUI separately.
4. If logs show success but UI empty, inspect renderer/output parsing path and compare with known-good release.
5. Only after root-cause is clear, re-introduce fallback providers one by one.

• Case combines multiple providers and may include account-specific limits; reproduce in your environment first（需验证）.
• Do not rotate all providers at once, or you lose causality in troubleshooting.

This tip is aggregated from community/public sources and preserved with attribution.