Knowledge RAG

设计知识库

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

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

玻璃、acrylic、mica、smoke 和 backdrop blur 不能只是风格滤镜；它们必须明确 surface role、背景可变性、层级、对比度、用户偏好、forced-colors 和 fallback。

半透明材质的价值是把界面层级和背景上下文连接起来；如果它降低阅读、状态识别、键盘焦点或可访问偏好，它就应该退回不透明 surface。

滚动动效要区分 CSS scroll timeline、GSAP ScrollTrigger、Lenis smooth scroll 和普通原生滚动；不要为了沉浸感破坏阅读、锚点、键盘和移动端手感。

滚动是用户控制阅读节奏的输入，不是动画导演的时间轴。实现应优先保留原生滚动语义，再为确有价值的局部段落绑定轻量动效。

组件响应式不应只跟随 viewport；卡片、侧栏、图表和资源卡应根据自身容器宽度调整密度、层级和操作显隐。

Container queries 把响应式判断从页面级断点推进到组件级上下文，让同一组件能安全放进 grid、sidebar、drawer、modal 和 dashboard 插槽。

纹理背景应作为次级层级接入 token、CSS/SVG 输出和降级策略；在 forced-colors、打印、移动端和低带宽下仍要保留可读界面。

背景纹理的价值是增加表面深度、品牌语气或冗余编码，不是抢走信息层级。生产实现必须把纹理当作可关闭、可压缩、可替换的 surface layer。