Ссылки workai://

WorkAI регистрирует в системе схему workai://. Если клиент уже запущен, ссылка переключает на него; если нет — система запускает приложение и передаёт ему действие.

Промпт и правило в такой ссылке — это текст. Клиент его не исполняет: промпт только подставляет в поле ввода, правило записывает только после вашего подтверждения. Ссылки на плагин — другое: после согласия клиент ставит код с указанного источника.

Мессенджеры и почта часто не открывают workai:// напрямую. Для промпта и правила есть страница на сайте: она сама попытается открыть клиент, а если не выйдет — покажет кнопки «Открыть в WorkAI» и «Скачать клиент».

https://workai.su/link/prompt?text=<текст промпта>
https://workai.su/link/rule?name=<имя-файла>&text=<текст правила>

Параметры те же, что у workai://share/… ниже. Неизвестный тип (/link/что-то-ещё) не открывает приложение: страница напишет, что ссылка недействительна.

Поделиться промптом #

workai://share/prompt?text=<текст промпта>

Открывает чат и подставляет текст в поле ввода. На этом всё: отправка модели — отдельное ваше действие, кнопкой или Enter. Клиент никогда не отправляет промпт из ссылки сам.

Если в поле ввода уже есть черновик или прикреплённые файлы, ссылка их не затрёт — промпт откроется в новом чате.

Если ссылка попала в окно, где панели чата нет (пустое окно, окно агентов без чата), текст никуда не подставится и ошибки на экране не будет. Откройте обычное окно редактора и перейдите по ссылке ещё раз.

Текст нужно закодировать для URL (percent-encoding): & превращается в %26, + — в %2B, пробел — в %20. Пример:

workai://share/prompt?text=%D0%9E%D0%B1%D1%8A%D1%8F%D1%81%D0%BD%D0%B8%20%D1%8D%D1%82%D0%BE%D1%82%20%D1%84%D0%B0%D0%B9%D0%BB

Поделиться правилом #

workai://share/rule?name=<имя-файла>&text=<текст правила>

Предлагает сохранить правило для агента в файл .workai/rules/<имя-файла>.md в открытом проекте. Перед записью клиент показывает диалог подтверждения с полным текстом правила — целиком, без сокращений, потому что именно этот текст затем будет подмешиваться в запросы к модели. Ничего не создаётся, пока вы не нажмёте «Сохранить правило».

Требования:

• Должна быть открыта папка или воркспейс. Иначе сохранять некуда — клиент покажет ошибку и предложит сначала открыть проект. Правило записывается в первую папку воркспейса.
• name — только строчные латинские буквы, цифры и дефис, от 1 до 64 символов, без слешей и точек, первый и последний символ — не дефис (commit-lang, api-style). Имя используется как имя файла.
• Существующий файл не перезаписывается. Если правило с таким именем уже есть, сохранение не пройдёт, и клиент об этом сообщит.

После сохранения файл открывается в редакторе. Что такое правила, где они лежат и как активируются — см. Правила.

Ограничение по длине #

И промпт, и правило передаются целиком внутри ссылки, поэтому вся ссылка workai://share/… не должна быть длиннее 8000 символов. Более длинная просто игнорируется — диалога об ошибке не будет. Для больших правил надёжнее приложить сам markdown-файл. На проект Создателя и плагины этот лимит не распространяется.

Открыть проект Создателя в клиенте #

workai://open-builder-web-project?projectId=…&handoffToken=…&apiOrigin=…

Эту ссылку не составляют руками — её формирует пункт «Открыть в IDE» в меню проекта в веб-интерфейсе Создателя. Клиент проверяет параметры, спрашивает подтверждение и затем скачивает проект и открывает его как папку в новом окне.

Адрес сервера в ссылке сверяется со списком доверенных доменов WorkAI: подменить его на чужой в скопированной ссылке не получится — такая ссылка будет отклонена до всякого диалога. Про сам режим — Создатель.

Установить плагин или добавить маркетплейс #

workai://chat-plugin/install?source=<owner/repo>
workai://chat-plugin/add-marketplace?ref=<owner/repo>

Эти ссылки обычно присылает маркетплейс, а не составляют вручную как промпт. Первая предлагает установить плагин из указанного источника, вторая — добавить маркетплейс плагинов в каталог. source и ref принимаются и как обычный owner/repo или git-URL, и в base64. У первой ссылки можно дополнительно указать plugin=<имя> — тогда после установки откроется карточка именно этого плагина.

Оба маршрута всегда показывают диалог подтверждения с указанием источника: плагины выполняют код на вашей машине, поэтому устанавливайте их только из источников, которым доверяете.

Что происходит с ссылками, которые вы не открывали сами #

Часть ссылок workai:// клиент и браузер используют между собой служебно — например, чтобы вернуть фокус в приложение после входа в аккаунт. Их не нужно составлять или хранить: они одноразовые и появляются только в момент, когда вы сами инициировали действие.

Безопасность #

Ссылку workai:// может прислать кто угодно, поэтому каждое действие устроено так, чтобы одного перехода по ссылке было недостаточно:

• промпт только подставляется в поле ввода — отправляете его вы;
• правило записывается только после подтверждения, и в диалоге показан весь его текст;
• проект Создателя и плагин требуют явного подтверждения, и в диалоге показан источник; у проекта Создателя адрес сервера дополнительно сверяется со списком доверенных доменов;
• некорректные параметры (пустое имя, слишком длинный share-URL, чужой адрес сервера) клиент отбрасывает до диалога — на экране ничего не появится. Исключение: правило без открытой папки — тогда будет ошибка с просьбой открыть проект;
• промпт в окне без панели чата тоже проходит тихо: ссылка считается обработанной, поле ввода не меняется.

Общий принцип тот же, что и в режимах запуска агента: необратимое действие всегда требует вашего явного согласия. Тем не менее относитесь к присланной ссылке как к присланному файлу — читайте текст в диалоге подтверждения, прежде чем соглашаться.