nex_squid/docs/DESIGN.md

136 lines
6.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Nex 应用视觉规范
版本:1.1
状态:Nex 系列应用统一标准
基准实现:`nex_shift` 的主色系
## 1. 原则
Nex 系列应用共用一套暖色品牌体系。Shift 已经使用的橙色是主品牌色,
Squid 以及后续 Nex 应用不得再各自定义蓝色或其它颜色的主操作色。
- 主操作、选中态、焦点环和进度使用 Nex 主色。
- 页面底色、卡片和正文使用暖中性色,不使用冷蓝色底。
- 绿色、红色、黄色只表达成功、危险和警告,不作为品牌主色。
- 图表、分类和装饰只使用主色、暖中性色或成功/警告/危险状态色。
- 不引入蓝色、紫色、青色、粉色等第二品牌色;状态色也不得用于装饰。
- 新界面必须引用 `src/styles.css` 中的 `--nex-*` 常量,不写新的主色十六进制值。
## 2. 品牌常量
这些值同时写在 `src/styles.css` 的 `:root` 中,是运行时唯一来源。
| 常量 | 值 | 用途 |
| --- | --- | --- |
| `--nex-primary` | `#F26A33` | 主按钮、选中态、焦点、进度 |
| `--nex-primary-hover` | `#E45C2A` | 主色悬停 |
| `--nex-primary-strong` | `#D94F1F` | 主色深阶、主按钮渐变终点 |
| `--nex-primary-pressed` | `#C94A1D` | 按下态 |
| `--nex-primary-soft` | `#FFF0E7` | 主色浅底、权限提示 |
| `--nex-primary-tint` | `#FFF7F2` | 选中卡片、弱高亮 |
| `--nex-ink` | `#342019` | 正文 |
| `--nex-ink-strong` | `#24120A` | 标题 |
| `--nex-muted` | `#7D6256` | 次级文字 |
| `--nex-muted-soft` | `#A98F80` | 说明文字 |
| `--nex-line` | `rgba(89, 51, 34, 0.10)` | 分隔线 |
| `--nex-paper` | `#FBF7F2` | 面板 |
| `--nex-cream` | `#FFF6EE` | 浅色表面 |
| `--nex-canvas` | `#F5EEE7` | 应用底色 |
主色高亮需要透明度时使用 `rgba(var(--nex-primary-rgb), α)`,其中
`--nex-primary-rgb` 为 `242, 106, 51`。
### 状态色
| 常量 | 值 | 用途 |
| --- | --- | --- |
| `--nex-success` / `-strong` / `-soft` | `#17865F` / `#126D4C` / `#E7F8F1` | 完成、安全、已授权 |
| `--nex-warning` / `-strong` / `-soft` | `#A97729` / `#8C6C40` / `#FFF8E9` | 警告、需要注意 |
| `--nex-danger` / `-strong` / `-soft` | `#C85A62` / `#A64048` / `#FFEDEF` | 错误、危险操作 |
对应的 `--nex-success-rgb`、`--nex-warning-rgb`、`--nex-danger-rgb`
用于状态色透明度。组件通过 `.tone-primary`、`.tone-success`、
`.tone-warning`、`.tone-danger`、`.tone-neutral` 五种语义色调取色,
不新增分类专用色调。
## 3. 图标渐变
应用图标的品牌渐变沿用 Shift:
- 起点 `#FFB25C`
- 中段 `#FF6B35`
- 终点 `#C66BFF`
图标主体允许保留应用图标自身的暖橙渐变与粉色高光;它们属于图标资产,
不得扩展为界面装饰色。图标主体的描边和阴影必须使用暖色,不得保留旧版蓝色。
### 侧栏品牌锁定
侧栏标识直接使用打包进应用的 `src-tauri/icons/128x128.png`,不得维护第二份
图标资源。默认视觉为 37 × 37 px、12 px 圆角。
- 一级标题固定为 `Squid`,使用 `--nex-text-lg` / `--nex-weight-display`。
- 中文二级标题固定为 `给你的电脑洗个澡`;英文为
`Give your computer a bath`,使用 `--nex-text-3xs` / `--nex-weight-body`。
- 所有 Nex 应用使用同一锁定结构:应用图标、产品名、产品定位短句。
## 4. 字体规范
字体与 Shift 使用同一套系统字体栈和字号阶梯。所有新界面必须引用下面的
常量,不得再写 7–10px 等阶梯外的字号。
| 常量 | 值 | 用途 |
| --- | --- | --- |
| `--nex-font-sans` | `-apple-system, BlinkMacSystemFont, "SF Pro Display", "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif` | 界面正文 |
| `--nex-font-mono` | `"SF Mono", "Cascadia Code", ui-monospace, monospace` | 路径、哈希、配置值 |
| `--nex-text-3xs` | `11px` | 最小辅助文字与标签 |
| `--nex-text-2xs` | `12.5px` | 正文说明、列表文字 |
| `--nex-text-xs` | `13.5px` | 面板标题 |
| `--nex-text-sm` | `14.5px` | 强调正文 |
| `--nex-text-md` | `16px` | 区块标题 |
| `--nex-text-lg` | `18px` | 品牌与重点标题 |
| `--nex-text-xl` | `21px` | 对话框标题 |
| `--nex-text-hero` | `clamp(28px, 3vw, 38px)` | 页面主标题 |
字重沿用 Shift 的层级:`540` 正文、`620` 中等、`650` 半粗、`680` 粗体、
`720` 重体、`760` 品牌展示。对应常量为 `--nex-weight-body`、
`--nex-weight-medium`、`--nex-weight-semibold`、`--nex-weight-bold`、
`--nex-weight-heavy`、`--nex-weight-display`。
行高常量:`--nex-leading-tight: 1.1` 用于标题,
`--nex-leading-body: 1.55` 用于说明正文。
## 5. 组件规则
- 主按钮:`#FF9664 → --nex-primary → --nex-primary-strong` 的暖色渐变。
- 次按钮:暖白表面、暖棕文字,悬停时使用主色描边。
- 选中卡片:`--nex-primary-tint` 背景与 10% 主色描边。
- 焦点环:`rgba(var(--nex-primary-rgb), 0.55)`,宽度 2px。
- 进度条、开关、勾选框:主色或主色渐变。
- 正文不使用纯黑;标题使用 `--nex-ink-strong`。
- 更新面板面向使用者,只展示当前系统版本、版本状态、更新说明、进度与操作;
更新地址、安装包文件名和哈希留在后端校验流程中,不进入常规界面。
- 下载完成后的“放弃”使用中性描边按钮:34px 高、9px 圆角、暖白半透明表面、
`--nex-ink` 文字;悬停仅切换主色描边与白色表面,与 Shift 保持一致。
- 软件更新不再重复显示“已是最新版本”;当前版本只在系统信息面板中展示,
只有发现更新包时才展开版本变化与操作区。
## 6. 语言与本地化
- 首次启动默认跟随系统语言:macOS 读取 `AppleLocale` / `AppleLanguages`,
Windows 读取 `GetUserDefaultUILanguage`,Linux 读取标准 locale 环境变量。
- 设置中只提供“简体中文”和“English”两个语言选项;尚未手动选择时,选中项反映当前系统语言。
- 手动选择语言会写入 `config.toml` 的 `language`,后续启动继续使用该选择。
- 托盘菜单与主界面使用同一语言,并在切换后立即刷新。
- 当前支持中文与英文,其他系统语言回退到英文。
## 7. 验收
- 全应用不出现蓝色、紫色、青色或粉色界面装饰;品牌色只有橙色。
- 状态色只用于成功、警告和危险,不作为卡片或图表的分类装饰色。
- 页面底色为 `#F5EEE7`,面板为暖白,不使用冷蓝渐变。
- Settings、首次启动权限卡和更新面板共享同一套主色。
- 应用图标与界面使用同一组暖色品牌常量。
- 正文和标签不小于 11px,标题使用统一字号阶梯,不出现 7–10px 的正文。
- 默认语言与系统一致,切换语言后主界面和托盘同步更新。