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.2 KiB
Sorular ve izinler
OpenCode soruları, Formları ve izin istekleri, konuşma dökümündeki bekleyen araç kartlarında değil, ileti düzenleyicisinin hemen üstündeki istek panelinde yanıtlanır.
İsteği bulun ve kaynağını kontrol edin
- Girdi Gerekiyor / İzin Gerekiyor durumundaki konuşmayı seçin veya istek panelini yerinde açmak için proje istek rozetini tıklayın.
- Genişletmeden veya yanıtlamadan önce istek türünü, konuşma başlığını ve kaynağını okuyun.
- Birkaç istek beklemede olduğunda Önceki istek / Sonraki istek öğesini kullanın. Sohbeti görüntüle öğesini yalnızca kaynağına gitmek istiyorsanız kullanın.
| Kaynak | Anlam ve davranış |
|---|---|
| Açık konuşma | İsteği normal biçimde genişletilebilir |
| Kaynak: … üst konuşması belirtilen alt ajan | Açık konuşmanın özyinelemeli alt konuşması yerel bağlamdır; üst konuşma bilgisi görünür kalır |
| Diğer konuşma | Kompakt bir önizleme olarak başlar; Mevcut görüşmeden ayrılmadan yanıtlamak için açıkça genişletin |
| Proje isteği / Hizmet isteği | Formun sahibi olan bir konuşma bulunmayabilir; uydurma konuşma bağlantısı gösterilmez |
Yeni istekler düzenlediğiniz isteği değiştirmez veya başka yere yönlendirmez. Kuyruk yenilendiğinde seçim aynı istekte kalır; oklar uçtan başa dönmez. Sonuçlandırmadan sonra ilgisiz başka konuşmanın isteği siz açana kadar küçük önizleme halinde kalır.
İstekleri daralt içeriği gizler; hiçbir şeyi reddetmez, iptal etmez veya yanıtlamaz. Genişletilmiş düzenleyici, kayıtlı boyut veya taslağı değiştirmeden ileti düzenleyicisini geçici olarak en düşük yüksekliğe indirir. İçerik sabit yanıt eylemlerinden bağımsız kaydırılır.
Soruları ve Formları yanıtlayın
- Amaçlanan isteği genişletin ve alanlarını doldurun veya sunulan seçenekleri seçin.
- Bir seçim alanı özel yanıtlara izin verdiğinde ek bir metin alanı gösterilir: sunulan bir seçenek yerine kendi yanıtınızı buraya yazın (veya çoklu seçim alanına özel değerler ekleyin). Gerekli tüm soruları yanıtlayın.
- Gönder öğesini seçin; İptal öğesini yalnızca yerel iptali istediğinizde bir soru veya Form için kullanın.
Kısmi yanıtlar ve ret taslakları çalışan istemcide kuyruk yenilemeleri ve konuşma değişimleri boyunca korunur. Bunlar gönderilmiş karar veya istemci verileri temizlendikten sonra kurtarma garantisi değildir. Başarısız yanıt düzenlenebilir kalır; yeniden denemeden önce bekleyen isteği inceleyin. CodeNomad yanıtı otomatik yeniden göndermez.
Bazı Formlar, tarayıcı akışı için Harici formu aç sağlar. Açılan sayfayı başarılı bir yanıt olarak değerlendirmek yerine isteğin talimatlarını izleyin ve durumuna geri dönün. Rastgele sağlayıcı/yetkilendirme Formlarının mutlaka konuşma eserleri olması gerekmez.
Tamamlanan OpenCode soru araçları geçmişte soruyu, seçili yanıtı, seçenek açıklamalarını ve özel metni aynen gösterir. Diğer seçenekler seçilmeyen alternatifleri erişilebilir tutar. Bu tamamlanmış sonuçlar canlı istek panelinden ayrıdır.
Bir izni onaylama veya reddetme
- İstenen işlemi, kaynakları ve İstenen diff öğesini okuyun. Hangi görüşmenin kararı alacağını kontrol edin.
- İsteğe bağlı olarak bir reddi veya daha güvenli bir alternatifi açıklayan geri bildirimi girin.
- Bir Kez İzin Ver, Her Zaman İzin Ver veya Reddet öğesini seçin.
| Seçim | Yerel etki | Güvenlik sınırı |
|---|---|---|
| Bir Kez İzin Ver | Bu izin isteğini onaylıyor | İlgisiz gelecekteki operasyonlar için genel onay değil |
| Her Zaman İzin Ver | Geçerli oturum bağlamında eşleşen istekler için OpenCode kalıcı onay seçimini gönderir | CodeNomad veya işletim sistemi genelinde güven anahtarı değildir; yetkilendirilen kaynağı/deseni inceleyin |
| Reddet | İsteğe bağlı geri bildirimle isteği reddeder | Bu istekten önce gerçekleştirilen işi geri almaz |
İzin onayı araç yürütmesini hemen serbest bırakabilir. Bu bir deneme çalıştırması değildir. Fark/okuma sınırları ve kaynak kimliği kontrolleri, istenen içerik doğrulanamadığında onayı engelleyebilir; başka işlemi varsayımla onaylamak yerine gerçek isteği yenileyip inceleyin.
Başka istemci isteği sonuçlandırırsa burada kaybolabilir. Zaman aşımı veya başarısız yanıt, OpenCode hizmetinin kararı kabul edip etmediğini kanıtlamaz: yeniden bilinçli seçim yapmadan önce bekleyen istek uzlaştırmasının paneli güncellemesini bekleyin. Belirsiz yanıt asla uydurma doğrulanmış karar olarak gösterilmez.
İzin makbuzlarını okuma
- Yerel araç kartları gizlenmiş olsa bile, ilgili konuşma dökümü içeriğinin yanında İzin kararları öğesini arayın.
- Kaynak mesajı olmayan kararlar için Oturum izin kararları öğesini açın.
- Devam etmek için Daha fazla karar yükle öğesini veya okuma hatasından sonra Yeniden dene öğesini kullanın.
Karar kayıtları bilinen istekleri/kaynakları, doğrulanmış kararı ve mevcut gerekçe/kaynak bilgisini kaydeder. CodeNomad'da verilen karar, Otomatik · Yolo ve Yerel karar gözlemlenen kaynakları ayırır; OpenCode'da sonuçlandırılmış olması bu pencerede kullanıcının tıkladığının kanıtı değildir.
Karar kayıtları OpenCode mesajı veya izin kuralı düzenleyicisi değil, salt okunur CodeNomad açıklamalarıdır. OpenCode tam geçmiş araması, mesaj kopyalama ve dışa aktarmaya dahil edilmezler. CodeNomad çevrimdışıyken kaçırılan kararları yeniden kuramazlar; başarılı araç sonucu eksik kaydın yerine geçmez. Oturumun silinmesi karar kayıtlarını da kaldırır.
Yolo modu ve aile kapsamı
- Bir görüşme seçin ve Durum → Yolo Modu öğesini açın.
- Yalnızca otomatik izin onayının tüm aile için kabul edilebilir olması durumunda etkinleştirin.
- Güvenilmeyen çalışmalara devam etmeden önce onu devre dışı bırakın; Bekleyen istekleri ve halihazırda çalışan araçları inceleyin.
Kontrol bir oturumu belirtse de etkili kapsamı çözümlenen aile kökü ve alt konuşmalarıdır: alt oturumdan açmak/kapatmak o aileyi etkiler. OpenCode çatallaması kendi kökü sayılır. Her proje veya bağımsız konuşma için genel onay değildir.
Yolo yalnızca izinleri onaylar. Soruları veya Formları yanıtlamaz, eksik bilgi sağlamaz, başarılı yürütme garantisi vermez veya arka uç sahiplik kontrollerini aşmaz. Otomatik onayı CodeNomad arka ucu yapar: arka uç açıkken tek pencereyi kapatmak bunu devre dışı bırakmaya yetmez; durmuş arka uç istek onaylayamaz. Aile ayarı kalıcı kaydedilir ve çalışma alanı yeniden yüklendiğinde geri alınır.
Yolo'nun kapatılması halihazırda kabul edilmiş bir kararı iptal etmez veya dosya/ağ etkilerini geri almaz. Otomatik · Yolo makbuzlarını inceleyin ve gerekirse yürütmeyi açıkça durdurun. İnsan kapılarıyla otomasyon için bkz. Görevler.
Eksik veya eski istekleri kurtarma
- Bağlantı göstergesini kontrol edin ve aynı arka uca/projeye yeniden bağlanın.
- Kurtarmanın bekleyen yerel istekleri uzlaştırmasına izin verin; Kapsamın eksik olması durumunda bilinen talepler ve taslaklar korunur.
- Sorular ve izinler tam olarak kurtarılamadı uyarısı görünürse, projeyi, nedeni, klasörleri ve etkilenen oturumları belirtir. Bu nedeni giderin (örneğin silinmiş bir çalışma ağacı veya bu projenin dışında çalışan bir oturum); bir sonraki kurtarma geçişi otomatik olarak yeniden dener.
Kurtarma, yalnızca istekleri numaralandırmak için etkin olmayan her çalışma ağacını yüklemez. Eksik bir yanıt, yetkili bir boş kuyruk değildir ve uyarı, bir istemin, yanıtın veya onayın tekrarlanmasına izin vermez. Yapılandırmanın yeniden yüklenmesi yerel Formları/izinleri iptal edebilir; bunu rutin bir istek yenileme düğmesi olarak kullanmayın. Bkz. Sorun Giderme ve OpenCode kurulumu.