Skip to content

dorofeevb1/video-context

Repository files navigation

Контекст по видео

Контекст по видео

Субтитры YouTube → темы → ссылки на источники. Энциклопедии, научные базы, веб — карточки в popup, без своего бэкенда.

Chrome MV3 TypeScript License MIT Version CI

Установка · Возможности · Документация · Поддержка · English


О проекте

Расширение для Chrome работает с открытой страницей youtube.com/watch?v=…:

  1. Читает стенограмму из субтитров (Innertube + панель «Стенограмма» как запасной путь).
  2. Считает резюме и темы — эвристикой по тексту или через ваш OpenAI-совместимый ключ.
  3. Запрашивает до восьми источников: Wikipedia, Wikidata, DuckDuckGo, OpenAlex, Semantic Scholar, Internet Archive, Google CSE, SerpAPI.
  4. Ранжирует и показывает карточки в popup; результат кэшируется на 24 часа.

Собственного сервера нет. Запросы уходят либо к публичным API, либо к сервисам, для которых вы сами ввели ключ.


Возможности

  • YouTube watch?v=… и Shorts, кнопка Найти контекст в popup.
  • Стенограмма через Innertube; запасной путь — панель стенограммы в плеере.
  • Анализ: эвристический по умолчанию, ИИ — при заданном openaiApiKey в настройках (бейдж AI в popup, откат на эвристику при ошибке сети).
  • Восемь источников, выбор и приоритеты — в настройках расширения (⚙).
  • Кэш по videoId (24 ч), список последних 20 успешных запросов в popup.
  • Локали интерфейса: ru, en (через chrome.i18n); язык поиска переключается отдельно.
  • Manifest V3, CSP script-src 'self'; ни eval, ни инлайновых скриптов.
  • Circuit breaker на провайдере: 3 неудачи подряд → 60 с пропуска.

Подробный список — docs/USER_GUIDE.md.


Быстрый старт

git clone https://github.com/dorofeevb1/video-context-extension.git
cd video-context-extension/extension
npm ci && npm run build

В Chrome: chrome://extensionsРежим разработчикаЗагрузить распакованноеextension/dist/.

Откройте видео на YouTube, нажмите иконку расширения, затем Найти контекст.

Установка из Chrome Web Store и Firefox — docs/INSTALL.md.


Скриншоты

Скриншоты и короткие GIF главных потоков — в docs/media/. На момент текущего тега они помечены как TODO; их собирает QA через Playwright (см. план в TEAM_PLAN.md).


Документация

Документ Содержание
docs/INSTALL.md Установка из CWS и из исходников
docs/USER_GUIDE.md Руководство для пользователя
docs/FAQ.md Частые вопросы
docs/TROUBLESHOOTING.md Решение проблем
docs/DEVELOPER.md Сборка, тесты, сообщения SW
docs/ARCHITECTURE.md Слои, контракты, паттерны
docs/API.md Внутренние интерфейсы и сообщения
docs/RELEASE.md Процесс релиза, версии, ZIP
docs/PRIVACY_POLICY.md Политика конфиденциальности (CWS-ready)
docs/TERMS.md Условия использования
SECURITY.md Reporting и threat model
CONTRIBUTING.md Как присылать PR
CHANGELOG.md История изменений

Разработка

make install   # npm ci в extension/
make build     # vite build → extension/dist
make test      # vitest

Подробнее — docs/DEVELOPER.md и docs/ARCHITECTURE.md.


Поддержка


Лицензия

MIT. См. docs/TERMS.md.

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors