设计工作
用 AI 写产品错误状态文案
用 AI 写产品错误状态文案指南从错误分类、用户影响、可恢复动作、数据安全和技术边界生成清楚提示,并用状态矩阵避免责怪用户或暴露内部信息。
用 AI 写产品错误状态文案,应先知道发生了什么、用户的任务受到什么影响、哪些数据已保存以及下一步能做什么。AI 能将技术错误映射成表达候选,但不能猜原因、承诺恢复时间或替安全团队决定披露范围。
| 项目 | 说明 |
|---|---|
| 阅读时间 | 约 8 分钟 |
| 适合人群 | 产品设计师、内容设计师、产品经理、前后端开发者、测试和支持团队 |
| 核心产出 | 错误分类、用户提示、恢复动作、日志关联、无障碍通知和复核表 |
| 使用前提 | 有真实错误状态、业务影响、可用动作和技术或支持责任人 |
| 不适合 | 用同一句“出错了”覆盖所有问题,或让 AI 虚构网络原因与恢复承诺 |
文案不能替代错误预防、自动恢复、数据保护和可观察性。如果系统无法区分原因,就使用诚实的通用提示并提供安全下一步,而不是随机归因为网络。安全、支付、身份、隐私和数据丢失相关提示要走更严格审校。
| 错误类型 | 用户需要知道 | 不应暴露或猜测 |
|---|---|---|
| 输入无效 | 哪项不符合、怎样修正 | 内部校验实现细节 |
| 权限不足 | 当前不能做什么、向谁求助 | 其他用户或资源敏感信息 |
| 冲突 | 状态已变化、怎样刷新或合并 | 无依据归责某位协作者 |
| 暂时失败 | 任务是否保存、能否重试 | 未确认恢复时间和服务器细节 |
| 部分成功 | 哪些完成、哪些未完成 | 把整体显示成完全成功 |
七步错误文案流程
Section titled “七步错误文案流程”- 建立错误目录:从真实接口、客户端、业务规则和支持记录收集错误码与触发条件。
- 按用户影响分类:区分可立即修正、可重试、需权限、需支持和不可逆风险。
- 确认数据状态:说明输入是否保留、动作是否已执行、重复操作是否安全。
- 定义恢复动作:为每类错误提供一个主要下一步,必要时提供帮助或联系路径。
- 让 AI 生成候选:输入准确状态与禁用措辞,要求不猜原因、不责怪用户、不承诺时间。
- 放回界面与辅助技术测试:检查位置、焦点、播报、长文本、重复错误和移动端遮挡。
- 连接日志与维护:用户文案不暴露内部信息,但通过安全关联码帮助支持定位;版本变化同步更新。
假设示例:保存草稿失败
Section titled “假设示例:保存草稿失败”以下状态与文案为教学假设,不代表真实产品行为或服务承诺。
状态 E1:请求未到达服务端,编辑内容仍保存在当前页面。状态 E2:服务端返回版本冲突,其他人已更新同一草稿。状态 E3:用户编辑权限被移除,本地内容仍可复制。要求:分别写标题、说明和主动作;不写“网络不好”除非已确认。| 状态 | 标题 | 说明 | 主动作 |
|---|---|---|---|
| E1 | 草稿尚未保存 | 你的编辑仍保留在当前页面。请稍后重新保存。 | 重新保存 |
| E2 | 草稿有新的版本 | 其他更改已先保存。请查看新版本,再决定怎样保留你的编辑。 | 查看新版本 |
| E3 | 你已无法编辑这个草稿 | 当前编辑尚未保存。你可以先复制内容,再联系项目所有者确认权限。 | 复制内容 |
状态与实现复核
Section titled “状态与实现复核”- E1 的“仍保留”只有在页面确实持有完整内容时才能使用。- E2 需要产品定义比较、覆盖或合并规则,文案不能先承诺自动合并。- E3 的复制动作必须真实可用,并避免暴露用户无权查看的新内容。- 所有状态要测试焦点移动和读屏通知,避免错误不断重复播报。决策与复核表
Section titled “决策与复核表”| 检查项 | 复核问题 | 合格信号 |
|---|---|---|
| 准确 | 原因和数据状态真的已知吗? | 不确定处使用诚实通用表达 |
| 影响 | 用户知道哪些动作已完成吗? | 不会因重复操作造成新风险 |
| 恢复 | 主动作真实可用且安全? | 不是只有“确定”或“重试” |
| 语气 | 是否责怪、恐吓或模糊? | 中性说明事实和下一步 |
| 可访问 | 错误怎样被发现与关联? | 焦点、语义和播报经过测试 |
- 所有失败都写“网络异常”,即使系统没有确认原因。
- 提示“数据不会丢失”,实现却没有持久保存保证。
- 只显示错误码,没有用户可执行的下一步。
- 表单顶部报错,但字段没有程序化关联和焦点引导。
- 权限错误暴露资源存在、成员姓名或内部角色信息。
错误提示应该写技术原因吗?
Section titled “错误提示应该写技术原因吗?”只写用户理解和行动所需、且已经确认的原因。内部堆栈、安全细节和无法验证的推测不应展示。
所有错误都可以提供重试吗?
Section titled “所有错误都可以提供重试吗?”不可以。权限、冲突、不可逆操作和重复提交可能需要其他恢复方式,重试前要确认幂等与数据安全。
错误码要不要给用户看?
Section titled “错误码要不要给用户看?”可以提供安全的关联码帮助支持定位,但不要直接暴露内部路径、数据库或敏感实现信息。
怎样判断错误文案是否有效?
Section titled “怎样判断错误文案是否有效?”观察用户能否理解影响、预测下一步并安全恢复,同时验证实现状态、辅助技术和支持流程,而不是只评审句子好不好听。
错误文案必须建立在真实状态、数据安全和可用恢复动作上。AI 可以生成表达候选,原因、承诺与披露边界要由产品和工程确认。