KevinLiss/ApeAdmin

Apeadmin 面向现代AI应用打造的Python后台管理框架，基于 FastAPI+Vue3 设计100%开源，内置 RBAC 权限管控、审计日志等企业级基础能力。框架集成 MCP‑SSE 网关，具备强大插件生态完整，帮助开发者快速搭建兼具业务管理与 AI 工具输出能力的应用。

什麼是 ApeAdmin？

ApeAdmin 是一個開源的、基於 FastAPI + Vue 3 的管理面板框架，專為現代 AI 應用而設計。它提供您期望的常見後台功能——使用者/角色管理、選單、稽核日誌、RBAC 等——但還額外加入了一個 模組化架構 和一個 MCP‑SSE 網關，讓 AI 代理可以將系統功能當作「工具」來呼叫。簡單來說，這是一個「後端即服務」，您可在數分鐘內安裝，並透過 Python 模組擴充，將業務邏輯暴露給人類使用者與大型語言模型代理。

核心功能

類別	功能說明
安裝精靈	WordPress 風格的三步驟設定（資料庫設定 → 網站與管理員 → 完成）。自動建立資料庫、產生 JWT 秘密，並在首次執行後鎖定安裝程式。
RBAC	五張資料表模型（使用者、角色、選單、部門、關聯）。四層權限檢查（未登入 → 無驗證 → 规則 → 資料範圍），以及前端 `v‑permission` 指令用於按鈕級別隱藏。
模組系統	透過 `importlib` 探測 Python 套件。模組可在執行時載入/卸載，擁有完整的生命週期（`load → install → register → uninstall`），並可作為 ZIP 檔案或從線上模組市場安裝。
MCP‑SSE 網關	將註冊的模組函數公開為工具、資源或提示，讓 AI 代理可透過 Server-Sent Events 呼叫。Schema 會自動根據函數簽章產生，呼叫會經過 RBAC 过濾，且每次呼叫都會記錄請求/回應與耗時。
AI 聊天	內建多模型聊天（DeepSeek、Qwen、GLM、OpenAI，或任何 OpenAI 兼容端點）。支援流式 SSE 輸出、Markdown 渲染，以及最多五輪的工具呼叫循環。模型金鑰以 Fernet 加密儲存。
稽核與監控	全域請求 ID、操作日誌、各 API 延遲追蹤，以及內建 ECharts 可視化的儀表板。
資料庫彈性	內建支援 SQLite（零設定）或 MySQL 用於生產環境；驅動程式透過 `DB_TYPE` 切換。可選 Redis 快取，若不可用則自動降級為記憶體快取。

哪些人可能會使用它？

使用情境	為何 ApeAdmin 適合
需要安全管理介面的 AI SaaS 平台，用於管理使用者、角色與自訂 AI 工具。
企業想將內部服務暴露給 LLM 代理，而無需撰寫專屬 API——只需將服務註冊為 MCP 工具即可。
開發者建構 AI 增強的內部工具（例如文件檢索、工作流程自動化），並偏好模組化模型以保持核心程式碼乾淨。
新創公司想快速搭建「管理面板 + AI 網關」，無需從零開始建構基礎架構。

技術堆疊概覽

層級	技術
後端	FastAPI、SQLAlchemy 2.0（非同步）、Alembic 迁移
前端	Vue 3.5、Vite 6、TypeScript 5.7、Element Plus、Pinia、ECharts
資料庫	MySQL（透過 `aiomysql`）或 SQLite（`aiosqlite`）
快取	Redis（可選）
驗證	JWT + bcrypt 密碼雜湊
AI 整合	MCP（模型上下文協定）透過 SSE，支援 DeepSeek、Qwen、GLM、OpenAI，或自訂 OpenAI 兼容端點
打包	MIT 授權，Docker 友好，亦可部署於裸機或透過常見主機控制面板

快速入門（最快路徑）

克隆倉儲，並導航至後端資料夾。

建立虛擬環境，以可編輯模式安裝套件，並啟動 FastAPI 伺服器：

cd backend
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
uvicorn src.main:app --reload --host 0.0.0.0 --port 8000

開啟另一個終端機，進入前端資料夾，安裝 npm 依賴並啟動開發伺服器：
```
cd frontend
npm install --legacy-peer-deps
npm run dev
```
訪問 http://localhost:5173。由於系統是全新的，會自動重導至 /setup。依照三步驟精靈操作（本地演示選 SQLite，生產環境選 MySQL），完成安裝。
使用您設定的管理員憑證登入，瀏覽 系統管理 → 模組，並嘗試從內建市場安裝一個範例模組。
若要試用 AI 聊天，請在 AI 助手 → 模型金鑰 中新增模型金鑰，然後開始對話；助理可呼叫已註冊的 MCP 工具（例如 system_list_plugins）。

擴充 ApeAdmin

建立模組：在 backend/src/plugins/builtin/ 下新增一個新的 Python 套件。實作 PluginInterface，包含 on_load、register_routes 和 register_mcp_tools 等方法。
公開工具：在 register_mcp_tools 中使用 @mcp_manager.tool 裝飾器；函數簽章會轉換為 JSON-Schema，讓 LLM 可以調用。
發佈模組：將模組打包為 ZIP 檔案，或推送到線上模組市場，讓其他使用者點擊即可安裝。

社群與貢獻

Fork → 分支（feat/…、fix/… 等）→ PR。請遵循倉儲的貢獻指南，包含提交風格與測試要求。
提供 WeChat 群組，用於即時支援與討論（QR 碼位於 README 中）。

總結：ApeAdmin 是一個即時可用、可擴充的管理框架，橋接傳統企業後端與現代 LLM 代理。若您需要一個安全的使用者介面、基於模組的擴充性，以及讓 AI 代理能將您的服務當作一等工具呼叫的方式，這個專案能為您提供一個堅實的開箱即用基礎。