Genel bakış

Adanotch eklentileri, MacBook'unun çentiğinin hemen yanındaki kompakt alana ve tıklandığında açılan ada kartına kendi görünümünü yerleştiren hafif, güvenli TypeScript programlarıdır. Bir sistem monitörü, canlı hava durumu, açık GitHub PR'ları, pomodoro sayacı ya da kendi sunucunun durum paneli dakikalar içinde yazılabilir.

const { activity, ui, system } = AdanotchKit;

activity({
  async update() {
    const { cpuPercent } = await system.stats();
    return {
      compact: { leading: ui.icon("cpu"), trailing: ui.text(`${cpuPercent}%`) },
      expanded: ui.ring(cpuPercent, { label: "CPU" }),
    };
  },
});

1 Dakikada Hızlı BaşlangıçBağlantıyı kopyala

İlk eklentini kurmak için yalnızca üç adım yeterlidir:

adanotch --help

adanotch init my-widget --name "İlk Eklentim"
cd my-widget
npm install

npm run watch   # Kod değiştikçe dist/index.js'i anında derler
adanotch dev    # Eklentiyi Adanotch'a yükler, kaydettikçe çentikte canlı yeniler

İki Görünüm: Kompakt & Genişletilmiş AdaBağlantıyı kopyala

Adanotch eklentileri iki farklı arayüz yüzeyi sunar:

compact: {
  leading: ui.icon("cloud.sun.fill", { tone: "accent" }),
  trailing: ui.text("21°", { style: "mono" })
}

Mimari ve Temel İlkelerBağlantıyı kopyala

Adanotch eklenti sistemi hız, pil verimliliği ve sıkı güvenlik üzerine inşa edilmiştir:

• Yerel SwiftUI Hızı: HTML, CSS veya DOM yoktur. Eklentin hafif bir JSON düğüm ağacı döndürür; Adanotch bunu doğrudan macOS'un yerel SwiftUI motoruyla çizer. 120 FPS akıcı geçişler ve sıfır bellek yükü sağlanır.
• İzole JavaScriptCore Süreci: Her eklenti Adanotch ana uygulamasından ayrı bir süreçte çalışır. Eklentin hata verirse veya takılırsa yalnızca ilgili süreç yeniden başlar; ada asla donmaz.
• Sıkı İzin Modeli: Eklentiler yalnızca manifest.json içinde bildirdikleri ve kullanıcının onay verdiği izinleri kullanabilir: sistem istatistikleri, ağ erişimi (alan adı bazlı), pano, takvim ve ortam olayları.
• macOS Entegrasyonu: SF Symbols ikonları, sistem Dark Mode renk tonları, Keychain'de şifrelenen API anahtarları ve yerel klavye kısayolları doğrudan desteklenir.

Hazır Kullanım Senaryoları & ŞablonlarBağlantıyı kopyala

Farklı kullanım alanları için hazır örnekleri incele ve doğrudan projenin temeli olarak kullan:

AI Kodlama Ajanları ile Eklenti GeliştirmeBağlantıyı kopyala

Adanotch, Claude Code, Codex, Antigravity CLI veya Cursor gibi yapay zeka araçlarıyla eklenti geliştirmeyi birinci sınıf bir deneyim haline getirir.

Eklenti klasöründe bulunan SKILL.md kuralları sayesinde AI ajanına doğrudan komut verebilirsin:

# Terminalinde veya Cursor/Claude'da:
"Adanotch için MacBook pil sağlığını ve kalan şarj süresini gösteren bir eklenti yaz"

Ajanın manifest.json, izinler, src/index.ts ve test dosyalarını otomatik olarak eksiksiz üretecektir. Eklentini npm test ve adanotch lint ile anında doğrulayabilirsin.

Hızlı Başvuru KaynaklarıBağlantıyı kopyala

Sık Sorulan SorularBağlantıyı kopyala