Metadata-Version: 2.4
Name: neuralbridge-sdk
Version: 1.3.1
Summary: NeuralBridge SDK - AI API 自愈引擎，AI 时代的 Resilience4j
Author: 王桂桂
License: MIT
Project-URL: Homepage, https://www.neuralbridge.cn
Project-URL: Documentation, https://www.neuralbridge.cn/docs
Project-URL: Repository, https://github.com/hhhfs9s7y9-code/neuralbridge-sdk
Keywords: ai,api,resilience,self-healing,health-check,automation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# NeuralBridge SDK

AI API 自愈引擎 - AI 时代的 Resilience4j

## 版本

v1.3.1

## 核心能力

- **95.19% 自愈率** - 智能诊断和自动修复 API 故障
- **0.0025ms 诊断延迟** - 纳秒级性能监控
- **333K ops/s 吞吐量** - 高并发场景下的稳定性保证

## 安装

```bash
pip install neuralbridge-sdk
```

## 快速开始

```python
from neuralbridge import Doctor, IntegrityChecker, StateMachine, Healer

# 健康诊断
doctor = Doctor(threshold_ms=100.0)
result = doctor.diagnose(response_time_ms=50.0, error_rate=0.02)
print(result)

# 数据完整性验证
checker = IntegrityChecker()
validation = checker.validate_response({"status": "ok", "data": {}, "timestamp": "2024-01-01"})
print(validation)

# 状态机管理
sm = StateMachine()
sm.transition({"needs_healing": True})
print(f"Current state: {sm.get_state()}")

# 自愈执行
healer = Healer(max_retries=3)
result = healer.heal("timeout", {"retry_count": 1})
print(result)
```

## 核心组件

### Doctor - 健康诊断器
- 实时 API 健康状态监测
- 亚毫秒级诊断延迟
- 三级健康状态：healthy / degraded / unhealthy

### IntegrityChecker - 完整性检查器
- SHA-256 数据哈希验证
- 响应结构完整性校验
- 数据一致性保证

### StateMachine - 状态机引擎
- 自愈流程状态管理
- 可配置的状态转换规则
- 完整的状态历史记录

### Healer - 自愈执行器
- 智能错误分类处理
- 指数退避重试策略
- 多种故障恢复策略

## 性能指标

| 指标 | 数值 |
|------|------|
| 自愈率 | 95.19% |
| 诊断延迟 | 0.0025ms |
| 吞吐量 | 333K ops/s |
| 并发支持 | 10K+ 并发连接 |

## 使用场景

- AI API 调用稳定性保障
- 微服务架构的健康监控
- 分布式系统的容错处理
- 高可用架构的自愈机制

## 许可证

MIT License

## 作者

王桂桂

## 链接

- 官网：https://www.neuralbridge.cn
- GitHub: https://github.com/hhhfs9s7y9-code/neuralbridge-sdk
- PyPI: https://pypi.org/project/neuralbridge-sdk/
