Як перенести рід у проєкт: покрокова інструкція

У Нишпорці 0.37 одна Майстерня може вести кілька проєктів: ваш рід, рід дружини, замовлення клієнта. Якщо ви ставили Нишпорку раніше, ваш рід лежить просто в просторі, без проєкту. Ця інструкція — про те, як перенести його в проєкт. Це треба зробити кожному, хто оновлюється з попередніх версій.

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

Перенос — обов'язковий крок переходу на 0.37

Перенесіть рід у проєкт одразу після оновлення, навіть якщо ведете лише один рід.

Старий простір після оновлення ще відкривається й працює: той самий канон, те саме прочитане, ті самі команди. Ми лишили це, щоб ви переносили рід тоді, коли зручно, а не в ту ж хвилину, коли оновились. Але Нишпорка 0.37 і наступні випуски побудовані навколо Майстерні з проєктами, тож рід, що лежить просто в просторі, — це перехідний стан, а не спосіб роботи.

• Ведете один рід — переносьте все одно. Простір стане таким самим, як у тих, хто ставить Нишпорку вперше.
• Беретесь за другий рід або замовлення — спершу перенесіть перший, і лише потім заводьте другий. Інакше перший рід лишиться змішаним із Майстернею, і Нишпорка про це нагадуватиме.

Що переїжджає, а що лишається

Перенос нічого не копіює й не перечитує. Те, що стосується саме роду, переїжджає в теку projects/<ім'я>, а спільний матеріал лишається на місці й далі доступний з будь-якого проєкту.

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

Перед переносом

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

1. Оновіться до 0.37 і скажіть своєму помічникові (Claude чи Codex): «перейди на нову версію».
2. Дочекайтесь, поки все стихне. Не має йти читання справи, завантаження з архіву чи віддавання в Супрягу. Нишпорка не почне переносу, якщо в теках роду щось змінювалось за останні 10 хвилин.
3. Заберіть усе з хмари. Якщо в хмарі щось читається або орендована карта ще не звільнена, дочекайтесь кінця, заберіть результат і звільніть карту (екран «Хмара»).
4. Збережіть правки. Якщо простір веде історію змін, усе в теках роду має бути збережено. Канон Нишпорка зберігає сама. Якщо план скаже про незбережене, попросіть помічника: «збережи історію» (nysh history save).
5. Перевірте місце на диску. Перед переносом Нишпорка складає архів усього, що переїжджає. Він лягає в теку поруч із простором: якщо простір — D:\Нишпорка, архів буде в D:\Нишпорка-adopt. Місця треба приблизно стільки, скільки займає те, що їде, і ще десяту частину. Точне число покаже план.
6. Придумайте ім'я проєкту. Воно стане назвою теки: малі латинські літери, цифри й дефіс, до 48 знаків. Наприклад, ivanenko чи rid-ivanenkiv. Українську назву з кольором і знаком дасте потім.

Помічником чи кнопкою

Перенести рід можна двома способами.

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

• після переносу розкладе свою пам’ять та інструкції: родинне — у проєкт, загальні правила — у Майстерню;
• якщо щось заважає переносу, сам розбереться, що саме, і прибере це.

Кнопкою в Нишпорці — без помічника. На огляді роду вгорі є плашка «Перенесіть рід у проєкт» і кнопка «Перенести…».

Екран переносу спершу ще раз радить доручити це помічникові. Щоб відкрити кроки, позначте «Переношу сам, без помічника».

Далі:

1. Назва проєкту. Назва, тека латинкою (Нишпорка підставить її з прізвища) і тека для архіву.
2. Перевірка. «Показати план» показує, що переїде і чи щось заважає. Якщо є незбережені правки, поруч буде кнопка «Зберегти».
3. Перенос. Нишпорка закривається на хвилину-дві, переносить рід і відкривається знову. Вкладка браузера оновлюється сама, і ви бачите, що зробити далі.

Коли наступного разу відкриєте помічника, він отримає нагадування розкласти пам’ять після переносу. Повернути все назад можна тут же, кнопкою «Повернути як було».

Нижче — те саме командами, для тих, хто працює в терміналі, і докладніше про кожен крок.

Крок 1. Подивитись план

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

Якщо робите самі, у терміналі в теці простору:

nysh project adopt ivanenko

На цьому кроці нічого не змінюється. Нишпорка лише показує, що поїде і чи все готово:

Переїзд кореня в проєкт «ivanenko»: 3 шляхів, 4 файлів, 0.0 МБ
  data/canonical                                    2 ф.       0.0 МБ  (git: 2)
  config/research_profile.yaml                      1 ф.       0.0 МБ  (git: 1)
  reports/research                                  1 ф.       0.0 МБ  (git: 1)
  погляд на сторінки: 0 сторінок → projects/ivanenko/data/views
  архів: D:\Нишпорка-adopt (вільно 56.6 ГБ)
Далі: nysh project adopt ivanenko --apply

Це план із пробного простору з двома особами в каноні. Ваш буде довшим. Як його читати:

• рядки з шляхами — що переїде: скільки файлів і мегабайтів у кожній теці;
• погляд на сторінки — скільки аркушів ви позначали як такі, що стосуються роду;
• архів — куди ляже архів і скільки там вільного місця;
• «Далі: …» — план чистий, можна переносити.

Крок 2. Прибрати перешкоди

Якщо щось заважає, план покаже це рядком із червоною позначкою 🔴, а рядка «Далі» не буде. Що означає кожна перешкода:

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

Крок 3. Перенести

Скажіть помічникові «так, переносимо» або виконайте самі:

nysh project adopt ivanenko --apply

Нишпорка робить усе по черзі й записує кожен крок у журнал:

1. Складає архів усього, що переїжджає, і перевіряє кожен файл у ньому. Доки архів не перевірено, нічого не рухається.
2. Заводить теку проєкту.
3. Переносить ваш погляд на аркуші.
4. Переносить теки роду. Історія змін іде разом із файлами.
5. Виправляє посилання доказів, щоб кожна вирізка знала, до якої картки якого проєкту вона належить.
6. Копіює пам'ять помічника в проєкт. Оригінал лишається на місці.
7. Позначає простір як Майстерню.

Наприкінці Нишпорка друкує, куди переїхав рід, мітку переносу і де лежить архів. Запишіть мітку й шлях до архіву.

Крок 4. Після переносу

1. Перезапустіть Нишпорку. Закрийте застосунок і відкрийте знову. Угорі з'явиться перемикач: Майстерня або ваш рід.
2. Дайте проєкту назву. Спершу проєкт зветься ім'ям теки. На огляді роду натисніть «Назва, колір і знак» і впишіть людську назву, наприклад «Рід Іваненків».
3. Перевірте, що все на місці. Огляд роду має показувати стільки ж осіб у каноні, скільки було до переносу. Бібліотека — ті самі справи з тими самими позначками «прошукано».
4. Перезберіть сайт родини, якщо він у вас є: екран «Сайт родини» → «Перезібрати». Сама збірка сайту не переїжджає, бо збирається з канону наново.
5. Помічник тепер працює в теці проєкту. Пам'ять, інструкції й стан роду він підхоплює на старті сесії, тож для роботи над родом відкривайте його там: nysh project open ivanenko --agent claude (або codex). Команди роду з кореня Майстерні тепер потребують --project ivanenko. Без нього вони відмовлять і не читатимуть порожній канон.
6. Дозвольте помічникові розібрати пам'ять. У першій сесії він розкладе нотатки: родинне лишиться в проєкті, загальні правила роботи — у Майстерні. Перш ніж щось видалити, він покаже вам перелік.

Архів переносу не видаляйте, доки не переконаєтесь, що все гаразд.

Як повернути назад

Якщо щось пішло не так або ви передумали:

nysh project adopt ivanenko --rollback

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

Найпростіше повертати одразу, поки ви ще нічого не змінили в проєкті. Якщо переносів було кілька, конкретний вибирається міткою: --stamp <мітка>. А якщо щось зіпсовано зовсім, у вас є архів із перевіреними файлами.

Другий проєкт

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

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