Metadata-Version: 2.4
Name: rvp-sdk
Version: 0.2.5
Summary: Real-Virtual Agents Network Framework
Project-URL: Homepage, https://github.com/haichuan/rvp
Project-URL: Issues, https://github.com/haichuan/rvp/issues
Author-email: rvp Team <rvp@haichuan.cn>
License: MIT
Keywords: RVP,RVP Protocol,RVP SDK,Real-Virtual Agents Protocl Framework
Requires-Python: >=3.10
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: opentelemetry-api>=1.33.0
Requires-Dist: opentelemetry-sdk>=1.33.0
Requires-Dist: pydantic>=2.11.3
Requires-Dist: rich
Requires-Dist: sse-starlette>=2.3.3
Requires-Dist: starlette>=0.46.2
Requires-Dist: websockets>=13.0
Provides-Extra: dev
Requires-Dist: datamodel-code-generator>=0.30.0; extra == 'dev'
Requires-Dist: mypy>=1.15.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.26.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.1.1; extra == 'dev'
Requires-Dist: pytest-mock>=3.14.0; extra == 'dev'
Requires-Dist: pytest>=8.3.5; extra == 'dev'
Requires-Dist: ruff>=0.11.6; extra == 'dev'
Requires-Dist: uv-dynamic-versioning>=0.8.2; extra == 'dev'
Description-Content-Type: text/markdown

README.md

---

## 🚀 快速开始

---

## 🧪 CLI 命令

```bash
RVP clean       # 清理临时文件
RVP setup       # 安装依赖
RVP --help      # 查看可用命令
```
 ## 🧱 协议架构
<img src="./docs/image/rvp.png" alt="RVP 架构" />

## 🧱 项目结构

```
rvp/                            # RVP Framework Root / RVP框架根目录
├── docs/                                 # Documentation / 文档
│   ├── specifications/                   # Protocol specifications / 协议规范
│   └── api_reference/                    # API reference / API参考
├── server/                                  # Source code / 源代码
│   ├── core/                             # Core components / 核心组件
│   │   ├── foundation/                   # Foundation communication / 基础通信
│   │   ├── elements/                     # Communication elements / 通信要素
│   │   ├── processes/                    # Communication processes / 通信流程
│   │   ├── mechanisms/                   # Interaction mechanisms / 交互机制
│   │   ├── security/                     # Security components / 安全组件
│   │   └── applications/                 # Application layer / 应用层
│   ├── functional_units/                 # Functional units / 功能体
│   │   ├── protocol_applications/        # Protocol applications / 协议应用
│   │   ├── comm_security/                # Communication security / 通信安全
│   │   ├── interaction_mechanisms/       # Interaction mechanisms / 交互机制
│   │   ├── comm_processes/               # Communication processes / 通信流程
│   │   ├── comm_elements/                # Communication elements / 通信要素
│   │   └── basic_comm/                   # Basic communication / 基础通信
│   ├── capability_management/            # Capability management / 能力管理
│   │   ├── platform_compatibility/       # Platform compatibility / 平台兼容
│   │   ├── protocol_adaptation/          # Heterogeneous protocol adaptation / 异构协议适配
│   │   ├── protocol_extension/           # Protocol extension / 协议扩展
│   │   └── protocol_registration/        # Protocol-less registration / 元协议注册
│   ├── sica/                             # SICA security framework / SICA安全框架
│   │   ├── did/                          # DID implementation / DID实现
│   │   ├── security_policies/            # Hierarchical security policies / 层级安全策略
│   │   ├── composite_identity/           # Composite identity / 复合身份
│   │   ├── oauth2/                       # OAuth2.0 implementation / OAuth2.0实现
│   │   ├── apikey/                       # APIKey management / APIKey管理
│   │   ├── tls_ssl/                      # TLS/SSL implementation / TLS/SSL实现
│   │   └── e2ee/                         # End-to-end encryption / 端到端加密
│   ├── asymmetric_comm/                  # Asymmetric communication / 不对等通信
│   │   ├── external_constraints/         # External comm constraints / 外部通信约束
│   │   ├── protocol_switching/           # Dynamic protocol switching / 动态协议切换
│   │   ├── request_sending/              # Request sending / 发送请求
│   │   ├── streaming/                    # Streaming transmission / 流式传输
│   │   ├── state_sync/                   # State synchronization / 状态同步
│   │   └── async_operations/             # Asynchronous operations / 异步操作
│   ├── relationship/                     # Relationship recognition / 关系识别
│   │   ├── task_decomposition/           # Task decomposition / 任务分解
│   │   ├── hierarchical_routing/         # Hierarchical routing / 分层路由
│   │   ├── task_routing/                 # Task routing / 任务路由
│   │   ├── identity_recognition/         # Identity recognition / 身份识别
│   │   ├── task_management/              # Task management / 任务管理
│   │   ├── feedback/                     # Information feedback / 信息反馈
│   │   └── capability_negotiation/       # Capability negotiation / 能力协商
│   ├── task_objects/                     # Task objects / 任务对象
│   │   ├── resource_objects/             # Resource objects / 资源对象
│   │   ├── production_chain/             # Production relation chain / 生产关系链
│   │   ├── protocol_meta/                # Protocol metadata / 协议元
│   │   ├── message_objects/              # Message objects / 消息对象
│   │   ├── basic_data/                   # Basic data / 基本数据
│   │   ├── identity_elements/            # Identity elements / 身份要素
│   │   └── work_objects/                 # Work objects / 工作对象
│   ├── network_transport/                # Network transport / 网络传输
│   │   ├── http3_quic/                   # Ontology HTTP3+QUIC / 本体HTTP3+QUIC
│   │   ├── grpc/                         # Entity gRPC / 实体gRPC
│   │   └── a2amcp/                       # Virtual A2AMCP / 虚体A2AMCP
│   └── protocols/                        # Protocol implementations / 协议实现
│       ├── http/                         # HTTP implementations / HTTP实现
│       │   ├── sse/                      # Server-Sent Events / SSE
│       │   ├── mq/                       # Message Queue / 消息队列
│       │   └── websocket/                # WebSocket implementation / WebSocket实现
│       ├── oshttp/                       # OSHTTP protocol / OSHTTP协议
│       └── mott/                         # MOTT protocol / MOTT协议
├── configs/                              # Configuration files / 配置文件
│   ├── security/                         # Security configurations / 安全配置
│   ├── protocol_mappings/                # Protocol mappings / 协议映射
│   └── identity_profiles/                # Identity profiles / 身份配置文件
├── tests/                                # Test suites / 测试套件
│   ├── unit/                             # Unit tests / 单元测试
│   ├── integration/                      # Integration tests / 集成测试
│   └── performance/                      # Performance tests / 性能测试
└── examples/                             # Example implementations / 示例实现
    ├── smart_sanitation/                 # Smart sanitation example / 智慧环卫示例
    └── protocol_adapter/                 # Protocol adapter example / 协议适配器示例
```

---

## 🤝 贡献方式

我们欢迎开发者、研究人员和早期使用者的加入！

- 💬 通过 [GitHub Issues](https://github.com/your-repo/issues) 提出建议或反馈问题
- 📧 联系我们：[team@rvp.xyz](mailto:team@rvp.xyz)
- 📄 查阅我们的 [贡献指南](CONTRIBUTING.md)，了解如何参与贡献

---

## 📜 开源协议

本项目采用 [MIT License](LICENSE) 开源。

---
## ⚠️ 法律声明

RVP 是一个开源、无许可的技术框架，旨在支持去中心化智能体协作系统的构建。  
本项目的贡献者不运营、控制或监控任何已部署的智能体或其行为。  
使用本项目即表示您将为自己的行为承担全部责任。详情请参阅 [LEGAL.md](./LEGAL.md)。

---
<p align="center">
  Made with ❤️ by the <strong>RVP Team</strong><br />
  <em>Autonomy is not isolation. It's cooperation, at scale.</em>
</p>
