# 第三方服务对接框架

ICE编号: AG-USER-04
优先级: P3·规划中
备注: 标准化对接协议·OAuth/APIKey/Webhook三种鉴权·铸渊现场写代码对接·适配器标准接口 | 前置: AG-ZY-01+AG-TEAM-05+AG-USER-03
状态: 待接力
负责人: 自由接单
预计周期: 4~6周

## AG-USER-04 · 第三方服务对接框架

### 定位

让人格体能够对接任何暴露了API的第三方软件。用户说「帮我接钉钉」→人格体自动完成全部技术工作→用户只点授权。

### 核心功能

- 标准化对接协议（不管接什么软件，走同一套流程）
- 三种鉴权模式适配：OAuth / API Key / Webhook
- 对接代码模板库（常见服务的预置模板，加速对接）
- 铸渊（编程人格体）现场写新对接代码的能力
- 适配器标准接口：send / receive / query / subscribe
- 适配器版本管理（API改版时铸渊自动更新）

### 完整流程

```
用户：「帮我把钉钉接进来」
  ↓
语言人格体：理解意图→拆解为技术需求→转发铸渊
  ↓
编程人格体（铸渊）：
  → 查钉钉API文档
  → 在用户代码仓库写对接代码
  → 配置鉴权·路由·错误处理
  → 部署到用户服务器
  ↓
弹出授权页→用户点授权→密钥写入（AG-USER-03）
  ↓
完成：以后用户说「发到钉钉群」→人格体直接调用
```

### 与现有架构的关系

- 插座协议v1.0（模块接入标准）→ 对接框架的底层规范
- GMP协议v1.0（模块注册/共享/校验）→ 适配器注册到模块注册中心
- 神笔马良MagicPen（AG-TEAM-05）→ 铸渊写代码的能力基座

### 前置依赖

- AG-ZY-01 铸渊部署（编程能力）
- AG-TEAM-05 神笔马良MagicPen（写代码的框架）
- AG-USER-03 密钥管理（对接需要密钥）

### 验收标准

- 预置服务（钉钉/微信等）：用户说一句话→5分钟内完成对接
- 新服务：铸渊读API文档→自动写代码→部署→用户授权→完成
- 适配器统一接口，任意适配器可热插拔