Ajanla Geliştirme

Bir yapay zekâ ajanına Pano için eklenti, tema ya da headless site yaptırmanın yolu. Kalıp her seferinde aynıdır: resmi iskeletten başlayın, ajan rehberi okusun, her seferinde tek bir şey isteyin, denetimleri çalıştırın, elle gözden geçirin.

Ajan rehberi

Pano'nun ajanlar için kuralları agent-guide/ adlı bir klasördür: işe göre yönlendiren kısa bir README.md ("yeni eklenti yapmak", "işaretlemeye dokunmadan görünümü değiştirmek", "headless ön yüz"...) ve her iş için küçük bir dosya. Depo kökündeki AGENTS.md ve CLAUDE.md, ajana önce o README'yi, sonra yalnızca kendi işinin dosyasını okumasını söyler.

Depo	Rehberi taşıyor mu
PanoMC/pano-starter-sveltekit (headless başlangıç şablonu)	evet; client-gen new onu projenize de kopyalar
PanoMC/pano-boilerplate-plugin (eklenti şablonu)	evet, panel sayfaları için design/ ile birlikte
PanoMC/vanilla-theme (varsayılan tema)	evet
PanoMC/sdk	rehberin kaynağı

Eklenti ve tema iskelet komutları bu dosyaları yeni projeye yazmaz. Bir kez kopyalayın:

git clone --depth 1 https://github.com/PanoMC/pano-boilerplate-plugin /tmp/pano-boilerplate
cp -r /tmp/pano-boilerplate/agent-guide /tmp/pano-boilerplate/design my-plugin/    # a plugin
cp -r /tmp/pano-boilerplate/agent-guide my-theme/                                  # a theme

Sonra isteklerinize "Önce agent-guide/README.md dosyasını oku" diye başlayın ya da bu cümleyi kendi AGENTS.md dosyanıza yazın.

Eklenti

Eklenti Başlangıç sayfasındaki gibi başlayın; Pano yerelde çalışıyor ve Geliştirme Modu açık olmalı:

cd <your-pano>/plugins && bunx @panomc/plugin-kit new my-plugin
cd my-plugin && bun run dev

Örnek istekler:

Önce agent-guide/README.md dosyasını oku. /my-plugin/rules adresinde sunucu kurallarının
listesini gösteren bir site sayfası ekle. Kuralları eklentinin kendi tablosunda sakla ve
onları listeleyen uç noktayı ekle.

Önce agent-guide/README.md dosyasını oku. Yöneticinin kuralları ekleyip düzenleyip
silebileceği, bu eklentinin bir izniyle korunan bir panel sayfası ekle. design/README.md'ye uy.

Bu eklentinin bütün metinlerini src/main/resources/locales/ altına taşı ve Türkçe çeviri ekle.

Sonucu denetleyin: bun run check (ya da bunx pano-plugin check --strict), sonra ./gradlew build. Kotlin değişikliklerini görmek için ./gradlew build -Pnoui ve Pano'yu yeniden başlatmak gerekir.

Tema

Tema Başlangıç sayfasındaki gibi başlayın:

bunx @panomc/theme-core new my-theme
cd my-theme && bun install && bun run dev:ui

Örnek istekler:

Önce agent-guide/README.md dosyasını oku. Bu temaya yeşil vurgulu koyu bir görünüm ver.
Yalnızca src/styles/tokens.scss ve src/styles/style.scss dosyalarını değiştir; hiçbir view'ı eject etme.

Önce agent-guide/README.md dosyasını oku. Ana sayfayı bir karşılama sayfasıyla değiştir:
sunucu adresini gösteren bir üst bölüm, ardından son üç yazı. Bütün eklenti slotlarını koru.

Market eklentisinin ürün kartını bu temaya uyacak şekilde yeniden biçimlendir. İşe yarayan
en ucuz adımı seç ve hangisini seçtiğini söyle.

Sonucu denetleyin: bunx @panomc/theme-core check --strict, bun run build; ayrıca her view'ı örnek veriyle görmek için <Pano adresiniz>/__pano/views adresini açın.

Headless ön yüz

Ön Yüz Hızlı Başlangıç (Headless) sayfasındaki gibi başlayın. Bu iskelet AGENTS.md, CLAUDE.md ve agent-guide/ ile gelir:

bunx @panomc/client-gen new my-site --url http://localhost:8088
cd my-site && bun run dev

Örnek istekler:

Önce AGENTS.md dosyasını oku. Bu Pano'nun Minecraft sunucularını çevrimiçi oyuncu sayılarıyla
listeleyen bir /servers sayfası ekle. src/lib/pano içindeki üretilmiş istemciyi kullan, onu düzenleme.

bun run pano:pull çalıştır, sonra market eklentisinin işlemleri üzerine bir mağaza sayfası ekle.

Sonucu denetleyin: bun run check, bun test, bun run build. bun run package, "Yüklediğim site" olarak yükleyeceğiniz zip'i üretir.

Yayınlamadan önce elle gözden geçirin

• Çalıştırın. Yeşil bir denetim, çalışan bir eklenti ya da tema demek değildir. Sayfayı Geliştirme Modu açık bir Pano'da, telefon genişliğinde de açın.
• Farkı (diff) okuyun. Üretilen klasörlerdeki düzenlemelere (temada src/routes/, src/lib/, lang/; eklentide src/main/resources/plugin-ui/; headless sitede src/lib/pano/), TypeScript dosyalarına ve değişmiş svelte sürümüne bakın. Rehber bunların hepsini yasaklar.
• Eklentiler: her panel uç noktasında izin denetimi, girdi doğrulama ve eklentinin yalnızca kendi tablolarına yazması. pluginId ilk yayından sonra bir daha değişemez.
• Gizli bilgiler: kodda ya da commit'te ön yüz anahtarı, lisans anahtarı ya da parola olmamalı.
• Sürümler ve yayınlar: ajan sürüm yükseltmemeli, etiket atmamalı, push yapmamalıdır. Yayınlar commit mesajlarınızdan çıkar: Derleme ve Yayınlama ve Yayınlama ve Premium.