PlyLoom 0.14: больше места для работы
Карте отдано почти всё окно: верх сворачивается, карточки как в draw.io, паспарту в трёх состояниях, картинки в узлах и рассказ по шагам.
Когда языковая модель дорабатывает карту, она обычно возвращает весь проект заново — и увидеть, что именно она переписала, нельзя. В PlyLoom 0.10 правки приходят списком: каждую видно отдельно, нужные принимаются, остальные остаются в стороне, а всё сразу отменяется одним шагом.
Я попросил модель добавить в карту проекта одну проверку — что повторная доставка сообщения не создаёт второй файл. Ответ пришёл списком из четырёх пунктов. Два — то, о чём я просил: новая проверка и её связь с очередью. Два других я не заказывал: срок доступности файла незаметно стал 72 часа вместо 24, а из описания очереди пропала оговорка «конкретный продукт и провайдер не выбраны».
В полном файле эти два изменения тоже можно найти, но для этого надо сравнить два больших JSON целиком. Здесь они предъявлены отдельными пунктами: я оставляю отметки у проверки и связи, снимаю у срока и оговорки и нажимаю «Применить отмеченное». На карте появляется новый узел, обведённый зелёным, а срок и оговорка остаются прежними. Откройте этот пример — ответ модели уже ждёт проверки.
До сих пор работа с ИИ над готовой картой выглядела так: приложить проект к промту, попросить изменения и получить обратно весь проект. Открыв такой файл, вы заменяете карту целиком. Если модель по дороге потеряла пару узлов, сократила цитату или «поправила» атрибут, о котором её не просили, заметить это можно, только сравнив два больших файла целиком. Это долго, и что-то легко пропустить.
Подводит сама форма ответа. Полный файл — это снимок, а нам нужна разница: что добавить, что изменить и что убрать. Поэтому в 0.10 PlyLoom различает две вещи.
.plyloom, полный снимок проекта. Его хранят, пересылают коллегам, кладут в репозиторий. С нуля карта по-прежнему приходит пакетом.Чужие правки никогда не попадают в проект сами. Они проходят один и тот же экран проверки — пришли они от ИИ или из файла коллеги.
В меню «ИИ» выберите «Доработать карту…». Откроется окно, где кнопка скопирует промт вместе с проектом (целиком или одним листом с его соседями) и попросит модель вернуть только список правок. То, чего модель не трогала, остаётся как было, а всё, что она тронула, в том числе лишнее или ошибочное, предъявлено списком. Ответ при этом короче.
Ответ из чата вставляется как есть в то же окно — или, если оно уже закрыто, через «ИИ → Вставить ответ ИИ…»: текст вокруг JSON и кавычки ``` не мешают. Если модель всё же вернула проект целиком, PlyLoom сравнит его с текущим и покажет тот же список.
Каждый пункт — одна правка с понятным смыслом:
Отмеченное применяется одним шагом, неотмеченное отклоняется. Проверка идёт в два захода, и это два разных решения. «Применить» — решение по списку: эти правки стоит попробовать на карте. «Принять» — решение после того, как вы увидели их среди соседей: всё на месте, отметки можно снять. Если смотреть в контексте не нужно, «Принять все» нажимается сразу. Решить позже можно кнопкой «Отложить»: список ждёт в полосе внизу экрана и открывается снова с теми же отметками.
Применённое не становится окончательным сразу: оно остаётся отмеченным, как исправления в текстовом редакторе. Новые узлы обведены зелёным, изменённые — жёлтым. Они могут быть на любых листах: стрелки ‹ › в полосе внизу проходят по ним по очереди. У выбранного узла в панели свойств написано, что с ним сделали, и есть «Принять» и «Отклонить». Для всех сразу есть «Принять все» и «Отклонить все» в той же полосе; отклонение возвращает и удалённое, а ваши собственные правки после применения не трогает.
Тот же экран открывается из «Проект → Сравнить с файлом…» и из предпросмотра при открытии .plyloom — там появилась кнопка «Сравнить с текущим». Сравнение идёт по смыслу, а не по строкам: узлы, тексты, атрибуты, связи, листы и словари. Передвинутые карточки не засоряют список; если нужно, отметьте «Перенести и расположение».
Модели иногда перенумеровывают ID. Узел с другим ID, но тем же типом и названием, PlyLoom считает тем же узлом, а связь — той же связью по её концам и типу. Без этого любое переименование ID выглядело бы как «удалить всё и добавить заново».
При каждом «Скачать .plyloom» в файл записывается отпечаток версии (12 знаков, вычисленных из содержимого) и отпечатки версий, из которых он получился. Только отпечатки: история версий в файл не попадает, и удалённый из карты абзац не уедет вместе с ней к получателю. Исключение — непроверенные правки: пока вы их не приняли и не отклонили, файл хранит их и прежние значения затронутых мест, иначе отклонить потом было бы нечем. После «Принять все» или «Отклонить все» эти данные из файла уходят.
По отпечаткам PlyLoom понимает, что пришло: продолжение вашей версии, более старая копия или копия, которая менялась параллельно с вашей. Для последнего случая нужна общая версия. Её содержимое хранится только в вашем браузере — последние восемь открытых или скачанных версий. Если она есть, показываются только правки коллеги, а то, что вы меняли тоже, отмечено конфликтом. Если нет — различия смешивают обе стороны, и удаления не отмечены: это могут быть ваши новые узлы.
Кроме обычных тестов, сравнение проверено на случайных правках учебных карт: переименования, тексты, атрибуты, новые и удалённые узлы, связи, листы, порядок вкладок. Для каждого набора правок список, посчитанный PlyLoom, должен превращать одну карту в другую и обратно без остатка, а при слиянии конфликты должны появляться только там, где обе стороны трогали одно и то же. Эти проверки нашли и закрыли несколько тонких мест — например, сохранение основного листа узла и порядка вкладок.
Остальные изменения версии — на странице «Что нового».
Эта статья с обсуждением — на Хабре.
Скриншоты сняты с версии 0.10.0 на учебной карте «Разработка: экспорт отчёта»; правки в них придуманы для иллюстрации.
Карте отдано почти всё окно: верх сворачивается, карточки как в draw.io, паспарту в трёх состояниях, картинки в узлах и рассказ по шагам.
Карта, которая объясняет PlyLoom его же средствами, и двенадцать шагов её рассказа — так, как их видит читатель.
Две модели, один вопрос, две карты: что карта показывает сразу (дубли, открытые вопросы) и почему PlyLoom 0.14 спрашивает, откуда брать факты.
Карта — исходник, документ — сборка: записка, CSV или схема одной кнопкой, приватное, которое не попадёт в промт, и просмотр того, что уйдёт, до отправки.
Схему разложили по листам — и на краях листа связи обрываются. Как PlyLoom 0.9 показывает соседей: рамка, плашки, «Ещё» и раскладка, которая не прыгает.
Пересказ изменений легко читать и почти невозможно проверить. Карту, где каждое изменение привязано к номерам пунктов обеих редакций, можно проверить глазами.
На большом холсте сущности борются за место и соседство. Что астрономы сделали с небом и что из этого следует для схем.
Вкладки, таблицы и схемы ломаются в одном и том же месте. Идея из технической документации: один компонент — во многих местах.