Правила взаимодействия с Home PC

Версия: 1.0.0
Дата: 2025-11-30

ГЛАВНОЕ ПРАВИЛО

Оператор выполняет команды в терминале на своём ПК.
Claude работает на сервере и НЕ имеет прямого доступа к ПК.

КАК ДАВАТЬ КОМАНДЫ

НЕЛЬЗЯ

❌ Несколько команд через &&
❌ Длинные однострочники
❌ Команды с переносами строк

Причина: Терминал оператора ломает команды при копировании.

МОЖНО

✅ Один скрипт-файл
✅ Короткие команды по одной
✅ Скрипт на сервере → оператор скачивает и запускает

ФОРМАТ СКРИПТОВ

#!/bin/bash
set -e
clear
echo "=========================================="
echo "  НАЗВАНИЕ ОПЕРАЦИИ"
echo "=========================================="
echo ""
echo "1/N Шаг первый..."
# команда

echo "2/N Шаг второй (ЖДИТЕ ~2 мин)..."
# долгая команда

echo "=== OK ==="

Обязательно:

• set -e — останавливаться при ошибке
• clear — очистка экрана в начале
• Отбивка === — в начале и конце
• Нумерация шагов — 1/N, 2/N...
• ПРЕДУПРЕЖДЕНИЕ О ДОЛГИХ ОПЕРАЦИЯХ — "(ЖДИТЕ ~X мин)"
• Финальная проверка

Долгие операции (предупреждать!):

• rclone sync — зависит от объёма данных
• apt install — загрузка пакетов
• git clone — загрузка репозитория
• Любая сетевая операция с большими данными

КАК ПЕРЕДАВАТЬ СКРИПТ

РАБОЧИЙ СПОСОБ: echo с одинарными кавычками

echo '#!/bin/bash
set -e
clear
echo "1/2 Шаг..."
команда
echo "=== OK ==="' > /tmp/f.sh && bash /tmp/f.sh

Почему так:
- heredoc (<< 'EOF') ломается при копировании в терминал
- echo с одинарными кавычками работает стабильно
- Короткое имя /tmp/f.sh — меньше шансов на ошибку

НЕ РАБОТАЕТ:

# ❌ heredoc — ломается при копировании
cat > /tmp/task.sh << 'EOF'
...
EOF

# ❌ длинные однострочники через &&
cmd1 && cmd2 && cmd3 && ...

ДИАГНОСТИКА

Перед любым действием — диагностика!

# Claude СНАЧАЛА просит выполнить диагностику
# Оператор присылает вывод
# Claude анализирует
# Только потом — действия

Не ломать!

1. Диагностика текущего состояния
2. Анализ
3. План действий
4. Подтверждение оператора
5. Выполнение
6. Проверка результата

СИСТЕМА ОПЕРАТОРА

Облачные диски

CHECKLIST ПЕРЕД ДЕЙСТВИЕМ

• [ ] Диагностика выполнена?
• [ ] Состояние понятно?
• [ ] Скрипт создан файлом (не однострочник)?
• [ ] Есть шаги и проверки?
• [ ] Оператор подтвердил?

Версия: 1.0.0