# 前端重设计 v2 —— 页面改造规范
本文件是改造**页面**时必须遵守的约定。基础设施(主题、布局、图标、样式)已经完成,
不需要你动。
## 0. 铁律
1. **不动业务逻辑。** API 调用、轮询定时器、SSE 流式解析、上传与压缩、localStorage 键名、
错误分类、二次确认、权限判断 —— 全部保持与原文件**语义等价**。你只改模板结构与样式。
2. **不写硬编码颜色。** 不许出现 `#fff` / `#909399` / `#3b5998` / `rgba(0,0,0,.06)` 这类
具体色值(图表除外,图表用 `chartTheme()`)。一律用下面的 CSS 变量。
3. **不用 emoji 当图标。** 用 ``。
4. **不改 `src/locales/*.ts`。** 文案优先复用已有 key;确实缺 key 时,把
「key 路径 + 中文 + English」写进你的最终报告,由主流程统一补。
5. **完成后必须跑 `npm run typecheck`,要求 0 error。**
## 1. 主题 token(src/style.css 已定义,直接用)
| 变量 | 用途 |
| --- | --- |
| `--bg` / `--bg-2` | 页面底色(bg 是内容区,bg-2 是最外层) |
| `--surface` / `--surface-2` | 卡片底 / 次级底(输入框、只读控件) |
| `--line` / `--line-2` | 分隔线(line 明显,line-2 极淡) |
| `--text` / `--muted` / `--muted-2` | 主文字 / 次要 / 更淡 |
| `--primary` / `--primary-ink` / `--primary-soft` | 主色 / 主色上的字 / 主色淡底 |
| `--ok` `--warn` `--err` + `--ok-soft` `--warn-soft` `--err-soft` | 语义色与淡底 |
| `--chip` | 灰色小底(标签、胶囊) |
| `--radius` / `--radius-s` / `--radius-l` | 12 / 8 / 16 |
| `--gap` | 14px 间距 |
| `--chart-a` / `--chart-b` | 图表主/辅色(ECharts 用 `chartTheme()` 取) |
三套主题 A(深空蓝,深色)/ B(素白蓝紫,默认)/ C(暖砂墨绿)会自动切换这些变量,
**页面不需要为某个主题写特例**。
## 2. 页面外壳
```vue
…
…
```
`.page` / `.page-fill` 自带 16/20 的内边距,窄屏自动收成 12/14。
`.page-fill` 内部需要自己安排「固定区 + 可滚区」。
**不要再使用** `.main-scroll`、`.page-card`(已删除)、`el-row` + `el-col` 栅格。
## 3. 现成类(都在 src/style.css)
- 卡片:`.card`(白底圆角边框)+ `.card-h`(内放 `标题` 和 `副标题`
以及右侧 `.pager`)
- KPI:`.kpis`(4 列网格)> `.kpi` > `.k` / `.v` / `.f`;`.delta.up/.down/.flat`;
窄屏自动两列
- 栅格:`.grid2`(1.55fr 1fr)、`.grid3`(1.35fr 1fr)、`.grid-eq`(1fr 1fr),自带 `margin-top: var(--gap)`
- 竖排信息行:`.pv` > `.pv-i` > `.nm` / `.st`;进度条 `.bar` > `i`(`width` 控制)
- 状态胶囊:`.pill.ok/.warn/.err/.mute`;徽标 `.badge.g/.o/.r/.m`
- 可选中的胶囊:`.chip-sel`(选中加 `.on`)
- 表单:`.field`(`