nex_squid/docs/DESIGN.md

6.7 KiB
Raw Blame History

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 的正文。
  • 默认语言与系统一致,切换语言后主界面和托盘同步更新。