看得见、摸得着、能动手的桌面 AI 工作站。基于 ReAct Agent + 子 Agent 分层架构，一个引擎统一服务 Web / 桌面 / IM 三大入口。
English · Gitee · GitHub · GitCode
# 克隆项目
git clone https://gitee.com/zhendongdong/guada_ai.git
cd guada_ai
# 一键部署（Docker）
cp .env.example .env
./deploy.sh
# 打开浏览器访问 http://localhost:3000
# 开始跟你的 AI 助手对话！也可选择 Electron 桌面端 或 传统 Web 部署。
|
运营 · 文案 · 编导
写脚本、出文案、追热点，Agent 定时抓取竞品动态、自动整理素材库，还能打开浏览器帮你爬数据。 |
开发 · 架构 · 运维
分析代码、写技术方案、审 PR，丢项目进知识库随时问，写脚本的事交给 Agent 自动完成。 |
创作 · 构思 · 脑暴
构思人物、搭建世界观、头脑风暴情节，GuaDa 记得住你的设定，不会"忘记前面说过什么"。 |
内部AI · 知识库 · 客服
搭内部AI客服，绑定知识库，员工问问题AI自动答，还能接入 QQ/企业微信。 数据不出本机，安全可控。 |
| 能力 | 亮点说明 | 文档 |
|---|---|---|
| 🤖 智能体（Agent） | ReAct 多轮自治循环 + 子 Agent 分层委派，支持会话锁、流式传输、中断处理与再生模式 | → 详情 |
| 🧩 子 Agent 系统 | 主 Agent 自动拆解复杂任务 → 委派子 Agent 独立执行 → 结果自动归集 | → 详情 |
| 📚 知识库 (RAG) | 语义 + 关键词双混合检索，Agent 自助多轮搜索与写入，支持 40+ 文件格式 | → 详情 |
| 🧠 长期记忆 | 两级压缩（裁剪→语义），可编辑、可回退、有历史，非破坏性压缩 | → 详情 |
| 🔧 技能管理 | 文件即技能，热插拔即时生效，渐进式加载省 Token | → 详情 |
| ⏰ 定时任务 | Agent 按 Cron 自动执行，独立会话隔离，完整执行记录 | → 详情 |
| 🤝 Bot 网关 | 统一接入 QQ/企业微信等 IM 平台，自动重连、消息合并、动态启停 | → 详情 |
| 🌐 浏览器自动化 | Electron 内嵌 Chromium，Agent 直接操控浏览器。6 层智能压缩，省 70%+ Token 不丢结构 | → 详情 |
| 🧠 多模型管理 | 统一适配 OpenAI / Anthropic / Azure / Google 等，角色级/会话级/全局级配置 | → 详情 |
| 🚀 多部署方式 | Electron 桌面 + Web 应用 + Docker 容器化，开箱即用 | → 部署指南 |
| 🗄️ 企业级数据 | 默认 SQLite，Prisma ORM 可无缝切换 MySQL / PostgreSQL | — |
| 🎨 自定义壁纸 | 自定义背景、透明度、毛玻璃效果，打造你的专属工作站 | — |
架构四层： 前端入口 → 入口层 → 核心服务层 → 数据层
| 层级 | 职责 | 核心组件 |
|---|---|---|
| 前端入口 | 用户交互 | Vue 3、Electron、QQ/企微 Bot |
| 入口层 | 路由与协议转换 | REST + SSE API、Bot Gateway |
| 核心服务层 | Agent 引擎 + 子 Agent + RAG + 工具调度 + Skills + LLM 适配 | Agent Engine、Sub-Agent Manager、上下文压缩、RAG、MCP、Skills 框架、LLM 适配器 |
| 数据层 | 持久化存储 | SQLite（Prisma ORM，可切换 MySQL/PostgreSQL）、sqlite-vec + FTS5、文件系统 |
ai_chat/
├── backend-ts/ # NestJS 后端
│ ├── prisma/schema.prisma # 数据库 Schema
│ ├── src/
│ │ ├── common/ # 基础设施（数据库、向量、MCP、工具函数）
│ │ └── modules/
│ │ ├── chat/ # ⭐ 核心对话（Agent 引擎、压缩、上下文、审批）
│ │ ├── tools/ # ⭐ 工具调用系统（调度、MCP、上下文）
│ │ ├── skills/ # ⭐ Skills 技能框架
│ │ ├── sub-agent/ # ⭐ 子 Agent 系统
│ │ ├── knowledge-base/ # ⭐ 知识库（RAG）
│ │ ├── llm-core/ # LLM 适配层
│ │ ├── bot-gateway/ # 机器人网关
│ │ ├── characters/ # 角色管理
│ │ ├── scheduler/ # 定时任务
│ │ └── ... # auth、files、models、settings、users
│ └── main.ts
├── frontend/ # Vue 3 前端
├── electron/ # Electron 桌面端
├── docs/ # 文档
└── LICENSE
| 功能 | 状态 | 说明 |
|---|---|---|
| 子 Agent 系统 | ✅ 已完成 | 分层 Agent 体系，复杂任务自动拆解分发 |
| Agent 工作流 | ✅ 已完成 | 多步骤 Agent 编排，任务拆解与协作 |
| 子账户 | 🔧 后端完成 | 数据隔离、配置共享，适合家庭/团队 |
| 沙箱 | 📅 规划中 | 安全的代码执行环境，Agent 可编写并运行脚本 |
| Agent 工作流可视化 | 📅 规划中 | 图形化展示 Agent 推理、工具调用、子 Agent 执行链 |
遇到问题？想交流技术？下载预编译客户端？来这里：
| 渠道 | 直达 |
|---|---|
| 💬 QQ 群 | 1047993501 |
| 📢 公众号 | 冬瓜编程实验室 |
| 🐛 反馈 Issue | Gitee Issues |
| ⭐ 支持项目 | 点个 Star（你的鼓励是持续更新的动力 ❤️） |
本项目基于 MIT License 开源，可自由使用、修改和商用。
如果 GuaDa 对你有帮助，欢迎在 Gitee 上点个 Star ⭐
你的每一次 Star，都是让这个项目变得更好的动力