Gemini Nexus Bot
42466c274b
- Add LICENSE-MIT for all new code written by evandrodevbr - Rewrite License section: dual structure (original code CC-BY-NC-SA, new code MIT) - Add migration notice: project is transitioning to fully open-source MIT - Rewrite Credits section: accurately attribute what Draculabo created vs what evandrodevbr rewrote - Remove outdated 'commercial use prohibited' disclaimer - Applied across all 4 languages (EN, PT-BR, ES, ZH-CN)
12 KiB
Gemini Nexus
🚀 专业的多账户 AI 网关，支持 Google Gemini 和 Claude
English | Português | 中文 | Español
Important
Windows 用户： 如果在安装过程中看到 “Windows 已保护你的电脑” (SmartScreen) 警告，请点击 “更多信息” (More info)，然后点击 “仍要运行” (Run anyway)。这是未签名的新应用预期的安全提示，属于正常现象。
📖 目录
✨ 为什么选择 Gemini Nexus？
在使用 AI 驱动的 IDE 和编程工具时，你是否遇到过这些问题？
- 😫 配额限制： 单个账户配额很快用完，需要频繁手动切换。
- 🔄 账户管理： 管理多个 Google/Claude 账户非常繁琐。
- 📊 盲目使用： 不知道已经消耗了多少 Token 或还剩多少配额。
- 🔌 集成问题： 需要一个可靠的本地 API 代理，并且必须原生支持 OpenAI/Anthropic 协议。
- 🔍 缺乏透明度： 无法查看代理在后台实际发送或接收的数据。
Gemini Nexus 解决所有这些问题。它是一个专业的 Electron 桌面应用，作为你的开发工具和 Google Gemini / Claude AI 之间的智能网关。
核心价值主张
- ✅ 无限账户池 — 添加任意数量的 Google Gemini 和 Claude 账户。
- ✅ 智能自动切换 — 当配额不足或被限速时自动轮换到下一个可用账户。
- ✅ 实时使用分析 — SaaS 级仪表板，配备面积图、趋势指标和模型分布。
- ✅ 完整的代理可观测性 — 实时流量监控、请求重放和模型能力检查器。
- ✅ 兼容 OpenAI 和 Anthropic — 即插即用的代理，支持 Cursor、Windsurf、OpenCode 以及任何兼容 OpenAI 的工具。
- ✅ 默认安全 — AES-256-GCM 加密，配合操作系统原生凭证管理。
🎯 功能特性
☁️ 云端账户池
|
📊 使用分析仪表板
|
🔌 本地 API 代理（网关）
|
🔄 智能自动切换
|
🔍 代理可观测性（高级）
|
🔐 安全与加密
|
⚙️ 设置与自定义
|
🖥️ 桌面体验
|
📸 截图
⚡ 安装与快速开始
📦 下载
您可以从我们的 Releases 页面 下载适用于 Windows、macOS 和 Linux 的最新预编译版本。
(如果您使用的是 Windows 并在安装时遇到了 SmartScreen 提示，请参阅页面顶部的警告)。
🔌 配合 AI IDE 使用
在代理运行并至少添加一个账户后，配置您首选的 IDE（Cursor、Windsurf、OpenCode 等）：
API Base URL: http://localhost:10100/v1
API Key: （从应用的 Proxy 页面复制）
Model: gemini-3-flash （或您选择的任何映射模型）
🛠️ 从源码构建
前置要求
- Node.js v20 或更高版本
- npm （本项目使用
package-lock.json）
步骤
# 克隆仓库
git clone https://github.com/evandrodevbr/GeminiNexus.git
cd GeminiNexus
# 安装依赖
npm install
# 启动开发环境
npm start
# 构建生产版本（例如 Windows 安装程序）
npm run make
🛠️ 技术栈
| 分类 | 技术 |
|---|---|
| 核心 | Electron, React 19, TypeScript |
| 构建 | Vite, Electron Forge |
| 样式 | Tailwind CSS v4, Radix UI, Lucide Icons |
| 状态 | TanStack Query, TanStack Router |
| 后端 | NestJS (内部网关), ORPC (类型安全 RPC) |
| 数据库 | Better-SQLite3, Drizzle ORM |
| 图表 | Nivo (Line, Bar, Pie) |
| 测试 | Vitest, Playwright |
💻 开发
# 启动开发环境 (Electron + Vite HMR)
npm start
# 运行代码规范检查
npm run lint
# 类型检查
npm run type-check
# 格式化代码
npm run format:write
# 运行测试
npm test
❓ 常见问题
问：安装时出现 Windows SmartScreen 警告（"Windows 已保护你的电脑"）？
是的，对于未签名的新应用，这是一个常见的警告。请点击 "更多信息" (More info)，然后点击 "仍要运行" (Run anyway)。详情请参阅 README 顶部的提示。
问：从源码构建时应用无法启动？
- 确保所有依赖均已安装：
npm install - 检查 Node.js 版本是否 >= 20。
- 尝试删除
node_modules并重新安装。 - 在 Windows 上，请确保已安装 WiX Toolset 以便执行
npm run make命令。
问：账户登录失败？
- 确保您的网络连接正常。
- 尝试清除应用数据并重新登录。
- 检查该账户是否已被 Google/Claude 限制。
问：IDE 无法连接到代理？
- 确保代理正在运行（查看状态栏的绿色指示器）。
- 确认端口与您 IDE 中的配置一致（默认为
10100）。 - 直接从 Proxy 页面复制 API 密钥并粘贴到 IDE 设置中。
- 确保在 Accounts 页面中至少有一个活跃的账户。
问：Token 计数显示为零？
- 这是早期版本中的一个已知漏洞 — 请更新至最新版本。
- 目前 Token 追踪功能已能正确处理流式元数据及预估计数。
- 使用数据会在 Usage Analytics 页面每 15 秒自动刷新。
🤝 参与贡献
欢迎贡献代码！详情请参阅 CONTRIBUTING.md。
📄 许可证
本项目采用双重许可结构：
- 原始代码来自 Draculabo 的 AntigravityManager：采用 CC BY-NC-SA 4.0 许可。
- 所有新代码、功能和架构由 evandrodevbr 开发：采用 MIT 许可证。
🔄 迁移通知： 本项目正在积极迁移到完全开源许可证（MIT）。随着剩余原始代码的逐步重写，整个项目将过渡到 MIT。我们致力于将 Gemini Nexus 打造为 100% 开源项目。
🙏 致谢
本项目最初是从 Draculabo 创建的 AntigravityManager 分支而来的。最初的代理概念和早期的 Electron 框架基于他的工作。
自从分支以来，evandrodevbr 重写、重新设计并扩展了绝大部分代码库，包括但不限于：
- 完整的 UI/UX 重新设计（导航、账户、使用分析、代理管理）
- 使用分析仪表板，包含成本跟踪、Token 平均值以及 OpenRouter 集成
- 流量监视器，提供按请求查看的 Token/成本检查
- 环境隔离（dev/prod）、CI/CD 流水线和测试基础设施
- IDE 快速设置（OpenCode、Cursor、VS Code、Claude Code）
- 自定义模型定价配置
- 所有文档和国际化（EN, PT-BR, ES, ZH-CN）