docs: refresh Claude Codex and Gemini integration guides

This commit is contained in:
Codex
2026-03-11 19:31:16 +00:00
parent 9da3125c34
commit 136d1605c0
3 changed files with 124 additions and 33 deletions

86
GEMINI_SKILL_SETUP.md Normal file
View File

@@ -0,0 +1,86 @@
# Развёртывание 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.