🦀 ClawHub
Semantic Circuit Breaker
by @kingofzhao
Protect downstream services by monitoring semantic content quality and triggering circuit breaks based on semantic drift, inconsistency, factual errors, or t...
TERMINAL
clawhub install semantic-circuit-breaker📖 About This Skill
Semantic Circuit Breaker
> 语义熔断器:基于内容语义而非错误率的服务保护机制。
何时使用
核心认知
1. 传统熔断看状态码,语义熔断看内容
传统Circuit Breaker基于HTTP状态码和超时率。但当LLM API返回200但内容是幻觉、偏见、或语义偏移时,传统熔断完全无效。语义熔断触发条件:
2. 三态模型(扩展传统熔断)
区别:转换条件不是"错误率"而是"语义距离"。
3. 语义距离计算
def semantic_distance(responses, baseline):
"""计算响应集合与基线的语义距离"""
embeddings = embed(responses) # 句向量
baseline_emb = embed(baseline)
# 余弦距离
cosine_dist = 1 - cosine_similarity(embeddings.mean(axis=0), baseline_emb.mean(axis=0))
# 方差(一致性)
variance = embeddings.std(axis=0).mean()
# 事实性(与知识库比对)
factuality = verify_against_kb(responses)
return 0.4 * cosine_dist + 0.3 * variance + 0.3 * (1 - factuality)
碰撞来源
circuit-breaker-pattern × semantic-diff-engine × llm-output-validatorsemantic-cache-layer(语义计算)× adaptive-circuit-breaker(自适应熔断)