Komut Satırı Referansı

Aşağıda colpan komut satırı arayüzündeki son kullanıcı komutları, işlev alanına göre gruplanmıştır.

activity

• colpan activity — Colpan’ın ne yaptığı: önizleme, arama, indeksleme, OCR gibi işlemlerin zaman damgalı ve sonuçlu kronolojik akışı; diskteki kalıcı etkinlik günlüğünden okunur

cloud — Bulut kaynaklarını yönet (Google Drive, S3, WebDAV, …)

• colpan cloud fetch <name> <uri> <out> — Tek bir dosyayı yerel bir yola indir
• colpan cloud list — config.toml’da tanımlı tüm bulut kaynaklarını listele
• colpan cloud ls <name> — Uzak bir yoldaki dosyaları listele
• colpan cloud stat <name> <uri> — Tek bir bulut URI’si için meta verileri göster

config

• colpan config show

convert — Belgeleri biçimler arasında dönüştür (LibreOffice ile)

• colpan convert file <input> <output> — Bir dosyayı başka bir biçime dönüştür
• colpan convert formats — Desteklenen biçimleri listele
• colpan convert to-pdf <input> — Bir dosyayı PDF’ye dönüştür

export

• colpan export <query> — Arama sonuçlarını JSON Lines olarak dışa aktar (ajan ince ayar iş akışları için)

filter — Filtre ön ayarları (uzantılar, boyut sınırları, hariç tutmalar)

• colpan filter add-ext <name> — Bir filtreye uzantı ekle
• colpan filter copy <source> <target> — Yerleşik bir filtreyi yeni, düzenlenebilir bir filtreye kopyala
• colpan filter create <name> — Yeni bir filtre ön ayarı oluştur
• colpan filter delete <name> — Özel bir filtreyi sil
• colpan filter list
• colpan filter remove-ext <name> — Bir filtreden uzantı çıkar
• colpan filter set-size <name> — Bir filtre için boyut sınırlarını ayarla
• colpan filter show <name>

group — Grup (indeks) yönetimi — dizinler ve kurallar

• colpan group add-cloud-dir <group> <source> <remote_path> — Tanımlı bir bulut kaynağına dayalı bir bulut dizini ekle
• colpan group add-dir <group> <path> — Gruba dizin ekle
• colpan group attach <profile> <group> — Grubu bir profile bağla
• colpan group clear-alias <group> — Bir grubun takma adını temizle
• colpan group create <group> — Yeni bir grup oluştur
• colpan group delete <group> — Bir grubu sil
• colpan group detach <profile> <group> — Grubu bir profilden ayır
• colpan group disable <group> — Bir grubu devre dışı bırak
• colpan group enable <group> — Bir grubu etkinleştir
• colpan group exclude <group> <path> — Bir alt dizini hariç tut
• colpan group exclude-file <group> <path> — Belirli bir dosyayı hariç tut
• colpan group export <group> <output> — Grup yapılandırmasını dosyaya aktar
• colpan group export-bundle <group> <output> — Tam indeksi (yapılandırma + Tantivy verisi) bir .colpan ZIP paketi olarak dışa aktar — salt okunur dağıtım için paylaşılan bir klasöre yayımladığın anlık görüntü. export’tan (yalnızca yapılandırma) farklı olarak veriyi de taşır. Anlık görüntünün tutarlı olması için grubu indekslemezken çalıştır. Yazma atomiktir (geçici + yeniden adlandırma); hedef, kopyalama sırasında bir okuyucu tarafından kilitliyse, vazgeçmeden önce —wait-secs kadar bekler
• colpan group group-info <group> — Grup istatistiklerini göster
• colpan group import <file> — Grup yapılandırmasını dosyadan içe aktar
• colpan group include <group> <path> — Hariç tutulan alan içinde yeniden dahil et
• colpan group include-file <group> <path> — Hariç tutulan alan içinde belirli bir dosyayı dahil et
• colpan group list — Tüm grupları listele
• colpan group list-rules <group> — Bir grubun tüm kurallarını listele
• colpan group publish <group> — Bir grubun indeksini yapılandırılmış yayımlama yoluna hemen yayımla — elle “şimdi paylaş”. —force verilmedikçe indeks değişmemişse atlar
• colpan group remove-dir <group> <path> — Gruptan dizin çıkar
• colpan group remove-rule <group> <path> — Bir kuralı yola göre kaldır
• colpan group rename <old> <new> — Bir grubu yeniden adlandır
• colpan group set-alias <group> <alias> — Bir grup için takma ad belirle
• colpan group set-archive-ext <group> <ext> <formats> — Uzantıya özgü arşiv kapsamı geçersiz kılmasını ayarla veya temizle. Biçimler: “global” (devral) | “none” | virgülle ayrılmış liste
• colpan group set-archive-global <group> <formats> — Grubun genel arşiv kapsamını ayarla (biçimler varsayılan olarak açılır). Biçimler: “none” | “all” | zip,rar,7z,tar,iso virgül listesi
• colpan group set-description <group> <text> — Bir grup için açıklama belirle
• colpan group set-filter <group> <filter> — Mevcut bir grup için filtre ön ayarını belirle. Uzantılar, boyut sınırları ve hariç tutma listeleri indeksleme anında filtreden çözümlenir — nelerin uygulanacağı için `filter show <name>`‘e bak
• colpan group set-language <group> <language> — Bu grubun gövdeleme için belge dilini ayarla. Dil: ISO kodu (“en”, “tr”, “de”) veya Snowball adı (“english”); “auto” veya “clear” genel indexing.stem_language / işletim sistemi yerel ayarını izler. Bir sonraki (yeniden) indekslemede uygulanır — mevcut segmentler kendi çözümleyicisini korur
• colpan group set-max-size <group> <ext> <size> — Uzantıya özgü en büyük boyut geçersiz kılmasını ayarla. Boyut: “1KB”/“5MB”/… veya temizlemek için “0”/“none”
• colpan group set-min-size <group> <ext> <size> — Uzantıya özgü en küçük boyut geçersiz kılmasını ayarla. Boyut: “1KB”/“5MB”/… veya temizlemek için “0”/“none”
• colpan group set-ocr-ext <group> <ext> <engine> — Uzantıya özgü OCR motoru geçersiz kılmasını ayarla. Motor: off | auto | oar | tesseract | system | plugin:<name> | global (geçersiz kılmayı temizle)
• colpan group set-publish <group> — Bir grup için düzenli salt okunur yayımlamayı yapılandır: indeks değiştiğinde her —every saniyede —path’e bir .colpan anlık görüntüsü yazılır. 0 / —off = yalnızca elle (group publish kullan)
• colpan group show <group> — Grup ayrıntılarını göster

index — Arama indekslerini oluştur, incele ve bakımını yap

• colpan index browse — İndekslenmiş dosyalara göz at (indeksteki tüm belgeleri listele)
• colpan index delete-dir <path> — Bir dizindeki tüm dosyaları indeksten sil
• colpan index delete-file <path> — Bir dosyayı yola göre indeksten sil
• colpan index info — İndeks istatistiklerini göster (biçim sayıları, boyutlar, en çok kullanılan dizinler)
• colpan index start
• colpan index status

info

• colpan info

models — Birleşik model paketi kataloğu + indirici (OCR / LLM / NER). colpan ocr models …’in yerini tür-duyarlı bir yüzeyle alır

• colpan models download <id> — Adlandırılmış bir paketi indir — tür, id’den otomatik çözümlenir
• colpan models list — Her manifesti, kurulum durumuyla birlikte listele. --kind süzer
• colpan models where — Modellerin diskte nerede olduğunu göster (yapılandırma geçersiz kılmasına saygı duyarak)

ocr — OCR motoru seçimini ve dilini yönet

• colpan ocr list — Tam durum — kip, motor, motor başına kullanılabilirlik + diller, model kurulumları
• colpan ocr probe — Her motoru küçük, sentetik 4x4’lük bir görüntüyle dene — kayıtlı arka uçların çökmeden yanıt verdiğini doğrulayan CI tarzı sağlık kontrolü
• colpan ocr set-enabled <value> — Ana açma/kapama — GUI’de “OCR’ı Etkinleştir”i işaretlemeye eşdeğer
• colpan ocr set-engine <engine> — Motor seçimi
• colpan ocr set-language <language> — Dil dizesi (eng+tur | tur | …)
• colpan ocr system langs — Kurulu platform OCR dillerini göster (iskele — bağlanmamış yapılarda boş liste)

pii — PII filtre ayarlarını yönet (kategoriler, terim izin listeleri)

• colpan pii auto-scan <value> — Önizleme açılışında otomatik taramayı etkinleştir veya devre dışı bırak
• colpan pii disable-category <category> — Bir PII kategorisini devre dışı bırak (örn. DATE, URL, IBAN, EMAIL, PHONE)
• colpan pii disable-term <term> — Özel bir terimi kasadan kaldırmadan geçici olarak devre dışı bırak
• colpan pii dismiss <term> — Algılanan belirli bir değeri yok say (yanlış pozitif izin listesi)
• colpan pii enable-category <category> — Önceden devre dışı bırakılmış bir kategoriyi yeniden etkinleştir
• colpan pii enable-term <term> — Devre dışı bir özel terimi yeniden etkinleştir
• colpan pii show — Geçerli PII filtre durumunu göster (kategoriler, terimler, izin listesi)
• colpan pii undismiss <term> — Bir terimi yok sayılanlar listesinden çıkar
• colpan pii vault clear — Kasadaki her girdiyi + özel terimi sil. vault_id ve ana anahtar korunur (paylaş/geri yükle dışa aktarmaları yine çözümlenir). Ana anahtarı yok etmeden, bir önizleme tarama oturumundan biriken NER gürültüsünü temizlemek için bunu kullan
• colpan pii vault export <path> — Her kasa girdisini bir CSV dosyasına aktar (belirteç yok — İçe Aktar’a bak)
• colpan pii vault import <path> — export tarafından üretilmiş veya elle yazılmış bir category,original CSV’sini içe aktar. Belirteçler dosyada DEĞİLDİR — eklemede etkin kasanın vault_id tuzuyla yeniden üretilir
• colpan pii vault list — Kasa girdilerini listele (başlık + sayı + ilk N satır)

plugin — Keşfedilen eklentileri incele

• colpan plugin disable <id> — Bir eklentiyi kalıcı olarak devre dışı bırak (config.plugins.disabled’a yazılır). Uygulama/CLI bir sonraki yüklenişinde etkili olur
• colpan plugin enable <id> — Önceden devre dışı bırakılmış bir eklentiyi yeniden etkinleştir
• colpan plugin list — Keşfedilen tüm eklentileri durumlarıyla listele
• colpan plugin show <id> — Tek bir eklenti için tam manifesti göster

profile — Profilleri yönet (çalışma alanları)

• colpan profile add-dir <name> <path>
• colpan profile create <name>
• colpan profile delete <name>
• colpan profile list
• colpan profile remove-dir <name> <path>
• colpan profile show <name>

search — İndekste sorgula

• colpan search <query> — İndekste sorgula

search-saved — Kayıtlı (sabitlenmiş) CQL arama sorgularını yönet

• colpan search-saved add <query> — Hızlı yeniden kullanım için bir CQL sorgusunu sabitle. Zaten kayıtlıysa işlem yapmaz
• colpan search-saved list — Sabitlenmiş her arama sorgusunu, en yeni sabit en üstte olacak şekilde göster
• colpan search-saved remove <query> — Önceden kaydedilmiş bir sorgunun sabitini kaldır. Mevcut değilse işlem yapmaz
• colpan search-saved rename-category <old> <new> — Kategorisi old’a eşit her girdiyi new olarak yeniden adlandır. Boş new onları Kategorisiz’e taşır (bu bir yeniden kategorileme, silme değil — sabitler korunur)
• colpan search-saved set-category <query> <category> — Kayıtlı bir sorguyu bir kategori grubuna taşı. Boş kategori onu “Kategorisiz”e bırakır. Sorgu kayıtlı değilse hata verir
• colpan search-saved set-label <query> <label> — Kayıtlı bir sorgu için kullanıcı dostu bir etiket belirle. Boş etiket ham sorguyu gösterir. Sorgu henüz kayıtlı değilse hata verir

settings — Masaüstü tümleştirme ayarları — otomatik başlatma, küçültülmüş başlat, kapatınca tepsiye

• colpan settings autostart — PC açılışında otomatik başlatma. Geçerli değeri okumak için state’i atla
• colpan settings mode — Arayüz kip ön ayarı (yerleşik simple / advanced veya config.toml’da tanımlı herhangi bir [modes.<name>]). Okumak için name’i atla
• colpan settings show — Her desktop_integration ayarını yazdır (yapılandırma + gerçek işletim sistemi durumu)
• colpan settings start-minimized — Otomatik başlatma girdisinin --minimized geçirip geçirmeyeceği (gizli başlat)
• colpan settings tray-on-close — X düğmesi yakalama: on olduğunda X pencereyi tepsiye gizler

starred — Yıldızlı koleksiyonları yönet

• colpan starred add <collection> <path> — Bir koleksiyona dosya yolu ekle
• colpan starred create <collection> — Yeni, boş bir koleksiyon oluştur
• colpan starred delete <collection> — Bir koleksiyonu sil
• colpan starred list — Tüm koleksiyonları öğe sayılarıyla listele
• colpan starred prune <collection> — Yolu diskte artık bulunmayan öğeleri kaldır
• colpan starred remove <collection> <path> — Bir koleksiyondan yol çıkar
• colpan starred rename <old> <new> — Bir koleksiyonu yeniden adlandır
• colpan starred show <collection> — Bir koleksiyondaki öğeleri göster

status

• colpan status — Çalışan GUI’nin diske yansıttığı canlı kaynak anlık görüntüsü — yüklü modeller / oturumlar / alt süreçler ve RAM + CPU kullanımları, ayrıca etkin akışlar (indeksleme, OCR doldurma, …)

watch — Dosya değişikliklerini izle ve otomatik yeniden indeksle

• colpan watch — Dosya değişikliklerini izle ve otomatik yeniden indeksle