配置发布前为什么要做差异预览？

简化版

差异预览让提交者和审批人确认“哪些键从什么值变成什么值、影响哪些作用域”，用于发现误删、错环境、格式变化和超大范围变更。好的 diff 不是简单文本对比：结构化配置要按键比较、稳定排序、识别类型变化，并对敏感值脱敏。 diff 只能降低风险，不能替代 schema、语义校验、灰度和回滚。

预览以提交时的 baseVersion 与候选版本比较，并展示目标环境、租户、命名空间、实例范围和最终合并结果。审批期间基线若变化，必须阻止发布并重新生成差异，避免覆盖并发变更。

JSON/YAML 等结构化内容应解析后按路径展示新增、删除、修改和类型改变。敏感项显示“已替换”及密钥版本，不展示明文。系统同时执行范围、枚举、跨字段和引用完整性检查，把机器结论与人工意图审查放在一起。

审查者需要知道变更内容、目标对象、潜在爆炸半径以及是否可回滚。只展示新文件无法快速发现删除项，只展示文本行也可能被格式变化淹没。

有效预览是“内容差异 + 作用域差异 + 风险提示”，而不只是一块红绿文本。

YAML 调整缩进或键顺序可能产生大量文本差异，但语义没有变化。解析后按字段路径比较，可以突出真正改变的值和类型。

重复键、锚点和自定义标签要按所用解析器的真实语义校验。

用户基于 v120 编辑，审批期间别人发布了 v121。若仍把候选内容覆盖上去，可能把 v121 的改动悄悄抹掉。提交单携带 baseVersion，并使用乐观锁。

publish(candidate, base=120)
current == 120 ? commit : reject_and_rediff

冲突时重新基于当前版本合并、预览和审批。

配置可能有全局、环境、集群、租户和实例多层覆盖。仅展示某一层源文件不足以说明运行结果。预览应同时展示修改层和选定目标的最终合并值，并标明值来自哪一层。若删除租户覆盖后将回落到全局默认，也要明确显示回落结果。

密码、令牌和私钥在界面、日志、通知与审计中都不能明文出现。 diff 可显示 secretRef、密钥版本、是否发生替换和轮换时间。不能用固定前后缀泄露短密钥，也不应让浏览器先收到明文再用前端遮盖。需要明文读取时走单独的强认证、短时授权和审计流程。

预览旁展示 schema、类型、枚举、范围、跨字段约束和策略检查结果。例如 pool.min 不大于 pool.max，重试总预算不能超过上游 deadline。从 1 次重试改为 4 次虽然是合法整数，却可能让最坏尝试数从 2 倍变 5 倍。系统应给出容量提示，但最终业务意图仍由审批者判断。

大文件 diff 要限制大小、折叠未变区域并支持按路径搜索，不能截断后仍允许盲目发布。保存审批时看到的 diff 摘要和候选版本哈希，确保批准的内容就是最终发布内容。审计记录操作者、基线、候选、目标范围和校验结果。预览服务不可用时，高风险生产发布应失败关闭。