weights-biases-ui-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Weights Biases UI Skills

Weights Biases UI设计指南

Opinionated constraints for building Weights Biases-style interfaces with AI agents.
为AI Agent构建Weights Biases风格界面的专属约束条件。

When to Apply

适用场景

Reference these guidelines when:
  • Building light-mode interfaces
  • Creating Weights Biases-inspired design systems
  • Implementing UIs with Inter font and 4px grid
在以下场景中请参考本指南:
  • 构建浅色模式界面时
  • 创建受Weights Biases启发的设计系统时
  • 实现采用Inter字体和4px网格的UI时

Colors

色彩规范

  • SHOULD use light backgrounds for primary surfaces
  • MUST use
    #FFFFFF
    as page background (
    surface-base
    )
  • SHOULD limit color palette to 1 distinct colors
  • MUST maintain text contrast ratio of at least 4.5:1 for accessibility
  • 主界面应使用浅色背景
  • 页面背景必须使用
    #FFFFFF
    surface-base
  • 应将调色板限制为1种独特颜色
  • 为保证可访问性,文本对比度必须至少达到4.5:1

Semantic Tokens

语义令牌

TokenHEXRGBUsage
surface-base
#FFFFFFrgb(255,255,255)Page background
令牌十六进制值RGB值用途
surface-base
#FFFFFFrgb(255,255,255)页面背景

Typography

排版规范

  • MUST limit font families to:
  • MUST use
    text-balance
    for headings and
    text-pretty
    for body text
  • SHOULD use
    tabular-nums
    for numeric data
  • NEVER modify letter-spacing unless explicitly requested
  • 必须限制字体族为:
  • 标题必须使用
    text-balance
    ,正文文本必须使用
    text-pretty
  • 数值数据应使用
    tabular-nums
  • 除非明确要求,否则不得修改字间距

Spacing

间距规范

  • MUST use 4px grid for spacing
  • NEVER use arbitrary spacing values (use design scale)
  • SHOULD maintain consistent padding within containers
  • 间距必须使用4px网格
  • 不得使用任意间距值(请使用设计刻度)
  • 容器内的内边距应保持一致

Borders

边框规范

  • NEVER use arbitrary border-radius values (use design scale)
  • SHOULD use subtle borders (1px) for element separation
  • 不得使用任意边框圆角值(请使用设计刻度)
  • 应使用细微边框(1px)分隔元素

Layout

布局规范

  • MUST design for 1920px base viewport width
  • NEVER use
    h-screen
    , use
    h-dvh
    for full viewport height
  • MUST respect
    safe-area-inset
    for fixed elements
  • SHOULD use
    size-*
    for square elements instead of
    w-*
    +
    h-*
  • 必须基于1920px视口宽度进行设计
  • 不得使用
    h-screen
    ,应使用
    h-dvh
    实现全屏高度
  • 固定元素必须考虑
    safe-area-inset
  • 方形元素应使用
    size-*
    而非
    w-*
    +
    h-*

Detected Layout Patterns

已识别的布局模式

  • Main Content: width: 1673px, height: 1080px
  • 主内容区:宽度: 1673px, 高度: 1080px

Components

组件规范

Interactive States

交互状态

Focus

聚焦状态

  • MUST use
    2px
    outline with accent color (
    #5E6AD2
    )
  • MUST use
    2px
    outline-offset
  • NEVER remove focus indicators
  • 必须使用2px宽度的强调色(
    #5E6AD2
    )外轮廓
  • 必须使用2px的外轮廓偏移量
  • 不得移除聚焦指示器

Hover

悬停状态

  • Buttons (primary): lighten background by 10%
  • Buttons (secondary): use
    surface-raised
    background
  • List items: use
    surface-raised
    background
  • 主按钮:背景色提亮10%
  • 次要按钮:使用
    surface-raised
    背景
  • 列表项:使用
    surface-raised
    背景

Disabled

禁用状态

  • MUST use
    opacity: 0.5
  • MUST use
    cursor: not-allowed
  • 必须设置
    opacity: 0.5
  • 必须设置
    cursor: not-allowed

Interaction

交互规范

  • MUST use an
    AlertDialog
    for destructive or irreversible actions
  • SHOULD use structural skeletons for loading states
  • MUST show errors next to where the action happens
  • NEVER block paste in
    input
    or
    textarea
    elements
  • MUST add an
    aria-label
    to icon-only buttons
  • 对于破坏性或不可逆操作,必须使用
    AlertDialog
  • 加载状态应使用结构化骨架屏
  • 错误提示必须显示在操作发生的位置附近
  • 不得阻止
    input
    textarea
    元素的粘贴功能
  • 纯图标按钮必须添加
    aria-label

Animation

动画规范

  • NEVER add animation unless it is explicitly requested
  • MUST animate only compositor props (
    transform
    ,
    opacity
    )
  • NEVER animate layout properties (
    width
    ,
    height
    ,
    top
    ,
    left
    ,
    margin
    ,
    padding
    )
  • SHOULD use
    ease-out
    on entrance animations
  • NEVER exceed
    200ms
    for interaction feedback
  • SHOULD respect
    prefers-reduced-motion
  • 除非明确要求,否则不得添加动画
  • 必须仅对合成器属性(
    transform
    opacity
    )执行动画
  • 不得对布局属性(
    width
    height
    top
    left
    margin
    padding
    )执行动画
  • 入场动画应使用
    ease-out
    缓动函数
  • 交互反馈的时长不得超过200ms
  • 应遵循
    prefers-reduced-motion
    设置

Performance

性能规范

  • NEVER animate large
    blur()
    or
    backdrop-filter
    surfaces
  • NEVER apply
    will-change
    outside an active animation
  • NEVER use
    useEffect
    for anything that can be expressed as render logic
  • 不得对大面积区域执行
    blur()
    backdrop-filter
    动画
  • 不得在非活跃动画场景下使用
    will-change
  • 任何可通过渲染逻辑实现的功能,都不得使用
    useEffect