# Развёртывание Gemini Skill Для ServerManager

Этот документ описывает, как ServerManager интегрируется с Gemini CLI.

## Что устанавливается

Для каждого target home устанавливаются:

1. Общий backend:
   - `~/.server-connections/ssh.py`
   - `~/.server-connections/encryption.py`
2. Gemini skill package:
   - `~/.gemini/skills/server-manager/`
3. Безопасный runtime wrapper:
   - `~/.server-connections/gemini-ssh`
4. Глобальный Gemini context:
   - `~/.gemini/GEMINI.md`

## Skill workflow

Gemini должен начинать discovery так:

```bash
$HOME/.server-connections/gemini-ssh --list
```

Далее:

- определить `Type`
- выбрать команду строго по типу
- выполнить ровно одно действие
- не раскрывать IP, логины, пароли, порты

## Рекомендуемая установка

### Через GUI

Вкладка `Setup` теперь умеет ставить:

- Claude skill
- Codex skill
- Gemini skill
- shared backend и wrappers

### Через Python installer

```bash
python3 tools/install_ai_integrations.py
python3 tools/install_ai_integrations.py --target-home /root
python3 tools/install_ai_integrations.py --all-users
```

### Через shell installer (Linux/macOS)

```bash
bash tools/install.sh --source-dir /path/to/server-manager
bash tools/install.sh --source-dir /path/to/server-manager --target-home /root
bash tools/install.sh --source-dir /path/to/server-manager --all-users
```

## Проверка

### 1. Проверить skill discovery

```bash
gemini skills list
```

### 2. Проверить wrapper

```bash
$HOME/.server-connections/gemini-ssh --list
```

### 3. Проверить doctor script

```bash
$HOME/.gemini/skills/server-manager/scripts/server-manager-gemini-doctor.sh
```

## Важные замечания

- `servers.json` не размножается автоматически в `--all-users` режиме — это сделано намеренно, чтобы не копировать credentials между пользователями.
- Для root / service accounts используйте отдельную установку в нужный `target home`.
- Gemini skill source в репозитории лежит в `.gemini/skills/server-manager/`.
- При необходимости можно дополнительно ставить mirror в `~/.agents/skills/server-manager/`, но по умолчанию это отключено, чтобы Gemini не ругался на duplicate skill conflict.