• Русский

      • Быстрый старт по разработке плагинов с помощью AI

      Плагин AI-разработки — это возможность NocoBase для разработки плагинов с помощью AI. Вы можете описать требования на естественном языке, а AI автоматически сгенерирует полноценный frontend- и backend-код, включая таблицы данных, API, frontend-блоки, права доступа и интернационализацию. Это обеспечивает более современный и эффективный опыт разработки плагинов.

      Возможности AI-разработки плагинов реализованы на основе Skill nocobase-plugin-development. Если Вы уже инициализировали систему через NocoBase CLI (nb init), этот Skill будет установлен автоматически.

      Быстрый старт

      Если Вы уже установили NocoBase CLI, этот шаг можно пропустить.

      Установка одной командой через AI

      Скопируйте приведённый ниже промпт Вашему AI-ассистенту (Claude Code, Codex, Cursor, Trae и т.п.), и установка с настройкой будут выполнены автоматически:

      Помогите мне установить NocoBase CLI и выполнить инициализацию: https://docs.nocobase.com/cn/ai/ai-quick-start.md (пожалуйста, перейдите по ссылке и используйте её содержимое напрямую)

      Ручная установка

      npm install -g @nocobase/cli@beta
nb init --ui

      Браузер автоматически откроет визуальную страницу настройки, которая поможет Вам установить NocoBase Skills, настроить базу данных и запустить приложение. Подробные шаги см. в разделе Быстрый старт.

      Внимание
      • NocoBase сейчас переходит с client (v1) на client-v2, и client-v2 пока находится в разработке. Клиентский код, сгенерированный AI-разработкой, основан на client-v2 и работает только по пути /v/. Это для предварительного ознакомления, не рекомендуется использовать в продакшене.
      • Сгенерированный AI код не всегда корректен на 100%, рекомендуется делать review перед включением. Если в процессе работы возникают ошибки, отправьте сообщение об ошибке AI, чтобы он продолжил диагностику и исправление — обычно проблема решается за несколько итераций диалога.
      • Для разработки рекомендуется использовать большие модели серии GPT или Claude — они дают наилучшие результаты. Другие модели также можно использовать, однако качество генерации может отличаться.

      От одной фразы до полноценного плагина

      После установки Вы можете на естественном языке прямо сказать AI, какой плагин хотите разработать. Ниже несколько реальных сценариев, чтобы Вы могли почувствовать возможности AI-разработки плагинов.

      Разработка плагина водяного знака одной фразой

      Один промпт — и AI поможет Вам сгенерировать полноценный плагин водяного знака, включая логику отрисовки на frontend, защиту от изменений, backend API для сохранения настроек и страницу настроек плагина.

      Помогите мне с помощью skill nocobase-plugin-development разработать плагин водяного знака для NocoBase.
Требования: накладывать на страницу полупрозрачный водяной знак с именем текущего пользователя, чтобы предотвратить утечку через скриншоты.
Периодически проверять, не удалён ли DOM водяного знака; если удалён — пересоздавать его.
На странице настроек плагина поддерживать настройку текста, прозрачности и размера шрифта водяного знака.
Имя плагина: @my-project/plugin-watermark

      В течение всего процесса Вам нужно только описывать требования и принимать решения, остальное AI делает автоматически. Хотите увидеть полный процесс? → Практика: разработка плагина водяного знака

      Создание собственного компонента поля одной фразой

      Хотите, чтобы поле integer отображалось как звёздный рейтинг? Расскажите AI, какой эффект Вам нужен, и он сгенерирует пользовательский FieldModel, заменяющий стандартный компонент отрисовки поля.

      Помогите мне с помощью skill nocobase-plugin-development разработать плагин для NocoBase, имя плагина: @my-scope/plugin-rating.
Сделайте пользовательский компонент отображения поля (FieldModel), который превращает поле типа integer в иконки звёзд.
Поддержка от 1 до 5 баллов, при клике по звезде значение рейтинга должно изменяться и сразу сохраняться в базу данных.

      Демонстрация компонента Rating

      Чтобы узнать больше о возможностях, см. Поддерживаемые возможности.

      Что AI может для Вас сделать

      Я хочу...AI поможет Вам
      Создать новый плагинСгенерировать полный scaffold, включая структуру каталогов front/back
      Определить таблицу данныхСгенерировать определение Collection с любыми типами полей и связями
      Сделать собственный блокСгенерировать BlockModel + панель настроек + регистрация в меню «Добавить блок»
      Сделать собственное полеСгенерировать FieldModel + привязку к интерфейсу поля
      Добавить собственную кнопку действияСгенерировать ActionModel + popup/drawer/диалог подтверждения
      Сделать страницу настроек плагинаСгенерировать frontend-форму + backend API + хранение
      Написать собственный APIСгенерировать Resource Action + регистрацию роутов + ACL
      Настроить права доступаСгенерировать правила ACL, контроль доступа по ролям
      Поддержка нескольких языковАвтоматически сгенерировать языковые пакеты на китайском и английском
      Написать миграциюСгенерировать Migration с поддержкой DDL и миграции данных

      Подробное описание каждой возможности и примеры промптов → Поддерживаемые возможности

      Связанные ссылки