A.1-8 外部对接统一抽象 — REST 入口 + WS/MQ 协议适配 #31

New issue

Open

opened 2026-06-12 21:43:42 +08:00 by orion · 1 comment

orion commented

2026-06-12 21:43:42 +08:00

Owner

来源

Doc-Code Aligner 差距：外部对接 → v0.2 目标「先做 REST 入口」

现状

bixiweave/webhook/ 已有 Forgejo webhook 接收 + 处理（硬编码为 Forgejo 事件格式）
无统一的外部接口抽象

待做

ExternalAdapter(ABC) — 统一适配器接口（connect / disconnect / receive / send）
RESTAdapter — 作为第一个实现（FastAPI/Starlette），支持：
- POST /event — 投递事件到指定 Agent
- GET /status — 系统状态
- GET /agents/{id}/context — 查看 Agent 上下文
为 WS / MQ 预留适配器基类
Webhook 模块按 ExternalAdapter 重构

估时

大（2-3 天）

## 来源 Doc-Code Aligner 差距：外部对接 → v0.2 目标「先做 REST 入口」 ## 现状 - `bixiweave/webhook/` 已有 Forgejo webhook 接收 + 处理（硬编码为 Forgejo 事件格式） - 无统一的外部接口抽象 ## 待做 - [ ] `ExternalAdapter(ABC)` — 统一适配器接口（connect / disconnect / receive / send） - [ ] `RESTAdapter` — 作为第一个实现（FastAPI/Starlette），支持： - POST /event — 投递事件到指定 Agent - GET /status — 系统状态 - GET /agents/{id}/context — 查看 Agent 上下文 - [ ] 为 WS / MQ 预留适配器基类 - [ ] Webhook 模块按 ExternalAdapter 重构 ## 估时大（2-3 天）

orion commented

2026-06-12 23:20:36 +08:00

Author

Owner

评价

太大了，不适合当前库： 这本质是一个独立的 HTTP 服务（FastAPI 应用），不是一个库特性。

建议拆分：

当前 bixiweave 保持纯逻辑库
新建 bixiweave-server 仓库作为独立包（FastAPI + WS 适配）
或者直接集成到 bixiu 后端的 pipeline 模块中，不走独立服务

当前不做。

## 评价 **太大了，不适合当前库：** 这本质是一个独立的 HTTP 服务（FastAPI 应用），不是一个库特性。 **建议拆分：** - 当前 `bixiweave` 保持纯逻辑库 - 新建 `bixiweave-server` 仓库作为独立包（FastAPI + WS 适配） - 或者直接集成到 `bixiu` 后端的 pipeline 模块中，不走独立服务 **当前不做。**