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 操作和快速選擇
自動提交功能: 倒數計時器和自動回饋提交機制
會話管理功能: 會話歷史追蹤和統計分析（v2.4.3 重構增強）
音效通知系統: 智能音效提醒和自訂音效管理（v2.4.3 新增）
智能記憶功能: 輸入框高度記憶和一鍵複製（v2.4.3 新增）
多語言支援: 繁體中文、簡體中文、英文動態切換

技術棧

後端: Python 3.11+, FastAPI, FastMCP
前端: HTML5, JavaScript ES6+, WebSocket, Web Audio API（v2.4.3）
通信: WebSocket, HTTP REST API
存儲: localStorage（會話歷史、音效文件、設定記憶）
部署: uvicorn, 跨平台支援

🎯 快速導航

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

📊 架構圖表

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

系統整體架構圖
組件關係圖
交互流程圖
會話生命週期圖
部署拓撲圖
音效通知系統架構圖（v2.4.3 新增）
會話管理重構流程圖（v2.4.3 新增）
智能記憶功能架構圖（v2.4.3 新增）

🆕 v2.4.3 版本亮點

🔊 音效通知系統

內建音效: 經典提示音、通知鈴聲、輕柔鐘聲
自訂音效: 支援 MP3、WAV、OGG 格式上傳
智能播放: 會話更新時自動播放通知音效
音量控制: 0-100% 可調節音量
瀏覽器相容: 處理自動播放政策限制

📋 會話管理重構

頁籤化設計: 從側邊欄遷移到獨立頁籤，解決瀏覽器相容性問題
本地歷史存儲: 支援 72 小時可配置保存期限
隱私控制: 三級用戶訊息記錄設定（完整/基本/停用）
數據管理: 匯出和清理功能
詳情查看: 專門的會話詳情彈窗

🧠 智能記憶功能

輸入框高度記憶: 自動保存和恢復輸入框高度
一鍵複製: 專案路徑和會話ID點擊複製
設定持久化: 用戶偏好自動保存
國際化支援: 複製提示支援多語言

版本: 2.4.3 最後更新: 2025年6月14日 維護者: Minidoracat 架構類型: Web-Only 四層架構 v2.4.3 新功能: 音效通知系統、會話管理重構、智能記憶功能、一鍵複製 歷史功能: 提示詞管理、自動提交、會話管理、語系切換優化 文檔狀態: ✅ 已完成 v2.4.3 全面更新，包含所有新功能的詳細說明和架構分析

4.1 KiB Raw Blame History Unescape Escape