#Kemampuan yang Didukung

Kemampuan Pengembangan Plugin AI berbasis pada Skill nocobase-plugin-development. Jika Anda sudah menginisialisasi melalui NocoBase CLI (nb init), Skill ini akan otomatis terinstal.

Berikut tercantum semua hal yang dapat dilakukan AI saat ini untuk Anda. Setiap kemampuan dilengkapi contoh prompt, Anda dapat langsung menyalin, mengubah deskripsi kebutuhan, dan menggunakannya.

#Praktik Terbaik

• Beri tahu AI dengan jelas untuk membuat atau memodifikasi Plugin NocoBase, dan berikan nama Plugin — misalnya "Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-rating". Tanpa memberikan nama Plugin, AI mungkin tidak tahu di mana harus menghasilkan kode.
• Tentukan dengan jelas penggunaan nocobase-plugin-development skill di prompt — misalnya "Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase…". Dengan ini AI Agent dapat langsung membaca kemampuan Skills, menghindari masuk ke mode plan dan mengabaikan Skills.
• Jalankan AI Agent di direktori root repository kode sumber NocoBase — dengan ini AI dapat secara otomatis menemukan struktur proyek, dependensi, dan Plugin yang sudah ada. Jika Anda tidak berada di direktori root kode sumber, perlu memberi tahu AI Agent path repository kode sumber.

#Indeks Cepat

#Scaffold Plugin

AI dapat menghasilkan struktur direktori Plugin NocoBase yang lengkap berdasarkan deskripsi kebutuhan Anda — termasuk file entry frontend dan backend, definisi tipe, dan konfigurasi dasar.

Contoh prompt:

Bantu saya membuat Plugin NocoBase, nama Plugin @my-scope/plugin-todo

AI akan menjalankan yarn pm create @my-scope/plugin-todo dan menghasilkan direktori standar:

packages/plugins/@my-scope/plugin-todo/
├── src/
│   ├── server/
│   │   └── plugin.ts
│   ├── client-v2/
│   │   └── plugin.tsx
│   └── locale/
│       ├── zh-CN.json
│       └── en-US.json
├── package.json
└── ...

#Definisi Tabel Data

AI mendukung pembuatan definisi Collection untuk semua tipe Field NocoBase, termasuk relasi (one-to-many, many-to-many, dll).

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-order,
kemudian definisikan tabel "order" di dalamnya, Field termasuk: nomor order (auto increment), nama pelanggan (string),
jumlah (decimal), status (single select: pending/processing/completed), waktu pembuatan.
Order dan pelanggan adalah relasi many-to-one.

AI akan menghasilkan definisi defineCollection, berisi tipe Field, nilai default, konfigurasi relasi, dll.

#Block Kustom

Block adalah cara ekstensi paling inti dari frontend NocoBase. AI dapat membantu Anda menghasilkan model Block, panel konfigurasi, dan register menu.

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-simple-block,
buat satu Block tampilan kustom (BlockModel), Pengguna dapat memasukkan konten HTML di panel konfigurasi,
Block merender HTML ini. Daftarkan Block ini ke menu "Tambah Block".

AI akan menghasilkan BlockModel, membuat panel konfigurasi melalui registerFlow + uiSchema, dan mendaftarkannya ke menu "Tambah Block".

Untuk contoh lengkap rujuk Membuat Block Tampilan Kustom.

#Komponen Field Kustom

Jika komponen rendering Field bawaan NocoBase tidak memenuhi kebutuhan, AI dapat membantu Anda membuat komponen tampilan kustom, mengganti cara rendering Field default.

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-rating,
buat satu komponen tampilan Field kustom (FieldModel), render Field tipe integer sebagai ikon bintang,
mendukung skor 1-5, klik bintang dapat langsung memodifikasi nilai rating dan menyimpannya ke database.

AI akan menghasilkan FieldModel kustom, mengganti komponen rendering default Field integer.

#Action Kustom

Tombol Action dapat muncul di bagian atas Block (level collection), kolom action setiap baris tabel (level record), atau muncul di kedua posisi sekaligus. Setelah diklik dapat memunculkan tooltip, membuka popup formulir, memanggil API, dan lainnya.

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-simple-action,
buat tiga tombol Action kustom (ActionModel):
1. Satu tombol level collection, muncul di bagian atas Block, klik akan menampilkan tooltip sukses
2. Satu tombol level record, muncul di kolom action setiap baris tabel, klik akan menampilkan ID record saat ini
3. Satu tombol level both, muncul di kedua posisi sekaligus, klik akan menampilkan tooltip informasi

AI akan menghasilkan ActionModel, mengontrol posisi munculnya tombol melalui ActionSceneEnum, menangani event klik melalui registerFlow({ on: 'click' }).

Untuk contoh lengkap rujuk Membuat Tombol Action Kustom.

#Halaman Setting Plugin

Banyak Plugin memerlukan halaman setting untuk Pengguna mengonfigurasi parameter — misalnya API Key layanan pihak ketiga, alamat Webhook, dll.

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-settings-page,
buat satu halaman setting Plugin, daftarkan entry "Konfigurasi Layanan Eksternal" di bawah menu "Konfigurasi Plugin", berisi dua Tab:
1. Tab "Konfigurasi API": formulir berisi API Key (string, wajib), API Secret (password, wajib), Endpoint (string, opsional), simpan ke database melalui API backend
2. Tab "Tentang": menampilkan nama Plugin dan informasi versi
Frontend menggunakan komponen formulir Ant Design, backend mendefinisikan dua antarmuka externalApi:get dan externalApi:set.

AI akan menghasilkan komponen halaman setting frontend, Resource Action backend, definisi tabel data, dan konfigurasi ACL.

Untuk contoh lengkap rujuk Membuat Halaman Setting Plugin.

#API Kustom

Jika antarmuka CRUD bawaan tidak cukup, AI dapat membantu Anda menulis REST API kustom. Berikut adalah contoh lengkap interaksi frontend dan backend — backend mendefinisikan tabel data dan API, frontend membuat Block kustom untuk menampilkan data.

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-todo,
buat Plugin manajemen data Todo dengan interaksi frontend dan backend:
1. Backend mendefinisikan tabel todoItems, Field termasuk title (string), completed (boolean), priority (string, default medium)
2. Frontend membuat TableBlock kustom, hanya menampilkan data todoItems
3. Field priority ditampilkan dengan Tag berwarna (high merah, medium oranye, low hijau)
4. Tambahkan tombol "Buat Todo Baru", klik akan memunculkan formulir untuk membuat record
5. Pengguna yang sudah login dapat melakukan semua operasi CRUD

AI akan menghasilkan definisi Collection sisi server, Resource Action, konfigurasi ACL, serta TableBlockModel, FieldModel, dan ActionModel kustom sisi klien.

Untuk contoh lengkap rujuk Membuat Plugin Manajemen Data dengan Interaksi Frontend dan Backend.

#Konfigurasi Permission

AI akan secara otomatis mengonfigurasi aturan ACL yang masuk akal untuk API dan resource yang dihasilkan. Anda juga dapat secara eksplisit menentukan kebutuhan Permission di prompt:

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-todo,
definisikan satu tabel data todoItems (Field title, completed, priority),
persyaratan Permission: Pengguna login dapat melihat, membuat, dan mengedit, hanya role admin yang dapat menghapus.

AI akan mengonfigurasi aturan akses yang sesuai melalui this.app.acl.allow() di sisi server.

#Internasionalisasi

AI secara default akan menghasilkan dua paket bahasa Mandarin dan Inggris (zh-CN.json dan en-US.json), Anda tidak perlu menyebutkannya secara terpisah.

Jika ada kebutuhan bahasa lain:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya mengembangkan Plugin NocoBase, namanya @my-scope/plugin-order,
perlu mendukung tiga paket bahasa: Mandarin, Inggris, dan Jepang

#Script Upgrade

Saat Plugin perlu memperbarui struktur database atau memigrasi data, AI dapat membantu Anda menghasilkan script Migration.

Contoh prompt:

Tolong gunakan nocobase-plugin-development skill untuk membantu saya menulis script upgrade untuk Plugin NocoBase @my-scope/plugin-order,
tambahkan Field "catatan" (long text, opsional) ke tabel "order", dan isi default Field catatan untuk order yang sudah ada dengan "tidak ada".

AI akan menghasilkan file Migration dengan nomor versi, berisi operasi DDL dan logika migrasi data.

#Tautan Terkait

• Mulai Cepat Pengembangan Plugin AI — Mulai cepat dan ikhtisar kemampuan
• Praktik: Pengembangan Plugin Watermark — Studi kasus praktik pengembangan Plugin AI yang lengkap
• Pengembangan Plugin — Panduan lengkap pengembangan Plugin NocoBase
• NocoBase CLI — Tool baris perintah untuk memasang dan mengelola NocoBase