Code Explainer RU

Chrome-расширение, которое объясняет выделенный код, термины или текст на русском языке через AI-модель по выбору. Для вайб-кодеров и начинающих разработчиков.

Что умеет

• Объясняет выделенный текст в любой вкладке: код, термины, аббревиатуры, иностранные фразы.
• Три уровня детализации — новичок, средний, технический — переключаются одним кликом.
• Streaming-ответы: текст появляется по мере генерации.
• Conversational mode с историей и follow-up вопросами в том же боксе.
• 7 AI-провайдеров на выбор: Claude (Anthropic), OpenAI ChatGPT, DeepSeek, Google Gemini, OpenRouter, локальная Ollama, любой OpenAI-совместимый endpoint.
• Опциональный мини-словарь ключевых терминов в конце ответа.
• Универсальность: ключи провайдеров хранятся локально, нет своего бэкенда — твои запросы идут напрямую к выбранному AI.

Установка

Из Chrome Web Store

Скоро. До публикации — устанавливай вручную.

Вручную (для разработчиков)

git clone https://github.com/zzz10vvv10-lab/code-explainer-ru.git
cd code-explainer-ru

1. Открой chrome://extensions/, включи Developer mode.
2. Нажми Load unpacked и выбери папку extension/.
3. Кликни иконку расширения на тулбаре, выбери AI-провайдера и вставь свой API-ключ (ссылки «Где взять ключ?» в попапе).

Использование

Выдели любой текст на странице — рядом появится floating-кнопка. Клик → объяснение в боксе сбоку. Можно задать follow-up вопрос прямо из бокса.

Конфиденциальность

Расширение не собирает телеметрию, не передаёт пользовательские данные на серверы автора и не использует трекеры. Выделенный текст и API-ключ отправляются напрямую выбранному AI-провайдеру по HTTPS.

Подробнее — PRIVACY.md (English).

Сборка из исходников

npm install
npm run build:icons   # SVG → PNG через sharp + svgo (детерминированно, sha256 в логе)
npm run lint          # eslint по tools/ и extension/

PNG-иконки регенерируются из SVG-источников в assets/icons/source/ и сохраняются в extension/icons/. Запуск build:icons идемпотентен — повторный запуск даёт байт-в-байт идентичный результат.

Структура репозитория

• extension/ — содержимое расширения (загружается в Chrome как unpacked)
• assets/icons/source/ — мастер-SVG для иконок (16/48/128 размеров)
• tools/ — build-скрипты
• docs/decisions/ — Architecture Decision Records

Вклад

Pull requests welcome. Перед коммитом запусти npm run lint && npm run build:icons. Conventional Commits 1.0, atomic-коммиты — см. CLAUDE.md.

Лицензия

MIT © 2026 Виталий Зыков