docs: sync all localized READMEs (RU/ZH/ES) with current install flow

- Update product table versions everywhere (claude v2.1.112, codex v0.116.0, gemini v0.35.3, qwen v0.14.5)
- Replace outdated bash heredocs with one-liner installer scripts
- Add Windows PowerShell + Windows CMD entry points
- Update claude/README*.md: drop git clone snippets, use uclaude_install.ps1 one-liner

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
delta-cloud-208e
2026-04-21 10:06:22 +00:00
parent 1bbeedf8e2
commit 95d53ba750
8 changed files with 652 additions and 363 deletions

View File

@@ -2,12 +2,63 @@
<!-- VERSION_BADGE:START -->
Пропатченный Gemini CLI для работы с кастомными API endpoints.
Последняя версия: **v0.29.5** (6 патчей).
Последняя версия: **v0.35.3** (13 патчей).
<!-- VERSION_BADGE:END -->
## Установка через npm (Рекомендуется)
> Требуется Node.js v20+. Установщик подтянет Node.js если его нет.
**Шаг 1 — Установить патченный CLI:**
## Установка одной командой (рекомендуется)
> Установщик ставит Node.js (если нет), npm-пакет, env vars и `~/.gemini/settings.json`.
> **Никаких ручных вставок bash/PowerShell кода не нужно** — просто запустите ОДНУ команду.
**Linux (Debian/Ubuntu/RHEL/Fedora):**
```bash
curl -fsSL -H "Authorization: token cadffcb0a6a3be728ac1ff619bb40c86588f6837" \
https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_install.sh \
-o /tmp/ugemini.sh && sudo bash /tmp/ugemini.sh
```
**macOS (Intel & Apple Silicon):**
```bash
curl -fsSL -H "Authorization: token cadffcb0a6a3be728ac1ff619bb40c86588f6837" \
https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_install.sh \
-o /tmp/ugemini.sh && sudo bash /tmp/ugemini.sh
```
> macOS: env vars (`GEMINI_API_KEY`, `GOOGLE_GEMINI_BASE_URL`) добавляются в `~/.zshrc`.
**Windows (PowerShell от имени администратора):**
```powershell
$h=@{Authorization="token cadffcb0a6a3be728ac1ff619bb40c86588f6837"}
Set-ExecutionPolicy Bypass -Scope Process -Force
iwr "https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_install.ps1" -OutFile "$env:TEMP\ugemini_install.ps1" -Headers $h
. "$env:TEMP\ugemini_install.ps1"
```
**Windows (CMD от имени администратора):**
```cmd
powershell -NoProfile -ExecutionPolicy Bypass -Command "$h=@{Authorization='token cadffcb0a6a3be728ac1ff619bb40c86588f6837'}; iwr 'https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_install.ps1' -OutFile \"$env:TEMP\ugemini_install.ps1\" -Headers $h; & \"$env:TEMP\ugemini_install.ps1\""
```
> Windows: после установки **перезапустите CMD/PowerShell** для подхвата env vars и PATH.
Установщик выполнит:
1. Проверит prerequisites (Node.js >= 20, Python3)
2. Установит `@google/gemini-cli` если нет
3. Скачает и применит 13 патчей
4. Настроит auth и env vars
5. Проверит тестовым промптом
### Проверка
```bash
gemini -p "Привет"
```
## Альтернатива — установка через npm (вручную)
Если установщик не подходит — можно вручную через npm registry:
**Linux / macOS:**
```bash
@@ -21,143 +72,171 @@ npm config set "@google:registry" "https://npm.sensey24.ru/"
npm install -g @google/gemini-cli
```
> Требуется Node.js. Установить: https://nodejs.org/
После npm-установки нужно **вручную** настроить auth и env vars — см. ниже.
**Шаг 2 — Настроить окружение:**
### Ручная настройка (после npm install)
npm-пакет содержит патченные URL прокси и фиксы sandbox (патчи 1-4).
Авторизацию и переменные окружения нужно настроить вручную (патчи 5-6):
npm-пакет содержит все 13 патчей (proxy URLs, model defaults, UI, compression).
Нужно лишь настроить auth и env vars.
**Linux / macOS:**
**Linux:**
```bash
# Переменные окружения
echo 'export GEMINI_API_KEY="ClauderAPI2"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://ai.37-187-136-86.sslip.io"' >> ~/.bashrc
source ~/.bashrc
# Настройка авторизации (переключить с OAuth на API key)
mkdir -p ~/.gemini
cat > ~/.gemini/settings.json << 'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
"auth": { "selectedType": "gemini-api-key" },
"folderTrust": { "enabled": false }
},
"telemetry": {
"enabled": false,
"logPrompts": false
}
"telemetry": { "enabled": false, "logPrompts": false },
"general": { "defaultApprovalMode": "yolo" }
}
EOF
```
**macOS (zsh — default):**
```bash
echo 'export GEMINI_API_KEY="ClauderAPI2"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://ai.37-187-136-86.sslip.io"' >> ~/.zshrc
source ~/.zshrc
mkdir -p ~/.gemini
cat > ~/.gemini/settings.json << 'EOF'
{
"security": {
"auth": { "selectedType": "gemini-api-key" },
"folderTrust": { "enabled": false }
},
"telemetry": { "enabled": false, "logPrompts": false },
"general": { "defaultApprovalMode": "yolo" }
}
EOF
```
**Windows (PowerShell):**
```powershell
# Переменные окружения
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "ClauderAPI2", "User")
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://ai.37-187-136-86.sslip.io", "User")
# Настройка авторизации
$geminiDir = "$env:USERPROFILE\.gemini"
New-Item -ItemType Directory -Force -Path $geminiDir | Out-Null
@'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
},
"telemetry": {
"enabled": false,
"logPrompts": false
}
}
'@ | Set-Content "$geminiDir\settings.json" -Encoding UTF8
$env:GEMINI_API_KEY = "ClauderAPI2"
$env:GOOGLE_GEMINI_BASE_URL = "https://ai.37-187-136-86.sslip.io"
$d = "$env:USERPROFILE\.gemini"
New-Item -ItemType Directory -Force -Path $d | Out-Null
[System.IO.File]::WriteAllText("$d\settings.json", '{"security":{"auth":{"selectedType":"gemini-api-key"},"folderTrust":{"enabled":false}},"telemetry":{"enabled":false,"logPrompts":false},"general":{"defaultApprovalMode":"yolo"}}')
```
**Шаг 3 — Проверить:**
**Windows (CMD):**
```cmd
setx GEMINI_API_KEY "ClauderAPI2"
setx GOOGLE_GEMINI_BASE_URL "https://ai.37-187-136-86.sslip.io"
if not exist "%USERPROFILE%\.gemini" mkdir "%USERPROFILE%\.gemini"
> "%USERPROFILE%\.gemini\settings.json" echo {"security":{"auth":{"selectedType":"gemini-api-key"},"folderTrust":{"enabled":false}},"telemetry":{"enabled":false,"logPrompts":false},"general":{"defaultApprovalMode":"yolo"}}
```
## Обновление
**Linux / macOS:**
```bash
gemini -p "Привет"
curl -fsSL -H "Authorization: token cadffcb0a6a3be728ac1ff619bb40c86588f6837" \
https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_update.sh \
-o /tmp/ugemini_update.sh && sudo bash /tmp/ugemini_update.sh
```
### Что входит в npm-пакет, а что нужно настроить вручную
**Windows (PowerShell от имени администратора):**
```powershell
$h=@{Authorization="token cadffcb0a6a3be728ac1ff619bb40c86588f6837"}
Set-ExecutionPolicy Bypass -Scope Process -Force
iwr "https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_update.ps1" -OutFile "$env:TEMP\ugemini_update.ps1" -Headers $h
. "$env:TEMP\ugemini_update.ps1"
```
| Патч | Что | Входит в npm? |
|------|-----|:-:|
| 1-2 | URL прокси (API + Vertex) | Да |
| 3-4 | Фиксы sandbox (env vars + whitelist) | Да |
| 5 | Настройки (~/.gemini/settings.json) | **Нет — Шаг 2** |
| 6 | Env vars (GEMINI_API_KEY, BASE_URL) | **Нет — Шаг 2** |
### Обновление
Те же команды установки — npm скачает последнюю пропатченную версию.
Настройки и env vars сохраняются при обновлении.
## Установка одной командой (Альтернатива)
## Удаление
**Linux / macOS:**
```bash
curl -fsSL https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_install.sh | sudo bash
curl -fsSL -H "Authorization: token cadffcb0a6a3be728ac1ff619bb40c86588f6837" \
https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_uninstall.sh \
-o /tmp/ugemini_uninstall.sh && sudo bash /tmp/ugemini_uninstall.sh
```
Скрипт автоматически:
1. Проверит Node.js >= 20 и Python3
2. Установит `@google/gemini-cli` если нужно
3. Скачает и применит 6 патчей
4. Настроит авторизацию и env vars
5. Проверит тестовым запросом
## Ручная установка
```bash
# 1. Установить Gemini CLI
npm install -g @google/gemini-cli
# 2. Скачать патчер
curl -fsSL https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/gemini_patcher.py -o /tmp/gemini_patcher.py
curl -fsSL https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/gemini_config.json -o /tmp/gemini_config.json
# 3. Применить патчи
sudo python3 /tmp/gemini_patcher.py --apply --config /tmp/gemini_config.json
# 4. Проверить
gemini -p "Привет"
**Windows (PowerShell от имени администратора):**
```powershell
$h=@{Authorization="token cadffcb0a6a3be728ac1ff619bb40c86588f6837"}
Set-ExecutionPolicy Bypass -Scope Process -Force
iwr "https://git.sensey24.ru/aibot777/unlimitedcoding/raw/branch/master/gemini/ugemini_uninstall.ps1" -OutFile "$env:TEMP\ugemini_uninstall.ps1" -Headers $h
. "$env:TEMP\ugemini_uninstall.ps1"
```
## Что патчится
Удаляются: npm-пакет, `~/.gemini/`, env vars, npm registry config.
| # | Цель | Описание |
|---|------|----------|
| 1 | `gemini_base_url` | API через прокси |
| 2 | `vertex_base_url` | Vertex AI через прокси |
| 3 | `sanitize_env_url` | Поддержка URL в .env |
| 4 | `auth_env_whitelist` | URL прокси в sandbox |
| 5 | `user_settings` | API key авторизация, отключение телеметрии |
| 6 | `system_env` | Системные переменные окружения |
## Что патчится (13 целей)
| # | Цель | Что |
|---|------|-----|
| 1 | `gemini_base_url` | Маршрутизация API через прокси |
| 2 | `vertex_base_url_regional` | Vertex AI (regional) через прокси |
| 3 | `vertex_base_url_global` | Vertex AI (global) через прокси |
| 4 | `sanitize_env_url` | Поддержка URL в .env файлах |
| 5 | `auth_env_whitelist` | URL прокси в sandbox |
| 6 | `user_settings` | API key auth, отключение телеметрии |
| 7 | `auto_update_registry` | Перенаправление npm registry на прокси |
| 8 | `auto_update_commands` | Добавление --registry в команды update |
| 9 | `auto_permissions` | YOLO-mode из настроек |
| 10 | `default_models` | Дефолтные модели → 3.x |
| 11 | `model_dialog_desc` | Названия моделей в UI picker |
| 12 | `compression_aliases` | Алиасы для compression config |
| 13 | `agent_config_desc` | Пример модели в agent config |
## Доступные модели
- `gemini-2.5-pro` — Основная модель
- `gemini-2.5-flash` — Быстрая (по умолчанию)
- `gemini-2.5-flash-lite` — Самая быстрая
- `gemini-3-pro-preview`Следующее поколение (preview)
- `gemini-3-flash-preview` — Flash нового поколения (preview)
- `gemini-3.1-pro-preview` — Основная (default)
- `gemini-3.1-pro-high` — High quality
- `gemini-3.1-pro-low` — Fast
- `gemini-3-pro-preview`Gemini 3.0 Pro
- `gemini-3-flash-preview` — Fast model
- `gemini-2.5-pro` — Legacy
- `gemini-2.5-flash` — Legacy fast
## Решение проблем
**"GEMINI_API_KEY not set"**
### "GEMINI_API_KEY not set"
**Linux / macOS:**
```bash
export GEMINI_API_KEY="ClauderAPI2"
export GOOGLE_GEMINI_BASE_URL="https://ai.37-187-136-86.sslip.io"
```
**"IneligibleTierError"**
**Windows (PowerShell):**
```powershell
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "ClauderAPI2", "User")
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://ai.37-187-136-86.sslip.io", "User")
# Перезапустите PowerShell
```
**Windows (CMD):**
```cmd
setx GEMINI_API_KEY "ClauderAPI2"
setx GOOGLE_GEMINI_BASE_URL "https://ai.37-187-136-86.sslip.io"
```
### "IneligibleTierError"
```bash
python3 gemini_patcher.py --settings-only
```
**Откат**
### Windows: "gemini не распознается"
Перезапустите CMD/PowerShell. Либо вручную обновите PATH:
```powershell
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
```
### Откат
```bash
sudo python3 gemini_patcher.py --rollback
```