Akış Logu Ayrıştırıcı Nasıl Yazılır

Bu rehber ne yapar

Akış Logu Ayrıştırıcı rehberi komutu küçük, tekrar koşulabilir ve dosyaya kanıt bırakan hale getirir. Solo çalışırken bu disiplin, bir hafta sonra kendi notunuza güvenmenizi sağlar. Bu iş sonunda Kumru 2B için tarihli bir karar kanıtı oluşur, RTX 4090 24GB sınıfı donanım not edilir ve ölçüm TurkBench karşılaştırması ile ilişkilendirilir. Akış GitHub Actions ile yürür; daha geniş bağlam Kurs O006: Değerlendirme ve Kayma içinde işlenir.

Yasal uyarı: Bu içerik eğitim amaçlı teknik çalışma notudur; hukuki görüş, mevzuat yorumu, uyum belgesi veya profesyonel danışmanlık değildir. Kişisel veri, sağlık, finans, çocuk/öğrenci verisi, telif veya regüle sektörlerde gerçek uygulamadan önce yetkin hukuk/uyum uzmanıyla yazılı değerlendirme alın.
Operatör notu: Akış Logu Ayrıştırıcı Nasıl Yazılır: CLI akışının değeri komutun idempotent olmasıdır; aynı komut ikinci kez koşunca çıktıyı bozuyorsa işletim defteri eksiktir. Orta seviyede komutun yanında hata modunu da yazın; gelecekteki bakım çoğu zaman bu satırdan başlar. Bu rehberde beklenen kanıt outputs/akis-log-ayristirici.json dosyasıdır.

Ön koşullar

  • Ubuntu 24.04 LTS ya da eşdeğer geliştirme ortamı.
  • Yerel çalışma zamanı kontrolü: python -V.
  • Akış Logu Ayrıştırıcı: Komutların yazabileceği outputs, logs ve reports klasörleri; sürüm bilgisini aynı klasöre koyun.
  • Terminal çıktısı UTF-8 olmalı; Windows tarafında şüphede kalırsanız chcp çıktısını kaydedin.

Adımlar

  1. Kanıt klasörünü aç. Akış Logu Ayrıştırıcı için çıktıyı akis log ayristirici adıyla ayır; aynı klasöre log ve kısa rapor da girecek.
mkdir -p outputs logs reports
  1. Küçük kanıtı üret. Akış Logu Ayrıştırıcı için CLI işi ikinci kez koşulduğunda aynı dosya düzenini korumalı; aksi halde otomasyon güvenilmez olur. Bu komut gerçek veriyi çağırmadan Kumru 2B etiketini karar dosyasına işler.
mkdir -p outputs
python - <<'PY'
from pathlib import Path
Path("outputs/akis-log-ayristirici.json").write_text('{"model":"kumru-2b","status":"kontrol-tamam"}\n', encoding="utf-8")
print("outputs/akis-log-ayristirici.json yazıldı")
PY
  1. Özeti kilitle. Akış Logu Ayrıştırıcı özetini daha sonra değişiklik yakalamak için kullanacaksınız; TurkBench karşılaştırması notunu bu hash ile birlikte saklayın.
python - <<'PY'
from hashlib import sha256
from pathlib import Path
p = Path("outputs/akis-log-ayristirici.json")
print(sha256(p.read_bytes()).hexdigest(), p)
PY
  1. Türkçe kırılmayı ara. Akış Logu Ayrıştırıcı Nasıl Yazılır cevabı ortasında İngilizceye kayarsa sistem istemine tek dil kısıtı ekleyin ve aynı girdiyi tekrar çalıştırın. Çıktı temizse GitHub Actions tarafındaki sıradaki adıma geçebilirsiniz.

Doğrulama

Tek komutla son durumu doğrula:

python - <<'PY'
import json
from pathlib import Path
p = Path("outputs/akis-log-ayristirici.json")
data = json.loads(p.read_text(encoding="utf-8"))
print(p.exists(), data["status"])
print("kanıt:", p)
print("model:", data["model"])
PY

Beklenen çıktı:

True kontrol-tamam
kanıt: outputs/akis-log-ayristirici.json
model: kumru-2b

Yaygın Hatalar

  • `ModuleNotFoundError` — Python ortamı rehber için beklenen paketi görmüyor. Çözüm: python -V çıktısını kaydedin, sanal ortamı etkinleştirin ve komutu aynı kabukta tekrar çalıştırın.
  • `output file is empty` — Komut başarılı dönmüş gibi görünse de kanıt dosyasına içerik yazmamış. Çözüm: outputs/akis-log-ayristirici.json dosyasını silip komutu tekrar çalıştırın; ikinci koşuda dosya boyutunu kontrol edin.
  • `Türkçe karakterler bozuk` — Akış Logu Ayrıştırıcı Nasıl Yazılır çıktısında Türkçe harfler okunmuyorsa kodlama katmanı karışmıştır. Çözüm: locale çıktısını kontrol edin ve dosyayı UTF-8 olarak tekrar üretin.
  • `outputs/akis-log-ayristirici.json yok` — Rehberin sonunda beklenen kanıt dosyası oluşmamış. Çözüm: önce çalışma klasörünü oluşturun, sonra karar kanıtı adımını tek başına tekrar çalıştırın.
Veri koruma uyarısı: Bu rehber KVKK uyum kararı vermez. Kişisel veri içeren örnekleri üretimde kullanmadan önce amaç, saklama süresi, erişim yetkisi ve yurtdışı aktarım ihtimalini yetkin hukuk/uyum uzmanıyla doğrulayın. Başlangıç noktası: KVKK ve AI.

İlgili rehberler

İlgili katalog girişleri