osFoundry / Platform
Заметки — Диаграммы
Диаграммы Mermaid живут рядом с исходником. Редактируйте с одной стороны, смотрите рендер с другой.
Что это
Notes (Диаграммы) — это область создания Mermaid внутри Notes в osFoundry. Диаграмма Mermaid задаётся обычным текстом (блок-схемы, диаграммы последовательности, диаграммы классов, конечные автоматы, ER-диаграммы, диаграммы Ганта), и эта функция держит этот текст и его отрисованное изображение в одной и той же заметке. Вы правите исходник с одной стороны, а диаграмма отрисовывается с другой, так что определение и результат никогда не расходятся.
Поскольку диаграмма хранится в виде своего исходного кода, а не как экспортированная картинка, она остаётся частью текста заметки. Её можно сравнивать через diff, копировать, передавать агенту или вставлять в другую заметку, не теряя возможности редактирования. Ничто не сплющивается в скриншот, который пришлось бы перерисовывать ради любого изменения. Измените одну стрелку в коде — и отрисовка сразу это отразит; именно это делает работу над диаграммой быстрой, а не утомительной.
Всё это находится внутри osFoundry — десктопного рабочего пространства с собственным ключом (BYOK), где чат, агенты, приложения, код и знания живут в одном месте. Notes работает по принципу local-first, поэтому диаграмма, которую вы набрасываете (архитектура, процесс, модель данных), остаётся на вашем устройстве, пока вы не решите иначе. А так как osFoundry запускает любую модель, для которой вы приносите свой ключ, агент в рабочем пространстве может писать или править исходник Mermaid прямо в заметке, и вы видите, как он отрисовывается в тот же миг, когда текст появляется.
Ключевые возможности
- Пишите диаграммы Mermaid в заметке и смотрите на отрисовку бок о бок: исходник с одной стороны, изображение с другой
- Изменения в коде диаграммы перерисовывают изображение прямо по мере ввода, поэтому работа над потоком или последовательностью идёт мгновенно
- Диаграммы хранятся как их текстовый исходник, а не как впечатанные картинки, поэтому остаются редактируемыми, сравнимыми и копируемыми
- Поддерживаются типы, которые охватывает Mermaid: блок-схемы, последовательности, классы, состояния, ER и Гант
- Local-first Notes держит исходник ваших диаграмм на вашем устройстве; агенты, запускаемые с вашим собственным ключом, могут писать или править Mermaid напрямую
Сценарии использования
- Инженер: документирует поток запросов сервиса как диаграмму последовательности Mermaid в заметке и правит исходник по мере изменения дизайна
- Технический писатель: держит блок-схему архитектуры прямо в документе, который её объясняет, редактируя код вместо повторного экспорта картинки
- Тимлид: набрасывает график проекта как диаграмму Ганта и просит агента рабочего пространства обновить исходник Mermaid, когда сдвигаются даты
Часто задаваемые вопросы
Какие типы диаграмм Mermaid я могу отрисовывать?
Стандартный набор Mermaid: блок-схемы, диаграммы последовательности, диаграммы классов, диаграммы состояний, диаграммы «сущность-связь» и диаграммы Ганта. Вы пишете их в текстовом синтаксисе Mermaid, а заметка отрисовывает их в реальном времени.
Диаграмма сохраняется как изображение или как редактируемый текст?
Как текст. Исходник Mermaid живёт в заметке, а отрисовка генерируется из него. Это значит, что вы всегда можете вернуться и отредактировать определение, а не перерисовывать статичную картинку, и при копировании заметки исходник переходит вместе с ней.
Может ли ИИ-агент написать диаграмму за меня?
Да. osFoundry — это рабочее пространство с собственным ключом, поэтому агент, работающий на подключённой вами модели, может создавать или править исходник Mermaid внутри заметки. Поскольку диаграмма — это исходный текст, всё, что напишет агент, отрисуется точно так же, как ваши собственные правки.