mcp-feedback-enhanced/docs/architecture/README.md

MCP Feedback Enhanced 架構文檔

📋 文檔索引

本目錄包含 MCP Feedback Enhanced 專案的完整架構文檔，提供深入的技術分析和設計說明。

📚 文檔結構

文檔	描述	適用對象
系統架構總覽	整體架構設計、核心概念和技術亮點	架構師、技術負責人
組件詳細說明	各層級組件的詳細功能和實現	開發人員、維護人員
交互流程文檔	AI 助手與 MCP 服務的完整交互流程	集成開發人員
API 參考文檔	MCP 工具接口和 WebSocket API 規範	API 使用者、前端開發
部署指南	環境配置、部署選項和故障排除	運維人員、系統管理員

🏗️ 架構概覽

MCP Feedback Enhanced 採用單一活躍會話 + 持久化 Web UI的創新架構，實現了 AI 助手與用戶之間的無縫交互體驗。

核心特性

• 智能環境檢測: 自動識別 Local/SSH Remote/WSL 環境
• 單一活躍會話: 替代傳統多會話管理，提升性能和用戶體驗
• 持久化 Web UI: 支援多次循環調用，無需重複開啟瀏覽器
• 實時雙向通信: WebSocket 實現前後端狀態同步
• 智能資源管理: 自動清理和會話生命週期管理
• 提示詞管理系統: 常用提示詞的 CRUD 操作和快速選擇
• 自動提交功能: 倒數計時器和自動回饋提交機制
• 會話管理功能: 會話歷史追蹤和統計分析
• 多語言支援: 繁體中文、簡體中文、英文動態切換

技術棧

• 後端: Python 3.11+, FastAPI, FastMCP
• 前端: HTML5, JavaScript ES6+, WebSocket
• 通信: WebSocket, HTTP REST API
• 部署: uvicorn, 跨平台支援

🎯 快速導航

• 新手入門: 從 系統架構總覽 開始
• 深入理解: 閱讀 組件詳細說明
• 集成開發: 參考 交互流程文檔 和 API 參考文檔
• 部署運維: 查看 部署指南

📊 架構圖表

所有文檔都包含豐富的 Mermaid 圖表，包括：

• 系統整體架構圖
• 組件關係圖
• 交互流程圖
• 會話生命週期圖
• 部署拓撲圖

---

版本: 2.4.0 最後更新: 2025年6月 維護者: Minidoracat 架構類型: Web-Only 四層架構 新功能: 提示詞管理、自動提交、會話管理、語系切換優化 文檔狀態: ✅ 已完成全面更新，包含所有新功能的詳細說明