61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# Web Surface — запуск
|
||
|
||
## Быстрый старт (мок-режим, без агента)
|
||
|
||
```powershell
|
||
$env:WEB_PLATFORM_BACKEND="mock"
|
||
python -m adapter.web.bot
|
||
```
|
||
|
||
Открыть http://localhost:8080
|
||
|
||
## С реальным агентом
|
||
|
||
```powershell
|
||
$env:WEB_PLATFORM_BACKEND="real"
|
||
$env:AGENT_BASE_URL="http://lambda.coredump.ru:7000/agent_0"
|
||
python -m adapter.web.bot
|
||
```
|
||
|
||
## Переменные окружения
|
||
|
||
| Переменная | По умолчанию | Описание |
|
||
|---|---|---|
|
||
| `WEB_PORT` | `8080` | Порт сервера |
|
||
| `WEB_PLATFORM_BACKEND` | `mock` | `mock` — заглушка, `real` — настоящий агент |
|
||
| `AGENT_BASE_URL` | `http://127.0.0.1:8000` | URL агента (только для `real`) |
|
||
| `SURFACES_WORKSPACE_DIR` | `/workspace` | Куда сохраняются файлы |
|
||
|
||
## Фронтенд
|
||
|
||
В `adapter/web/static/index.html` — работает сразу, ванильный JS.
|
||
|
||
React-версия в `adapter/web/frontend/` — требует сборки:
|
||
|
||
```powershell
|
||
cd adapter/web/frontend
|
||
npm install
|
||
npm run build
|
||
```
|
||
|
||
После `npm run build` Vite перезапишет `adapter/web/static/` — React заменит ванильный HTML.
|
||
|
||
## История
|
||
|
||
Сообщения сохраняются на сервере (в `InMemoryStore` или `SQLiteStore`).
|
||
При переподключении история загружается автоматически. Хранится до 200 сообщений на чат.
|
||
|
||
## Команды чата
|
||
|
||
- `/start` — начать работу (регистрация)
|
||
- `/new` — создать новый чат
|
||
- `/chats` — список чатов
|
||
- `/rename <название>` — переименовать чат
|
||
- `/archive` — архивировать чат
|
||
- `/settings` — настройки (скиллы, личность, безопасность)
|
||
|
||
## Файлы
|
||
|
||
- **Загрузка**: кнопка 📎 → файл добавляется в очередь → отправляется с сообщением
|
||
- **Скачивание**: файлы от агента показываются как карточка с кнопкой "⬇ Скачать"
|
||
- **Хранение**: файлы сохраняются в `SURFACES_WORKSPACE_DIR`, доступны по `/files/{path}`
|