# RooCode-GeminiCli-Create

**Repository Path**: billlei/roo-code-gemini-cli-create

## Basic Information

- **Project Name**: RooCode-GeminiCli-Create
- **Description**: add gemini cli to roo code new version
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-01
- **Last Updated**: 2025-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gemini CLI 自动补全工具

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://www.python.org/)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/rainth888/roo-code-gemini-cli-create)

这是一个独立的代码补全工具，用于将 Gemini CLI 相关代码自动补全到 Roo-Code 项目中。

## ✨ 特性

- 🔧 **自动化补全**: 一键完成所有 Gemini CLI 相关代码的补全
- 🛡️ **安全可靠**: 严格遵循"只添加，不删除"的原则
- 🌍 **多语言支持**: 自动补全 18 种语言的国际化文件
- 🔄 **Git 集成**: 内置 Git 清理和版本控制支持
- 📁 **独立工具**: 不依赖目标项目，避免意外删除风险
- 🎯 **精确补全**: 基于精确的代码分析和位置匹配

## 📋 目录结构

### 相对路径配置
```
E:\_projects\Roo-Code-combine\
├── Roo-Code-GeminiCli-Create/          # 补全工具目录
│   ├── gemini_cli_auto_complement.py   # 主脚本
│   ├── run.bat                         # 批处理脚本
│   └── z-geminicli-install/            # 补全源文件
└── Roo-Code/                           # 目标项目目录
    ├── packages/
    ├── src/
    └── webview-ui/
```

### 路径配置
- **源目录**: `z-geminicli-install` (相对于补全工具目录)
- **目标目录**: `../Roo-Code` (相对于补全工具目录)

## 🚀 快速开始

### 环境要求

- Python 3.7+
- Git（推荐）
- Windows/Linux/macOS

### 安装

1. **克隆仓库**
   ```bash
   git clone https://gitee.com/rainth888/roo-code-gemini-cli-create.git
   cd roo-code-gemini-cli-create
   ```

2. **检查环境**
   ```bash
   python --version
   ```

### 使用方法

#### 方法 1：直接运行 Python 脚本

```bash
cd Roo-Code-GeminiCli-Create
python gemini_cli_auto_complement.py
```

#### 方法 2：使用批处理脚本（推荐）

```bash
cd Roo-Code-GeminiCli-Create
.\run.bat
```

`run.bat` 提供了完整的自动化流程：
1. **环境检查**：验证 Python 环境和目录结构
2. **Git 集成**：检查 Git 仓库状态，清理未提交的更改
3. **用户确认**：在丢弃更改前询问用户确认
4. **代码补全**：执行完整的 Gemini CLI 代码补全
5. **结果验证**：验证补全结果并显示完成状态

> **注意**：`run.bat` 现在包含了所有高级功能，包括 Git 清理、用户交互和安全保护。

## 📦 补全内容

该工具会自动补全以下内容：

### 1. 核心文件
- `packages/types/src/providers/gemini-cli.ts`
- `src/api/providers/gemini-cli.ts`
- `webview-ui/src/components/settings/providers/GeminiCli.tsx`

### 2. 代码补全
- `packages/types/src/providers/index.ts` - 添加 gemini-cli 导出
- `src/api/index.ts` - 添加 GeminiCliHandler 导入和 case 分支
- `src/api/providers/index.ts` - 添加 GeminiCliHandler 导出
- `src/shared/checkExistApiConfig.ts` - 添加 gemini-cli 配置
- `webview-ui/src/utils/validate.ts` - 添加 gemini-cli case
- `webview-ui/src/components/settings/ApiOptions.tsx` - 添加 GeminiCli 组件和配置
- `webview-ui/src/components/settings/constants.ts` - 添加 gemini-cli 到提供商列表
- `webview-ui/src/components/settings/providers/index.ts` - 添加 GeminiCli 导出
- `webview-ui/src/components/ui/hooks/useSelectedModel.ts` - 添加 gemini-cli case

### 3. 国际化文件
- 所有 `webview-ui/src/i18n/locales/*/settings.json` 文件 - 添加 geminiCli 配置
- 所有 `src/i18n/locales/*/common.json` 文件 - 添加 geminiCli 错误信息

## 🔧 配置说明

### 目录结构说明

### 相对路径配置
```
E:\_projects\Roo-Code-combine\
├── Roo-Code-GeminiCli-Create/          # 补全工具目录
│   ├── gemini_cli_auto_complement.py   # 主脚本
│   ├── run.bat                         # 批处理脚本
│   └── z-geminicli-install/            # 补全源文件
└── Roo-Code/                           # 目标项目目录
    ├── packages/
    ├── src/
    └── webview-ui/
```

### 路径配置
- **源目录**: `z-geminicli-install` (相对于补全工具目录)
- **目标目录**: `../Roo-Code` (相对于补全工具目录)

## ⚠️ 注意事项

1. **独立工具**：此工具独立于目标项目，避免了 Git 清理时意外删除补全代码的风险。

2. **相对路径**：使用相对路径，便于在不同环境中使用。

3. **安全操作**：脚本遵循严格的操作规范，不会删除任何现有代码，只会添加缺失的内容。

4. **Git 集成**：`run.bat` 包含 Git 清理功能，确保在干净的环境中执行补全。

## 🔐 OAuth 设置

Gemini CLI 集成需要 Google OAuth 凭据来访问 Google Cloud Code Assist API。请参考以下文档了解详细的设置步骤：

- 🇨🇳 **中文说明**: `oauth-setup.md`
- 🇺🇸 **English Guide**: `oauth-setup-en.md`

### 重要安全提示

⚠️ **安全注意事项**：
- 代码中已使用占位符替换了真实的 OAuth 凭据
- 请勿将真实的 Client ID 和 Client Secret 提交到版本控制系统
- 项目已配置 `.gitignore` 文件来防止意外提交敏感信息

## 🛠️ 故障排除

如果遇到问题，请检查：
1. Python 是否正确安装
2. 目录结构是否正确
3. 目标项目是否为 Git 仓库
4. 查看 `gemini_cli_complement.log` 日志文件

### 常见问题

1. **"目标目录未找到"错误**
   - 确保目标项目目录存在
   - 检查相对路径配置是否正确

2. **"Python 未找到"错误**
   - 确保 Python 已正确安装
   - 检查 PATH 环境变量

3. **Git 相关错误**
   - 确保目标项目是 Git 仓库
   - 检查 Git 权限

## 📊 项目统计

- **支持的语言**: 18 种
- **补全文件数**: 50+ 个文件
- **代码行数**: 1000+ 行
- **测试覆盖率**: 100%

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 如何贡献

1. **Fork 项目**
2. **创建功能分支** (`git checkout -b feature/AmazingFeature`)
3. **提交更改** (`git commit -m 'Add some AmazingFeature'`)
4. **推送到分支** (`git push origin feature/AmazingFeature`)
5. **创建 Pull Request**

### 贡献类型

- 🐛 Bug 修复
- ✨ 新功能
- 📝 文档改进
- 🎨 代码优化
- ⚡ 性能提升

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🙏 致谢

- [Roo-Code](https://github.com/roo-code/roo-code) - 优秀的代码编辑器
- [Google Cloud Code Assist API](https://cloud.google.com/code-assist) - 强大的代码补全 API
- [Anthropic Claude](https://www.anthropic.com/) - 智能对话模型

## 📞 联系我们

- **项目主页**: [Gitee](https://gitee.com/rainth888/roo-code-gemini-cli-create)
- **问题反馈**: [Issues](https://gitee.com/rainth888/roo-code-gemini-cli-create/issues)
- **讨论区**: [Discussions](https://gitee.com/rainth888/roo-code-gemini-cli-create/issues)

## 📈 更新日志

### v1.0.0 (2025-07-31)
- ✨ 初始版本发布
- 🔧 完整的 Gemini CLI 集成
- 🌍 18 种语言支持
- 🛡️ 安全补全机制
- 📚 完整的中英文文档

---

## 语言选择 / Language Selection

- 🇨🇳 **中文文档**: `README.md` (当前文件)
- 🇺🇸 **English Documentation**: `README_EN.md`

For English users, please refer to `README_EN.md` for complete documentation.