# 工业控制台与复古终端 UI 设计规范 (Industrial Command Terminal & Retro Brutalism UI Spec)
本文档定义了本项目的核心视觉语言、交互规范与组件设计体系。所有前台(用户端)与后台(管理端)页面及新组件均须严格遵循此规范,杜绝现代圆角拟物与渐变模糊风格,确保全局一致的高对比度工业硬朗质感。
---
## 1. 核心设计哲学 (Design Philosophy)
1. **工业控制中心 (Industrial Ops Center)**:
- 界面整体宛如精密任务调度台与工业终端机。
- 所有容器边缘均使用清晰坚实的纯黑硬边框,强调结构分块与功能模块的独立性。
2. **严禁现代柔光与大圆角 (No Soft Shadows & Rounded Corners)**:
- 严禁使用 `rounded-xl`、`rounded-2xl`、`rounded-3xl`、`rounded-full`(除微型状态圆点指示灯外)。
- 严禁使用带大模糊半径的软阴影(如 `shadow-lg`, `shadow-xl`, `shadow-indigo-500/20`)。
- 全局统一使用**纯黑硬投影 (Hard Drop Shadows)**,如 `shadow-[2px_2px_0px_#000]`, `shadow-[4px_4px_0px_#000]`, `shadow-[8px_8px_0px_#000]`。
3. **等宽与终端美学 (Monospace & Bracket Nomenclature)**:
- 标题、模块头部、状态标签、ID、关键数值和配置均使用等宽字体(`font-mono`)。
- 采用大写命名与终端中括号格式,如 `[ SYSTEM ACCESS // 认证鉴权 ]`、`[ 01 // 商品与结算状态 ]`。
4. **实体机械按压交互 (Tactile Physical Feedback)**:
- 按钮在点击或激活时,位移 `+1px ~ +2px` 并减少投影,产生如同实体机械开关、琴键按压的即时物理反馈(`active:translate-x-0.5 active:translate-y-0.5`)。
---
## 2. 色彩系统 (Color Palette & Tokens)
| 色彩角色 | Tailwind 类名 | 实际十六进制 | 语义与应用场景 |
| :--- | :--- | :--- | :--- |
| **基础边框与投影** | `border-black`, `shadow-[..._#000]` | `#000000` | 全局外边框 (2px / 1px)、硬阴影、主要文字 |
| **主操作 / 琥珀高光** | `bg-amber-300`, `hover:bg-amber-400` | `#FCD34D` / `#FBBF24` | 核心 CTA 按钮、选中状态 Tab、重要指示方块、高亮字段 |
| **终端标题栏底色** | `bg-neutral-200` | `#E5E5E5` | 弹窗顶部栏、表格表头、卡片分组头部 |
| **模块卡片浅底** | `bg-neutral-50` / `bg-white` | `#FAFAFA` / `#FFFFFF` | 卡片容器、表单区块、详情内容区 |
| **代码与终端深底** | `bg-neutral-900` / `bg-black` | `#171717` / `#000000` | 代码编辑器、JSON 预览区、调试日志终端 |
| **成功 / 激活状态** | `bg-emerald-300` / `bg-emerald-100` | `#6EE7B7` / `#D1FAE5` | 成功标签、正常在线状态、支付完成印章 |
| **警告 / 锁定状态** | `bg-amber-200` / `bg-amber-100` | `#FDE68A` / `#FEF3C7` | 冷却锁定中、待确认、部分可用 |
| **危险 / 错误状态** | `bg-rose-200` / `bg-rose-100` | `#FECDD3` / `#FFE4E6` | 禁用、执行失败、删除确认按钮 |
---
## 3. 标准组件规范 (Component Specifications)
### 3.1 弹窗与侧边抽屉 (Modals & Drawers)
```tsx
// 遮罩层 (Mask Overlay)
// 弹窗本体 (Modal Box)
{/* 顶部标题栏 */}
[ MODAL TITLE // 模块标题 ]
{/* 内容区域 */}
{/* 内容卡片 */}
{/* 底部按钮栏 */}
```
---
### 3.2 按钮体系 (Buttons)
1. **主要操作按钮 (Primary Action)**:
```tsx
className="px-4 py-2 bg-amber-300 hover:bg-amber-400 text-black border-2 border-black font-black text-xs uppercase shadow-[2px_2px_0px_#000] transition active:translate-x-0.5 active:translate-y-0.5 disabled:opacity-50"
```
2. **次要操作按钮 (Secondary Action)**:
```tsx
className="px-4 py-2 bg-white hover:bg-neutral-100 text-black border-2 border-black font-bold text-xs uppercase shadow-[2px_2px_0px_#000] transition active:translate-x-0.5 active:translate-y-0.5"
```
3. **危险/删除按钮 (Danger Action)**:
```tsx
className="px-4 py-2 bg-rose-100 hover:bg-rose-200 text-rose-950 border-2 border-black font-bold text-xs uppercase shadow-[2px_2px_0px_#000] transition active:translate-x-0.5 active:translate-y-0.5"
```
4. **小型表格内操作按钮 (Table Inline Action)**:
```tsx
className="px-2 py-0.5 bg-white hover:bg-neutral-100 border border-black text-[10px] font-bold uppercase shadow-[1px_1px_0px_#000]"
```
---
### 3.3 输入框与下拉选择 (Inputs & Form Controls)
```tsx
{/* 文本输入框 */}
{/* 下拉选择框 */}
{/* 多行文本框 */}
```
---
### 3.4 状态印章与标签 (Status Stamps & Badges)
```tsx
{/* 成功 / 正常印章 */}
[ SUCCESS // 成功 ]
{/* 运行中 / 高亮印章 */}
[ RUNNING // 运行中 ]
{/* 锁定 / 冷却印章 */}
LOCKED (15m20s)
{/* 禁用 / 失败印章 */}
[ FAILED // 失败 ]
{/* 通用属性标签 */}
HTTP
```
---
### 3.5 表格规范 (Data Tables)
```tsx
| ID // 名称 |
状态 |
操作 |
| #001 |
正常可用
|
|
```
---
### 3.6 分页控件规范 (Pagination)
```tsx
{/* 统计提示 */}
显示第 1 至 20 条,共 100 条
{/* 分页按钮组 */}
```
### 3.7 JSON 编辑与预览终端规范 (JSON Editor & Viewer)
```tsx
// 轻量级 / 弹窗内 JSON 编辑器 (JsonEditor)
{/* 顶部控制栏 */}
[ JSON TERMINAL // 参数视窗 ]
VALID
{/* 终端代码视窗 */}
```
---
## 4. 关键准则总结 (Do's and Don'ts)
### ✅ 正确做法 (DO's)
- 所有独立卡片与弹窗一律使用 `border-2 border-black` 以及硬阴影 `shadow-[4px_4px_0px_#000]` 或 `shadow-[8px_8px_0px_#000]`。
- 主视觉强调一律使用琥珀黄 `#FCD34D`(`bg-amber-300`)配合纯黑文字。
- 代码、JSON、日志一律使用 `bg-neutral-900 text-neutral-100` 或 `bg-neutral-950 text-emerald-400`。
- 模块标题统一格式:`[ MODULE // SUBTITLE ]` 或 `[ 01 // SECTION NAME ]`。
### ❌ 严禁出现 (DON'Ts)
- ❌ 严禁使用任何形式的大圆角(如 `rounded-xl`, `rounded-2xl`)。
- ❌ 严禁使用弥散性/模糊彩色阴影(如 `shadow-lg`, `shadow-blue-500/20`)。
- ❌ 严禁使用渐变色文字或渐变背景(如 `bg-gradient-to-r`)。
- ❌ 严禁使用过细字体(如 `font-light`, `font-thin`),正文与标签统一使用 Medium、Bold、Black。