Куди копати: картки каналів

Третій із трьох файлів документа «Куди копати». Протокол і класи — у where-to-dig.md, маршрути за жанрами — у where-to-dig-genres.md. Читати картки тих каналів, які стоять у плані заходу.

Одна картка — один канал. Формат однаковий, і саме він робить канал придатним до маршруту. Перелік підключених джерел, що кожне вміє, де його межі й що доводить його нуль — завжди з nysh op sources.list (поле about); картка каже те саме людською мовою, із замірами й пастками, а не чи є канал на цій машині.

### Канал: <клас або `id` з `nysh op sources.list`>
- **Питання, на яке відповідає:** одне речення, як його ставить людина
- **Дає:** що саме приходить — перелік справ, копія, текст, контакт
- **Не дає:** чого не питати
- **Як кликати:** команда або операція, або «руками» — `caps` з `nysh op sources.list`, не звідси
- **Ціна за захід:** час · токени (порядок) · гроші
- **Знаменник нуля:** що треба назвати, щоб «немає» щось означало
- **Пастки:** два-чотири рядки, кожен із причиною
- **Замір:** дата — що міряли, що вийшло; без дати замір не рахується
- **Стан:** активний · 0 за N заходів · більше не повертатись — з датою й причиною

У вбудованого джерела пакета картка має двійника в коді — about у класі джерела: answers — «Питання», gives і not_gives, zero_means — «Знаменник нуля», pitfalls — «Пастки», where_class — рядок таблиці класів. tests/test_source_cards.py вимагає для кожного вбудованого джерела картку з його id у заголовку.

🔴 Канал без картки не викидається мовчки. Без картки агент не знає, на яке питання канал кликати, чим приймати відповідь і що означає нуль, — але джерело з nysh op sources.list, у якого немає картки чи about, усе одно йде в план рядком «без опису — перевірити руками». Саме так фотоархів Волока випав із маршруту в симуляції 15.09.2026: підключений, але без картки. Новий канал і далі заводиться карткою раніше, ніж скриптом.

Канал: локальні сховища (local і сховища простору)

• Питання: ми це вже знаємо? що вже лежить на диску?
• Дає: канон, реєстри описів, нотатки, реєстр справ, сховище сторінок, прочитаний текст.
• Не дає: нічого про те, чого в простір не заносили.
• Як кликати: nysh text grep "<регекс>" --where all, nysh cases list, nysh pages status <справа>, nysh find <шифра> (бібліотека — перший крок адресного маршруту).
• Ціна: секунди, токени малі, гроші нуль.
• Знаменник нуля: layers.coverage по шарах; stale.is.
• Пастки: застарілий реєстр виглядає як відповідь; rg по теці прогонів мовчить.
• Стан: активний, завжди перший.

Канал: ridni — каталог книг за селом

• Питання: які метричні, сповідні й клірові книги мого села збереглися, за які роки, і де копія.
• Дає: перелік книг із роками, церквою, приписними селами, шифрою й, де є, адресою копії або номером плівки; головне — роки, яких у фонді немає.
• Не дає: опису фонду цілком; світських фондів; нічого про справи без прив'язки до села.
• Як кликати: nysh find "<село>" --source ridni.
• Ціна: секунди, гроші нуль.
• Знаменник нуля: кількість записів по селу; збіг чи розбіжність із газетиром і покажчиком.
• Пастки: звуження на боці сервера немає — запит по назві йде по всій країні, відсів робить пакет; у видачі трапляється книга чужої парафії, до якої село приписане; поле копії відстає від архіву — порожнє не означає «немає онлайн».
• Замір: 30.08.2026 — перелік метрик одного села збігся з газетиром дослівно, а відсутність трьох років у обох каталогах довела лакуну фонду.
• Стан: активний, перший для жанру 1.

Канал: duck — зведений покажчик

• Питання: що взагалі існує про село або у фонді, оцифроване чи ні.
• Дає: справи за заголовком, анотацією, парафією і колом сусідів; повний склад опису за хвилину.
• Не дає: пошуку за селом без знання фонду в старих режимах; заголовки — чужі транскрипції, не першоджерело; нічого не віддає — покажчик, не сховище.
• Як кликати: nysh find "<село>" --source duck, nysh parish find, nysh parish in-case, nysh parish mentions, nysh parish near; порядок і заміри — скіл find-parish.
• Ціна: секунди; черга запитів спільна на машину.
• Знаменник нуля: скільки з чотирьох каналів прогнано, якими написаннями, чи впирались у стелю 50, чи були в книги перелічені парафії.
• Пастки: стеля видачі 50 без пагінації; парафія кількома записами; тег конфесії буває хибний; для деяких архівів поле адреси копії порожнє всюди.
• Замір: 30.08.2026 — по одному фонду покажчик дав повний склад двох описів із роками на 100 %, адрес копій — нуль, пошуку за селом — немає; відповідь по селу того дня дав каталог за селом.
• Стан: активний; для села — другий після ridni, для фонду — перший.

Канал: газетир (nysh geog)

• Питання: де документи цього села по всіх фондах одного архіву, не лише в православному розділі.
• Дає: картку поселення з прив'язкою, церквою й переліком справ, і що з них уже в нас.
• Не дає: інших архівів; світських фондів поза каталогом.
• Як кликати: nysh geog find "<село>", nysh geog card <id>.
• Ціна: секунди, локально.
• Знаменник нуля: чи зібрано базу (nysh geog build); чи є поселення в газетирі під цією назвою.
• Пастки: однойменні села з чужих повітів; історична назва не завжди індексована.
• Стан: активний.

Канал: церкви до поділів (nysh church)

• Питання: чи була в селі парафія у XVIII ст., чия, у якому деканаті, і де тепер її книги.
• Дає: церкву з присвятою, деканатом, патронатом, сторінкою джерела, колом сусідніх церков; зшивку з газетиром.
• Не дає: метрик; координат, надійніших за прив'язку укладача бази.
• Як кликати: nysh church find "<село>", nysh church card <id>, nysh church near "<село>" --km 12.
• Ціна: секунди, локально.
• Знаменник нуля: чи є пак церков у каталозі (nysh catalog list).
• Пастки: однойменне село в іншому воєводстві зшивається з позначкою region=mismatch; парафію звіряти за храмом.
• Стан: активний.

Канал: archium — переглядач архіву

• Питання: забрати скани справи, яку вже знаю за шифрою; пройти описом фонду.
• Дає: перегляд фондів, описів і справ з кількістю аркушів; кадри.
• Не дає: негативу — індексуються лише введені описи, тож нуль пошуку тут нічого не означає; для частини архівів — завантаження без входу.
• Як кликати: nysh find <шифра>, nysh browse <id> fond:<N>, nysh get <id> <ref>; окремий id на кожен майданчик.
• Ціна: хвилини на справу; гроші нуль.
• Знаменник нуля: для завантаження — лічильник кадрів у джерелі; для пошуку — знаменника немає, і це треба сказати.
• Пастки: адреса перегляду дрейфує; на неоцифровану справу майданчик віддає головну сторінку з кодом 200; кадри приходять кольоровими і важать утричі більше, ніж треба для читання.
• Стан: активний.

Канал: commons — Wikimedia Commons і Вікіджерела

• Питання: повні томи й описи, викладені волонтерами.
• Дає: файли справ, скани описів, транскрипції описів.
• Не дає: пошуку по змісту; гарантії, що файл — справа цілком.
• Як кликати: nysh get commons <ref>; пошук по опису — руками.
• Ціна: хвилини; гроші нуль.
• Знаменник нуля: чи взагалі викладений цей фонд.
• Пастки: файл буває витягом однієї парафії, а не справою; транскрипція опису обірвана або відсутня для частини описів; дублікат тієї самої справи під іншим номером.
• Стан: активний.

Канал: fsfilm — дзеркало плівок

• Питання: кадри плівки без входу в сервіс; яке село на яких кадрах.
• Дає: кадри й поаркушевий покажчик плівок для покритих регіонів.
• Не дає: масового завантаження з самого сервісу — це проти його правил і не буде реалізовано; сіл для частини плівок.
• Як кликати: nysh find "<село>" --source fsfilm, nysh get fsfilm <ref>.
• Ціна: хвилини; гроші нуль.
• Знаменник нуля: чи покритий регіон покажчиком.
• Пастки: покажчик тримає лише першу парафію плівки; сусідні села звіряти окремо; дзеркало обрізає великі файли при збіжному розмірі.
• Стан: активний.

Канал: babynyar — онлайн-архів XX ст.

• Питання: книги РАЦС і те, чого архіви онлайн не показують.
• Дає: десятки архівів однією адресою; кадри.
• Не дає: пошуку на самому майданчику — працює по каталогу, який треба зібрати; не всі фонди й не всі архіви.
• Як кликати: nysh crawl babynyar, потім nysh find "<район>" --source babynyar.
• Ціна: збір каталогу — десятки хвилин; далі секунди.
• Знаменник нуля: чи зібрано каталог за потрібним архівом і роком.
• Пастки: прямий доступ інструментами ріже сам майданчик — це властивість маршруту, не відсутність справи.
• Стан: активний.

Канал: chtyvo — текст друкованих книг

• Питання: де моє село згадане в літературі; чи є друкована праця про фонд або повіт.
• Дає: пошук у тексті книг без завантаження, номер сторінки.
• Не дає: повного тексту довгих книг — індексована лише перша частина; форматів без текстового шару.
• Як кликати: nysh find "<село>" --source chtyvo, далі nysh get chtyvo <ref> і nysh text grep "<регекс>" --dir <тека>.
• Ціна: секунди на пошук; хвилини на книгу.
• Знаменник нуля: довжина книги проти індексованої частини — нуль по довгій книзі слабкий.
• Пастки: книга без текстового шару виглядає як нуль; сучасна назва в старій книзі не трапляється.
• Стан: активний.

Канал: ia — повний текст Internet Archive

• Питання: де прізвище чи село згадане в газетах, єпархіальних відомостях, пам'ятних книжках, викладених на archive.org.
• Дає: пошук по тексту сканів; на кожне входження — лист, адреса сторінки й вирізка навколо слова; текст документа по листах і кадри листів.
• Не дає: форм слова — індекс шукає лише точне слово; OCR-калік; латинки в частині колекцій.
• Як кликати: nysh find "<слово> in:<колекція або запис>" --source ia, кожна форма окремим запитом; далі nysh get ia <ref> і nysh text grep "<регекс>" --dir <тека> для нечіткого пошуку.
• Ціна: секунди на запит; хвилини на текст тому.
• Знаменник нуля: перелік форм × межа (in:, year:) і перевірка відомим позитивом у тій самій межі — нуль закриває лише перелічені форми.
• Пастки: зірка, OR і змішане письмо — відмова, а не нуль; year: — рік запису, у записі з багатьма томами він один на всі.
• Стан: активний.

Канал: volok — фотоархів дослідника

• Питання: чи знімав хтось цю справу чи книгу — і де подивитись кадри.
• Дає: альбом Flickr із назвою, шифрою, архівом (як його пише автор), роками й адресою. Автор знімає в архівах і бібліотеках підряд: РДІА (дворянство, Селянський поземельний банк, плани міст), ДАДнО, ДАКО (Курськ), ГА РФ; друковане — списки населених місць, статистичні збірники, розписи парафій, родовідні книги.
• Не дає: кадрів — їх дивляться й беруть на Flickr; топонімів, що стоять на кадрах, а не в назві альбому.
• Як кликати: nysh find "<слово>" --source volok, основою слова, а не повною формою; новий список автора — nysh crawl volok --from List<РРРРММДД>.zip.
• Ціна: секунди, локально; гроші нуль.
• Знаменник нуля: дата списку й кількість альбомів із basis; нуль означає «у назвах альбомів на дату списку немає всіх слів запиту», а не «ніхто не знімав».
• Пастки: збіг — підрядок без відмінків, тож основа знаходить більше за повну форму («Мелітопол» — 15 альбомів, «Мелітопольський» — 1); короткий корінь ловить чуже («казк» — народні казки, «Метрич» — «Геометрический план»); «ДАДО (ДАДнО)» у назвах — Дніпропетровський архів, не Донецький ДАДоО, і repo у знахідці порожній.
• Замір: 15.09.2026, список від 12.09.2026 — «Бахмут» 37 альбомів (списки населених місць 1911, статистичний збірник 1886, землевласники 1905, плани міст), «ДАДО» 1195, «Екатеринослав» 205, серед них «Росписание приходов, церквей и причтов Екатеринославской епархии»; ревизск і исповед — 0.
• Стан: активний.

Канал: веб-пошук (поза nysh op sources.list, руками)

• Питання: краєзнавство й контекст — назви, перейменування, кордони, парафіяльна приналежність; друковані серії та їх оцифровані копії; форуми й паралельні дослідники; чи має архів онлайн-каталог; біографічні згадки XX ст.
• Дає: контекст із джерелом, посилання на друковане, людей.
• Не дає: архівних позицій — справу знаходить каталог, не пошуковик; нічого, що можна внести у факт без звірки.
• Як кликати: руками; рядок запиту — усіма написаннями: сучасним, історичним, мовою діловодства доби.
• Ціна: час; токени зростають із кожним переглянутим результатом; гроші нуль.
• Знаменник нуля: перелік запитів (написання × мова) і межа заходу.
• Правила:
• Нічого з вебу не йде у факт без джерела (адреса й дата) і без звірки каталогом або документом.
• Захід обмежується заздалегідь — числом запитів або часом; після межі звіт зі знаменником, а не наступний запит.
• Архівна шифра з вебу перевіряється адресним маршрутом nysh find <шифра>.
• Веб рівноправний з рештою каналів: у жанрах 7 і 9 він стоїть рано, у жанрах 1–5 — після каталогів, і не тому, що гірший, а тому, що там на питання відповідає каталог.
• Пастки: частина архівних і бібліотечних майданчиків ріже автоматичні запити (403, 402, заслін на JavaScript) — це «цим маршрутом не дістатись», а не «немає». Таблиця «джерело × маршрут доступу» — в оверлеї дослідника.
• Стан: активний.

Канал: банк посібників фахової спільноти

Великі генеалогічні спільноти тримають розділ «Посібники» (Guides) — набір дописів, які адміністратори відібрали й розклали по темах. Це інший шар, ніж стрічка: стрічка — потік питань, посібники — відповіді, відібрані людьми, що працюють із цими архівами щодня. Зняте лягає в простір як звичайні нотатки, тож питається тим самим nysh text grep, що й решта прочитаного.

• Питання: з чого почати по цій області; який покажчик метрик існує; де онлайн-колекція цього фонду; як подати запит; що взагалі буває в цьому жанрі.
• Дає: назву ресурсу, адресу, і — головне — присуд фахівців про нього в коментарях: що там насправді є, за які роки, і чого шукати марно.
• Не дає: нічого про конкретну справу й конкретне прізвище; жодного систематичного покриття — набір відбиває інтереси тих, хто його складав.
• Як кликати: nysh text grep "<регекс>" --where notes по вже знятому банку. Саме зняття робиться окремим збирачем спільноти: він потребує чужого облікового запису й підкоряється чужим правилам, тож це окремий крок, а не частина пошуку.
• Ціна за захід: зняття — години й один обліковий запис у спільноті; питання до вже знятого — секунди, токени малі, гроші нуль.
• Знаменник нуля: скільки посібників знято з наявних і скільки матеріалів дістали тіло. Обидва числа друкує хаб банку; без них «у банку немає» означає лише «ми цього ще не знімали».
• Пастки:
• посібник, якого не знімали, виглядає в банку так само порожньо, як справді порожній — звіряти з колонкою «знято», а не з відсутністю рядка;
• матеріал-картинка й матеріал-файл тіла не мають узагалі, і це не збій: уся їхня цінність у назві та підписі;
• адреси в дописах старіють мовчки — покажчик, названий у 2019-му, міг переїхати або зникнути; перевіряє той канал, якому ресурс належить;
• присуд у коментарях — це досвід, а не документ: він каже, куди йти, і не замінює перевірку в самому архіві.
• Замір: 22.09.2026, спільнота з 42 тис. учасників — 24 посібники, 316 матеріалів, серед джерел переважають каталоги метрик, польські та українські архівні портали й державні реєстри.
• Стан: активний; знімається раз на кілька місяців, бо змінюється повільно.

Класи без вбудованого джерела

Ці канали кличуться через реєстр опису фонду (keep-fond), покажчик або руками. Картка коротша, бо «як кликати» в них однакове.

клас	питання	дає	не дає	знаменник нуля	пастки
консисторія	клірові, метрики, сповідки, справи причту	рік за парафією	нічого до переходу парафії у православ'я	рядки опису за роком і повітом	томи нарізані за абеткою сіл, і в каталозі цього не видно
дворянське зібрання, Герольдія	докази шляхетства	іменна справа, протоколи	однодворців і чиншовиків після виключення	рядки опису за літерою	однокорінні роди; номери між публікаціями
суди, нотаріат	купчі, спадщина, легітимації	сторони й свідки з місцем проживання	систематичного обліку населення	опис і покажчик-анотація	село лише в анотації
маєткові інвентарі	хто жив у маєтку і на яких умовах	двори з повинностями, окрема секція шляхти	точних років народження	інвентар року знайдено або ні	ключ маєтку названо іменем власника, не села
ревізії, однодворчі списки, волосні	податний стан за роком	склад двору, переміщення	станів, що не підлягали ревізії	казка року за селом	назва стану — дані, не константа
єпархіальні відомості, періодика	кар'єра причту, некрологи	рядок із датою	повноти за роки лакун видання	роки × номери	покажчик тематичний; OCR плутає літери
рукописний відділ бібліотеки	візитації, суд митрополії, топографічні описи деканатів	справи, яких в архівах немає; суцільні діапазони одиниць зберігання по деканатах	каталогу онлайн одним входом; списків парафіян	обидва входи перевірені; діапазон із довідника звірено каталогом: скільки справ, скільки оцифровано, скільки на диску	описи рукописні, OCR сліпий; пошук за словами назви пропускає справи, названі інакше
ЗАГС / ДРАЦС	акти після 1920-х	виписку родичу	сканів, ніколи	письмова відмова або виписка	доступ лише за спорідненістю
люди	те, чого немає онлайн	документи з приватних архівів, досвід	швидкої відповіді	дата запиту	усне — непряме свідчення

---