Skip to content

README.md

Latest commit

 

History

History
180 lines (133 loc) · 6.03 KB

README.md

File metadata and controls

180 lines (133 loc) · 6.03 KB

AgentHub / AI 工作台

让 Claude Code、Codex、OpenCode 在同一 IM 工作台上协作

status go react license

English  ·  官网


AgentHub 工作台

三种 AI Runtime 统一调度 · IM 原生多 Agent 协作 · 团队审批流 · 中英双语 · Glass 拟态设计


核心卖点
三种 Runtime 统一 同一界面调度 Claude Code、Codex、OpenCode，不锁定单一模型或工具链
IM 原生协作 像飞书/微信一样拉群、@Agent、审批——不是又一个 IDE 插件
Hub-Edge 分布式 本地执行 + 云端同步 + 多端协作，数据不出本地，协作走云端

快速开始（5 步）

# 1. 克隆仓库
git clone https://github.com/TokenDanceLab/AgentHub.git
cd AgentHub

# 2. 初始化开发环境
.\scripts\setup.ps1

# 3. 启动 Edge Server（选择一种 Runtime）
cd edge-server
go run ./cmd/agenthub-edge --addr 127.0.0.1:3210 --runner-profile claude-code

# 4. 启动 Desktop
cd ..\app\desktop
pnpm install
pnpm dev

# 5. 打开 http://localhost:5173 开始使用

需要先安装 Go 1.25+、Node.js 20+ 和 pnpm。详见 架构文档。


功能对比

能力 AgentHub Cursor Windsurf Claude Code Codex
多 Agent 协作 IM 群聊 单人 单人 实验性 单人
多 Runtime 支持 3 种 自有 自有 Claude 专用 OpenAI 专用
中英双语 完整 英文 英文 英文 英文
本地执行 Tauri 桌面端 VS Code 插件 VS Code 插件 CLI CLI
移动端 Android 原生 无 无 无 Web
团队审批流 内置 无 无 权限弹窗 无
多端同步 Hub 云端 无 无 无 无
设计系统 Glass 拟态 VS Code 主题 VS Code 主题 TUI Web Dashboard
MCP 生态 规划中 完整 完整 最完整 无
定价 开源免费 $20/月 $20/月 API 计费 $20/月

AgentHub 是 IM 层的创新——不替代任何 Runtime，而是让它们在同一工作台上协作。


架构

Desktop / Mobile / Web
        |
   Edge Server (Go) ── Agent Runtime Adapter ── Claude Code / Codex / OpenCode
        |
   Hub Server (Go) ── PostgreSQL + Redis
组件 职责
Desktop App（Tauri） 本地执行工作台，IM 聊天、Diff 审批、多 Agent 管理
Web App 浏览器工作台，远程查看、审批协作
Mobile App（Tauri Android） 移动端 IM、审批、预览
Edge Server 本地执行节点，Agent CLI 进程管理，EventStore
Hub Server 账号、IM 群聊、多端同步、设备路由、审计
Agent Runtime Claude Code / Codex / OpenCode CLI 适配器

本地执行不依赖 Hub——Desktop 只连 Local Edge 即可完成项目、线程、Run 全流程。Hub 用于云端 IM、多端同步、远程审批。


产品分层

层 描述 阶段
Desktop Command Center 本地项目、Thread、Run、Diff、审批、Preview P0 ✅
IM Collaboration 单聊、群聊、@Agent、多 Agent 审查、进度卡片 P1 🔧
Hub Network 账号、好友、多端同步、Edge 中继、审计 P2-P4 📋

技术栈

层 技术
前端 React 19 + TypeScript + Vite + CSS Modules + OKLCH tokens
Desktop Tauri 2.5
Mobile Tauri 2.5（Android）
Edge Server Go 1.25 + WebSocket + Agent Runtime adapters
Hub Server Go 1.25 + Gin + GORM + PostgreSQL + Redis
实时通信 WebSocket typed events
共享组件 @shared/ui — 通用 UI 组件库

项目结构

AgentHub/
├── app/
│   ├── desktop/          # Tauri 桌面端
│   ├── web/              # Web 工作台
│   ├── mobile/           # Mobile 端
│   └── shared/           # 前端共享类型、API client、@shared/ui
├── edge-server/          # Edge 执行节点
├── hub-server/           # Hub 中心服务
├── api/                  # API 契约（OpenAPI + WebSocket events）
├── docs/                 # 文档
│   ├── architecture.md   # 产品定位 + 系统架构 + 实现状态
│   ├── adr/              # 架构决策记录
│   ├── designs/          # 组件设计文档
│   ├── handoffs/         # 项目状态与交接
│   ├── governance/       # 安全台账、分支治理、文档标准
│   ├── reference/        # 调研与竞品分析
│   ├── operations/       # 运维文档
│   └── archive/          # 历史评审与归档
└── scripts/              # 初始化脚本、git hooks

文档导航

文档 面向
架构文档 产品定位、系统架构、实现状态（首选入口）
API 契约 REST + WebSocket 接口定义
安全风险台账 安全风险登记与追踪
项目交接 项目状态与交接文档

鉴权

本地执行无需登录。使用云端 IM、多端同步或远程控制时，通过 TokenDance ID 统一登录。


English  ·  系统架构  ·  API 契约