R1.06.4multi-use promotion设计

提案需要先证明存在多个真实用例

别名: 多用例门槛 · N 个调用点 · promotion threshold · 升格

概念解释

共享库里的名字是公共维修对象。把它升格进去,等于让系统团队从此替所有调用方改缺陷、跟版本、配主题。一笔这样的承诺,需要用多个真实用例(multi-use promotion)来换:已经存在、或已经排进近期发布的若干调用点,而不是设计稿里的一处示意、也不是沙盒里的演示页。一条设置页上的特殊选择器,再精致也只是那一页的零件。

「真实」指生产路径上的界面,能打开、能被用户碰到。虚构的第三处用法不算。

机制

维护成本几乎不随调用点线性下降:文档、无障碍、主题矩阵、弃用公告,做一次是一份,做一百次还是这一份再乘回归。收益却随调用点上升——N 处共用,才摊薄那份固定成本。N = 1 时,共享库是在用公共编制补贴一个局部零件,还把这个零件的生命周期拉长到「公共对象」的量级。提案人最容易拿出的证据是「我们这页需要」。那只能证明局部痛,不能证明公共职责。要求先出示多处调用,是把「像不像原语」从口味之争换成可核对的清单:URL、仓库路径、即将合并的分支。

数字不是魔法。它过滤的是「尚未重复就被升格」的冲动,让结构在重复里显形,而不是在第一稿里被宣布。

边界

平台强制的基础件——复选框、焦点环、语义标题——在第一个产品出现之前就该存在,不必等三个调用点;它们的「N」来自平台契约,不来自本产品页面。探索性实验、限时活动、明确将删除的功能,即使出现了三处,也不该升格,以免把短命结构写成长期契约。反过来,两处已经在生产、第三处写在下个迭代且有排期的,可以按「即将为 N」处理,但第三处若两个迭代后仍未落地,应降回局部件。法律或品牌强制的唯一入口(例如全局同意横幅)可以是 N = 1 的合法公共件,前提是全产品只有这一处、且必须统一。

怎么落地

  • 提案模板要求列出至少两处已上线路径和一处可核对的近期路径:页面 URL 或仓库中的调用位置,而不是「类似的地方还会有」。
  • 评审时打开这些路径,确认它们真的在做同一件事,而不是标题相近、交互不同的三件东西被算成三次。
  • 未达门槛的请求允许以产品仓库局部件存在,并在记录里写「未升格原因:调用点不足」。
  • 验证:抽最近一个季度新进入共享库的组件,对每个组件数生产调用点。若超过三分之一只有一个真实调用点(演示站和文档页不计入),升格门槛没有在运转。对「即将第三处」做一次回头:到期未出现就从库中移出或标为试用,而不是默认转正。

延伸

  • 同组R1.06.1 需要明确谁可以新增组件 · R1.06.2 无治理的系统会退化为组件堆 · R1.06.3 贡献成本过高会导致绕过体系 · R1.06.5 评审关注接口而非实现细节 · R1.06.6 维护责任需随组件一起被接收
  • 相邻R1.02 组件库与变体 · R1.17 组件的过度抽象
  • 站内检索multi-use promotion · call sites · promotion threshold

同组卡片

快捷操作

分享

分享当前页面

ios_share

https://hci.top/zh/handbook/R1.06.4