信息与动作规则

当任务涉及可见文案、动作层级、图标、点击反馈或视觉强调时读取；数据范围和空间布局由对应规则负责。

可见信息

每段文字和每个视觉元素必须至少完成一项职责：

标识当前对象；
区分相邻对象；
表达当前状态；
说明无法从结构推断的规则、限制或风险；
说明可执行动作；
反馈动作结果。

不承担这些职责就删除。

当对象、操作顺序、控件和反馈已经通过界面结构清楚表达时，不再用说明文案重复解释流程。添加帮助文字前，先检查能否通过更准确的标题、按钮文案、布局、默认值或状态反馈直接解决；不能用长说明掩盖结构和动作关系不清。

只有以下信息不能从当前界面可靠推断时才补充说明：

非共识的业务规则；
系统限制或数据作用范围；
容易造成真实损失的误操作风险；
危险或不可逆动作的具体后果。

必须删除：

重复页面标题、重复状态和重复入口；
重述按钮含义的段落；
解释显而易见布局的文字；
不影响下一步动作、作用范围或结果判断的状态复述，如 3 selected、20 items、Filter applied；
仅用于填空的说明、徽章和图标；
原始数据库 ID、内部枚举、存储路径和系统时间戳等实现信息，除非它们直接用于当前判断、搜索、复制或排障。

空状态只说明为空的原因，并提供一个恢复动作。同一创建或恢复意图不能同时出现在页面 Header 和空状态中。

即使实现信息确有用途，也只能作为辅助信息或按需复制项，不得取代用户能够识别的名称、图片和区分字段。

容器强调边

左侧或顶部的彩色强调边、色带和装饰性轨道属于强调边卡片（accent-border card）视觉语言，源自 callout、引用块和状态提示。它会主动争夺注意力，不应成为普通卡片、列表项或内容分组的默认装饰。

只有强调边持续表达可复用的状态、类别、选择或告警含义时才使用。
分类文字、图标或状态已经表达同一信息时，删除重复的强调边。
不为制造层次、填补空白或让相邻卡片“看起来不同”而给每项配置不同颜色的强调边。
普通集合优先使用对齐、留白、文字层级、轻量分隔线或背景差异建立结构。
项目确有符合本规范的稳定提示、引用、告警或选中模式时，由共享组件和按用途命名的组件变体统一维护；页面不得临时拼装彩色边线。

用户已有认知

常见的浏览、选择、编辑、保存、删除、返回和关闭任务使用用户已经理解的结构和动作含义。
同一对象、状态和动作在不同页面使用相同名称；不得用不同术语包装同一件事。
不改变共识图标和动作的惯常含义，也不为普通任务创造自定义手势或新操作模型。
只有标准模式无法表达真实任务时才新增交互模式，并明确显示它的对象、动作和结果。

动作层级

层级	用途	呈现
主操作	完成当前页面、弹窗或操作区域的主要任务	一个高强调文字按钮
次级操作	高频但非主要	低强调文字按钮
管理操作	重命名、重新处理、复制、可撤销删除	“更多”菜单
危险操作	永久删除或其他不可恢复、高损失操作	菜单分隔 + 确认
导航操作	返回、关闭、翻页	上下文明确时可用共识图标

同一页面、弹窗或操作区域出现两个高强调按钮时，重新判断主任务。批量工作台可以同时提供不同任务动作，但只能有一个与当前阶段直接相关的主导动作。

上下文操作与按需呈现

不是所有操作都需要始终平铺显示。根据当前对象和用户正在进行的任务，只显示此刻需要的操作：

主操作、关键状态和完成当前任务必须先发现的入口保持可见。
卡片、列表项或表格行中的次级操作，可以在 hover、聚焦或选中当前项后显示。
重命名、复制、重新处理等低频管理操作优先放入“更多”菜单，不在每一项中长期平铺。
操作出现前预留稳定位置，不挤压文字，也不让列表或卡片发生布局跳动。
触屏设备没有 hover 时，通过点击选中当前项，或使用始终可见的“更多”入口提供相同操作。
不隐藏用户必须先发现，才能理解当前状态或完成主要任务的操作。

按钮与图标

使用能够说明结果的“动作 + 对象”文案，避免只有“处理”“管理”“继续”等无法判断结果的词。
图标只有在能加快识别，并明确表达对象、动作、状态或结果时才使用；移除后不影响理解和扫描的图标应删除，不为标题、标签、菜单项或卡片机械配图标。
同一图标保持相同含义；图标与文字同时出现时表达同一件事。非共识图标必须显示文字，tooltip 不能代替标签；纯图标只用于上下文明确的共识动作。
AI 只是实现方式时，图标表达摘要、翻译、生成图片、转写、编辑等实际动作或结果，不额外叠加通用 AI 标记。
星星、闪光、机器人、脑形和魔法棒不作为生成、增强、助手等功能的默认图标；只有表达收藏、真实机器人或 Agent 对象等本来含义，或项目已有不违背本规范的稳定含义时才使用。
AI 身份本身影响用户判断时，优先显示明确名称、模型、Logo 或真实 Agent 身份，不用抽象的“AI 图标”代替对象。
Check 只表示选中、确认、保存或完成，不表示查看；Refresh 只表示刷新、重试或重新分析，对象不明确时显示文字。
状态不得做成看似可点击的按钮。

点击区域与鼠标反馈

所有可点击按钮、链接、卡片、表格行、菜单项、选择器选项、分页项和上传区域必须显示 cursor: pointer。
cursor: pointer 必须覆盖完整点击区域，不只覆盖图标或文字。
点击区域必须有可见 hover 反馈，例如背景、边框或文字颜色变化。
按下状态必须与 hover 有区别。
禁用控件不是可点击区域，使用禁用视觉和 cursor: not-allowed。
非交互卡片、标签、状态和装饰图标不得显示 pointer。
整张卡片可点击时，卡片根节点负责 pointer 和 hover；不要让用户猜只有哪一小块能点。
卡片或表格行内存在独立控件时，各控件保持自己的点击范围，不触发外层点击。

pointer、hover、active 和 disabled 样式由共享组件负责，使用组件的页面不得逐个补充。

“更多”菜单

菜单项显示文字。
点击外部关闭菜单。
删除与普通操作分隔。
当前状态不允许的操作直接隐藏；不要留下无法解释的灰色图标。
菜单触发器与菜单项都显示 cursor: pointer。

检查

删除某段文字后，用户是否仍能正确判断？
删除流程说明后，用户是否仍能通过对象、顺序、控件和反馈完成任务？如果不能，问题来自真实规则还是界面结构不清？
图标是否要求用户猜含义？
每个图标是否有明确职责，移除无意义图标后是否仍能正常理解和扫描？
AI 功能的图标是否表达真实动作或对象，还是只使用了星星、机器人、脑形等通用装饰？
所有可点击区域是否显示 pointer 和 hover？
pointer 是否误加到不可点击内容？
低频操作是否仍平铺在主界面？
次级操作是否只在相关对象进入 hover、聚焦或选中状态后出现？触屏设备是否有同等入口？
按需出现的操作是否造成文字位移或布局跳动？
是否展示了不能帮助识别、判断或操作的实现信息？
容器左侧或顶部的强调边是否表达稳定含义，还是只在重复标签或装饰页面？
常见任务是否要求用户重新学习术语或操作方式？

8.1 KiB Raw Blame History Unescape Escape