项目概述
1、项目名称
搭建高效开发环境:VSCode + Roo Code + Gemini 2.5 Pro + Gemini Balance
2、项目背景
在现代软件开发中,选择合适的开发工具和环境对于提高工作效率和代码质量至关重要。VSCode 是一款功能强大的代码编辑器,广泛用于各种编程语言的开发。Roo Code 是一款支持快速开发的框架,而 Gemini 2.5 Pro 和 Gemini Balance 则是用于项目管理和性能监控的工具。将这些工具结合在一起,可以构建一个高效、灵活的开发环境。
3、项目目标
本项目旨在通过整合 VSCode、Roo Code、Gemini 2.5 Pro 和 Gemini Balance,创建一个高效的开发环境,以支持快速开发、代码管理和性能监控。通过这一环境,开发者可以更轻松地进行项目开发,提升团队协作效率,并有效管理项目进度和性能。
配置概述
1、VsCode:轻量级、开源的代码编辑器
Visual Studio Code(简称 VSCode)是由微软开发的一款轻量级、开源的代码编辑器。它支持多种编程语言,提供了强大的功能和灵活的扩展性,使其成为开发者在各种开发环境中首选的工具之一。
2、RooCode:为AI辅助编码而生的强大插件
Roo Code 是一款AI编程助手插件,与通义灵码类似,他们都提供了强大的编程支持,此外他还集成了多个AI模型,允许通过简单的配置实现与不同大型模型的交互。借助这一插件,开发者可以体验到全方位的智能辅助,包括自动化编程、代码补全以及问答式编程指导等,Roo Code 都能提供精准而高效的支持。
RooCode 的设计理念,是成为一个深度融入你项目生态、能够理解你整个代码库上下文的、个性化的AI编码伙伴。

3、Gemini 2.5 Pro:编码能力的革命性突破
Gemini 2.5 Pro 模型是一个先进的人工智能模型,旨在提供高效的自然语言处理和生成能力。它基于最新的深度学习技术,能够理解和生成自然语言文本,广泛应用于对话系统、内容生成、文本分析等多个领域。
Gemini 2.5 Pro 在代码智能方面实现显著提升:
- 卓越的代码生成能力:特别擅长前端和UI开发领域,生成的代码兼具精准性、美观性和功能完整性
- 精准技术解答:能深入理解复杂技术问题,提供更准确的解决方案
- 深度上下文理解:可更好地把握代码上下文,给出更贴合实际的建议
- 高效文档生成:自动产出优质代码注释和文档,大幅提升代码可维护性
- 流畅的多语言转换:能轻松实现不同编程语言间的代码转换
4、Gemini Balance:Gemini轮询代理服务
Gemini Balance 是一个基于 Python FastAPI 构建的强大应用程序,旨在为您提供 Google Gemini API 的代理和负载均衡功能。🚀 它可以帮助您轻松管理多个 Gemini API Key,并通过简单的配置实现 Key 的智能轮询、安全认证、灵活模型过滤和实时状态监控。
文档地址:https://gb-docs.snaily.top/guide/introduction.html
GitHub项目地址:https://github.com/snailyp/gemini-balance
项目搭建
1、VsCode安装(自行查询)
2、Roo Code 插件安装(详细请查看该博客)
在代码编辑器(如 VS Code 或 IntelliJ IDEA)中:
- 进入插件/扩展市场
- 搜索并安装 "Roo Code"
- 重启编辑器完成安装打开你的代码编辑器(如VS Code、IntelliJ IDEA等)

3、获取Gemini 2.5 Pro API Key
- 登录谷歌 AI Studio
点击链接,跳转 Sign in to Google AI Studio,然后登录你的谷歌账号。

- 创建 API Key


- 保存 API Key

4、Roo Code 配置
- 点击打开Roo Code

- 配置刚刚获取到的Api Key,点击完成

- 选择对应模式

- 设置其操作权限,进行提问


5、Gemini Balance搭建(AI辅助可选)
- 安装Augment插件/Cursor插件 ,后续进行辅助搭建 (可选 )

- 提前安装Docker和Mysql环境(重点)
如果你是Mac用户的话,可以直接在终端进行安装 。
如果你是Window用户的话,你有两种选择,购买"云服务器"或者搭建"Docker虚拟机"环境。 - 克隆Gemini Balance项目
bash
git clone https://github.com/snailyp/gemini-balance.git
- 通过Augment插件/Cursor插件去部署Gemini Balance项目(可选)
- 先让Augment熟悉Gemini Balance项目(其会分析该项目的整体结构 )

- 将我们对于的Api Key(可以部署多个)、Mysql账号密码 交给Augment插件/Cursor插件,让其生成对应的env和docker-compose.yml文件


- 启动项目(docker-compose up -d )



- 访问主页:http://localhost:8000 (输入对应密码:sk-123456 )


- 在对应Gemini Balance项目网页上,可以进行Api Key的监控和负载均衡


- 直接复制下方的对应env和docker-compose.yml 文件部署Gemini Balance项目(适合window电脑,使用docker进行配置)
创建env文件
bash
# 数据库配置
DATABASE_TYPE=mysql
MYSQL_HOST=host.docker.internal
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=密码
MYSQL_DATABASE=数据库
API_KEYS=["填写对应的api-key"]
ALLOWED_TOKENS=["sk-123456"] # Gemini Balance平台登录密码
AUTH_TOKEN=sk-123456
# For Vertex AI Platform API Keys
VERTEX_API_KEYS=[]
# For Vertex AI Platform Express API Base URL
VERTEX_EXPRESS_BASE_URL=https://aiplatform.googleapis.com/v1beta1/publishers/google
TEST_MODEL=gemini-1.5-flash
THINKING_MODELS=[]
THINKING_BUDGET_MAP={}
IMAGE_MODELS=["gemini-2.0-flash-exp"]
SEARCH_MODELS=["gemini-2.0-flash-exp","gemini-2.0-pro-exp"]
FILTERED_MODELS=["gemini-1.0-pro-vision-latest", "gemini-pro-vision", "chat-bison-001", "text-bison-001", "embedding-gecko-001"]
# 是否启用网址上下文,默认启用
URL_CONTEXT_ENABLED=false
URL_CONTEXT_MODELS=["gemini-2.5-pro","gemini-2.5-flash","gemini-2.5-flash-lite","gemini-2.0-flash","gemini-2.0-flash-live-001"]
TOOLS_CODE_EXECUTION_ENABLED=false
SHOW_SEARCH_LINK=true
SHOW_THINKING_PROCESS=true
BASE_URL=https://generativelanguage.googleapis.com/v1beta
MAX_FAILURES=10
MAX_RETRIES=3
CHECK_INTERVAL_HOURS=1
TIMEZONE=Asia/Shanghai
# 请求超时时间(秒)
TIME_OUT=300
# 代理服务器配置 (支持 http 和 socks5)
# 示例: PROXIES=["http://user:pass@host:port", "socks5://host:port"]
PROXIES=[]
# 对同一个API_KEY使用代理列表中固定的IP策略
PROXIES_USE_CONSISTENCY_HASH_BY_API_KEY=true
#########################image_generate 相关配置###########################
PAID_KEY=AIzaSyCHiTeXju18XgihKluyO66OU2yZQhRDQwk
CREATE_IMAGE_MODEL=imagen-3.0-generate-002
UPLOAD_PROVIDER=smms
SMMS_SECRET_TOKEN=
PICGO_API_KEY=
CLOUDFLARE_IMGBED_URL=
CLOUDFLARE_IMGBED_AUTH_CODE=
CLOUDFLARE_IMGBED_UPLOAD_FOLDER=
##########################################################################
#########################stream_optimizer 相关配置########################
STREAM_OPTIMIZER_ENABLED=false
STREAM_MIN_DELAY=0.016
STREAM_MAX_DELAY=0.024
STREAM_SHORT_TEXT_THRESHOLD=10
STREAM_LONG_TEXT_THRESHOLD=50
STREAM_CHUNK_SIZE=5
##########################################################################
######################### 日志配置 #######################################
# 日志级别 (debug, info, warning, error, critical),默认为 info
LOG_LEVEL=info
# 是否开启自动删除错误日志
AUTO_DELETE_ERROR_LOGS_ENABLED=true
# 自动删除多少天前的错误日志 (1, 7, 30)
AUTO_DELETE_ERROR_LOGS_DAYS=7
# 是否开启自动删除请求日志
AUTO_DELETE_REQUEST_LOGS_ENABLED=false
# 自动删除多少天前的请求日志 (1, 7, 30)
AUTO_DELETE_REQUEST_LOGS_DAYS=30
##########################################################################
# 假流式配置 (Fake Streaming Configuration)
# 是否启用假流式输出
FAKE_STREAM_ENABLED=True
# 假流式发送空数据的间隔时间(秒)
FAKE_STREAM_EMPTY_DATA_INTERVAL_SECONDS=5
# 安全设置 (JSON 字符串格式)
# 注意:这里的示例值可能需要根据实际模型支持情况调整
SAFETY_SETTINGS=[{"category": "HARM_CATEGORY_HARASSMENT", "threshold": "OFF"}, {"category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "OFF"}, {"category": "HARM_CATEGORY_SEXUALLY_EXPLICIT", "threshold": "OFF"}, {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "OFF"}, {"category": "HARM_CATEGORY_CIVIC_INTEGRITY", "threshold": "BLOCK_NONE"}]
URL_NORMALIZATION_ENABLED=false
# tts配置
TTS_MODEL=gemini-2.5-flash-preview-tts
TTS_VOICE_NAME=Zephyr
TTS_SPEED=normal
#########################Files API 相关配置########################
# 是否启用文件过期自动清理
FILES_CLEANUP_ENABLED=true
# 文件过期清理间隔(小时)
FILES_CLEANUP_INTERVAL_HOURS=1
# 是否启用用户文件隔离(每个用户只能看到自己上传的文件)
FILES_USER_ISOLATION_ENABLED=true
##########################################################################
创建docker-compose.yml文件
bash
services:
gemini-balance:
image: ghcr.io/snailyp/gemini-balance:latest
container_name: gemini-balance
restart: unless-stopped
ports:
- "8000:8000"
env_file:
- .env
healthcheck:
test: ["CMD-SHELL", "python -c \"import requests; exit(0) if requests.get('http://localhost:8000/health').status_code == 200 else exit(1)\""]
interval: 30s
timeout: 5s
retries: 3
start_period: 10s
启动项目(docker-compose up -d )创建容器Container



-
成功创建在docker中创建Container容器

-
访问主页:http://localhost:8000 (输入对应密码:sk-123456 )


-
在对应Gemini Balance项目网页上,可以进行Api Key的监控和负载均衡

