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.1 KiB
Ses girişi ve oynatma
Konuşmayı yapılandırın
- Ayarlar → Konuşma öğesini açın. Konuşma kartı, görüşmenizin model sağlayıcısından bağımsız olarak OpenAI uyumlu bir sunucu tarafı bağdaştırıcısı kullanır.
- API anahtarı öğesini, isteğe bağlı olarak Temel URL, Transkripsiyon modeli, Konuşma modeli ve Varsayılan ses öğesini girin.
- Giriş ve çıkış farklı hizmetlere ihtiyaç duyuyorsa Girdi ve çıktı için ayrı provider'lar öğesini etkinleştirin, ardından giriş/çıkış anahtarını, temel URL'yi ve model alanlarını doldurun.
- Oynatma modu ve Çıktı formatı öğesini, ardından Kaydet öğesini seçin (kaydedilmemiş değişiklikler varken kullanılabilir). Test etmeden önce test düğmelerinin yanındaki durumu kontrol edin: Yapılandırıldı, Kısmen yapılandırıldı veya API anahtarı eksik; başarısız bir kaydetme Kaydetme başarısız gösterir.
Konuşma ayarları ve anahtarlar, seçilen projeye veya OpenCode sağlayıcı bağlantısına değil, bağlı CodeNomad sunucu yapılandırmasına aittir. Bunu paylaşan diğer istemciler bu ayarları kullanır. Kaydedilen anahtarlar gizlidir: boş bir anahtar alanı kaydedilen değeri tutar; Kayıtlı anahtarı temizle kaydedildiğinde kaldırılmasını planlıyor. Kendi uç noktası veya anahtarı olmayan bir yön, paylaşılan ayarları kullanabilir; ayrı bir uç noktanın kendi anahtarına, ayrı bir anahtarın da kendi uç noktasına ihtiyacı vardır. Bir uç noktayı değiştirirken amaçlanan anahtarı açıkça sağlayın ve kaydedilen yapılandırmayı doğrulayın; uç nokta değişiklikleri, farklı bir ana bilgisayara göndermek yerine o yuva için kayıtlı anahtarı temizler.
Arka uç, paylaşılan varsayılanlar için OPENAI_API_KEY ve OPENAI_BASE_URL'yi de kullanabilir. Kaydedilmiş bir anahtarın temizlenmesi, ortam tarafından sağlanan kimlik bilgilerini kaldırmaz; geri dönüşü kaldırmak istiyorsanız arka uçtaki ortamı değiştirin ve yeniden başlatın.
| Ayar | Anlamı / varsayılan |
|---|---|
| Temel URL | OpenAI uyumlu API kökü, varsayılan https://api.openai.com/v1. Giriş audio/transcriptions'yi kullanır; çıkış audio/speech'yi kullanır. |
| Transkripsiyon modeli / Giriş modeli | STT uç noktası tarafından kabul edilen model; varsayılan gpt-4o-mini-transcribe. |
| Konuşma modeli / Çıkış modeli | TTS uç noktası tarafından kabul edilen model; varsayılan gpt-4o-mini-tts. |
| Varsayılan ses | Sağlayıcının ses tanımlayıcısı; varsayılan alloy. Bu bir işletim sistemi ses seçicisi değildir. |
| Akış | Varsayılan. Sağlayıcı ve tarayıcı seçilen formatı desteklediğinde, ses geldiğinde oynatmayı başlatır. |
| Tamponlanmış | Oynatmadan önce sesli yanıtın tamamını bekler. |
| Çıkış formatı | mp3, wav, opus veya aac; varsayılan mp3. Uyumluluk tarayıcıya/sağlayıcıya göre değişir. |
Bunlar yapılandırılmış hizmete yönelik isteklerdir; her uyumlu uç noktanın her modeli, sesi veya formatı uygulayacağının garantisi değildir. Başarısız kaydetme hata bırakır; başka bir değişiklik yapmadan önce konfigürasyonu inceleyin.
Giriş ve çıkışı test edin
- Önce uç nokta, anahtar, model ve ses değişikliklerini kaydedin.
- Girdiyi test et öğesini seçin, mikrofon izni verin, konuşun ve ardından Kaydı durdur öğesini seçin. Döndürülen transkripsiyonu kontrol edin.
- Örneği dinlemek için Oynatmayı test et öğesini seçin; Örneği durdur bunu bitirir.
Oynatma testi seçilen oynatma modunu/formatını hemen kullanır, ancak uç nokta, anahtar, model ve ses kayıtlı ayarlardan gelir. Test girişi bir konuşma istemi göndermiyor. Testler yine de yapılandırılmış konuşma sağlayıcısına ses/metin göndermeye devam eder ve ücretlendirilebilir.
Akış başarısızsa Tamponlanmış seçeneğini ve mp3 biçimini deneyin, kaydedip yeniden test edin. “Yapılandırıldı” başarılı sağlayıcı kimlik doğrulamasını veya codec oynatımını değil, ayarları doğrular. Yeniden denemeden önce sunucu ana bilgisayarından uç noktaya erişimi, sağlayıcının model/ses adlarını ve kotayı kontrol edin.
Bir istemi dikte edin
- Konuşma bölümünde Prompt ses girişi öğesini etkin tutun (varsayılan olarak açıktır).
- İleti düzenleyicisinde Diğer eylemler menüsünü açın, Ses girişini başlat öğesini seçin ve bu cihazda mikrofon erişimine izin verin.
- Konuşmanız bitince aynı menüde Kaydı durdur ve metne dönüştür öğesini seçin; işlenirken Ses metne dönüştürülüyor görünür.
- İstemi normal şekilde göndermeden önce eklenen metni inceleyin ve düzenleyin.
Transkripsiyon metni geçerli seçime ekler; bunu otomatik olarak OpenCode'a göndermez. Menü girişi yalnızca STT yapılandırıldığında ve istemci kaydetmeyi desteklediğinde görünür. Kayıt, CodeNomad uzak bir sunucuda çalıştığında bile istemci aygıtının mikrofonunu kullanır.
Eksik bir menü girişi için geçiş düğmesini ve STT yapılandırmasını kontrol edin. İzin hataları için, hem tarayıcı hem de işletim sistemi gizlilik ayarlarında mikrofona izin verin. Uzaktan tarayıcı kaydı, normalde güvenilen HTTPS olan güvenli bir bağlama ihtiyaç duyar; bkz. Mobil erişim ve Doğrudan uzaktan erişim. İleti düzenleyicisini değiştirmek veya kapatmak, onun kayıt yaşam döngüsünü sona erdirir; gönderilmemiş sesin kurtarılabilir olduğuna güvenmeyin. Yazdığınız taslak, sonucu gözden geçirebileceğiniz yer olarak kalır.
Mesajları yüksek sesle oku
- TTS kullanılabiliyorsa bir mesajda Mesajı seslendir eylemini veya bir araç çağrısında aynı eylemi kullanın.
- Bitirmek için aynı kontrolde Oynatmayı durdur öğesini kullanın; başka bir okumayı başlatmak geçerli okumayı durdurur.
- Sonraki istekler için Konuşma bölümünde kayıtlı sesi, modeli, modu veya formatı değiştirin.
Oynatma, anlatımlı bir ekran görüntüsünü değil, CodeNomad'in metin projeksiyonunu kullanır: ikili/görüntü baytları ve izin makbuzları konuşma içeriği değildir. Bir istem çalıştırmaz veya seçilen OpenCode modelini değiştirmez. Tarayıcı ses desteği ve sağlayıcı yanıtları, bir format seçilebilir olsa bile oynatmayı yine de engelleyebilir.
Otomatik konuşma seslendirmesi için ileti düzenleyicisinin Diğer eylemler menüsünden Konuşma modunu etkinleştir seçeneğini kullanın; bu mod o proje sekmesi için geçerlidir ve yeniden yüklemeden sonra korunmaz. Açıkken CodeNomad, gönderdiğiniz her istemle birlikte ajandan yanıtına kod çitleri arasında kısa bir spoken özetiyle başlamasını ister. Etkin ana oturumda yalnızca bu tamamlanmış blok okunur; her yanıtı veya alt ajanı otomatik okumaz. Konuşma modunu devre dışı bırak kuyruğu durdurur ve artık özeti istemez. Mikrofon girişine başlamak da etkin seslendirmeyi durdurur. Anahtar ses girişiyle birlikte veya konuşma modu zaten açıkken görünür; etkinleştirmek için çalışan TTS gerekir.
Veri akışı ve gizlilik
Mikrofon sesi istemcinizden CodeNomad arka ucuna, oradan yapılandırılmış STT uç noktasına gider. Sentezlenecek metin arka uç üzerinden yapılandırılmış TTS uç noktasına gider; dönen ses istemcide oynar. API anahtarları sunucuda kalır ve kayıtlı değerler olarak ayar formuna döndürülmez.
Dikte edilen veya okunan materyal için güvendiğiniz bir uç nokta kullanın. Bu, çevrimdışı bir transkripsiyon garantisi değildir ve OpenCode kimlik bilgileri konuşmaya otomatik olarak yetki vermez. Bittiğinde kaydetmeyi/oynatmayı durdurun; Bir anahtarın veya uç noktanın değiştirilmesi, bir sağlayıcıya halihazırda gönderilmiş olan verileri değil, gelecekteki istekleri etkiler. Bir sunucuyu diğer kullanıcıların kullanımına açmadan önce Güvenlik konusuna bakın.