AgentRouter

多 Agent 协作桌面平台——编排多个 AI 编码助手，统一管理、统一调度。

AgentRouter 将 6 个 AI 编码 CLI 工具集成到一个 Electron + Vue 3 桌面应用中，提供统一的界面和 CLI 接口。平台本身不写代码——它只负责调用（启动 CLI 子进程）和管理（消息、任务、日志、记忆）。

快速开始

安装

# CLI 工具（推荐）
npm install -g @kuaizhongqiang/agent-router

# 或下载桌面端安装包
# 从 GitHub Releases 下载 AgentRouter-*.exe

配置 API Key

ar credential set --apiKey sk-xxx --baseUrl https://api.deepseek.com

创建项目并执行

# 创建项目
ar project create MyApp /path/to/myapp

# 运行 Agent
ar exec codewhale "分析项目结构并输出摘要"

# 诊断系统状态
ar diag

集成 Agent

构建 Agent

# CodeWhale（需要 Rust 1.88+）
cd agents/codewhale && cargo build --release -p codewhale-cli -p codewhale-tui

# Reasonix
cd agents/reasonix && npm run build

# OpenCode（需要 Go 1.24+）
cd agents/opencode && go build -o ar-opencode.exe .

# Cline & Continue（npm 全局安装）
npm install -g @cline/cli @continuedev/cli

CLI 命令

ar <command> [subcommand] [args...]

核心命令:
  exec <agent> <指令>      执行 Agent
  doctor [agent]           健康诊断
  status                   全局状态
  diag                     深度体检

项目管理:
  project list             列出项目
  project create <name> <path>  创建项目
  project init <id>        项目初始化扫描
  project rm <id>          删除项目

会话与任务:
  session list/create/rm   会话管理
  task list/approve        任务管理
  msg list <session>       消息历史

Agent 管理:
  agent list               列出 Agent
  agent info <name>        查看详情

构建与测试:
  build                    编译后端
  test run                 运行测试

工具:
  db <sql>                 查询数据库
  log <agent>              查看日志
  git status/diff          集成 Git
  credential show/set      凭证管理
  clean                    清理产物

全局选项:
  --json                   JSON 输出
  --project <id>           指定项目

执行模式

开发

# 环境要求
node >= 22
npm >= 10

# 安装依赖
npm install --ignore-scripts

# 编译后端
npm run build:electron

# 开发模式（前端 + Electron 热更新）
npm run electron:dev

# 生产构建
npm run build && npm run build:electron && npm run electron:build

# 运行测试
node test/runtime-test-2.mjs   # 集成测试（100 项）
node cli/bin/ar.mjs test run --cli  # CLI 测试（82 项）

数据存储

• 数据库: ~/.agentrouter/agentrouter.db (sql.js WASM)
• 日志: ~/.agentrouter/projects/<id>/sessions/<id>/events/*.jsonl
• 凭证: ~/.agentrouter/credentials.json
• 记忆: memories 表（按项目 + Agent 索引）

架构

Electron Main Process
├── Agent Layer — 6 个 Agent 适配器 + NDJSON 事件流
├── Data Layer — sql.js + 迁移 + CRUD
├── IPC Layer — 50+ 处理程序，错误统一包装
├── Scheduler — 并行组调度 + 文件冲突检测
├── MCP Server — 文件/搜索/Wiki/Git 工具
├── CLI — 独立于 Electron 的终端命令
└── Project Initializer — 技术栈检测 + 项目画像

License

MIT