统一用户报错为通俗中文提示 #33

Merged
zhanghongming merged 1 commits from codex/plain-language-errors into dev 2026-09-30 20:54:54 +08:00
Collaborator

用户界面原先会直接显示英文异常、技术字段和较长的处理说明。本次统一将报错显示为简短中文问题描述,例如“账号或密码不正确”“这条审核意见已被修改,本次保存未成功”,覆盖认证、账号与项目、任务、标注、质检、验收、存储、预览及工作流页面。

保留原始 API 错误、错误码、状态码、请求编号及后台日志;只调整显示文案,不改变权限、重试或提交判断。连接中断、超时仍明确表示结果尚不确定。必要操作按钮继续保留。

验证:

  • 类型检查、前端构建、14 项定向测试通过。
  • 全量前端测试的 14 项历史失败与原版本逐项及断言原因一致,无新增失败。
  • 本地 Edge 验证登录及审核、视频、网络报错。
  • 对应原提交 8e657b28 已发布公司 droboticflow-fanyu:滚动部署、健康检查、前端资源摘要核验通过;线上页面采用拦截登录请求验证中文报错,未写入客户业务数据。未重新执行全套业务写入验收。

本 PR 从最新 dev 单独提取文案改动,前端代码与已上线版本一致,不带入线上分支与 dev 的其他历史差异。

用户界面原先会直接显示英文异常、技术字段和较长的处理说明。本次统一将报错显示为简短中文问题描述,例如“账号或密码不正确”“这条审核意见已被修改,本次保存未成功”,覆盖认证、账号与项目、任务、标注、质检、验收、存储、预览及工作流页面。 保留原始 API 错误、错误码、状态码、请求编号及后台日志;只调整显示文案,不改变权限、重试或提交判断。连接中断、超时仍明确表示结果尚不确定。必要操作按钮继续保留。 验证: - 类型检查、前端构建、14 项定向测试通过。 - 全量前端测试的 14 项历史失败与原版本逐项及断言原因一致,无新增失败。 - 本地 Edge 验证登录及审核、视频、网络报错。 - 对应原提交 8e657b28 已发布公司 droboticflow-fanyu:滚动部署、健康检查、前端资源摘要核验通过;线上页面采用拦截登录请求验证中文报错,未写入客户业务数据。未重新执行全套业务写入验收。 本 PR 从最新 dev 单独提取文案改动,前端代码与已上线版本一致,不带入线上分支与 dev 的其他历史差异。
zhanghongming added 1 commit 2026-09-30 20:49:45 +08:00
zhanghongming merged commit 8824478498 into dev 2026-09-30 20:54:54 +08:00
Owner

@zhanghongming 过去 8 天自合并 PR 回溯审查(2026-10-08)。实际增量:1ccb2587 → 88244784,全部 60 个文件已检查。确认两项 P2,当前 dev bd253016 仍存在;共同入口是 src/lib/action-errors.js:3-4 将通用错误提取改为中文展示转换。

Standards

[P2] 上传失败的持久化诊断被展示文案覆盖。 DirectoryUploadPanel.tsx:295-301 将 getActionErrorMessage 的返回值传给 failUploadSessionItem,服务端 object_storage_upload_sessions.go:489-491 保存为 item.Error。合成上传异常含 SignatureDoesNotMatch、分片路径和 request-id,改动前写回原始诊断,改动后写回的 payload 只剩“操作失败”。这违反 docs/ui/error-messages.md:16-20“只调整显示、保留原始诊断”的边界。建议保留独立的原始错误提取用于诊断存储,仅在渲染时调用 userErrorMessage。

Spec

[P2] 文案转换破坏阶段失权后返回任务池的恢复分支。 AnnotationOperations.tsx:1535-1540 仍对已格式化的 msg 判断英文 current human stage role is required。普通任务页选中的任务被他人推进到当前账号无权访问的阶段后,详情 GET 返回该 403;如今 msg 已变成“当前账号没有操作权限”,条件永不命中,未执行 closeTaskAndReturnToPool,失效的任务选择/详情/URL 被保留。服务端权限没有被绕过,但恢复行为改变,与“只调整文案,不改变权限、重试或提交判断”不符。建议先按原始 APIError/code 分类,再格式化显示;为阶段失权提供稳定 code,并检查其他按显示文本分支的调用点。

验证:原有错误显示定向测试 14/14、lint:web、diff --check 通过。另用生产 runSession 和详情 catch 回调、合成异常及 mock 副作用分别复现:上传原始诊断基线保留、合并版丢失;失权恢复基线返回池、合并版和当前版均不返回。当前上传链路相关文件与合并版相同。两项都属于这次改动引入,不是已有全量测试失败;本轮未写真实上传记录、未运行浏览器或 Fanyu 验收。

@zhanghongming 过去 8 天自合并 PR 回溯审查(2026-10-08)。实际增量:1ccb2587 → 88244784,全部 60 个文件已检查。确认两项 P2,当前 dev bd253016 仍存在;共同入口是 `src/lib/action-errors.js:3-4` 将通用错误提取改为中文展示转换。 ### Standards **[P2] 上传失败的持久化诊断被展示文案覆盖。** `DirectoryUploadPanel.tsx:295-301` 将 getActionErrorMessage 的返回值传给 failUploadSessionItem,服务端 `object_storage_upload_sessions.go:489-491` 保存为 item.Error。合成上传异常含 `SignatureDoesNotMatch`、分片路径和 request-id,改动前写回原始诊断,改动后写回的 payload 只剩“操作失败”。这违反 docs/ui/error-messages.md:16-20“只调整显示、保留原始诊断”的边界。建议保留独立的原始错误提取用于诊断存储,仅在渲染时调用 userErrorMessage。 ### Spec **[P2] 文案转换破坏阶段失权后返回任务池的恢复分支。** `AnnotationOperations.tsx:1535-1540` 仍对已格式化的 msg 判断英文 `current human stage role is required`。普通任务页选中的任务被他人推进到当前账号无权访问的阶段后,详情 GET 返回该 403;如今 msg 已变成“当前账号没有操作权限”,条件永不命中,未执行 closeTaskAndReturnToPool,失效的任务选择/详情/URL 被保留。服务端权限没有被绕过,但恢复行为改变,与“只调整文案,不改变权限、重试或提交判断”不符。建议先按原始 APIError/code 分类,再格式化显示;为阶段失权提供稳定 code,并检查其他按显示文本分支的调用点。 验证:原有错误显示定向测试 14/14、lint:web、diff --check 通过。另用生产 runSession 和详情 catch 回调、合成异常及 mock 副作用分别复现:上传原始诊断基线保留、合并版丢失;失权恢复基线返回池、合并版和当前版均不返回。当前上传链路相关文件与合并版相同。两项都属于这次改动引入,不是已有全量测试失败;本轮未写真实上传记录、未运行浏览器或 Fanyu 验收。
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: longtao.wu/droboticflow#33
No description provided.