状态：十二章、六原则原文、职责与工作空间权限边界，以及颜色两维标识、三类文字角色各九档、每个独立任务上下文至多突出一个主操作等边界沿用既有确认；D01-R2 与 D02—D08 按既有授权记录采用为初始设计输入，不代表组件包已发布、设计已验收或四端已达标。规范文档仍在完善，具体设计工作暂停；正式 API 与组件包未实现，文档夹具与真实运行验收均未执行。
YUDS（Yiplex Unified Design System）为数据密集、业务关系复杂的企业工作提供共同设计语言、交互契约和验收方法。YUDS 定义规则；实现项目提供组件与平台映射；产品负责业务模型、计算、权限与流程。职责全文见定位、使用者与职责边界。
从你要完成的任务开始
| 我现在要做什么 | 先读 | 继续到哪里／应得到什么 |
|---|---|---|
| 第一次了解 YUDS | 定位、使用者与职责边界、六条设计原则 | 用体系大纲与阅读路线看十二章关系，分清规范、实现和产品职责 |
| 选择合适组件 | 组件使用手册：从任务选型到页面组合、基础组件与交互契约第 2 节 | 进入组件唯一主节，确认用途、不适用场景、变体与状态，不按截图选型 |
| 设计页面或工作台 | 页面与端到端模板、接入示例：共享资料清单 | 导航、深链接与上下文保留、布局、响应式与信息密度：明确对象、任务、返回路径与内容增长 |
| 做筛选、表格与批量动作 | 数据表与交互网格契约、查询、选择范围与批量执行 | 异步执行、结果核查与恢复：明确选择范围、执行身份、部分成功与结果未知 |
| 做编辑、提交或审批 | 表单校验、草稿与提交 | 流程推进与协作责任、权限变化、并发修改与保存冲突：保稿、提交、责任与冲突 |
| 解释或比较数据 | 指标、数值与时间格式 | 版本、比较与并发差异、来源、快照与依据追溯：单位、版本、来源与依据 |
| 适配主题、密度或平台 | 视觉与语义基础、组件平台选型：先定任务，再定呈现 | 平台适配、国际化与输入能力：消费同一语义，记录平台差异和支持范围 |
| 实现或验收一个能力 | 规范、设计与实现映射 | 质量基线、门禁与验收证据：绑定实际版本、环境、任务与证据 |
| 修改规则或升级采用 | 贡献、决定、版本与迁移 | 识别兼容影响、提交变更记录、形成采用与迁移证据 |
先分清：手册说了什么，不代表什么
规范文档仍在完善，具体设计工作暂停；既有设计草稿与未执行用例不计作运行证据。D01-R2 与 D02—D08 已采用为初始设计输入，不代表组件包已发布、设计已验收或四端已达标。默认 primary 为 ink、neutral 为 gray；用户可覆盖 primary，覆盖后的配对须重新验证。
| 阅读标记 | 能从中获得什么 | 不能据此推断什么 |
|---|---|---|
| 契约（contract） | 在所述范围内查到用途、行为、状态、边界与验收预期 | 不表示实现可用、视觉通过或支持所有平台 |
| 有界子集（subset） | 只使用逐项列明的能力；未覆盖项保持显式缺口 | 不把同名族、目录入口或部分夹具当成完整能力 |
| 分类边界（boundary） | 知道该类能力归哪里、与已有规则怎样衔接 | 不用于承诺具体行为、API 或生产采用 |
以上是阅读范围标签，不另建实现成熟度体系。某条规则是否已确认、采用或仍为建议，仍以该主节及决策与讨论记录为准；实现成熟度、发布状态和测试结论分别记录，见贡献、决定、版本与迁移第 4 节。没有足够证据时保留“未验证／未执行”，不以篇数、目录数或历史评分代替质量。
找到唯一规则，而不是最近一份附件
- 用户明确确认的 YUDS 决定优先；现行规范主档是日常使用入口。经核验的 Billgo Standard Design 与外部研究是参考，不能覆盖 YUDS 已确认语义。
- 主档内的稳定规则 ID 和同名组件主节承载契约。跨章只链接，不复制一套会分叉的规则；实现 API 以实际实现版本为准。
- 当前登记用于定位与核对摘要，不产生新规则；历史研究、冻结稿和审计回执用于追溯，不作现行值表。
- 附件与主档冲突时，先检查时间、适用范围和决定记录，不选择自己偏好的版本；无法消解的冲突登记为阻断，不自行改语义。
组件共同契约从基础组件与交互契约开始；菜单唯一完整主档为操作组件：按钮与动作入口 CMP-05，浮层章（浮层组件：对话框、抽屉与提示）只承担共享层与焦点边界。四个 C 通用组合分别归于AI 辅助与用户控制 C1-AI、流程推进与协作责任 C1-FEED、输入组件：文本、结构化编辑与专用输入 C1-TRANSLATE、查询、选择范围与批量执行 C1-OUTPUT；另在日历、日程提案与只读依赖时间线与地点选择与只读关系探索补充日历排程、只读依赖时间线、地点选择和只读关系探索四族的限定候选。它们不代表完整族能力；其余分类仍保留边界，不以目录入口升级为完整契约。
必须保持的已确认边界
- 颜色公共消费标识使用七角色
primary / neutral / focused / success / warning / failure / general× 固定职责 step 两维；不新增 Primitive／Semantic／Component 三层颜色别名，物理色板仅作中心配置。数据类别色独立于 UI 状态色，跨端同一 Token ID 与语义、语法分别映射。 label / prose / heading各九档；页面标题、字段标签、数据文字是用途映射，不另建字号体系。D02 已采用系统字体与四端初始尺度；实际字体回退／使用范围与渲染仍待验证。- 每个独立任务上下文至多突出一个主操作；以对象、目标、提交和退出边界识别，不机械等于整个 View，也不由卡片／工具栏数量新增配额。危险确认与普通主操作分清；D04 已选择不启用批准／拒绝双主例外。
- 十二章、六原则原文、职责及工作空间权限边界沿用既有确认；YUDS 定义契约，实现项目提供组件与平台映射，产品负责业务模型、计算、权限和流程，不预先绑定实现仓库。
现行设计基线
D01-R2（D01-R1 加默认选择面淡彩修订）与 D02—D08 按既有授权记录采用；手册化整理不重新批准或更改这些设计输入。理由、撤回条件与授权来源见决策与讨论记录。唯一数值与行为主档如下：
- D01-R2 物理值：Token 契约、主题与状态；允许配对／焦点构造：色彩语义与可辨状态。默认 primary=ink、neutral=gray；用户未覆盖 primary 即使用 ink，完整自定义需单独重验。TeaCSS 来源及高可读修订已记录；64 HEX 与 198 项静态算术并非真实绘制验收。
- D02 全 27 行四端尺度、系统字体和动态缩放：排版层级与文字可读性。
- D05-L01—L05 间距、密度、几何、画布／框宽与 RTL：布局、响应式与信息密度；四端设计目标：平台适配、国际化与输入能力；真实门禁：质量基线、门禁与验收证据。
- D03 八变体／六材质职责及 D04 不启用双主例外：操作组件：按钮与动作入口、基础组件与交互契约；正式 API 和组件包未实现。
- D06 中性设计任务：端到端任务旅程与验收案例；D08 稳定范围：信息架构与工作空间；真实业务与服务能力不编造。
- D07 克制动效、静态替代及 D07-I01—I04 首批 Lucide 图标策略：图标、层级与动态反馈。
十二章主线
- 定位、使用者与职责边界：YUDS、具体实现项目、产品分别负责什么。
- 六条设计原则：共同语义、清晰、数据可信、恢复、效率、可访问。
- 信息架构与工作空间：业务对象、用户任务和业务流程怎样衔接。
- 视觉与语义基础：设计变量、颜色、排版、密度、动效和文案。
- 基础组件与交互契约：组件的用途、输入、状态、反馈与替代操作。
- 复杂数据工作模式：表格、矩阵、筛选、批量处理和版本比较。
- 数据表达与分析：单位口径、时间、空值、图表和依据追溯。
- 表单与业务流程：编辑校验、保存提交、审核及协作。
- 系统状态与权限：异步、部分成功、未知结果、并发与恢复。
- 页面与端到端模板：从列表与详情到复杂工作台和整条任务。
- 跨平台与智能交互：语义一致的平台适配及可选 AI 边界。
- 治理、交付与质量：贡献、版本、实现映射、例外与验收证据。
完整专题导航、角色阅读路线与章节交付物见体系大纲与阅读路线。六原则原文以六条设计原则为准，本入口的摘要不替代原文。
如何把手册用于一次真实工作
先写对象、任务、范围、开始与结束条件；按任务选模式与组件。用组件章（基础组件与交互契约）的消费模板识别尚缺的用途、解剖、状态与平台信息，缺口不靠想象补齐。再在端到端任务旅程与验收案例的中性任务中检查组合，最后绑定实际实现与质量基线、门禁与验收证据的验收环境。无法确认的服务能力由产品补齐，不由 UI 伪造。
文档可先完成，不必等待行业系统接入；但文档夹具全部仍需真实运行。四端设计、代码实现、平台与辅助技术验收是不同成果，分别登记。SAP 体系覆盖与深度是学习基准，不是已完成等价声明；视觉简洁不能删掉任务所需信息、反馈和恢复路径。
关于本知识库版本
本目录是 YUDS 工作笔记的阅读版，整理自 fsnotes 知识库 60-engineering/yuds 在提交 6bea7de（2026-10-22）时的 54 篇笔记，供后续制作 YUDS 展示网页使用。
- 每篇源笔记对应一页，按十二章分目录存放；每页 frontmatter 的
source指向对应源笔记，chapter与order给出章节与页内顺序。 - 整理只删去评审轮次、回执、哈希、行号等过程记录，并统一状态说明与链接格式；规则、规则 ID、数值、表格、示例、夹具和外部依据均保留，未新增规则，也未改变任何“建议”“候选”“未执行”的状态。
- 规则以源笔记和决策与讨论记录为准。源笔记更新后，本目录需按同样方式重新整理，不在这里单独修改规则。
- 术语表汇总各章使用的术语，含义以所链接的专题页为准。
研究、历史与未完成证据
日常读者可以跳过本节。复核者从这里追溯原始证据，不把旧时间点当现行状态。
- 2026-10-21 已完成设计规范与跨模型讨论快照：固定于 2026-10-21 12:41（UTC+8），720 个平台×主题单元中 126 个通过有界静态 G2（有界设计接受），含精确设计参数、组件合同及资产链接；G3（实现与真实运行证据）全部未执行。该快照不替代现行主档，也不代表完整系统完成。
- 2026-10-20 手册化前入口全文：完整保留原入口、各阶段审计、旧数量及附件链接，并标出过期设计状态。
- 既有阶段历史与早期导航快照：旧编号、行号与 hash 只对应原快照。
- 手册修订与复审回执：说明实质修改、复验和仍未覆盖的能力，不代表运行通过。
- SAP 手册研究与来源边界：采用任务优先、选型／解剖／适配／示例的组织方法，不照搬 SAP 视觉、API 或平台行为。
- 来源登记：SAP、Geist、OUDS 及经核实 Sail 相关公开资料的读取范围与缺证。Stripe Apps 不代表 Sail 全貌，公开资料不授予品牌资产复用许可。
- 尚未执行的验收清单：349 项文档用例及 18 项真实运行目标等既有记录不能换算通过率；以具体证据范围为准。
- D01-R1 修订证据：静态配对与可重算脚本不替代真实绘制验收。
- D01-R2 修订证据：默认
primary-200/300淡彩修订的来源、可辨性记录与重算账本；同样不替代真实绘制验收。
Teakit／Teasim 定位资料（Teakit 产品定位与边界、Teasim 产品定位与边界）仅提供背景，不自动指定 YUDS 实现承载项目。