typeui-fundamentals

设计基础原则 — Agent 指南

定义为什么模式有效、如何正确应用模式，以及哪些无障碍要求不可妥协的通用设计原则。这些原则历久弥新，不依赖特定设计系统，适用于所有界面，不受垂直领域或工作流阶段影响。

加载顺序

加载设计系统（SKILL.md / DESIGN.md + 令牌模块）之后，再阅读这些文件。设计系统告诉你要用什么令牌；这些文件则解释为什么这样选择是正确的，以及如何避免常见的原则性问题。

模块索引

文件	用途
ui-principles.md	通用视觉设计原则——层级、布局节奏、排版位置、色彩理论、深度与层叠、交互设计、响应式适配、组件行为
spacing-principles.md	间距相关原则——4 点网格、邻近分组、内外间距、垂直与水平节奏、标题→段落间距、区块与组件的间距层级
ux-principles.md	交互与控件原则——30 条 UX 定律、按钮/控件状态约定（9 种状态）、悬停/激活效果技巧、触控目标、认知负荷、反馈循环
typography-principles.md	排版相关原则——字体系统基础、比例与模块化比例、可读性与行宽、无障碍、响应式字体、通过字体表达品牌调性
accessibility.md	WCAG 2.1/2.2 合规要求——对比度、色彩作为信息的规则、焦点可见性、键盘导航、动态效果安全、目标尺寸、文本间距、语义结构、ARIA

这些文件不包含什么

这些文件不会定义：

• 工作流阶段（思考 → 构建 → 检查 → 发布）——参见 skills/vertical/SKILL.md
• 质量关卡或审计——参见 skills/vertical/inspect.md、review.md、preflight.md
• 反模式目录——参见 skills/vertical/anti-patterns.md
• 行业专属内容——参见 skills/vertical/team-social-saas.md
• 设计令牌或组件规范——参见 skills/design-system/SKILL.md

冲突解决

当来源之间存在分歧时：

1. 设计系统决定具体值（颜色、尺寸、间距令牌、组件规范）。
2. 基础原则（本层）决定结构性原则（层级、无障碍、动态效果逻辑）。
3. 垂直领域决定流程与内容架构（区块顺序、必需区块、行业调性）。

各个层级都必须满足无障碍要求——无障碍要求始终优先于审美偏好。

设计系统未作规定时，由这些原则决定

对于系统令牌或组件规则未涵盖的任何设计决策，都应遵循此处的原则。绝不违背设计系统——如果某项原则与设计系统规则冲突，以设计系统为准。请标记冲突并提交审核。