AgentHub
把 AI Agent 当队友一样拉进群聊。和真人好友、AI Builder、AI Reviewer 在同一个 IM 里聊天协作——消息就是任务流，聊天就是工作台。
English · 架构 · API
产品定位
AgentHub 让你像在 IM 群聊里协作一样，把真人好友、Builder、Reviewer、Researcher、Deployer 等 AI Agent 放进同一个项目会话，围绕代码、文档、Diff、Preview、Approval 和产物协同工作。
核心特性
- IM 形态协作 — 单聊、群聊、@Agent，在同一条任务流里完成
- 多 Runtime 调度 — Claude Code、Codex、OpenCode 通过统一 Adapter 接入
- Diff / Preview / Approval — 代码变更内联展示，审批流可控
- 三端客户端 — Tauri Desktop + Web + Expo React Native Mobile（Desktop/Web 主线；Mobile 是装配中的 fixture/边界验证 lane，非 release candidate —— 发布链路的
build-mobile 受 RELEASE_MOBILE_ENABLED 门控、默认关闭）
- Hub-Edge 分布式 — 本地执行不依赖 Hub；Hub 提供多端同步、远程查看和审计
- Account 身份与产品会话分离 — Web 同源 HttpOnly 会话、CSRF 和局部/Account 全局退出；Desktop 保留 native Hub token。服务端配置、迁移和撤销边界见 身份契约，实际运行激活需独立验收。
技术栈
| 层 | 技术 |
|---|
| Desktop | Tauri 2 · React 19 · TypeScript · Vite |
| Web | React 19 · TypeScript · Vite |
| Mobile | React Native · Expo |
| 后端 | Go · PostgreSQL · Redis · SQLite |
仓库结构
| 目录 | 说明 |
|---|
app/web | 浏览器工作台 |
app/desktop | Tauri Desktop 工作台 |
app/mobile-rn | Expo / React Native Mobile |
app/shared | 共享 UI 组件、类型、transcript 逻辑 |
app/workbench | 端级工作台壳（@agenthub/workbench，依赖方向 workbench → shared 单向） |
hub-server | Hub API：身份、会话、项目、任务、消息、审批 |
edge-server | 本地执行节点：CLI Adapter、SQLite、事件回放 |
pkg | Hub/Edge 共享的 Go 包（errcode、jwtutil、testkit 等；独立 module，经根 go.work 联编） |
api | OpenAPI 与 WebSocket 事件合同 |
docs | 稳定架构、治理与设计文档；交付进度与路线图在 GitHub issues |
快速开始
最小本地启动路径（5 步）。需要 OpenSSL、Docker、Go 1.27.3、Node 24+/corepack、pnpm 10+。
终端 A（基础设施与 Hub）：
cp .env.example .env
secret="$(openssl rand -hex 32)"
sed -i.bak "s/^AGENTHUB_JWT_SECRET=.*/AGENTHUB_JWT_SECRET=$secret/" .env && rm -f .env.bak
set -a; . ./.env; set +a # 1. 复制配置、生成开发 secret 并导出给 Hub 进程
docker compose up -d postgres redis # 2. 起基础设施（PG16 + Redis7，仅绑 127.0.0.1）
cd hub-server && go run ./cmd/server-hub # 3. 起 Hub Server（自动跑迁移，API 在 :8080）
终端 B（前端）：
cd app && corepack pnpm install # 4. 装前端依赖
corepack pnpm dev # 5. 起 Desktop Vite（:5173）；web 用 corepack pnpm dev:web
.env.example 不提供可复用 JWT secret；Windows PowerShell 命令、完整启动路径、OIDC 接入和 Edge Server 调试见 docs/developer-quickstart.md。生产部署与必填变量见 docs/architecture/05-deployment.md。
开发
贡献
欢迎提交 Issue 和 Pull Request。详情见 CONTRIBUTING.md。
License
Apache-2.0. See LICENSE.
