OpenPencil terminal-minimal-dark 风格指南全解:终端审美的移动端深色界面设计规范
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)
这份指南明确要求移动端布局遵守以下纪律:
- 顶部节奏紧凑:状态栏、头部与首个内容块应感觉连贯,除非刻意做图引领(image-led)的设计,否则避免出现 80px+ 的空白带;
- 搜索框保持单行整洁:中性输入框 + 可选筛选按钮;不要把输入框再包一层带色调的圆角外壳,分组 Frame 保持结构性、透明;
- 横向导轨与轮播视口透明:不加白色圆角背板、不加额外阴影;只有单个卡片、图片或刻意设计的推广面板才获得 fill、radius 或 elevation;
- 图片卡片上的收藏/点赞/书签/心形操作:只用纯图标叠加或非常微弱的半透明命中区域;不要给心形加白色圆形气泡、边框或阴影;
- 底部导航融入页面流:用安静的分隔线或激活指示条;除非提示词明确要求浮动胶囊导航,否则避免;
- 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 与换肤管线吃的结构化数据"。
- 编译期内嵌:
op-ai-skills通过include_dir!宏在编译期把整个skills/语料(含 style-guides 子目录)嵌入二进制(lib.rs),运行期零文件 IO、可在 wasm32 上工作,且天然无网络依赖(audit_tests.rs 断言注册表 ≥50 份指南且同步返回)。 - frontmatter 解析:
parse_style_guide_file解析name / tags / platform(loader.rs),frontmatter 采用精简 YAML 解析器(frontmatter.rs),支持key: value、[a, b]数组与#注释。 - 选中策略:
select_style_guide(loader.rs)优先按name精确查找(带可选 platform 约束);否则按标签 Jaccard 相似度打分——请求标签命中占比最高者胜出。terminal, dark-mode, monospace, minimal, cyan-accent, tech, developer, crisp这组标签决定了它在"终端/深色/开发者"任务中的命中率。审计测试(audit_tests.rs)确保exact_name_lookup对注册表内每一份指南都能原样返回,这是子代理复现一致性的硬约束。 - 结构化取值:
extract_style_guide_values把## Color System / ## Typography / ## Corner Radius小节解析为StyleGuideValues { colors, typography, radius }(parser.rs),缺失通道由社区 token-table 方言(token_table)补齐。 - 风格切换映射:
build_style_mapping(mapping.rs)把"从指南 A 到指南 B"的差异产出PropertyReplacement:fill 色(背景/表面/强调)、text 色、stroke 色、字体族、圆角 px——即 MCPreplace_all_matching_properties工具执行换肤所用的 from → to 对。例如从本指南切到浅色指南,#0A0F1C → 目标背景色、JetBrains Mono → 目标字体、card 8px → 目标圆角都会被自动计算。 - 用户侧可读反馈:
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-down14px 图标 + 正绿#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 了解整套模块的组成。