OpenPencil neon-purple-mobile-dark 风格指南:为 AI 生成移动端霓虹暗色界面定制的设计系统
OpenPencil neon-purple-mobile-dark 风格指南:为 AI 生成移动端霓虹暗色界面定制的设计系统
导读
neon-purple-mobile-dark 是 OpenPencil 的 AI 技能引擎(op-ai-skills)内置的 63 份风格指南之一,面向移动端(platform: mobile)的暗色霓虹界面——游戏、娱乐、夜生活类 App 的高强度视觉风格。本文以该指南全文为骨架,逐项拆解其色板、字体排印、间距、圆角与图标规范,并结合仓库源码说明这份 Markdown 如何被引擎解析、按名称或标签匹配、提取结构化 token,以及在风格切换时如何生成 from → to 属性替换映射。读完本文,你将能理解 OpenPencil 的"设计即代码"链路中风格指南从文档到生成立即生效的完整机制,并可直接把这份指南当作移动端霓虹暗色 UI 的落地规范使用。
指南的定位与使用边界(Style Scope)
该指南是**自包含(self-contained)**的:只有在精确选中本指南时,才应用它的色板、圆角比例、间距、阴影与组件处理方式,严禁借用 food、social、dashboard、luxury、terminal 等其他指南的模式混入本风格。指南还规定了一条关键结构纪律:
Treat unnamed layout frames as structural by default: no fill, stroke, cornerRadius, or shadow unless the node is intentionally a card, input, button, badge, media mask, navigation surface, or other visible component.
即未命名的布局帧默认视为纯结构元素——不加填充、描边、圆角或阴影,除非该节点本身就是卡片、输入框、按钮、徽标、媒体遮罩、导航表面等可见组件;同时避免为组件包裹装饰性外壳,层级关系应来自间距、字体排印与指南明确的表面(surface)体系。
这一点在仓库中有硬性测试约束:crates/op-ai-skills/src/style_guide/loader.rs 的测试 every_style_guide_declares_its_scope_boundary 断言每份风格指南都必须包含 ## Style Scope、This guide is self-contained 以及 Treat unnamed layout frames as structural by default 三段声明,防止跨指南的视觉泄漏与"布局帧被误装饰"。
风格总览(Style Summary)
这是一套高强度的暗色移动界面,为游戏、娱乐、夜生活类 App 设计。核心视觉逻辑是:极深的虚空背景 #0D001A 作为"宇宙画布",衬托电光紫 #A855F7 产生生动的霓虹辉光效果;Space Grotesk 以粗字重呈现几何自信的展示型标题,Inter 保证暗色低对比环境下的正文最大可读性;渐变表面与辉光效果增加纵深与能量;12–20px 的圆角区间在"现代锐利感"与"舒适的触控目标"之间取得平衡。
关键美学点:
- Deep void canvas:
#0D001A背景营造带紫色底调的沉浸式暗色空间 - Electric purple neon:
#A855F7作为签名强调色,配合辉光效果呈现夜店般的生动氛围 - Geometric display type:Space Grotesk 粗字重标题,传递自信、都市化的视觉气质
- Glow depth:紫色调阴影与半透明表面叠加出多层视觉纵深
- Gradient cards:特色内容使用深紫渐变卡片获得视觉能量
- Integrated bottom nav:全宽底部导航 + 紫色激活辉光
从源码结构看,该摘要段(## Style Summary)还被引擎复用为悬停卡片的"一句话简介":crates/op-ai-skills/src/style_guide/card.rs 中的 description() 会优先从名为 Summary/Overview 的 ## 小节里取第一个自然段落(跳过表格、列表与代码块),因此这份指南的摘要会被直接呈现在编辑器的风格悬停卡上。
色板系统(Color System)
核心背景(Core Backgrounds)
| Token | 值 | 用途 |
|---|---|---|
| Page Background | #0D001A | 根屏幕背景(deep void) |
| Card Surface | #1A0D2E | 标准卡片、列表项 |
| Elevated Surface | #221340 | 悬浮卡片、模态底部弹层 |
| Gradient Start | #1A0D2E | 渐变卡片暗色端 |
| Gradient End | #2D1B4E | 渐变卡片亮色端 |
| Tab Bar Surface | #1A0D2E | 一体化底部导航表面 |
文本颜色(Text Colors)
| Token | 值 | 用途 |
|---|---|---|
| Primary Text | #FFFFFF | 标题、指标数值、主标签 |
| Secondary Text | #B8A0D4 | 正文、描述 |
| Tertiary Text | #7A5FA0 | 时间戳、说明文字、非激活标签 |
| Muted Text | #3D2660 | 占位符、禁用文本 |
| Accent Text | #A855F7 | 激活态、高亮数值、链接 |
边框颜色(Border Colors)
| Token | 值 | 用途 |
|---|---|---|
| Default Border | #2D1B4E | 卡片边框、分隔线 |
| Subtle Border | #221340 | 轻量分隔线 |
| Active Border | #A855F7 | 聚焦输入框、激活标签指示 |
| Glow Border | #A855F740 | 激活元素上的柔和紫色辉光 |
强调色(Accent Colors)
| Token | 值 | 用途 |
|---|---|---|
| Primary Accent | #A855F7 | 激活态、按钮、高亮、标签指示器 |
| Accent Glow | #A855F766 | 辉光效果、状态点光晕(40% 不透明度) |
| Accent Muted | #A855F720 | 着色背景、徽标填充 |
| Accent On-Dark | #FFFFFF | 紫色背景上的文本/图标 |
| Success | #22C55E | 胜利状态、正向指标 |
| Warning | #F59E0B | 连续打卡警告、待处理状态 |
| Error | #EF4444 | 失败状态、破坏性操作 |
| Neon Cyan | #06B6D4 | 次级霓虹强调色、备选高亮 |
注意表格中带 8 位十六进制的颜色(如 #A855F740、#A855F766、#A855F720)是带 Alpha 通道的紫色变体,用于光晕、半透明着色等场景;而引擎的结构化提取器只认 6 位色值——crates/op-ai-skills/src/style_guide/parser.rs 的 first_hex() 明确规定第 7 个十六进制数字会使该行判定失败(#A855F740 有 8 位,会被跳过,而 #A855F7 可被提取),这与 TS 原版的正则词边界行为保持了一致。
色板如何被引擎提取与复用
op-ai-skills 的解析器(crates/op-ai-skills/src/style_guide/parser.rs)会把本指南的 ## Color System 段落按小写标题切分,再按角色标签匹配提取 7 个颜色通道:background(匹配 page background 或 root … background)、surface(card surface / surface)、accent(primary accent)、text_primary / text_secondary / text_muted(primary text 等)、border(default border)。提取结果被用于三处:
- 摘要芯片与悬停卡片:
crates/op-ai-skills/src/style_guide/summary.rs与card.rs会把背景、表面、强调色、主文本色等按角色顺序渲染为色卡,帮助用户在编辑器里确认"当前生效的风格是不是我想要的那个"; - 风格切换映射:
crates/op-ai-skills/src/style_guide/mapping.rs的build_style_mapping将两套指南的结构化值两两对比,生成fill_color/text_color/stroke_color/font_family/corner_radius五类from → to替换对,供replace_all_matching_properties类工具对已有设计进行整体换肤; - 对比度审计:
crates/op-ai-skills/src/color/contrast.rs用 WCAG 相对亮度公式计算前景/背景对比比(目标 4.5:1),resolve_style.rs的测试resolve_our_catalog_zero_aa_violations会遍历全部风格与全部 7 个内置色板(Alloy Blue、Harbor Teal、Fern Signal、Ember Coral、Iris Steel、Amber Field、Rose Circuit),断言零 AA 违规——本指南深紫背景上的白色文本正是这类自动审计要守护的可读性底线。
字体排印(Typography)
字体家族(Font Families)
| 角色 | 家族 | 用途 |
|---|---|---|
| Display | Space Grotesk | Hero 指标、章节标题、显著标题 |
| Body / Functional | Inter | 正文、标签、按钮、导航、描述 |
解析器(extract_typography)会从 ### Font Families 表格中按角色关键词识别展示字体与正文字体:display/logo/heading/serif 命中 Display 角色、body/functional/ui 命中 Body 角色,若关键词未命中则按行序回退(第一行作展示字体、第二行作正文字体)。本指南的 Display 行首行即 Space Grotesk,会被稳定地识别为 headings 字体。
字号刻度(Type Scale)
| 层级 | 字号 | 字体 | 字重 | 用途 |
|---|---|---|---|---|
| Hero | 48px | Space Grotesk | 700 | Hero 分数、主要数据 |
| Display | 34px | Space Grotesk | 700 | 大号指标数值 |
| Title 1 | 24px | Space Grotesk | 700 | 章节标题 |
| Title 2 | 18px | Space Grotesk | 600 | 卡片标题、列表标题 |
| Title 3 | 15px | Inter | 600 | 小节标题、列表项标题 |
| Body | 14px | Inter | 400 | 描述、正文 |
| Label | 13px | Inter | 500 | 字段标签、按钮文字 |
| Caption | 12px | Inter | 400 | 时间戳、元数据 |
| Small | 11px | Inter | 500 | 徽标、辅助标签 |
| Micro | 10px | Inter | 600 | 标签栏文字(大写)、微型徽标 |
字重(Font Weights)
| 字重 | 值 | 用途 |
|---|---|---|
| Regular | 400 | 正文、描述 |
| Medium | 500 | 标签、导航、按钮文字 |
| Semibold | 600 | 卡片标题、小节标题 |
| Bold | 700 | 章节标题、hero 指标、display |
字距(Letter Spacing)
- Hero/Display(34–48px):-1.5px(强烈的字距压缩)
- 章节标题(18–24px):-0.5px
- 大写标签栏文字:+1.5px
- 正文:0px
行高(Line Height)
- Hero(48px):0.9
- Display(34px):1.0
- 标题(18–24px):1.2
- 正文(14px):1.5
- 说明文字(11–12px):1.4
字体规范与移动端正文可读性是配套约束:Inter 400/14px 正文搭配 1.5 行高、0 字距,正是暗色低对比场景下最大化可读性的组合;而 -1.5px 的 Hero 压缩字距则服务于"geometric confidence"的展示型气质。
间距系统(Spacing System)
间距刻度(Gap Scale)
| 值 | 用途 |
|---|---|
| 2px | 紧凑的行内配对 |
| 4px | 标签栏图标到文字、行内图标组 |
| 6px | 状态指示器组 |
| 8px | 紧凑卡片内容、游戏条目 |
| 12px | 列表项之间、按钮组 |
| 16px | 卡片内部区块 |
| 20px | 卡片之间、大卡片区块 |
| 24px | 内容区内章节间距 |
| 32px | 屏幕级顶层章节分隔 |
内边距刻度(Padding Scale)
| 值 | 用途 |
|---|---|
| [0, 24] | 屏幕内容外层包裹(仅水平方向) |
| [12, 21, 21, 21] | 标签栏区块外内边距 |
| 4px | 一体化标签栏内内边距 |
| [8, 16] | 输入框、紧凑按钮 |
| [10, 20] | 标准按钮 |
| [12, 24] | 大按钮、CTA 按钮 |
| 16px | 紧凑卡片内边距 |
| 20px | 标准卡片内边距 |
| 24px | 特色卡片、渐变卡片内边距 |
布局模式(Layout Pattern)
- 屏幕宽度:402px(移动端)
- 内容包裹:padding [0, 24]、纵向、gap 24–32
- 状态栏:62px,标准 iOS
- 一体化标签栏:高 62–72px、cornerRadius 0–12、padding 0–4、页面流内全宽
- 标签项:fill_container、纵向、gap 4、居中对齐
- 特色卡片:渐变背景(#1A0D2E → #2D1B4E)+ 紫色辉光边框
移动端构图护栏(Mobile Composition Guardrails)
- 顶部节奏保持紧凑:状态栏、头部与首个内容块应连贯,除非设计刻意以图片为主导,否则避免 80px+ 的空白带;
- 搜索保持干净单行:中性输入框 + 可选筛选按钮;不要给输入框再套一层着色圆角外壳,分组帧应保持结构透明;
- 横向轨道与轮播视口帧保持透明:不加白色圆角衬底、不加额外阴影;只有单张卡片、图片或刻意的推广面板才获得填充、圆角或高度;
- 图片卡片上的收藏/点赞/书签/爱心操作:应为纯图标覆盖层或极轻的半透明点击区,不要围绕爱心加白色圆形气泡、边框或阴影;
- 底部导航融入屏幕流:用安静的分隔线或激活指示器;除非用户明确要求浮动导航模式,否则避免悬浮胶囊导航;
- 9999px 圆角仅用于真正的圆形或微型胶囊(头像、状态点、短徽标),绝不可用于页面区块、搜索外壳、轮播、卡片操作按钮或完整导航栏。
这条护栏与移动端领域技能的约束一脉相承:crates/op-ai-skills/src/loader.rs 中的 mobile_style_guides_do_not_force_pill_nav_template 与 style_guides_do_not_revive_forced_pill_nav_templates 两则测试会扫描全部移动端指南,断言它们不含 Pill tab bar、bottom navigation pill、cornerRadius 100、100px 等旧模板用语——本指南的"一体化底部导航"正是这一"反悬浮胶囊"纪律的落地。
圆角体系(Corner Radius)
| 值 | 用途 | 设计理由 |
|---|---|---|
| 8px | 小按钮、紧凑徽标、输入框 | 克制的现代锐利感 |
| 12px | 标准卡片、列表项、游戏条目 | 主要容器圆角 |
| 16px | 特色卡片、排行榜区块 | 舒适的交互圆角 |
| 20px | Hero 卡片、模态底部弹层、大容器 | 标准圆角上限 |
| 9999px | 仅限头像、状态点、短徽标 | 语义化微元素的真圆/胶囊;绝不用于导航、搜索、轮播或卡片操作按钮 |
设计理由:8–20px 区间在"现代几何锐利感"与"舒适的移动端触控目标"之间取得平衡。较小的圆角(8–12px)让界面保持技术感与游戏气质;较大圆角(16–20px)用于特色内容,在需要注意力停留之处增加视觉柔和度。次级元素的锐利与特色元素的柔和形成对比,通过几何形状本身建立视觉层级。
引擎会从 ## Corner Radius 小节中提取 card 与 button 两个标量:行文本含 card/standard/container 等词取卡片圆角,含 button/input/small 等词取按钮圆角(crates/op-ai-skills/src/style_guide/parser.rs 的 extract_radius)。本指南的"标准卡片 12px、小按钮 8px"即分别落入这两个通道,风格切换时会被映射为对应的 corner_radius 替换。
图标规范(Icons)
图标字体
- 家族:Lucide
- 风格:描边(Outline)、圆角连接与端点(rounded joins and caps)
常用图标
gamepad-2, trophy, crown, star, zap, flame, sword, shield, target, users, message-circle, volume-2, play, pause, skip-forward, heart, thumbs-up, gift, gem, rocket, bell, search, settings, plus, x, chevron-right
这份清单与"游戏/娱乐/夜生活"主题高度对应:trophy、crown、flame、sword、shield、gamepad-2 服务于竞技与游戏场景,play/pause/skip-forward/volume-2 服务于媒体播放,heart/thumbs-up/gift/gem 服务于互动与打赏类社交动作。
图标尺寸
| 尺寸 | 用途 |
|---|---|
| 14px | 行内指标、徽标指示器 |
| 18px | 标签栏图标、列表前置图标 |
| 20px | 卡片操作图标、游戏图标 |
| 24px | 头部操作、通知铃铛、显著按钮 |
图标颜色状态
| 状态 | 颜色 | 用途 |
|---|---|---|
| Active | #A855F7 | 选中标签、激活状态、紫色高亮 |
| Default | #B8A0D4 | 未激活标签、次级操作 |
| Muted | #3D2660 | 禁用状态、占位图标 |
| On Accent | #FFFFFF | 紫色背景上的图标 |
指南在 OpenPencil 引擎中的生命周期
编译期嵌入,零运行时 IO
crates/op-ai-skills/src/lib.rs 通过 include_dir!("$CARGO_MANIFEST_DIR/skills") 将整个 skills/ 语料库(含 style-guides/ 子树、domain/knowledge/phases 等约 90+ 份 Markdown)在编译期嵌入二进制,引擎自包含、无运行时文件 IO,可在 wasm32 目标上使用。crates/op-ai-skills/src/loader.rs 的测试断言语料规模 ≥ 91 份 Markdown;crates/op-ai-skills/src/style_guide/audit_tests.rs 的 registry_is_local_and_returns_at_least_fifty_guides 则验证风格指南注册表 ≥ 50 份且调用同步完成(无网络往返)。
Frontmatter 解析与注册
neon-purple-mobile-dark.md 的文件头是:
---
name: 'neon-purple-mobile-dark'
tags: [neon, dark-mode, vibrant, electric, purple, bold-typography, mobile]
platform: mobile
---
crates/op-ai-skills/src/style_guide/loader.rs 的 parse_style_guide_file 仅提取这三个字段:name(精确匹配键)、tags(受控词表)、platform(mobile → Platform::Mobile)。其中 platform: mobile 是一个硬过滤条件——crates/op-ai-skills/src/style_guide/types.rs 定义了 webapp / mobile / landing-page / slides / card 五种平台,未识别的值回退到 webapp。这意味着本指南只会响应移动端画布的风格请求,不会串扰到 webapp 或 landing-page 场景。
按名称或标签匹配的选择机制
select_style_guide(crates/op-ai-skills/src/style_guide/loader.rs)的匹配规则:
- 名称优先:若请求带
name,则精确匹配(可叠加 platform 约束)——这是子代理可复现性契约:audit_tests.rs的exact_name_lookup_returns_the_correct_guide断言每个注册指南都能被自己的名字精确找回,这正是spawn_agents.styleguideName依赖的稳定性保证; - 标签评分:无名称时,按 Jaccard 式命中率(请求标签在指南标签中的占比)在平台过滤后的候选中取最高分者;平分时保留注册表中靠前者(TS 等价行为)。
本指南的 7 个标签 neon, dark-mode, vibrant, electric, purple, bold-typography, mobile 全部位于 STYLE_GUIDE_TAGS 受控词表内(crates/op-ai-skills/src/style_guide/types.rs),当用户的移动端请求携带 neon、dark-mode、electric、vibrant 等意图词时,它就能在风格竞选中胜出。
注入生成提示的方式
被选中的指南全文(content,逐字节保留的原始 Markdown)会原样注入生成提示:crates/op-ai-skills/src/style_guide/types.rs 的 ParsedStyleGuide.content 即"frontmatter + 全文"。在 lib.rs 的 design_agent_system_prompt 中,工具循环会调用 get_style_guide 按需拉取风格指南;若请求仅携带标签而无精确名称,则回退到 select_style_guide 的标签评分。风格指南与领域技能(如 mobile-app 的三段式架构)共同决定了 AI 生成画布的视觉语言。
与用户导入指南的统一查找
crates/op-ai-skills/src/style_guide/user_registry.rs 允许用户运行时导入自定义 DESIGN.md,并以 user:<slug> 前缀与内置语料区分。查找统一走 find_style_guide:user: 前缀优先匹配导入集;否则先查内置语料(其名称是规划提示给模型的词汇表),再按显示名大小写不敏感地匹配导入指南。这意味着 neon-purple-mobile-dark 这类内置指南与用户自建的移动端霓虹风格可以并存、同构参与 pinning(风格固定)与子代理注入。
快速落地要点
把本指南作为移动端霓虹暗色界面的实现清单时,请按此顺序执行:
- 背景:整页使用
#0D001A,卡片用#1A0D2E,需要层级再提升时用#221340; - 强调:按钮、激活标签、高亮数值统一使用
#A855F7;辉光用#A855F740边框或#A855F766光晕,禁用态用#3D2660; - 文字:标题/数值
#FFFFFF,正文#B8A0D4,时间戳/说明#7A5FA0,占位#3D2660; - 字体:标题系用 Space Grotesk(700),正文/控件用 Inter;Hero 48px/-1.5px/0.9,正文 14px/0px/1.5;
- 圆角:卡片 12px、按钮/输入 8px、特色卡 16–20px;9999px 只给头像与状态点;
- 导航:底部导航做全宽一体化(62–72px 高、圆角 0–12、页面流内),激活项用紫色,不要悬浮胶囊;
- 结构纪律:布局帧保持透明无装饰,层级靠间距与明确表面表达,图片卡上的爱心等动作为纯图标覆盖层。
以上每一步都有引擎侧的结构化提取与审计测试兜底,保证指南所述与最终生成结果一致。
延伸阅读
- 风格指南原始文档:crates/op-ai-skills/skills/style-guides/neon-purple-mobile-dark.md
- 风格指南注册表与选择逻辑:crates/op-ai-skills/src/style_guide/loader.rs
- 结构化值提取(颜色/字体/圆角):crates/op-ai-skills/src/style_guide/parser.rs
- 风格切换 from→to 映射:crates/op-ai-skills/src/style_guide/mapping.rs
- 对比度审计(WCAG):crates/op-ai-skills/src/color/contrast.rs
- 语料库嵌入入口:crates/op-ai-skills/src/lib.rs