Часті питання¶

Те, про що питають першого тижня. Якщо застосунок щойно поставлено й незрозуміло, з чого починати — «Поставив. Що далі?».

Скани й місце на диску¶

Треба скачати всі скани на комп'ютер?¶

Так. Нишпорка читає теку із зображеннями, що лежать на вашому диску, і нічого не читає «на льоту» з архівного сайту.

Причина не в лінощах: щоб прочитати аркуш, рушій ріже його на рядки й проганяє кожен через модель. Це десятки звернень до самого файла на одну сторінку.

Якщо потім видалити скани з комп'ютера — інформація зітреться?¶

Не вся, і різниця тут важлива.

Лишається (воно лежить у робочому просторі, а не в теці зі сканами):

машинний текст справи — <простір>\reports\htr\<назва справи>\;
облік переглянутого, знахідки, нотатки, реєстр справ;
пошук по цьому тексту працює далі.

Зникає:

картинка в гортачі й вирізки рядків — показувати нема з чого;
можливість подивитись кандидата оком, тобто підтвердити чи відкинути знахідку;
можливість перечитати справу ще раз — іншою моделлю або після оновлення ваг.

Тобто видалення сканів залишає вас із текстом, який нема з чим звірити. Перед тим, як звільняти місце, справу варто довести до кінця: прочитати, прошукати, знахідки занести в облік.

Дешевша порада: перенести теку на зовнішній диск і сказати про це застосунку — nysh roots add "E:\скани" або галочка «Узяти теку під облік там, де вона лежить» на екрані «Завести справу». Файли не переносяться, справа не зникає з переліків, а місце на системному диску звільняється.

Скани обов'язково класти всередину теки Нишпорки?¶

Ні. Тека може лежати де завгодно — зовнішній диск, робочий стіл, мережа. Потрібно лише один раз оголосити її: галочкою у формі, командою nysh roots add <тека> або полем case_roots у файлі nyshporka.toml.

Застосунок ніколи не бере теку сам — цей крок завжди явний.

Скільки місця треба?¶

сам застосунок із рушіями — близько 3 ГБ (з них ~2.5 ГБ важить torch);
ваги трьох моделей — ~130 МБ;
скани — скільки їх є; аркуш метричної книги важить 2-8 МБ;
машинний текст — дрібниця проти сканів, кілька МБ на справу.

Без читання рукопису (набір catalog) torch не ставиться взагалі.

Архів віддав PDF, а не окремі сторінки¶

Читання поки бере лише зображення, що лежать прямо в теці: jpg, jpeg, png, tif, tiff, webp. PDF застосунок показати може, а прочитати — ні; його треба спершу розкласти на посторінкові зображення зовнішнім засобом.

Робота з архівами¶

Чи можна працювати з ДАКО, ДАВіО, ЦДІАК — не тільки з ДАХмО?¶

Зі сканами будь-якого архіву — так, одразу. Скорочення й коди всіх обласних і центральних архівів України вже в довіднику, тож шифра ДАКО 13-1-1 приймається без жодних налаштувань: справа заводиться, читається, шукається, облік ведеться.

Різниця не в читанні, а в тому, чи вміє застосунок сам ходити каталогом архіву. Готові каталоги в комплекті — ДАХмО і ЦДІАК.

Як додати переглядач свого архіву в перелік джерел¶

Якщо архів працює на системі ARCHIUM (адреса виду archium.<архів>.gov.ua), його додають кількома рядками у файл <простір>\config\archives.yaml — код при цьому не чіпається. Для ДАКО це виглядає так:

version: 1
repositories:
  DAKO:
    sites:
      archium:
        url: https://archium.dako.gov.ua
        fond_groups: false

Після цього в переліку джерел з'являється archium-dako, і перегляд фондів, описів та справ працює:

nysh sources                              # у переліку з'явився archium-dako
nysh browse archium-dako fond:1           # описи фонду 1
nysh browse archium-dako inv:10           # справи опису, з кількістю аркушів

Перевірено на ДАКО: перегляд працює, завантаження — ні

Каталог ДАКО читається, а самі зображення цей архів віддає лише через особистий кабінет, під входом. Тому nysh get на справу ДАКО відмовить, хоч у переліку вона й видна. Скани звідти зберігаються вручну з кабінету.

fond_groups: false тут не декоративне: дерево груп фондів у ДАКО, як і в ЦДІАК, відповідає помилкою, і без цього рядка перегляд показав би чуже дерево.

Чи качає Нишпорка справи з FamilySearch?¶

Ні, і не качатиме: це вимагає живої сесії в браузері, а масове завантаження суперечить правилам сервісу. Що є натомість — поаркушевий покажчик плівок: яке село на яких кадрах якої плівки. Він відповідає на «де метрики мого села» без завантаження жодного байта, але накриває поки лише Молдову.

Читання¶

Чи потрібна відеокарта?¶

Ні. Найдовше в читанні рахує процесор, і на звичайному ноутбуці все працює — просто повільніше: близько 2 хвилин на сторінку проти ~20 секунд з відеокартою. Книга на 300 аркушів — це ніч роботи; комп'ютер при цьому не має спати.

Текст виходить із помилками — це поламка?¶

Ні, це стеля технології на такому матеріалі. На скорописі XVIII-XIX ст. машина плутає приблизно чверть-третину літер: «Franciszka Lubkowskiego» стає «Francisrha Lubhoustrio90».

Тому текст і не призначений для читання очима. Він потрібен, щоб у ньому шукати — пошук тут нечіткий і знаходить прізвище в покаліченому вигляді, — а знайдене дивитись на скані.

З цього ж випливає головне обмеження: не відкидайте кандидата через те, що корінь слова не схожий. Рушій калічить саме середину прізвища.

Чому текст читають два рушії?¶

Другий голос не для швидкості. Він помиляється інакше й витягує те, де перший підставив правдоподібне слово замість того, що справді написано.

Чи читає Нишпорка друкований текст, польські книги, документи ХХ століття?¶

Ваги вчились на скорописі XVIII-XIX ст. українських, молдовських і польських архівів. Латинка (нотаріат, костельні книги) читається окремим рушієм — Скрибою, і польську справу треба ставити на читання латинкою явно.

Поза цим матеріалом якість ніхто не міряв. Погано прочитаний текст виглядає так само впевнено, як добрий, тож першу справу з нетипового матеріалу варто звірити оком.

Вручну чи агентом¶

У чому взагалі різниця?¶

Вручну — ви працюєте в браузерному застосунку: заводите справи, запускаєте читання, гортаєте, шукаєте, тиснете кнопки. Застосунок повний сам по собі, і нічого, крім вашого часу, це не коштує.

З агентом — Claude Code або Codex керує тими самими операціями замість вас: сам заводить справи, ставить прогони, перебирає кандидатів, веде облік, пише звіт. Це зручно на великих обсягах і коштує грошей — за підпискою чи за токени того сервісу, яким ви користуєтесь.

Обидва шляхи ходять одним і тим самим ядром, тож змішувати їх можна вільно: почати руками, дочитати агентом і навпаки.

Що потрібно, щоб підключити агента¶

nysh skills install     # порядок роботи, який агент підвантажує за потреби
nysh mcp install        # прописати сервер у .mcp.json проєкту

Скіли в комплекті: перша сесія на свіжій установці, читання справи, пошук прізвища, ведення обліку, читання на чужій машині.

Агентові при цьому не обов'язковий MCP: nysh op <ім'я> --describe віддає схему будь-якої операції, nysh op <ім'я> --args ... виконує її.

Чи розбере агент метричну книгу на поля — дати, імена, ролі?¶

Так, і це єдина частина роботи, за яку платите ви самі. Пакет дає нарізку на тайли, контракт, перевірку й чексуми повноти книги, але сам не читає: аркуш читає модель вашого агента, і це близько 84 тисяч токенів на скан. Книга на дві сотні аркушів — мільйони токенів за прохід, а проходів треба два, бо один прохід не є джерелом істини.

Вбудувати сюди чужий платний API означало б витрачати ваші гроші з програми, яку ви поставили подивитись каталог.

Установлення й неполадки¶

Інсталятор завершується помилкою, «код 1»¶

Сам по собі код 1 означає лише «щось не вдалося» і причини не називає. Дивитись треба останні рядки виводу — там сказано, який саме крок упав. Найчастіші причини:

обірване завантаження — інсталятор тягне з мережі власний Python і пакети;
бракує місця на диску — набір із рушіями важить близько 3 ГБ;
антивірус або корпоративна політика блокують запис у профіль користувача;
irm … | iex — так цей скрипт запускати не можна: спершу -OutFile, потім -File. Робочі команди — на сторінці встановлення.

Якщо термінал взагалі не хочеться відкривати, простіший шлях — інсталятор nyshporka-setup.exe зі сторінки релізів. Він приносить власний Python, прав адміністратора не просить, а журнал пише сам:

nyshporka-setup.exe /LOG=setup.log

Windows пише «захистив ваш ПК» і не дає запустити¶

«Докладніше» → «Виконати в будь-якому разі». Так Windows зустрічає кожну програму, яку ще мало хто завантажував. Звірити завантажене можна за файлом .sha256, що лежить поруч із інсталятором у релізі.

Команда `nysh` не знаходиться¶

Закрийте вікно термінала й відкрийте нове: у вікнах, відкритих до встановлення, її не буде. Якщо й у новому не знаходиться — перезапустіть комп'ютер. Тим, хто ставив .exe-інсталятором, ярлики працюють одразу.

Екран порожній, хоча дані мають бути¶

Порожній екран завжди називає, чого саме бракує. Три найчастіші випадки:

Бібліотека порожня, а справи на диску є — реєстр не перезбирали (nysh cases build), або теки лежать без шифри й чекають у Приймальні.
Описи фондів порожні — реєстр опису не зібраний. Це два кроки: nysh registry collect, потім nysh registry merge; другий не необов'язковий.
Каталоги нічого не знаходять — подивіться таблицю джерел під полем пошуку: джерело без зібраного каталогу назване там поіменно, разом із командою.

Половини екранів немає¶

Частини застосунку вмикаються й вимикаються: ⚙ → «Частини застосунку» (або nysh sections). Якщо при встановленні обрано набір catalog, читання рукопису вимкнене цілком — це економить 2.5 ГБ, і вмикається без перевстановлення.

Гроші й приватність¶

Скільки коштує Нишпорка?¶

Нічого. Програма вільна, під ліцензією AGPL-3.0. Платити доведеться лише за сторонні речі, якщо ви ними користуєтесь: підписку агента (розбір актів у поля) і оренду відеокарти, якщо надумаєте читати справи в хмарі.

Мої скани й моє дослідження кудись відправляються?¶

Ні. Телеметрії немає, облікових записів немає, серверної частини немає. Скани, прочитаний текст і нотатки лежать у теці на вашому диску.

У мережу застосунок ходить лише тоді, коли ви самі про це попросили: пошук по каталогах, завантаження справи, встановлення моделей і оновлення самого пакета. Повний перелік адрес — у політиці приватності.

Чи можна перенести дослідження на інший комп'ютер?¶

Так. Простір — звичайна тека; її можна скопіювати цілком. Справи всередині неї записані відносними шляхами саме для цього. Сказати застосунку, де вона тепер:

$env:NYSHPORKA_WORKSPACE = 'D:\Дослідження'
nysh --workspace D:\Дослідження doctor

Опис кожної справи лежить у самій теці справи, тож переїжджає разом із нею — і до колеги теж.

Коли пошук нічого не знайшов¶

Порожній результат — найдорожча відповідь у генеалогії, бо «немає» закриває напрям надовго. Перш ніж у нього повірити, варто відповісти на три питання:

Чи читабельний текст? Подивіться справу в гортачі. Якщо там суцільний шум, нуль стосується якості читання, а не наявності прізвища.
Скільки сторінок насправді прошукано? «Не знайшлось у 876 прогонах з 1159» і «не знайшлось у 1159» — різні відповіді. Застосунок показує це до запиту.
Чи знаходить пошук те, що в цій справі точно є? Візьміть прізвище, яке ви вже бачили на скані власними очима, і пошукайте його. Не знайшлось — справа в пошуку, а не в справі.

І окремо: не викреслюйте кандидата через те, що корінь слова не той. Рушій калічить середину прізвища найчастіше, тож шукане може вийти з нього невпізнанним.