用途：glass-dark-ui 用于构建深色模式下的玻璃拟态（glassmorphism）界面，强调可读对比度、磨砂表面和渐变边框。适用于 HTML/CSS、Tailwind 或 React 环境，目标表面包括 hero、仪表盘、模态框和卡片。
主要能力：提供深色 UI 令牌（背景、玻璃填充、边框辉光、主文本、弱化文本）；使用 backdrop-filter 构建磨砂面板；通过 .border-gradient::before 伪元素遮罩实现渐变边框；添加克制的阴影与辉光，并定义清晰的悬停/聚焦状态。
使用方式：先确认环境与目标表面，定义深色令牌，再构建磨砂面板并应用遮罩渐变边框，最后验证对比度与移动端表现。基础令牌以 :root 变量给出，如 --bg-0: #020617、--glass-fill: rgba(15, 23, 42, 0.45)、--text-main: #e2e8f0 等。玻璃面板使用 .glass-panel 类，包含背景渐变、圆角、阴影和 backdrop-filter: blur(18px) saturate(140%)。渐变边框使用 .border-gradient::before，配合 -webkit-mask 与 mask-composite: exclude。Tailwind 用法示例为 section 元素配合 rounded-3xl、border-gradient、bg-slate-950/45、backdrop-blur-xl 等类。
适用场景：深色玻璃 hero 区、发光边框卡片、将明亮 UI 转为深色玻璃拟态、为磨砂导航栏/卡片/模态框添加渐变边框辉光、让深色仪表盘更具高级感。
限制与检查项：正文文本在深色玻璃表面上至少保持 #cbd5e1；避免在模糊上使用纯黑叠加，改用深海军蓝/炭黑透明度；限制辉光半径与强度以保持可读性；确保聚焦环可见；为非模糊环境提供回退，使用更强的实色背景（--glass-fill-strong）。