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.8 KiB
Dosyalar ve Git
Dosyalar sağ panel sekmesi çalışma kopyasına göz atmayı, yerel değişiklikleri ve commit geçmişini birleştirir. Satır seçmek merkezi okuyucuyu açmaktan farklıdır.
Çalışma kopyasına göz atın
- Dosyalar öğesini açın ve Çalışma alanı öğesini seçin.
- Başka çalışma kopyası istiyorsanız İncelenecek çalışma ağacı seçimini değiştirin; klasörleri gerektiğinde genişletin.
- Dosya satırını tıklayarak seçin. Merkezi önizlemeyi açıp kapatmak için göz simgesini kullanın.
- Görünür anlık görüntünün yeniden kontrol edilmesi gerekiyorsa Yenile öğesini kullanın.
| Mod | Okur | Konuşma üzerindeki etkisi |
|---|---|---|
| Çalışma alanı | Göz atılan çalışma kopyasındaki dosyalar | Oturumu taşımaz veya dalı kullanıma almaz |
| Değişiklikler | Dizin ve çalışma ağacı değişiklikleri | Git değişiklik işlemleri yalnızca açık eylemlerle gerçekleşir |
| Commitler | Sayfalandırılmış commit geçmişi ve revizyon içerikleri | Salt okunur geçmiş; çalışma kopyasını değiştirmez |
Genişletilmiş klasörler mod değişikliklerinden etkilenmez. Listeleme/durum/geçmiş, önbelleğe alınmış anlık görüntüleri kullanır ve ilgili dosya sistemi değişiklikleri, etkinleştirme veya açık yenileme sonrasında yeniden doğrulanır; panele odaklanmak yeni bir okuma garantisi değildir. Görünür Çalışma alanı klasörleri, arka uç ana bilgisayarında oluşturulan, düzenlenen, yeniden adlandırılan veya silinen dosyaları kendiliğinden algılar; sürekli etkinlik sırasında bu en fazla beş saniyede bir olur. Daraltılmış klasörler ve diğer çalışma ağaçları yalnızca onları gösterdiğinizde yeniden okunur.
Satır eylemleri arasında Yolu kopyala ve istemcinin arka uç yollarının açılmasını desteklediği durumlarda Varsayılan uygulamayla aç, Klasörde göster, Dosya yöneticisinde aç ve Burada terminal aç gibi dosya yöneticisi/düzenleyici/terminal eylemleri bulunur. Alan sınırlı olduğunda eylemler {name} için daha fazla eylem öğesine taşınabilir; dosya veya klasör adı {name}'nin yerine geçer. Uzak bir tarayıcı, sunucu yolunun yerel aygıt yolu olduğunu varsayamaz; bkz. Uzaktan Kontrol.
Kaynağı düzenleyin ve güvenle kaydedin
- Çalışma Alanındaki bir metin dosyasını göz simgesiyle açın.
- Markdown için düzenleme yapmak üzere Kaynağı göster, işlenmiş görünümü okumak üzere Markdown'ı önizle eylemini seçin.
- Düzenleyin ve Kaydet öğesini seçin veya düzenleyici odaklanmışken Ctrl/Cmd+S tuşuna basın.
- Dosya harici olarak değiştiyse üzerine yazma onayını inceleyin; taslağınızı bu değişikliğin üzerine yazmadan saklamak için İptal öğesini seçin.
Kaydetme, bağlantılı çalışma ağacı dahil göz atılan çalışma kopyasındaki gerçek dosyaya yazar; istem göndermez veya düzenlemeyi stage/commit etmez. Kaydetmeden önce yetkili dosya yeniden okunur. Çakışma penceresi Dosya agent tarafından değiştirildi. Agent'ın değişikliklerinin üzerine yazılsın mı? der; diğer harici yazıcıların değişikliklerine de aynı özeni gösterin.
Kaydedilmemiş kaynak taslakları okuyucu kapatıldığında veya değiştirildiğinde, proje örneği, dizin ve yol kapsamında arayüz belleğinde korunur. Dosya sistemi yenilemeleri bunları sessizce değiştirmez. Bu kalıcı dosya deposu değildir: istemciyi yeniden başlatmadan/yüklemeden önce önemli düzenlemeleri kaydedin veya kopyalayın. Okuma/yazma hataları taslağı korur. Açık Yenile eylemi kaydedilmemiş düzenlemeleri atmadan önce uyarır.
Okuyucunun sonundaki kapatma düğmesi konuşmaya döner; ileti düzenleyicisi okuyucunun altında kullanılabilir kalır. Oturumu/çalışma ağacını değiştirmek seçili okuyucuyu temizler, taslağı kaydetme garantisi vermez. Tarayıcı önizlemesi okuyucunun yerini alır; dosya açmak bu görünümü sohbet moduna döndürür.
Salt okunur ve sınırlı önizlemeler
- Göz eylemiyle bir görüntüyü, ikili dosyayı veya geçmiş değişikliği açın.
- Bir fark için, gerektiği şekilde Bölünmüş görünüme geç / Birleşik görünüme geç, sözcük kaydırma ve değişmemiş bölge kontrollerini kullanın.
- Sohbete geri dönmek için okuyucuyu kapatın.
| İçerik | Mevcut davranış |
|---|---|
| Markdown kaynağı dahil çalışma alanı metni | Açık Kaydet ile düzenlenebilir |
| Çalışma alanı resmi | Salt okunur resim önizlemesi |
| Diğer ikili içerik | Salt okunur, önizlemenin kullanılamadığını belirten alternatif görünüm |
| Değişiklikler/Commitler metin farkı | Her iki tarafı da düzenlemeyen salt okunur karşılaştırma |
| Git görüntü farkı | Tam olarak karşılaştırılan revizyonlardan önceki/sonraki görüntüler |
Önizleme okumaları sınırlıdır; büyük/desteklenmeyen içerik sınırsız yüklenmek yerine kullanılamaz olabilir. Geçmiş görüntülerin yerine hiçbir zaman mevcut çalışma ağacı dosyası kullanılmaz. Önizleme hatası dosyanın yokluğunu göstermez. Yalnızca önizleme almak için revizyonu değiştirmeden dosyayı uygun harici uygulamada açın.
Stage, unstage ve commit işlemleri
- Değişiklikler öğesini seçin ve Staged Değişiklikler ile Değişiklikler öğesini inceleyin.
- Dosyayı stage et / Dosyayı unstage et öğesini kullanın, karşılık gelen seçili dosyalar eylemi için birkaç satır seçin veya satırları bölümler arasında sürükleyin.
- Staged Değişiklikler öğesinin üst kısmına bir mesaj girin ve ardından Commit öğesini seçin.
Daraltılmış bölüm başlıkları sürükle-bırak hedefi olmaya devam eder. Bölümleri daraltmak veya mod değiştirmek durumlarını ve commit mesajı taslağını korur. Uzun bir bölüm ilk 200 dosyasını gösterir, ardından sonrakileri yerinde açmak için 200 tane daha göster ile birlikte 480 dosya gösterilmiyor gibi bir satır gelir; bölüm sayıları tam toplamları göstermeye devam eder ve geçerli, önizlenen ve seçili dosyalar görünür kalır. Shift ile tıklanarak seçilen aralıklar yalnızca gösterilen satırları kapsar; böylece toplu bir eylem göremediğiniz bir dosyayı asla içermez. Stage/unstage göz atılan çalışma ağacının indeksini değiştirir; commit yalnızca stage edilmiş içeriği kaydeder. Unstage, çalışma ağacındaki düzenlemeyi geri almaz.
Özellikle ajanlar veya başka istemci de aynı yere yazıyorsa commit öncesinde stage edilmiş dosyaları inceleyin. Başarısız commit otomatik yeniden gönderilmez. Yeniden denemeden önce durumu/geçmişi yenileyip hatayı inceleyin; kayıp yanıt hiçbir commit oluşmadığının kanıtı değildir.
Commit geçmişini okuyun
- Commitler bölümünü seçip mesajını ve değişen dosyalarını okumak için bir commit seçin.
- Yüklenen seti filtrelemek için Yüklenen commitleri filtrele… öğesini veya başka bir sayfa getirmek için Eski commitleri yükle öğesini kullanın.
- Değişen dosyayı göz simgesiyle açın.
Metin geçmişi commiti ilk üst commitiyle (kök committe boş bir tabanla) karşılaştırır. HEAD'i değiştirmez veya oturumları taşımaz. Yüklenen commitleri filtrelemek sunucu genelinde Git günlüğü araması değildir. Yeni commitlerden sonra güncel geçmişten başlamak için yenileyin; mevcut sayfalama başlangıçtaki geçmiş anlık görüntüsünü korur.
Boşluk ve satır sonları
- Ayarlar → Gelişmiş → Yalnızca boşluk değişikliklerini gizle öğesini açın.
- Değişiklikler listesinden gizlenen, yalnızca boşluk içeren stage edilmemiş düzenlemeleri incelemek istiyorsanız ayarı kapatın.
- Commit öncesinde gerçek farkı ve stage edilmiş içeriği inceleyin.
Ayar varsayılan olarak açıktır. Ana etkisi, uygun stage edilmemiş, izlenen metin değişikliklerini Değişiklikler listesinden, sayılardan, seçimden, toplu stage ve sürükleme işlemlerinden gizlemektir. Gizlenen dosyalar stage edilmeden kalır. Stage edilmiş dosyalar ile izlenmeyen, eklenen/silinen/yeniden adlandırılan ve ikili dosyalar görünür kalır. Algılama başarısızsa veya desteklenmiyorsa tahmin etmek yerine dosyalar görünür tutulur.
Git'in liste algılaması iç boşlukları, yalnızca CRLF değişikliklerini ve eklenen/kaldırılan son yeni satırları göz ardı edebilir. Fark okuyucunun boşluk karşılaştırması daha dardır: girinti ve sondaki boşluklar/sekmeler, iç boşlukların tamamı değil. Stage ve Commit, görüntüleme tercihinden bağımsız olarak her zaman tam içerik üzerinde hareket eder.
Satır sonu ve bayt sırası işareti farklılıkları, vurgulanan satırlar yerine gerçeklere dayalı bir not üretebilir. Ayarın kapatılması, düzenleyicinin her satır sonu/BOM değişikliğini veya her aynı uzunluktaki sondaki boşluk değişimini çizmesini sağlayamaz. Görsel olarak boş bir fark, aynı baytların kanıtı değildir.
Git'i başlat
- Değişiklikler veya Commitler öğesini depo olmayan bir klasörde açın.
- Git'i başlat öğesini seçin; onay gerekmeden hemen çalışır.
- Proje/oturum yenilenmesini bekleyin; hazır olduğunuzda stage ve commit işlemlerini açıkça yapın.
Başlatma .git dizinini açıkça açılan klasörde oluşturur; üst dizini başlatmaz veya ilk commiti oluşturmaz. Arka uçta Git yoksa yalnızca dizin konuşmaları ve Çalışma Alanına göz atma kullanılabilir kalır; başlatma ve Git işlemleri kullanılamaz. Belirsiz hata durumunda yeniden denemeden önce yenileyin; başlatma isteği otomatik yeniden gönderilmez. Bkz. Projeler.