Plyloom новая версия (0.14). Работа над удобствами и мысли про OKF (Open Knowledge Format)

В статье речь пойдет немножко про OKF (Open Knowledge Format) и мои мысли про позиционирование инструмента Plyloom.net относительно него, а также представление новой версии Plyloom. В обновлении была проведена работа по переработке функционала который больше всего влияет на удобства. Также сильно переработан режим “Стопка”, раньше он был скорее заглушкой, чем чем-то полезным, теперь же он кажется стал лучше. Также мне очень хотелось добавить возможность добавления к узлам мини-картинок.

Open Knowledge Format

Open Knowledge Format (OKF) — это открытый стандарт для представления знаний: метаданных, контекста и курированной информации, которая окружает данные и системы. Его цель - создать универсальный формат, который могут использовать люди и AI-агенты, также удобный экспорт и обеспечить переносимость знаний между системами и организациями.

Как же он устроен? Это директория Markdown-файлов с YAML. Такой подход решает сразу несколько задач:

• Читаемость для человека. Markdown легко читается в любом редакторе, а GitHub нативно отображает такие файлы.

• Переносимость. Данные можно упаковать в архив, разместить в любом Git-репозитории или смонтировать в файловую систему.

• Структурированный поиск. Минимальный набор полей в YAML (type, title, description, resource, tags, timestamp) позволяет агентам эффективно искать и запрашивать информацию.

То есть задумка то правильная по своей сути. Улучшить жизнь агентам, для человека читать md тоже в целом удобно, ну а github для тех кто умеет в нем работать - отличная возможность прослеживать изменяемость. Остается только ряд проблем:

• Открытых MD файлов может быть столь же много, сколько открытых отдельных документов или вкладок браузера

• Все эти наборы открытых документов связаны между собой только мозгом человека - перегруженный мозг не может держать много информации. Также никуда не уходит проблема со скроллингом этих самых MD файлов внутри.

• С гитом не все умеют работать.

• С точки зрения визуализации для человека - предлагают что-то монстроузное типа куча точек на одном листе, в частности тот же obsidian. С точки зрения Вау-эффекта выглядит круто, а с точки зрения полезности как будто бы не очень.

Место Plyloom в быстроменяющемся современном мире

Начиная сборку протипа своей идеи - что мне хочется просто несколько листов вместо одного и я был не согласен с тем, чтобы выносить то что не помещается на другой лист. В процессе работы над ним я все больше прихожу к мысли, что мир сильно меняется и условно все также есть инструменты и нотации прошлого и настоящего, есть необходимость их отдавать в ИИ и LLM в виде разных файлов и надеяться на то, что он правильно понял все взаимосвязи. На другой чаше весов - есть множество агентов со своими правилами взаимодействия, понимания и того что конкретного происходит под капотом, что скрыто зачастую от глаз пользователя. Просто хочется верить что все будет работать и работать правильно. Plyloom это концепт-протип проверки этой и других теорий. Основная мысль что есть узлы с атрибутами, картинкой, основным текстом и названием. Есть листы содержащие эти узлы, и есть возможность прозводить связывание узлом как внутри одного листа, так и между листами. А также есть много различных гипотез удобного доступа и просмотра к эитм данным с точки зрения человека, при этом есть возможность посмотреть на эти структуры знаний совместно с ИИ - одинаково ли мы понимаем друг друга?

Изменения. Что же нового в Plyloom версии 0.14

В предыдущей версии 0.13.1 на ноутбуке с экраном 1366×768 под саму карту оставалась треть окна — остальное занимали панели, меню и кнопки. В новой версии карте отдано почти всё окно, карточки ведут себя как в draw.io, в узлах появились картинки, а карту можно показать по шагам. Рассказываю, что изменилось и зачем.

Зачем

Карта знаний в PlyLoom - это прежде всего листы, а лист нужно видеть целиком, вместе с соседями. В 0.13 на экране 1366×768 под холст уходило 34 % окна: сверху три строки меню, кнопок и вкладок, снизу своя панель, а слева и справа панели узлов и свойств. Даже со свёрнутыми панелями холст получал 56 %.

Было: 0.13.1, пример «Разработка», экран 1366×768.

Стало: 0.14, тот же пример и тот же экран. Панели на месте, а холст доходит до низа окна.

Я замерил, сколько окна достаётся холсту, на четырёх экранах и в трёх состояниях: панели открыты, панели свёрнуты, свёрнуты и панели, и верх.

Верхняя область, которая стала более удобной

Сверху теперь две строки: в первом меню («Проект», «ИИ», «Словари», «Настройки», «Фильтр», «Рассказ», «Справка»), отмена и название карты, во второй - режимы и их настройки. Кнопка ⌃ справа (или Ctrl+.) сворачивает обе строки, и над картой остаётся только полоса листа: ← n/N →, вкладки листов, ＋, счётчики и состояние сохранения. Режим тогда выбирается прямо в ней.

Нижней панели больше нет. Масштаб, «Вписать», «Оптимизировать», «Развернуть все» и «?» с горячими клавишами - стали полупрозрачными кнопками в правом нижнем углу холста. Панели «Узлы» и «Свойства» есть во всех режимах и сворачиваются в узкие полоски.

Верх и панели свёрнуты: карте достаётся почти 90 % окна.

Взаимодействие с узлами в стиле привычных инструментов

Чтобы переименовать узел, достаточно выделить карточку и начать печатать, это заменит название. Нажатие Enter или F2 - исправит название. Esc для того чтобы вернуть прежнее, а двойной щелчок выделяет название целиком.

Свёрнутая карточка показывает только название. Стрелка ↘ в её правом нижнем углу разворачивает карточку, а ↖ сворачивает обратно. В развёрнутой карточке можно изменить название, ниже добавить, заменить или удалить картинку, еще ниже основной текст и атрибуты. Каждый раздел узла можно свернуть. Всё можно изменить прямо в карточке - отдельной кнопки “редактировать” больше нет. При помощи «Развернуть все ▾» в нижей правой части экрана можно раскрыть все карточки на экране в нескольких режимах: только картинки, только текст, только атрибуты или показать всё.

Текст правится в самой карточке, поле скролится вместе с текстом.

Рамку паспарту теперь можно свернуть

Вокруг листа PlyLoom показывает узлы соседних листов, с которыми он связан. Раньше это называлось рамкой и всегда занимало место. Теперь у неё одно название “паспарту” и два режима. По умолчанию паспарту свёрнуто в тонкие полоски по краям холста: по цветному отрезку на каждый соседний лист, на той стороне, где этот лист показала бы развёрнутая рамка. Щелчок по отрезку показывает карточки этого листа. «Паспарту ▾» стоит на выступе в углу самого паспарту и переключает режимы, а также какие листы показывать. Линии к соседним листам тонкие и бледные, все одним пунктиром и всегда входят в карточку со стороны листа; наведение на карточку позволяет увидеть её линии вместе с названиями связей.

Свёрнутое паспарту: щелчок по отрезку показывает карточки соседнего листа.

Изменения в режимах: Все листы, оглавление и развороты

«Все листы» теперь имею свою отдельную кнопку между листом и разворотами.

«Оглавление» стало двухрежимным. Схему листов можно расставлять руками, места сохраняются в файле. Между двумя связанными листами - одна тихая линия с карточкой чисел «→ 11 · ← 3 · ◆ 2»: связи в одну и в другую сторону и общие узлы; наведите на карточку - подсветятся оба листа. «Схема · Список» и «Оптимизировать» - прямо над схемой. Список показывает листы с их карточками и пары листов по силе связи: у каждой пары раскрывается «мостик» - общие узлы сверху, затронутые узлы обоих листов по сторонам и линия на каждую связь.

Мостик между двумя листами: общие узлы золотом, связи - линиями.

Новый режим «Архитектура» показывает листы блоками в духе C4: название, тип листа, описание и число узлов. Внутрь блоков можно поставить узлы выбранных типов, блоки - расставить и выгрузить картинкой.

«Архитектура»: листы блоками.

Стопка для слайдов

«Стопка» показывает листы плитами друг над другом - так видно, как одна сущность проходит сквозь несколько листов. Карточки лежат на плитах там же, где стоят на листе, название листа написано на передней грани. Линии между плитами идут как в многослойной плате: по плите к краю и там переходит к той же точке на другой плите. Карточки лежат с просветами и не налезают друг на друга: тесная плита растёт. В одной стопке до пяти плит; больше листов - несколько стопок рядом, а «Листы и стопки ▾» выбирает, какие листы лежат в стопках и сколько стопок нужно. «Картинкой ↓» сохраняет стопку в SVG для статьи или PNG для слайда.

Стопка: карточки лежат на плитах, золотые линии переходят с плиты на плиту.

Картинки в узлах

В узел теперь можно добавлять картинки. Картинка сразу автоматически сжимается до маленького размера. Метаданные вроде координат съёмки удаляются. Каждая картинка хранится один раз, сколько бы раз карта ни попадала в историю версий. На свёрнутой карточке видна маленькая картинка, а в развёрнутой - крупнее.

Картинки выгружаются в Word, PDF, HTML и draw.io. В промт для ИИ уходит только подпись картинки. Карта plyloom с картинками сохраняется в формате новой версии 4, и открыть её сможет только PlyLoom 0.14 или новее. Карты без картинок остаются в прежнем формате и открываются в 0.13.

Карточки с картинками, «Развернуть все → Картинки».

Рассказ по шагам и режим чтения

Карту часто надо кому-то объяснить. «Рассказ → Добавить шаг» запоминает вид - режим, листы, масштаб, фильтр, выделенную и развёрнутые карточки; к шагу можно дописать заголовок и пару строк. «Рассказ → Смотреть» показывает шаги по очереди, камера плавно переезжает от шага к шагу, стрелки и пробел листают.

Кнопка «Чтение» убирает всё, что меняет карту: палитру, свойства, перетаскивание. Щелчок по карточке разворачивает её, щелчок по связи ведёт к соседу, «← Назад» возвращает. Так карту можно отдать читателю, не боясь, что что-то сдвинется. Как это выглядит, показывает пример «PlyLoom о себе» (https://plyloom.net/ru/articles/plyloom-story/) идёт по его двенадцати шагам.

Рассказ: шаг 3 из 12, внизу - заголовок, текст и стрелки.

ИИ: два понятных сценария

Меню «ИИ» теперь начинается с вопроса, что вы хотите сделать. «Новая карта…» - карта из ваших материалов, и рядом выбор, откуда модели брать факты: только из материалов, черновик из общих знаний с пометкой «непроверено» или смешанно. Или «Доработать эту карту…» - ответ приходит списком правок, каждую можно принять или отклонить. Прежний «Документ по карте» стал задачами доработки: текст письма или записки приходит новым узлом со связями к источникам, а «Проект → Собрать документ» делает из него Word или PDF.

Как и раньше, PlyLoom сам к ИИ не обращается: промт уходит через буфер обмена в любой чат, ответ возвращается в то же окно, а приватные листы, узлы и атрибуты в промт не попадают.

«Новая карта»: задача, откуда факты, промт и ответ - в одном окне.

Снимок

Среди кнопок холста появилась кнопка «Снимок ▾»: «Скопировать картинку» снимает то, что сейчас на холсте и кладет в буфер обмена, а «Скачать PNG» сохраняет ее файлом. Кнопки холста на снимок не попадают.

Изменение терминологии

«Типы» стали «Словарями» - теперь с подсказками под каждой вкладкой и что в ней настраивается. «Настройки» теперь разбиты на четыре понятных раздела: карточки, паспарту, экран и счётчики. Руководство и «С чего начать» переписаны под новый экран, а «Справка → Руководство картой» открывает руководство в виде карты plyloom.

Как попробовать

Откройте демо с примером «Разработка» или рассказ «PlyLoom о себе». Если вы пользуетесь скачанным файлом, скачайте новый PlyLoom.html: ваши карты в браузере и файлы .plyloom откроются в нём как есть. Полный список изменений - на странице «Что нового».

PlyLoom это бесплатный инструмент, который работает в браузере, в виде одного единого файла без интернета: plyloom.net.

Если Вам интересен Plyloom, вы заметили ошибки или есть мысли на тему какой функционал Вам понравился или какого не хватает - просьба писать тут или в ТГ: Plyloom