面向AI助手的工具无关项目协作

概述

OGP（Open Collaboration Protocol）是一种开放协议，使AI助手能够跨不同工具和平台进行项目协作。用户可以保留自己喜爱的工具（Linear、Jira、Obsidian、GitHub、iCloud、本地文件等），同时通过OGP实现统一的协作体验。

核心功能

• 工具无关协作：不强制用户切换到特定工具生态系统
• 联邦架构：通过本地OGP守护进程连接对等代理
• 意图共享：在项目相关操作前主动协调多代理行动
• 本地优先：配置和状态存储在用户本地（~/.ogp*）

前置要求

• 安装OGP CLI：

   npm install -g @dp-pcs/ogp
   

• 启动OGP守护进程：

   ogp daemon start
   

• 配置对等代理：

使用场景

跨工具项目同步

当您在任意已连接的协作工具中更新项目状态时，OGP会自动将变更同步到其他工具。

多代理协调

在执行复杂任务前，OGP会主动联系对等代理，确认是否有相关上下文或并行任务需要协调。

本地文件集成

支持将本地文件系统作为项目数据源之一，便于使用Obsidian等本地优先工具。

配置

peers.json

{
  "peers": [
    {
      "id": "peer-alice",
      "endpoint": "https://alice.example.com/ogp",
      "trusted": true
    }
  ]
}

项目配置

在项目根目录创建 .ogp/config.json：

{
  "project": {
    "name": "my-project",
    "tools": ["github", "linear", "obsidian"]
  }
}

安全注意事项

• 仅添加您信任的对等代理
• 定期检查peers.json配置
• 了解网络联邦调用的隐私影响
• 可在需要时禁用自主调用

故障排除

守护进程未启动

ogp daemon status
ogp daemon start

无法连接对等代理

• 检查网络连接
• 验证对等端点URL
• 确认对等代理在线

配置问题

使用 ogp doctor 命令诊断配置问题。