690c1247e4
* feat(MCP): follow agent activity in canvas * feat(collab): show MCP, ACP, and harness sessions as agents MCP clients worked on the document unseen: only the built-in chat had a presence, and following agent activity meant a separate setting that moved the viewport after every MCP tool. Each MCP session now shows as an agent with a callsign in its owner's color, like the chat: the MCP server forwards the session and the client's name with each tool call, the app's own ACP and Pi harness chats mark their sessions with a header, and the agent points at the layers each call reads or changes on their page. It rests after a quiet spell, leaves when its session ends or the server disconnects, and collaborators see it through awareness. Following it works like following anyone else, from the avatars, so the default-on follow setting and its viewport fitting go. Co-authored-by: Victor Wads <victor@wads.dev> * feat(ai): move the chat's agent through JSX as it streams While the built-in chat streamed a render call, its preview grew on the canvas but the agent stood still until the tool finished. The preview now reports, after each update, the element that appeared last and the bounds of what the JSX builds; the agent's cursor follows that element and its outline traces the preview, for collaborators too, until the tool runs and the agent outlines the real layers. Peers' outlines are validated and capped like their selections. Co-authored-by: Victor Wads <victor@wads.dev> * feat(collab): glide cursors and the followed view instead of jumping People's and agents' cursors jumped to each new point, which with throttled awareness and an agent streaming JSX made them stutter, and following re-centered the view in one jump on every update. Cursors now ease to each new point from wherever they are drawn, and following pans and zooms the view there the same way, stopping in place when you take over. With animations off or reduced motion, both move at once. Each cursor carries an id so it keeps its glide between updates. Co-authored-by: Victor Wads <victor@wads.dev> * test(collab): cover MCP agents and the streaming agent in the browser Test runs send MCP requests through the bridge's own command handler, so a browser test can show an MCP session as an agent to the editor and to a collaborator without a separate server. The streaming JSX test checks that the chat's agent cursor and outline follow the newest element. Co-authored-by: Victor Wads <victor@wads.dev> * docs: describe agent sessions, streaming cursors, and gliding follow Co-authored-by: Victor Wads <victor@wads.dev> * fix(ai): keep the streaming agent's name off the text it writes The chat's agent sat at the newest streamed element's top-left corner, so its name label covered the text being written. It now sits at the element's trailing corner, where content grows. Co-authored-by: Victor Wads <victor@wads.dev> * fix(collab): end only a closed connection's own MCP sessions When the app's connection to the MCP server closed, every MCP session's agent left, including sessions that never came over that connection, such as a second editor's. The bridge now remembers the sessions each connection carried and ends only those. Co-authored-by: Victor Wads <victor@wads.dev> * feat(ai): follow your agents automatically while they work Agents spun up from the chat or an MCP client worked out of sight and then went idle, so people had to find what changed, and the agent skill told agents to move the user's view and selection after every edit. A Follow agents toggle in the AI panel's header, on by default, now has the view follow our agents from the start of each run: whichever starts first, then the next one at work once the followed agent rests. Leaving the page, moving the view, Escape, or Stop following leaves that agent alone until it rests; people are never followed this way. The skill no longer asks agents to select and zoom to their work. Co-authored-by: Victor Wads <victor@wads.dev> * fix(collab): keep an MCP agent when a restarted bridge carries its session Restarting MCP disconnects the old bridge and opens a new one at once, but the browser reports the old socket's close only after its close handshake. A tool call that reached the new connection in between was undone by that close, which ended the session and removed its agent. Sessions now record every connection their calls came over, across bridges, and end only when the last of them closes. The docs no longer say that following an agent keeps it from editing out of sight: following moves your view, and the stale variables and follow bullets the changelog's union merge brought back are removed. Co-authored-by: Victor Wads <victor@wads.dev> * test(collab): record what the bridge sends instead of an empty fake method Co-authored-by: Victor Wads <victor@wads.dev> --------- Co-authored-by: Danila Poyarkov <dev@dannote.net>
11 KiB
| title | description |
|---|---|
| Совместная работа | Одновременное редактирование напрямую между участниками через WebRTC, без отдельного сервера и учётной записи. |
Совместная работа
Несколько пользователей могут одновременно редактировать один документ. Участники соединяются напрямую, поэтому центральный сервер не передаёт данные, а создавать учётную запись не требуется.
Отправка ссылки
- Нажмите кнопку «Поделиться» в правом верхнем углу.
- Нажмите Поделиться файлом — ссылка
app.openpencil.dev/share/<room-id>будет скопирована. - Отправьте её другим участникам.
Документ попадает в комнату только через «Поделиться»: вкладка, из которой вы делитесь, становится вкладкой комнаты и остаётся связанной со своим файлом. Присоединиться может любой, у кого есть ссылка.
Вход в комнату
Откройте ссылку или вставьте её (или только идентификатор комнаты) в поле Войти на панели «Поделиться» либо в Войти в комнату… на начальном экране. Комната открывается в отдельной вкладке, поэтому уже открытые документы не меняются. На компьютере браузер также предлагает Открыть в настольном приложении — комната откроется в OpenPencil по ссылке openpencil://join.
Вы входите сразу под сгенерированным именем, например Teal Fox. Своё имя можно задать на панели «Поделиться» или в настройках; оно используется во всех комнатах.
Комнаты не хранятся на сервере: файл находится на устройствах тех, кто был в комнате, поэтому вкладка комнаты открывает документ, только пока кто-то из них в сети. До тех пор она сообщает, что ждёт, объясняет почему и открывает файл, как только войдёт тот, у кого он есть. Комната, в которой вы уже были, сразу открывается из копии на этом устройстве, а ваши изменения синхронизируются, когда вернутся остальные.
Покинуть комнату на панели «Поделиться» завершает ваше участие. Вкладка, которая поделилась своим документом, снова становится этим документом; вкладка, которая вошла в комнату, сохраняет файл комнаты как локальную несохранённую копию, которую можно сохранить. У каждой вкладки комнаты своё соединение, поэтому можно быть в нескольких комнатах одновременно.
Что синхронизируется
- Документ: фигуры, текст, свойства и компоновка обновляются после каждого изменения.
- Указатели: видны положение, имя и цвет каждого участника.
- Выделение: выбранные другими участниками объекты видны всем.
- Агенты: встроенный чат с ИИ, чаты ACP и Pi harness и каждый подключённый клиент MCP отображаются как указатели у слоёв, которые они читают или редактируют; на их контурной подписи есть значок-искорка и позывной, например Fern. Пока чат передаёт JSX потоком, его указатель проходит по элементам по мере их появления и обводит их. Указатель и контур имеют цвет того, кто запустил агента, так что видно, чей это агент. Передаются только имя, тип, модель, состояние, страница, положение и изменяемые слои — но не запросы и ответы.
Режим слежения
Щёлкните аватар участника на верхней панели, чтобы следовать за его областью просмотра. Положение и масштаб вашего холста будут повторять его вид, а рамка его цвета с панелью «Вы следуете за …» показывает, за кем вы следите. Чтобы остановить слежение, снова щёлкните аватар, нажмите Esc либо сами щёлкните по холсту, прокрутите его, измените масштаб или переключите страницу.
За вашими собственными агентами — чатом ИИ и MCP-клиентами вроде Claude Code или Cursor — вид следует автоматически, пока они работают, так что то, что они правят, остаётся на виду. Отключить это можно кнопкой с прицелом вверху панели ИИ. Если вы перестанете следовать за агентом во время работы, за ним не будут следовать до конца его работы, а при следующем запуске — снова.
На аватаре отображается число агентов, которых запустил этот участник. Наведите на него указатель, чтобы увидеть каждого агента, чем он занят и на какой странице, и нажмите Следовать рядом с агентом, чтобы страница и слои, которые он редактирует, оставались в поле зрения. Слежение продолжается между его ответами и прекращается, когда агент уходит. Кнопка после аватаров показывает всех участников комнаты с их агентами и доступна с клавиатуры. Ваш собственный аватар перечисляет ваших агентов — щёлкните по одному, чтобы переименовать, — и содержит пункт Покинуть комнату.
Панель «Поделиться» перечисляет всех участников комнаты с запущенными ими агентами, показывает, чем занят каждый агент и на какой странице. Следуйте за агентом так же, чтобы страница и слои, которые он редактирует, оставались в поле зрения; слежение продолжается между его ответами и прекращается, когда агент уходит. Дважды щёлкните своего агента, чтобы переименовать его.
Как это работает
Участники соединяются напрямую через WebRTC, поэтому данные документа передаются из одного браузера в другой без центрального сервера.
Состояние документа синхронизируется с помощью Yjs CRDT. Одновременные изменения автоматически объединяются.
Перемещение и изменение порядка слоёв тоже объединяются. Каждый слой помнит всех родителей, в которые его перемещали, и своё место среди соседних слоёв, и каждый участник выводит из этой истории одно и то же дерево слоёв (CRDT дерева Эвана Уоллеса). Перемещения, изменения порядка и новые слои от разных людей применяются все; если двое одновременно переместят один и тот же слой, у всех побеждает одно и то же перемещение. Если одновременные перемещения вложили бы два слоя друг в друга, более позднее отменяется, а слой, нового родителя которого тем временем удалили, возвращается на прежнее место.
Всем в комнате нужна версия OpenPencil, которая записывает дерево слоёв одинаково; версии, записывающие его по-разному, не видят комнат друг друга.
IndexedDB хранит локальное состояние: после перезагрузки страницы вы автоматически возвращаетесь в комнату с тем же состоянием.
Советы
- Совместная работа доступна в браузере и настольном приложении.
- Идентификаторы комнат создаются из криптографически стойких случайных значений. Присоединиться может только тот, кто знает ссылку.
- Указатели и сведения о присутствии отключившихся участников удаляются автоматически.