OpenMed.life 网站例外注册表site-exceptions深度解析设计系统一致性治理、可访问性护栏与审查流程【免费下载链接】openmedLocal-first healthcare AI: clinical NER HIPAA PII de-identification that runs 100% on-device. 2,200 medical models, 21 languages, Apple MLX Python, no cloud, no patient data leaving your network. Apache-2.0项目地址: https://gitcode.com/GitHub_Trending/ope/openmed本文面向设计系统维护者、前端工程师与品牌治理负责人基于 OpenMed 仓库内的 site-exceptions.md 品牌治理文档展开。OpenMed 在 2026.07.0 版本建立了以 IBM Plex Sans/Mono、单一红色强调引擎#B0413E为核心的共享设计系统而site-exceptions正是该系统唯一的例外登记处它逐条列明 OpenMed.life 网站允许偏离共享规范的角色、精确作用域、护栏、责任人Owner与复查截止日期。读完本文你将掌握如何按注册表审查一个候选例外、如何为设计偏差配置可访问性护栏与自动化测试门禁以及如何把例外治理嵌入令牌→所有权→审查节奏→测试的完整闭环。一、背景为什么需要一个例外注册表OpenMed 的共享设计系统不是一份孤立的风格指南而是一套以仓库为唯一权威来源source of truth的令牌体系具体落地为tokens/colors.css冷调近白/蓝黑语义色板所有强调色相均由单一基础令牌--om-accent-base: #B0413E通过 OKLCH 相对颜色派生tokens/typography.cssIBM Plex Sans 与 IBM Plex Mono 作为共享字族Newsreader 仅是显式允许列表中的编辑例外tokens/surfaces.css圆角、间距、动效与扁平默认、仅终端可投影的层级策略tokens.json面向生成型消费者的平台中立角色定义与 CSS 强制保持等价。在这一基线之上site-exceptions.md 开篇便明确了共享系统的默认约束IBM Plex Sans 与 Mono、冷调临床风格表面、紧凑圆角、单一红色强调引擎、无装饰性渐变、克制的状态动效。同时它划出一条清晰的治理边界只有 OpenMed.life 的特定角色role被允许偏离这些默认值任何偏离都必须进入注册表登记而不是被默默实现。从 BRAND_SYSTEM_ROLLOUT_PLAN.md 的权威优先级authority precedence来看这条边界是有层级支撑的当前仓库的产品事实 7 月根令牌/品牌标记/共享内容规则 OpenMed.life 专属构图与例外 十张已批准社交导出图。例外注册表正是第三层的落地文件它决定了哪些构图细节可以越过共享系统存活。二、注册表全景七条受控例外注册表核心是一张七行例外表每行由例外名称、精确作用域Exact role、护栏Guardrail、责任人Owner、审查日期Reviewed、复查截止Review by六列构成。以下完整继承原表全部内容例外精确作用域护栏责任人审查日期复查截止Newsreader编辑数字editorial numerals、选定的社区/FAQ 展示文案、社交标题绝不用于正文、导航、控件、代码或文档散文Brand2026-07-292026-10-29旋转渐变词所有权ownershipHero 中的硬件词hardware word纯红回退不允许其他渐变文字Website2026-07-292026-10-29发布/星标胶囊仅限实时发布与星标元数据必须带可访问标签且数值由注册表registry背书Website2026-07-292026-10-29发布脉冲发布状态指示器在 reduced motion 下禁用不允许其他脉冲式装饰Website2026-07-292026-10-29合成 PHI 动画显式标注为合成的演示需要静态的有意义回退与 reduced-motion 状态Website2026-07-292026-10-29FAQ 过渡折叠面板展开/收起无 JavaScript 时内容仍可用Website2026-07-292026-10-29对比表溢出视口高度 ≤ 1080px 时的对比表例外在可键盘聚焦的横向滚动区域内保留 850px 内在表格其余所有布局断点一律使用 900pxWebsite/docs2026-07-292026-10-29几点关键观察所有例外均于2026-07-29品牌系统版本 2026.07.0 的建立日期完成审查并统一设定2026-10-29为复查截止与 ownership.md 规定的按review_by字段审查带日期声明节奏严格对齐例外是按角色role授权而不是按页面授权——每条都写了绝不never作用域例如 Newsreader 的护栏明确排除了正文、导航、控件、代码与文档散文责任人为 Brand、Website、Website/docs 三类与 ownership.md 的表面所有权表一一对应。2.1 Newsreader被围栏限制的编辑字体例外Newsreader 是共享系统中唯一的编辑衬线字族但它不是第三种全局 UI 字体。在 tokens/typography.css 中Newsreader 的font-face声明被显式的openmed-editorial-exception:start/openmed-editorial-exception:end注释标记包围并且通过unicode-range收窄到拉丁基础字符与常见排版符号集U0020-007E、连字符、弯引号、项目符号、省略号、上下标符号、± 与 ≤≥ 等避免它被误用于中文或其他脚本的正文渲染。这一定义在令牌层同样有据可查tokens.json 将editorial_exception声明为Newsreader并给出度量兼容的本地回退Newsreader Fallback → Georgiasize-adjust: 88.48%确保字体加载期间几乎无布局位移仅提供 Medium500与 MediumItalic 两个字重从源头上杜绝它在标题/正文层级上的滥用。从 BRAND_SYSTEM_ROLLOUT_PLAN.md 的决策记录看Newsreader 是刻意的 OpenMed.life 工件例外用于编辑数字、社区/FAQ 展示文案与社交标题绝不作为第三种全局字体族推广。它与注册表第三行发布/星标胶囊叠加使用社交标题可用 Newsreader但胶囊数值必须来自注册表且带可访问标签。2.2 旋转渐变词共享系统唯一的渐变共享系统默认无装饰性渐变但 OpenMed.life 的最终构图源在所有权 Hero 中明确定义了一个旋转渐变硬件词。注册表允许这条唯一例外同时施加两条硬性护栏纯红回退solid red fallback——在不支持渐变或用户偏好精简时必须回退到强调色不允许其他渐变文字——渐变只存在于这一个词上任何其他文本渐变都属于未登记偏离。该护栏与令牌层单一强调引擎设计一脉相承colors.css 中所有强调色accent / accent-strong / accent-bright / accent-deep / wash / 按钮背景都由--om-accent-base: #B0413E经 OKLCH 相对颜色派生任何私有强调色阶private accent shades都被 site-exceptions.md 明确列入全局禁止项。2.3 发布/星标胶囊与发布脉冲元数据的受控可视化共享系统默认禁用通用胶囊控件与除终端外的脉冲动效但 OpenMed.life 的实时发布/星标元数据与发布状态指示器获得了两条例外。它们的共同护栏是数据真实性胶囊只能承载实时发布与星标元数据且数值必须由注册表registry背书——对应 BRAND_SYSTEM_ROLLOUT_PLAN.md 中的声明注册表claims registry机制CI 离线校验已提交的声明快照动态指标使用保守取整值并附as_of日期任何网络刷新都是显式维护者动作脉冲指示器在prefers-reduced-motion下必须禁用。动效层面对此有直接证据surfaces.css 定义fast 160ms / standard 250ms / type 350ms三档时长与统一ease曲线并在media (prefers-reduced-motion: reduce)中将过渡与入场动效全部置为nonetokens.json 同步登记reduced: 0。这意味着脉冲只能以该动效体系内、且尊重系统减少动态偏好的方式实现。2.4 合成 PHI 动画隐私演示的边界OpenMed 的核心能力是临床 NER 与 PII 去标识化因此其网站上的 PHI 演示动画属于高风险视觉。注册表要求它必须被**显式标注为合成explicitly synthetic**演示提供静态的有意义回退——即使关闭 JavaScript演示区也要呈现有意义的代码/内容具备reduced-motion 状态。仓库内的证据链相当完整publication.yml 的 fixtures 段以data_policy: synthetic_only、indexing: noindex,nofollow、social_metadata: prohibited约束演示页明确演示数据只能为合成数据colors.css 定义了主题不变的--om-syntax-*令牌name/date/phone/location/id 五类实体的描边、背景、前景色专门服务于终端上的合成 PII 演示语法高亮BRAND_SYSTEM_ROLLOUT_PLAN.md 的基线审计明确记录动画 PHI 演示在prefers-reduced-motion下仍继续播放属于待修复缺陷浏览器矩阵要求JavaScript 禁用 reduced-motion两条路径都通过。这条例外与项目本地优先、隐私优先的定位直接相关演示可以动但必须是合成数据、必须可被关闭、必须不依赖网络。2.5 FAQ 过渡渐进增强的折叠交互FAQ 展开/收起过渡获得例外护栏是无 JavaScript 时内容仍可用。这意味着 FAQ 的折叠动画属于增强层而非内容载体。从 BRAND_SYSTEM_ROLLOUT_PLAN.md 的审计结论可以反推出实现要求FAQ 行必须是原生button而非可点击的div、暴露aria-expanded状态、可键盘操作、且禁用 JS 时最长答案不被max-height裁剪。这些要求与 WCAG 2.2 的键盘与名称/角色/状态name/role/state契约一致。2.6 对比表溢出唯一的非常规断点共享系统默认断点为900pxtokens.json 的mobile_breakpoint: 900但对比表在视口高度 ≤ 1080px 时获得溢出例外保留一张850px 内在宽度的表格并将其放入可键盘聚焦的横向滚动区域其余所有布局断点仍然强制 900px。这条例外在自动化门禁规划中被单独点名按 BRAND_SYSTEM_ROLLOUT_PLAN.md 新增门禁清单校验逻辑必须确保Newsreader、渐变、胶囊、动画与非 900px 断点仅出现在其精确的允许列表角色上包括 1080px 对比表溢出例外。换言之注册表中的每一条例外都会被测试精确匹配防止例外漂移成新的默认行为。三、红线清单任何例外都不允许触碰的禁区注册表在列出七条例外之后紧接着给出了反向约束——以下效果无论以什么名义都不得出现不允许任何例外引入模糊blur、玻璃拟态glass、纹理texture、悬停抬升hover lift、缩放动画scale animation、通用胶囊控件generic pill controls、装饰性页面渐变decorative page gradients或私有强调色阶private accent shades。这套红线的仓库证据包括层级elevationsurfaces.css 将默认层级定义为none仅终端表面使用--om-term-shadow色板封闭性colors.css 的全部强调色均从--om-accent-base派生且 BRAND_SYSTEM_ROLLOUT_PLAN.md 明确要求删除文档侧未登记的蓝色覆盖#4A92C8确保单一红色引擎不被稀释动效克制surfaces.css 只有一种标准过渡组合type-in动效仅用于打字场景任何缩放/脉冲/抬升动画都需要先在注册表登记。理解这条清单的关键在于例外是角色级授权而不是样式级放权。你可以在 Hero 里旋转一个渐变硬件词但不能给整个页面铺装饰性渐变你可以在 FAQ 上做折叠动画但不能给任意卡片加 hover lift。例外永远是最小化的、可测试的、有明确作用域的。四、新增例外的准入流程从默默改样式到登记在册注册表的最后一段定义了新增例外的硬性门槛。原文档原文要求新例外必须在使用前具备文档化的角色、可访问性护栏、责任人、审查日期以及自动化测试。也就是说一条新例外要进入系统必须同时满足五个条件文档化的角色documented role——它服务于哪个精确的表面角色而不是某个页面或某个组件实例可访问性护栏accessibility guardrail——如 reduced-motion 回退、无 JS 回退、键盘可聚焦、对比度达标责任人owner——按照 ownership.md 的所有权表落实到具体表面负责人审查日期review date——即注册表中的 Reviewed 列自动化测试automated test——例外必须被测试精确锚定避免漂移。这套流程与整个品牌治理体系是咬合的ownership.md 的变更协议第 5 条明确以登记已批准例外的方式替代静默添加字体、颜色、圆角、断点、动效模式或身份分配ownership.md 的审查节奏要求静态身份指南每年审查带日期声明按其review_by字段审查并在发布、运行时、许可或支持语言变更后立即复查逾期或未验证的声明应从公开文案中移除而非顺延——这正是注册表Review by: 2026-10-29的治理含义CHANGELOG.md 记录 2026.07.0 已注册受所有权与审查日期约束的有限网站编辑、渐变、元数据、动效、演示、FAQ 与溢出例外并要求未来条目必须识别令牌、资产、声明、消费者、迁移与验证影响且不得重写或删除已发布条目按 BRAND_SYSTEM_ROLLOUT_PLAN.md 的门禁规划迁移目标包含tests/unit/test_brand_system.py与scripts/brand/validate_system.py用于校验例外只出现在精确允许列表角色上并核验消费者 CSS 未引入未登记的原始强调色、字族或断点docs/brand/system/evidence/ 目录存放人工可访问性审查证据供门禁比对。五、例外注册表在品牌治理体系中的位置site-exceptions.md不是孤立文件它是 OpenMed 品牌系统docs/brand/system/治理闭环中的一环。整条链路如下tokens/colors.css · typography.css · surfaces.css · tokens.json │ 定义默认值 ▼ site-exceptions.md ──► 登记偏离默认值的 7 个角色及其护栏 │ ▼ ownership.md ──► 绑定表面负责人、变更协议、年度/按字段审查节奏 │ ▼ CHANGELOG.md ──► 版本化记录例外注册2026.07.0禁止重写历史 │ ▼ BRAND_SYSTEM_ROLLOUT_PLAN.md ──► 迁移顺序、权威优先级、自动化门禁 │ ▼ publication.yml ──► 发布路由/资产清单、合成数据策略docs/brand/** 被排除出 MkDocs 产物几个值得注意的系统性设计令牌是浏览器侧的权威来源BRAND_SYSTEM_ROLLOUT_PLAN.md 明确分割的 CSS 令牌是浏览器权威来源tokens.json必须对照 CSS 校验而非独立维护杜绝两份来源漂移例外不随网站部署自动生效docs/brand/**被列入 publication.yml 的 excluded 分类即这套治理文档是内部治理寄存器不直接进入 MkDocs 生成的公开站点社交像素例外是另一条独立路径site-exceptions.md管的是网站角色级偏离而社交导出图的烘焙文案baked copy例外记录在所有权与 rollout 文档中——它的任何变更都必须走修改源 DC 文件 → 重新导出 → 负责人审查 → 更新来源哈希流程绝不直接编辑 PNG两条例外通道互不混用。六、实操指南如何审查一条候选例外基于注册表与配套治理文档审查一条新例外的可执行清单如下第一步确认它属于角色而非样式偏好它是否对应一个可命名的表面角色如 Hero、FAQ、对比表、状态指示器是否能用一句话写清只在什么场景、什么内容类型下出现第二步对照红线清单做反向排除是否引入 blur / glass / texture / hover lift / scale animation / 通用胶囊 / 装饰性页面渐变 / 私有强调色阶命中任一项则直接拒绝除非单独登记。第三步为每个风险维度写护栏动效prefers-reduced-motion下是否完全禁用是否复用--om-transition/--om-motion-duration-*令牌无 JS内容在禁用 JavaScript 后是否完整可用FAQ、PHI 演示、胶囊数值键盘溢出区域是否可键盘聚焦滚动控件是否有可访问名称与aria-expanded/aria-selected状态数据展示的数值是否来自声明注册表并带as_of日期而不是硬编码在模板里第四步登记五要素并测试锚定补齐角色、护栏、责任人、审查日期、自动化测试五项写入site-exceptions.md表格并分配Review by日期在门禁测试中精确匹配该例外的选择器/状态/断点确保它不会悄悄扩展到其他表面。第五步进入版本化发布在 CHANGELOG.md 记录新条目并声明其令牌、资产、声明、消费者、迁移与验证影响。结语OpenMed 的site-exceptions注册表展示了一种可落地的设计治理模式默认值靠令牌强制执行例外靠注册表显式授权两者之间用角色 护栏 责任人 复查日期 自动化测试五要素缝合。对于任何一个需要同时满足品牌一致性与产品灵活性的项目这套先登记、后偏离、到期复查、测试锁定的机制比单纯依赖设计评审会议更可审计、更可执行。若要继续深入可以进一步阅读仓库中的 voice.md声明与文案纪律、iconography.md标记与图标的平台角色分配以及 BRAND_SYSTEM_ROLLOUT_PLAN.md完整的网站/docs/社交迁移计划与门禁矩阵。【免费下载链接】openmedLocal-first healthcare AI: clinical NER HIPAA PII de-identification that runs 100% on-device. 2,200 medical models, 21 languages, Apple MLX Python, no cloud, no patient data leaving your network. Apache-2.0项目地址: https://gitcode.com/GitHub_Trending/ope/openmed创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考