nux-gen Otonom Recipe Generator

Nucora Linux ST 3.0 — Obsidian Engine | Resmî teknik dokümantasyon

Upstream tarama, recipe üretimi, bağımlılık DAG’i ve ELF runtime taraması.

Komutları güvenli çalıştır

Örneklerdeki paket ve aygıt adlarını kendi sisteminle karşılaştır. Root yetkisi gerektiren işlemlerde komutun etkisini ve hedef yolu doğrulamadan devam etme.

Amaç ve bileşenler

nux-gen Python tabanlı, 128 dosya ve yaklaşık 79.000 satır olarak belirtilen recipe otomasyonudur. planner.py güncelleme sıralar, upstream.py kaynak sürümlerini tarar, recipe.py tarif üretir, resolver.py DAG çözer, providers.py soname eşleştirir, runtime_check.py ELF runtime bağımlılıklarını tarar, analyzer.py logları inceler ve audit.py eksikleri raporlar.

Upstream keşfi

Kaynak tarayıcı GitHub API, GNOME FTP, Xfce ve GNU upstream’lerini kapsar. API rate-limit, imza, archive naming ve sürüm ön ekleri ayrı ayrı ele alınmalıdır. Yeni bir sürüm tespit edilmesi otomatik olarak güvenilir kaynak veya yayın onayı anlamına gelmez.

Recipe üretimi

Meson/CMake/Autotools tespiti başlangıç noktasıdır. Tarife kaynak URL’si, gerçek checksum, build bağımlılığı, runtime bağımlılığı, lisans ve test adımları eklenmeden otomatik taslağı doğrudan stable’a yayımlama. nux-fix-sha hash güncelleyebilir; bu işlem güvenilir upstream checksum doğrulamasının yerine geçmez.

DAG ve sağlayıcı veritabanı

resolver.py bağımlılık ağacını yönlü çevrimsiz grafik olarak çözmeyi hedefler. providers.py SQLite veritabanında soname ile paket sağlayıcısını eşleştirir. Eksik sağlayıcı, bir build’in sırasını bozabilir; sağlayıcı kaydını gerçek paket metadata’sı ve ELF çıktısıyla doğrula.

Runtime taraması

readelf ile ELF NEEDED kayıtları taranır. Bu tarama yalnızca ELF dinamik bağlantılarını görür; dlopen ile sonradan yüklenen eklentiler, interpreter/script bağımlılıkları veya özellik bazlı opsiyonel gereksinimler ayrıca test edilmelidir.

İnsan incelemesi

Üretilen tarife kaynak ve lisans kontrolü, clean chroot build’i, test, manifest.json gözden geçirmesi, install/remove testi ve stable yayın onayı ekle. Örnek runtime_sync çıktısı belirtilmediğinden burada sahte çıktı formatı verilmemiştir; gerçek CLI çıktısını repo README’sinden al.

Güvenli uygulama akışı

Bu sayfadaki nux-gen Otonom Recipe Generator adımlarını uygularken önce mevcut durumu kaydet; ilgili sistemde nux doctor komutunun kullanılabilirliğini ve yardım metnini doğrula. 1. Hedef cihazın ST sürümünü, x86_64 mimarisini, aktif kanalı ve gerekli disk alanını doğrula. 2. Geri alınması zor işlem öncesinde kullanıcı verisini yedekle ve cihazı kararlı güç kaynağına bağla. 3. Tek seferde tek değişiklik uygula; komut, zaman, çıkış kodu ve sonucu not et. 4. Başarısızlık halinde işlemi tekrarlamadan önce tam logu ve son başarılı durumu sakla. 5. Sonucu nux doctor, ilgili bileşen sorgusu ve gerçek kullanıcı senaryosuyla doğrula.

ST 3.0 referans matrisi

Bileşen	Verilen referans
Sürüm / kod adı	ST 3.0 / Obsidian Engine
Taban / mimari	Saf LFS / x86_64
Kernel / init	linux-nucora 6.4.12 / SysVinit
libc / derleyici	glibc 2.39 / GCC 14.2.0
Masaüstü / görüntü	XFCE 4.20, Xfwm4 / Xorg
Paket yöneticisi	nux 8.4.10; Go
Bellek / depolama	Boşta ~450 MB; minimum 2 GB RAM, 15 GB disk
Paket envanteri	stable 433; testing 46 (sağlanan sayılar)

Değişiklik sonrası doğrulama

Beklenen dosya/paket/ayar doğru yerde ve doğru sürümde.
İlgili servis, masaüstü oturumu veya ağ bağlantısı yeniden çalışıyor.
Paket veritabanı tutarlı; nux doctor yeni hata üretmiyor.
Loglarda checksum, bağımlılık veya izin hatası yok.
Geri dönüş yolu ve yedeğin okunabilirliği biliniyor.

Hata ayırma matrisi

Belirti	İlk kontrol	Güvenli sonraki adım
Paket bulunamıyor	`nux channel`, `nux repo list`	İndeksi yenile; gerçek paket adını ara.
Hash uyuşmuyor	Arşiv SHA256 ve repo metadata	Arşivi kurma; kaynağı/indeksi doğrula.
Bağımlılık eksik	`nux check-deps`, `nux info`	Sağlayıcıyı belirle; rastgele dosya kopyalama.
Sistem beklenmedik	History ve son log	Yeni değişiklik yapmayı durdur; yedekle ve raporla.

Güvenlik sınırları

Arşiv, recipe, maintainer script veya tester anahtarını güvenilir kaynaktan doğrulamadan root ile çalıştırma.
.nux checksum uyuşmazlığını görmezden gelme; hash düzeltme aracı kaynağın güvenilirliğini kanıtlamaz.
/var/lib/nux/ veritabanını elle düzenleme veya snapshot dosyalarını doğrulamadan silme.
-y bayrağını özellikle remove/upgrade işlemlerinde etkisini anlamadan kullanma.
Rapor ve ekran görüntülerinden parola, anahtar, kişisel dosya yolu ve token’ları ayıkla.

İlgili sayfalar

Dokümantasyon ve ürün verisi notu

Bu içerik proje tarafından sağlanan ST 3.0 tanımına dayanır; burada açıklanmayan endpoint, environment variable, CLI flag, canlı checksum veya otomatik downgrade davranışı varsayılmaz. Sistemde gözlenen davranış bu metinle çelişirse önce nux --version, aktif repo indeksi ve kaynak kodu/release notlarını karşılaştır; doğrulanmış düzeltmeyi issue veya değişiklik günlüğüne ekle. Bu sayfanın konusu: nux-gen otonom recipe generator. Üretim sistemlerinde değişiklikleri önce test kanalında veya yalıtılmış ortamda doğrula.

İşlem kaydını hazırlama

Destek veya bakım kaydı açarken dağıtım sürümünü, mimariyi, aktif kanalı ve etkilenen paket sürümünü ekle. Komutu kopyalayıp yapıştırmak yerine hedef dosya ve aygıt adlarını önce gözden geçir. Birden fazla adım varsa her adımın çıktısını ayrı sakla; sorunun ilk görüldüğü zamanı not et. Başarılı sonucu yalnızca komutun çıkış koduyla değil, beklenen işlevi test ederek doğrula. Kişisel verileri ve gizli anahtarları paylaşmadan önce logları redakte et. Bu sayfadaki sürüm bilgilerini yeni release çıktısıyla karşılaştırarak güncel tut.