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

# MCP Feedback Enhanced 架構文檔

## 📋 文檔索引

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

### 📚 文檔結構

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

### 🏗️ 架構概覽

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, 跨平台支援

### 🎯 快速導航

- **新手入門**: 從 [系統架構總覽](./system-overview.md) 開始
- **深入理解**: 閱讀 [組件詳細說明](./component-details.md)
- **集成開發**: 參考 [交互流程文檔](./interaction-flows.md) 和 [API 參考文檔](./api-reference.md)
- **部署運維**: 查看 [部署指南](./deployment-guide.md)

### 📊 架構圖表

所有文檔都包含豐富的 Mermaid 圖表，包括：
- 系統整體架構圖
- 組件關係圖
- 交互流程圖
- 會話生命週期圖
- 部署拓撲圖

---

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