39227-vm/PROJECT_OVERVIEW.md
2026-03-19 16:56:24 +00:00

41 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Проект: Screenshot AI Bridge
Этот проект представляет собой систему для автоматизации сбора, обработки и анализа снимков экрана с использованием ИИ. Система разработана для работы в среде виртуальной машины Flatlogic и обеспечивает интеграцию между браузерным расширением и бэкенд-обработкой.
## Основные компоненты
1. **`tools/local_screenshot_bridge.py`**:
- Основной сервис (бэкенд), написанный на Python.
- Запускается как процесс PM2 на порту 3001.
- Обеспечивает следующие функции:
- **API эндпоинты**:
- `/`: Основной эндпоинт для данных (health check и JSON-ответы).
- `/health`: Проверка состояния системы.
- `/guide`: Человекочитаемая страница с инструкциями.
- `/download/chrome-extension.zip`: Динамическая генерация и загрузка архива с расширением для Chrome.
- **ИИ интеграция**:
- Автоматический сбор и анализ контента со скриншотов.
- Конфигурируемые параметры ИИ (напр. `--ai-max-output-tokens 2500`).
- Автоматическое сохранение результатов в директории `screenshots/` (PNG, JSON, .ai.json).
2. **`chrome_screenshot_ext/`**:
- Расширение для браузера Chrome.
- Используется для захвата содержимого экрана и отправки его в `local_screenshot_bridge` для последующей обработки.
3. **`screenshots/`**:
- Директория для хранения результатов обработки (снимки экрана, метаданные, контент, результаты анализа ИИ).
4. **`scripts/`**:
- Вспомогательные скрипты для подготовки ответов и обработки событий (напр. `on_screenshot.sh`).
## Развертывание и эксплуатация
- **Порт**: Приложение слушает порт 3001.
- **Прокси**: Доступ снаружи осуществляется через Apache (reverse proxy), который перенаправляет запросы на локальный порт 3001.
- **PM2**: Управление процессом `screenshot-bridge` осуществляется через PM2.
- **Конфигурация**: Параметры работы ИИ (такие как `ai-max-output-tokens`) задаются при запуске процесса через аргументы командной строки.
## Как использовать
Для получения расширения используйте эндпоинт: `https://<ваша-доменная-зона>/download/chrome-extension.zip`
Документация и статус системы доступны по адресу: `https://<ваша-доменная-зона>/guide`