Logseq Plugins ve scripting: DB graph'ı genişletmenin iki yolu

DB sürümü eski file graph plugin davranışının aynısını garanti etmiyor.

Bu nedenle ilk kontrol:

**plugin DB graph destekliyor mu?**

Marketplace işareti

Resmî db-version.md, 65+ plugin'in DB graph desteklediğini ve Marketplace'te DB uyumluluğunun filtrelenebildiğini söylüyor.

Uygulama içindeki Marketplace'te de DB destekli plugin'ler özel işaret taşıyor.

Bu sayı kaynakta verilen durum bilgisidir; zamanla değişebilir.

Plugin neden ayrı kontrol ister?

File graph plugin'i genellikle:

• Markdown dosyaları,
• eski block API'leri,
• eski property modeli

üzerinden çalışmış olabilir.

DB graph ise:

• SQLite,
• typed properties,
• tags/classes,
• yeni SDK yöntemleri

kullanıyor.

Bu yüzden eski plugin'in yüklenmesi, davranışının doğru olduğu anlamına gelmez.

SDK tarafı

Resmî belge JS Plugin SDK'nın DB-specific methods eklediğini söylüyor.

CLJS SDK da mevcut.

Bu, plugin geliştiricilerin DB modeline doğrudan uyumlu entegrasyon yazabilmesine alan açıyor.

Örnek olarak kaynak DB-compatible plugin'lere bağlantılar veriyor; bunları kalite sıralaması gibi yorumlamıyoruz.

Scripting

Plugin başka, script başka.

DB graph, nbb-logseq üzerinden script ile okunup yazılabiliyor.

Resmî belge desktop üzerinde bir graph'ı script ile değiştirmek için şu yüksek seviye akışı veriyor:

1. Cmd-S ile graph'ı db.sqlite'a persist et.
2. nbb-logseq script ile db.sqlite üzerinde değişiklik yap.
3. app içinde Replace graph with its db.sqlite file dev command ile değişen dosyayı yükle.

Bu güçlü ama düşük seviyeli bir workflow.

Ne zaman plugin?

Şu durumda:

• arayüze yeni davranış eklemek,
• günlük kullanımda sürekli çalışan özellik,
• kullanıcı etkileşimi,
• Marketplace dağıtımı.

Ne zaman script?

Şu durumda:

• toplu veri dönüşümü,
• tek seferlik migration,
• veri denetimi,
• otomasyon,
• CI işi.

Script yazmak için plugin UI'si kurmak gereksiz olabilir.

Yazma yetkisi riski

nbb-logseq script'leri graph'ta veri okuyup yazabilir.

Bu nedenle production graph üzerinde ilk deneme yapma.

Sıra:

1. export/backup al,
2. test graph oluştur,
3. küçük dataset üzerinde çalıştır,
4. diff veya beklenen sonuç listesini kontrol et,
5. sonra gerçek graph'a uygula.

Bu operasyon kuralıdır; source scriptlerin her değişikliği otomatik geri alacağını söylemiyor.

Plugin sayısını azalt

PKM araçlarında plugin koleksiyonculuğu sık görülür.

Her plugin:

• upgrade riski,
• uyumluluk riski,
• öğrenme maliyeti,
• performans yükü

ekleyebilir.

DB sürümünün built-in özellikleri zaten:

• tasks,
• views,
• properties,
• templates,
• MCP,
• CLI

gibi birçok ihtiyacı karşılıyor.

Önce core ile çöz.

Plugin yalnız açık boşluk varsa gelsin.

Karar

Logseq DB iki genişletme seviyesi sunuyor:

**plugin → kullanıcı deneyimini genişletir**

**script → graph verisi ve otomasyonla çalışır**

İkisini aynı ihtiyaca kullanma. Bir UI problemi için script, tek seferlik veri dönüşümü için plugin gereksiz karmaşıklık yaratır.