**> **Версия:** v0.10.0 (2026.4.16)

**> **

---

Содержимое бекапа

.ruslan/
├── config.yaml          # Конфигурация (провайдеры, модели, инструменты)
├── .env                 # API-ключи (OpenRouter, Telegram и т.д.)
├── ruslan-agent/        # Исходный код Ruslan + зависимости
├── skills/              # Все установленные скиллы (20MB)
├── memories/            # Persistent memory (user profile + notes)
├── state.db             # Сессии и история разговоров (81MB)
├── sessions/            # Архив сессий (326MB)
├── auth.json            # Токены авторизации
├── cron/                # Запланированные задачи
├── scripts/             # Пользовательские скрипты
├── plugins/             # Плагины
├── data/                # Данные
├── SOUL.md              # «Душа» агента
├── launch.sh            # Скрипт запуска
├── channel_directory.json  # Каналы связи
├── gateway_state.json   # Состояние гейтвея
└── backups/             # Предыдущие бекапы (461MB)

---

🔧 Полное восстановление

Если Ruslan не установлен

# 1. Распаковать бекап в домашнюю папку
cd ~
tar xzf ruslan-v0.10.0-backup.tar.gz

# 2. Создать виртуальное окружение и установить зависимости
cd ~/.ruslan/ruslan-agent
python3.11 -m venv .venv --without-pip
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync --frozen

# 3. Проверить
~/.ruslan/ruslan-agent/.venv/bin/ruslan --version
# Должно показать: Ruslan Agent v0.10.0 (2026.4.16)

Если Ruslan уже стоит — замена

# 1. Сохранить старую версию (на всякий случай)
mv ~/.ruslan ~/.ruslan.old

# 2. Распаковать бекап
cd ~
tar xzf ruslan-v0.10.0-backup.tar.gz

# 3. Пересоздать venv (если нужно)
cd ~/.ruslan/ruslan-agent
rm -rf .venv
python3.11 -m venv .venv --without-pip
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync --frozen

# 4. Запустить
~/.ruslan/ruslan-agent/.venv/bin/ruslan chat

---

🧪 Проверка после восстановления

1. Версия

~/.ruslan/ruslan-agent/.venv/bin/ruslan --version

✅ Должно быть: Ruslan Agent v0.10.0 (2026.4.16)

2. Конфигурация

cat ~/.ruslan/config.yaml | head -20

✅ Должны быть: провайдер opencode-go, модель deepseek-v4-flash

3. API-ключи

cat ~/.ruslan/.env | grep -E "OPENCODE|TELEGRAM"

✅ Должны быть: OPENCODE_GO_API_KEY, TELEGRAM_BOT_TOKEN, и т.д.

4. Скиллы

ls ~/.ruslan/skills/ | wc -l

✅

5. Память

# Запустить Ruslan в режиме CLI и проверить /memory
~/.ruslan/ruslan-agent/.venv/bin/ruslan chat
# Внутри чата: /memory
# Должны быть: user profile + заметки о проектах (YachtGs, ESP32, флот и т.д.)

6. Gateway (Telegram)

~/.ruslan/ruslan-agent/.venv/bin/ruslan gateway run

✅ Должен запуститься без ошибок, бот в Telegram отвечает

7. Сессии

ls ~/.ruslan/state.db

✅ Файл существует (81MB) — вся история на месте

8. Cron (если есть задачи)

cat ~/.ruslan/cron/jobs.json

✅ Запланированные задачи на месте

---

📁 Структура скиллов

Скиллы лежат в ~/.ruslan/skills/ и организованы по категориям:

skills/
├── android/
├── apple/
├── autonomous-ai-agents/
├── brainstorming/
├── code-reviewer/
├── creative/
├── data-science/
├── devops/
├── hardware/
├── ruslan-agent/
├── incident-commander/
├── marketing/
├── media/
├── mlops/
├── n8n-code-javascript/
├── n8n-code-python/
├── note-taking/
├── seo/
├── social-media/
├── software-development/
├── speech-to-text/
├── telegram/
├── vision-analysis/
├── voice-transcription/
├── writing/
└── ...

Как добавить скилл: положить .md файл в нужную папку или через /skills install в чате.

---

⚠️ Важные заметки

1. Python 3.11 обязателен — Ruslan v0.10.0 не работает на 3.12/3.13
2. API-ключи — если восстанавливаете на другом компьютере, проверьте .env
3. Telegram bot token — если токен сменился, обновите в config.yaml и .env
4. state.db — если не нужна старая история, можно удалить (Ruslan создаст новую)
5. Зависимости — uv sync --frozen устанавливает всё необходимое из uv.lock

---

🚀 Быстрый старт после восстановления

# Просто запустить чат
cd ~/.ruslan/ruslan-agent
source .venv/bin/activate
ruslan chat

Или с Telegram-ботом:

ruslan gateway run

---

*