oh-my-muse/docs/explainers/muse-cloud/content/troubleshooting.md

排障维护备注

HTML 主入口至少覆盖以下八类症状，并给出优先定位层、检查项、下一步和证据。

1. 404。
2. 400。
3. 401/403。
4. 409。
5. 空列表但应有数据。
6. accepted 但不终态。
7. 外部服务失败。
8. 响应字段不对。

排障规则：先定位请求落在哪一层，再找能证明该层事实的文件、日志、测试或运行结果；没有证据时不宣称完成。