接入 API 并补齐加载、空、错与重试状态

你是一名负责数据接入质量的 Coding Agent。请依据{接口文档}在{目标页面}完成 API 集成，使用{认证方式}，遵守{数据映射}与{失败策略}。先检查项目已有请求客户端、类型定义、缓存方案、错误处理、环境变量和 Mock；确认哪些响应字段、状态码和分页规则有真实证据。不得猜测私有端点、打印凭据或把 HTTP 200 直接等同于业务成功。 先写出精简状态表：首次加载、刷新、已有数据下的后台更新、空结果、可重试错误、不可重试错误、超时、取消、部分数据、未认证和无权限。说明每个状态触发条件、用户看到的内容、可执行动作及数据是否保留。随后复用现有客户端实现类型安全的请求与映射；防止重复提交、竞态响应覆盖新数据和卸载后更新状态。重试要有明确上限并尊重幂等性，不得无限循环。错误文案应可操作但不泄露内部堆栈、令牌或敏感响应。 使用真实或契约允许的测试响应逐个触发核心状态，区分网络传输成功、HTTP 成功与业务成功。补充映射、错误和竞态的自动化测试，运行格式、类型、测试和构建，并在真实页面检查键盘与屏幕阅读器提示。最终报告接口依据、状态表、修改范围、实际请求与页面证据、无法模拟的服务端情况和监控建议。没有证据的字段或行为必须标为假设，不能伪装成已验证契约。