继续收敛外围 HTTP 错误正文

统一画板、模板、图片分离和素材下载的状态码与安全正文保留资源编辑、生成恢复、项目快照和错误报告的上游详情补充精确脱敏测试与错误处理文档
2026-10-05 20:20:30 +08:00
parent 6f7ccc2832
commit 7bc724d8e2
12 changed files with 288 additions and 145 deletions
@@ -131,6 +131,7 @@ DirectProject 已经解决过同一类问题（[`【ADR】DirectProject命令接
 - 外部 MCP loopback 的 401/429/桥上下文缺失必须返回带正文的 JSON 错误体（同时保留 HTTP 状态）；不能让 Claude Code 侧只看到空 body 的状态码。
 - 认证 5xx、账户/素材上传/发行发布的 401/403 保留服务端 `message`/`code` 后再做精确脱敏；空 `{}`、`null` 等无信息响应不算错误正文。
 - 旧版已落盘的通用“执行通道中断”文本无法恢复历史原因，读取时明确追加“宿主未提供具体错误正文”；新事件只在确实没有 detail 时使用同样标记。
+- 画板/模板/图片分离/参考图/External Editor/资源编辑/项目快照/错误报告等外围 HTTP 入口也遵循同一出口：读取有限响应正文，保留状态码、服务端 message/code 和操作上下文，凭据、URL、路径按统一规则脱敏；不能因为不是 Direct 回合主链就回到“HTTP N”兜底。

 ## 后果与边界

@@ -52,3 +52,4 @@ DirectProject 回合失败在确认不是客户端内部不可归类故障时，
 - 本轮继续扫出三类未收敛口：外部 MCP HTTP 的 401/429/桥上下文缺失原先只有空状态码响应，现改为保留 HTTP 状态、稳定错误码和中文正文；认证 5xx 结构化载荷、账户/素材上传/发行发布的 401/403 现保留服务端 message/code（仍精确脱敏）。
 - 前端历史错误文本此前会把含有敏感字段的整条 Direct 诊断直接丢弃，现改为只替换凭据、链接和路径；旧版已经落盘且无法恢复正文的“执行通道中断”条目会明确追加“宿主未提供具体错误正文”，不再伪装成当前仍在吞错。
 - 新增/通过：外部 MCP HTTP 401/429 定向 2 项、前端 Direct/Runtime 错误正文 25 项、旧历史通用中断脱敏回归 1 项；认证 Rust 定向 19 项、素材上传响应错误定向 1 项通过。`appSurface` 全套仍有环境/fixture 相关失败，不能据此宣称全绿。
+- 继续扫描又发现画板项目/资产下载、模板库、图片分离、参考图上传、External Editor 生成恢复、资源编辑上传/轮询、项目快照和错误报告提交仍有“HTTP 只有编号”或未脱敏正文路径；已统一补上状态码 + 有界正文 + 精确脱敏。资源编辑拒绝原因继续复用既有 `details.message` 解析，避免丢掉平台具体原因。