1dabb5110f
docs(help): bring the user guide back in line with the current app The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer. Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages. The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English. Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
8.8 KiB
Masaüstü pencereleri ve veriler
Pencereler, sekmeler ve paylaşılan hizmet
- Geçerli pencerede başka bir proje/ana sayfa sekmesi açmak için Yeni instance öğesini kullanın.
- Ayrı bir uygulama penceresi için yerel Pencere → Yeni pencere (
Ctrl+Shift+NveyaCmd+Shift+N) kullanın. - Ayarlar → Gelişmiş bölümünde, başka bir başlatmanın yeni bir pencere açmak yerine en son kullanılan pencereye odaklanması gerekiyorsa İkinci başlatmada mevcut pencereye odaklan öğesini etkinleştirin.
Proje sekmeleri, seçilen konuşmalar ve düzen bir pencereye aittir. OpenCode oturumları/mesajları paylaşılan yerel OpenCode hizmetine aittir: aynı konuşmayı başka bir pencere görebilir. Proje sekmesini kapatmak projeyi CodeNomad'de kapatır, OpenCode oturumlarını kapatmaz; onları yeniden bulmak için projeyi tekrar açın. Aynı proje bağlantısını gösteren başka bir pencere de sekmesini kapatır ve bir bildirim gösterir; aynı klasörün ayrı açılmış sekmeleri etkilenmez. Bir pencerenin tamamını kapatmak, uygulamadan çıkmak veya yeniden yüklemek proje bağlantılarını geri yükleme için korur; bkz. Projeler. Kapanan pencereleri bir temsilcinin veya planlanmış Görevin durduğunun kanıtı olarak kullanmayın.
Yerel uygulama menüleri, bir pencere yüklendikten sonra CodeNomad'ın arayüz dilini kullanır; o zamana kadar İngilizce görünür. Yardım → CodeNomad hakkında (macOS uygulama menüsünde de bulunur), sürüm, güncellemeler ve tanılamayla birlikte Ayarlar → Bilgi bölümünü açar.
Tercihler ve başlangıç geri yüklemesi
- Yapılandırmak istediğiniz pencereden Ayarlar'ı açın. Yerel masaüstü giriş noktaları, açıcının projesi/Location ile tek yerel Tercihler penceresine odaklanır.
- Genel bölümünde Önceki durumu geri yükle öğesini açın veya kapatın.
- Bu pencerenin kayıtlı düzenini unutmak için Kaydedilen başlangıç durumunu temizle öğesini kullanın. Onay istemeden hemen uygulanır.
Geri yükleme, çalışma alanı/SideCar sekmelerini ve etkin oturumları, gönderilmemiş metni, kaydırma konumlarını, panelleri, pencere yerleşimini ve yakınlaştırmayı yeniden açabilir. Bu, yerel konuşma veritabanının bir kopyası değil, pencere başına istemci durumudur. Temizlendiğinde kayıtlı sekmeler, taslaklar ve düzen kaldırılır; CodeNomad yapılandırmasını veya OpenCode konuşmalarını silmez. Gönderilmemiş önemli taslakları önce başka bir yere kaydedin.
Tercihler penceresinin ayrı bir geri yükleme durumu yoktur: bu kontroller, Tercihler'i açan pencereyi hedefler. Bu pencere kapanmışsa veya Tercihler başlangıçta yeniden açıldığı için bilinmiyorsa, kontroller en son kullanılan pencereyi izler; başka bir pencere için hazırlanan değişiklik asla uygulanmaz, kontroller önce yeni pencerenin değerini gösterir. Belirli bir pencereyi yapılandırmak için Tercihler'i o pencereden açın. Proje kapsamlı ayarlar aynı şekilde açıcının Location'sini kullanır; biri olmadan kullanılamaz durumda kalırlar. Tercihler başlangıçta yeniden açıldığında, bu ayarlar ilgili proje açılmayı bitirince yeniden bağlanır; klasör hâlâ başlatılırken veya birkaç sekmede açıkken, Tercihler'i amaçlanan pencereden açana kadar kullanılamaz kalırlar.
Tarayıcı ve uzak istemci ayarları, ikinci bir native Preferences sahibi açmak yerine istemciye gömülüdür. Native Preferences açılış hatası bildirilir; bunun yerine gizli bir gömülü ayar ekranı açıldığını varsaymayın.
Açıkça seçilen masaüstü veri profilleri
Açık profil seçilmediyse paketlenmiş başlatmalar o yapılandırma için hatırlanan profili kullanır. Hatırlanan seçim yoksa uygulama varsayılan, dev ve dev-v2 profillerinde geri yüklenebilir durum arar: tek adayı seçer, birden fazlaysa sorar, yoksa varsayılanı kullanır. Seçim profil verilerini taşımaz, birleştirmez veya silmez. Başka profili açıkça açmak için CODENOMAD_PROFILE kullanın.
- Kasıtlı masaüstü izolasyonu için, yürütülebilir dosyayı başlatmadan önce
CODENOMAD_PROFILE'yi ayarlayın. - Bir harf veya rakamla başlayan, 1-64 arası ASCII harf/rakam, nokta, alt çizgi veya kısa çizgiden oluşan bir ad kullanın. Adlar küçük harfe göre normalleştirilmiştir;
defaultveyastablevarsayılan profili seçer. - Adlandırılmış bir profil için Ayarlar → Bilgi → Veri profili öğesini kontrol edin. Geçersiz bir ad, başka bir profil seçmek yerine başlatmayı engelliyor.
Örneğin, PowerShell'de istenen masaüstü yürütülebilir dosyasını başlatmadan önce:
$env:CODENOMAD_PROFILE = "review"
Bağımsız bir sunucu yapılandırması için başlatmadan önce CLI_CONFIG'yi de ayrı bir yapılandırma dosyasına ayarlayın. Varsayılan ~/.config/codenomad/config.yaml'dir. Profil adı tek başına o dosyayı veya paylaşılan OpenCode hizmetini değiştirmez.
| Masaüstü veri profiliyle yalıtılmış | Otomatik olarak izole edilmedi |
|---|---|
| Pencere/sekme geri yükleme durumu, gönderilmemiş taslaklar ve masaüstü tekil/arka uç kapsamı | OpenCode oturumları, mesajları, sağlayıcı kimlik bilgileri ve yürütme |
| Platform sınırları içinde profile ait native Chromium/WebView depolaması | Yapılandırma paylaşılmışsa CodeNomad yapılandırması/tercihleri, ses hizmeti anahtarları, SideCars ve uzantı etkinleştirmesi |
| Ana makinesi/profili içindeki yerel önizleme depolaması | Açılan projelerdeki dosyalar; uzak sunucuların verileri |
macOS Tauri'de kapsamlı profiller sistem WebKit depolama alanını, oturum açma işlemlerini ve önbelleğini paylaşır; hesap güvenliği izolasyonu olarak profil adlarını kullanmayın. Electron, web verilerini profilinde saklar. Yüklü sürüm ve Güncelleme akışı asla başka bir veri profili seçmez. Paketlenmemiş geliştirme lansmanları, açıkça seçilmediği sürece dev profilini kullanır.
Diğer kayıtlı profilleri sil
- Yerel Ayarlar → Genel bölümünde, Önceki durumu geri yükle öğesinin altında Diğer kayıtlı profiller öğesini bulun. Yalnızca makinede başka profiller mevcut olduğunda görünür.
- Gerekirse listeyi yenileyin, Sil… öğesini seçin ve listelenen hedefleri ve atlanan profilleri okuyun.
- Yalnızca ihtiyacınız olan taslakları/oturum açma bilgilerini koruduktan sonra onaylayın. Yeniden denemeden önce eksik kaldırma raporlarını inceleyin.
Silme işlemi, başka bir yapılandırmadan listelenen profiller de dahil olmak üzere diğer profillerin kayıtlı sekmelerini, taslaklarını, düzenini ve sahip olunan web depolama/önbellek/oturum açma bilgilerini kaldırır. Açık profili, OpenCode konuşmalarını ve proje dosyalarını korur. Açık veya bilinmeyen durum profilleri atlanır; Açıkça yenileyip yeniden denemeden önce ilgili CodeNomad pencerelerini kapatın. Tanınmayan içerik, genel olarak silinmek yerine saklanır ve raporlanır.
macOS Tauri'nin ortak WebKit deposu korunur; silinmesi diğer profilleri etkilerdi. Bu temizlik geri alınamaz: korunan OpenCode konuşması, silinmiş gönderilmemiş taslağı geri getirmez. Yalnızca güncel pencereyi sıfırlamak istiyorsanız Kaydedilen başlangıç durumunu temizle daha dar kapsamlı eylemdir.
Yakınlaştırma ve panel geometrisi
- Yerel Görünüm → Yakınlaştır, Uzaklaştır veya Gerçek boyut kullanın; klavye/tekerlek girişi de ana bilgisayar desteğini takip eder.
- Paneller arasında geçiş yapmak için sabit dış başlık köşelerinde Sol panel ve Sağ panel öğesini kullanın. Bu düzen izin verdiğinde çekmeceleri sabitleyin/sabitlemeyi kaldırın.
- Kontroller artık sığmıyorsa yakınlaştırmayı azaltın veya pencereyi genişletin; dar düzenler kontrolleri menülere ve panelleri kaplamalara taşır.
Ana yerel ve uzak masaüstü pencereleri, uygulama yakınlaştırmasına göre ölçeklenen ve monitörün çalışma alanıyla sınırlanan en az 390 × 600 CSS pikselini ayırır. Yakınlaştırma çok küçük bir pencereyi büyütebilir; uzaklaştırmak zaten daha büyük olanı küçültmez. Tercihler ve tarayıcı önizleme alt öğelerinin ayrı boyut kuralları vardır.
Paneller, yüzmeden önce minimum bir konuşma genişliği bırakır. Konuşma genişliğinin 420 CSS pikselinin altında, zaman çizelgesi gizlenir ve başlık eylemleri taşma menüsünü kullanır; kaydedilen zaman çizelgesi tercihi korunur. Bu geometri değişiklikleri istem taslağınızı veya yerel oturumunuzu değiştirmez. Bkz. Ayarlar ve düzen ve Tarayıcı önizlemeleri ve SideCars.