OpenPencil developer-terminal-dark 风格指南:在 AI 设计工具中复刻 VS Code 开发者深色界面
OpenPencil developer-terminal-dark 风格指南:在 AI 设计工具中复刻 VS Code 开发者深色界面
导读
developer-terminal-dark 是 OpenPencil 内置的 60+ 套视觉风格指南(style guide)之一,它面向开发者工具类 Web 应用,用精确复刻 VS Code 默认深色主题的 #1E1E1E 背景、#569CD6 蓝色强调色与 Fira Code 等宽字体,把「代码编辑器」的质感整体迁移到界面设计上。本文以该指南的完整设计规范为主体,结合 style_guide 模块 的源码实现,讲解这套风格从色彩、排版、间距、圆角到图标的全套 Token 定义,以及它在 OpenPencil「Design-as-Code」生成流程中如何被选择、注入并最终落成画布上的真实节点。读完本文,你将掌握这套 IDE 风格的全部设计参数,并理解风格指南在 AI 生成管线中的实际工作机制。
风格定位:为什么是 VS Code 深色
该指南的元数据(frontmatter)声明了它的身份:
---
name: 'developer-terminal-dark'
tags: [developer, terminal, dark-mode, monospace, minimal, tech, code-inspired]
platform: webapp
---
name是风格指南的唯一标识,也是生成计划中styleGuideName字段使用的精确名称;tags供标签匹配(tag score)选择,覆盖developer(开发者)、terminal(终端)、dark-mode(深色)、monospace(等宽)、minimal(极简)、tech(科技)、code-inspired(代码启发)等语义;platform: webapp将其限定在 Web 应用场景,不会被移动端(mobile)请求匹配到——平台过滤在 types.rs 中是硬过滤。
这份指南的核心美学主张:
- IDE 调色板:背景
#1E1E1E与强调色#569CD6直接取自 VS Code 默认深色主题; - 代码排版:标题与数据值使用 Fira Code,保留编程连字(ligature)能力,营造原生开发环境感;
- 紧凑圆角:4–8px 的圆角范围贴合 IDE 面板审美,工具感强、不软不圆;
- 活动栏模式:窄左栏纯图标导航,复刻 VS Code activity bar;
- 语法启发的色彩编码:蓝色主操作、绿色成功、橙色警告,与常见语法高亮主题一致;
- 标签页导航:内容区采用下划线高亮的 tab 式页头。
此外,指南开头有一段强制的 Style Scope 声明:它强调该指南自包含(self-contained),调色板、圆角、间距、阴影与组件处理仅在选中本指南时生效,不得与其他风格互相借用;未命名布局帧默认保持结构性(无填充、无描边、无圆角、无阴影),层级关系应由间距、排版和本指南明确的表面(surface)来建立,避免为组件套装饰性外壳。仓库的审计测试 loader.rs 测试 会校验每个指南都包含 ## Style Scope、This guide is self-contained 与 Treat unnamed layout frames as structural by default 这三段防串味约束,确保各指南之间不产生视觉泄漏。
色彩系统
核心背景
| Token | 值 | 用途 |
|---|---|---|
| Page Background | #1E1E1E |
页面根背景(VS Code dark) |
| Card Surface | #252526 |
卡片、面板、编辑器表面 |
| Sidebar Surface | #1E1E1E |
活动栏 / 侧栏背景 |
| Inset Surface | #2D2D2D |
输入框、嵌套容器、代码块 |
| Title Bar | #3C3C3C |
顶栏、标签页头 |
背景体系采用「同一明度的分层」策略:页面与侧栏同为 #1E1E1E,卡片 #252526 略微提亮,输入区 #2D2D2D 再提一级,顶栏 #3C3C3C 最深。这与 VS Code 的 editor → sidebar → title bar 层级一一对应,是开发者用户无需学习即可辨认的「可信深色」。
文本色
| Token | 值 | 用途 |
|---|---|---|
| Primary Text | #D4D4D4 |
标题、主内容(VS Code 前景色) |
| Secondary Text | #9CDCFE |
变量式文本、次要高亮 |
| Tertiary Text | #808080 |
注释、说明文字、非激活标签 |
| Muted Text | #5A5A5A |
占位符、禁用态 |
| Accent Text | #569CD6 |
关键字、激活项、链接 |
| String Text | #CE9178 |
带引号的值、特殊标签 |
文本色参考了 VS Code 语法高亮:#D4D4D4 正是 VS Code 默认前景,#9CDCFE 对应变量色,#CE9178 对应字符串色,#569CD6 对应关键字色。把「注释灰」「字符串橙」搬进 UI 文案层级,让界面在工程师眼里天然「像编辑器」。
边框色
| Token | 值 | 用途 |
|---|---|---|
| Default Border | #3C3C3C |
卡片边框、面板分隔线 |
| Subtle Border | #2D2D2D |
分区隔线、细分隔 |
| Active Border | #569CD6 |
聚焦输入框、激活 tab 下划线 |
| Active Muted Border | #569CD640 |
25% 透明度的装饰强调 |
#569CD640 是 8 位 hex 的 25% 透明度写法——这是一个值得注意的细节:OpenPencil 的节点填充模型支持带 alpha 的颜色值(参见 parser.rs 中对 #RRGGBB 的解析,以及设计节点填充的 fill 数组语义),因此「半透明强调色」可以直接落到画布上而不需要额外的透明度节点。
强调色
| Token | 值 | 用途 |
|---|---|---|
| Primary Accent | #569CD6 |
激活态、关键字、tab 指示 |
| Accent Subtle | #569CD620 |
悬停背景、选中着色(约 12.5% 透明度) |
| Success | #6A9955 |
正向指标、成功态(注释绿) |
| Error | #F44747 |
错误态、破坏性操作 |
| Warning | #CE9178 |
警告、字符串色警报 |
| Info | #4EC9B0 |
信息徽标(类型绿) |
Success/Error/Info 三个语义色分别对应 VS Code 语法主题中的注释绿 #6A9955、错误红 #F44747 和类型名青绿 #4EC9B0,形成一整套「语法语义 → 产品语义」的映射,是这套指南最具辨识度的设计决策。
排版系统
字体家族
| 角色 | 字体 | 用途 |
|---|---|---|
| Display / Data | Fira Code | 指标值、标题、标签、导航、代码引用 |
| Body | Inter | 正文、描述、长段落 |
Fira Code 承担展示与数据角色——它的编程连字让 !=、=>、=== 等在界面数据展示中呈联合字符,强化「代码感」;Inter 负责可读性最好的正文。这个双字体策略在 parser.rs 中被识别为 display_font / body_font,Fira Code 同时命中 data/mono 关键字而成为 data_font,从而可以被风格切换映射(见下文)整体替换。
字号阶梯(Type Scale)
| 层级 | 字号 | 字体 | 字重 | 用途 |
|---|---|---|---|---|
| Display | 36px | Fira Code | 700 | Hero 指标值、主计数器 |
| Title 1 | 24px | Fira Code | 600 | 章节标题 |
| Title 2 | 18px | Fira Code | 600 | 卡片标题、面板标题 |
| Title 3 | 15px | Fira Code | 500 | 列表项标题、子面板头 |
| Body | 14px | Inter | 400 | 描述、正文 |
| Body Mono | 13px | Fira Code | 400 | 代码片段、终端输出 |
| Label | 12px | Fira Code | 500 | 字段标签、tab 标签、列头 |
| Caption | 11px | Fira Code | 400 | 时间戳、元数据、文件路径 |
| Micro | 10px | Fira Code | 500 | 状态徽标、行号(大写) |
字重与字距
| 字重 | 值 | 用途 |
|---|---|---|
| Regular | 400 | 正文、代码、描述 |
| Medium | 500 | 标签、导航项、次级标题 |
| Semibold | 600 | 章节标题、卡片标题 |
| Bold | 700 | Display 指标、主强调 |
字距(letter spacing)规则:
- Display 指标(36px):
-1px(收紧大字号); - 大写标签:
+1px至+1.5px(Micro 徽标、全大写标签需放宽); - 等宽代码:
0px(保持等宽字体天然字距); - 正文:
0px。
行高(line height)规则:
- Display(36px):
1.0; - 标题(18–24px):
1.2; - 正文(14px):
1.5; - 代码 / 说明(10–13px):
1.4。
间距系统
间隙阶梯(Gap Scale)
| 值 | 用途 |
|---|---|
| 0px | 活动栏项(仅靠 padding 分隔) |
| 4px | 行内图标+文本对、状态点到标签 |
| 8px | tab 组、紧凑指标区 |
| 12px | 列表项之间、按钮组 |
| 16px | 卡片内部区块、导航项间距 |
| 20px | 面板分区、表单字段组 |
| 24px | 网格中卡片之间 |
| 28px | 内容区主要分区 |
| 32px | 页面顶层分区 |
内边距阶梯(Padding Scale)
| 值 | 用途 |
|---|---|
| [8, 12] | 活动栏项 |
| [10, 16] | 标准按钮 |
| [8, 12] | 输入框、紧凑按钮 |
| 16px | 卡片内边距(紧凑) |
| 20px | 标准卡片内边距 |
| 24px | 大卡片内边距、区块缩进 |
| [24, 32] | 内容区内边距 |
[w, h] 记法表示水平/垂直双向 padding,是 OpenPencil 节点布局(layout / gap / padding 属性)的常规写法,可直接映射到画布 frame 的 padding 值。
布局模式(Layout Pattern)
- 屏幕宽度:
1440px; - 活动栏:
48px宽、垂直、纯图标、图标居中; - 侧栏面板:
240px宽、垂直、gap 为 0(项与项之间靠 padding 分隔); - 内容区:宽度
fill_container、高度fit_content、垂直、gap 24–32、padding [24, 32]; - Tab 下划线指示:
2px底部边框、强调蓝。
这套布局定义了开发者工具产品的「骨架三栏」:窄活动栏 + 中侧栏 + 弹性内容区,与 VS Code 的窗口结构同构。fill_container / fit_content 是 OpenPencil 画布节点的尺寸语义,Agent 生成时直接套用即可获得自适应布局。
圆角系统
| 值 | 用途 | 设计理由 |
|---|---|---|
| 0px | Tab 下划线、分隔线、活动栏 | 扁平精密元素 |
| 4px | 按钮、输入框、徽标、小元素 | 紧凑的 IDE 式圆角 |
| 6px | 卡片、面板、下拉菜单 | 主容器圆角 |
| 8px | 大卡片、模态对话框 | 最大圆角——仍然紧凑 |
设计理由:4–8px 区间复刻了 VS Code 与现代 IDE 面板的观感,圆角恰好达到「可接近」而不「软萌」,保留工具感的同时避免全直角带来的生硬。在 parser.rs 中,Corner Radius 一节会被提取为 card(命中 card/standard/container 行)与 button(命中 button/input/small 行)两个标量,供风格切换时做 from → to 的圆角替换。
图标规范
图标字体
- 字体族:Lucide;
- 风格:线性(outline),圆角连接与端点。
常用图标
terminal, code, file, folder, git-branch, git-commit, search, settings,
play, pause, bug, check-circle, x-circle, chevron-right, chevron-down,
plus, minus, copy, clipboard, download, upload, refresh-cw, eye, lock,
globe, database, cpu, layers
这套图标名与仓库的 icon-catalog.md 规则完全兼容:必须使用 icon_font 节点类型("iconFontFamily": "lucide" + "iconFontName": "terminal"),绝不能使用 path 节点绘制图标,且不能自创名称——未知图标名在画布上会回退成一个小圆。例如渲染活动栏的终端图标:
{
"type": "icon_font",
"name": "Terminal Icon",
"iconFontName": "terminal",
"iconFontFamily": "lucide",
"width": 16,
"height": 16,
"fill": [{ "type": "solid", "color": "#808080" }]
}
图标尺寸
| 尺寸 | 用途 |
|---|---|
| 14px | 行内指示、面包屑分隔符 |
| 16px | 活动栏图标、tab 图标 |
| 18px | 侧栏导航图标、列表项 |
| 20px | 卡片头图标、操作按钮 |
| 24px | 主操作、页头图标 |
图标颜色状态
| 状态 | 颜色 | 用途 |
|---|---|---|
| Active | #569CD6 |
选中的活动栏项、激活 tab |
| Default | #808080 |
未激活项、次要操作 |
| Muted | #5A5A5A |
禁用图标、占位态 |
| On Surface | #D4D4D4 |
提亮表面上的图标 |
图标状态色与文本层级(Accent/Tertiary/Muted/Primary)一一对应,保证整个界面的色彩语义只有一套,这正是 Style Scope 要求的「单一来源」原则。
在 OpenPencil 生成管线中的应用
选择机制:标签打分与精确名称
风格指南由 loader.rs 在编译期随 include_dir! 嵌入二进制并缓存为注册表(registry)。选择逻辑 select_style_guide 遵循两条路径:
- 精确名称优先:计划中
styleGuideName指明名称时,按名称(可附加平台约束)精确查找——这是「子 Agent 可复现性」的关键,audit_tests.rs 专门守护「父 Agent 记录名称、子 Agent 按名称取回同一指南」的契约; - 标签打分:否则按 Jaccard 式命中率
命中标签数 / 请求标签数排序取最高分,同分取注册表更靠前者;无任何匹配时返回None,由调用方回退到style-defaults.md。
在规划阶段,style-guide-selector.md 技能负责推断 3–5 个标签:用户说「developer tool」→ 推断 developer + monospace,「dark」→ dark-mode,然后按标签重叠选出 developer-terminal-dark 这类指南。选中后,名称写入计划的 styleGuideName 字段;decomposition.md 同时要求根 frame 的填充色必须使用所选指南的背景色(如本指南的 #1E1E1E),以实现计划阶段与生成阶段「同源取色」。
注入与消费:Agent 工具闭环
设计 Agent 阶段(design-agent.md)通过工具闭环消费风格指南:
get_style_guide_tags:列出全部可用指南及其标签;get_style_guide(按标签或精确名称):加载具体设计 Token——颜色、字体、字号、间距、圆角、图标风格;- 子 Agent 无法自行调用这两者,必须由主 Agent 在计划中传入解析后的名称(
styleguideName),保证多 Agent 协同下的风格一致性。
风格指南的 markdown 全文会被原样注入生成提示词(ParsedStyleGuide.content 保留原始 markdown,参见 types.rs 与 loader.rs),因此这套指南的每一张表、每一个 Token 都是模型生成画布节点的「事实来源」。系统提示词还强制「选择恰好一个调色板来源」,当没有匹配的内置风格时,保留所选指南的具体色值路径,禁止混入无关预设(参见 lib.rs 测试)。
风格切换:结构化提取与 from→to 替换
parser.rs 会把指南 markdown 结构化为 StyleGuideValues:从 ## Color System 提取背景/表面/强调/主次文本/边框色,从 ## Typography 的 Font Families 表提取 display/body/data 字体,从 ## Corner Radius 提取 card/button 圆角。之后 mapping.rs 的 build_style_mapping 对两份指南求差,产出 PropertyReplacement(fill_color / text_color / stroke_color / font_family / corner_radius 五类 from → to 对),供 replace_all_matching_properties 工具对既有设计做整体换肤。例如从另一指南切换到本指南,#252526 → #1E1E1E 的 surface 替换、Inter → Fira Code 的 display 字体替换都会落进这个映射包。这意味着你既可以把 developer-terminal-dark 作为新设计的起点,也可以把它作为「重换肤」的目标风格。
适用场景与边界
- 最适合:开发者工具、IDE 类、命令行运维面板、监控与 CI/CD 控制台、代码示例展示型落地页——凡是用户是工程师、产品天然带技术气质的 Web 应用;
- platform: webapp:不适用于移动端请求;移动端有自己的平台守卫规则(如 loader.rs 测试 要求的 Mobile Composition Guardrails);
- CJK 注意:decomposition.md 规定,面向中文/日文/韩文受众时,标题字体必须替换为 Noto Sans SC/JP/KR 等 CJK 兼容字体,正文保持 Inter——Fira Code 只用于代码与数据,不应承载 CJK 正文;
- 风格自包含:不要在本指南中借用其他指南的组件模式(食品、社交、仪表盘等),也不要反向借用本指南的终端元素——这是每个指南 Style Scope 的硬约束。
总结
developer-terminal-dark 用「VS Code 默认深色 + Fira Code 连字排版 + 语法高亮式色彩语义 + 三栏 IDE 骨架 + 4–8px 紧凑圆角」五件套,定义了一整套可直接落到画布的开发者工具界面规范。在 OpenPencil 中,它不仅是静态文档:编译期被嵌入注册表、规划期通过标签打分被选中、生成期被整体注入提示词、编辑期可被结构化提取用于风格切换,形成了「文档即 Token、Token 即画布」的完整闭环。想要构建让工程师「一眼就觉得是本行」的深色工具界面,这套指南就是官方给出的现成答案——它的全部参数都在这篇文章中,可直接用于你的下一次 AI 生成设计。