Skip to content
aartzzPublic

About

[🇺🇦] open-source test solver (autoanswer, disabler, stealth etc.)

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

xdAnswers

Licensed under the GNU General Public License v3.0

Безкоштовне розширення з відкритим кодом, яке розв'язує тестові питання за допомогою ШІ.

GitHub Actions Workflow Status GitHub Repo stars Cash App

Important

Проект може мати баги. Будь ласка, Звітуйте про них.

showcase

Можливості

  • Безкоштовні моделі з коробки — DeepSeek, MiMo, Nemotron, Qwen etc.
  • Будь-який OpenAI-сумісний API — OpenAI, Anthropic, Gemini, DeepSeek, Groq, локальний Ollama, що завгодно
  • Розпізнавання зображень — обробляє зображення в питаннях та варіантах відповідей (через провайдери з підтримкою vision)
  • Пошук в інтернеті — модель може самостійно шукати актуальну інформацію в мережі (пару безкоштовних інстанцій SearXNG інтегровано з коробки)
  • Тихі режими — індикатори (точка біля правильної відповіді), заголовок сторінки, стелс (тільки буфер обміну) або one-click (клік на питання для відповіді)
  • Автовідповідь — автоматично обирає правильний варіант із налаштовуваною затримкою (cooldown)
  • Кеш відповідей — повторно використовує вже отримані відповіді на ідентичні питання, економить токени й час; керування терміном зберігання та очищення в налаштуваннях
  • Batch-режим — заздалегідь розв'язує весь тест у фоні та складає відповіді в кеш; працює на НаУрок (beta) і Google Forms (у межах поточної сторінки)
  • Консенсус — запускає відповідь кількома моделями одночасно та обирає варіант більшості
  • Плаваючий помічник — перетягуваний, показує відповідь + пояснення + витрачений час
  • Мультиязичність — інтерфейс українською, російською та англійською
  • Кастомні теми — обери готову або створи свою з + кнопкою
  • Disabler (обхід анти-читу) — універсальний та специфічний для кожного сайту

Встановлення

PC (Chromium-based browsers)

  1. Перейдіть до Releases, завантажте останній xdAnswers-chrome-*.crx
  2. Відкрийте chrome://extensions, увімкніть Режим розробника (справа вгорі)
  3. Перетягніть .crx у вікно chrome://extensions → підтвердіть встановлення

Note

Chrome може блокувати встановлення .crx поза Chrome Web Store. У такому разі використовуйте Chromium або корпоративну політику встановлення розширень.

PC (Gecko-based browsers)

Розширення підписано Mozilla — працює на будь-якій версії Firefox без додаткових налаштувань.

  1. Завантажте xdAnswers-firefox-*.xpi з Releases
  2. Перетягніть файл .xpi у вікно Firefox → підтвердіть встановлення

Android (Kiwi Browser)

  1. Встановіть Kiwi Browser з GitHub
  2. Перейдіть до Releases, завантажте останній xdAnswers-chrome-*.crx
  3. Відкрийте kiwi://extensions, увімкніть Режим розробника
  4. Встановіть завантажений .crx

Збірка з вихідного коду

Потрібен Node.js 18+ (щоб був доступний npm).

git clone https://github.com/aartzz/xdAnswers.git
cd xdAnswers
npm install

Далі оберіть ціль:

# Firefox — готовий .xpi (не підписаний)
npm run build:firefox

# Chrome/Brave/Edge/Vivaldi — готовий .crx
npm run build:chrome

Note

Для підписання Firefox-розширення потрібні облікові дані Mozilla Add-ons API. Створи файл .env у корені проєкту (дивись .env.example) або передай їх через змінні середовища WEB_EXT_API_KEY / WEB_EXT_API_SECRET, потім запусти npm run sign:firefox щоб скомпілювати підписаний .xpi.

Готові артефакти лежать у папці ./build. Далі встановлюйте їх так само, як і реліз-файли (див. розділи вище).

Tip

Скрипти build:firefox / build:chrome крос-платформні (працюють на Windows, macOS, Linux). Firefox пакується через web-ext, Chrome — через Chrome/Chromium --pack-extension. Для Chrome-збірки потрібен встановлений Chrome або Chromium; шлях до нього можна задати через CHROME_BIN.

Important

Для стабільного ID Chrome-розширення задайте CHROME_EXTENSION_KEY — PEM-вміст ключа або шлях до .pem-файлу. Без ключа локальна збірка створить build/chrome-extension.pem, а CI згенерує новий ключ на кожен запуск.

Для ітеративної розробки зручно використовувати режим web-ext run, який запускає тимчасовий профіль браузера з уже завантаженим розширенням і автоматично перезавантажує його при змінах у файлах:

# Спочатку зберіть розширення у ./dist
npm run dev # або: node scripts/build.js firefox

# Firefox — відкриється тимчасовий Firefox з розширенням
npx web-ext run

# Chrome/Chromium (потребує встановленого Chrome)
npx web-ext run -t chromium

Підтримувані сайти

Сайт URL Статус Авто-Відповідь Disabler Silent mode
НаУрок naurok.com.ua 🟢 ✅ ✅ ✅
Всеосвіта vseosvita.ua 🟡 ✅ ✅ ✅
JustClass justclass.com.ua 🟡 ✅ ⚠️ ✅
Kahoot! kahoot.it ❔️ ✅ ✅ ✅
Classtime classtime.com ❔️ ✅ ⚠️ ✅
МійКлас miyklas.com.ua ❔️ ✅ ⚠️ ✅
LCloud lcloud.in.ua ❔️ ⚠️ ⚠️ ✅
Google Forms docs.google.com/forms 🟢 ✅ ➖ ✅
Microsoft Forms forms.office.com 🟡 ✅ ➖ ✅
Quizlet quizlet.com ❔️ ⚠️ ⚠️ ✅
Szkoła w Chmurze szkolawchmurze.org ❔️ ⚠️ ⚠️ ✅
TestPortal testportal.pl ❔️ ⚠️ ⚠️ ✅
Blooket blooket.com ❔️ ✅ ⚠️ ✅
Gimkit gimkit.com ❔️ ✅ ⚠️ ✅
Wayground wayground.com ❔️ ✅ ⚠️ ✅
Мрія school.mriia.gov.ua ❔️ ✅ ⚠️ ✅
SchoolOS INTEGRITY schoolos-test.vercel.app ❔️ ✅ ✅ ✅
Testix testix.com.ua 🟢 ✅ ✅ ✅
Amplify Classroom student.amplify.com ❔️ ✅ ➖ ✅
S&T School school.smileandtask.com ❔️ ✅ ✅ ✅

Умовні позначення

Позначення Пояснення
✅ повністю підтримується
⚠️ використовується універсальне рішення або ще в розробці
❌ не підтримується
➖ не планується
🟢 роботу перевірено повністю
🟡 роботу перевірено не повністю
❔️ роботу не було перевірено

About

[🇺🇦] open-source test solver (autoanswer, disabler, stealth etc.)

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages