Sorun Giderme

Sık görülen kurulum ve kullanım hataları

Hızlı teşhis komutları

docufy --version
docufy --help
which docufy
ffmpeg -version
docufy formats --output-format json

Yaygın sorunlar ve çözümler

Belirti	Muhtemel neden	Çözüm
`command not found: docufy`	Go bin dizini PATH içinde değil	Kurulum sayfasındaki PATH adımlarını uygula, yeni terminal aç
`ffmpeg not found`	FFmpeg kurulu değil veya PATH'e ekli değil	`ffmpeg -version` çıktısı alana kadar kurulumu doğrula
Eski sürüm çalışıyor	PATH'te farklı binary önce geliyor	`which docufy` / `where docufy` ile aktif yolu kontrol et
Dönüşüm desteklenmiyor	Format kombinasyonu geçersiz	`docufy formats --from ...` ile destek matrisini doğrula
Batch/pipeline yarıda kaldı	İşlem kesildi veya dosya hatası oluştu	JSON rapordan `--resume-from-report` ile devam et

FFmpeg kaynaklı medya sorunları

Codec uyumsuzluklarında `--to mp4 --reencode` gibi açık format hedefi ver.
Video trim/merge için önce `--dry-run` ile planı doğrula.
Çok uzun işlemlerde çıktıyı rapora yaz: --report json --report-file ./reports/job.json.

Raporla devam (resume) örneği

docufy batch ./resimler --from jpg --to png --report json --report-file ./reports/batch.json
docufy batch ./resimler --from jpg --to png --resume-from-report ./reports/batch.json

Hala çözülmediyse

Komut çıktısını (hata mesajı + komut parametreleri + işletim sistemi bilgisi) paylaşarak issue açman, sorunu daha hızlı izole etmeyi sağlar.