VeryAgent

一个多智能体协作编程桌面应用。把多个 AI 编程助手（Claude Code、Codex CLI、Gemini CLI、OpenCode 等）整合到一个工作空间里，支持会话聚合、多智能体协作、以及丰富的开发工具链。

仓库

• GitHub（公网）：https://github.com/plhys/VeryAgent
• Gitea（内网）：http://10.10.100.233:3030/boss/veryagent

应用内「系统管理 → 软件更新」可按网络选择上述任一发布源；标题栏主题切换旁在有新版本时会显示绿色「更新」按钮。发布产物与 latest.json 说明见 docs/updater-release.zh-CN.md。

主要功能

• 多智能体协作 — 一个会话中可以同时调度多个不同类型的智能体，各自独立运行，共同完成复杂任务
• 会话聚合 — 导入所有支持的智能体会话到统一工作空间
• 专家技能系统 — 内置可扩展的技能插件，智能体可直接调用（如 Gemini 文生图/图生图）
• 图片交互 — 聊天中的图片支持右键复制、下载、地址复制，以及引用二次创作
• 项目脚手架 — 可视化创建新项目，实时预览，一键生成 shadcn/ui 模板
• Office 文档 — 创建、分析、编辑 .docx / .xlsx / .pptx，支持在线预览
• 自动化 — 将编辑器配置保存为可复用的自动化任务，支持定时或手动执行
• 聊天频道 — 接入 Telegram、飞书、微信等消息平台，远程控制智能体
• MCP 管理 — 本地扫描 + 市场搜索安装 MCP 服务器
• Git 工作流 — 内置文件树、差异对比、提交、终端等完整开发工具链
• Web 服务模式 — 支持 Docker 部署和独立服务器模式，浏览器即可访问
• 桌面端宠物 — 桌面小宠物陪伴，支持自定义

支持的智能体

Claude Code · Codex CLI · OpenCode · Gemini CLI · OpenClaw · Cline · Hermes Agent · CodeBuddy · Kimi Code · Pi

快速开始

桌面端

# 安装依赖
pnpm install

# 开发模式启动
pnpm tauri dev

# 构建安装包
pnpm tauri build

产物在 src-tauri/target/release/bundle/ 下，Windows 会生成 .exe 安装包。

推荐的本地 EXE 构建方式

如果你只是想在本机改完代码后尽快生成一个可双击运行的 exe，优先使用项目根目录下的脚本：

• build-exe.bat：快速模式，默认复用已有 out/，直接构建 exe
• build-exe.bat full：完整模式，先重建前端再构建 exe
• prepare-release-assets.bat：整理 out/ 和 sidecar，便于上传到仓库 Release 附件

详细说明见：docs/build-recovery.zh-CN.md

服务端 (Docker)

docker compose up -d

开发

推荐（Windows 日常）：前后端拆开、桌面进程独立，避免 pnpm tauri dev 每次冷启动，也避免关终端/agent 时把桌面端一起杀掉。

# 一键：后台前端 + 按需增量编 debug + Start-Process 独立拉起 exe
.\dev-detached.ps1

说明见：docs/dev-detached.zh-CN.md

# 前端开发 (Next.js dev server)
pnpm dev

# 完整桌面应用（偶发排查用；日常更推荐 dev-detached）
pnpm tauri dev

# 独立服务器
pnpm server:dev

环境要求

• Node.js ≥ 22
• pnpm ≥ 10
• Rust stable (2021 edition)
• Tauri 2 构建依赖（仅桌面端需要）

CI / CD 自动构建

本项目使用 GitHub Actions 自动构建桌面端安装包，换机器无需编译，直接下载 exe 即可运行。

Workflow	触发方式	产物
release.yml	git tag v* && git push --tags 或手动触发	Windows/Mac/Linux 全平台安装包 + Release draft
snapshot.yml	push 到 main / dev 分支 或手动触发	Windows exe（Actions Artifacts，保留 7 天）

新机器上手：

1. 前往 GitHub Releases 页面
2. 下载最新的 .exe 安装包，双击安装
3. 零编译，直接运行

本地开发（首次编译后自动缓存）：

pnpm install          # ~10 min（首次），后续 ~1 min（缓存命中）
pnpm tauri dev        # ~3 min（首次 Rust 编译），后续 ~30s（rust-cache 增量）

CI 使用 Swatinem/rust-cache@v2 缓存编译产物，换机器后首次编译从 3 分钟降至 30-60 秒。

架构

Next.js 16 (React 19) + Tauri 2
    │
    ▼
共享 Rust 核心
  ├── ACP 智能体管理
  ├── 会话聚合 & 解析
  ├── 聊天频道 (Telegram / 飞书 / 微信)
  ├── Git / 文件树 / 终端
  ├── MCP 市场 & 配置
  ├── Office 工具 & 自动化
  └── SeaORM + SQLite

致谢

• ACP — 智能体客户端协议
• Superpowers — 专家技能模块
• OfficeCLI — Office 文档工作流

License

Apache-2.0