应用介绍
< #后台管理框架 #RBAC #插件市场 #MCP #FastAPI #Vue3 #AI Agent #开源软件
ApeAdmin 是一个用 FastAPI + Vue3 写的后台管理框架，和传统中后台脚手架最大的区别在于：它把系统自身的管理能力也封装成了 AI Agent 能调用的工具。底座负责权限、菜单、部门、日志这些基础设施，业务功能以插件形式独立开发和部署，再通过内置的 MCP-SSE 网关把这些能力暴露出去，让大模型智能体可以直接操作后台。
上手方式有点像装 WordPress：启动前后端后浏览器会自动跳到安装向导，三步配完数据库、站点和管理员就能用，MySQL 不存在时还会自动建库，JWT 密钥也是自动生成写入配置的。适合需要一套现成后台底座，同时又想把业务能力开放给 AI Agent 调用的团队。作者说明项目由 AI 驱动开发、人工负责产品方向与质量把关，采用 MIT 协议，官方也提供了在线演示环境（只读体验账号）。
安装向导：首次访问自动跳转
RBAC 权限体系：用户 / 角色 / 菜单 / 部门五表模型，权限分免登录、免鉴权、规则鉴权、数据范围四层，数据范围可细到本部门、本部门及以下或全部；菜单区分目录、菜单、按钮三种类型并支持无限层级。
前端权限控制：提供 v-permission 指令做按钮级显示控制，路由守卫负责页面级校验，超级管理员自动拥有全部权限。
插件化架构：插件以 Python 包形式开发，通过 importlib 自动扫描发现，支持 load、install、register、uninstall 完整生命周期与热启用禁用，业务插件还能作为独立 Docker 服务部署。
插件市场与事件总线：可在线浏览、搜索、下载社区插件，也支持上传 ZIP 包导入；EventBus 内置 7 种事件（应用启动、数据库就绪、用户登录等），插件之间保持松耦合。
MCP-SSE 网关：支持 Tools、Resources、Prompts 三种原语，工具注册时自动从函数签名推断 JSON Schema，并按 RBAC 过滤——Agent 只能看到当前用户有权限调用的工具，传输走 SSE 一次性 ticket 认证，调用有 30 秒超时保护和完整审计记录。
内置 AI 对话：兼容 DeepSeek、通义千问、智谱 GLM、OpenAI 及自定义端点，流式输出配合 Markdown 实时渲染，支持 Function Calling 让 AI 调用 MCP 工具完成管理操作，供应商密钥在后台加密存储。
审计日志：中间件为每个请求分配唯一 ID 做链路追踪，记录用户操作行为与接口耗时，可按模块、时间、用户筛选。
技术栈与部署：后端 FastAPI + SQLAlchemy 2.0 异步 + Alembic，前端 Vue 3.5 + Vite 6 + TypeScript + Element Plus，数据库 MySQL 与 SQLite 双驱动自动切换，Redis 可选且缺失时自动降级为内存缓存。
开源项目：项目源码托管在 GitHub，方便开发者查看实现方式、参与开发，或者根据自己的需求进行二次定制。
ApeAdmin 是一个用 FastAPI + Vue3 写的后台管理框架，和传统中后台脚手架最大的区别在于：它把系统自身的管理能力也封装成了 AI Agent 能调用的工具。底座负责权限、菜单、部门、日志这些基础设施，业务功能以插件形式独立开发和部署，再通过内置的 MCP-SSE 网关把这些能力暴露出去，让大模型智能体可以直接操作后台。
上手方式有点像装 WordPress：启动前后端后浏览器会自动跳到安装向导，三步配完数据库、站点和管理员就能用，MySQL 不存在时还会自动建库，JWT 密钥也是自动生成写入配置的。适合需要一套现成后台底座，同时又想把业务能力开放给 AI Agent 调用的团队。作者说明项目由 AI 驱动开发、人工负责产品方向与质量把关，采用 MIT 协议，官方也提供了在线演示环境（只读体验账号）。
软件功能
安装向导：首次访问自动跳转
/setup，三步完成数据库、站点与管理员配置；MySQL 连接会自动检测并在库不存在时建库，装完写入 setup.lock 防止向导被重复执行。RBAC 权限体系：用户 / 角色 / 菜单 / 部门五表模型，权限分免登录、免鉴权、规则鉴权、数据范围四层，数据范围可细到本部门、本部门及以下或全部；菜单区分目录、菜单、按钮三种类型并支持无限层级。
前端权限控制：提供 v-permission 指令做按钮级显示控制，路由守卫负责页面级校验，超级管理员自动拥有全部权限。
插件化架构：插件以 Python 包形式开发，通过 importlib 自动扫描发现，支持 load、install、register、uninstall 完整生命周期与热启用禁用，业务插件还能作为独立 Docker 服务部署。
插件市场与事件总线：可在线浏览、搜索、下载社区插件，也支持上传 ZIP 包导入；EventBus 内置 7 种事件（应用启动、数据库就绪、用户登录等），插件之间保持松耦合。
MCP-SSE 网关：支持 Tools、Resources、Prompts 三种原语，工具注册时自动从函数签名推断 JSON Schema，并按 RBAC 过滤——Agent 只能看到当前用户有权限调用的工具，传输走 SSE 一次性 ticket 认证，调用有 30 秒超时保护和完整审计记录。
内置 AI 对话：兼容 DeepSeek、通义千问、智谱 GLM、OpenAI 及自定义端点，流式输出配合 Markdown 实时渲染，支持 Function Calling 让 AI 调用 MCP 工具完成管理操作，供应商密钥在后台加密存储。
审计日志：中间件为每个请求分配唯一 ID 做链路追踪，记录用户操作行为与接口耗时，可按模块、时间、用户筛选。
技术栈与部署：后端 FastAPI + SQLAlchemy 2.0 异步 + Alembic，前端 Vue 3.5 + Vite 6 + TypeScript + Element Plus，数据库 MySQL 与 SQLite 双驱动自动切换，Redis 可选且缺失时自动降级为内存缓存。
开源项目：项目源码托管在 GitHub，方便开发者查看实现方式、参与开发，或者根据自己的需求进行二次定制。
