AiHummer
Türkçe▾
Oturum açHesap
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Pazar yeri ve eklentiler/Kurulum ve güncellemeler

Kurulum ve güncellemeler

v1.0.x · güncellendi 2026-07-05

AiHummer’da bir eklenti yüklemek, yönetici kullanıcı arayüzünde tek bir tıklamadır, ancak bu tıklamanın arkasında belirleyici, ana bilgisayar yerel bir yaşam döngüsü vardır. Platform eklentiyi indirir, belirtilen yükleme adımlarını çalıştırır, bir sandboxlanmış systemd birimive yalnızca bir sağlık kontrolüne yanıt verdiğinde eklentiyi sağlıklı olarak değerlendirir. Her kurulum daha sonra kendi kendine güncel kalır.

Yönetici kullanıcı arayüzünden tek tıklamayla kurulum

Eklentileri yönetici kullanıcı arayüzünden kurar ve yönetirsiniz; bu arayüz, yönetici modülü API’si tarafından desteklenmektedir:

GET  /v1/admin/modules
POST /v1/admin/modules/install

Modül slug’ı yol yerine JSON istek gövdesine gider:

{ "slug": "einstein", "version": "" }

Elle kablolamaya gerek yok: katalogdan bir eklenti seçin, yükle’ye tıklayın ve dağıtıcı devreye girer.

[!NOTE] Çekirdek setin dışında bir kanal bağlayıcı kurmak (sadece Telegram) aktif bir şeye ihtiyaç duyar Başlangıç, İş veya Girişim lisans. Topluluk planında böyle bir istek geri döner HTTP 402 “yükleme gerekli” (kod plan_limit) — bak Lisanslama.

[!NOTE] Einstein bellek eklentisi yerleşik: otomatik olarak yüklenir, Bir “Yerleşik” rozeti taşır ve kaldırılamaz veya durdurulamaz.

SystemdDeployer akışı

Kaputun altında SystemdDağıtıcı bu adımları gerçekleştirir:

  1. Bir tar arşivi indir seçili eklenti için.
  2. Manifesti çalıştır install[] adımlar eklenti tarafından ilan edildi.
  3. Bir sandboxed systemd birimi çalıştır eklenti için.
  4. Anket /healthz servis sağlıklı rapor verene kadar.
download tarball ─▶ run install[] steps ─▶ render sandboxed systemd unit ─▶ poll /healthz ─▶ active

Sadece ne zaman /healthz Başarılı olursa kurulum etkin olarak işaretlenir — çalışmayan bir eklenti sessizce yüklü olarak sayılmaz.

Ana bilgisayar yerel, izole edilmiş systemd — Docker değil

Her eklenti şu şekilde çalışır kendi izole edilmiş systemd servisi. Konteynerler yok, Docker yok, orkestratör yok: bir eklenti, kendi birimi, portu ve sandbox kısıtlamaları olan yönetilen bir Linux servisidir ve kurulumun geri kalanı gibi systemd tarafından denetlenir.

[!WARNING] AiHummer yerel ana bilgisayar içindir. Eklentiler, sandboxlı systemd servisleri olarak dağıtılır bir sürüm arşivinden — asla Docker konteynerleri olarak. Eğer bir rehber sana söylerse “plug-in konteynerini çalıştırmak” için, AiHummer’ı tanımlamaz.

Sağlık denetimi /healthz ile

Dağıtıcı, eklentiyi yoklar /healthz Başarıyı ilan etmeden önce uç noktayı kontrol etmek. Bu sağlık kapısı, tek tıklamayla yüklemeyi güvenli kılan şeydir: bozuk veya yanlış yapılandırılmış bir eklenti, üretimde daha sonra keşfedilmek yerine yükleme sırasında yakalanır.

Kurulum başına otomatik güncelleme

Güncellemeler ele alınır kurulum başına. Yüklenen her eklenti, kendi programına göre otomatik olarak kendini güncelleyebilir, bu nedenle eklentileri güncel tutmak, her yeni sürüm kataloga ulaştığında elle yeniden yükleme gerektirmez. Aynı indirme → yükleme adımları → render birimi → sağlık kontrolü akışı, bir güncelleme için de ilk yükleme için olduğu gibi çalışır.

[!TIP] Otomatik güncelleme kurulum başına olduğu için, bazı eklentileri sabit tutabilirsiniz iken başkalarının en son gelişmeleri takip etmesine izin vermek — her kurulum kendi yaşam döngüsünü yönetir.

Çok kaynaklı katalog

Katalog artık tek bir URL’ye bağlı değil. topluluk kataloğu üçüncü taraf eklentilerin yerleşik olarak gelmesi varsayılan kaynak (kurulum sırasında eklenmiş) — bunu kendiniz eklemezsiniz. İçinde Eklentiler → Kaynaklar (Yönetici Arayüzü, ya da POST /v1/admin/modules/catalog/sources) kendi ek kaynaklarınızı ekleyebilirsiniz. Geçit, etkinleştirilmiş her kaynağı başlatmada ve otomatik güncelleme aralığında senkronize eder.

  • resmî kaynak (birinci taraf modülleri) varsayılan olarak sabitlenir ve güvenilir olarak kabul edilir — ayrı bir nesne olan üstüne yazılmadı diğer kaynaklar tarafından.
  • topluluk kataloğu tohumlanmış varsayılan bir kaynaktır; özel kaynaklar olmak operatör tarafından eklenmiştir. Her katalog girişinin bir origin, ve bu origin hangi çapa ile imzanın doğrulandığını belirler karşı (resmi → sabitlenmiş anahtar, özel → güven deposu).

Topluluk kataloğuna yayınlamak için, bkz. Bir eklenti yayımlamak.

Güven modeli ve sabitlenmiş anahtar

Kurulum, bir eklentinin imzasını kaynağına göre doğrular:

  • resmî → … karşı doğrulandı çekirdek içine sabitlenmiş kayıt defteri anahtarı. Tarafından güvenilir varsayılan, operatör işlemi yok.
  • özel (yan yükleme) → doğrulandı örnek güven deposu; Yazar anahtarı, yükleme sırasında operatör tarafından onaylanır (tek tık).
  • işaretsiz → reddedildi, sadece geliştirme modunda (AIHUMMER_PLUGIN_DEV_UNSIGNED=1, sadece yerel geliştirme için).

[!WARNING] Topluluk eklentileri şu anda kurulamıyor — bu bir bağlantı sorunu değil. Topluluk kataloğunu imzalayan anahtar geri çekildi; yeni bir anahtar yayınlanana kadar imza denetimi bu kayıtları reddediyor. Bundan bağımsız olarak, üçüncü taraf kod sunucunuzda henüz bir servis olarak çalıştırılmıyor: yalıtılmış bir çalışma ortamı hazır olana kadar yalnızca kendi tarafında çalışan ve ağ üzerinden bağlanan entegrasyonlara izin veriliyor.

Ne göreceksiniz: «kur» düğmesinden sonra her zamanki «kuruluyor» mesajı çıkar, ama eklenti kurulu listesinde hiç görünmez. Reddin nedeni ağ geçidi günlüğüne yazılır — yönetim panelinde Günlükler’i açın.

Bugün işleyenler:

  • AiHummer’ın resmî katalogdaki eklentileri — her zamanki gibi kurulur, bunlar farklı ve geçerli bir imza taşır;
  • HTTP üzerinden MCP sunucusu — geliştirme gerektirmeyen bir araç kaynağı olarak bağlanır, kod sizin tarafınızda kalır;
  • OpenAPI belirtimiyle entegrasyon — aynısı, kurulacak servis olmadan.

Kendi eklentinizi elle yüklemek imza denetimini geçer, ama yalnızca HTTP üzerinden uzak MCP ya da OpenAPI entegrasyonu olarak çalışır; aynı sunucuda servis olarak başlatılması gereken bir yapı reddedilir.

İmzalı güncellemeler

Bir güncelleme aynı imza kapısını tekrar çalıştırır ilk kurulum olarak: yeni bir sürüme geçerken imza aynı güven ağına karşı tekrar doğrulanır. Bir güncelleme atlatamaz kontrol — bir güncellemeyle güveni yükseltemezsiniz.

Resmî rozet ve sıralama

Web UI kataloğunda, AiHummer’dan gelen eklentiler bir Resmî rozet ve rütbe önce. Üçüncü taraf eklentiler rozet olmadan gösterilir ve sıralanır indirme sayısına göre. Resmi bayrak, bir başvurudan türetilmiştir origin (resmî) — manifestoda elle ayarlanamaz.

Sonra nereye?