Ana Sayfa
EN

Teknik Referans

Dosya yapısı, indeks formatları ve komut satırı parametreleri.

Dosya Yapısı

Colpan\
├── Colpan.exe                  (Ana uygulama)
├── QtPdfView.exe               (Bağımsız PDF viewer)
├── Qt6Core.dll                 (Qt çekirdek kütüphanesi)
├── Qt6Gui.dll                  (Qt GUI kütüphanesi)
├── Qt6Widgets.dll              (Qt widget kütüphanesi)
├── Qt6Pdf.dll                  (Qt PDF kütüphanesi)
├── Qt6PdfWidgets.dll           (Qt PDF widget'ları)
├── Qt6Concurrent.dll           (Qt paralel işlem)
├── Qt6Network.dll              (Qt ağ kütüphanesi)
├── Qt6Xml.dll                  (Qt XML kütüphanesi)
├── Qt6PrintSupport.dll         (Qt yazdırma desteği)
├── quazip.dll                  (ZIP kütüphanesi)
├── zlib.dll                    (Sıkıştırma kütüphanesi)
├── platforms\                  (Qt platform eklentileri)
│   └── qwindows.dll
├── imageformats\               (Görsel formatlar)
│   ├── qsvg.dll
│   └── qico.dll
├── styles\                     (Qt stil eklentileri)
│   └── qmodernwindowsstyle.dll
└── udf2pdf_portable\           (PDF dönüştürücü)
    ├── udf2pdf_simple.bat      (Başlatıcı script)
    ├── udf2pdf.jar             (Java uygulaması)
    └── jre-25-custom\          (Gömülü Java)

İndeks Dosya Formatları

header.txt

Dosya listesi ve hash eşleştirmesi:

# Format: hash|path|size|modified|offset|length
a1b2c3d4|C:\docs\file1.udf|1024000|2024-12-22T10:30:00|0|32768
b2c3d4e5|C:\docs\file2.udf|2048000|2024-12-21T15:45:00|32768|65536

content.idx

Hash → konum haritası:

# Format: hash offset length
a1b2c3d4 0 32768
b2c3d4e5 32768 65536

content.bin

  • Binary format
  • 32 MB hizalı bloklar
  • Normalize edilmiş UTF-8 içerik

Ayar Dosyası

Konum: %APPDATA%\Colpan\settings.ini

[Settings]
ThemeMode=3
PreviewSide=true
StartWithWindows=false
SonucLimit=1000
AktifProfil=0

[Profiles]
Count=5

[Profile_0]
name=Profil 1
icon=1
color=#FF5733

[Profile_0_Dirs]
count=2
0\path=C:\Documents
0\active=true
0\excluded=false
1\path=D:\Archive
1\active=true
1\excluded=false

Log Dosyası

Konum: %TEMP%\Colpan\colpan.log

Log Seviyeleri:

  • DEBUG: Detaylı teknik bilgi
  • INFO: Normal işlem bilgisi
  • WARNING: Uyarı mesajları
  • ERROR: Hata mesajları

Komut Satırı Parametreleri

Colpan.exe [seçenekler]

Seçenekler:
  --minimized     Tray'de başlatır
  --profile N     Belirli profille başlatır (0-4)
  --search "..."  Otomatik arama başlatır

Örnekler:

# Tray'de sessiz başlat
Colpan.exe --minimized

# Profil 3 ile başlat
Colpan.exe --profile 2

# Başlatıp otomatik arama yap
Colpan.exe --search "boşanma ; nafaka"

Desteklenen Dosya Formatları

Format Uzantı Destek
UYAP UDF .udf Tam destek
PDF (çıktı) .pdf Oluşturma/Görüntüleme

Sistem Gereksinimleri (Detaylı)

Bileşen Minimum Önerilen Notlar
OS Windows 10 64-bit Windows 11 32-bit desteklenmez
CPU 2 çekirdek 4+ çekirdek Paralel arama için
RAM 4 GB 8 GB+ Büyük indeksler için
Disk 500 MB 2 GB+ İndeksler için
Ekran 1366x768 1920x1080 Daha iyi kullanım
.NET Gerekli değil - Qt tabanlı
Java Gerekli değil - Gömülü Java

Port Kullanımı

Port Kullanım
39876 PDF daemon iletişimi (Java)
9308 Manticore Search HTTP API
9306 Manticore Search MySQL protokolü

Geçici Dosyalar

Konum İçerik
%TEMP%\Colpan\ İndeksler, loglar
%TEMP%\Colpan\pdf_cache\ PDF önbellekleri
%TEMP%\Colpan\Profil_N\ Hash index dosyaları
%TEMP%\Colpan\manticore_data_N\ Manticore Search veritabanı

AI Asistan Ayarları

API Endpoint’leri:

Mod Endpoint
CF Worker Cloudflare Worker proxy
Direct OpenRouter https://openrouter.ai/api/v1/chat/completions

Ayar Dosyasında:

[AI]
UseWorker=true
ApiKey=sk-or-v1-xxx
Model=anthropic/claude-3-haiku

Dönüştürücü Modları

Mod Açıklama
OriginalUyapEditor Java daemon tabanlı (port 39876)
ColpanUdf2Pdf Native Qt/C++ dönüştürücü

Ayar Dosyasında:

[PDF]
ConverterType=0  # 0=Java, 1=Native

Desteklenen Giriş Formatları

Format Uzantı Dönüşüm Yolu
UYAP UDF .udf Direkt → PDF
RTF .rtf RTF → UDF → PDF
FODT .fodt FODT → UDF → PDF
DOCX .docx LibreOffice → RTF → UDF → PDF
DOC .doc LibreOffice → RTF → UDF → PDF
ODT .odt LibreOffice → RTF → UDF → PDF
TXT .txt Dokümanı UDF Yap → UDF
HTML .html/.htm Dokümanı UDF Yap → UDF
PDF .pdf PDF’yi UDF Yap → UDF

Dönüşüm Yönleri (Kısa Özet)

  • Diğer formatlardan UDF’ye: DOCX/DOC/ODT/RTF/TXT/HTML, PDF
  • UDF’den diğer formatlara: PDF ve kelime işlemci formatlarına dışa aktarım
  • PDF’den UDF’de önerilen yol: PDF -> DOCX -> UDF

Sürüm Bilgisi

v1.1.0 (Şubat 2026)

  • AI Sorgu Asistanı (CF Worker + OpenRouter)
  • Manticore Search entegrasyonu (BM25 ranking)
  • Native Qt dönüştürücü (ColpanUdf2Pdf)
  • RTF/FODT import desteği
  • LibreOffice zinciri (DOCX/DOC/ODT)

v1.0.0 (Aralık 2025)

  • İlk kararlı sürüm
  • 5 profil desteği
  • Hash tabanlı indeksleme
  • Entegre PDF viewer
  • 4 tema seçeneği
  • Global kısayollar

LLM ve MCP Kaynakları