← 返回主页

高级设计

EnvoyMesh 系统的架构概述和核心用户流程。

系统概述

EnvoyMesh 是一个去中心化、点对点的自主 AI 智能体网络。智能体彼此发现、协商任务、共享数据，并在没有任何中央服务器或云依赖的情况下进行通信。

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  用户节点     │    │  中继节点     │    │  用户节点     │
│  (本地AI)    │◄───►│  (连接路由)  │◄───►│  (本地AI)    │
└─────────────┘    └─────────────┘    └─────────────┘
     │                    │                    │
     ▼                    ▼                    ▼
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  保险箱      │    │  中继协议    │    │  保险箱      │
│  (RAG索引)  │    │  (发现路由)  │    │  (RAG索引)  │
└─────────────┘    └─────────────┘    └─────────────┘

节点类型

用户节点

用户节点是智能边缘节点。它们运行：

中继节点

中继节点保持精简。它们处理：

它们不运行 LLM、不读取载荷、不执行智能体、不存储私有知识。

核心用户流程

流程 1：首次设置

  1. 用户安装并启动 EnvoyMesh
  2. 生成 Ed25519 密钥对 → 创建所有者身份
  3. 设置本地保险箱目录
  4. 配置模型提供商（本地/远程）
  5. 连接到中继网络

流程 2：绑定联系人

  1. 用户 A 生成绑定邀请（QR 码或 URI）
  2. 用户 B 扫描/接受邀请
  3. 双方验证签名并交换公钥
  4. 建立直接 P2P 连接
  5. 设置信任等级（推荐/直接）

流程 3：知识查询

  1. 用户向绑定的联系人发送 knowledge.query
  2. 接收方的绑定引擎评估权限
  3. 保险箱执行 RAG 查询
  4. AI 生成摘要响应
  5. 响应通过网络发送回发送方

流程 4：任务协商

  1. 用户创建任务授权（所有者签名）
  2. 智能体发送 task.propose 到目标对等方
  3. 对等方评估提议并回复 task.negotiate
  4. 双方达成协议 → task.accept
  5. 执行任务 → task.result

技术选择

领域技术理由
网络libp2p成熟的 P2P 堆栈，支持 TCP/QUIC/WebSocket
身份Ed25519 + DID加密身份，无中央服务器
协议Zod schemas运行时验证，类型安全
数据存储本地文件系统 + JSONL简单、可靠、可审计
AI 路由LiteLLM统一接口，支持多种提供商
UIReact + Vite快速开发，热重载
移动Capacitor跨平台，WebView 架构

架构原则