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.7 KiB
Uzaktan Kontrol
Uzaktan Kontrol, eşleştirilmiş bir tarayıcının veya masaüstü istemcisinin, gelen bir ağ bağlantı noktasını açmadan çalışan CodeNomad arka ucunuzu kullanmasına olanak tanır. Sunucu parolası, geridöngüsüz --host veya VPN gerektirmez. Bu, doğrudan bağlantılardan ayrı bir erişim yoludur.
Başlatın ve eşleştirin
- Ana bilgisayarda Ayarlar → Uzak Erişim öğesini açın.
- Uzaktan Kontrolü başlat öğesini seçin. Uzak bağlantılar için hazır öğesini bekleyin; ilk kullanımda tünel kimliğinin ve sertifikasının sağlanması zaman alabilir.
- Başka bir cihaz bağla altında, QR kodunu tarayın veya Bağlantıyı kopyala öğesini seçin, ardından amaçlanan cihazda o tek kullanımlık bağlantıyı açın.
- Eşleştirilen tarayıcının site verilerini saklayın. Arka uç çalışırken yeniden bağlanmak için tünel adresini yeniden açın.
Bağlantı beş dakika süreyle geçerlidir ve bir kez başarılı olur. Bunu bir kimlik bilgisi olarak değerlendirin: Bunu tüketen herkes eşleştirilmiş bir cihaz haline gelebilir. Kod, sorgu dizesinde değil, URL parçasında bulunur. Yeni eşleştirme bağlantısı oluştur, önceki kullanılmayan bağlantıyı anında geçersiz kılar. Durdurma, arka uç kapatma ve tünel arızası, bekleyen eşleştirme bağlantılarını iptal eder.
Başka masaüstü CodeNomad istemcisini eşleştirmek için onun ana sayfasında CodeNomad Sunucusuna Bağlan öğesini seçin, bağlantıyı Sunucu URL'si alanına yapıştırıp Bağlan eylemini seçin. Eşleştirme bağlantısı Kaydet ile bile penceresini açar, çünkü bağlantıyı açmak kodu tüketir. Yer imi yalnızca tünelin origin adresini saklar; kod saklanmaz. Eşleştirme bağlantılarında TLS doğrulaması etkin kalır.
Eşleştirilmiş cihazları yönetin
- Ana bilgisayarda Ayarlar → Uzak Erişim → Uzaktan Kontrol öğesine dönün.
- Eşleştirilmiş cihazlar ve Son görülme zamanlarını inceleyin. Her cihaz, onu eşleştiren platform ve tarayıcıya göre adlandırılır; örneğin
iPhone · Safari. - Artık bağlanmaması gereken cihaz için İptal et eylemini seçin.
İptal, cihazın mevcut HTTP/SSE bağlantılarını ve gelecekteki erişimini sonlandırır. Yeniden erişim için yeni bağlantıyla eşleştirin. Cihazın süresi 30 gün kullanılmadığında dolar. 32 cihaz sınırında, yeni eşleştirme en uzun süredir görülmeyen cihazın yerini alır ve bağlantılarını kapatır.
Arka uç, ham cihaz kimlik bilgilerini değil, kimlik bilgisi karmalarını kendi yapılandırma tabanı altında remote-control-devices.json'de saklar. İstemci, ana bilgisayar kapsamlı Secure, HttpOnly, SameSite=Lax cihaz çerezine sahiptir. Tarayıcının ömrü, sunucunun 30 günlük hareketsizlik sınırından daha uzun olabilir; kayıt defteri yetkili kalır. Site verilerini temizlemek, tarayıcı profillerini değiştirmek veya özel taramayı kullanmak yeniden eşleştirme gerektirebilir.
Doğrudan erişim parolasını değiştirmek cihazları iptal etmez. Uzaktan Kontrolü durdur tünelin bağlantısını keser ancak eşleştirilmiş cihaz listesini korur; yetkiyi kaldırmak için İptal et eylemini kullanın.
Yerinizi kaybetmeden yeniden eşleştirin
- İstemci Bu cihazı yeniden eşleştirin gösterirse bu sayfayı açık bırakın.
- Ana bilgisayarda Yeni eşleştirme bağlantısı oluştur öğesini seçin ve aynı istemci tarayıcısında/profilinde açın. Kaydedilmiş bir masaüstü sunucusu için, yeni eşleştirme bağlantısını kullanarak yeniden bağlanın, böylece mevcut uzak pencere depolama alanı yeniden kullanılabilir.
- Bekleme sayfasına dönün ve Bağlantıyı kontrol et öğesini seçin; sayfa yeniden odak kazandığında da kontrol tekrarlanır.
Kurtarma, açık sayfayı ve taslakları korur; başarısız bir eylemi tekrarlamaz. Yeniden denemeden önce bir gönderme, yanıtlama veya silme işleminin etkili olup olmadığını kontrol edin. Doğrudan erişim parolası Uzaktan Kontrol eşleştirmesini kurtaramaz.
Kullanılabilirlik ve kullanım ömrü
| Eylem/durum | Etki |
|---|---|
| Uzaktan Kontrolü başlat | Bu arka ucu bağlar ve sonraki başlatmalar için seçimi hatırlar. |
| Uzak tarayıcıyı kapatın | Ana bilgisayar arka ucunu durdurmaz veya cihazı iptal etmez. |
| Uzaktan Kontrolü durdur | Erişimi keser ve başlangıçta otomatik sürdürme tercihini temizler; cihaz kayıtlarını korur. |
| Arka uç kapatma / son masaüstü penceresi kapatılır ve uygulama sonlandırılır | Uzaktan Kontrol çevrimdışı oluyor. OpenCode'un paylaşılan hizmeti çalışmaya devam edebilir ancak bu kullanıcı arayüzüne durdurulmuş bir arka uç aracılığıyla hizmet veremez. |
| Uzaktan Kontrol başlatıldıktan sonra başlat | Yeni bir eşleştirme bağlantısı vermeden arka planda yeniden bağlanır. Hiç başlatılmayan kurulumlar kendilerini etkinleştirmez. |
| Başlangıçta sürdürmenin başarısız olması veya kritik tünel hatası | Hatırlanan tercih korunur ve ana bilgisayar hatayı gösterir; Uzaktan Kontrol kartının yenileme simgesi durumu yeniden okur. Uzaktan Kontrolü başlat hemen yeniden dener; Uzaktan Kontrolü durdur tercihi temizler. Aksi halde sonraki başlatma yeniden dener. |
Başlangıçta otomatik sürdürme yapılandırma dizini başına tek arka uçla sınırlıdır. Ek tünel kapasitesi için aynı yapılandırmayla birbiriyle yarışan ana bilgisayar süreçleri başlatmayın. Masaüstünden çıktıktan sonra erişilebilir kalması gereken ana bilgisayar için ayrıca yönetilen bağımsız sunucu kurun; Uzaktan Kontrol bağımsız bir daemon değildir.
Mevcut ve mevcut olmayan yüzeyler
Eşleştirilen cihazlar sıradan proje/konuşma API'lerini kullanabilir, istemler gönderebilir, dosyaları inceleyebilir ve aynı sahiplik kontrollerine tabi olan izinleri/Formları yanıtlayabilir. Eşleştirme, salt okunur bir paylaşım bağlantısı değil, güçlü bir erişimdir. Tünel trafiği ana bilgisayar üzerinde dahili olarak iletse bile hiçbir zaman geridöngü ayrıcalıkları vermez.
| Yüzey | Uzaktan Kontrol üzerinden |
|---|---|
| Normal kimlik doğrulamalı kullanıcı arayüzü, çalışma alanları, konuşmalar ve SSE | Eşleştirilmiş bir cihazda kullanılabilir. |
| Parolayla giriş/çıkış, parola değişiklikleri, yerel belirteç önyüklemesi | Mevcut değil; doğrudan kimlik doğrulama devre dışı bırakılsa bile cihaz kimlik bilgileri gereklidir. |
| Uzaktan Kontrol durumu | Eşleştirilmiş bir cihaz tarafından okunabilir; yönetim mevcut değildir. Başlat/Durdur, eşleştirme oluşturma, cihaz listesi ve iptal etme, ana bilgisayar erişim yolunda kalır. |
| Masaüstü uzak pencere/sunucu yönetimi ve proxy rotaları | Kullanılamıyor (/api/remote-servers/, /api/remote-proxy/). |
| SideCar içerik proxy'si | Kullanılamaz (/sidecars/). Bu, tüm SideCar API'lerinin engellendiği anlamına gelmez: eşleştirilmiş istemciler yine de /api/sidecars kayıt API'lerine erişebilir. |
| Önizleme içeriği ve otomasyon köprüsü | Kullanılamaz (/previews/, /api/opencode-plugin/). Native masaüstü yetenekleri tarayıcı yeteneğine dönüşmez. |
| WebSocket yükseltmeleri | Uzaktan Kontrol girişinde kullanılamaz. |
Bir iş akışı engellenmiş bir proxy/WebSocket yüzeyi gerektirdiğinde uygun şekilde korunan bir doğrudan bağlantı kullanın. Uzaktan Kontrol otomatik olarak bu yola geçmez.
Aktarma ve gizlilik
CodeNomad OpenTunnel kullanır ve makinenin ortak varsayılan tünel kimliğinde rastgele bir rota alır. Durdurmak, diğer uygulamaların kullandığı ortak kimliği değil, CodeNomad köprüsünü serbest bırakır.
TLS, CodeNomad arka ucunda sonlanır. Röle şifreli metni iletir ve uygulama içeriğini okuyamaz ancak ana bilgisayar adlarını, bağlantı zamanlamasını ve trafik boyutlarını gözlemleyebilir. Tünel sertifikası/özel anahtar ana bilgisayarda kalır. Ana bilgisayarın tünel depolamasını ve CodeNomad yapılandırmasını kimlik bilgileri olarak koruyun; Tahmin edilemeyen bir adres yetkilendirme değildir.
CODENOMAD_REMOTE_CONTROL_API, kendi barındırdığınız OpenTunnel API hizmetini seçer; tanımsızsa barındırılan hizmet kullanılır. Bu, eşleştirme gereksinimlerini veya engelli yüzeyleri değil, tünel kurulumunu değiştirir. Kimlik bilgileri ve tanılama işlemleri için Güvenlik sayfasına bakın.