# OIP开放互联协议 **Repository Path**: orginone/OIP ## Basic Information - **Project Name**: OIP开放互联协议 - **Description**: 开放互联协议（Open Interconnect Protocol, OIP） - **Primary Language**: TypeScript - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 4 - **Forks**: 3 - **Created**: 2026-06-23 - **Last Updated**: 2026-09-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 开放互联协议（OIP） 开放互联协议（Open Interconnect Protocol, OIP）是一个**基于网络实现权利流通的底层协议**。它将权限作为一等公民，使其能够像数据一样被标准化描述、在线传输、动态组合、可编程执行，并在此之上构建去中心化的流通与交易市场协议。 OIP 不是又一个数据互操作协议，而是**互操作的元协议**——它不关心数据以什么格式存储、通过什么通道传输，它只关心一件事：**谁有权对什么做什么，以及这个权利是怎么来的**。 [English](./README.en.md) | 中文 --- ## 什么是 OIP **一句话**：OIP 用一套开放协议统一"权利的发行、流转、验证与消亡"，让多个系统、组织、智能体和物理设备在同一套权利语义下互操作。 它解决的问题是：今天每一家平台、每一个组织都在用私有标准定义"谁有权做什么"，导致权利被锁在各自为政的系统孤岛中——数据难以跨平台流动、权限不可携带、协作依赖中心化审批。 OIP 通过**开放协议**（而非强制力）达成统一，就像 TCP/IP 统一了网络、HTTP 统一了万维网一样。 **给采纳方的中性技术价值**（与价值立场无关，可直接评估）： | 价值 | 含义 | | --- | --- | | **互操作成本降低** | 存量系统经适配连接器接入，免重构，低侵入 | | **协作效率提升** | 统一权利模型替代私有权限体系，减少点对点集成 | | **数据/流量资产归属明确** | 归属参与方而非平台，不被截留 | | **可迁移性** | 协议不绑定技术栈，降低供应商锁定风险 | | **渐进式部署** | 从单进程（形态 0）到集群（形态 V）按需升级 | --- ## 核心特性 - **权利即资产**：每一项权限都是可独立存在的数字资产，有自己的标识符、生命周期和所有权 - **委托链可追溯**：权限的每一次转移都有完整的链式记录，可验证、可审计 - **协议无关执行**：权限的验证和执行不依赖于特定平台、区块链或中心化服务 - **无中心依赖**：任何参与方按照规范实现协议即可互操作，无需双方预先约定 - **人人、智能体、物平等**：人类、AI Agent、IoT 设备使用同一套身份和权限体系。此"平等"指**身份层面的平等**——各类参与者都享有同等的 DID 身份与权利表达/流通能力，而非能力层面的对等；受限设备（如 8 位 MCU）可由边缘/网关代理参与，无需在设备端实现完整协议栈 - **默认拒绝**：任何未被显式授权的操作一律拒绝 - **市场中立**：协议不偏袒任何市场主体，流量数据归参与方所有，市场之间可互通 - **反供应商锁定**：协议只规定互操作要求，不绑定特定技术栈、平台或供应商 - **低成本适配**：通过智能体编程等机制，为现有应用和系统提供低侵入适配路径 - **实物虚拟统一**：实物资产与虚拟资产（软件、数据、服务等）使用统一流通协议 - **本地优先路由**：优先走本地或局域网，提升性能，降低网络延迟 - **求同存异**：协议统一互操作标准，但不规定内部治理方式，尊重各参与方的制度与文化差异 --- ## 快速理解 **场景一**：Alice 授权 Bob 读取她的传感器数据，Bob 可进一步委托给 Carol。 ```text Alice ──发行令牌──> Bob ──委托(收窄)──> Carol │ │ └── 委托链可验证 ─────┘ 权限只能收窄 不能扩张 ``` **场景二**：买家跨市场购买实物资产。 ```text Buyer ──发现──> Market-X + Market-Y ──要约──> Lister ──结算──> Settler ──交割权利Token──> Buyer ``` **场景三**：组织内部跨部门资源共享。 ```text 部门A ──挂牌──> 组织内部流通平台 ──发现──> 部门B └── 获得使用权Token (局域网优先路由，零公网延迟) ``` --- ## 协议架构 ```text ┌─────────────────────────────────────────┐ │ 应用层（Application） │ │ 商场、交易平台、共享平台、组织内部系统 │ ├─────────────────────────────────────────┤ │ 流程与市场触发层（Process & Market） │ │ 监管通道（审批流发行）+ 市场通道（交易）│ ├─────────────────────────────────────────┤ │ 智能体适配层（Agent Adaptation） │ │ 智能体编程、协议桥接、遗留系统适配 │ ├─────────────────────────────────────────┤ │ 市场流通层（Market Circulation） │ │ 资产挂牌、发现、撮合、结算、流量度量 │ ├─────────────────────────────────────────┤ │ 权限执行层（Enforcement） │ │ PDP / PEP / 策略决策与执行 │ ├─────────────────────────────────────────┤ │ 权限传输层（Transfer） │ │ 令牌发行、委托、撤销、验证 API │ │ 本地/局域网优先路由 │ ├─────────────────────────────────────────┤ │ 权利描述层（Description） │ │ RDL 权限建模与表达 │ ├─────────────────────────────────────────┤ │ 身份与信任层（Identity） │ │ DID / VC 去中心化身份 │ └─────────────────────────────────────────┘ ``` --- ## 系统架构与模块 OIP 的系统架构将协议落地为分层模块（详见 [OIP.md](docs/OIP.md)）： | L 层 | 模块 | 职责 | | --- | --- | --- | | L6 | OIP-React / OIP-Flutter / OIP-UniApp | 人机交互端 | | L5 | OIP-Agent | 智能体服务（AI 交互、工具沙盒、软件研发全链路） | | 底座 | OIP-GoInOne | 统一接入底座（认证代理、连接管理、服务注册表、业务插件化接入） | | L4 | OIP-Message | 消息分发中心（NATS 事件流） | | L4 | OIP-Accounting | 会计核算子系统（权利→财务转化，独立服务） | | L3 | OIP-Book | 认证服务端（OIP 协议核心：VET/PDP/转移法则/DID/存证） | | L2 | OIP-Data | 数据服务端（数据存储/变动/权限控制） | | L1 | OIP-IoT | 物联网服务（设备 DID、边缘 VET 缓存、协议转换） | --- ## 规范文档 以下是本仓库的文档体系（详见 [AGENTS.md](AGENTS.md)）： | 文档 | 类别 | 说明 | | --- | --- | --- | | [OIP-Protocol.md](docs/OIP-Protocol.md) | 协议规范 | OIP 协议核心（VET/转移法则/传输/REST API/市场/智能体适配） | | [OIP.md](docs/OIP.md) | 架构总纲 | V6 架构分层、模块协同、演进路线 | | [OIP-Book-Design.md](docs/OIP-Book-Design.md) | L3 设计 | 认证服务端（OIP 协议核心实现） | | [OIP-GoInOne-Design.md](docs/OIP-GoInOne-Design.md) | 网关设计 | 统一接入底座/业务服务插件化 | | [OIP-Data-Design.md](docs/OIP-Data-Design.md) | L2 设计 | 数据服务端（数据存储/变动/权限控制） | | [OIP-Message-Design.md](docs/OIP-Message-Design.md) | 消息分发设计 | 消息缓存/消费、事件流分发 | | [OIP-Accounting-Design.md](docs/OIP-Accounting-Design.md) | 会计核算设计 | 权利→财务转化，独立服务 | | [OIP-IoT-Design.md](docs/OIP-IoT-Design.md) | L1 设计 | 物联网服务 | | [OIP-Agent-Design.md](docs/OIP-Agent-Design.md) | L5 设计 | 智能体服务 | | [OIP-Frontend-Design.md](docs/OIP-Frontend-Design.md) | L6 设计 | 人机交互端 | | [OIP-Security.md](docs/OIP-Security.md) | 安全 | 纵深防御、威胁模型、合规映射 | | [OIP-Deployment.md](docs/OIP-Deployment.md) | 部署 | 形态体系、Docker Compose、K8s 集群、运维手册 | | [OIP-Glossary.md](docs/OIP-Glossary.md) | 术语表 | 权威术语定义 | | [architecture-review-report.md](docs/architecture-review-report.md) | 审计 | 架构评审报告 | --- ## 为什么需要 OIP **核心问题不是技术，而是权力结构**：当权利的"发行权""流转权""解释权"集中在平台手中，用户就失去了对自己权利的控制。你的数据你能访问吗？你的资产你能转让吗？你的权限你能带走吗？在中心化体系下，这些答案由平台决定，不由你决定。 互联网通过协议（TCP/IP、HTTP、SMTP）统一了网络、网页与邮件——协议不强制任何人效忠，但所有人都能基于它互通。OIP 以同样的方式统一**权利**的流通： - **对个体**：恢复对自己数据、权限、数字资产的控制权 - **对平台型企业**：打破垄断，促进市场竞争，流量数据归参与方 - **对发展中国家**：零门槛接入全球数字市场 - **对组织**：统一内部跨部门、跨法域的资源流通，局域网优先路由降低延迟 OIP 的使命是**还权于民，赋权于个体**——让每一个人都成为自己数字权利的主人；其愿景是**人人自主掌控数字权利的世界**。 **部署形态**决定你的接入成本（详见 [OIP-Deployment.md](docs/OIP-Deployment.md)）： | 形态 | 资源 | 定位 | | --- | --- | --- | | 形态 0 | 1 vCPU / 1 GB | 单进程 PoC，零外部依赖 | | 形态 IV | 8 vCPU / 16 GB | 服务器/Docker Compose 生产部署 | | 形态 V | 27.5 vCPU / 55 GB | K8s 集群全栈 | --- ## 中立性与全球治理 OIP 是开放的**互操作协议基础**，不输出价值观： - **不规定实现语言 / 技术栈 / 部署架构**：中心化、去中心化、混合部署均可 - **市场流量归用户**：由参与方自主记录，不被平台或国家垄断 - **不预设治理模式**：协议不内置对任何意识形态、政治制度或经济模式的偏好 就像 TCP/IP 不关心你传输什么内容，OIP 不关心你如何治理，只确保权利流通的标准统一。 --- ## 谁应该参与 - **市场主体**（商场、交易平台）：获得跨市场互通能力，不再被中心化平台锁定流量 - **超大组织与公共机构**：统一内部跨部门、跨法域资源流通，局域网优先路由零公网延迟 - **全球南方与发展中国家**：零门槛接入全球数字市场，最低成本获得同等流通能力 - **技术供应商 / SaaS 平台**：实现 OIP 协议，产品天然接入全球流通网络 - **智能体开发者**：开发可自主协商、交易、编排的智能体 - **数据与资产所有者 / 设备厂商**：将资产权利标准化、可流通 - **标准组织与学术界**：参与协议演进，贡献互操作测试用例 - **公民社会与公益组织**：参与协议治理，确保协议服务公共利益 --- ## 如何参与生态 OIP 的实现分阶段演进： ```text 阶段一：协议奠基 阶段二：市场连通 阶段三：智能体涌现 ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ 核心协议实现 │ ──────> │ 市场流通层 │ ──────> │ 智能体自主协作 │ │ 身份/权利/令牌│ │ 挂牌/发现/结算│ │ 协商/交易/编排 │ └──────────────┘ └──────────────┘ └──────────────┘ 参与方互通 流量回归用户 全网最优平衡 ``` 1. **实现协议**：按 [OIP-Protocol.md](docs/OIP-Protocol.md) 实现核心层（身份、权利描述、令牌、传输） 2. **接入市场**：实现市场流通层，搭建基于 OIP 的流通/交易市场 3. **提供适配**：为 ERP、CRM、电商平台等遗留系统开发适配连接器 4. **贡献生态**：贡献互操作测试用例、参考实现、推荐实践 --- ## 参与贡献 欢迎全球任何组织和个人参与贡献： 1. Fork 本仓库 2. 创建特性分支（`feat/xxx`） 3. 提交变更 4. 创建 Pull Request 贡献不仅限于代码——文档翻译、用例设计、互操作测试、场景验证同样重要。 --- ## 许可证 本项目采用 **GNU Affero General Public License v3 (AGPLv3)** 开源协议。 [![AGPLv3](https://img.shields.io/badge/License-AGPLv3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) AGPLv3 确保协议及其衍生实现保持开放——任何基于 OIP 的网络服务都必须公开其源代码，防止协议被私有化 fork 后形成新的锁定。协议采用 AGPLv3 是对开放精神的守护，确保没有人能独占公共基础设施。