Knowledge RAG

设计知识库

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

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

长页面、库页面和工作台必须明确唯一主滚动容器；嵌套 `height: 100vh`、`overflow: hidden/auto` 和 sticky 面板前要先声明滚动归属。

滚动不是浏览器附带行为，而是布局契约。谁拥有页面滚动、谁拥有局部滚动、哪些面板 sticky、移动端如何 reflow，都要在实现前确定。

浮层不是一层遮罩，而是 modality、初始焦点、焦点循环、关闭规则、背景 inert、滚动锁、portal 层级和移动端安全区的联合契约。

只要浮层改变用户可交互范围，就必须同时治理键盘、读屏、指针、滚动和移动端行为；视觉上盖住背景但语义上仍可达，是最危险的假 modal。

搜索、筛选、分面和排序必须共同解释当前结果集：查询是什么、范围是什么、条件是什么、结果为何出现、如何恢复。

检索界面是一台状态机。用户每输入 query、选择 facet、改变排序或清空条件，都应看到结果数量、active filters、命中摘要、空结果恢复和可分享的 URL 状态。

复杂数据表在移动端不能只缩小字号或强塞横向滚动；必须定义主键、列优先级、替代表达、表头关联和批量/行内操作边界。

数据表是一种比较结构。响应式处理要保护比较关系和可访问语义，而不是只保护桌面视觉外观。

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

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

做模式库时应从真实产品流程提取任务、状态和文案，而不是只模仿单张漂亮截图。

触控手势替代路径把一个高频界面判断转成可执行约束，帮助 Agent 在生成前做出更具体的布局、交互或可访问性选择。

触控键盘与输入目的把一个高频界面判断转成可执行约束，帮助 Agent 在生成前做出更具体的布局、交互或可访问性选择。

移动端底部行动栏把一个高频界面判断转成可执行约束，帮助 Agent 在生成前做出更具体的布局、交互或可访问性选择。

响应式导航折叠把一个高频界面判断转成可执行约束，帮助 Agent 在生成前做出更具体的布局、交互或可访问性选择。

移动端不是桌面的缩小版，应按任务优先级重新堆叠内容和操作。

按钮、链接、菜单项和图标按钮需要足够命中区域，移动端尤其不能只看视觉尺寸。