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.
6.9 KiB
Güncellemeler
Yayın akışını seçin
- Ayarlar → Bilgi → Güncellemeler öğesini açın.
- Güncelleme akışı öğesini Kararlı sürümler veya Önizleme ve kararlı sürümler olarak ayarlayın.
- Kurulumu kabul etmeden önce güncellemeleri yenileyin/kontrol edin ve sunulan sürümü inceleyin.
Akış, CodeNomad sunucu yapılandırmasına kaydedilir ve yalnızca hangi sürümlerin sunulduğu değişir. Masaüstü veri profillerini, taslakları, pencereleri, OpenCode oturumlarını veya hizmet yapılandırmasını değiştirmez. Açık bir seçim olmadan, önizleme etiketli derlemeler varsayılan olarak önizlemelere, diğer derlemeler ise kararlıdır.
Kararlı akış en son nihai sürümü seçer. Geliştirme derlemeleri aynı temel sürüm numarasını paylaşabildiğinden önizleme akışı yayımlanma sırasını izler; yalnızca sayısal sürümleri karşılaştırmayın. Bir önizleme sürümü ancak tüm derlemeleri yayımlandıktan sonra sunulur. Önizleme paketleri yayımlanmadan önce davranışı sınamak isteyenler içindir; yeniden başlatmadan önce sürüm notlarını inceleyip önemli taslakları koruyun.
Masaüstü kurulumunu güncelleme
- Yardım → Güncellemeleri denetle… öğesini, güncelleme bildirimini veya Ayarlar → Bilgi → Güncellemeler içindeki düğmeyi kullanın.
- Electron'de sürüm sayfasını takip edin ve kullandığınız ana bilgisayar/platformun arşivini/paketini edinin.
- Uygun yerel Tauri kurulumlarında yerel teklifi inceleyin ve açıkça Yükle ve yeniden başlat öğesini seçin.
- Kurulumdan/yeniden başlatmadan önce her pencerede önemli çalışmaları kaydedin ve yeniden başlattıktan sonra Bilgi öğesini doğrulayın.
| Tauri kurulumu | Uygulama içi yükleme uygunluğu |
|---|---|
| Windows x64 NSIS kurulumu | Yerleşik güncelleyici anahtarı ve imzalı sürüm verisi ile desteklenir. |
| macOS x64 / arm64 uygulaması | Yerleşik güncelleyici anahtarı ve imzalı bir .app.tar.gz verisi ile desteklenir. |
| Linux x64 AppImage | AppImage paket işaretçisi ve boş olmayan bir APPIMAGE yolunun yanı sıra imzalı güncelleme desteği gerektirir. APPRUN tek başına yetersizdir. |
| Debian/RPM, bağımsız Windows yürütülebilir dosyası, imzasız/anahtarsız derleme | Uygulama içi yükleme yerine sürüm sayfasını açar. |
Tauri uygulama pencerelerinde ve yerel Tercihler pencerelerinde, bir sürüm sunulduğunda Güncellemeler bölümü Güncellemeyi yükle düğmesini gösterir. Seçilen akışı kontrol eder ve uygulama içi güncelleme mevcutsa Yükle ve yeniden başlat seçeneğini sunar; aksi halde bölümde gösterilen sürüm sayfasını açar. Electron, web ve uzak pencereler ise yerel güncelleyici kontrolü olmadan Güncellemeyi indir bağlantısını gösterir.
Tauri'nin Yardım → Güncellemeleri denetle… menüsü güncelleme akışını odaktaki uygulama penceresinde çalıştırır. Tercihler veya uzak bir pencereden kullanıldığında, kontrolü çalıştırmak için en son kullanılan uygulama penceresini öne getirir; uzak pencere üzerinden kurulum yapmaz. Hedeflenen pencerenin yükleme, oturum açma veya eşleştirme ekranı göstermesi dahil, eylemi alabilecek bir uygulama penceresi yoksa menü bunun yerine sürüm sayfasını açar.
Tauri yalnızca seçilen akış/hedef için yayınlanmış bir güncelleme bildirimine sahip sürümleri yükler. Duyurulan bir sürüm henüz yüklenemiyorsa bildirim bunun yerine yayın sayfasını açar. Kurulumdan önce yerel imza doğrulaması gereklidir. Güncelleyici imzaları, işletim sistemi noter onayı/kod imzalama güvencelerinden farklıdır.
Kurulum uygulamayı değiştirmeden/yeniden başlatmadan önce tüm uygulama pencerelerinin durumunu diske kaydeder ve kendisine ait CodeNomad arka ucunu durdurur. Bağımsız yönetilen OpenCode daemon'ı bu kapatmaya dahil değildir. CodeNomad kapalıyken dönene kadar arka uca bağlı özellikler kullanılamaz; süren OpenCode oturumundan kesintisiz arayüz hizmeti sonucu çıkarmayın.
Bir kontrol meşgulse diğer pencerenin çalışmasını bekleyin. İndirme, doğrulama veya kapatma hataları için hatayı okuyun ve yeni bir kontrol yapın; eski bir bildirim, eski baytları yeniden yükleme lisansı değildir. Başarısız bir kurulum, arka ucu geri yükleyebilir ve pencereleri yeniden yükleyebilir ve kurulumu otomatik olarak yeniden yürütmez. Yerel kurulum kullanılamıyorsa uygun paketin yayın sayfasını kullanın; bkz. Kurulum.
Bağımsız bir sunucuyu güncelleme
- CodeNomad'i nasıl başlattığınızı belirleyin ve bu arka uca bağlı tüm çalışmaları kaydedin.
- Bu CodeNomad sunucu işlemini normal işlem/hizmet kontrolünü kullanarak durdurun.
- Aynı paket kurulumunu güncelleyin, ardından amaçlanan yapılandırma ve bayraklarla yeniden başlatın.
| Başlatma/yükleme yöntemi | Güncelleme komutu |
|---|---|
| Tek seferlik kararlı npm lansmanı | npx @neuralnomads/codenomad@latest normal bayraklarınızla |
| Küresel kararlı kurulum | npm install -g @neuralnomads/codenomad@latest |
| Yerel kararlı kurulum | Bu paket dizinindeki npm install @neuralnomads/codenomad@latest |
| Tek seferlik önizleme lansmanı | npx @neuralnomads/codenomad-dev@latest normal bayraklarınızla |
| Küresel/yerel önizleme kurulumu | @neuralnomads/codenomad-dev@latest'yi aynı genel/yerel npm formuyla yükleyin |
Halihazırda çalışan bir işlem, npm yüklediği için yeni kodu almaz. Aynı yapılandırma yolunu kasıtlı olarak koruyun; Ayarlar'da bir yayın seçilmesi, npm paketinizin yerini almaz veya kararlı/önizleme paketi adlarını otomatik olarak değiştirmez. Yeniden başlatırken kimlik doğrulama/TLS işaretlerini koruyun; bkz. Sunucu.
OpenCode bakımını ayrı tutun
CodeNomad'in güncellenmesi, seçilen OpenCode CLI'nin güncellenmesi anlamına gelmez. CLI'nin güncellenmesi, çalışan paylaşılan arka plan programını yeniden başlatmıyor. Yerel yapılandırmanın yeniden yüklenmesi, yüklenen Konumlar ve istekler üzerinde kendi etkileri olan başka bir açık işlemdir.
Masaüstü Node/npm kaynakları uygulamayla gelir; bunların güncellemeleri uygulama sürümüyle sunulur. Bu, sistem Node/npm kurulumunu, Electron dahili çalışma zamanını, platform web görünümünü veya bağımsız yönetilen OpenCode hizmetini değiştirmez.
Çalışma zamanı seçimi, kurulum/güncelleme ve açık hizmet kontrolleri için Ayarlar → OpenCode öğesini kullanın. Özellikle diğer pencereler/kullanıcılar veya Görevler arka plan programını paylaştığında, yeniden başlatmadan veya yeniden yüklemeden önce OpenCode kurulumu'yi kontrol edin. Bir güncelleme/yeniden bağlanma bitti diye belirsiz bir istemi veya değişiklik işlemini asla tekrarlamayın.