mirror of https://github.com/NeuralNomadsAI/CodeNomad.git synced 2026-10-22 14:22:22 +00:00

docs(help): bring the user guide back in line with the current app (#1079 )

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.

2026-10-21 14:38:29 +02:00

11 KiB

Raw Permalink Blame History

Konuşmalar

CodeNomad, yerel OpenCode oturumlarını, devredilen işler için bir hiyerarşi ve bir sonraki göndereceğiniz şey için ayrı kontrollerle konuşmalar olarak sunar.

Mesajlar Markdown, kod, farklar ve desteklenen araç sonucu görüntülerini işler. Metin kopyalama, tam geçmiş araması ve seslendirme gömülü görüntü baytlarını değil, metin izdüşümünü kullanır. Mesaj içeriği saklanan parçaları silmeden görünürlüğü değiştirir; Geçmiş görünüm kontrolleriyle temizliği ayırır.

Akıl yürütme ve araç başlıkları her adımın ne kadar sürdüğünü gösterir; süre, adım çalışırken canlı olarak sayılır ve bir saniyenin altındaki süreler gösterilmez. Mesaj içeriği içinde Tokenlar gösterildiğinde (Her şey hazır ayarı bunu gösterir), her ajan mesajı son metninden sonra tek bir token ve maliyet satırıyla biter. Bu satır, yüklenmiş konuşma dökümü içinde mesajı ve Bu yanıttan araçları ve akıl yürütmeyi kaldır eyleminin kapsadığı araçları ve akıl yürütmeyi içeren mesajları toplar; akıl yürütme ve önbellek sayıları için satırı genişletin. Yalnızca araç çalıştıran adımların kendi satırı yoktur.

Konuşmaları bulma ve gezinme

Session'lar altında satır seçin veya üst konuşma başlatmak için Yeni session eylemini kullanın.
Alt oturumlarını görmek için üst konuşmanın okunu genişletin. Kapalı ok, alt konuşmalarının en acil durumunu gösterir: girdi bekliyor, çalışıyor veya yakın zamanda bitti (boşta); araç ipucu bunları sayar.
Listeyi daraltmak için Session ara…, Ana oturumlar / Alt oturumlar, çalışma ağacı filtresini ve Etkinlik, Ad veya Çalışma ağacı sıralamasını kullanın.
Görüntülediğiniz konuşmaları yeniden ziyaret etmek için kenar çubuğundaki Geri ve İleri öğesini kullanın.

Normal gezinme hiyerarşiktir; arama/filtre sonuçları her konuşmanın kendi kimliği ve çalışma ağacıyla düz listelenir. Yeni çalışmaya başlayan alt oturum yalnızca etkin konuşmanın ailesi altında otomatik gösterilir. Dalı kapatmak o anda çalışan alt konuşmaların otomatik gösterimini kaldırır.

Geri/İleri, liste sırası değil, proje sekmesi başına, pencere başına ziyaret geçmişidir. Bellekte tutulur, kullanılamayan/silinmiş konuşmalar atlanır ve yeniden başlatıldıktan sonra geri yüklenmez. Geri döndükten sonra yeni bir görüşme seçmek ileri yolun yerini alır. Paletin Önceki Session / Sonraki Session'si bunun yerine görünür listeyi döndürür.

Ajan, Model ve Düşünme seçimi

Göndermeden önce ileti düzenleyicisinin altındaki ajan ve model seçicilerini kullanın.
Model varyant sunuyorsa Düşünme düzeyini seçin; Varsayılan OpenCode varsayılanını kullanır.
Bir sonucu teşhis ederken sonraki istemi gönderin ve yanıtın aracı/model meta verilerini kontrol edin.

Yeni bir konuşma, siz başka birini seçmedikçe OpenCode'un varsayılan olarak çözümlediği ajanla başlar; bu varsayılanı bir eklenti belirleyebilir. Seçicilerin araç ipuçları kısayollarını gösterir.

Bunlar daha önceki yanıtlara yönelik düzenlemeler değil, sonraki gönderimlere yönelik yürütme seçenekleridir. Eski bir zaman çizelgesi pasajını okumak, ileti düzenleyicisinin mevcut seçimlerini tarihsel meta verilerle değiştirmez. Model görünürlüğü, sık kullanılanlar ve sağlayıcı bağlantıları Sağlayıcılar'de yönetilir.

Taslaklar ve ekler

Seçili konuşmada yazın. Konuşma değiştirmek taslağı göndermez, korur.
Bu cihazdaki dosyalar için ileti düzenleyicisinin Diğer eylemler menüsünde Dosya ekle… öğesini seçin ya da dosyaları bırakın veya yapıştırın; proje dosyalarını, aracıları veya becerileri seçmek için @ yazın.
Ek çiplerini inceleyin ve bir sonraki gönderimde kullanılması amaçlanmayan her şeyi kaldırın.

Giriş	Kaynak ve etki
Cihaz eki	Seçici, bırakma veya pano, kullanıcı arayüzünü çalıştıran cihazdaki baytları okur; bu bir sunucu yolu değil
Proje `@` referansı	Çalışma ağacı dahil konuşmanın arka uçtaki projesi/Location bağlamında çözümlenir
Ajan anma	Geçmiş mesajları değiştirmeden seçili ajan referansını ekler
Beceri	Location bağlamının becerilerini ada/açıklamaya göre arar ve çıkarılabilir bir beceri seçimi ekler

Cihaz dosyalarının okunabilir olması ve ek bütçesine uygun olması gerekir: her biri en fazla 5 MiB, 10 dosya ve toplamda 20 MiB. Reddedilen bir dosya eklenmez; Tüm seçimin başarılı olduğunu varsaymak yerine bildirimi inceleyin.

Bir beceri seçildiğinde @query jetonu kaldırılır ve bir çip eklenir. Gönderme işlemi, OpenCode tarafından gönderilen mesajla birlikte depolanan talimatları değil, ileti düzenleyicisi seçimini temizler. Geçmiş mesajlar beceri etiketlerini korur. Kuyruğa alınmış bir istemi düzenlerken bir beceriyi kaldırmak, onun yeni gönderimden kaldırılmasını sağlar.

Masaüstünde gönderme, klavye odağını konuşmaya taşır; böylece oklar, sayfa tuşları ve Boşluk konuşmayı kaydırır. Bir karakter yazmak, o karakterle birlikte ileti düzenleyicisine döner. Diğer eylemler içindeki Prompt metnini temizle (varsayılan Ctrl/Cmd+K) ileti düzenleyicisinin taslağını temizler.

Taslaklar paylaşılan OpenCode mesajları değil, istemci çalışma durumudur. Başlangıçta geri yükleme desteklenen ileti düzenleyicisi durumunu koruyabilir; ancak gönderilmemiş taslak veya eki yedek saymayın ve başka cihazda göründüğünü varsaymayın. Başlangıç verilerini temizlemeden veya geri yüklemesi kapalı istemciyi kapatmadan önce önemli metni kaydedin; bkz. Masaüstü.

Komutlar ve Shell modu

/ yazın ve bulunan özel bir komutu seçin, ardından bağımsız değişkenlerini sağlayın.
Doğrudan kabuk komutu için boş ileti düzenleyicisinin başına ! yazarak Shell modu durumuna geçin.
Komutu gönderin. Shell modundan çalıştırmadan çıkmak için Escape veya boş alanda Backspace kullanın.

Yalnızca bilinen eğik çizgi komut adları özel komut yolunu kullanır; bilinmeyen /text sıradan istemdir. Özel komutlar OpenCode tanımlarını kullanır. Dosya/görüntü ekleri bu yolla gönderilmez ve sonraki istem için kalır; argümanlarda kullanılan yapıştırılmış metin argümanlara çözümlenir.

Shell modu, modelin bir komut önerme isteğini değil, yerel bir oturum kabuğu isteğini çalıştırır. Yürütme ana bilgisayarında dosyaları değiştirebilir ve işlemleri başlatabilir. Profil ortamı ayarları bir sonraki istemden, özel komuttan veya kabuk isteğinden önce uygulanır; mevcut bir hizmeti yeniden başlatmazlar. Bkz. Entegrasyonlar ve OpenCode kurulumu.

Takipleri yönlendirin, sıraya koyun ve düzenleyin

Ayarlar → Genel bölümünde, oturum meşgulken gönderilen takipleri kuyruğa almak için Gönderilen istemleri kuyruğa al seçeneğini açın; çalışan görevi yönlendirmek için kapalı bırakın (varsayılan).
Oturum meşgulken bu davranışı kullanarak bir takip gönderin. Diğer davranış için ileti düzenleyicisinin Diğer eylemler menüsünde Mesajı kuyruğa ekle veya Şimdi yönlendir öğesini seçin ya da alternatif gönderme kısayolunu kullanın (Windows ve Linux'ta varsayılan Alt+Enter, macOS'ta Cmd+Shift+Return; bkz. Kısayollar).
İstem kuyruğunda, giriş hala beklemedeyken Şimdi yönlendir, Kuyruğa al, Kuyruktaki promptu düzenle veya Kuyruktaki promptu kaldır öğesini kullanın.

Teslimat	Etki
Yönlendir	Devam eden yürütme için yerel yönlendirme girişi
Kuyruk	Sonradan işlenmek üzere tutulan OpenCode takip girdisi

Oturum boşta ise normal gönderme, bu anahtardan bağımsız olarak standart hemen gönderme yolunu kullanır ve Diğer eylemler alternatifi kullanılamaz. Düzenleme bekleyen istemi ve kaldırılabilir eklerini ileti düzenleyicisine getirir; Düzenlemeyi iptal et düzenleme akışından çıkar. OpenCode tarafından işlenmiş istem artık düzenlenebilir bekleyen kayıt değildir. Kaydı kaldırmak yapılmış işi geri almaz.

Kuyruk güncellemesi başarısızsa yeniden denemeden önce güncel kuyruğu inceleyin. Kabul, modelin takip girdisini işlediğinin kanıtı değildir; yeniden bağlanmak tekrar gönderme izni vermez.

/btw ile yan soru sorun

Mevcut bir görüşmede /btw your question'yi veya yan soru penceresini açmak için /btw'yi gönderin.
Cevabı okuyun, Yanıtı kopyala öğesini kullanın veya beklemedeyken Soruyu iptal et öğesini seçin.
İşiniz bittiğinde pencereyi kapatın.

Bu, oturum bağlamını kullanan ayrı bir model isteğidir. Bir araç döngüsü çalıştırmaz, eylemde bulunmaz veya sorusunu/cevabını konuşmaya eklemez. Dosya/resim ekleri ileti düzenleyicisinde kalır; Soruda kullanılan yapıştırılan metin metin olarak dahil edilir. Bu yeni ve kalıcı bir konuşma ya da işi dağıtmanın alternatif bir yolu değil.

Kapatmak ana oturumu kesmeden bekleyen yan isteği iptal eder. Etkin konuşmadan ayrılmak bu geçici pencereyi temizler; gerekeni önce kopyalayın. Boş/hatalı yanıtlar konuşma mesajına dönüşmeden burada gösterilir.

Başarısız bir çalıştırmayı çatallayın, geri alın ve kurtarın

Bir mesajda, bu noktadan sonra orijinali değiştirmeden bir konuşma oluşturmak için Bu mesajdan sonra fork'la öğesini seçin.
Geri almak için Buraya kadarki değişiklikleri geri al (mesajları siler) öğesini dikkatlice inceleyin. Palet, aşamalı geri alma için Son Mesajı Geri Al ve Son Mesajı Yinele öğesini sunuyor.
Yürütme başarısız olursa, tekrar göndermeden önce Session hatası öğesini, yanıt hatasını ve tüm Gönderme başarısız ayrıntılarını inceleyin.

Çatallama seçilen noktaya kadar konuşma bağlamını kopyalar; Git çalışma ağacı oluşturmaz veya dosyaları yalıtmaz. Geri alma yalnızca gezinme değildir. Devam etmeden önce dosya etkilerini ve geri alma sınırını inceleyin; özgün akışı yeniden yazmadan alternatif konuşma istiyorsanız çatallama kullanın.

Geri sayım içeren bir Yeniden deneniyor durumu, OpenCode'un bir sağlayıcı hatasını kendiliğinden yeniden denediği anlamına gelir; tekrar göndermek yerine bekleyin veya oturumu durdurun. Başarısız gönderme, daha yeni yazdıklarınızın üzerine yazmayacaksa denenen taslağı ve ekleri geri getirir. Başarısız çalıştırma araçları zaten yürütmüş olabilir: yeniden denemeden önce Dosyalar, bekleyen istekler ve OpenCode etkinliğini inceleyin. Mesajları yeniden yükle veya Session'ı yeniden yükle durumu okur; değişiklik işlemini tekrarlama talimatı değildir. Session'ı durdur yürütmeyi keser, dosya veya dış hizmet değişikliklerini geri almaz.

11 KiB Raw Permalink Blame History Unescape Escape