结构变更哨兵SCHEMAWATCH-AI · 潮汐线
夜色海岸:湿沙上有一条青绿监测潮汐线,崖上有机房窗光

2026 · 契约海岸线

结构一退
下游就搁浅

结构变更哨兵(slug:schemawatch-ai)把 API/库表当潮汐线来测:拉取当前结构、对比提议版本、按策略包判定破坏性/高风险/兼容/新增,再路由到责任人审批。示意 v1.24.0 → v1.25.0:User 删除 email 为破坏性,需张磊审批后才能发布。静默变更拖垮下游时,要能指到字段,而不是事后对日志。本页写清需求、适用前提、如何工作和对岗位的价值。

需求 / 适用前提

没有差分和责任人,破坏性就是静默的

工作台的单位是快照与变更行。没有源、策略包和责任人路由,告警只能发到群里没人认。破坏性判定依赖策略包配置,不替代发布系统。

必须先有的材料

  • API / 库表源与版本快照
  • 字段、类型、鉴权、枚举
  • 策略包:何为破坏性
  • 资源责任人与团队
  • 下游依赖清单

谁在用

  • 平台负责人:破坏性闸
  • 接口 owner:差分与审批
  • 下游调用方:影响面
  • SRE:告警路由是否有人接

现在为什么对不上

  • 删字段没人拦,下游空指针
  • 类型收窄当兼容发了
  • 告警进大群,没有责任人
  • 策略口头,无法复盘

如何工作

拉取、差分、判定、路由

对应源码:源、差分、策略、告警、责任人、历史。时间线:快照 05-20 10:30 → 差异 14:21 → 影响 14:25 → 策略判定警告 → 路由审批进行中。示意 23 个影响:直接 8、间接 11、调用方 4。

  1. 拉取快照
  2. 对比差分
  3. 影响评估
  4. 策略判定
  5. 路由审批
  6. 发布闸
01 差分

当前版与提议版并排

删除字段、类型收窄、鉴权变更标成破坏性或高风险。新增可选字段走兼容。差分是证据,不是评论。

两份结构打印件并排,一页用琥珀色胶带标出被删字段
email 被删,要写在差分上,不能只写在合并说明里。
02 路由

破坏性必须到责任人,而不是大群

User 删除 email → 用户平台组张磊,状态待审批。高风险 Order.amount int→decimal 同样要人接。系统不自动发布。

运维室墙上海岸线图,一枚节点呈琥珀色,旁有路由夹板
潮汐线退了,要有人签字,不能让下游自己搁浅。

差分演练

点一条变更,看它过不过闸

示意 v1.25.0。静态部署路径为 /schemawatch-ai。打开工作台:apps.chatsoftware.cn/schemawatch-ai

对使用者的价值

静默变更不再把调用方拖垮

价值不在又一张结构图,而在破坏性有人审、告警有人接、策略可复盘。

平台负责人

破坏性计数和待审批队列在同一潮汐线上。

接口 owner

差分写清删了什么,而不是合并后再解释。

下游调用方

影响面可见,有时间改客户端。

SRE

告警路由到人,大群不再当垃圾桶。

边界

系统代劳的上限

破坏性判定依赖策略包配置。哨兵不代替发布流水线,也不自动改生产库。

  1. 不自动发布,破坏性必须人审。
  2. 策略包未覆盖的变更标不确定,不默认为兼容。
  3. 差分以拉取到的结构为准,口头约定不算快照。

进出角色

从哪进、从哪出

静态部署路径为 /schemawatch-ai。打开工作台:https://apps.chatsoftware.cn/schemawatch-ai/

进入

  • 源、快照、提议版
  • 策略包、责任人
  • 下游依赖

离开

  • 带判定的差分行
  • 待审批路由
  • 禁止发布的破坏性清单