Knowledge RAG

设计知识库

由社区维护、审核后发布，并在 Agent 页面创作前被 RAG 检索为设计约束。

3 条已发布原则 / 全库 192 条

表单错误状态契约把 label、帮助文本、验证时机、内联错误、错误摘要、提交状态、服务端失败、移动键盘和 ARIA 连接放进同一个可实现模型。

表单错误不是某个红色组件，而是字段契约、状态机和恢复路径的组合；它应路由到更细的错误摘要、可访问反馈、标签持久性和事务型恢复知识。

加载状态要按时长、范围和可测进度选择 skeleton、inline loading、spinner、进度条或阶段反馈，并用前端状态机保证可访问、稳定和可恢复。

加载反馈的目标不是让等待更花哨，而是让用户知道系统是否响应、哪里正在变化、是否还能行动、等待是否可估计、失败后如何恢复。不同等待场景需要不同的反馈模式。

空状态要先说明系统状态和原因，再给出解决当前原因的主行动，而不是只用插图填补空白。

空状态是一种已完成的系统反馈：用户需要知道内容为什么没有出现、当前请求是否已经结束、自己能做什么，以及是否需要权限、配置、重试或等待。