tenzir-design-system

Tenzir 设计系统

Tenzir 设计系统的权威来源：机器可读的令牌、设计原则和品牌资源。该技能定义值和设计决策；如何在任何特定工具中实现这些内容不在其范围内。

**YAML 数据文件是所有值的权威来源；Markdown 记录设计决策：**如何选择和应用令牌。当代码片段与 YAML 不一致时，以 YAML 为准。

数据文件

• data/brand.yml：调色板、语义角色（primary/success/warning/…）、图表颜色、排版和徽标。遵循 Quarto 的 brand.yml 架构，因此 Quarto/Shiny 可以直接使用。
• data/tokens.yml：该架构之外的所有内容，位于 tenzir: 键下：间距、圆角、字号比例、阴影、不透明度和色调、动效、z-index、断点以及深色模式映射。
• source.md：范围和非目标。

问题路由

问题	加载
某个令牌的十六进制值/数值是多少？	data/brand.yml, data/tokens.yml
应该使用哪种颜色/字体/字号？	references/colors.md, references/typography.md
间距、圆角、断点、z-index？	references/layout.md
阴影、叠加层、表面堆叠？	references/elevation.md
动画时长和缓动？	references/motion.md
使用哪套图标及样式？	references/iconography.md
品牌效果（渐变边框、渐变文字、强调标记、正文）？	references/branded-effects.md
不容妥协的设计规则有哪些？	references/invariants.md
范围和非目标？	source.md

仅加载当前任务所需的文件。优先使用设计令牌和现有组件模式，而非定制样式。

组件

Tenzir 没有组件规范。该系统提供不变量（令牌、平面表面、层级、渐变、图标），而非组件结构。使用项目的组件库构建组件，并遵循不变量。

约定

• 该技能与工具无关：它负责值（data/）和设计决策（references/ 中的原则文档以及不变量）。如何在特定工具中实现这些内容不在其范围内。
• 浅色和深色都是严格的一等模式，共用一套调色板并重新映射语义角色；尽量减少背景噪声。

资源

官方徽标位于 assets/logos/。变体名称描述图稿颜色；深色图稿应放在浅色背景上：

• logo-dark.svg, logomark-dark.svg：用于浅色背景
• logo-light.svg, logomark-light.svg：用于深色背景

Logomark 是仅含图标的标志；完整徽标已出现或空间紧张时，可使用它。