Update README with web service documentation

This commit is contained in:
Кирилл Блинов 2026-05-29 12:17:27 +03:00
parent beb411dfdc
commit b9897555a3

View File

@ -260,6 +260,46 @@ output:
paragraph_pause_sec: 2.0 paragraph_pause_sec: 2.0
``` ```
## 🌐 Веб-интерфейс
Проект включает веб-сервис с минималистичным фронтендом для удобной работы через браузер.
### Функции веб-интерфейса
- 📤 **Drag & Drop загрузка** — перетащите файлы или выберите через диалог
- 📦 **Пакетная загрузка** — загружайте несколько файлов одновременно
- 📊 **Прогресс в реальном времени** — WebSocket показывает статус обработки каждого файла
- 🌳 **Файловый менеджер** — дерево обработанных совещаний с датами
- 📝 **Просмотр Markdown** — встроенный рендерер с подсветкой синтаксиса
- ⬇️ **Скачивание** — docx и md файлы доступны для скачивания
### Запуск веб-сервера
```bash
# Установите HF_TOKEN
export HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxx
# Запустите сервер
python start_server.py
```
Сервер поднимается на `http://localhost:8000`
Откройте браузер и перетащите файлы в зону загрузки. Обработка происходит в фоне, прогресс отображается в реальном времени.
### API Endpoints
| Endpoint | Метод | Описание |
|----------|-------|----------|
| `/` | GET | Фронтенд |
| `/upload` | POST | Загрузка одного файла |
| `/upload-batch` | POST | Пакетная загрузка |
| `/ws` | WebSocket | Прогресс обработки |
| `/api/tasks` | GET | Список задач |
| `/api/files` | GET | Дерево обработанных файлов |
| `/api/files/content?path=...` | GET | Содержимое файла |
| `/api/files/download?path=...` | GET | Скачивание файла |
## Ограничения ## Ограничения
- Перекрывающаяся речь (overlap) распознаётся плохо - Перекрывающаяся речь (overlap) распознаётся плохо