OpenPencil terminal-minimal-dark 风格指南全解:终端审美的移动端深色界面设计规范

原创2026-10-11 09:22:361,604 阅读

OpenPencil terminal-minimal-dark 风格指南全解:终端审美的移动端深色界面设计规范

本文围绕 OpenPencil 内置 AI 设计风格指南 terminal-minimal-dark(原始文档)展开,系统拆解这一面向开发者的深色终端风界面规范:从色板 Token、等宽字体排版、紧凑间距到圆角与图标体系,并对照 op-ai-skills crate 的源码说明该规范如何被解析、选中与用于风格切换。读完本文,你将掌握这套移动端深色风格的完整设计参数,并理解 OpenPencil 中"风格指南(Style Guide)→ 结构化取值 → 风格切换"的底层链路,可直接指导你在画布中复现同款终端风界面。

一、指南定位:一份自包含的移动端终端风风格指南

terminal-minimal-dark 是 OpenPencil AI 技能语料库(op-ai-skills crate)中随包发布的数十份风格指南之一,位于 style-guides 目录。其文档头部(frontmatter)定义了这份指南的身份元数据:

name: 'terminal-minimal-dark'
tags: [terminal, dark-mode, monospace, minimal, cyan-accent, tech, developer, crisp]
platform: mobile
  • name:指南的唯一标识,get_style_guide / 子代理 spawn_agents.styleguideName 依赖它做精确查找;
  • tags:受控标签词汇表(STYLE_GUIDE_TAGS)中的合法标签,用于按语义打分匹配(详见第七节);
  • platform:mobile,对应 Platform 枚举 中的 Platform::Mobile——这意味着当设计任务被判定为移动端页面时,它才会进入候选集合。

这份指南的**适用边界(Style Scope)**写得很明确:自包含(self-contained)。只有当用户明确选择这份指南时,才应用它的色板、圆角、间距、阴影与组件处理方式;禁止把它的模式"借用"到其他风格中。同时,未命名的布局 Frame 默认视为结构容器:不给 fill、stroke、cornerRadius 或 shadow,除非该节点确实是卡片、输入框、按钮、徽章、媒体遮罩、导航面等可见组件;避免给组件套装饰性外壳,层级关系应来自间距、排版和本指南明确的表面。

二、风格概述:深海军蓝 × 青色高亮的开发者深色界面

terminal-minimal-dark 面向开发者,灵感来自终端美学与命令行工具。深海军蓝黑背景(#0A0F1C)配尖锐青色(#22D3EE)高亮,营造现代 IDE 或系统监控器的气质,每个元素都显得精确、数据驱动,等宽字体带来"代码原生感"。

六个关键美学特征:

特征 要点
终端色板 深海军蓝 #0A0F1C + 青色 #22D3EE 高亮,呼应终端光标与选区颜色
等宽优先 JetBrains Mono 作为主显示与数据字体,数字和标签都带代码感
紧凑密度 紧密间距 + 小圆角(3–12px),信息密集而不杂乱
辉光指示 状态点与激活态使用微弱青色辉光(blur 8,40% 透明度)
极简镀铬 边框细(#1E293B),表面与背景几乎不分离
集成式底部导航 底部导航以紧凑的 icon+label 项融入页面流,而非浮动胶囊

三、色彩系统:从背景到强调色的完整 Token 表

色彩系统是这份指南的骨架,共四组 Token:核心背景、文字、边框、强调色。值得注意的一点是:指南中出现了 8 位十六进制色值 #22D3EE40(带 40 透明度通道),而引擎的 first_hex 解析器 只提取前 6 位十六进制(7 位及以上会判定不合法)——这正是 Accent Muted 作为"辉光/徽章背景"使用时透明度语义的体现,也说明结构化提取时该值会以 #22D3EE 参与映射。

核心背景(Core Backgrounds)

Token 值 用途
Page Background #0A0F1C 根屏幕背景
Card Surface #111827 卡片、输入框、列表项
Inset Surface #0F172A 嵌套容器、代码块
Tab Bar Surface #111827 集成式底部导航表面

文字颜色(Text Colors)

Token 值 用途
Primary Text #F1F5F9 标题、指标值、激活标签
Secondary Text #94A3B8 正文、描述
Tertiary Text #64748B 时间戳、说明文字、非激活标签
Muted Text #475569 占位符、禁用态
Accent Text #22D3EE 激活导航项、链接、状态标签

边框颜色(Border Colors)

Token 值 用途
Default Border #1E293B 卡片边框、分隔线
Subtle Border #162032 区块分隔
Active Border #22D3EE 聚焦输入框、激活 Tab 指示条

强调色(Accent Colors)

Token 值 用途
Primary Accent #22D3EE 激活态、高亮、链接
Accent Muted #22D3EE40 辉光效果、徽章背景
Success #22C55E 正向指标、完成态
Error #EF4444 错误指示、破坏性操作
Warning #F59E0B 告警、待处理态

从源码看,这些 Token 在解析时被映射为结构化的 StyleColors(types.rs):Page Background → background、Card Surface / surface → surface、Default Border → border、Primary Accent → accent、Primary / Secondary / Muted Text → text_primary / text_secondary / text_muted。这意味着这份指南可以被引擎"读懂",进而用于两套风格之间的自动换肤(详见第七节)。

四、排版系统:JetBrains Mono × Inter 双字体等宽优先

字体族(Font Families)

角色 字体族 用途
Display / Data JetBrains Mono 指标值、标题、时间戳、导航标签
Body Inter 描述、正文段落、次级标签

"等宽优先"是本风格区别于其他深色风格的核心:所有"数字类"信息(指标、时间戳)和界面骨架(标题、导航标签)都用 JetBrains Mono,正文才回退到 Inter 的无衬线舒适阅读。

字阶(Type Scale)

层级 字号 字体 字重 用途
Display 36px JetBrains Mono 700 Hero 指标值
Title 1 24px JetBrains Mono 600 区块标题
Title 2 17px JetBrains Mono 600 卡片标题、小节标题
Title 3 15px JetBrains Mono 500 列表项标题
Body 14px Inter 400 描述、正文
Label 12px JetBrains Mono 500 导航标签、字段标签
Caption 11px JetBrains Mono 400 时间戳、元数据
Micro 10px JetBrains Mono 500 状态徽章、Tab 标签(大写)
Tiny 9px JetBrains Mono 500 辅助数据、脚注

字重、字距与行高

  • 字重:Regular 400(正文)、Medium 500(标签/次级标题/导航)、Semibold 600(小节标题/卡片标题)、Bold 700(Hero 指标/主标题);
  • 字距:大写标签 +1px 至 +2px;Display 指标 −1px;默认正文 0px;Tab 栏标签 +1px;
  • 行高:Display(36px)1.0;标题(17–24px)1.2;正文(14px)1.5;说明文字(10–11px)1.4。

排版节在引擎中的处理值得留意:extract_typography(parser.rs)按 ### Font Families 表格的 Role 列关键词(display / body / data / mono)识别三路字体,并写入 StyleTypography { display_font, body_font, data_font }。也就是说,只要这份指南被选中,JetBrains Mono 与 Inter 就会作为结构化值参与后续的风格映射——例如从 Inter → JetBrains Mono 的字体族替换。

五、间距系统:8 级 Gap 与 7 档 Padding 的紧凑节奏

Gap 刻度(元素间距离)

值 用途
2px 行内 icon+text 微组合
4px Tab 图标到标签、紧密元素组
6px 状态点到标签
8px 指标变化指示组、紧凑卡片分区
12px 列表项之间、按钮组
16px 卡片内部区块、表单字段组
20px 卡片主要分区(头部、数值、变化)
24px 网格中卡片之间
32px 屏幕区块间距

Padding 刻度(元素内边距)

值 用途
[0, 24] 屏幕内容包裹层(仅水平)
[12, 21, 21, 21] Tab 栏区域外边距
4px 集成式 Tab 栏内边距
[8, 12] 输入框、小按钮
[10, 16] 标准按钮
16px 卡片内边距(紧凑)
20px 卡片内边距(标准)
24px 大卡片内边距、区块内边距

布局模式(Layout Pattern)

  • 屏幕宽度:402px(移动端);
  • 内容包裹层:padding [0, 24]、垂直方向、gap 24–32;
  • 集成式 Tab 栏:高度 62–72px、cornerRadius 0–12、padding 0–4、在页面流中全宽;
  • Tab 项:fill_container、垂直、gap 4、居中对齐。

移动端组合护栏(Mobile Composition Guardrails)

这份指南明确要求移动端布局遵守以下纪律:

  1. 顶部节奏紧凑:状态栏、头部与首个内容块应感觉连贯,除非刻意做图引领(image-led)的设计,否则避免出现 80px+ 的空白带;
  2. 搜索框保持单行整洁:中性输入框 + 可选筛选按钮;不要把输入框再包一层带色调的圆角外壳,分组 Frame 保持结构性、透明;
  3. 横向导轨与轮播视口透明:不加白色圆角背板、不加额外阴影;只有单个卡片、图片或刻意设计的推广面板才获得 fill、radius 或 elevation;
  4. 图片卡片上的收藏/点赞/书签/心形操作:只用纯图标叠加或非常微弱的半透明命中区域;不要给心形加白色圆形气泡、边框或阴影;
  5. 底部导航融入页面流:用安静的分隔线或激活指示条;除非提示词明确要求浮动胶囊导航,否则避免;
  6. 9999px 圆角只用于真圆或小胶囊:头像、状态点、短徽章;绝不用于页面区块、搜索外壳、轮播、卡片操作按钮或整条导航栏。

从审计测试(loader.rs 测试)可见,"Search should be one clean row"、"carousel viewport frames stay transparent"、"do not add circular white bubbles" 等护栏是移动端指南的强制检查项;audit_tests.rs 还强制每一份指南都必须包含 ## Color System 与 ## Typography 两个结构化小节,确保引擎能稳定提取换肤所需的 Token。

六、圆角与图标:精确工程的弧度语言与 Lucide 图标体系

圆角刻度(Corner Radius)

值 用途 理由
0px 分隔线、全宽分割条 扁平技术精确感
3px 徽章、微型指示 几乎不可感知的柔和
6px 输入框、小按钮 紧凑技术感
8px 标准卡片、列表项 主要容器圆角
12px 大卡片、模态面板 舒适但紧凑
9999px 仅头像、状态点、短徽章 真圆/胶囊用于语义性微元素;绝不用于导航、搜索、轮播或卡片操作按钮

设计理由:3–12px 的紧凑圆角保持干脆的技术美学——锐利边角暗示精密工程,轻微圆角又避免过于生硬的粗野主义(brutalist)观感。底部导航保持紧凑与集成,靠图标/标签的对比度给出清晰可点性,而不是靠浮动胶囊容器。

引擎侧,extract_radius(parser.rs)解析该小节中带 px 的整数,按关键词把 Standard cards / 8px 归为 card、把 Input fields / small buttons / 6px 归为 button,产出 StyleRadius { card: 8, button: 6 }——这两档圆角正是风格切换时 cornerRadius 替换对(from → to)的数据来源。

图标(Icons)

  • 图标族:Lucide;
  • 风格:Outline,圆角连接与端帽(rounded joins and caps);
  • 常用图标:home, search, bell, settings, user, calendar, check-circle, trending-up, trending-down, clock, activity, target, plus, x, chevron-right, chevron-down, bar-chart-2, zap, terminal, code(终端与代码图标尤其契合本风格的数据/开发气质);
  • 尺寸刻度:
尺寸 用途
14px 与文字同行、指标变化指示
18px Tab 栏图标、列表项前置图标
20px 卡片头部图标、操作按钮
24px 主导航、头部操作
  • 颜色状态:
状态 颜色 用途
Active #22D3EE 选中 Tab、激活导航
Default #94A3B8 未激活 Tab、次级操作
Muted #475569 禁用、占位图标
On Background #F1F5F9 强调色表面上的图标

七、源码级原理:这份指南如何被 OpenPencil 引擎使用

terminal-minimal-dark 是 OpenPencil AI 设计管线中的一等公民。理解以下链路,就能明白这份文档不只是"给人看的规范",更是"给 Agent 与换肤管线吃的结构化数据"。

  1. 编译期内嵌:op-ai-skills 通过 include_dir! 宏在编译期把整个 skills/ 语料(含 style-guides 子目录)嵌入二进制(lib.rs),运行期零文件 IO、可在 wasm32 上工作,且天然无网络依赖(audit_tests.rs 断言注册表 ≥50 份指南且同步返回)。
  2. frontmatter 解析:parse_style_guide_file 解析 name / tags / platform(loader.rs),frontmatter 采用精简 YAML 解析器(frontmatter.rs),支持 key: value、[a, b] 数组与 # 注释。
  3. 选中策略:select_style_guide(loader.rs)优先按 name 精确查找(带可选 platform 约束);否则按标签 Jaccard 相似度打分——请求标签命中占比最高者胜出。terminal, dark-mode, monospace, minimal, cyan-accent, tech, developer, crisp 这组标签决定了它在"终端/深色/开发者"任务中的命中率。审计测试(audit_tests.rs)确保 exact_name_lookup 对注册表内每一份指南都能原样返回,这是子代理复现一致性的硬约束。
  4. 结构化取值:extract_style_guide_values 把 ## Color System / ## Typography / ## Corner Radius 小节解析为 StyleGuideValues { colors, typography, radius }(parser.rs),缺失通道由社区 token-table 方言(token_table)补齐。
  5. 风格切换映射:build_style_mapping(mapping.rs)把"从指南 A 到指南 B"的差异产出 PropertyReplacement:fill 色(背景/表面/强调)、text 色、stroke 色、字体族、圆角 px——即 MCP replace_all_matching_properties 工具执行换肤所用的 from → to 对。例如从本指南切到浅色指南,#0A0F1C → 目标背景色、JetBrains Mono → 目标字体、card 8px → 目标圆角 都会被自动计算。
  6. 用户侧可读反馈:style_guide_summary(summary.rs)把钉住的指南压缩为"名称 + 最多 4 个色板"的收据(背景、表面、强调、主文字),style_guide_card(card.rs)则在悬停时展示更完整的色带、字体与一句自述,二者均按 id 记忆化,避免渲染路径上反复解析数十字节文档。

八、实战落地:把这份规范应用到你的移动端深色界面

以下是一份可直接对照执行的落地清单,全部参数取自本指南原文:

  • 页面根:背景 #0A0F1C,内容容器水平 padding 24px、垂直方向 gap 24–32px,宽度基准 402px;
  • 卡片:表面 #111827,圆角 8px,内边距 16–20px,边框 #1E293B(1px 级细线),卡内分区间距 20px;
  • 数据指标:JetBrains Mono,Display 36px / Bold / 行高 1.0,颜色 #F1F5F9;变化量用 trending-up/trending-down 14px 图标 + 正绿 #22C55E / 负红 #EF4444 标识;
  • 表单控件:输入框表面 #111827、圆角 6px、内边距 [8, 12],聚焦边框 #22D3EE,占位文字 #475569;
  • 列表:列表项间距 12px,列表项标题 Title 3(15px / 500 / JetBrains Mono),时间戳 Caption(11px / #64748B);
  • 徽章与状态点:圆角 9999px(仅限短徽章/状态点),成功 #22C55E、错误 #EF4444、警告 #F59E0B;状态点辉光用 #22D3EE40 + blur 8px;
  • 底部导航:融入页面流、全宽,高度 62–72px、圆角 0–12px,图标 18px + 标签 12px(gap 4px,字距 +1px),激活态图标/文字/指示条全部 #22D3EE,未激活 #94A3B8;
  • 图标:一律 Lucide outline 风格,按上文四档尺寸与四种颜色状态使用;
  • 禁区:不在搜索框外包圆角外壳、不给心形/收藏加圆形气泡、不用 9999px 圆角做区块与导航、不引入浮动胶囊导航(除非提示词明确要求)。

遵循以上参数即可在 OpenPencil 画布上稳定复现 terminal-minimal-dark 的"现代 IDE 终端"观感;而当你需要整体换肤时,该指南提供的结构化 Token 正是引擎自动计算 from → to 替换对的基础,让风格切换保持数据驱动而非手工逐节点重绘。

九、小结

terminal-minimal-dark 是一份密度高、纪律严的移动端深色风格指南:深海军蓝 #0A0F1C 打底、青色 #22D3EE 点睛、JetBrains Mono 撑起数据感、3–12px 紧凑圆角与 8 级 Gap 刻度保证信息密度,并通过 Style Scope 与移动端护栏约束生成的边界。在 OpenPencil 的架构里,它既是以 Markdown 呈现的设计规范,也是被 parser.rs、loader.rs 与 mapping.rs 消费的结构化数据源——这让同一份文档同时服务于"人读"与"机器换肤"两种用途。需要进一步研究时,可对照 style-guides 全目录 查看其余深色风格(如 developer-terminal-dark、dashboard-analytics-dark)的差异化设计,以及 style_guide/mod.rs 了解整套模块的组成。

登录后查看全文
openpencil