yeahhe365/AMC-WebUI

解决的问题

AMC WebUI 提供了一个全面的、以本地优先的界面来与 AI 模型进行交互，主要专注于 Google Gemini 的原生功能，同时保持与 OpenAI 标准聊天 API 的兼容性。它将深度推理、实时音频/视频和高级工具集成整合到一个控制台中，消除了对多个独立界面的需求。

运作方式

该项目构建为 Vite + React SPA，遵循“本地优先”原则，聊天数据存储在浏览器的 IndexedDB 中以确保隐私和速度。它可以通三种方式部署：作为标准静态网站、通过 Docker Compose（结合前端和 Node.js API 代理），或作为 Cloudflare Pages 上的静态前端并配合独立的 API 后端。系统支持直接浏览器到 API 的通信 (BYOK) 以及用于安全代理的服务器端密钥管理。

目标用户

希望为 Gemini 的高级功能（如 Live API 和 Thinking 模型）提供强大且以隐私为中心的 UI 的用户，以及需要统一控制台来管理多个 AI 提供商和 MCP 工具的开发者。

特色亮点

• Gemini 原生集成：全面支持 Thinking（思维链可视化）、Live API（实时语音/视觉）和 Gemini Files API。
• 本地 Python 沙盒：使用 Pyodide (WASM) 的浏览器内 Python 环境，可自动加载 numpy 和 pandas 等科学库。
• 模型上下文协议 (MCP)：通过 Node API 支持 MCP，包括工具调用的人工审核授权。
• 实时 Artifacts：自动将代码块渲染为交互式 HTML、SVG、Mermaid 图表和 Graphviz 图表。
• 企业级 API 管理：支持 Gemini 和兼容 OpenAI 的 API 双模式，具备多密钥轮换和配置隔离功能。
• PWA 支持：可安装为桌面或移动应用，支持离线 Shell 访问和画中画模式。
• 高级文件处理：浏览器端音频预处理，并支持 ZIP/文件夹上传以映射代码库结构。