---

A2A-Forge 是一款原生桌面应用，专为开发 A2A（Agent-to-Agent） 协议 Agent 的工程师设计。可以理解为 A2A 版的 Postman —— 输入 Agent URL，浏览所有技能，直接运行测试，无需写代码。

基于 Tauri 2 构建，快速、轻量、跨平台。

• 🔍 Agent 发现 — 自动获取并解析 .well-known/agent.json Agent 卡片
• ⚡ 技能测试 — 自适应输入（文本、JSON、文件上传），一键调用任意技能
• 📡 实时流式 — 基于 SSE 的流式响应，异步任务自动轮询
• 🔐 认证配置 — 每个 Agent 独立配置默认 Headers，凭证存储在系统钥匙串
• 🖼️ 智能预览 — 自动检测并内联渲染图片、视频、音频
• 📋 Curl 导出 — 一键复制等效 curl 命令
• 📜 历史记录 — 可搜索的执行历史，支持保存测试用例一键重跑
• 🗂️ 工作空间 — 将 Agent 分组管理到不同工作空间
• 🌗 主题切换 — 跟随系统的深色/浅色模式，支持手动覆盖
• ⌨️ 键盘优先 — Ctrl+N 添加 · Ctrl+Enter 运行 · Ctrl+Shift+C 复制 curl

• Rust（stable 工具链）
• Node.js v18+
• 平台依赖：参见 Tauri 环境准备

git clone https://github.com/learningpro/a2a-forge.git
cd a2a-forge
npm install
npm run tauri dev

npm run tauri build
# 输出：.dmg (macOS) / .msi + .exe (Windows)

点击 + Add agent card 或按 Ctrl/Cmd+N，输入 Agent 的 URL，A2A-Forge 会自动获取 Agent 卡片并展示所有技能。

点击 Agent 名称旁的 ⚙️ 齿轮图标，设置默认 Headers（如 X-API-Key）。配置会持久化到本地数据库，对该 Agent 的所有技能测试自动生效。

选择技能 → 填写输入 → 点击 Run（或 Ctrl/Cmd+Enter）。响应查看器会智能渲染结果 —— 图片直接显示、视频可播放、JSON 语法高亮。

每次执行自动保存到历史记录。常用请求可保存为命名测试用例，一键重跑。支持复制等效 curl 命令分享给团队。

层级	技术
运行时	Tauri 2.x (Rust)
前端	React 18 + TypeScript
样式	CSS Variables + 内联样式（已集成 Tailwind CSS 4）
状态管理	Zustand 5
数据库	SQLite (via tauri-plugin-sql)
类型桥接	tauri-specta
编辑器	Monaco Editor

Agent 管理、技能浏览、自适应测试、异步轮询、SSE 流式、智能媒体预览、历史记录、认证配置、工作空间

• 测试套件 — 将测试用例组合为自动化序列（Agent 级 + 工作空间级）
• 断言验证 — 7 种类型：状态匹配、JSONPath 等值/存在/包含/正则、响应时间、媒体检测
• CI 集成 — 命令行运行测试套件
• 测试报告 — 导出 HTML/JSON 格式报告

• 本地 A2A 注册中心 — 内嵌 axum HTTP 代理，聚合 Agent 发现
• 请求/响应拦截与修改
• 延迟模拟与故障注入
• 流量录制与回放

• 本地 Agent 目录 — 从本地目录浏览和组织 Agent
• 测试套件导入/导出 — 在工作空间之间共享测试集
• Agent 健康检查 — 手动刷新卡片并显示状态
• 收藏夹 — 收藏和整理常用 Agent
• 远程社区注册中心 — 从共享在线源发现 Agent（计划中）

• 工作空间共享 — 导出/导入完整工作空间配置
• 环境变量 — 按工作空间的变量替换，支持密钥脱敏
• 请求链 — 将一个技能的输出通过 JSONPath 提取传递给另一个
• Diff 视图 — 跨运行对比响应结果

欢迎贡献！请提交 Issue 或 Pull Request。

npm run tauri dev        # 启动开发服务器
npx tsc --noEmit         # 类型检查
npx vitest run           # 运行测试

MIT — Copyright 2026 Orange Dong