# AngelSystem: подключение проекта. Инструкция для ИИ

AngelSystem (https://angelsystem.top) присматривает за проектами пользователя: запускает их по слотам, поднимает после падения, хранит зашифрованные копии баз и пишет в Telegram. Чтобы проект попал под присмотр, нужно три шага:

1. На устройство, где работает проект (Ubuntu или Windows, Python 3.11 или новее), поставить агент AngelSystem.
2. В проект положить клиент подключения: папку `$angel_system` целиком, вписать в её настройки имя проекта и добавить несколько строк в главный файл.
3. В панели https://angelsystem.top создать слот проекта или нажать «Добавить» на его карточке.

Всё нужное лежит в одном архиве: агент 3.12, клиент `$angel_system` версии 3.2, полная инструкция `#ANGEL_CLIENT_INTEGRATION_V4_0.md` и файл `#AI_START_HERE.md` с порядком действий. Ничего не придумывай сверх этих файлов.

## 1. Сначала спроси пользователя

Есть два способа получить архив. Спроси пользователя, какой ему удобнее, и дай ему конкретные шаги:

- **Архив под его аккаунт (проще всего).** Пользователь входит на https://angelsystem.top/login (нет аккаунта - регистрируется там же через Telegram), открывает раздел «Установка» и нажимает «Скопировать задание для ИИ». Он пришлёт тебе задание со ссылкой вида `https://angelsystem.top/install/...` (она личная и действует ограниченное время). В таком архиве уже вписан его логин: устройство само придёт ему приглашением.
- **Общий архив без входа:** `https://angelsystem.top/ai/bundle`. Перед запуском агента в него нужно вписать строку доступа пользователя. Попроси его войти на сайт, открыть раздел «Доступ» и прислать строку вида `"логин": "ключ"` из блока «Ваш ключ приглашений» (это не пароль, вход по ней невозможен). Впиши её в `ANGEL_CLIENT/PROJECT_SYSTEM_SETTINGS.py`, в `AGENT_SETTINGS_CL.ACCESS["admins"]`. Без этой строки подключение устройства подтверждает только администратор платформы.

Если на устройстве уже работает агент AngelSystem (порт `127.0.0.1:7078` занят, есть служба `angelagent` или папка `ANGEL_CLIENT`), второй агент не ставь: нужен только клиент в проект. Агент должен быть версии 3.12 или новее, старый обнови файлами из архива.

## 2. Как скачивать

Скачивай командой в терминале, а не кнопкой в браузере: браузер может открыть окно «Куда сохранить» и ждать человека.

```bash
curl -fL -o AngelSystem_install.zip "<ссылка>"
```

Windows (PowerShell):

```powershell
Invoke-WebRequest -Uri "<ссылка>" -OutFile AngelSystem_install.zip
```

Распакуй архив и действуй по файлу `#AI_START_HERE.md` в его корне.

## 3. Прочитать заранее, без скачивания

- полная инструкция подключения: https://angelsystem.top/ai/guide
- папка клиента архивом (класть в проект без изменений кода): https://angelsystem.top/ai/client

## Важно

- Способ запуска проекта (`Virt` или Docker) - решение архитектуры самого проекта: возьми его из проекта (`#FIRST_RUN.md`, `#reference`, папка `$docker`). Спрашивай пользователя, только если он нигде не записан.
- Клиенту не нужны токены и файл секретов проекта: агент узнаёт проект по его процессу. Секреты проекта не выводи в ответах и логах.
- Кнопку перезагрузки устройства в панели не нажимай и пароли пользователя на сайте не вводи: это делает сам пользователь.