状态:本页汇总各章已使用的术语,供阅读入口;术语的规范含义以所链接的专题页为准,本页不新增规则。
词条按主题分组,只写各章已经使用的含义和必须随之保留的限定;完整规则、例外和夹具见「见」列的专题页。同一个字母或缩写在不同章节可能代表不同对象(例如 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 接入为前置,正式介绍也不写其验证产品身份。 | 体系大纲与阅读路线、决策与讨论记录 |