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.
9.2 KiB
Projeler ve çalışma ağaçları
Bir proje sekmesi CodeNomad'i arka uç bilgisayarındaki bir klasöre bağlar. Sekme açmak, bir çalışma kopyasına göz atmak ve konuşma ailesini taşımak farklı işlemlerdir.
Bir proje açın
- Ana sayfayı açmak için Yeni instance (
+) öğesine tıklayın. - Klasörlere Göz At öğesini seçin, arka uç klasörünü seçin ve açın; veya Son Klasörler altında bir giriş seçin.
- Depoyu kopyalamak için Git Deposunu Klonla eylemini seçin; Depo URL'si ve Hedef klasör alanlarını doldurup Klonla eylemini seçin.
Uzak bir sunucuya göz atmak, telefonunuzun veya dizüstü bilgisayarınızın değil, o sunucunun dosya sistemine göz atmak anlamına gelir. Bir projeyi açmak, her sekme için ayrı bir OpenCode arka plan programı oluşturmaz. Konuşmalar yerel OpenCode oturumlarıdır; bunların ömrü sekmenin ömrü değildir.
Klonlama hedefe bir depo yazar. Hedef klasör zaten varsa önce onu kaldırın. yıkıcıdır: yalnızca zaten orada olan her şeyin silinebildiği durumlarda etkinleştirin. Emin değilseniz yeni bir hedef kullanın. Başarısız bir klon, mevcut bir projeyi silmek için bir neden değildir; yeniden denemeden önce bildirilen hedefi ve hatayı inceleyin.
Son kullanılan kayıtlar birer kısayoldur. Workspace'i yeniden adlandır görünen adı değiştirir; Son kullanılanlardan kaldır dosyaları veya konuşmaları değil, kısayolu kaldırır. Zaten açık olan bir son kullanılan projeye tıklamak yeni bir sekme açar; mevcut sekmeyi seçmek için bunun yerine projenin Aç düğmesini (Açık projeye geç) kullanın.
Yeni örnek başlatıcıyı kullanın
+'ye uzun basın veya sağ tıklayın; Klavye odağı oradayken Alt+Down, Shift+F10 veya Menü tuşunu kullanın.- Son projeleri arayın veya Gözat…, Geçici veya Klonla… öğesini seçin.
Normal bir tıklama yine de tam ana sayfayı açar. Başlatıcı, yönetim yüzeyi değil, bir kısayoldur: ana sayfadaki son projeleri yeniden adlandırın/kaldırın ve sunucu yer imlerini yönetin. Escape, başlatıcıyı kapatır ve odağı +'ye döndürür.
Bir projeyi kapatın
- Sekmenin kapat düğmesini veya komut paletindeki Sekmeyi Kapat öğesini (arayüzde
Ctrl/Cmd+W) kullanın. - Sekmeyi kapatmak o projeyi CodeNomad'de kapatır: CodeNomad projenin olaylarını ve isteklerini izlemeyi bırakır. Oturumlar OpenCode'da çalışmaya devam eder.
- Konuşmaları yeniden bulmak için klasörü Gözat veya Son Kullanılanlar aracılığıyla tekrar açın.
| Eylem | Kapsam ve etki | Ne yapmaz |
|---|---|---|
| Sekmeyi Kapat | O sekmenin CodeNomad proje bağlantısını kaldırır; aynı klasörde ayrı açılmış başka bir sekme etkilenmez | Proje dosyalarını veya yerel geçmişi silmez, oturumları durdurmaz veya OpenCode'un Location bağlamını kaldırmaz |
| Oturumu durdur | Seçilen görüşmenin yürütülmesi | Projeyi kapatmaz veya geçmişini silmez |
Aynı proje bağlantısını başka bir pencere gösteriyorsa oradaki sekme de kapanır ve o pencere bir bildirim gösterir. Kapatmayı başlatan pencere bildirim göstermez. Kapatma hemen gerçekleşir; arka uç projeyi kapatamazsa bir hata görünür ve ana sayfadaki Açık projeye geç yine projeye ulaşır. Otomatik yeniden deneme yoktur. Kapatılan sekmenin gönderilmemiş taslakları başlangıç geri yüklemesinde korunmaz.
Bir pencerenin tamamını kapatmak, uygulamadan çıkmak veya yeniden yüklemek proje bağlantılarını kapatmaz; normal başlangıç geri yüklemesi yine uygulanır. Yürütmenin bittiğini doğrulamak istiyorsanız ilgili çalıştırmaları açıkça durdurun. CodeNomad yerel Location bağlamlarını hiçbir zaman kaldırmaz; paylaşılan hizmetin bakımı OpenCode kurulumu bölümünde açıklanır.
Geçici çalışma alanları
- Başlatıcıda Geçici öğesini veya ana sayfada Yeni geçici instance öğesini seçin.
- Boş CodeNomad tarafından yönetilen klasörde çalışın; Git otomatik olarak başlatılmıyor.
- Sekmeyi kapatırken Sakla, At veya İptal öğesini seçin. Sekme menüsü ayrıca Proje olarak sakla öğesini de sunar.
| Seçim | Etki | Kurtarma |
|---|---|---|
| Sakla | Projeyi CodeNomad'de kapatır, klasörü ve konuşmaları korur, geçici durumunu kaldırır ve son kullanılan projelere ekler | Son kullanılanlardan yeniden açın; klasör taşınmaz |
| At | Geçici çalışma alanının konuşmalarını ve dosyalarını siler | Geri alma yok; ihtiyaç duyulan her şeyi önce başka bir yere kaydedin |
| İptal | Geçici çalışma alanını açık bırakır | Çalışmaya devam edin veya daha sonra karar verin |
Hiçbir konuşma, dosya veya gönderilmemiş taslak içermeyen, dokunulmamış bir geçici sekme, kapatıldığında sessizce atılır. Açık geçici sekmeler normal başlangıç geri yüklemesine katılır, ancak ana sayfada kapatılan geçici klasörlerin devam ettirilmesi için ayrı bir liste yoktur.
Bir konuşma çalışırken veya klasör başka sekmede/pencerede açıkken At işlemi reddedilir. Önce çalıştırmayı durdurup diğer görünümleri kapatın. Atma başarısız olursa çalışma alanı geçici kalır: üst dizini elle silmek yerine bildirilen sorunu çözüp yeniden deneyin.
Bir çalışma ağacı seçin veya oluşturun
- Bir üst konuşma açıp ileti düzenleyicisindeki çalışma ağacı seçicisini kullanın. Dar yerleşimlerde bu kontrol yalnızca bir ok gösterir.
- Mevcut keşfedilen bir çalışma ağacını seçin veya + Worktree oluştur öğesini seçin.
- Oluşturmak için Ad girin ve Worktree oluştur ve kullan öğesini seçin.
CodeNomad çalışma ağaçlarını OpenCode aracılığıyla keşfeder ve açılan depoya ait olduklarını doğrular. Yeni dal adı seçili çalışma kopyasının HEAD revizyonundan başlar. Mevcut dal adı o dalın güncel revizyonunu kullanır; Git başka yerde kullanıma alınmış dalı reddedebilir. Çalışma ağaçları varsayılan .codenomad/worktrees konumunu kullanır. Commit edilmemiş değişiklikler özgün çalışma kopyasında kalır; oluşturma bunları yeni çalışma ağacına kopyalamaz.
İleti düzenleyicisindeki seçici, üst konuşmayı ve tüm alt konuşmalarını doğrulanmış bir aile olarak taşır. Alt oturum bu seçiciyi bağımsız değiştiremez. Etkin oturumlar işlemi engeller: önce ailenin tamamlanmasını bekleyin veya yürütmesini durdurun. Yeni taşıma istemeden önce mevcut taşımanın sonuçlanmasını bekleyin; hata durumunda yeniden denemeden önce yenilenen konuşma/çalışma ağacı durumunu inceleyin.
Buna karşılık Dosyalar bölümündeki İncelenecek çalışma ağacı yalnızca panelin okuduğu çalışma kopyasını değiştirir. Konuşmayı taşımaz, dal değiştirmez veya sonraki kabuk komutunun çalışacağı yeri değiştirmez.
Bir çalışma ağacını kaldırma
- Arayüz çalışma ağacı listesinde, çıkarılabilir bir dal çalışma ağacı için Worktree sil öğesini kullanın.
- Hedef klasörü inceleyin. Yerel değişikliklerin kaybını kabul etmiyorsanız Zorla sil (yerel değişiklikleri at) seçeneğini kapalı tutun.
- Silme işlemini onaylayın ve ortaya çıkan envanteri kontrol edin.
Silme, çalışma ağacının yerel klasörünü kaldırır. Git'in ana çalışma kopyası silinebilir bir hedef değildir. CodeNomad etkilenen konuşma ailelerini kök çalışma kopyasına geri taşır ve çalışma ağacını kaldırmadan önce yerleşimlerini doğrular; etkin oturumlar kaldırmayı engelleyebilir. Silme, commit edilmemiş dosyaların arşivi veya yedeği değildir.
Git değiştirilmiş/izlenmeyen dosyaları reddederse yeniden denemeden önce bu dosyaları koruyun veya temizleyin. Zorla silme bunları açıkça siler. Kilitli dizinde onu kullanan terminalleri, düzenleyicileri, izleyicileri ve arka plan süreçlerini kapatın. Eksik kayıt için çalışma ağaçlarını yenileyip yeniden denemeden önce yolu inceleyin. Tanılama paylaşımı için hata penceresi Temizlenmiş sürümü kopyala eylemini sunar; temizlenmiş metni bile önce gözden geçirin.
Git'i başlatın veya Git olmadan çalışın
- Git'in mevcut olduğu sıradan bir klasör için Dosyalar → Değişiklikler veya Commitler öğesini açın.
- Git'i başlat öğesini seçin. Ekstra bir onay gerektirmeden anında harekete geçer.
- Proje meta verilerinin ve konuşmalarının yenilenmesini bekleyin; Git, CodeNomad dışında başlatılmışsa Yenile öğesini kullanın.
Başlatma, depoyu üst dizinde değil, açıkça açılan klasörde oluşturur. Commit oluşturmaz. Başarısızlık durumunda yeniden denemeden önce mesajı inceleyip yenileyin: belirsiz yanıt otomatik yeniden gönderilmez.
Arka uç Git'i çalıştıramazsa, konuşmalar ve sınırlı dosya tarama, yalnızca dizin modunda açıkça açılan klasör için kullanılabilir durumda kalır. Worktree işlemleri ve Git başlatma, bu arka uçta Git gerektirir. Bkz. kurulum ve Dosyalar.