OpenPencil developer-terminal-dark 风格指南:在 AI 设计工具中复刻 VS Code 开发者深色界面

原创2026-10-11 18:51:401,871 阅读

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 遵循两条路径:

  1. 精确名称优先:计划中 styleGuideName 指明名称时,按名称(可附加平台约束)精确查找——这是「子 Agent 可复现性」的关键,audit_tests.rs 专门守护「父 Agent 记录名称、子 Agent 按名称取回同一指南」的契约;
  2. 标签打分:否则按 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)通过工具闭环消费风格指南:

  1. get_style_guide_tags:列出全部可用指南及其标签;
  2. get_style_guide(按标签或精确名称):加载具体设计 Token——颜色、字体、字号、间距、圆角、图标风格;
  3. 子 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 生成设计。

登录后查看全文
openpencil