跳到正文
定位、使用者与职责边界
定位、使用者与职责边界
搜索 YUDS 文档

YUDS 文档

术语表

汇总 YUDS 各章固定使用的术语、状态词、规则 ID 前缀与缩写,供阅读专题前查阅。

状态:本页汇总各章已使用的术语,供阅读入口;术语的规范含义以所链接的专题页为准,本页不新增规则。

词条按主题分组,只写各章已经使用的含义和必须随之保留的限定;完整规则、例外和夹具见「见」列的专题页。同一个字母或缩写在不同章节可能代表不同对象(例如 D 既是设计决定编号,也是查询草稿或值帮助临时值),以所在章节为准。

阅读与状态

体系与文档

术语 含义 见
YUDS Yiplex Unified Design System,Yiplex 正在建设的统一设计系统,为产品、设计与开发团队提供共同的设计语言、交互规则和可复用资源,重点服务数据密集、业务关系复杂的企业工作。当前资源与能力仍在建设和验证中。 定位、使用者与职责边界
三方职责 已确认:YUDS 规定共同设计语言、组件行为、业务交互模式及可用性与无障碍验收要求;具体实现项目把规范实现为组件代码并维护对应关系;产品负责业务模型、计算规则与流程配置。不指定承载项目、框架或平台。 定位、使用者与职责边界
四层内容 基础规则(Foundation)、组件(Component)、任务模式(Pattern)、页面模板(Page template)。这是职责划分,不要求建立四套重复目录。 定位、使用者与职责边界
十二章 定位与职责、设计原则、信息架构、视觉与语义基础、基础组件、复杂数据、数据表达、表单与流程、系统状态与权限、页面模板、跨平台与智能交互、治理交付与质量。十二章是知识结构,不是必须逐章通读的门槛;章节篇数不是完备度指标。 体系大纲与阅读路线
六条设计原则 共同语义、清晰、数据可信、恢复、效率、可访问六个方向已确认;前两条完整文案已确认,第三至第六条细则可调整。原则原文以原则页为准。 六条设计原则
主档 某项规则、数值或组件的唯一权威所在。现行规范主档是日常使用入口;跨章只链接,不复制会分叉的规则。同一个完整 ID 只能有一个规范定义主档,其他位置出现同一 ID 是引用。附件与主档冲突时先查时间、适用范围和决定记录,无法消解的冲突登记为阻断,不自行改语义。 YUDS 统一设计系统、规范、设计与实现映射
唯一主节 组件或规则在主档内的同名连续章节,承载完整契约;各篇末尾索引只负责导航。选组件时进入唯一主节确认用途、不适用场景、变体与状态,不按截图选型。 YUDS 统一设计系统、基础组件与交互契约
主档登记 组件与规则主档登记按稳定 ID 定位唯一主节,设计基线主档登记按决定定位现行基础;登记只用于定位与核对摘要,不产生新规则。历史研究、冻结稿和审计回执只用于追溯,不作现行值表。 YUDS 统一设计系统
四端目录 分析范围与设计任务导航,不是组件发布清单。 YUDS 统一设计系统
A48/B22/C11 分析范围标签的数量,不是组件总量。 体系大纲与阅读路线
41 项组件目录 原始基线的 41 个命名组件(CMP-01—CMP-41),变体不重复计数;它界定已整理范围,不是完整度上限,也不表示已与 SAP 齐全。 基础组件与交互契约

阅读标记

术语 含义 见
阅读标记(覆盖级别) 契约、有界子集、分类边界三种阅读范围标签,只说明文档覆盖范围;不另建实现成熟度体系,不改变条款原有的确认状态,也不代表运行成熟度。 YUDS 统一设计系统、基础组件与交互契约
契约(contract) 能在所述范围内查到用途、行为、状态、边界与验收预期;组件阅读模板中所有适用问题须有明确答案或唯一引用。不表示实现可用、视觉通过或支持所有平台。泛指时,契约是必须共同遵守的输入、状态、行为和结果边界,不是指定实现 API。 YUDS 统一设计系统、规范、设计与实现映射
有界子集(subset) 只使用逐项列明的能力,必须列出覆盖与排除项;未覆盖项保持显式缺口。不把同名族、目录入口或部分夹具当成完整能力。 YUDS 统一设计系统、基础组件与交互契约
分类边界(boundary) 说明该类能力归哪里、与已有规则怎样衔接,只供分类和后续讨论。不能作为实现合同,不用于承诺具体行为、API 或生产采用。 YUDS 统一设计系统、基础组件与交互契约

决定与证据状态

术语 含义 见
已确认 限于决策记录有明确来源的方向或全文(用户确认)。方向已确认不等于所有数值与实现细则都已确认;已确认方向与实现验证通过分别记录。 定位、使用者与职责边界、决策与讨论记录
已确认原文 用户确认后按原文入库的文字,如系统定义、三方职责、原则与导航原文;原样保存,不改写措辞。 定位、使用者与职责边界、六条设计原则
默认采用(可修订) 按“先写入、再展示、按反馈修订”流程写入的细则:用户未要求调整即默认通过,但不记为用户逐项明确确认。 决策与讨论记录
已采用/代理依据用户授权采用 代理依据用户授权作出的普通可逆设计决定(如 D01—D08),逐项记录理由、撤回条件与验证状态;不冒称用户逐项亲自确认,也不使任何尚未记录的值或 API 自动生效。 定位、使用者与职责边界、决策与讨论记录
已采用为初始设计输入 D01-R2 与 D02—D08 的现行状态:作为设计起点使用,不代表组件包已发布、设计已验收或四端已达标。 YUDS 统一设计系统
拟议 决策状态之一:已提出、供讨论或评审,尚未批准;不把拟议默认写成已采用。 决策与讨论记录、贡献、决定、版本与迁移
建议(可调整) 未获确认、也未采用的细则;多数专题页以“本轮建议,可调整”标注。 定位、使用者与职责边界、体系大纲与阅读路线
候选 需要产品、设计和实现验证后才能确定的取舍;没有数据支持时不写成量化承诺。 定位、使用者与职责边界
限定候选/有界候选 只覆盖明确子范围的候选契约,如日历排程、只读依赖时间线、地点选择、只读关系探索四族,以及 B、C 类组合与 PAT- 模式;不代表完整族能力、整族全变体、SAP 等价或运行通过。 YUDS 统一设计系统、日历、日程提案与只读依赖时间线、地点选择与只读关系探索
待验证 决策状态之一:尚需证据核实的事项,例如品牌值、实际尺寸、平台 API、设计资产、实现与辅助技术测试。 决策与讨论记录
待确认 尚待责任方确定的事项,如完整 API 和实现;用于请求或逐项结果时指“结果待确认”,见本页「系统状态与权限」。 基础组件与交互契约、异步执行、结果核查与恢复
被替代 决策状态之一:已由后来的决定取代,正式改变时注明替代关系、日期与影响范围,旧内容只作历史追溯(如三层公共颜色 Token 候选被两维契约替代)。被删除规则的 ID 保留替代关系,不分配给新含义。 决策与讨论记录、Token 契约、主题与状态
未执行 测试结论之一:尚未运行、环境缺失、被阻断或无法确认结果,须记录原因。当前各章的文档夹具与真实运行验收均为未执行。 质量基线、门禁与验收证据
未验证 缺少实际版本、环境与结果证据时的标记,如“实现能力:draft/未验证”。没有足够证据时保留“未验证/未执行”,不以篇数、目录数或历史评分代替质量。 YUDS 统一设计系统、贡献、决定、版本与迁移
应/不得/可 “应/不得”表达规则在其采用范围内的行为要求,须同时读取决定状态,不能仅凭措辞把候选规则或设计输入称为已发布的实现标准;“可”表示按任务决定的可选能力。 定位、使用者与职责边界

信息架构与工作空间

术语 含义 见
业务对象/用户任务/业务流程 对象提供稳定的工作身份(处理什么),任务表达当前目标(做什么),流程表达业务推进关系(如何推进);三者可以关联,但不能相互替代。导航以业务对象与用户任务为基本方向,并支持按业务流程操作(均已确认)。 对象、任务与流程的衔接、信息架构与工作空间
实际业务阶段/正在查看的步骤/当前可执行任务 实际阶段由产品业务状态与服务端确认结果决定;查看步骤只是用户此刻打开的内容;可执行任务是当前身份有权执行且满足业务条件的工作。步骤被访问过不等于业务已完成。 对象、任务与流程的衔接
全局导航/对象内部导航 已确认:全局导航定位要进入哪类工作,对象内部导航组织当前对象的内容分区;切换同一对象的分区与切换到另一对象要清楚区分。不限定导航只有两级,也不预定侧栏或顶栏。 信息架构与工作空间
深链接 定位对象、任务、版本/快照或视图的链接;打开时重新核查身份、访问范围与当前状态。链接是定位信息,不是授权凭证,不承载敏感输入或访问令牌。 导航、深链接与上下文保留
返回、向上、关闭、取消、撤销 返回沿平台实际返回栈离开;向上到业务父级;关闭结束当前呈现,不自动取消已发任务或放弃未保存内容;取消编辑只放弃未提交的更改;取消执行是向执行协议提出的请求;撤销是业务明确支持的补偿动作。一个离开事件只提交一次位置变化。 导航、深链接与上下文保留
工作空间 围绕工作组织的交互上下文,由身份与范围区、定位区、主工作区、辅助区、操作与结果区等区域组成;不等同于某个固定布局组件,也不据此断言它等于租户、组织、项目或资产。 信息架构与工作空间
权限范围(稳定范围) 已确认:每个工作空间声明明确且稳定的数据权限范围,不随页面、对象或分区切换隐式扩大;范围可以是单一组织,也可以是明确定义且获准共同访问的数据组。稳定不等于冻结权限,访问与操作始终受当前授权约束。 信息架构与工作空间
跨范围能力 跨范围查看、搜索、比较、汇总等须单独定义并独立授权;能查看多个范围不自动获得跨范围写入权。导航、菜单、共享链接和已保存视图都不授予跨范围权力。各项能力是否提供仍由产品决定。 信息架构与工作空间
租户与安全范围 租户在本文指系统隔离域;物业中的租户/承租人是业务对象,二者不能因同名混用。工作空间是否等于租户或某个组织层级由产品决定,当前未定。 信息架构与工作空间
S1 D08 采用的初始合成范围:初始合成任务只在单一可见范围 S1 中运行,跨范围默认无能力;切换范围时旧读取不进入新视图,旧写回执不转到新范围。 信息架构与工作空间、端到端任务旅程与验收案例
页面模板 为一类任务组合区域和组件的页面骨架;不是任意视觉容器,也不把领域逻辑固化进通用模板。 页面与端到端模板
布局 页面区域如何排列;不规定一次完整任务。 页面与端到端模板
任务链(任务旅程) 用户从进入到结果及返回的跨页面路径;端到端验收按完整旅程进行,并包含权限、并发、失败及可访问场景。 端到端任务旅程与验收案例

视觉基础

术语 含义 见
Token(设计变量) 可追溯设计决定的表达方式;不承担权限、业务状态机、格式化规则或布局算法。 Token 契约、主题与状态
七角色 已确认:公共 UI 颜色只使用 primary、neutral、focused、success、warning、failure、general 七个角色,与固定职责色阶两维组合。不建立 Primitive/Semantic/Component 三层公共颜色别名,不虚构第八个 UI 颜色角色。 Token 契约、主题与状态、色彩语义与可辨状态
职责色阶(step) 每个角色允许使用的固定色阶编号,每个编号有唯一职责,共 32 项 role-step。主题改变物理值但不反转职责编号;不得临时造出未允许的色阶,如 primary-400、failure-800。 Token 契约、主题与状态
role-step 标识 产品组件消费的统一颜色标识,如 primary-200、neutral-950;跨平台名称与职责一致,调用语法可按平台映射。组件不得再叠加 background/foreground/hover 或组件颜色别名。 Token 契约、主题与状态
primary 操作与选择信号,允许 000 200 300 800 850 900 950:品牌面用 800 表面与 000 文字(悬浮 850),值、链接与指示用 900,选择面用 200(悬浮 300)。 Token 契约、主题与状态
neutral 表面、边界与文字等结构,允许 100 150 200 300 400 500 600 700 800 850 900 950:如 100 面板、150 页面与工具栏、200/300/400 控件默认/悬浮/按下、900/950 次级文字与正文标题。 Token 契约、主题与状态
focused 只有 900:明确获得焦点时的独立轮廓,不作选择底色或业务状态色;默认跟随最终 neutral-900,不因自定义 primary 自动改色。焦点采用 focused-900 轮廓加 neutral-100 稳定间隔。 Token 契约、主题与状态、色彩语义与可辨状态
success 允许 200 900 950:某项已请求的动作确实完成;“已保存草稿”不表示“审批已通过”。 色彩语义与可辨状态
warning 允许 200 900 950:存在风险或限制,是否能继续由规则决定;限于已说明的风险上下文。 色彩语义与可辨状态
failure 允许 200 900 950:校验或执行出现必须处理的问题,限于错误/危险上下文。 色彩语义与可辨状态
general 允许 200 900 950:信息提示,补充上下文或说明发生的变化,限于明确的信息提示上下文。 色彩语义与可辨状态
物理色板 角色与色阶背后的具体色值,只用于中心配置,不形成额外的公共消费层。 Token 契约、主题与状态
默认 primary 与自定义 primary 默认 primary 为 ink、neutral 为 gray(用户确认);未覆盖、覆盖删除或覆盖校验失败时使用完整默认 ink 映射。用户可自定义 primary 的中心色板,但须记录浅深两主题全部允许步骤并重跑受影响配对,任何一项不达门槛即拒绝整份覆盖。 Token 契约、主题与状态
D01/D01-R1/D01-R2 色值设计决定:D01 为代理初始采用;D01-R1 依用户确认纠正为 TeaCSS 默认映射(primary=ink、neutral=gray),具体高可读值由代理决定;D01-R2(2026-10-22,用户决定)只把默认 primary-200/300 改为带轻微彩度的选择面,其余 60 个值不变。唯一色值表在 Token 页。 决策与讨论记录、Token 契约、主题与状态
允许配对 已登记的前景/背景组合(C01—C11 配对组,共 198 项):正文与辅助文字至少 4.5:1,必要边界与焦点至少 3:1。198 项只是静态 sRGB 算术,不是浏览器、原生或真实绘制验收;不能因数字通过而扩大用途。 色彩语义与可辨状态
数据类别色 图表中的数据类别、顺序、发散、缺失、预测颜色由独立的数据语义字典定义,不冒充 UI 状态色。 色彩语义与可辨状态、图表选择、交互与可访问等效
label/prose/heading 三角色九档 已确认:跨平台统一三种文字角色,每种九档;页面标题、字段标签、数据文本等是业务用途映射,不另建字号体系。不设 13px 档位。 排版层级与文字可读性
label 单行标签类文字:字段与控件标签、单行数据文本、短状态与短辅助说明。 排版层级与文字可读性
prose 多行阅读文字:正文、多行说明与多行反馈,保留可持续阅读的行高与行长。 排版层级与文字可读性
heading 标题文字,包含字重:页面标题、区块标题;视觉档位与标题结构语义分别维护。 排版层级与文字可读性
档位 1x~9x 各平台尺度中的相对档位,不是像素倍数。应用 UI 的 label/prose 用 1x~3x、heading 用 3x~6x;文档长文 prose 用 2x~4x、heading 用 3x~7x;营销可用全部档位。 排版层级与文字可读性
业务用途映射 把页面标题、字段标签、数据文本等用途映射到三种基础角色;可修订,但不新增角色或档位。 排版层级与文字可读性
FND-T01-A/D02 D02 由代理采用的全部 27 行×四端初始尺度表,配合各端系统字体与动态缩放;真实字形与运行未验证。 排版层级与文字可读性
布局/响应式/密度 布局决定内容关系和阅读路径;响应式决定可用空间变化时如何重新组织;密度决定同一组织方式中的空间用量。三者不能互相替代。 布局、响应式与信息密度
标准/紧凑密度 D05-L02 采用的两种初始密度,默认标准。紧凑只减少非必要空白,不降低文字档位、必要说明或命中范围;窗口宽窄不自动改变密度。 布局、响应式与信息密度
命中区 控件的有效点击/触控区域。D05 初始设计目标:Web 触控 44×44 CSS px(精确指针按 WCAG 2.5.8 的 24 CSS px 下限及例外),iOS/iPadOS 44×44 pt,Android 48×48 dp,HarmonyOS 48×48 vp;这是 YUDS 设计政策,不冒称平台官方通用下限。 布局、响应式与信息密度
D05 四端设计目标 Web 以 WCAG 2.2 AA 为设计验收目标,四端采用命中区与可访问目标矩阵,并把 RTL 纳入四端设计目标;目标不等于已支持的版本或实测通过。 平台适配、国际化与输入能力、质量基线、门禁与验收证据
D07 动效 克制定时档 100/150/200 ms,默认 150 ms 短层级过渡;减少动态效果时自定义非必要过渡为 0 ms。动效不能控制网络提交、成功、取消或解锁时机。 图标、层级与动态反馈
D07-I01—I04 图标策略 首批应用图标采用 Lucide 1.59.0 锁定提交与 16/20/24 初始绘制档;仅采用来源策略,未导入资产或安装 SDK。 图标、层级与动态反馈

组件与交互

术语 含义 见
组件 具有明确输入、输出、状态及操作约定的可复用单元,复杂度不决定归属。组件可以提交审批,但不能决定谁有审批权。 基础组件与交互契约
统一阅读模板 消费一项组件契约的固定问题:目的、使用与不使用、解剖、变体与配置、值与身份、状态与转换、操作与反馈、可访问性、响应式与密度、平台、内容、正反例与组合、验收与资源。缺什么补什么,不复制共同契约。 基础组件与交互契约、组件使用手册:从任务选型到页面组合
解剖(anatomy) 组件必需、可选和条件必需的组成区域;只附默认态截图不算解剖完整。 基础组件与交互契约
变体(variant) 同一任务下明确不同用途的组件形式,不是每个状态的别名;视觉变体不增加组件数量。 基础组件与交互契约
状态维度(CMP-STATE) 视觉与指针/焦点、交互能力、值与校验、请求、业务阶段、授权分别记录,是可组合维度,不是一个排他枚举;例如“聚焦、只读、已有值、后台刷新失败”是合法组合。 基础组件与交互契约
聚焦(焦点) 当前输入与键盘操作的目标,是独立可见的一层;不等于已选择或已打开。 选择组件:值、范围与层级、基础组件与交互契约
选择 用户明确选中的值或范围,以持久标记表达;不因获得焦点自动改变。 选择组件:值、范围与层级
只读 能查看并理解当前获准的值,但不能改变;复制仍受输出权限约束,不能由只读推定复制、下载或导出授权。只读不等于禁用。 权限变化、并发修改与保存冲突、基础组件与交互契约
禁用 动作当前不可执行;原因放在邻近说明或可达帮助中,不只绑在无法聚焦的控件上;不等于内容不可读。 操作组件:按钮与动作入口、基础组件与交互契约
主操作 已确认:每个独立任务上下文至多突出一个主操作;不是要求每块区域都配主按钮。主次样式只表达当前任务优先级,不改变权限、请求结果与恢复契约。 操作组件:按钮与动作入口
独立任务上下文 主操作的计数单位:按对象与范围、任务目标、一次操作的后果、输入及结果的归属、提交与退出边界共同识别;不机械等于整个 View,不能以分栏、卡片、按钮组或窗口数量拆分。两个“主操作”若消费同一份未保存输入、改变同一处理集合或互斥地结束同一个任务,就不是两个独立任务(TASK-01)。 对象、任务与流程的衔接、操作组件:按钮与动作入口
危险确认 说明对象、范围和后果的独立确认任务;其中的危险操作是该任务唯一的主操作,不再并列品牌主按钮。 操作组件:按钮与动作入口
状态强操作 使用 general、success、warning、failure 变体的行动,只在已有同状态原因或后果的上下文成立,取代该任务的普通主操作而不与之并列。 操作组件:按钮与动作入口
D04 选择保守路径:不启用批准/拒绝双状态主操作例外;先以普通选择明确批准或拒绝及意见,再用一个“提交决定”主操作。 操作组件:按钮与动作入口、决策与讨论记录
八变体(CMP-ACTION/D03) 按钮视觉变体:primary、outline、neutral、minimal 表达强调层级(outline 与 neutral 同级,同组只选一种);general、success、warning、failure 只用于对应状态上下文。变体不是组件结构分类,success 样式也不代表业务已经成功。完整 API 和组件包未实现。 操作组件:按钮与动作入口
CMP-MAT 材质 D03 采用的六种表面职责:surface(卡片、面板、内容分组)、sunken(侧栏、工具栏、代码区)、tooltip(无交互短提示)、menu(菜单、弹出面板、选择器表面)、dialog(对话框及承担其语义的 sheet/抽屉)、fullscreen(全屏任务表面)。材质只是表面职责,不新增 surface-* 等颜色别名;按钮、输入、标签页是控件,不是第七种材质。实现 API 与资产未发布。 基础组件与交互契约
D03-M01 六材质的初始消费配方:不透明中性表面(默认 neutral-100,sunken 与全屏页面为 neutral-150),确需辨认时用 neutral-600 边界;最小起点不加阴影、玻璃或半透明遮罩,模态隔离不等同于深色遮罩。 基础组件与交互契约
模态层 打开期间限制对父任务的交互;关闭不自动取消父任务或已发写入。模态性由任务显式声明,不由阴影和位置决定;全屏不自动模态。 浮层组件:对话框、抽屉与提示、基础组件与交互契约
值帮助(SEL-HELP) 帮助字段检索、比较或跨页选择取值的独立任务,只有一个主要的“应用选择”;应用只把临时值接受为外层字段的新草稿,远程业务保存为 0,不把“应用到字段”说成“已保存”。 选择组件:值、范围与层级
等价路径 用不同呈现或输入方式完成同一任务、理解相同信息与结果,不只是显示相似卡片;拖动、悬浮、长按及多指动作不能是普通业务任务的唯一操作方式。 平台适配、国际化与输入能力、布局、响应式与信息密度

数据与流程

术语 含义 见
原始稿(原始输入) 用户实际输入的内容,可以不完整或暂时无效,如“1.”、未闭合的括号或输入法组字中的文字;与解析结果、已接受值、已提交值和服务端确认值分开记录。允许保留的原始稿不因暂时无效或取消而丢弃。 输入组件:文本、结构化编辑与专用输入
草稿 编辑中的工作内容,可以是本地未保存内容,也可以是已持久化的草稿;保存状态与业务提交阶段分别表达,允许保留暂时无效的原始输入。 表单校验、草稿与提交
接受 把子编辑器或当前编辑层的值交给其调用者;明确接受一般只改字段草稿,不代表远端保存、授权或业务执行。输入法确认组字不兼做接受;拖动、方向键、点击候选不自动代表已保存。 输入组件:文本、结构化编辑与专用输入、基础组件与交互契约
保存 须说明保存到哪里、是否已持久化;不等于提交、发布或审核通过。 界面文案、术语与多语言
提交 把内容交给某个流程的意图;提交意图与完成回执分开,接口返回“已受理”不等于业务完成。 界面文案、术语与多语言、基础组件与交互契约
已确认值(已确认结果) 由服务端等权威来源确认的值或结果,连同其版本;动效结束、请求已受理或本地接受都不能代替确认。 基础组件与交互契约、异步执行、结果核查与恢复
值事务(INP-G01) 具备编辑与提交能力的控件在概念上分开原始编辑内容、可解析候选、已接受的本地草稿、提交意图、服务端确认值及版本;异步响应绑定对象、值和版本,过期结果不能覆盖新草稿。 基础组件与交互契约
未知(值) 当前无法判定的值;与空、零、缺失、失败、无权限都不同,不能当作零,也不冒称缺失原因或实际值。 指标、数值与时间格式、基础组件与交互契约
零与非数值状态 已确认零值、已知没有记录、缺失/未上报、尚未加载、未知、不适用、受限、已脱敏、计算或获取失败、旧数据、部分数据须可区分;显示层不能统一转成 0,一个符号不能无说明地兼指多种状态。 指标、数值与时间格式
三种保存模型 本地视图变化、表单草稿、即时远程写入须先声明,不能用同一个“已选”字样混淆;表单改变只改草稿,Tab、失焦、折叠和重排不提交;即时写入没有“离开即撤销”。 基础组件与交互契约
编辑会话基线(快照) 进入编辑会话时允许保留的原始内容,包含未解析或尚不合法的草稿;取消只放弃本会话拥有的变化,回到该基线而不是远端旧值;恢复前重核权限与版本,失权内容不恢复。 基础组件与交互契约、浮层组件:对话框、抽屉与提示
D/A/R/S/W/V 查询审阅用的状态字母,不是 API 字段:D 查询草稿、A 最近明确应用的查询、R 当前显示结果、S 已选范围、W 已经提交的写任务、V 展示偏好。面向最终用户的文案不用这些字母。 查询、选择范围与批量执行
E/S(复选框父范围) E 是当前声明范围中已解析、可读取且可操作的稳定 ID 快照,S 是本次草稿所选 ID 的集合;父复选框按 S∩E 显示零、部分或全部,E 为空时父框不可用。 选择组件:值、范围与层级
B/D(值帮助) B 是值帮助打开时捕获的字段草稿快照,D 是对话框临时值;取消只丢弃 D,不把外层字段重置成 B。 选择组件:值、范围与层级
选择范围(三类) 当前页(当前页中可操作的稳定记录 ID)、已加载/显式选择(可能来自不同页或视图的集合)、全部查询结果(服务端按明确查询、权限和快照解析的成员集合,须有独立的升级动作)。“当前可见”“本页”“已加载”“查询总计”“可执行”的数量不能互换;总量未知时不显示精确全选数量。 查询、选择范围与批量执行
排除项 全量查询选择后取消的成员;按记录身份而非页面位置记录,查询成员或权限变化后重新解析并报告差异。 查询、选择范围与批量执行
冻结输入 已提交后台任务的对象、范围、动作参数和基准版本;之后修改查询条件不改变旧任务的范围。 查询、选择范围与批量执行
保存视图 可复用的查询条件定义;打开前显示本次实际范围,固定范围不可访问时停止应用或提供修复入口,不静默换成当前组织;不构成扩大工作空间授权的方式。 查询、选择范围与批量执行、信息架构与工作空间
批量预览 执行前列出动作、对象类型、选中与可执行数量、跳过或不允许的数量、拟改字段与新值、业务影响和可撤销性;预览不是锁,执行时仍重新验证。批量编辑区分“不修改此字段”“设为空值”“设为某值”。 查询、选择范围与批量执行
快照(数据) 一次查询或结果的版本;同一分析区内的指标、图、表和来源说明尽量绑定同一快照,无法原子更新时分别标明。打开依据时说明展示的是原快照还是当前最新记录。 来源、快照与依据追溯

系统状态与权限

术语 含义 见
内容状态四维度 数据可用性、数据有效性、访问与操作能力、动作执行结果分别描述,可以组合;不用一个“加载中”覆盖所有情况。 系统状态、权限与恢复
请求与业务结果 界面发出请求后可能只知道通信是否完成;请求被接受不等于任务完成,响应丢失也不等于任务失败。 异步执行、结果核查与恢复
结果待确认(结果未知) 动作可能已执行,但没有足以确认结果的证据。先核查同一动作,不直接写失败,不盲目重试,也不重新启用原按钮;能否查询取决于产品真实能力,无能力时说明限制与真实可用的处置路径,不伪造任务入口。 异步执行、结果核查与恢复、系统状态、权限与恢复
部分成功 批次已确认结束且全部逐项结果已核实,其中既有成功项也有未成功项,并保留逐项结果。仍有项目执行中时批次保持“处理中”;执行已结束但仍有未核实项时,说明“执行已结束,部分结果待确认”,不以部分成功代替核查。 系统状态、权限与恢复、异步执行、结果核查与恢复
批次生命周期与逐项结果 两个独立维度。逐项结果分为成功、明确失败、未执行/跳过、已取消和结果待确认,执行中的成员另有排队/处理中;总量与分类数应能对账。 查询、选择范围与批量执行、异步执行、结果核查与恢复
取消(执行) 取消是请求而非立即事实,正在执行的项可能在取消后成功;关闭进度界面与取消任务是不同动作。 查询、选择范围与批量执行
安全重试 只在已确认原操作未成功或具备幂等保证、资格和版本重新校验后,针对需要重试的成员发起;待确认项先查原请求。界面禁用按钮只能减少重复点击,不能保证不重复执行。 查询、选择范围与批量执行、异步执行、结果核查与恢复
访问权与操作权 能看到对象不等于能修改或提交;权限检查发生在执行层,隐藏按钮、禁用字段和前端校验只帮助理解和防错,不是授权已落实的证据。 权限变化、并发修改与保存冲突
不显示/只读/禁用/脱敏 不显示:用户无需或无权知道内容或能力存在,不经搜索、计数、错误、缓存或导出泄露;只读:可查看已获准内容但不能编辑;禁用:用户知道此操作但当前条件未满足;脱敏或摘要:产品允许查看的有限表达。 权限变化、并发修改与保存冲突
受限 受到读取或操作权限限制;是否能披露存在及原因由产品定义。 权限变化、并发修改与保存冲突
撤权 任务进行中权限被撤回。先阻断新意图,再清理不允许保留的草稿、名称与受限内容,仍可读的值可以保留;已发写入按真实回执处理,不说成已撤销;不承诺追回此前合法复制或已外发的副本。 基础组件与交互契约、权限变化、并发修改与保存冲突
授权代次 异步读取与回调须绑定的当前授权版本,连同账户、范围、资源版本与请求身份一起核对;切换范围或撤权后,旧响应不得重新填充界面、缓存或可访问名称,旧授权响应也不能复活能力。 基础组件与交互契约
请求身份/任务身份与写回执 每次请求或任务的稳定身份。过期的读取响应可以丢弃;已发出写操作的回执按原任务身份保留和核查,不当作旧读取丢弃,也不能写进已切换的对象或范围。 基础组件与交互契约、查询、选择范围与批量执行

治理与验收

术语 含义 见
文档夹具 用来检查规则的一组前提、操作和预期;有夹具不代表测试已运行,文档走查通过也不等于组件运行通过。夹具编号以“主档编号+夹具 ID”定位,不混入规范定义主键。 质量基线、门禁与验收证据、规范、设计与实现映射
中性夹具(D06) 当前阶段用行业无关的“记录 R 查询 → 修改字段 → 提交受控事件 → 查看结果”验证组件组合;合成记录 R-001 位于合成范围 S1,全部数据为测试替身,不能描述为真实租户、权限或服务已接通。 端到端任务旅程与验收案例、接入示例:共享资料清单
文档走查/组件组合运行/产品端到端集成 三个执行层次:文档走查只检查条款、固定输入与预期是否一致,不产生运行通过结论;组件/组合运行在实际构建的测试宿主中运行夹具;产品端到端集成验证真实产品规则与服务,本阶段不开展,单列“阶段外/未评估”。 质量基线、门禁与验收证据
测试宿主 运行组件与组合夹具的实际构建,固定组件依赖、受控服务事件与平台环境;无须先绑定业务产品。内存模拟的结果只证明受控条件下的组件行为,不能证明生产幂等、真实权限服务或跨会话持久能力。 质量基线、门禁与验收证据
通过/失败/未执行/不适用 测试结论:通过须在记录的条件与范围内实际满足预期并有可核查证据;失败须说明影响、复现和临时措施;未执行须记录原因;不适用是适用性判断,不当作通过,须记录理由和审阅者。 质量基线、门禁与验收证据
规范、设计、实现、验证 规范已写、设计已画、代码已实现、任务已验证是四种不同状态,分别登记,不能相互替代。 视觉与语义基础、体系大纲与阅读路线
决策状态 已确认/拟议/待验证/被替代,记录在决定记录和追溯字段中;资源生命周期与实现测试结果另列,不替代决策确认状态。 决策与讨论记录、规范、设计与实现映射
实现能力成熟度 草案 draft、已验证 validated、已弃用 deprecated,按能力和支持范围标注;文档审查不授予 validated,设计采用不等于视觉或运行通过。 贡献、决定、版本与迁移
release_status 每项资产的发布稳定性:Draft(草稿)、Experimental(试验)、Stable(稳定)或未核实;当前不分配稳定状态,也不与决策状态混用。 规范、设计与实现映射
实现映射 从需求或任务、规范规则及版本、设计资产/Token、平台实现、可运行样例、测试证据到使用产品的追溯链;每一跳有稳定标识与主档,缺失之处如实显示。 规范、设计与实现映射
采用记录 使用方的工作单,写明采用对象与范围、固定输入版本、覆盖级别、能力前提、差异与风险、责任、验证和迁移;不是第二份组件契约。关闭采用需要任务结果,不是“资源已下载”“PR 已合并”或“设计稿已更新”。 贡献、决定、版本与迁移
兼容审阅与破坏性变更 兼容判断超出函数签名:同名状态改变业务含义、默认操作范围扩大、键盘或焦点模型改变、Token 语义改变、支持范围被移除等都可能构成破坏性变更;截图没有变化不等于无破坏。 贡献、决定、版本与迁移
例外 记录限定范围的暂时差异,须有到期日期或可验证的退出条件,到期重新评估、不自动续期;不覆盖法律、安全政策、隐私或合同义务。 贡献、决定、版本与迁移、规范、设计与实现映射

规则 ID 前缀

文档规则 ID 只用于文档追溯,不是组件属性、包名、产品 API 或版本发布批准。规则移动时保留 ID 并更新主档定位;删除时保留被替代关系,不把原 ID 分配给新含义。族 ID 后接 -USE、-STATE、-KEY 等时多为该族的子节,后接 -F01、-N 等时多为该族的文档夹具,具体以所在主节为准。

前缀 含义 见
FND- 基础规则:FND-C01 七角色允许表;FND-C02—C04 配对、主题与强制颜色、数据与 UI 状态隔离;FND-T01—T03 排版;FND-L01—L03 命中区、键盘与输入法、安全区;FND-M01—M03 减少动态效果、系统偏好、中断与闪烁;FND-I01—I02 完整消息与方向隔离、输入与动态语言切换;FND-ICON 图标;FND-RESTRAINT 克制视觉审查。 Token 契约、主题与状态、色彩语义与可辨状态、排版层级与文字可读性、布局、响应式与信息密度、图标、层级与动态反馈、界面文案、术语与多语言、视觉与语义基础
CMP-01—CMP-41 原始 41 项目录组件的追踪标识:01—05 操作、06—12 输入、13—19 选择、20—25 导航、26—29 浮层、30—35 反馈、36—41 容器。不是新编号体系、品牌 Token 或实现 API;菜单的唯一完整主档是 CMP-05。 操作组件:按钮与动作入口、输入组件:文本、结构化编辑与专用输入、选择组件:值、范围与层级、导航组件:位置、切换与返回、浮层组件:对话框、抽屉与提示、反馈组件:让状态和结果可理解、容器组件:分组、展开与工作区组织
CMP-STATE/CMP-MAT/CMP-ACTION/CMP-LAYER/CMP-SELECT-KEYS 组件共同规则:状态组合与事件仲裁;六材质职责;八变体边界与任务判断;浮层的选择、关闭与背景仲裁;多选与树的有界 Web 键盘模型。 基础组件与交互契约、操作组件:按钮与动作入口、浮层组件:对话框、抽屉与提示、选择组件:值、范围与层级
ACT- 操作组件:ACT-BUTTON 普通按钮、ACT-ICON 图标按钮、ACT-TOGGLE 切换按钮、ACT-SPLIT 拆分按钮。 操作组件:按钮与动作入口
TXT-/QRY- TXT-SINGLE 单行输入、TXT-MULTI 多行文本;QRY-SEARCH 查询输入。 输入组件:文本、结构化编辑与专用输入
INP- 输入族:INP-G01—G05 值与选择控件的共同规则(值事务、状态独立、视觉语义、访问与内容、平台与实现);INP-DATE 日期、INP-T01—T07 时间与日期时间、INP-M01—M04 掩码、INP-UPLOAD 文件上传;INP-S01—S05 滑块、INP-R01—R04 评分、INP-E01—E05 分段控件在选择篇。 基础组件与交互契约、输入组件:文本、结构化编辑与专用输入、选择组件:值、范围与层级
PRM- PRM-TEXT 文本、标签、标题与展开;PRM-LINK 链接;PRM-SPIN 数值步进。 排版层级与文字可读性、导航组件:位置、切换与返回、输入组件:文本、结构化编辑与专用输入
CHO-/SEL- CHO-CHECK 复选框、CHO-RADIO 单选组、CHO-SWITCH 开关;SEL-COMMON 选择值、范围与取消层次,SEL-SINGLE 单项选择与组合框,SEL-MULTI 多项选择,SEL-HELP 值帮助。 选择组件:值、范围与层级、基础组件与交互契约
NAV- NAV-01—NAV-05 返回、关闭与离开的仲裁契约;导航组件篇中的 NAV-B1 等是夹具编号。 导航、深链接与上下文保留、导航组件:位置、切换与返回
PAG-/TBL-/FIL-/FT- PAG-DATA 分页;TBL-DATA 普通数据表与交互网格、TBL-SORT 排序、TBL-VIEW 列设置;FIL-BAR 查询条件与筛选条;FT-COMMON 查询、结果与执行的共同状态,FT-COMB 为其组合夹具。 导航组件:位置、切换与返回、数据表与交互网格契约、查询、选择范围与批量执行
LP- 浮层与面板:LP-COMMON 与 LP-G01—G06(身份、模态层树、父子编辑与取消快照、关闭请求、关闭后的焦点去向、视觉与增长),LP-DIALOG 对话框、LP-DRAWER 抽屉、LP-POPOVER 弹出面板;LP-PANEL、LP-RESIZE 在容器篇。 浮层组件:对话框、抽屉与提示、容器组件:分组、展开与工作区组织
FB-/DSP- 反馈:FB-LIVE 实时通告、FB-BANNER 提示横幅、FB-TOAST 短暂通知、FB-BUSY 忙碌与进度、FB-SKELETON 骨架、FB-EMPTY 空状态;展示:DSP-MESSAGE-SUMMARY、DSP-LABEL、DSP-NOTIFICATION 在反馈篇,DSP-AVATAR、DSP-IMAGE/DSP-PREVIEW 在容器篇,DSP-MONEY 在指标篇。 反馈组件:让状态和结果可理解、容器组件:分组、展开与工作区组织、指标、数值与时间格式
CT- CT-LIST 列表共享语义。 容器组件:分组、展开与工作区组织
GEN-/FORM- GEN-SNAPSHOT 原始草稿与接受边界回归、GEN-GRID 交互网格夹具;FORM-SNAPSHOT 表单提交快照编排。 基础组件与交互契约、数据表与交互网格契约、表单校验、草稿与提交
SCH-/LOC-/REL- 限定候选:SCH-BASE、SCH-CAL、SCH-PROP、SCH-TIME(日历、日程提案、只读依赖时间线);LOC-01—04 地点、REL-01—03 只读关系探索。未实现、未运行验收。 日历、日程提案与只读依赖时间线、地点选择与只读关系探索
PAT-/SUP- 有界文档候选:PAT-AUTH 认证入口与会话恢复、PAT-ONBOARD 首次使用引导、PAT-CONSENT 信息告知与明确选择、PAT-OFFLINE 离线读取与同步反馈、PAT-IMPORT 数据导入审阅;SUP-HANDWRITING 手写采集与本地稿确认。设计未创建、实现未验证、运行未执行。 权限变化、并发修改与保存冲突、流程推进与协作责任、表单校验、草稿与提交、系统状态、权限与恢复、表单与业务流程、输入组件:文本、结构化编辑与专用输入
PLAT- 平台补充:PLAT-INPUT 输入动作与附件、PLAT-INSETS 避让所有权与键盘形态、PLAT-SEMANTICS 原生语义验收记录、PLAT-VERSION 运行 OS、目标 SDK 与窗口条件。 输入组件:文本、结构化编辑与专用输入、布局、响应式与信息密度、平台适配、国际化与输入能力
B1- B 类分析标签下的通用组合族(有界候选):B1-SHELL 壳、账户与范围入口,B1-CARD 数据卡片,B1-SIDE 侧内容,B1-TREE 树与树表,B1-VIEW 视图设置,B1-EXPORT 导出,B1-WIZARD 向导。 导航组件:位置、切换与返回、容器组件:分组、展开与工作区组织、数据表与交互网格契约、查询、选择范围与批量执行、流程推进与协作责任
B2- B 类组合族(有界候选):B2-FAVORITE 标记与收藏、B2-PREVIEW 快速预览、B2-BANNER 首页横幅、B2-HEADER 可收缩页头、B2-COMPARE 比较模式、B2-DATA/B2-MICRO/B2-CHART/B2-TOOLS 图表、B2-FLOW 流程可视化。 操作组件:按钮与动作入口、浮层组件:对话框、抽屉与提示、容器组件:分组、展开与工作区组织、端到端任务旅程与验收案例、版本、比较与并发差异、图表选择、交互与可访问等效、流程推进与协作责任
B3- B 类扩展族(有界候选):B3-EDIT 结构化编辑共同契约、B3-EXPR 公式与规则、B3-RICH 富文本与 HTML、B3-COLOR 用户内容颜色、B3-SCAN 条码扫描与手工输入、B3-CLOUDFILE 云文件引用、B3-CAROUSEL 轮播。 输入组件:文本、结构化编辑与专用输入、选择组件:值、范围与层级、容器组件:分组、展开与工作区组织
C1- 四个 C 通用组合(有界候选):C1-AI 建议审阅(共同边界 C1-COMMON)、C1-FEED 评论与回复、C1-TRANSLATE 用户输入翻译建议、C1-OUTPUT 输出交付扩展。真实外部服务、传输授权和结果核查能力是门槛。 AI 辅助与用户控制、流程推进与协作责任、输入组件:文本、结构化编辑与专用输入、查询、选择范围与批量执行
FAM- 能力族编号,如 FAM-003、FAM-037、FAM-052、FAM-054、FAM-020、FAM-040,标示某篇覆盖的族;族内变体和夹具不计作新组件数量。 日历、日程提案与只读依赖时间线、地点选择与只读关系探索、基础组件与交互契约
YUDS-六位编号-局部编号 如 YUDS-090300-02:六位编号是源笔记编号(090300 即「查询、选择范围与批量执行」);定义是加粗“规则 完整 ID”的段落,复述与夹具表为引用。 规范、设计与实现映射
YUDS.140100.P01—P07/YUDS.150200.A01—A07/YUDS.150300.M01 平台事实与适配规则、可复现的无障碍执行矩阵、稳定 ID 与逐端登记契约。连字符 ID 不能改写成未登记的点分格式。 平台适配、国际化与输入能力、质量基线、门禁与验收证据、规范、设计与实现映射
TASK-01/SCOPE-01 独立任务边界的判定记录;采用工作稿时必须交付的内容。 对象、任务与流程的衔接、定位、使用者与职责边界
D01—D08 代理初始设计基线:D01 色值、D02 字体与尺度、D03 八变体与六材质职责、D04 单主操作、D05 几何与可访问目标、D06 中性设计任务、D07 动效、D08 稳定范围。子编号:D01-R1/D01-R2 色值修订,D03-B01 按钮状态配方,D03-M01 材质配方,D05-L01—L05 间距、密度、圆角、画布与 RTL,D07-I01—I04 图标。Stitch 批次 ID(D00、D01、D02 等)与这些设计决定是不同命名空间。 决策与讨论记录
Q- 任务级可观察用例编号,如 Q-TASK-01、Q-RESULT-01、Q-FOCUS-01;拟议,实际运行尚未执行。 质量基线、门禁与验收证据
ENV- 候选测试环境的官方配置依据:ENV-W1—W3、ENV-A1—A5、ENV-D1—D5、ENV-H1—H3;只支持所列配置事实,不是支持范围声明。 质量基线、门禁与验收证据
旅程 A—E 与 G1—G14 端到端任务旅程 A—E 及其验收用例(如 A6、B4),以及跨平台与组合状态夹具 G1—G14;用例存在不表示已运行。 端到端任务旅程与验收案例
C01—C11 允许配对的分组,如 C01-TEXT、C11-FOCUS;注意与 C1- 组合族区分。 色彩语义与可辨状态
R-001/S1 中性夹具中的合成记录与合成范围。 端到端任务旅程与验收案例、接入示例:共享资料清单

缩写与外部名称

术语 含义 见
IME 输入法组合会话。组合期间按键先由输入法占有:Enter 确认组字时不提交表单、不接受候选,Escape 只取消该次组合;组合期间不做破坏性格式化、截断或最终校验。 布局、响应式与信息密度、选择组件:值、范围与层级、界面文案、术语与多语言
AT 辅助技术,如 VoiceOver、TalkBack、系统屏幕朗读;验收须记录实际版本并真实运行,添加 ARIA 属性不等于通过。 质量基线、门禁与验收证据、基础组件与交互契约
ARIA Web 的无障碍语义属性,是参考模型;原生端采用对应平台语义,不把 ARIA 属性照搬为跨端验收;aria-disabled 只描述,不自动阻断操作。 基础组件与交互契约
APG W3C 的交互模式实现指导与示例;不是 YUDS 实现合格证,也不能当作通过 WCAG 或所有辅助技术的认证。 基础组件与交互契约
WCAG 2.2 AA D05 采用的 Web 设计验收目标,须覆盖全部适用的 A 与 AA 成功准则(SC),不能只查摘列的数字门槛;组件报告或自动扫描分数不能单独构成符合性声明。尚未宣称任何实现达标。 质量基线、门禁与验收证据
RTL/LTR 从右到左/从左到右的文字方向。RTL 是 D05-L05 的四端设计目标,尚未证明支持;不等于把数字、时区标识、序列号逐字倒置,也不能只翻转 CSS。组件键位默认按 Web LTR 描述。 布局、响应式与信息密度、平台适配、国际化与输入能力
HEX/sRGB 色值写法与色彩空间。D01-R2 共 64 个 HEX 物理值;198 项配对只是不透明 sRGB 输入的静态算术。B3-COLOR 首期只接受用户内容的 sRGB 六位 HEX 与独立 alpha,不改系统 Token。 Token 契约、主题与状态、色彩语义与可辨状态、输入组件:文本、结构化编辑与专用输入
OKLab ΔE D01-R2 用来记录默认选择面与中性面、状态柔和面可辨性的指标,仅作信息,不是门槛。 色彩语义与可辨状态
IANA 时区 日程中定时事项显示时区的明确名称;输入本地日期时间须对应 IANA 时区,夏令时不存在的当地时间报错,重复的当地时间须选具体偏移。 日历、日程提案与只读依赖时间线
WGS84 地图适配唯一接受的坐标声明(经度/纬度,单位为度);未提供坐标不等于 (0,0)。 地点选择与只读关系探索
尺寸单位 Web 用 CSS px 与 rem,iOS/iPadOS 用 pt,Android 用 dp 与 sp,HarmonyOS 用 vp 与 fp;相同数字不表示物理大小相同,不把 pt/dp 原数复制为 CSS px。 排版层级与文字可读性、布局、响应式与信息密度
API YUDS 只定义可观察语义与行为,不规定具体编程 API;规则 ID、“接受”“提交”等行为词和追溯字段都不是 API。正式组件 API 与组件包尚未实现。 基础组件与交互契约、规范、设计与实现映射
SemVer 语义化版本;实现包若采用,须先明确其公共契约。当前未建立正式包版本与发布渠道,不为完成文档虚构 v1.0。 贡献、决定、版本与迁移
四端 Web、Apple(iOS/iPadOS)、Android、HarmonyOS。四端设计、代码实现、平台与辅助技术验收是不同成果,分别登记。 平台适配、国际化与输入能力、YUDS 统一设计系统
SAP/Geist/OUDS/Stripe Sail 参考体系:SAP 是体系覆盖与深度的主要基准,Geist 是视觉克制的主要基准,OUDS 与 Stripe Sail 的优点按已核实范围吸收;不照搬其视觉、API、品牌或平台行为,也不宣称与 SAP 等价。 YUDS 统一设计系统、基础组件与交互契约
Billgo Standard Design 两维颜色、三角色九档与六材质名称的对齐参考;其中“每 View 一个品牌按钮”与 13px 建议不覆盖 YUDS 已确认规则。 决策与讨论记录
TeaCSS D01-R1 色值对齐的来源(默认 primary=ink、neutral=gray);YUDS 只消费允许子集,不冒充 TeaCSS 完整色板,未查验的发布能力不写成可调用。 Token 契约、主题与状态、决策与讨论记录
Teakit/Teasim 产品背景定位:Teakit 为 TypeScript 库与框架,Teasim 为 UI 体系;不自动决定由谁承载 YUDS。 规范、设计与实现映射
Stitch 用户授权的四端组件库设计项目所用工具;Stitch 成图不是运行证据。具体设计工作当前暂停。 决策与讨论记录、YUDS 统一设计系统
Lucide D07-I01 采用的首批开放图标家族(1.59.0 锁定提交)。 图标、层级与动态反馈
AMKit 早期的核心参考产品,其演示只用于理解业务流程,不是最终设计;当前不以 AMKit 接入为前置,正式介绍也不写其验证产品身份。 体系大纲与阅读路线、决策与讨论记录