# ma-chat
**Repository Path**: mac2019/ma-chat
## Basic Information
- **Project Name**: ma-chat
- **Description**: ma_agent 是AI Agent 开发工具。提供各类最新大模型和工具、框架，提供最便捷的 AI Agent 开发环境。
提供 AI Agent 开发所需的核心技术：Prompt、RAG、Plugin、Workflow，使得开箱即用、快速搭建聚焦创造 AI 核心价值。
当前项目只是用户前台。
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-06
- **Last Updated**: 2026-09-06
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ma_agent
## 介绍
ma_agent 是AI Agent 开发工具。提供各类最新大模型和工具、框架，提供最便捷的 AI Agent 开发环境。
提供 AI Agent 开发所需的核心技术：Prompt、RAG、Plugin、Workflow，使得开箱即用、快速搭建聚焦创造 AI 核心价值。
可以快速搭建个人AI助手、个人/企业知识库、智能客服、企业IT服务台等。
## 技术栈
ma_agent(暂未开源) 的后端采用 Golang 开发，前端(ma-front)使用 React + TypeScript，整体基于微服务架构并遵循领域驱动设计（DDD）原则构建。为用户提供一个高性能、高扩展性、易于二次开发的底层框架和开箱即用平台。
## 功能清单
| 功能模块 | 功能点 |
|-------|----------------------------------------------------|
| 模型服务 | 管理模型列表，可接入OpenAI、Claude、Gemini等在线或离线模型服务 |
| 搭建智能体 | * 编排、发布、管理智能体
* 支持配置工作流、知识库等资源 |
| 搭建应用 | * 创建、发布应用
* 通过工作流搭建业务逻辑 |
| 搭建工作流 | 创建、修改、发布、删除工作流 |
| 开发资源 | 支持创建并管理以下资源：
* 插件
* 知识库
* 数据库
* 提示词 |
| API | * 创建会话、发起对话等
|
## 快速开始
环境要求：
* 在安装 ma_agent 之前，请确保您的机器满足以下最低系统要求： 4 Core、4 GB
* 提前安装 Docker、Docker Compose，并启动 Docker 服务。
## 部署
展示未开放，待后续......
# ma-chat
ma_agent 的智能体对话 Web 客户端（Vue 3），面向最终用户，提供基于空间（Space）的智能体问答、会话管理与流式输出体验。
## 技术栈
- Vue 3 + TypeScript + Vite
- Vue Router（history 模式）
- Pinia（状态管理）
- 无 UI 组件库，自研轻量样式（`src/style.css`）
## 开发
```bash
npm install
npm run dev # 默认 http://localhost:5173
npm run build # vue-tsc --noEmit && vite build
npm run preview
```
Vite 已配置代理：`/api`、`/v1`、`/v3` 转发到本地后端 `http://localhost:8888`。
## 功能
- 登录 / 注册（cookie 会话，会话失效自动跳转 `/login`）
- 智能体切换（AgentSwitcher）
- 对话（支持 SSE 流式输出：message / function_call / tool_response / knowledge 等事件）
- 会话管理（侧边栏会话列表、切换、新建、删除）
- RunSteps 运行步骤查看面板
## 认证说明
- `/api` 接口走 cookie 会话认证
- `/v1`、`/v3` 走 OpenAPI PAT 认证，需在请求头携带 `Bearer `（token 存于 `localStorage` 的 `mac_chat_pat`，过期需联系管理员重新签发）
## 目录结构
```
src/
├── api/ # 接口封装（agent/chat/conversation/space/upload/auth 等）
├── components/ # 会话侧边栏、聊天输入、消息项、Agent 切换等组件
├── stores/ # Pinia 状态（auth / chat / conversation）
├── types/ # 类型定义
└── views/ # 页面（Chat / Login / Register）
```
# ma-front
ma_agent 的智能体Web 中台管理，以React 18技术栈构建的 AI Agent 开发平台
## 核心技术栈
- 框架：React 18 + TypeScript
- 构建工具：Rsbuild
- 包管理器：Rush + PNPM
- 路由：React Router v6
- 状态管理：Zustand
## 目录结构(暂未开源)
```
frontend/
├── apps/ # 应用层
│ └── ma-front/ # 主应用
├── packages/ # 核心包
│ ├── agent-ide/ # AI Agent 开发环境
│ ├── arch/ # 架构基础设施
│ ├── common/ # 通用组件与工具
│ ├── components/ # UI 组件库
│ ├── data/ # 数据层
│ ├── devops/ # DevOps 工具
│ ├── foundation/ # 基础基础设施
│ ├── project-ide/ # 项目开发环境
│ ├── studio/ # Studio 核心功能
│ └── workflow/ # 工作流引擎
├── config/ # 配置文件
│ ├── eslint-config/ # ESLint 配置
│ ├── rsbuild-config/ # Rsbuild 构建配置
│ ├── ts-config/ # TypeScript 配置
│ ├── postcss-config/ # PostCSS 配置
│ ├── stylelint-config/ # Stylelint 配置
│ ├── tailwind-config/ # Tailwind CSS 配置
│ └── vitest-config/ # Vitest 测试配置
└── infra/ # 基础设施工具
├── idl/ # 接口定义语言工具
├── plugins/ # 构建插件
└── utils/ # 工具库
```
## 环境要求
- Node.js >= 21
- PNPM 8.15.8
- Rush 5.147.1
## 安装依赖
```bash
# 在项目根目录执行
rush install
# 更新依赖
rush update
```
## 开发模式
```bash
# 启动开发服务器
cd apps/ma-front
npm run dev
# 或使用 rushx
rushx dev
```
## 生产构建
```bash
# 构建应用
cd apps/ma-front
npm run build
# 或使用 rushx
rushx build
```
## 核心模块
### Agent IDE
- agent-ide：AI Agent 集成开发环境
- prompt：提示词编辑器
- tool：工具配置管理
- workflow：工作流集成
### 架构层（arch）
- bot-api：API 接口层
- bot-hooks：React Hooks 库
- foundation-sdk：基础 SDK
- i18n：国际化支持
- bot-flags：功能开关管理
- web-context：Web 上下文工具
### 工作流引擎（workflow）
- fabric-canvas：画布渲染引擎
- nodes：节点组件库
- sdk：工作流 SDK
- playground：调试运行环境
### 数据层（data）
- knowledge：知识库管理
- memory：记忆系统
- common：通用数据处理
# ma-admin
ma_agent 的智能体管理后台（Vue 3 + Element Plus），面向管理员，提供平台基础配置、模型管理、知识库配置、API Key 管理与 RBAC 权限管理能力。
## 技术栈
- Vue 3 + TypeScript + Vite
- Vue Router（hash 模式，适配静态托管，如 Go StaticFS 挂载的 `/admin/` 路径）
- Pinia（状态管理）
- Element Plus + @element-plus/icons-vue
## 开发
```bash
npm install
npm run dev # 默认 http://localhost:5174
npm run build # vue-tsc --noEmit && vite build
npm run preview
```
Vite 已配置代理：`/api`、`/v1`、`/v3` 转发到本地后端 `http://localhost:8888`。
> 注意：`vite.config.ts` 中 `build.outDir` 指向 `../../../backend/resources/conf/admin`，即 `npm run build` 会将产物直接输出到 Go 后端静态资源目录（后台页面由 Go StaticFS 在 `/admin/` 下托管，`base: './'` 保证相对路径资源可加载）。
## 功能
- 登录（校验管理员身份，未登录/非管理员跳转 `/login`）
- 首页 Dashboard
- 配置管理：基础配置、模型管理、知识库配置
- API Key 管理（签发与续期，供 /v1 /v3 OpenAPI 使用）
- RBAC：用户管理、角色管理、权限表管理、默认角色权限（权限矩阵）
## 认证说明
- 走 `/api` cookie 会话认证；所有需要权限的页面由路由守卫校验 `auth.isAdmin`
- 业务错误通过 `ApiError`（含 status / code）抛出
## 目录结构(暂未开源)
```
src/
├── api/ # 接口封装（auth/config/apikey/rbac 等）
├── components/ # 通用组件（如权限矩阵 PermissionMatrix）
├── layout/ # 后台主布局 AdminLayout
├── stores/ # Pinia 状态（auth）
├── types/ # 类型定义
├── constants.ts
└── views/ # 页面（dashboard / config / apikey / rbac）
```
# 特技
有需要进一步了解和帮忙二次开发的请加我微信：wx_mac2013
# 截图展示
## ma-front
## ma-chat
## ma-admin
