当三方库完成适配、回归和来源核查后，工程往往还面临一个更难回答的问题：候选能力究竟应在什么条件下接管现有业务，又该在什么条件下迅速退出。直接把依赖版本从一个整数改成另一个整数，无法覆盖跨模块引用、正在进行的异步请求、静态资源回退和后续维护账目。LibraryBridge的前七篇已经把这些事实拆成独立记录，收尾时需要把它们重新连接为一条可执行的决策链。

当前稳定记录为@ohos/lottie解析版本2.0.0，声明约束为^2.0.0，本地bridge_utils依旧位于file:../bridge_utils；候选记录2.1.0的五项契约回归中四项通过，一项错误映射处于REVIEW。两条许可证登记仍为PENDING，依赖画像revision=1，资源租约已经在epoch=6收敛，活动租约数为零，asset-hero可沿用STATIC_POSTER。这些值共同要求候选门禁维持HOLD，业务选择继续指向稳定路径。

一、先区分依赖安装与业务路径切换

oh-package.json5中的依赖声明参与构建，应用启动后的业务路由则选择工程内已有的接口实现；两者发生在不同阶段。华为开发者联盟的添加依赖项文档说明了生产依赖、本地模块以及不同依赖形式的构建处理规则。对于LibraryBridge，AnimationBridge应继续暴露稳定调用契约，RegistryAnimationAdapter承接已经集成的实现，静态海报由独立的展示适配器承担。切换一个路由标识不会自动替换安装包里的第三方库字节，因此版本候选与业务分组不能共用同一个字段。

灰度策略至少保存profileRevision、baselineResolved、candidateResolved、candidateGate、candidatePercent和policyRevision。前四项解释所比较的依赖记录，比例用于决定业务访问路径，策略版本用于阻止旧配置覆盖较新决策。考虑到此刻候选尚有两类待复核事项，实际工作台策略应令候选比例为零。即使某个客户端被划入候选分组，尚未满足门禁也必须返回稳定路径；分组归属不具有跨越质量检查的优先权。

const profile = {
  project: 'LibraryBridge', revision: 1,
  dependency: '@ohos/lottie', declared: '^2.0.0',
  baseline: '2.0.0', candidate: '2.1.0',
  local: 'file:../bridge_utils', errorMapping: 'REVIEW',
  licenses: ['PENDING', 'PENDING'], activeLeases: 0,
  leaseEpoch: 6, fallback: 'STATIC_POSTER'
};
const policy = { revision: 8, candidatePercent: 0, state: 'HOLD' };
function selectRelease(p, rule) {
  const eligible = rule.state === 'READY' &&
    p.errorMapping === 'PASS' &&
    p.licenses.every(item => item === 'ACCEPTED');
  return eligible ? 'CANDIDATE_ELIGIBLE' : 'BASELINE_RETAINED';
}
console.log(selectRelease(profile, policy));

二、让分组保持稳定而非随页面重排

当门禁通过且运维策略允许扩展流量时，可以使用稳定的业务分组键计算落桶，而不依赖列表位置、当前时间或随机一次的页面状态。对同一分组键，计算结果应当稳定；对不同用户，不应把明文手机号、设备标识或完整用户资料放进审核记录。项目可以由已有的分组服务提供不可逆化后的短标识，并限定保留周期。落桶是产品侧策略的一部分，不应与系统设备类型、屏幕宽度直接捆绑：宽窗口与紧凑窗口是否使用动画，仍由第四篇的能力策略独立判断。

百分比配置变更也不能跳过质量门禁。例如候选比例从零提升为五，必须先完成许可证通知项、错误类型映射和相应契约回归，再更新策略版本。新比例变更只有在规定的生效时点后才被新的业务会话读取。已经启动的租约保留自身版本和代次，避免一半的操作采用旧适配器、一半采用新适配器。下面的纯数据函数只计算分组，不负责依赖安装、设备探测或后台发布。

function bucketOf(key) {
  let hash = 2166136261;
  for (const ch of String(key)) {
    hash ^= ch.codePointAt(0);
    hash = Math.imul(hash, 16777619);
  }
  return (hash >>> 0) % 10000;
}
function routeFor(key, rule, gates) {
  if (rule.state !== 'READY' || gates.some(x => x !== 'PASS')) {
    return 'BASELINE';
  }
  const pct = Math.max(0, Math.min(100, rule.candidatePercent));
  return bucketOf(key) < pct * 100 ? 'CANDIDATE' : 'BASELINE';
}
const gates = ['PASS', 'PASS', 'PASS', 'PASS', 'REVIEW'];
console.log(routeFor('cohort:asset-hero', {state:'HOLD',candidatePercent:0}, gates));

三、回退先冻结入口，再处理旧异步会话

回退容易出错的地方不是把按钮切换为“稳定版”，而是旧调用仍在排队。第五篇为资源租约定义了ACTIVE、CANCELING、RELEASED等状态，先停止新任务派发，再让租约代次失效，等待业务回调收敛，最后释放关联对象。收尾策略直接沿用这个顺序。遇到需要退出候选路径的条件时，控制器先把目标版本冻结，再增加epoch，使旧响应无法写回新页面。asset-hero的静态海报单独保存，不随动画对象一起丢弃。

触发回退的条件应可解释，包括候选异常比例持续越阈、关键错误类型变更、资源释放失败或配置撤销。阈值需要记录统计口径、时间窗口与最小样本量，不可以把一次偶发失败直接说成整体质量下降。当前还没有候选业务流量，因而回退控制器主要承担防误入与保持基线的工作。对于已产生副作用的任务，还需保证业务幂等键及完成结果的去重，单靠取消信号无法撤销已经提交的数据。

class RouteController {
  constructor() {
    this.epoch = 6;
    this.state = 'BASELINE_RETAINED';
    this.activeLeases = 0;
    this.posterRoute = 'STATIC_POSTER';
  }
  freezeAndRollback(reason) {
    if (this.state === 'BASELINE_RETAINED') {
      return { state: this.state, reason, epoch: this.epoch };
    }
    this.state = 'ROLLING_BACK';
    this.epoch += 1;
    this.activeLeases = 0;
    this.state = 'BASELINE_RETAINED';
    return { state: this.state, reason, epoch: this.epoch };
  }
  acceptCallback(callbackEpoch) {
    return callbackEpoch === this.epoch && this.state === 'CANDIDATE';
  }
}
const controller = new RouteController();
console.log(controller.freezeAndRollback('GATE_HOLD'));

四、不要让维护台账反过来修改业务结论

审查记录与运行策略要解耦。维护台账可以记录候选版本、依赖来源、摘要范围、许可证文本位置、错误映射对照及处理人，但不应因为有人更新了备注就自动放行候选。状态变更应当由门禁计算器汇总所有已签收的检查项，再生成新的不可变策略快照。对于同一候选，如果许可证从PENDING推进到REVIEW，原有错误映射问题仍然存在，整体状态不会因为页面颜色变化而成为READY。

还要把成本和可维护性写入长期决策。每增加一个适配器版本，测试矩阵会增长；老客户端是否还引用旧契约、不同模块是否复用相同依赖、错误分类是否保持一致，都影响继续保留多套实现的价值。维护策略可为每个版本标记SUPPORTED、SUNSET_REVIEW或RETIRED，但退役必须先确认仍在使用的业务路径、资源生命周期和迁移计划。已归档的稳定版本记录不能因为候选升级取消就被删除。

五、把锁文件和依赖树纳入持续复核

开发环境中可以利用华为的ohpm list命令核对已安装的依赖树，并依据官方ohpm clean文档理解清理安装目录与保留锁文件的区别。持续复核应同时保存声明范围、锁定结果和受控内容摘要，不能只看一个显示出来的版本数字。远端包与file:../bridge_utils本地依赖的来源规则不同，需分别建立追踪字段。

当本地模块目录发生变更时，清单需要更新其内容快照，而不是把相同路径当作相同文件。许可证记录同样遵循来源隔离原则：确认的软件分发条件与功能适配状态各有负责人，不应为了使版本升级显示为绿色而填入未经核对的许可名称。版本约束和构建模式还应与Hvigor配置一起复查，避免开发依赖与生产依赖误配造成包体差异。

六、界面必须把当前保留与未来方案区分开

业务页可以同时展示“当前决定”和“以后怎样放行”，但应避免把候选版本号当作已经启用的版本。LibraryBridge此刻的有效状态为稳定版本2.0.0、候选2.1.0、HOLD、稳定路径100%、候选路径0%。许可证待办为两项，错误映射仍有一项REVIEW；活动租约为零，资源代次保留6，STATIC_POSTER可用于动画不可用时的展示。页面提供“查看阻塞原因”“维护策略记录”和“回到稳定路径”等操作，避免使用含糊的成功提示。

当策略发生较新变更，旧页面提交需要携带其读取到的policyRevision。服务端或持久化层比较版本后决定接受与否，以免运维人员甲已经冻结候选，运维人员乙的旧表单又把候选比例写回。即使采用本地配置文件，也要先写入临时记录、校验再替换有效配置，失败时保留最近一个可用的策略版本。路由与许可检查的每一次决定都要可追溯，但记录中应避免存放用户身份明文与第三方访问凭据。

七、以可恢复的稳定状态结束工程主线

这套连载从依赖画像开始，逐步建立模块隔离、异步结果、跨端选择、租约取消、升级回归和供应链清单，最终用灰度门禁把各环节接起来。当前最合理的结果并非强行启用2.1.0，而是保留2.0.0基线，并将待办事项作为后续升级条件。以后完成错误映射和许可证复核后，可生成新的策略快照，先进行小比例观察，再按预设阈值评估是否扩展分组。

对于业务使用者，核心接口继续保持稳定，动画不可用时保留静态海报；对于维护者，依赖来源、实际版本、候选评估、回退触发与资源收敛均有明确记录。只有把“已集成的代码”“允许走的业务路径”和“候选升级资格”区分清楚，第三方库治理才能在版本变化时继续可靠运行。