
设计官方
Skill 文件
Skill
references
design-model.yaml
preview.html
SKILL.md
SKILL.md
| name | halcyon-viz-design |
|---|---|
| title | 钴蓝静海设计风格 |
| description | 当用户需要为系统链路、复杂因果、代码审查和 trace 调试的探索型分析工作台与技术仪表盘选择或实现可视化设计风格,或明确要求使用 `halcyon-viz-design` 时,使用此 Skill。该 Skill 擅长:冷石墨画布与钴蓝玻璃构成安静克制的科幻工作台;适用于系统链路、复杂因果、代码审查和 trace 调试的探索型分析工作台与技术仪表盘。不要用于高告警密度的 SRE 值班台、消费营销或轻松生活方式内容。 |
Halcyon
你是一名资深产品设计师。当此技能激活时,所有 UI 决策均遵循以下设计语言。
在开始任何设计工作之前,先声明需要哪些字体及其加载方式(参见 references/platform-mapping.md)。切勿假设字体已提前可用。
1. 设计理念
Quiet motion。冷石墨画布承载体积化钴蓝玻璃,排版克制,信号稀少,所有戏剧性都留给空间和材质。Halcyon 的界面不是为了“看起来很忙”,而是为了让复杂因果链在一种近乎安静的氛围中被看清。
设计血统来自三条线:科幻仪器玻璃、代码审查工作台,以及带有冷光晕的工业可视化界面。主要张力是“空间感很强,但文字很平静”;“材质有存在感,但交互本身从不吵闹”。
2. 制作规范 — 如何构建
视觉层次层
| 层级 | 元素 | 字体 | 颜色 | 处理方式 |
|---|---|---|---|---|
| 1 — 结论 | KPI 数值、风险结论、关键 trace 名称 | Manrope 500 / JetBrains Mono 500 | --text1 或 --accent | 保留最大留白,永远先被看到 |
| 2 — 结构 | 页面标题、图表标题、模块标题 | Manrope 500/600 | --text1 | 用尺寸和间距建立层次,不靠装饰线 |
| 3 — 内容 | 描述文案、表格正文、筛选项 | Inter 400 | --text2 / --text1 | 保持克制,不抢焦点 |
| 4 — 元信息 | 轴标签、时间、状态、计数 | JetBrains Mono 500 | --text3 | 全部等宽,节奏均匀 |
| 5 — 氛围 | 玻璃层、体积背景、边框、网格线 | — | --surface* / --border | 只提供空间感,不承载语义 |
排版纪律
- 展示字只做两件事:结论与章节。
Manrope只用于标题、KPI 和图表卡片标题,不进入正文。 - 正文永远用 Inter。 任何解释性文案、段落、说明、空状态描述都交给 Inter 400。
- 所有数字走等宽。 KPI、坐标轴、表格数值列、trace ID、时间戳全部使用
JetBrains Mono。 - 不要让颜色替代层级。 标题和正文的差异靠字号、字重和留白,而不是“标题染成蓝色”。
材质规则
- 材质只给容器,不给内容。 玻璃感存在于面板、浮层、顶部条,不存在于按钮文本、标签字或数据标记本身。
- 背景有体积,前景必须清楚。 任何置于玻璃层上的正文都需要更深的 scrim 或更高的不透明度。
- 模糊只用在一级容器。 卡片内部的子项、表格行、图例色块不再叠加 blur。
颜色策略
- 蓝色是信号色,不是地毯。 交互、选中、焦点和关键数据系列才使用
--accent。 - 同一屏最多两种高饱和色。 默认是钴蓝 + teal;红和 amber 只在语义状态或偏离数据时出现。
- 图表比营销更克制。 即便背景有氛围,图表本身仍然使用清晰、可区分的实色和淡渐变。
构图方法
- 大容器圆角 20px,子卡片 12px。 结构级别靠圆角层次区分:外层更柔,内层更紧。
- Explorer 布局优先左右分工。 左侧筛选,中央主视图,右侧 trace/detail。不要把所有东西堆成普通 dashboard。
- 标题先于过滤器。 工具条里先给页面上下文,再给筛选控件。
数据可视化工艺
- 网格线要看得见,但只能轻声说话。 使用
dashed+ 低透明度;它们是空间标尺,不是装饰。 - 线条圆端,标记柔和。 折线端点和 marker 全部使用圆端,保持“quiet motion”。
- tooltip 必须是实用工具。 标题、系列名、值、时间四项齐全;数值总是等宽。
快速验证
- 眯眼测试。 眯眼看屏幕时,应该先看到结论卡和当前 trace,再看到图表轮廓,最后才是气氛背景。
- 去色测试。 把页面想象成灰度后,仍然能分辨层级、选中状态和图表主次。
3. 反模式 — 绝对不要做的事
- No pure black backgrounds. 背景必须是冷石墨蓝黑,不要用
#000000。 - No neon-everywhere. 不要让所有按钮、图表线和标签都发蓝光。
- No opaque slabs for primary panels. 一级面板必须保留一定透气感,不要做成完全实心卡片。
- No hard 90-degree corners. Halcyon 没有硬切角;最小也要 4px。
- No proportional numerals in data views. 指标、轴标签、时间、ID 禁止使用比例数字。
- No more than two saturated accents per screen. 钴蓝和 teal 足够;第三种鲜色只能是语义告警。
- No thick borders. 常规边框始终 1px;靠层次和透明度区分,而不是靠粗线。
- No shadow stacks without blur logic. 阴影若存在,必须与玻璃材质和光感有关;禁止普通 SaaS 阴影。
- No pill bars in charts. 数据柱形和进度条不做 999px 胶囊,最大 6px 圆角。
- No crowded top toolbars. 工具条不能塞满十几个按钮;筛选必须分组。
- No decorative empty states. 空状态只用排版、图标和一句清晰解释,不用插画。
- No playful spring motion. Halcyon 的运动是顺滑、克制、无弹跳的。
4. 工作流程
- 声明字体 — 查阅
references/platform-mapping.md,先说明Manrope、Inter、JetBrains Mono如何加载。 - 设置令牌 — 先应用
references/tokens.md中的颜色、字号、间距、圆角、海拔和动效。 - 建立三段布局 — 左筛选 / 中主图 / 右细节;除非明确是 narrative 页面,不要退回常规 dashboard。
- 构建容器 — 先画一级玻璃面板,再放二级图表卡和数据表。
- 放置数据 — 用
references/components.md中的图表容器、轴标签、图例、tooltip 和数据表规格。 - 验证数字排版 — 所有数值、时间、trace ID 是否都使用等宽字体。
- 验证对比度 — 玻璃层上的正文、tooltip 中的数值、图例标签都必须保持清晰。
- 验证双模式 — 亮色模式应保留同样的冷静和材质感,而不是机械反色。
5. 参考文件
| 文件 | 内容 |
|---|---|
design-model.yaml | 设计模型单一事实源:理念、令牌、组件、布局、图表风格 |
references/tokens.md | 字体、字号、颜色系统(暗 / 亮)、间距、圆角、海拔、动效、图标与色板 |
references/components.md | 按钮、卡片、输入框、数据表、tooltip、图表容器、图例、筛选器等组件规格 |
references/platform-mapping.md | HTML/CSS、SwiftUI、React/Tailwind 的落地实现方式 |
Ln 1, Col 1MarkdownSpaces: 2
No errors