OpenPencil 工业霓虹暗色风格指南:industrial-neon-dark 全解析与源码级实现原理
OpenPencil 工业霓虹暗色风格指南:industrial-neon-dark 全解析与源码级实现原理
本指南是 OpenPencil AI 技能体系(
op-ai-skills)内置的 60 余份视觉风格指南之一,专为工业控制面板与工厂 HUD 气质的 Web 应用界面而设计。阅读本文后,你将掌握industrial-neon-dark的完整设计令牌体系(颜色、字体、间距、圆角、图标),理解它在 AI 设计 Agent 生成管线中如何被解析、按标签匹配、注入提示词,以及如何用于风格切换与对比度校验。
一、风格指南在 OpenPencil 中的定位
industrial-neon-dark 是 crates/op-ai-skills/skills/style-guides/industrial-neon-dark.md 这份文档定义的 Web 应用(platform: webapp)视觉风格。它以 Markdown + Frontmatter 形式存放在风格指南语料库中,随 op-ai-skills crate 编译期嵌入二进制(见 lib.rs 中的 include_dir! 与 SKILLS 静态目录),因此无需运行时文件 IO,即使编译到 wasm32 目标也可用。
其 Frontmatter 定义如下:
name: 'industrial-neon-dark'
tags: [industrial, neon, dark-mode, neon-green, monospace, tech, sharp-corners]
platform: webapp
name是风格指南在注册表中的唯一标识,供get_style_guide(name: ...)精确查找;tags是标签匹配的关键输入。从 types.rs 的受控标签词汇表(STYLE_GUIDE_TAGS)看,neon、dark-mode、monospace、tech、sharp-corners均命中受控词表,可直接参与匹配打分;industrial、neon-green属于补充描述性标签;platform决定该指南只会在 Web 应用(webapp)类任务中被检索,不会泄漏到移动端、落地页或幻灯片任务(Platform::from_str对未知值回退为Webapp,见 types.rs)。
Style Scope:样式作用域的硬性约束
指南开头有一段所有语料库指南共享的 ## Style Scope 声明,这是加载器测试强制校验的内容(见 loader.rs 的 every_style_guide_declares_its_scope_boundary 测试):
- 本指南自包含:调色板、圆角标尺、间距、阴影与组件处理方式,仅在本指南被选中时生效,不得借用其他指南(food、social、dashboard、luxury、terminal 等)的模式;
- 未命名布局帧默认作为结构元素:除非节点确实是有意为之的卡片、输入框、按钮、徽章、媒体遮罩、导航面等可见组件,否则不给 fill、stroke、cornerRadius 或 shadow;
- 避免装饰性包裹外壳:层级关系应来自间距、排版和本指南的显式表面,而不是额外的包裹容器。
这一约束在 Rust 侧由 split_frontmatter + parse_style_guide_file(loader.rs)解析,content 保留完整原始 Markdown,并在生成时逐字注入提示词。
二、风格概述:高压电的工厂仪表盘
industrial-neon-dark 的核心是「高电压暗色界面」,灵感来自工业控制面板与工厂车间的 HUD 显示屏:
- 霓虹与黑的对比:电光绿
#39FF14铺在近黑表面#0C0C0C上,形成最大对比度与毫不含糊的工业身份; - 等宽优先的层级:Space Mono 用于标题、指标与标签,唤起机器读数与终端显示;
- 锐利机械圆角:全局 0–4px 圆角,暗示冲压金属与 CNC 切割面板;
- 辉光效果:活跃元素使用电光绿辉光(blur 10、30% 透明度),模拟 LED 背光;
- 极小表面变化:背景保持在
#0C0C0C到#161616之间,让强调色承载全部视觉重量; - 结构边框:细
#1A1A1A边框界定面板,霓虹边框标记活跃区域。
三、颜色系统:完整令牌表
3.1 核心背景(Core Backgrounds)
| Token | 值 | 用途 |
|---|---|---|
| Page Background | #0C0C0C | 根页面背景 |
| Card Surface | #121212 | 卡片、面板、抬升容器 |
| Sidebar Surface | #0C0C0C | 导航侧边栏背景 |
| Inset Surface | #161616 | 输入框、嵌套容器、代码块 |
3.2 文本颜色(Text Colors)
| Token | 值 | 用途 |
|---|---|---|
| Primary Text | #E8E8E8 | 标题、指标值、活跃标签 |
| Secondary Text | #808080 | 正文、描述、次级标签 |
| Tertiary Text | #555555 | 时间戳、说明文字、非活跃元素 |
| Muted Text | #3A3A3A | 占位符、禁用状态 |
| Accent Text | #39FF14 | 活跃导航、状态标签、链接、高亮 |
3.3 边框颜色(Border Colors)
| Token | 值 | 用途 |
|---|---|---|
| Default Border | #1A1A1A | 卡片边框、面板分隔线、表格规则 |
| Subtle Border | #141414 | 区块分隔线、轻量分割 |
| Active Border | #39FF14 | 聚焦输入框、活跃面板指示器 |
| Active Muted Border | #39FF1440 | 装饰性霓虹描边(25% 透明度) |
3.4 强调色(Accent Colors)
| Token | 值 | 用途 |
|---|---|---|
| Primary Accent | #39FF14 | 活跃状态、高亮、状态 LED |
| Accent Glow | #39FF144D | 辉光效果(30% 透明度) |
| Accent Subtle | #39FF1420 | 淡色背景、悬停状态 |
| Success | #39FF14 | 正向指标(与强调色相同) |
| Error | #FF3333 | 错误状态、告警、破坏性操作 |
| Warning | #FFB800 | 警示指示、待处理状态 |
3.5 颜色在源码中的提取与校验
这份颜色体系并非仅供人阅读,而是可被机器结构化提取的。op-ai-skills 的 parser.rs 会把 ## Color System 小节按 ### 子节解析,用「标签 + 首个 #RRGGBB 十六进制」的方式抽取 background(匹配 page background 或 root + background)、surface(card surface/surface)、accent(优先取 Accent Colors 子节)、text 三档与 border(default border/border/divider)。
提取结果驱动三处关键功能:
- 对比度自动校验:
resolve_style(resolve_style.rs)会把前景/背景对送入 contrast.rs 的scan_pairs,按 WCAG 相对亮度公式计算比值,目标为 4.5:1。语料库测试resolve_our_catalog_zero_aa_violations会对全部风格 × 全部调色板组合断言零违例——即本指南的#E8E8E8主文本在#0C0C0C页面上、#39FF14强调色在近黑表面上的可读性都有程序化保障。注意on_color(contrast.rs)会基于 Oklch 亮度/饱和度决定某个背景上应放深色还是浅色文字——纯绿#39FF14之类的高亮表面会自动配深色前景。 - 会话摘要色板:
style_guide_summary(summary.rs)按 background → surface → accent → text_primary 顺序生成最多 4 个 swatch,用于编辑器聊天面板中展示「当前固定了哪个风格」; - 风格切换映射:
build_style_mapping(mapping.rs)把两个指南的结构化值差异转成from → to的填充色/文本色/描边色/字体族/圆角替换列表,供replace_all_matching_propertiesMCP 工具一次性给现有设计换肤。若把工业霓虹换成另一指南,#0C0C0C → 新背景、#39FF14 → 新强调色这类替换即由此生成。
四、排版系统
4.1 字体族
| Role | Family | 用途 |
|---|---|---|
| Display / Data | Space Mono | 指标值、标题、标签、导航、时间戳 |
| Body | Inter | 正文、描述、较长段落 |
双字体结构让等宽字体承担「机器读数」职责、Inter 承担「长文可读」职责。parser.rs 的 extract_typography 正是从 | Role | Family | 表中按关键词(display/heading、body/ui、data/mono)抽取 display/body/data 三档字体,供换肤映射与卡片展示使用。
4.2 字号标尺(Type Scale)
| Level | 尺寸 | 字体 | 字重 | 用途 |
|---|---|---|---|---|
| Display | 40px | Space Mono | 700 | Hero 指标值、主计数器 |
| Title 1 | 24px | Space Mono | 700 | 章节标题 |
| Title 2 | 18px | Space Mono | 600 | 卡片标题、小节标题 |
| Title 3 | 15px | Space Mono | 500 | 列表项标题、面板头 |
| Body | 14px | Inter | 400 | 描述、正文、段落 |
| Label | 12px | Space Mono | 500 | 字段标签、导航项、列头 |
| Caption | 11px | Space Mono | 400 | 时间戳、元数据、脚注 |
| Micro | 10px | Space Mono | 500 | 状态徽章、辅助数据(大写) |
| Tiny | 9px | Space Mono | 500 | 三级元数据、系统读数 |
4.3 字重(Font Weights)
| Weight | 值 | 用途 |
|---|---|---|
| Regular | 400 | 正文、描述、说明文字 |
| Medium | 500 | 标签、次级标题、导航 |
| Semibold | 600 | 卡片标题、小节标题 |
| Bold | 700 | Display 指标、章节标题 |
4.4 字距(Letter Spacing)
- Display 指标(40px):
-1px - 大写标签:
+2px到+3px(工业模板印花质感) - 等宽标题:
-0.5px - 正文:
0px
4.5 行高(Line Height)
- Display 指标(40px):
1.0 - 标题(18–24px):
1.15 - 正文(14px):
1.5 - 说明文字(10–11px):
1.4
五、间距系统
5.1 间距标尺(Gap Scale)
| 值 | 用途 |
|---|---|
| 0px | 侧边栏项(仅靠内边距分隔) |
| 4px | 行内图标+文字对、状态 LED 与标签之间 |
| 8px | 指标指示组、紧凑卡片区块 |
| 12px | 列表项之间、按钮组 |
| 16px | 卡片内部区块、导航项间距 |
| 20px | 面板区块、表单字段组 |
| 24px | 网格中卡片之间 |
| 32px | 主要内容区块 |
| 48px | 页面顶层区块 |
5.2 内边距标尺(Padding Scale)
| 值 | 用途 |
|---|---|
| [12, 16] | 侧边栏导航项 |
| [10, 16] | 标准按钮 |
| [8, 12] | 输入框、紧凑按钮 |
| 20px | 卡片内边距(紧凑面板) |
| 24px | 标准卡片内边距、内容内嵌 |
| [32, 40] | 内容区内边距 |
| [48, 40] | 宽松内容区内边距 |
5.3 布局模式(Layout Pattern)
- 屏幕宽度:
1440px - 侧边栏:
240px宽、纵向排列、space_between、图标+文字导航 - 内容区:
width: fill_container、height: fit_content、纵向、gap28–48、padding[32, 40] - 侧边栏指示器:活跃项左侧
3px电光绿边框
这套布局参数可直接对应到 OpenPencil 画布节点属性(如 fill_container、fit_content、gap、padding 均是 .pen 节点 DSL 中的既有概念),意味着 Agent 拿到指南后可以无歧义地落到具体节点数值。
六、圆角系统
| 值 | 用途 | 理由 |
|---|---|---|
| 0px | 侧边栏、分隔线、表格规则 | 机械精度,零公差 |
| 2px | 徽章、状态指示、微元素 | 几乎不可感知的柔和化 |
| 4px | 卡片、按钮、输入框、面板 | 最大圆角——依然工业感 |
设计理由:0–4px 区间强制工业、制造美学。锐角暗示冲压金属、CNC 铣削面板与工厂设备界面,近零圆角让每个元素都像「被制造出来」而非「被装饰出来」,视觉能量完全交给霓虹强调色。
在源码侧,parser.rs 的 extract_radius 从 ## Corner Radius 小节读取带 px 的数字,并按上下文关键词归类:card/standard/container 归卡片、button/input/small 归按钮。这意味着「4px 圆角」在风格切换时是一个可精确替换的标量(RadiusReplacement { from, to })。此外,内置设计系统预设(design_systems.rs)与 resolve_style 的圆角令牌(sharp/medium/large 三档 profile,见 resolve_style.rs 的 rounded_tokens)共同保证生成结果在圆角语义上自洽。
七、图标体系
7.1 图标字体
- Family:Lucide
- Style:Outline(描边),圆角连接与圆头端点——有机曲线与锐利的矩形容器形成对比
7.2 常用图标
activity、terminal、cpu、hard-drive、gauge、zap、power、settings、alert-triangle、check-circle、wifi、server、database、layers、monitor、refresh-cw、shield、lock、eye、bar-chart-2、trending-up、plus、x、chevron-right
这批图标清一色是系统监控/控制台语义(cpu、hard-drive、gauge、zap、server、database、bar-chart-2),与工业仪表盘主题严格对应。
7.3 图标尺寸
| 尺寸 | 用途 |
|---|---|
| 14px | 行内指示、表格行操作 |
| 18px | 侧边栏导航图标、列表项 |
| 20px | 卡片头图标、面板操作按钮 |
| 24px | 主导航图标、头部操作 |
7.4 图标颜色状态
| State | 颜色 | 用途 |
|---|---|---|
| Active | #39FF14 | 选中导航、活跃状态、状态开启 |
| Default | #808080 | 非活跃导航、次级操作 |
| Muted | #3A3A3A | 禁用图标、占位状态 |
| On Surface | #E8E8E8 | 抬升表面上的图标 |
注意图标状态色与文本色/边框色令牌共享同一色域:#39FF14(活跃)、#808080(次级)、#3A3A3A(弱化)、#E8E8E8(表面文字),这正是工业霓虹「一套颜色贯穿所有通道」的设计哲学。
八、在 AI 生成管线中的实际调用链
industrial-neon-dark 从文档到画布节点的完整链路如下:
-
注册与解析:
SKILLS内嵌语料中style-guides/子树由 loader.rs 的style_guide_registry()解析为ParsedStyleGuide(name/tags/platform/content),并缓存。普通技能注册表(loader.rs 的collect)会显式跳过style-guides/目录,避免风格指南被当成 phase 技能。 -
规划期选择:规划阶段技能 style-guide-selector.md 让 Agent 依据用户请求推断 3–5 个标签(如 "developer tool" →
developer+monospace,dark →dark-mode),按标签重叠度挑选最佳指南,并把styleGuideName写入计划输出。选择算法是select_style_guide(loader.rs):name 优先(可叠加 platform 约束),否则按「命中标签数 / 请求标签数」打分,平局保留语料中更早的条目。 -
生成期加载:设计 Agent 工具循环(design-agent.md)要求先
get_style_guide_tags列出全部可用风格标签,再get_style_guide(按标签或精确名)加载「具体设计令牌:颜色、字体、尺寸、间距、圆角、图标风格」,并捕获返回的name以便spawn_agents委派子屏时传递。MCP 侧实现见 style_guide_tools.rs:get_style_guide返回name/tags/platform/content(完整 Markdown),未命中时返回结构化 error 而不是工具崩溃。 -
令牌单一来源约束:design-agent.md 强调「Choose exactly ONE source of truth」——已有项目变量则复用;空画布且内置设计系统匹配则先
apply_design_system;无匹配内置时,保留所选风格指南的具体调色板/字体/圆角值,不安装无关预设、不追溯性替换已视觉确认的界面。 -
提示词组装与预算裁剪:风格指南内容作为技能注入系统提示词后,由
resolve_skills(resolve.rs)走「阶段过滤 → 意图匹配 → 内存注入 → 预算裁剪」四步;compose_system_prompt(compose.rs)把命中的技能按序拼接并受字符预算约束,超预算时从末尾整段丢弃以保住高优先级技能。
九、与其他指南的区隔:换肤与防串味
- 风格切换:
build_style_mapping生成的替换包可把整个既有界面从任一指南换到industrial-neon-dark——例如把旧背景换成#0C0C0C、旧强调色换成#39FF14、旧标题字体换成 Space Mono、旧圆角换成 4px。这是实现「Design-as-Code 中一键重设计」的底层机制。 - 防串味:加载器测试强制每份指南都必须包含
## Style Scope与「This guide is self-contained」,并禁止所有语料库指南出现胶囊导航措辞(loader.rs 的style_guides_do_not_revive_forced_pill_nav_templates)。工业霓虹的 0–4px 锐角正是与「soft-corners / rounded 风格家族」区隔的关键信号。 - 用户导入指南共存:
user_registry.rs允许运行时导入用户自己的DESIGN.md,并以user:<slug>前缀区分内置与用户指南;find_style_guide统一解析两类来源,get_style_guide则只面向内置语料(style_guide_tools.rs 中有明确说明)。
十、适用场景与使用建议
industrial-neon-dark 最适合以下诉求:
- 系统监控 / 控制台类 Web 应用:运维面板、资源监控、设备管理、CI/CD 状态页;
- 数据密集型指标界面:大量数值读数、状态 LED、实时计数器(Display 40px / Space Mono 700 的 Hero 指标是其招牌);
- 开发者工具与终端气质的桌面 Web 产品:等宽字体 + 锐角 + 霓虹强调的「机器感」;
- 「电光绿 + 近黑」高对比暗色品牌:需要强识别度、拒绝柔和圆润的界面。
实践提醒:生成时若已存在项目设计变量,应优先复用令牌而非硬编码十六进制;若确认走本指南,则从第一批节点起就统一使用 #0C0C0C/#121212/#161616 表面三档与 #39FF14 强调色,避免「背景套指南、强调色随意」的混搭;侧边栏活跃指示器务必使用 3px 电光绿左边框这一标志性元素。
综上,industrial-neon-dark 是一份「信息密度极高、可直接落图」的工业暗色风格规范:颜色、排版、间距、圆角、图标五大体系闭环自洽,同时在 OpenPencil 的 AI 技能引擎中具备结构化提取、标签匹配、对比度校验与风格切换的完整源码支撑。无论是直接把它作为目标风格生成界面,还是作为理解 OpenPencil 风格指南语料库工作方式的范本,这份文档都是值得深入研读的起点。