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
Doğrudan uzaktan erişim
Doğrudan erişim, sunucu şifresini kullanarak CodeNomad'in HTTP/HTTPS dinleyicilerine bağlanır. Uzaktan Kontrol'den farklıdır: eşleştirme için LAN bağlantısı veya gelen bağlantı noktası gerekmez ve her iki yol da sessizce diğerine geri dönmez.
Bir erişim yolu seçin
| Yol | Neyi yönetiyorsun |
|---|---|
| Aynı makine tarayıcısı | Geridöngü bağlamayı koruyun; yazdırılan yerel URL'yi kullanın. |
| LAN veya VPN | Erişilebilir bir arayüz bağlayın, güvenlik duvarını amaçlanan istemcilerle sınırlandırın ve güvenilir HTTPS'yi kullanın. VPN, CodeNomad dinleyicisini sizin için yapılandırmaz. |
| SSH yönlendirme | Arka uç geridöngüsünü bağlı tutun; gerçek yazdırılan bağlantı noktasını iletin. Tünel aktarımı korur ancak CodeNomad kimlik doğrulamasının yerini almaz. |
| Ters proxy | Arka ucu özel/geri döngü arayüzünde tutun; güvenilir TLS'yi proxy'de sonlandırın, yukarı akış atlama noktasını koruyun ve uzun ömürlü SSE'yi ve doğrudan erişim araçlarınızın ihtiyaç duyduğu tüm WebSockets'yi destekleyin. |
| Uzaktan Kontrol | Cihazı ana bilgisayardan eşleştirin; Daha dar yüzeyi ve kullanım ömrü için Uzaktan Kontrol'ye bakın. |
Bağlama, güvenlik duvarı kuralları, bağlantı noktası yönlendirme, DNS veya VPN oluşturmaz. Kimliği doğrulanmamış bir HTTP dinleyicisini İnternette yayınlamayın. Çalışma alanı kökü bir güvenlik korumalı alanı değildir; sunucuyu açığa çıkarmadan önce Güvenlik bölümünü okuyun.
Doğrudan erişimi etkinleştir
- Ana bilgisayarda Ayarlar → Uzak Erişim öğesini açın ve Doğrudan erişim (yerel ağ, gelişmiş) öğesini genişletin.
- Sunucu şifresi altında Şifre belirle veya Şifreyi değiştir eylemini seçin; Yeni şifre ve Şifreyi onayla alanlarını doldurup Şifreyi kaydet eylemini seçin. Çalışma zamanından sağlanan parola burada değiştirilemez; bkz. Güvenlik.
- Dinleme modu altında Diğer IP'lerden bağlantılara izin ver öğesini açın. Yeniden başlatma uyarısını okuyun ve yalnızca geçici kesintiye hazır olduğunuzda Şimdi yeniden başlat öğesini seçin.
- Yeniden başlattıktan sonra Yenile öğesini kullanın ve Erişilebilir adresler öğesini kontrol edin. Ulaşılabilir HTTPS adresini diğer cihazda açın veya ana bilgisayarda QR göster öğesini seçip diğer cihazla tarayın ve ardından oturum açın.
Bu, tek projeyi veya Uzaktan Kontrolü değil, ana bilgisayarın doğrudan dinleme modunu değiştirir. Sunucu localhost dışını dinlerken bölüm kendiliğinden açılır. Otomatik yeniden başlatma yoksa CodeNomad'i elle yeniden başlatın; bağımsız kurulumlarda başlangıç --host ayarı tutarlı olmalıdır. Dış erişimi kaldırmak için anahtarı kapatıp yeniden başlatın veya CLI'yi loopback bağlamasıyla başlatın. Bu, eşleştirilmiş Uzaktan Kontrol cihazlarını iptal etmez.
Dinleyici bağlama matrisi
--host varsayılan olarak 127.0.0.1'ye ayarlanır; localhost bu adrese normalleşir. Etkin dinleyiciler için aşağıdaki kurallar geçerlidir:
| Başlatma/mod | HTTP şuraya bağlanır: | HTTPS bağlanır |
|---|---|---|
| Bağımsız, yalnızca HTTPS (varsayılan) | Yalnızca özel geri döngü dinleyicisi (aşağıya bakın) | --host |
| Bağımsız, yalnızca HTTP | --host, LAN/joker karakter adresi dahil |
Etkin değil |
| Bağımsız, her iki dinleyici | 127.0.0.1, --host'den bağımsız olarak |
--host |
| Yerel masaüstü arka ucu | HTTP dinleyicisi, ana bilgisayar dahili dinleyicisi de dahil olmak üzere 127.0.0.1'de kalır |
HTTPS etkinleştirildiğinde --host |
Her arka uç, Görevler gibi CodeNomad'in kendi paketlenmiş OpenCode eklentileri için 127.0.0.1 üzerinde ayrıca bir HTTP dinleyicisi tutar. HTTP istenmediğinde veya istenen HTTP dinleyicisi 127.0.0.1 ya da 0.0.0.0 dışında bir adrese bağlandığında, arka uç rastgele bir 127.0.0.1 portunda özel bir HTTP dinleyicisi ekler. Bu dinleyici hiçbir zaman yazdırılmaz veya bağlantı adresi olarak sunulmaz, başka makinelerden erişilemez ve aynı kimlik doğrulamalı uygulamayı sunar.
Somut bir LAN adresinin geridöngü bağlantılarını kabul etmesi gerekmez. 0.0.0.0, tüm IPv4 arayüzleri anlamına gelir; :: çift yığınlı joker karakter dinleyicisidir. Bir tarayıcıda joker karakter değil, gerçek ulaşılabilir bir adres kullanın. IPv6 bölge tanımlayıcıları --host'de desteklenmez.
Bağımsız bir HTTPS dağıtımı için, önyükleme prosedürü aracılığıyla bir parola ayarlayın ve ardından şunu çalıştırın:
codenomad --host 0.0.0.0 --https=true --http=false
Yalnızca geri döngü HTTP için, örneğin yerel güvenilir bir proxy'nin arkasında:
codenomad --host 127.0.0.1 --https=false --http=true
9898 veya 9899 portunu varsaymayın: belirtilmeyen portlar doluyken başka port kullanılabilir. Açıkça verilen sıfır olmayan --https-port veya HTTP etkinken --http-port portu sabitler ve bağlanamazsa başarısız olur; 0 işletim sisteminden port atamasını ister. Yazdırılan Local Connection URL ve Remote Connection URL ile yenilenen Erişilebilir adresler o çalıştırma için yetkili bilgidir. Tam sunucu CLI başvurusuna bakın.
Güvenilir TLS'yi yapılandırın
Kendi sertifikanızı sağlayın
- Subject Alternative Names (SANs) alanı istemcilerin gerçekten kullandığı ana bilgisayar adını veya IP adresini kapsayan sertifika edinin.
- Hem
--tls-key <path>hem de--tls-cert <path>'yi PEM dosyaları olarak sağlayın. Dağıtımınızın bir CA zincirine/paketine ihtiyacı varsa--tls-ca <path>'yi ekleyin. - CodeNomad'i yeniden başlatın ve istemci aygıtından sertifikayı ve yazdırılan HTTPS adresini doğrulayın.
Özel sertifika dosyaları başlangıçta okunur ve CodeNomad bunları asla yeniden yazmaz. Yenileme ve yenilenen dosyaları yüklemek için yeniden başlatma sizin sorumluluğunuzdadır. --tlsSANs oluşturulan sertifikaları yapılandırır; sağlanan sertifikaya ad ekleyemez. Özel anahtarları koruyun ve yalnızca ana bilgisayar kimliğini doğruladığınız sertifikalara güvenin.
Oluşturulan yerel CA'yı kullanın
HTTPS etkinken ve anahtar/sertifika çifti sağlanmadığında, CodeNomad, yapılandırma tabanı altında yerel bir CA ve sunucu sertifikası oluşturur:
| Dosya | Amaç |
|---|---|
tls/ca-cert.pem |
Yönettiğiniz istemcilere güvenli bir şekilde dağıtmak için genel CA sertifikası. |
tls/ca-key.pem |
CA özel anahtarı; asla dağıtmayın. |
tls/server-cert.pem |
Sunucu sertifikası. |
tls/server-key.pem |
Sunucu özel anahtarı; asla dağıtmayın. |
--tlsSANs "host.example.test,192.0.2.10"kullanarak istemciye yönelik tüm DNS adlarını/IP'lerini ekleyin. Joker karakter bağlama, SANs için tüm LAN adreslerinizi keşfetmez.- Sertifikayı oluşturmak/yeniden kontrol etmek için arka ucu yeniden başlatın.
- Ana makineyi/CA'yı güvenilir bir kanal aracılığıyla doğrulayın ve ardından yalnızca CA sertifikasını amaçlanan her istemci/tarayıcı güven deposuna aktarın. Alternatif olarak genel olarak güvenilen bir sertifika veya TLS ters proxy kullanın.
Oluşturulan sunucu sertifikası 30 gün geçerlidir. Başlangıçta, bitimine üç gün veya daha az kaldığında, gerekli SANs eksikse, sertifika kontrolleri başarısızsa veya özel anahtar dosyası yoksa yenilenir. Oluşturulan CA 365 gün geçerlidir; süresi dolunca, sertifika kontrolleri başarısızsa veya özel anahtarı yoksa değiştirilir; değiştirilmesi sunucu sertifikasını da yeniden üretir. Mevcut bozuk, okunamayan veya eşleşmeyen özel anahtarlar otomatik onarılmaz. İstemciler yeni CA'ya güvenmelidir. Süreç içinde sürekli yenileme yoktur: uzun süre çalışan kurulumlarda süre dolmadan bilinçli yeniden başlatma planlayın.
Bir istemci bir sertifika uyarısı bildirirse, durdurun ve ana bilgisayar adını, SANs'yi, güven deposunu ve son kullanma tarihini kontrol edin. Doğrulamayı devre dışı bırakmayın veya uyarılara tıklamayı dağıtım prosedürünüz haline getirmeyin. Güvenilir HTTPS, PWA kurulumu ve mikrofon erişimi gibi uzak tarayıcı özellikleri için de gereklidir.
Uzak sunucuyu kaydedin
- Masaüstü ana sayfasında CodeNomad Sunucusuna Bağlan öğesini seçin. Aynı düğme boş bir Sunucular sekmesinde ve Ayarlar → Uzak Erişim → Sunucular bölümünde de bulunur.
- Sunucuya Bağlan penceresinde, güvenilir bir HTTPS kaynağını kullanarak Sunucu adı ve Sunucu URL'si öğesini girin. Kendinden imzalı sertifikalar için TLS doğrulamasını atla. öğesini işaretlemeden bırakın; bunun yerine güven oluşturun.
- Yer imlerine eklemek için Kaydet öğesini veya kaydedip açmak için Bağlan öğesini seçin. Bu sunucuda oturum açın.
Kayıtlı bir sunucuyu yeniden açmak için ana sayfanın Sunucular sekmesinde onu seçin. Yer imleri uzak sunucunun projelerine değil, bu CodeNomad yapılandırmasına aittir. Bir URL'nin kaydedilmesi sunucuyu başlatmaz veya erişim sağlamaz. Kayıtlı sunucuyu kaldır, uzak konuşmaları, arka ucu veya kimlik bilgilerini değil, yer işaretini kaldırır.
Uzaktan Kontrol için bunun yerine Sunucu URL'si öğesine yeni bir eşleştirme bağlantısı yapıştırın. Yer imi yalnızca tünelin kökenini korur, asla tek kullanımlık eşleştirme kodunu içermez; Cihaz çerezi kaybından sonra yeniden eşleştirme için bkz. Uzaktan Kontrol.