🤖 All Model Chat

---

📖 项目简介 / Overview

All Model Chat 是一款基于 React 18 深度定制的高性能 AI 交互终端。它不仅支持传统的文本对话，更原生集成了 Google Gemini 3.0 & 2.5 系列模型的最前沿特性。

项目坚持 Local-First (本地优先) 原则，数据存储于浏览器 IndexedDB（浏览器数据库），无需后端服务器，在保障隐私的同时提供媲美原生应用的响应速度。它是你连接 Google 最强 AI 算力的全能工作桥梁。

---

✨ 核心能力 / Flagship Capabilities

🧠 深度推理 (Thinking)	🎙️ 实时音视频 (Live API)	🎨 智能看板 (Canvas)
思维链可视化：适配 Gemini 3.0，支持设置 Token 预算或推理等级 (Minimal-High)。实时查看 AI 的逻辑演算过程。	毫秒级交互：集成双向实时流。支持语音通话、屏幕共享视觉识别，配合动态 Orb 音频可视化。	Artifacts 模式：代码块自动识别预览。一键将信息转化为交互式 HTML 看板、ECharts 图表或 Mermaid 流程图。

📁 高级文件处理	🔍 生产力工具链	🔐 企业级 API 管理
智能压缩：客户端自动将音频转码为 16kHz MP3，节省 90% Token。支持 ZIP/文件夹拖入自动解析代码库。	深度搜索：聚合 Google Search，自动规划搜索任务并提供精准引用。内置 Python 代码沙箱运行环境。	多 Key 轮询：支持填入多个 API Key（应用程序接口密钥）自动分担压力。原生兼容 Vertex AI Express 代理端点。

---

🚀 快速开始 / Quick Start

1. 安装与运行

# 克隆仓库
git clone https://github.com/yeahhe365/All-Model-Chat.git
cd All-Model-Chat/all-model-chat

# 安装依赖
npm install

# 启动开发服务器
npm run dev

2. 配置密钥

访问 http://localhost:5173，在设置 -> API 密钥中填入你的 Gemini API Key。

💡 提示: 你也可以在根目录创建 .env.local 填入 GEMINI_API_KEY=xxx 实现自动加载。

---

🛠️ 技术架构 / Technical Architecture

核心框架	React 18 + TypeScript 5.5 + Vite 5 (极速 HMR)
持久化层	原生 IndexedDB (封装 db.ts)，支持原子化事务与大数据量日志存储
音频引擎	AudioWorklet API (音频处理接口) (实时流处理) + Lamejs (Web Worker (网页工作线程) 异步压缩)
渲染引擎	React-Markdown + KaTeX (公式) + Highlight.js (代码) + Mermaid.js
网络拦截	自定义 Network Interceptor (网络拦截器)，动态重写 SDK 请求路径以兼容各类代理与 Vertex AI (谷歌云 AI 平台)

---

📂 项目结构 / Structure

src/
├── components/          # 模块化 UI 组件
│   ├── chat/            # 输入框、消息列表、Live 状态条
│   ├── message/         # 消息渲染引擎 (Markdown, 代码块, 思考过程)
│   ├── log-viewer/      # 开发者日志面板 (实时监控 API 与 Token)
│   └── modals/          # 场景市场、文件配置、导出等功能弹窗
├── hooks/               # 核心逻辑 (逻辑与视图分离)
│   ├── live-api/        # WebRTC (实时通信协议)、音视频流媒体处理逻辑
│   ├── message-sender/  # 消息发送编排 (流式处理、错误拦截)
│   └── file-upload/     # 文件预处理、MP3 压缩策略
├── services/            # 外部服务 (Gemini SDK 深度封装)
└── utils/               # 工具类 (文件夹上下文解析、IndexedDB 包装)

---

🤝 参与贡献 / Contribution

我们欢迎任何形式的贡献！

1. 报告问题：提交 GitHub Issue。
2. 代码贡献：Fork 仓库 -> 创建特性分支 -> 提交 Pull Request (代码合并请求)。
3. 支持作者：点个 Star (星标) ⭐️ 或前往 爱发电 支持持续开发。

---

All-Model-Chat 快速上手指南

All-Model-Chat 是一款专为 Google Gemini API 生态打造的旗舰级全能 AI 工作台。它基于 React 18 构建，坚持 Local-First（本地优先） 原则，所有数据存储在浏览器 IndexedDB 中，无需后端服务器，兼顾隐私与高性能。

🛠️ 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows / macOS / Linux
• Node.js：建议版本 v18.0+（支持 React 18 与 Vite 5）
• Git：用于克隆代码仓库
• 网络环境：需能访问 GitHub 及 Google AI Studio API

💡 国内开发者加速建议： 若安装依赖较慢，建议配置国内镜像源或使用 pnpm：

# 临时使用淘宝镜像安装
npm install --registry=https://registry.npmmirror.com

# 或全局切换
npm config set registry https://registry.npmmirror.com

📦 安装步骤

按照以下步骤在本地启动项目：

1. 克隆仓库

   git clone https://github.com/yeahhe365/All-Model-Chat.git
   cd All-Model-Chat/all-model-chat
   

2. 安装依赖

   npm install
   

3. 启动开发服务器

   npm run dev
   

   终端将显示访问地址，通常为 http://localhost:5173。

🚀 基本使用

1. 访问应用

打开浏览器，访问控制台提示的本地地址（如 http://localhost:5173）。

2. 配置 API 密钥

首次进入需要配置 Google Gemini API Key：

• 方式一（推荐）：点击界面右上角 设置 -> API 密钥，填入您的 Key 即可立即使用。
• 方式二（环境变量）：在项目根目录创建 .env.local 文件，填入以下内容实现自动加载：

  GEMINI_API_KEY=your_api_key_here
  

3. 开始对话

配置完成后，您即可在输入框发送消息。工具将自动调用 Gemini 模型进行响应，并支持查看思维链、实时音视频交互及代码看板等高级功能。

---

注：所有聊天记录与配置均存储于本地浏览器，刷新页面不会丢失数据。