Спільна робота і прогрес

Мова: English · Українська

Кімнати

Один учасник запускає кімнату у своєму Picoripi, інші приєднуються до неї. Центрального сервера немає і нічого не треба встановлювати: Picoripi хоста і є сервером (core/collab/server.py, лише стандартна бібліотека Python). Відкрийте її через Tools → Work Together... або кнопку Room: у рядку стану.

• Хост: введіть ім'я, виберіть порт (типово 8765) і пароль (його пропонують), натисніть Start the room. Windows може попросити дозволити Picoripi в брандмауері. Copy the invitation копіює адреси комп'ютера й пароль; надішліть їх іншим.
• Приєднатися: введіть ім'я, адресу хоста (192.168.1.20:8765) і пароль, натисніть Join.
• Усі відкривають той самий проєкт. Рядки названо за файлом, ключем блока і номером, і кімната звіряє відбиток тексту оригіналу кожного рядка: інший дамп чи регіон гри отримує відмову «another project».
• Мережа: кімната слухає лише цей комп'ютер (127.0.0.1), доки ви не відмітите Дозволити іншим комп'ютерам (LAN) перед Start the room. Тоді слухають усі мережеві інтерфейси, і комп'ютери вашої мережі можуть приєднатися з паролем. Трафік — звичайний HTTP, а пароль — спільний секрет, не шифрування: дозволяйте іншим комп'ютерам лише в мережі, якій довіряєте. Працюйте в локальній мережі або через VPN, що об'єднує комп'ютери в одну мережу (Tailscale, ZeroTier, Radmin VPN). Прокинутий на роутері порт теж працює, на ваш ризик.

Що спільне. Кожна правка перекладу (набір, AI-переклад, автовиправлення, Undo) доходить до інших за секунду-дві; у черзі перемагає найновіший текст рядка, тож набір — не запит на кожну клавішу. Правка іншого учасника приходить як незбережена правка: зберігайте як завжди. Її немає у вашому стеку Undo. Дві дії оминають кімнату: Import BMG та Undo Paste (вони пишуть багато рядків разом); повторіть їх на кожному комп'ютері або правте рядки.

Приєднання. Коли ви приєднуєтеся, рядки, які має кімната, замінюють ваші (як незбережені правки; ваші файли тримають старий текст, доки ви не збережете). Рядки, які ви переклали, а кімната не має, діляться з нею. Рядок, який ви змінили й не зберегли, а кімната має в іншій версії, не перезаписується: він стає конфліктом. Рядок стану каже, скільки рядків узято, поширено і в конфлікті.

Конфлікти. Кожен рядок у кімнаті має ревізію. Правку, зроблену на старій ревізії (двоє змінили той самий рядок одночасно), кімната відхиляє, а смужка над редактором показує обидві версії: Take theirs або Keep mine (яка надсилає вашу поверх).

Хто де. Смужка над редактором каже Here now: з іменами інших на тому самому рядку і Last changed by з іменем і часом. Вікно Work Together перелічує всіх у кімнаті й де вони; подвійний клік на імені — перейти туди. Кнопка в рядку стану показує, скільки людей у кімнаті.

Пам'ять кімнати. Кімната хоста пише свої рядки й лічильники команди в collab_room.json у теці проєкту хоста; кімната, запущена знову на тому самому проєкті, їх зберігає. Leave the room від'єднує; коли хост виходить, кімната закривається для всіх. Ім'я, порт і остання адреса (ніколи не пароль) запам'ятовуються в ~/.picoripi/collab.json.

Ролі, закріплення і коментарі

Ролі. Роль належить вашому токену кімнати, а не комп'ютеру.

• Господар (Host): один. Господар призначає модераторів і може передати роль господаря іншому (Make host, після підтвердження). Попередній господар стає модератором.
• Модератор: будь-яка кількість, призначає господар.
• Рецензент (Reviewer): позначає рядки затвердженими. Текст не змінює.
• Перекладач (Translator): роль, яку отримує кожен при приєднанні. Редагує рядки і закріплює їх.
• Спостерігач (Observer): читає і коментує.

Закріплення. Виберіть рядок, файл, блок, теку або віртуальну теку («Shared», « only») у дереві блоків, натисніть правою кнопкою і Claim for me. Рядок можна закріпити і зі смужки над редактором (Claim this row).

• Ділянку, яку ніхто не закріпив, отримуєте одразу.
• Ділянка, яку тримає хтось інший, стає запитом. Господар або модератор передає її або відхиляє.
• Закріплений рядок змінює лише його власник. Решта бачить Claimed by Name у смужці, а їхня зміна повертається.
• Ділянки, які ніхто не закріпив, не потребують закріплення: їх змінює кожен.
• Закріплення лишається, коли власник виходить; кімната показує його офлайн. Власник, господар або модератор його знімає.

Присутність. Коли відкриваєте рядок, над яким хтось працює, рядок стану каже «Name is working here». Нічого не блокується.

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

• ● N — кружечок з літерою учасника, який працює в блоці (+1, якщо їх більше). Підказка: «Name works here, N min ago».
• 🔒 N — закріплення в блоці з літерою власника. Елемент сірий, якщо власник офлайн.
• 💬 3 — три відкриті коментарі в блоці. Вирішені не враховуються.

Смужка над редактором показує те саме для відкритого рядка і кнопки Claim this row, Approve, Comment…. Рядок, закріплений за кимось іншим, у редакторі лише для читання: ви бачите його текст, а смужка каже Claimed by Name. Правою кнопкою на смужці або на блоці в дереві — меню кімнати: Claim for me, Release my claim here, Assign to…, Comment…, Resolve comments here.

Коментарі. Коментуйте рядок, файл, блок, теку, віртуальну теку або весь проєкт: правою кнопкою на елементі дерева натисніть Comment… або натисніть Comment… у смужці над редактором. Коментар має автора, час і текст. Resolve позначає коментар вирішеним із вказанням, хто і коли; натисніть знову, щоб відкрити його. Коментарі видно всім у кімнаті. Кожна Picoripi учасника зберігає копію в comments.json у теці свого проєкту, а кімната — у collab_room.json, тож коментарі лишаються після закриття кімнати. comments.json від попередньої кімнати господар або модератор переносить до кімнати під час входу; інші учасники бачать ці коментарі, щойно кімната їх має.

Затвердження. Рецензент, модератор або господар натискає Approve у смужці над редактором. Пізніша зміна тексту рядка знімає затвердження.

Ідентичність. Ваш токен зберігається на цьому комп'ютері для кожної адреси кімнати і імені в ~/.picoripi/collab.json (ніколи не пароль). Приєднайтеся до тієї самої адреси з тим самим іменем, і ви отримаєте свою роль назад. Токен ніколи не надсилається на іншу адресу. Поки ви онлайн, інший комп'ютер не може приєднатися з вашим іменем.

Вилучення учасника. Remove from room блокує токен учасника і його ім'я, доки господар або модератор не натисне Allow back. Пароль кімнати все одно пускає під новим іменем, тому змініть пароль, щоб не пускати когось. Господаря не можна вилучити. Модератора не можна вилучити, спочатку змініть його роль. Господаря й модераторів не можна вилучити.

Вікно. У вікні Work Together під списком людей є чотири вкладки: Roles, Claims (разом із запитами), Comments і Moderator log (лише для господаря).

Кімната без вікна. Кімната може працювати без вікна Picoripi на комп'ютері, який лишається ввімкненим:

python -m core.collab.server --headless --port 8765 --password-file room-password.txt --project-dir "D:\Projects\MyGame" --owner-token-file owner-token.txt

Першим господарем стає учасник, який приєднується з токеном із owner-token.txt. Процес друкує один рядок з портом і ідентифікатором кімнати та працює, доки ви його не зупините. Без --owner-token-file новий токен господаря друкується лише з --print-token; рядок на виводі тоді містить токен, тож тримайте цей вивід приватним. Кімната відповідає на пароль кімнати (для приєднання) і на токени кімнати (для всього іншого).

Віддалені кімнати вимкнені за замовчуванням. Picoripi підключається до кімнати лише тоді, коли ви натискаєте Start the room, Join або Connect. Нічого не підключається саме. Адреса й ім'я кімнати запам'ятовуються для наступного запуску; пароль — лише якщо ви позначили Remember this room. Пароль зберігається в налаштуваннях цього комп'ютера (collab.json, як ключі ШІ), ніколи в теці проєкту чи експорті. Забути збережену кімнату можна кнопкою Forget. Трафік іде звичайним HTTP: використовуйте VPN або мережу, якій довіряєте.

Сторінка прогресу

Tools → Progress... рахує відкритий проєкт у фоні й відкриває сторінку в браузері (progress.html у теці проєкту; core/progress_stats.py):

• кільце з часткою перекладених рядків, перекладені рядки й слова оригіналу, рядки, що лишилися, рядки за сьогодні, дні поспіль і дні до кінця в середньому темпі останніх семи робочих днів;
• досягнення: 100, 500, 1 000 … перекладених рядків, завершені блоки, серія від трьох днів;
• графік перекладених рядків по днях (один запис на день у progress_history.json у теці проєкту, пишеться щоразу, коли сторінку рахують);
• блоки, де лишилося найбільше, кожен зі смужкою.

Рядок вважається перекладеним, коли його оригінал має текст окрім тегів, а поточний текст не порожній і відрізняється від оригіналу (те саме правило, що в редакторі).

У кімнаті сторінку віддає хост за адресою http://<адреса хоста>:<порт>/stats?token=<токен кімнати> (кнопка Progress page додає токен; Tools → Progress); вона оновлюється сама кожні 30 секунд і додає таблицю Team: для кожного учасника — слова оригіналу й рядки, які він переклав першим, його правки і слова за сьогодні, з медалями для перших трьох, Leader of the day і тим, на скільки другий відстає від першого. Рядки, поширені при приєднанні, не зараховуються нікому; шліфування вже перекладеного рядка — це правка, а не нові слова. Сторінка показує лише числа й імена, ніколи не текст; її може відкрити кожен, хто досягає адреси кімнати. Picoripi кожного учасника надсилає кімнаті свіже зведення проєкту при приєднанні, а далі раз на хвилину, поки йдуть правки.