<!--
本文件是 docs/06-UI交互规范.md 的 § 一 ~ 三 大纲（§ 三页面清单由 downstream-gen 按模块追加；FE 决策表由 A6 frontend-scope-lock 追加到 § 三之后）。
skeleton-gen 读取 docs/04 § 零 和 docs/01 index，按下述大纲生成项目专属内容。
布局/页面骨架以项目根的 prototype/ 静态 HTML mockup 为权威，本文件仅承载跨页面通用规则与 Design Tokens。
-->

# 06-UI交互规范

> 本项目所有页面布局以项目根 `prototype/` 目录下的静态 HTML mockup 为权威。前端阶段实现时直接以 prototype/ HTML 推导组件树与样式。本文件仅承载跨页面通用规则与 Design Tokens。

## 一、通用交互规则

### 1.1 操作反馈
<!-- 成功/失败消息；危险操作二次确认；长耗时按钮 loading 态。 -->

### 1.2 数据展示
<!-- 空状态 / 加载 / 异常 的统一组件与文案。 -->

### 1.3 权限控制（前端）
<!-- 菜单级 / 按钮级 / 路由级的控制方式，关联后端 RBAC。 -->

## 二、Design Tokens

<!-- 所有色值统一以 CSS 变量定义于 src/styles/tokens.css；命名规范见 docs/04 § 2.5。 -->

### 2.1 全局调色板
<!-- 与 § 零 UI 库主题对齐：列名 = 语义 / 变量名 / 默认值 / 用途。
     至少含：主色/成功/警告/错误/主文字/次文字/边框/背景。 -->

### 2.2 组件级状态色
<!-- 场景 × 状态映射表：列名 = 序号 / 组件 / 编辑bg / 只读bg / 悬浮bg / 编辑fg / 只读fg / 悬浮fg / 备注。
     单元格写 token 名（var(--color-xxx) 形式），不写 hex；"—" 表示该状态不适用。
     表后追加「Token 默认值」表，列出每个 --color-xxx 在 tokens.css 的默认值。 -->

### 2.3 引用约定
<!-- 一句话三条：
     - 组件样式只用 var(--color-xxx)，禁止硬编码
     - 新增 token 须先登记到 § 2.1/2.2 再补 tokens.css
     - 修改色值只改 tokens.css 一处，不允许组件覆盖 -->

## 三、页面清单
（由 `downstream-gen` 按模块追加段落）