Перевод страниц через AI

TeqCMS использует языковые модели (LLM) для автоматического перевода HTML-страниц. Механизм работает локально, инициируется вручную и учитывает метаданные переводов.

1. Команда запуска

Переводы запускаются через CLI-команду:

npm run translate

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

2. Хранилище метаданных

Информация о переводах хранится в JSON-файле:

var/teq-cms/db_translate.json

Файл содержит даты изменения оригинала и даты последнего перевода по каждой локали. Это позволяет точно определить, какие страницы нуждаются в обновлении.

3. Структура шаблонов

• Исходные шаблоны располагаются в tmpl/web/{baseLocale}/
• Переводы сохраняются в tmpl/web/{targetLocale}/
• Если файл перевода отсутствует или устарел — он автоматически создаётся заново

4. Промпты для LLM

По умолчанию используется системная инструкция, встроенная в CMS. Её можно переопределить в файле:

var/teq-cms/system.prompt.md

Кроме того, для каждой страницы в целевой локали можно задать локальный промпт:

tmpl/web/ru/about.prompt.md

Такой файл добавляется в запрос к LLM и позволяет уточнять стиль или терминологию для конкретного перевода.

5. Поддержка API

TeqCMS работает с любыми провайдерами, совместимыми с OpenAI API (например, OpenAI, DeepSeek). Конфигурация задаётся через переменные окружения:

TEQ_CMS_AI_API_BASE_URL=
TEQ_CMS_AI_API_KEY=
TEQ_CMS_AI_API_MODEL=
TEQ_CMS_AI_API_ORG=