Masaüstü uygulaması

Multica Desktop macOS, Windows ve Linux için kullanılabilir. Web uygulamasıyla aynı hesap ve çalışma alanı verisini kullanır, ancak makinenizdeki daemon'ı otomatik olarak yönetir ve her çalışma alanı için ayrı bir sekme grubu tutar.

Masaüstü ve web

Web, hızlı bir bakış için veya paylaşılan bir bilgisayarda daha kullanışlıdır.

İkisine aynı anda giriş yapmış olabilirsiniz. Aynı Multica servisine bağlandıkları sürece gösterdikleri veri paylaşılır.

Kurulum

İşletim sisteminize ve CPU mimarinize uygun kurulum dosyasını Multica indirme sayfasından seçin:

Kurulumdan sonra, web'de kullandığınız aynı e-posta ile giriş yapın. Giriş yaptıktan sonra Desktop, kendi paketlenmiş Multica CLI'ını başlatır ve makinede zaten kurulu olan AI kodlama araçlarını algılar.

Masaüstü sekmeleri

Desktop, sekmeleri çalışma alanı başına kaydeder. Örneğin A çalışma alanında üç iş açıp B çalışma alanına geçerseniz, B'nin kendi sekmelerini görürsünüz; A'ya geri döndüğünüzde önceki üç sekme hâlâ orada olur.

Belirli bir kaynak geçerli çalışma alanında yalnızca bir kez açılır. Sekmeler yeniden sıralanabilir, sabitlenebilir ve kapatılabilir; her biri kendi ileri/geri geçmişini ve kaydırma konumunu tutar. Bu dağıtıma ait bir uygulama bağlantısına tıklamak veya onu yapıştırmak, tarayıcıya geçmek yerine bağlantıyı doğrudan bir sekmede açar.

Çıkış yapmak makinede kayıtlı tüm sekmeleri temizler, böylece bir sonraki giriş yapan kişi önceki hesaptan kalan sayfaları asla görmez.

Yerleşik daemon

Giriş yaptıktan sonra Desktop, geçerli Multica servisi için özel bir CLI profili oluşturur ve daemon'ı başlatmak için bunu kullanır. Profil şurada bulunur:

~/.multica/profiles/desktop-<host>/

Terminalde kullandığınız varsayılan profili asla okumaz veya üzerine yazmaz. Elle başka bir daemon'ı da başlatırsanız, Multica bunları ayrı runtime'lar olarak gösterir.

Runtime durumunu ve günlükleri Desktop'ın ayarlarından kontrol edebilirsiniz. Bir araç algılanmıyorsa, önce onun normal bir terminalde çalıştığını ve giriş yapılmış olduğunu doğrulayın, ardından Desktop'ın daemon'ını yeniden başlatın.

Desktop'ı güncelleme

Otomatik güncelleme varsayılan olarak açıktır. Uygulama arka planda yeni sürümleri kontrol eder ve indirir; bir indirme tamamlandığında hemen kurmak için yeniden başlatabilir veya bir sonraki çıkışta kurulmasına izin verebilirsiniz. Otomatik kontrolleri kapatabilir veya Ayarlar → Güncellemeler altından yeni sürümleri elle kontrol edebilirsiniz.

Güncellemeler işletim sistemi ve CPU mimarisine göre dağıtılır:

• Windows arm64 ve macOS x64 (Intel) her biri kendi güncelleme akışını kullanır;
• diğer tüm mimariler varsayılan akışı kullanır;
• uygulama güncelleme akışını otomatik olarak eşleştirir — elle seçim gerekmez;
• Linux'ta otomatik güncelleme yalnızca .AppImage için çalışır; .deb ve .rpm'i eski paketin üzerine yeni bir paket kurarak güncelleyin;
• otomatik güncelleme başarısız olursa, aynı şekilde indirme sayfasındaki eşleşen kurulum dosyasıyla üzerine kurun.

Kendi sunucunuzda barındırılan bir örneğe bağlanma

Desktop varsayılan olarak Multica Cloud'a bağlanır. Kendi sunucunuzda barındırılan bir örneğe bağlanmak için, ev dizininizin .multica klasörü içinde desktop.json dosyası oluşturun:

Bunlar varsayılan konumlardır — ev dizininiz taşınmış veya yönlendirilmişse gerçek yolunu kullanın.

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com"
}

apiUrl arka ucun genel adresidir; zorunludur ve http veya https kullanmalıdır. Diğer iki URL atlanabilir — Desktop bunları otomatik olarak türetir:

• wsUrl: apiUrl şemasını ws veya wss ile değiştirir ve yola /ws ekler;
• appUrl: host api. ile başlıyorsa ve en az üç etikete sahipse (api.example.com → example.com) api. önekini kaldırır; aksi halde apiUrl ile aynı kalır.

Genellikle yalnızca apiUrl yeterlidir. Yalnızca türetme dağıtımınızla eşleşmediğinde açıkça geçersiz kılın; üç yaygın durum:

• web uygulaması ve API farklı alan adlarında;
• WebSocket ayrı dağıtılmış;
• host önek kaldırma kuralına uymuyor (api.local gibi iki etiketli hostlar önekini korur).

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com",
  "appUrl": "https://app.example.com",
  "wsUrl": "wss://ws.example.com/socket"
}

Kaydettikten sonra Desktop'ı yeniden başlatın — dosya yalnızca başlangıçta okunur. İki başarısızlık modu birbirinden farklı görünür, ikisini ayırt etmenin en hızlı yolu budur:

• Dosya bulunamadı (yanlış dizin veya tam olarak desktop.json olmayan bir dosya adı) — Desktop varsayılan Cloud yapılandırmasını kullanır ve herhangi bir hata göstermez. Yani Desktop hâlâ bir Cloud adresi bildiriyor ve ortada bir yapılandırma hatası yoksa, dosya Desktop'ın aradığı yerde değildir.
• Dosya bulundu ama geçersiz — JSON, sürüm veya URL'ler hatalıysa Desktop bir yapılandırma hatası gösterir ve Cloud'a geri dönmez.

Varsayılan Cloud yapılandırmasına dönmek için dosyayı silin ve yeniden başlatın.

Windows: dosya adını ve kodlamayı kontrol edin

İki Windows düzenleyici varsayılanı, Desktop'ın kullanamayacağı bir dosyayı sessizce üretir:

• Not Defteri .txt ekler. desktop.json olarak kaydetmek desktop.json.txt üretebilir; Desktop bunu bulunamadı olarak değerlendirir. Explorer'da dosya adı uzantılarını görünür yapın veya kaydetme diyaloğunda Tüm dosyalar'ı seçin. Gerçek dosya adını görmek için PowerShell'de Get-ChildItem "$env:USERPROFILE\.multica" -Filter "desktop.json*" çalıştırın — Name sütunu tam olarak desktop.json okumalı.
• PowerShell yönlendirmesi UTF-16 veya BOM yazar. > desktop.json ve Out-File, ayrıştırılamayan bir kodlama üretebilir; bu da bir yapılandırma hatası olarak karşınıza çıkar.

İkisinden de kaçınmak için dosyayı PowerShell'den tek adımda oluşturun:

$dir = "$env:USERPROFILE\.multica"
New-Item -ItemType Directory -Force $dir | Out-Null
$json = @'
{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com"
}
'@
[System.IO.File]::WriteAllText("$dir\desktop.json", $json)

Windows Defender, Multica'yı virüs olarak işaretliyor

Belirti: Windows Security, Trojan:Script/Wacatac.B!ml gibi bir tehdit bildirir ve Desktop kurulumu içindeki bir dosyayı karantinaya alır. Etkilenen öğe genellikle uygulamanın yürütülebilir dosyası değil, paketlenmiş CLI'dır:

C:\Users\<you>\AppData\Local\Programs\@multicadesktop\resources\app.asar.unpacked\resources\bin\multica.exe

Bu yanlış bir pozitif sonuçtur. !ml soneki, kararın bir kötü amaçlı yazılım imzasından değil, Defender'ın makine öğrenimi sezgisel yöntemlerinden geldiği anlamına gelir. Multica'nın Windows derlemeleri henüz Authenticode ile kod imzalı değil ve arka plan işlemleri başlatan, ağ bağlantıları açan yeni yayımlanmış imzasız bir ikili dosya, tam olarak bu sezgisel yöntemlerin şüpheli olarak puanladığı profildir. Her Windows artefaktı, bu depodaki genel kaynak koddan GitHub Actions tarafından derlenir.

Kendiniz doğrulayın — her GitHub sürümü, her CLI arşivini kapsayan bir checksums.txt yayımlar:

Get-FileHash .\multica-cli-<version>-windows-amd64.zip -Algorithm SHA256

Karma değerini en son sürümdeki checksums.txt içindeki eşleşen satırla karşılaştırın.

Nasıl düzeltilir:

1. Karantinaya alınan dosyayı geri yükleyin — Windows Security → Virus & threat protection → Protection history → Multica öğesini seçin → Actions → Restore.

2. Bir dışlama ekleyin ki yeniden karantinaya alınmasın — Virus & threat protection → Manage settings → Exclusions → Add an exclusion → Folder, ve ikisini de ekleyin:

   • %LOCALAPPDATA%\Programs\@multicadesktop
   • %APPDATA%\Multica

   Her iki yol da önemlidir: paketlenmiş CLI kaybolduğunda, Desktop %APPDATA%\Multica\bin içine bir yedek indirir, bu yüzden yalnızca kurulum klasörünü dışlamak sizi yedeğin de karantinaya alındığı bir döngüde bırakır.

3. Yanlış pozitifi Microsoft'a bildirin — Microsoft Security Intelligence — submit a file adresinde Software developer ve Incorrectly detected as malware seçeneklerini seçin. Tespitin her kullanıcı için geri çekilmesini sağlayan budur, genellikle birkaç gün içinde.

Sonraki adımlar

• Hızlı başlangıç — ilk bağlantı akışı.
• Daemon ve runtime'lar — yerleşik daemon'ın nasıl çalıştığı.
• Sorun giderme — bağlantı sorunlarını teşhis etme.