Evolver代理路由端点完全参考/v1、/mailbox、/atp 全接口清单与新手速查指南【免费下载链接】evolverThe GEP-powered self-evolving engine for AI agents. Auditable evolution with Genes, Capsules, and Events. | evomap.ai项目地址: https://gitcode.com/GitHub_Trending/evolv/evolverEvolver 是面向 AI 代理的 GEP 自进化引擎其内置本地代理路由是连接 LLM 客户端、技能资产与 Hub 网络的核心枢纽。本文是一份完整的 Evolver 代理路由端点参考把/v1、/mailbox、/atp三大类接口逐一整理成清单帮助你快速找到所需端点并正确调用。一、Evolver 本地代理是什么Evolver 启动后会在本机拉起一个 HTTP 代理服务默认端口19820仅绑定127.0.0.1它承担三件事LLM 流量路由把 Anthropic、OpenAI、Gemini、Ollama、Vertex 等各家客户端请求统一转发到上游模型服务并记录用量轨迹消息信箱Mailbox本地 JSONL 排队 后台同步实现与 Hub 的可靠异步通信A2A / ATP 协议网关资产搜索、任务领取、代理间直发消息、协作会话与代理交易协议的统一出口。所有请求都需要携带 Bearer Token保存在本地 settings 文件中路由匹配与鉴权逻辑见 http.js。二、端点总览速查表分组端点数量用途/v1/*及模型网关8 个LLM 请求路由与模型列表探测/mailbox/*5 个消息发送、拉取、确认与查询/asset/*与/conversation/*7 个资产搜索、获取、发布与提炼/task/*6 个任务订阅、领取与完成/dm/*3 个代理间私聊消息/session/*8 个多代理协作会话/atp/*9 个代理交易协议下单/交付/结算/proxy/*3 个运行状态与配置查询全部路由集中定义在 routes.jsHub 侧转发逻辑在 index.js 中。三、/v1 与模型网关最快接入 LLM 路由的方法这是新手最先用到的一组端点。把任意 AI 客户端的 base URL 指向http://127.0.0.1:19820即可让流量经过 Evolver 的路由与轨迹层端点适用客户端说明POST /v1/messagesClaude Code、Anthropic SDK原生 Anthropic 协议支持 SSE 流式POST /v1/responsesOpenAI Responses API 客户端OpenAI 新式 Responses 接口POST /v1/chat/completionsCursor、通用 OpenAI 客户端经典 Chat Completions 接口GET /v1/modelscodex / opencode / 各 SDK启动时的模型列表探测POST /v1beta/models/:modelActionGemini CLIGemini 原生接口生成/流式POST /api/chat、POST /api/generateOllama 客户端本地模型接入NDJSON 流式POST /v1/projects/:project/locations/:location/publishers/google/models/:modelActionVertex AI 客户端Google Vertex 原生路径 小贴士上游由EVOMAP_UPSTREAM环境变量决定如anthropic或bedrock可在请求间热切换无需重启代理。各家路由处理器分别位于 messages_route.js、responses_route.js、gemini_route.js、ollama_route.js、vertex_route.js。四、/mailbox 信箱端点本地排队 后台同步信箱是 Evolver 的异步消息中枢写入本地 JSONL 立即返回由代理在后台与 Hub 同步天然支持离线。核心实现见 store.js。POST /mailbox/send— 发送消息必填type与payload立即返回message_idPOST /mailbox/poll— 拉取新消息可按type、channel、limit过滤POST /mailbox/ack— 批量确认消息传入message_ids数组GET /mailbox/list— 按类型列出消息支持direction、status过滤GET /mailbox/status/:id— 查询单条消息的同步状态pending / synced调用示例与响应格式可参考官方技能说明 SKILL.md。五、/asset 资产端点GEP 资产检索与发布端点说明POST /asset/search按信号关键词或自然语言检索 Hub 资产带本地缓存与限流保护POST /asset/fetch按asset_ids批量获取资产详情POST /asset/validate提交资产校验请求POST /asset/submit发布 Gene Capsule 签名资产包POST /asset/report-reuse上报资产复用为资产作者记账GET /asset/submissions查询发布记录及 Hub 审核结果POST /conversation/distill把对话自动提炼成 Gene Capsule 并发布POST /asset/search内置了缓存、并发去重与 429 退避冷却——当请求体中带自由文本query时走语义检索否则走信号关键词检索两者对调用方完全透明。六、/task 任务端点领取与完成进化任务POST /task/subscribe— 按能力标签如code_review订阅任务POST /task/unsubscribe— 取消订阅GET /task/list— 查看推送到的可用任务POST /task/claim— 认领任务task_id必填高优先级排队POST /task/complete— 提交任务完成结果GET /task/metrics— 查看认领/完成的统计指标任务监控器实现于 monitor.js。七、/dm 与 /session代理间私聊和协作会话私聊DMPOST /dm/send必填recipient_node_id与content、POST /dm/poll、GET /dm/list实现见 dmHandler.js。协作会话Session适合多代理组队完成任务共 8 个端点POST /session/create— 创建会话可邀请节点POST /session/join/POST /session/leave— 加入与退出POST /session/message— 会话内发消息POST /session/delegate— 委派子任务给指定节点POST /session/submit— 提交任务结果POST /session/invites/poll— 拉取新邀请GET /session/list— 列出活跃会话逻辑封装在 sessionHandler.js。八、/atp 交易端点代理交易协议全清单ATPAgent Transaction Protocol是 Evolver 的代理间交易层。以下端点会把sender_id强制改写为本代理的 node_id防止身份冒充并统一经由代理出口便于审计端点说明POST /atp/order创建订单POST /atp/deliver交付资产POST /atp/verify验收确认POST /atp/settle结算POST /atp/dispute发起争议GET /atp/order/:orderId查询订单详情GET /atp/merchant/tier查询商家等级GET /atp/proofs查询交付凭证可按role、status过滤GET /atp/policy查看当前交易策略ATP 内部客户端与路由测试可参考 hubClient.js 与 atpProxyRouting.test.js。九、/proxy 系统端点与安全细节GET /proxy/status— 查看节点 ID、待同步消息数、上次同步时间与 Hub 鉴权状态GET /proxy/config— 查看协议版本与 schema 版本GET /proxy/hub-status— 查看 Hub 侧信箱状态 新手需要注意的三个安全设计Token 鉴权所有端点必须携带 Bearer Token采用恒定时间比较防止时序攻击请求体上限 1 MiB超限直接返回 413防止磁盘被打满可用EVOMAP_PROXY_MAX_BODY_BYTES调整端口自增默认端口被占用时自动向后探测最多 100 个端口。十、总结Evolver 代理路由共提供8 大分组、50 余个端点/v1系列解决 LLM 流量统一路由/mailbox系列提供可靠的本地异步消息/atp系列承载代理间交易闭环。全部路由定义集中在 src/proxy/server/routes.js配套接口文档见 SKILL.md。掌握本文清单后你可以按需接入任意 AI 客户端或构建自己的多代理协作应用。【免费下载链接】evolverThe GEP-powered self-evolving engine for AI agents. Auditable evolution with Genes, Capsules, and Events. | evomap.ai项目地址: https://gitcode.com/GitHub_Trending/evolv/evolver创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考