openpencil/packages/docs/ru/programmable/ai-chat.md
Danila Poyarkov c3412a44fc
docs: polish localized documentation
* docs: polish localized documentation

- Rewrite Russian documentation for natural terminology and current source parity\n- Continue the Polish editorial pass across guides and SDK references\n- Refresh shared localized SDK API data imports

* docs(pl): complete editorial pass

- Rewrite the remaining advanced Vue SDK references\n- Refresh the Figma compatibility matrix against the canonical source\n- Align terminology and behavior across every Polish documentation page

* docs(de): complete editorial pass

- Rewrite German guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix

* docs(es): complete editorial pass

- Rewrite Spanish guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix

* docs(fr): complete editorial pass

- Rewrite French guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix

* docs: correct localized terminology

- Replace unnecessary English prose with natural localized terminology\n- Derive documentation aliases from named directory roots\n- Preserve English only for identifiers, APIs, and exact product terms

* docs(it): continue editorial pass

- Rewrite Italian user guides and automation documentation\n- Update Vue SDK composables and component references\n- Restore current AI, export, component, and variable behavior

* docs(it): complete editorial pass

- Finish Italian advanced SDK and reference documentation\n- Refresh the Penpot comparison and Figma compatibility matrix\n- Replace literal machine translations with natural technical prose

* docs(pl): refine property panel terminology

* docs: refine remaining localized prose

- Replace overfitted English prose in Polish feature documentation\n- Rewrite the Russian property-list reference in natural terminology

* docs(ru): rewrite Penpot comparison naturally

- Replace remaining English prose with natural Russian\n- Preserve code identifiers and library names only where required

* docs: rewrite localized feature overviews naturally

- Replace avoidable English prose in German, Spanish, and French\n- Keep identifiers and product names unchanged

* docs(de): refine property panel terminology

* docs: refine Spanish and French SDK terminology

* docs(ru): continue full prose audit

- Rewrite homepage, setup, navigation, and guide index naturally\n- Restore missing zoom shortcuts

* docs(ru): audit user and automation guides

- Rewrite selection, collaboration, and automation prose naturally\n- Preserve API identifiers while localizing ordinary terminology

* docs(ru): audit CLI inspection and analysis

* docs(ru): audit Vue SDK overview and guides

* docs(ru): audit Vue SDK API prose

- Localize ordinary component and composable terminology\n- Preserve API symbols and code identifiers

* docs(ru): audit advanced and gradient API references

* docs(ru): finish advanced API prose audit

* docs(ru): audit JSX renderer guide

* docs(ru): audit CLI export and scripting guides

* docs(pl): audit Penpot comparison prose

* docs(pl): audit selection and automation guides

* docs(pl): audit homepage and variable guides

* docs(pl): audit vector, layers, and Pen guides

* docs(pl): audit Auto layout and shape guides

* docs(pl): audit context menu and export guides

* docs(pl): audit JSX and analysis guides

* docs(pl): audit AI Chat guide

* docs(pl): audit components and CLI inspection

* docs(pl): audit scripting and SDK overview prose

* docs(pl): audit SDK API indexes

* docs(pl): audit SDK component references

* docs(pl): audit SDK composable references

* docs(ru): refine usePosition terminology

* docs(pl): audit advanced SDK references

* docs(pl): audit Figma compatibility matrix

* docs(pl): finish residual SDK terminology audit

* docs(pl): finish component terminology audit

* docs(pl): finish SDK guide terminology audit

* docs(de): begin full user guide prose audit

* docs(de): audit navigation, Pen, and layers guides

* docs(de): audit Auto Layout, shapes, menu, and export

* docs(de): audit components, text, and vector guides

* docs(de): audit variables and automation overview

* docs(de): audit AI Chat and collaboration guides

* docs(de): audit CLI inspection, analysis, and export

* docs(de): audit scripting and JSX guides

* docs(de): audit Vue SDK overview and guides

* docs(de): audit SDK API indexes

* docs(de): audit SDK component references

* docs(de): audit SDK composable references

* docs(de): audit advanced SDK references

* docs(de): audit Penpot comparison prose

* docs(de): audit Figma compatibility reference

* docs(es): begin full user guide prose audit

* docs(es): audit document organization guides

* docs(es): audit editing workflow guides

* docs(es): audit automation and collaboration prose

* docs(es): audit CLI inspection and export guides

* docs(es): audit CLI scripting guide

* docs(es): audit JSX and feature overview prose

* docs(es): audit Penpot comparison prose

* docs(es): audit SDK overview and guides

* docs(es): begin SDK component reference audit

* docs(es): audit SDK navigation component references

* docs(es): audit SDK color and layout components

* docs(es): begin SDK composable reference audit

* docs(es): audit SDK property composable references

* docs(es): audit SDK editor composable references

* docs(es): begin advanced SDK reference audit

* docs(es): audit advanced SDK state references

* docs(es): complete advanced SDK reference audit

* docs(es): audit Figma compatibility reference

* docs(es): complete residual terminology sweep

* docs(fr): begin full prose second audit

* docs(fr): audit AI and variables prose

* docs(fr): audit core user guide prose

* docs(fr): audit editing workflow guides

* docs(fr): audit CLI and JSX prose

* docs(fr): audit Penpot comparison prose

* docs(fr): audit SDK overview and guides

* docs(fr): begin SDK API reference audit

* docs(fr): audit SDK navigation component references

* docs(fr): audit SDK color and layout components

* docs(fr): begin SDK composable reference audit

* docs(fr): audit SDK property composable references

* docs(fr): audit editor composables and advanced APIs

* docs(fr): audit advanced SDK state references

* docs(fr): complete advanced SDK reference audit

* docs(fr): audit Figma compatibility reference

* docs(fr): complete residual terminology sweep

* docs(it): begin full prose second audit

* docs(it): audit document workflow guides

* docs(it): audit editing and automation prose

* docs(it): audit CLI and JSX prose

* docs(it): audit Penpot comparison and SDK guides

* docs(it): begin SDK API reference audit

* docs(it): audit SDK component and state references

* docs(it): audit residual SDK references

* docs(it): audit Figma compatibility reference

* docs(it): complete residual terminology sweep

* docs(i18n): verify residual locale terminology
2026-08-20 18:36:50 +03:00

7.9 KiB
Raw Blame History

title description
Чат с ИИ Встроенный помощник с более чем 90 инструментами для создания и изменения дизайна.

Чат с ИИ

Нажмите ⌘J или Ctrl + J. Помощник умеет создавать фигуры, менять стили и компоновку, работать с компонентами и анализировать документ.

Настройка

  1. Откройте панель чата.
  2. Нажмите значок настроек.
  3. Добавьте модель и настройте поставщика, идентификатор модели, учётные данные и возможности.
  4. Сохраните модель и назначьте её для роли Design agent.

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

Поставщики

Поставщик Модели Настройка
OpenRouter Claude, GPT, Gemini, DeepSeek, Qwen и другие Ключ API с openrouter.ai
Anthropic Claude Sonnet 4.6, Claude Opus 4.6 Ключ API с console.anthropic.com
OpenAI GPT-5.3 Codex, GPT-4.1, o3, o4-mini Ключ API с platform.openai.com
Google AI Gemini 3.1 Pro, Gemini 3 Flash Ключ API с aistudio.google.dev
Z.ai GLM-5.1, GLM-5, GLM-4.7 и семейство GLM-4.5 Ключ API из документации Z.ai
MiniMax MiniMax M3, M2.7, M2.7-highspeed, M2.5, M2.1 Ключ API с platform.minimax.io
Совместимый с OpenAI Любая конечная точка в формате OpenAI API Собственные базовый URL и ключ; можно выбрать Completions API или Responses API
Совместимый с Anthropic Любая конечная точка в формате Anthropic API Собственные базовый URL и ключ

Отдельный сервер и подписка OpenPencil не требуются: запросы отправляются поставщику напрямую с вашим ключом. В браузере действуют правила CORS поставщика. Разные развёртывания моделей также по-разному поддерживают потоковые вызовы инструментов. Результаты проверок и инструкции находятся в разделе Совместимость поставщиков и моделей BYOK.

Внешние подключения MCP

В настольной версии агенты ACP могут использовать доверенные удалённые серверы Model Context Protocol. Откройте Настройки → Подключения MCP, добавьте именованную конечную точку Streamable HTTP, при необходимости сохраните токен Bearer и включите подключение.

Токен хранится в настроенном хранилище учётных данных, а не в обычных настройках, и загружается только при запуске сеанса ACP.

Удалённый сервер должен работать через HTTPS. Для локальной разработки разрешены адреса обратной петли через HTTP. Включайте только сервер, которому доверяете: его инструменты могут читать внешние данные и выполнять действия с переданными учётными данными. Встроенный сервер MCP для дизайна подключается автоматически.

Возможности

Помощник использует более 90 инструментов:

  • Создание: фреймы, фигуры, текст, компоненты и страницы; JSX для сложных макетов.
  • Стиль: заливки, обводки, эффекты, прозрачность, радиусы углов и режимы наложения.
  • Компоновка: автоматическая компоновка, сетка, выравнивание, интервалы и размеры.
  • Компоненты: создание компонентов, экземпляров и наборов, управление переопределениями.
  • Переменные: создание и изменение переменных, коллекций и режимов, привязка к заливкам.
  • Запросы: поиск объектов, селекторы XPath, чтение свойств, получение списка страниц, шрифтов и выделения.
  • Проверка: get_jsx, diff_jsx и describe для анализа структуры, роли объекта и возможных проблем дизайна.
  • Анализ: палитра, типографика, интервалы и повторяющиеся группы.
  • Экспорт: PNG, SVG и JSX с классами Tailwind; визуальная проверка через export_image.
  • Векторы: логические операции и изменение контуров.

Визуальная проверка

После создания или изменения дизайна помощник может вызвать export_image, получить снимок результата и сопоставить его с исходным запросом. Так обнаруживаются проблемы компоновки, отсутствующие элементы и неверные цвета.

Примеры запросов

  • «Создай карточку с заголовком, описанием и синей кнопкой».
  • «Сделай одинаковый радиус углов у всех кнопок на этой странице».
  • «Какие шрифты используются в этом файле?»
  • «Замени фон выделенного фрейма на градиент от синего к фиолетовому».
  • «Экспортируй выделенный фрейм в SVG».
  • «Найди все текстовые объекты с размером шрифта меньше 12».
  • «Опиши роль выделенного компонента».
  • «Покажи JSX этого фрейма».

Советы

  • Перед запросом выделите нужные объекты: помощник видит выделение.
  • Точно указывайте цвета, размеры и положение.
  • В одном сообщении можно изменить несколько объектов.
  • Если результат не подходит, используйте отмену.
  • После каждого вызова инструмента компоновка пересчитывается автоматически.