OIP（开放意图协议）
连接未连接的。让每个App AI都准备好了。 虚拟超级应用联盟的去中心化标准。
 ](./schemas/v1.0.0.json)
🌍 什么是OIP？
开放意图协议（OIP） 是一种标准化的JSON规范，允许任何应用程序（移动应用程序、网站或SaaS平台）向AI代理公开其功能，而无需复杂的后端集成。
通过托管一个简单 oip.json 文件，独立应用程序可以加入 开放意图联盟，有效地形成 虚拟超级应用。这允许用户通过符合OIP的客户端（如Oipia）通过自然语言控制他们最喜欢的应用程序，打破了围墙花园超级应用程序的垄断。
主要特点
- 零后端： 无需构建新的服务器。只需映射您现有的URL方案或API。
- 商业就绪： 内置支持 认证 和 联盟佣金.
- 多模式执行： 支持应用内WebView、无头API和原生深度链接。
______________________________________________________________________
🚀 运作原理
- 定义： 开发人员创建
oip.json描述其应用程序意图（操作）的文件。 - 主持人： 将文件放置在域根目录（例如。，
https://myapp.com/oip.json). - 发现： AI代理通过DNS或OIP注册表自动索引这些功能。
- 执行： 当用户表达意图时（例如“点咖啡”），AI会填充参数槽并立即启动应用程序。
______________________________________________________________________
🛠 协议规范（v1.0）
OIP定义由四个主要部分组成： 元, 认证, 联盟，以及 行动.
1.执行方式
OIP支持三种模式来平衡用户体验和兼容性：
| 模式 | 类型 | 描述 | 最适合 |
|---|---|---|---|
view | 网页视图 | 在Agent中打开一个弹出浏览器。用户在不离开聊天的情况下完成操作。 | 电子商务、食品配送、预订 |
data | API | 在后台发送静默HTTP请求。AI确认完成。 | 待办事项、日历、物联网控制 |
native | 深度链接 | 跳转到设备上已安装的本机应用程序。 | 导航、系统设置、本地应用程序 |
2.身份验证(auth)
通过要求用户凭据来保护您的操作。
- 类型：
none,api_key,bearer,basic. - 行为： 客户端将提示用户输入一次凭据，安全地存储它们，并将其注入后续请求中（Header/Query）。
3.联盟跟踪(affiliate)
将您的AI流量货币化。
- 机制： 自动将合作伙伴ID注入URL或API调用。
- 好处： 实现应用程序开发人员和代理平台之间的收入共享。
______________________________________________________________________
🆚 OIP与MCP
虽然 模型上下文协议（MCP） 侧重于将LLM连接到 *后端数据和工具*, 作战改进计划 专注于将AI连接到 *前端应用程序和用户体验*.
思考 MCP作为“终端” （服务器端，以数据为中心）和 OIP作为“浏览器” （客户端，以用户为中心）。
| 功能 | 🔌 MCP（模型上下文协议） | 🚀 OIP（开放意图协议） |
|---|---|---|
| 首要目标 | 提供上下文（读取文件、查询SQL）。 | 执行操作 （点餐，预约乘车）。 |
| 整合 | 高代码： 需要运行Python/Node服务器。 | 零代码： 只需托管一个静态 oip.json 文件。 |
| 执行 | 无头： 在背景中无形地运行。 | 视觉： 使用UI打开WebView或深度链接。 |
| 用户交互 | 仅基于文本的结果。 | 互动： 支持表单、确认和付款。 |
| 生态系统 | 面向开发人员和极客。 | 适用于消费者应用程序和SaaS。 |
| 变现 | 无 | 内置联盟和佣金跟踪。 |
💡 OIP增强： MCP在API调用时停止。OIP会加倍努力来处理 用户界面, 流量归因，以及 商业货币化，使其成为 应用联盟生态系统.
______________________________________________________________________
⚡ 完整示例
这是一个全面的 oip.json 假设的SaaS平台示例 “云工具”:
{
"oip_version": "1.0.0",
"app_meta": {
"name": "CloudTools",
"description": "Enterprise PDF and Image processing tools.",
"home_url": "[https://cloudtools.com](https://cloudtools.com)",
"icon": "[https://cloudtools.com/logo.png](https://cloudtools.com/logo.png)"
},
"auth": {
"type": "api_key",
"location": "header",
"key_name": "X-API-TOKEN",
"instructions": "Get your API Token from your Dashboard settings."
},
"affiliate": {
"enabled": true,
"mechanism": "query_param",
"param_name": "ref_id",
"default_value": "oipia_alliance"
},
"actions": [
{
"id": "compress_pdf",
"name": "Compress PDF",
"description": "Upload and compress a PDF file.",
"mode": "view",
"confirmation": "optional",
"target": {
"url_template": "[https://cloudtools.com/mobile/compress?level=](https://cloudtools.com/mobile/compress?level=){level}",
"method": "GET"
},
"parameters": [
{
"name": "level",
"description": "Compression level",
"type": "enum",
"options": ["low", "medium", "extreme"],
"mapping": {
"low": "1",
"medium": "2",
"extreme": "3"
}
}
]
},
{
"id": "check_usage",
"name": "Check Usage",
"description": "Check current API usage statistics.",
"mode": "data",
"target": {
"url_template": "[https://api.cloudtools.com/v1/usage](https://api.cloudtools.com/v1/usage)",
"method": "GET"
},
"parameters": []
}
]
}
______________________________________________________________________
🤝 贡献
我们欢迎为标准做出贡献！
- 分叉存储库。
- 编辑
schemas/v1.0.0.json. - 提交拉取请求。
由开放意图联盟维护。