Локальний український вебзастосунок для дослідження криптопроєктів, оцінки умов та обліку завдань. Усі мережі на рівних; AI Jobs не входять до runtime.
У каталозі python-hunter/ розміщена нова локальна версія на FastAPI, SQLite та Ollama. Вона автоматично готує знайдені картки з описом, кампаніями, покроковими діями, джерелами й невідомими умовами, після чого користувач вирішує, які проєкти брати в роботу. Версія запускається окремо на http://127.0.0.1:4318/; інструкції містяться у python-hunter/README.md.
Node.js 24+. Для запуску й основних тестів зовнішніх npm-залежностей немає.
cd D:\Projects\ai-drop-hunter
npm test
npm startВідкрийте http://127.0.0.1:4317. Зупинка: Ctrl+C. Дані — у data/drop-hunter.sqlite, поза Git. Для резервної копії зупиніть сервер та скопіюйте всю папку data.
- Проєкти, фільтр мереж, без пріоритету мереж.
- Отримання офіційних матеріалів Ink Builder Program та network docs: текст, SHA-256, час отримання.
- Опціональний моніторинг кожні 6 годин, лише доки сервер працює. Налаштування й час запуску зберігаються.
- Пошук згадок умов, винагород, витрат, строків і builder-вимог за правилами. Пропозиції містять точні уривки знімка. Вибрані пункти додаються як ручні дослідницькі завдання без повторів.
- Структурована ручна оцінка кампанії: тип, статус, умови участі, ризик, витрати, дедлайн, п’ять обґрунтованих сигналів.
- Історія оцінок. Зміна джерела робить попередню оцінку застарілою навіть після повторного підтвердження домену.
- Розклади завдань: одноразово, кожні 24 години або кожні 7 днів. Час вводиться у місцевому часовому поясі та зберігається в UTC. Повторення — фіксований інтервал, не календарний час із поправкою на літній час.
- Історія повторюваних виконань із доказами. Пропущені періоди не позначаються виконаними. Повторний запит не створює дубль.
- SQLite-транзакції, журнал подій, перевірка актуальності знімків і версій розкладу.
- Локальний API з перевіркою Host/Origin, токеном для змін і CSP.
Бали описують повноту та придатність плану участі за оцінкою користувача, не ймовірність дропу. Ваги: відповідність умовам 30%, зрозумілість винагороди 25%, підтверджуваність виконання 20%, відомі витрати 15%, відповідність строкам 10%. Невідомі сигнали не додають балів; їхню частку показано окремо. Високі бали не скасовують високий ризик або минулий дедлайн.
Підтвердження джерела не підтверджує винагороду. Статус «оголошено» — висновок користувача із записаним доказом. Завдання виконуються вручну; застосунок зберігає повідомлення про виконання, без незалежного on-chain підтвердження.
Це однокористувацька локальна версія. Токен запобігає змінам зі сторонніх вебсторінок, але не замінює авторизацію. Не публікуйте цей сервер через reverse proxy.
Каталог Ink apps потребує JavaScript: статичний адаптер чесно повертає помилку недостатнього тексту. Автоотримання працює лише для фіксованого списку офіційних URL; користувацькі URL сервер не завантажує.
LLM-провайдер, автоматичні check-in, підключення гаманця, симуляції та виконання транзакцій ще не реалізовані. Приватні ключі не потрібні. Інші мережі поки є категоріями дослідження.
npm test: 32 unit/integration тести, включно зі збереженням після перезапуску, зміною джерел, часовими поясами, HTTP, повторюваністю та конфліктами розкладу.
npm run test:browser: повний сценарій у headless Edge, desktop/mobile, без змін робочої БД. Потребує встановленого Edge та пакета Playwright. Якщо Playwright розташований поза проєктом, задайте PLAYWRIGHT_MODULE як абсолютний шлях до пакета. Знімки зберігаються в data/qa і не комітяться.
- LLM-аналіз доказів після вибору провайдера (OpenAI API / Ollama).
- Browser adapter для каталогу Ink apps.
- Перевірка on-chain результатів, preview і симуляції; підпис лише в гаманці користувача.
- Шаблони контрактів, авторизація для серверного розміщення, rewards та feedback memory.
src/core/types.ts і src/core/scorer.ts перенесено з власного репозиторію користувача viktoriankv02/ai-hub, гілка feature/drop-hunter-product, каталог agents/drop-hunter, 2026-09-11. Імпорт змінено для нативного TypeScript у Node. Старий confidence не використовується в UI: кількість посилань не доводить їхню надійність.
Параметри Ink перевірені за https://docs.inkonchain.com/general/network-information 2026-09-11. Push у GitHub виконується за вказівкою власника.
Загальний список найближчих завдань: терміни, що настали, і наступні 24 години; підрахунок завдань без дедлайну та пізніших. Неперевірені джерела залишаються видимими з попередженням. Перехід до завдання скидає фільтр мережі. Оновлення лише переліку не стирає незбережені дані інших форм.
Ручний журнал винагород і витрат: кількість активу (точний десятковий текст), оцінка USD на момент запису, дата й доказ. Оцінки USD рахуються цілими центами, без ринкових API. Невідомі оцінки не вважаються нулями; загальна різниця тоді не показується. Повторні запити не дублюють запис; скасування з причиною зберігає аудит. Інтерфейс порівнює початкову оцінку витрат із відомими записаними витратами, не припускаючи повноту обліку. Це не незалежна on-chain перевірка.
У розділі «Резервна копія» кнопка завантажує цілісний SQLite-файл без зупинки сервера. Копія включає всі таблиці, докази, історію та налаштування; не містить тимчасового сесійного токена. Використовується SQLite backup, після чого файл переводиться в автономний journal mode.
Відновлення тільки в новий файл:
npm run backup:restore -- "C:\Users\vikto\Downloads\drop-hunter-backup.sqlite" "D:\Projects\ai-drop-hunter\data\restored.sqlite"Замініть ім’я завантаженої копії на фактичне. Інструмент перевіряє цілісність, зв’язки й наявність таблиць. Існуючий файл або службові SQLite-файли за цим ім’ям не перезаписуються.
Щоб відкрити відновлену базу окремо від основної:
$env:DROP_HUNTER_DB_PATH = "D:\Projects\ai-drop-hunter\data\restored.sqlite"
$env:PORT = "4318"
npm startВідкрийте http://127.0.0.1:4318. Змінні діють лише в поточному PowerShell; нове вікно термінала використовує стандартну базу й порт. Копія містить усі користувацькі записи та нотатки; зберігайте її окремо від публічного репозиторію.
Джерело «Ink: каталог застосунків» читає публічні дані Mainnet з офіційної сторінки: назви, описи та HTTPS-посилання. Зберігає їх як матеріал дослідження; наявність застосунку не підтверджує винагороду. Якщо формат сайту зміниться, показує помилку й зберігає попередні матеріали. Окремі картки застосунків поки не створюються.
Див. RESEARCH_ROADMAP.md: шість джерел, запропонованих користувачем, вимоги до агентів, доказів, оцінки витрат і ризиків та етапи реалізації. Інтеграції цих джерел ще не реалізовані.
Пріоритет Ink скасовано за уточненням користувача. Додано пошук за назвою/нотатками та збережені статуси new/watching/active/paused/dismissed. Невідома або кілька мереж — окремий дозволений варіант. Статус не підтверджує винагороду та не змінює виконання завдань. Початкова добірка асистента у research-candidates.json, імпорт у запущений локальний застосунок: node scripts/import-candidates.mjs. Повторний імпорт пропускає наявні назви. Це добірка за відкритими трекерами, не автономний LLM-пошук. Автоматичні адаптери шести трекерів і ШІ-модуль ще потребують реалізації.
Кнопка «Знайти нові проєкти» викликає POST /api/discovery/projects та читає публічні картки Airdrops.io. До 40 кандидатів за запит, інтервал 60 секунд, дублікати за назвою/URL пропускаються. Існуючі нотатки, статуси й перевірки не перезаписуються. Джерело та час записуються в нотатки. Це імпорт кандидатів без ШІ-оцінки; інші трекери ще не підключені. 37 тестів та браузерний сценарій кнопки пройшли.
План сервера, Android, Telegram та робота: ASSISTANT_ROADMAP.md.