可瑞沃技术社区

Correctover 中文开发者社区 — SDK 文档、实战教程、常见问题与技术讨论

pip install correctover
6维
合约验证
22µs
P50 延迟
84
自愈规则
949ms
L3 Failover
📚 SDK 文档
🚀

快速开始

5 分钟完成 Correctover SDK 集成,为你的 LLM API 调用加上6维合约验证与自动故障转移

# 安装 pip install correctover # 国内镜像加速 pip install correctover -i https://pypi.tuna.tsinghua.edu.cn/simple # 使用 from correctover import Correctover, Contract client = Correctover( api_key="your-openai-key", contract=Contract.all_dimensions(), failover=True )
查看完整文档 →
📋

6维合约验证

Structure / Schema / Latency / Cost / Identity / Integrity — 6个维度全面验证 LLM API 响应可靠性

contract = Contract( structure={...}, # 结构验证 schema={...}, # 模式验证 latency_sla="2s", # 延迟SLA cost_budget=..., # 成本验证 identity_check=True, # 身份验证 integrity=True # 完整性验证 )
BYOK 架构说明 →
🔄

故障转移

合约违约时自动切换 Provider,新 Provider 响应同样经过6维验证。Failover ≠ Correctover

client = Correctover( api_key="your-key", failover=True, failover_providers=["openai", "anthropic"] ) # 自动验证 + 自动故障转移 response = client.chat.completions.create( model="gpt-4", messages=[...] )
自愈架构详解 →
🔑

BYOK 直连

Bring Your Own Key — 你的密钥,直连 Provider,不经手第三方。零中间人、零数据泄露风险

# 你的密钥直接连接 Provider client = Correctover( api_key="your-openai-key", # 直连 # 不做 Token 中转/分销/加价转卖 # 你的数据不经我们的服务器 ) # 支持 Python 3.8+,仅依赖 httpx
BYOK 原理 →
🔧 实战教程
🏗️

生产环境最佳实践

如何正确配置6维合约、选择故障转移策略、设置检查点恢复,确保 LLM API 在生产环境中的可靠性

阅读教程 →
🔍

漂移检测实战

Provider 静默换模型的识别与应对 — 0.7% 的生产调用中会发生模型替换,你的系统能检测到吗?

阅读教程 →

性能优化指南

MAPE-K 决策引擎 P50=22µs 的实现原理,以及如何在极低开销下实现6维验证

阅读教程 →
🛡️

从零搭建自愈层

7个关键架构决策:集中式 vs 分布式决策、规则引擎 vs ML、BYOK vs Token 中转…

阅读教程 →
常见问题
Correctover 和普通 Failover 有什么区别?
普通 Failover 只是在超时/错误时切换 Provider,不验证新 Provider 的响应是否正确。Correctover 在切换前后都进行6维合约验证,确保你拿到的响应是真正可靠的。Failover ≠ Correctover。
6维合约验证会影响性能吗?
几乎不会。MAPE-K 决策引擎 P50=22µs,P99=99µs,总开销 < 0.01%。验证发生在本地,不增加额外的网络请求。
BYOK 是什么意思?我的数据安全吗?
BYOK = Bring Your Own Key。你的 API 密钥直接连接 LLM Provider(OpenAI/Anthropic等),不经过我们的服务器。我们从不做 Token 中转、分销或加价转卖。你的数据完全在你和 Provider 之间传输。
支持哪些 LLM Provider?
支持所有 OpenAI 兼容的 API 接口,包括 OpenAI、Anthropic、DeepSeek、智谱等。只要 Provider 的 API 格式兼容 OpenAI,就可以直接使用。
漂移检测是什么?
漂移检测(Drift Detection)是指识别 Provider 静默更换模型的行为。实测数据显示约0.7%的生产调用中,Provider 返回的模型与请求的模型不一致。Correctover 的 Identity 验证维度可以捕获这种情况。
pip install 安装很慢怎么办?
使用国内镜像加速:pip install correctover -i https://pypi.tuna.tsinghua.edu.cn/simple
支持哪些 Python 版本?
Python 3.8+。仅依赖 httpx,无其他重型依赖。
有 Go/Java/JavaScript SDK 吗?
Go/Java/JS SDK 暂未上架包管理仓库,如需多语言客户端请联系官方获取源码包。
License 是什么?
Apache-2.0 WITH commercial-restriction。核心 SDK 开源,商业使用需遵循许可条款。
📝 更新日志
v1.1.02026-06-25
  • 37个模块 + benchmark子包,100个公开API导出
  • 新增 CircuitBreaker 熔断器模块
  • 新增 benchmark 子包:性能基准测试工具
  • 依赖精简至 httpx + aiohttp
  • SDK体积优化至 308KB
  • 全量 .pyc 编译闭源保护
  • Proprietary Commercial License
v1.0.12026-06-20
PyPI 正式发布 — 6维合约验证 + 自动故障转移 + BYOK 直连 + 漂移检测 + 检查点恢复
v1.0.02026-06-15
首个正式版 — 完整6维合约验证引擎、MAPE-K 决策引擎、84自愈规则
v0.1.02026-05-01
Alpha 内测版 — 基础合约验证与故障转移能力
💬 社区
🐙

GitHub

源码、Issue、PR — 欢迎贡献自愈规则和新的验证维度

github.com/correctover →
🐦

Twitter / X

关注 @Whatqw4u 获取最新动态和技术分享

@Whatqw4u →
📝

Dev.to

LLM Reliability 系列技术文章,深度解析 API 可靠性架构

LLM Reliability 系列 →
📧

邮件联系

商务合作、技术咨询、企业定制

wangguigui@correctover.com