Schema-As-Code / Validation Toolkit

验证闭环 Validation Toolkit

三层验证工具:语义分级器 · JSON 输入 · 快照模板。证明"加了规则后有效"。

🎨 语义分级器 📋 JSON 输入 📄 快照模板

输入任意错误文案,自动诊断语义分级并给出约束建议。用于快速判断一个错误提示属于哪一级 severity。

请求过于频繁,请稍后再试
语义分级
快速测试: Error in message stream network error 请求过于频繁 Something went wrong

正常路径验证

限流提示 → 正确映射 retryable 级别

RETRYABLE

语义分级结果

限流/流控,用户可自助恢复

视觉:status.warning(黄色时钟 + 倒计时)

行动:等待倒计时 / 升级套餐

域归属校验通过

声明域:observational

引用绑定:status.warning

✓ 绑定合法,允许入库

字典规则树对账过程

Step 1:语义特征提取

关键词"频繁/限流/429" → 识别为 retryable 语义特征

Step 2:匹配 ERR-001 规则树

error_severity.retryable → color_token: status.warning

Step 3:域归属校验

status.warning 的 allowed_domains 包含 observational → 通过

Step 4:输出语义映射

黄色时钟图标 + 倒计时 + 升级入口 → 入库成功

越界路径验证

构造非法绑定 → cross_layer_ban 拦截

BLOCKED

构造的非法语义快照

{
  "component_type": "Alert",
  "visual": {
    "color": "red"
  },
  "copy": {
    "title": "Too Many Requests",
    "description": "请求过于频繁"
  },
  "context": "system_error"
}

⚠️ 越界点:限流场景(retryable)使用了 status.critical(致命红)

🚫 越域拦截结果

{
  "code": "CROSS_LAYER_BAN_VIOLATION",
  "message": "status.critical 不可用于 observational 域",
  "location": "semantic_tokens.error_severity.retryable.visual_mapping.color_token",
  "suggestion": "限流提示应使用 status.warning(黄色时钟 + 倒计时)",
  "domain": "observational",
  "binding": "status.critical",
  "ban_list": ["observational", "transactional"]
}

拦截链路追踪

Step 1:语义特征提取

关键词"频繁/限流" → 识别为 retryable 语义特征

Step 2:匹配 ERR-001 规则树

error_severity.retryable → 期望 color_token: status.warning

Step 3:域归属校验 → 命中 cross_layer_ban

实际绑定 status.critical → 查 ban_list:[observational, transactional] → 命中!

✗ 绑定越域,阻断入库

Step 4:返回修正建议

建议替换为 status.warning(黄色时钟 + 倒计时)

📖

字典规则树(内存结构)

编译期加载 contract/*.yaml 后生成的规则树

语义令牌:error_severity

fatal color_token: status.critical · motion_token: pulse.red.urgent · icon_token: alert.octagon · allowed_domains: [observational]
transient color_token: status.neutral · motion_token: spinner · icon_token: loader · allowed_domains: [observational]
retryable color_token: status.warning · motion_token: none · icon_token: clock · allowed_domains: [observational]
degraded color_token: status.info · motion_token: none · icon_token: info.circle · allowed_domains: [observational]

跨层禁止表(cross_layer_ban)

status.critical ban_list: [observational, transactional] → 禁止用于观察域和交易域
status.warning ban_list: [] → 无限制
status.info ban_list: [] → 无限制

验证结论

在演示环境中,语义分级器输入"限流提示"场景,输出 retryable 级别(status.warning:黄色时钟 + 倒计时);手动构造引用 status.critical 的输入,被判定为越域并返回修正建议。

域归属校验逻辑在单点成立。

正常路径
绑定合法,入库成功
越界路径
越域拦截,阻断入库
2
校验层级
编译期 + 安全层