# EdgeChat 后台设计约定

范围仅为 `/admin`。沿用既有 Workbench 布局；默认保留蓝色品牌，站点预设可统一切换奶油樱花粉，不改变布局、字体及状态语义。

- **界面结构**：256px 固定侧栏、64px 顶栏、独立滚动的内容区，阅读宽度最多 1440px。移动导航展开时覆盖工作区，关闭后恢复内容。
- **侧栏导航**：仪表盘独立置顶；「用户与权限」「集成」使用常显分类标题；站点外观、存储统计、安装与维护和隐身模式位于分隔线下。权限与搜索过滤后不显示空分类，长标签换行，子菜单仅由独立箭头展开。
- **颜色**：默认来源为 `frontend/src/styles/admin/tokens.css`；全站预设集中在 `frontend/src/styles/color-themes.css`，通过根节点 `data-color-theme` 切换。粉色预设采用浅樱花粉与雾蓝渐变，按钮浅底深字（`--site-action-*` / `--site-on-action`），不要把文字强调色当作大面积按钮底色；危险/警告/成功色不变。新增组件消费语义变量，不另写主题覆盖。
- **字体**：系统无衬线字体；页面标题 24px，表单与正文 14px 左右，表格 13px，辅助标签不低于 12px；数值使用等宽数字。不下载新字体。
- **层次**：页面标题不包卡片；内容面板使用细边框和轻阴影。主要操作放在页头，表格搜索放在表头工具栏，分页放在表尾。
- **间距**：复用 4/8/12/16/24/32/48px 令牌；面板圆角 10px，控件圆角 6px。
- **仪表盘**：真实聚合数据、紧凑快捷列表与站点摘要；禁止编造趋势、在线状态或图表。
- **用户列表**：搜索仅作用于服务端返回的当前页，明确标注范围；手机把每行排成账号信息块，危险操作常显但弱化填充色。
- **注册邀请**：创建用户按容器宽度排为单行、双列或单列，控件保持 44px；注册链接共用一个面板，以细分隔线代替逐条卡片。身份、用量、操作分列，窄屏顺序堆叠；链接完整可选，不使用截断隐藏内容。
- **状态与可访问性**：焦点环即时可见；加载与错误不得显示为真实零值；支持跳至内容、Esc 收起移动导航与焦点恢复；窄屏主要触控目标至少 44px。
- **性能**：不引入组件库、字体、图表或动画依赖。后台和用户详情继续按需加载；只允许交互反馈，不加装饰动画。遵循减少动态效果偏好。

修改共享视觉规则时优先调整后台 token 与职责明确的样式文件，不在页面叠加重复覆盖，不改动授权或数据访问逻辑。