OpenPencil 工业霓虹暗色风格指南:industrial-neon-dark 全解析与源码级实现原理

原创2026-10-11 14:17:571,607 阅读

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)。

提取结果驱动三处关键功能:

  1. 对比度自动校验: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 之类的高亮表面会自动配深色前景。
  2. 会话摘要色板:style_guide_summary(summary.rs)按 background → surface → accent → text_primary 顺序生成最多 4 个 swatch,用于编辑器聊天面板中展示「当前固定了哪个风格」;
  3. 风格切换映射:build_style_mapping(mapping.rs)把两个指南的结构化值差异转成 from → to 的填充色/文本色/描边色/字体族/圆角替换列表,供 replace_all_matching_properties MCP 工具一次性给现有设计换肤。若把工业霓虹换成另一指南,#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、纵向、gap 28–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 从文档到画布节点的完整链路如下:

  1. 注册与解析:SKILLS 内嵌语料中 style-guides/ 子树由 loader.rs 的 style_guide_registry() 解析为 ParsedStyleGuide(name/tags/platform/content),并缓存。普通技能注册表(loader.rs 的 collect)会显式跳过 style-guides/ 目录,避免风格指南被当成 phase 技能。

  2. 规划期选择:规划阶段技能 style-guide-selector.md 让 Agent 依据用户请求推断 3–5 个标签(如 "developer tool" → developer + monospace,dark → dark-mode),按标签重叠度挑选最佳指南,并把 styleGuideName 写入计划输出。选择算法是 select_style_guide(loader.rs):name 优先(可叠加 platform 约束),否则按「命中标签数 / 请求标签数」打分,平局保留语料中更早的条目。

  3. 生成期加载:设计 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 而不是工具崩溃。

  4. 令牌单一来源约束:design-agent.md 强调「Choose exactly ONE source of truth」——已有项目变量则复用;空画布且内置设计系统匹配则先 apply_design_system;无匹配内置时,保留所选风格指南的具体调色板/字体/圆角值,不安装无关预设、不追溯性替换已视觉确认的界面。

  5. 提示词组装与预算裁剪:风格指南内容作为技能注入系统提示词后,由 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 风格指南语料库工作方式的范本,这份文档都是值得深入研读的起点。

登录后查看全文
openpencil