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.8 KiB
קלט קולי והשמעה
הגדרת קול
- פתחו הגדרות → קול. כרטיס קול משתמש במתאם בצד השרת התואם ל־OpenAI, בנפרד מספק המודל של השיחה.
- הזינו מפתח API, ואפשר גם כתובת בסיס, מודל תמלול, מודל קול ו־קול ברירת מחדל.
- אם לקלט ולפלט נחוצים שירותים שונים, הפעילו ספקים נפרדים לקלט ולפלט, ואז מלאו את שדות המפתח, כתובת הבסיס והמודל לקלט/לפלט.
- בחרו מצב ניגון ו־פורמט פלט, ואז שמור (זמין כל עוד יש שינויים שלא נשמרו). לפני בדיקה, בדקו את הסטטוס שליד כפתורי הבדיקה: מוגדר, מוגדר חלקית או חסר מפתח API; שמירה שנכשלה מציגה השמירה נכשלה.
הגדרות הקול והמפתחות שייכים לתצורת שרת CodeNomad המחובר, לא לפרויקט שנבחר או לחיבור ספק OpenCode. לקוחות אחרים החולקים אותה משתמשים בהגדרות האלה. מפתחות שמורים מוסתרים: שדה מפתח ריק שומר את הערך השמור; נקה מפתח שמור מתזמן את הסרתו בשמירה. כיוון שאין לו נקודת קצה או מפתח משלו יכול להשתמש בהגדרות המשותפות; נקודת קצה נפרדת דורשת מפתח משלה, ומפתח נפרד דורש את נקודת הקצה שלו. בשינוי נקודת קצה, ספקו במפורש את המפתח הרצוי ואמתו את התצורה השמורה; שינויים בנקודת הקצה מנקים את המפתח השמור לאותו מקום במקום לשלוח אותו למארח אחר.
שרת הקצה יכול להשתמש גם ב־OPENAI_API_KEY וב־OPENAI_BASE_URL כברירות מחדל משותפות. ניקוי מפתח שמור אינו מסיר אישור שסופק מהסביבה; שנו את הסביבה בשרת הקצה והפעילו אותו מחדש אם בכוונתכם להסיר את החלופה הזו.
| הגדרה | משמעות / ברירת מחדל |
|---|---|
| כתובת בסיס | שורש API תואם OpenAI, כברירת מחדל https://api.openai.com/v1. הקלט משתמש ב־audio/transcriptions; הפלט ב־audio/speech. |
| מודל תמלול / מודל קלט | מודל שנקודת הקצה STT מקבלת; ברירת מחדל gpt-4o-mini-transcribe. |
| מודל קול / מודל פלט | מודל שנקודת הקצה TTS מקבלת; ברירת מחדל gpt-4o-mini-tts. |
| קול ברירת מחדל | מזהה קול של הספק; ברירת מחדל alloy. זה אינו בורר קולות של מערכת ההפעלה. |
| הזרמה | ברירת מחדל. מתחילה השמעה עם הגעת השמע, כשהספק והדפדפן תומכים בפורמט שנבחר. |
| באפר מלא | ממתין לתשובת השמע המלאה לפני השמעה. |
| פורמט פלט | mp3, wav, opus או aac; ברירת מחדל mp3. התאימות משתנה לפי דפדפן/ספק. |
אלו בקשות לשירות המוגדר, לא הבטחה שכל נקודת קצה תואמת מממשת כל מודל, קול או פורמט. כשל שמירה משאיר שגיאה; בדקו את התצורה לפני שינוי נוסף.
בדיקת קלט ופלט
- שמרו תחילה שינויי נקודת קצה, מפתח, מודל וקול.
- בחרו בדיקת קלט, אשרו גישה למיקרופון, דברו ואז עצור הקלטה. בדקו את התמלול שהוחזר.
- בחרו בדוק ניגון לשמיעת הדוגמה; עצור דוגמה מסיים אותה.
בדיקת ההשמעה משתמשת מיד במצב/פורמט ההשמעה שנבחרו, אך נקודת הקצה, המפתח, המודל והקול מגיעים מההגדרות השמורות. בדיקת קלט אינה שולחת קלט לשיחה. הבדיקות עדיין שולחות שמע/טקסט לספק הקול המוגדר ועשויות לגרור חיובים שלו.
אם הזרמה נכשלת, בחרו באפר מלא, נסו mp3, שמרו ובדקו שוב. "מוגדר" מאשר הגדרות, לא אימות מוצלח מול הספק או השמעת codec. בדקו זמינות נקודת קצה ממארח השרת, שמות מודל/קול אצל הספק ומכסה לפני ניסיון חוזר.
הכתבת קלט
- השאירו את קלט קולי לפרומפט מופעל ב־קול (הוא מופעל כברירת מחדל).
- בשדה הקלט, פתחו פעולות נוספות, בחרו התחל קלט קולי ואפשרו גישה למיקרופון במכשיר זה.
- כשתסיימו לדבר, בחרו עצור הקלטה ותמלל באותו תפריט; מתמלל אודיו מוצג בזמן העיבוד.
- בדקו וערכו את הטקסט שהוכנס לפני שליחת הקלט כרגיל.
התמלול מכניס טקסט בבחירה הנוכחית; הוא אינו שולח אותו אוטומטית ל־OpenCode. רשומת התפריט מופיעה רק כאשר STT מוגדר והלקוח תומך בהקלטה. ההקלטה משתמשת במיקרופון של מכשיר הלקוח, גם כש־CodeNomad פועל בשרת מרוחק.
אם הרשומה חסרה, בדקו את המתג ואת תצורת STT. לשגיאות הרשאה, אפשרו את המיקרופון הן בדפדפן והן בהגדרות הפרטיות של מערכת ההפעלה. הקלטה בדפדפן מרוחק דורשת הקשר מאובטח, לרוב HTTPS מהימן; ראו גישה מנייד ו־גישה ישירה מרחוק. מעבר מהקלט או סגירתו מסיימים את מחזור חיי ההקלטה; אל תסתמכו על האפשרות לשחזר שמע שלא נשלח. הטיוטה המוקלדת נשארת המקום לבדיקת התוצאה.
הקראת הודעות
- השתמשו ב־השמע הודעה בהודעה, או באותה פעולה בקריאת כלי, כש־TTS זמין.
- השתמשו ב־עצור ניגון באותו פקד כדי לסיים אותה; התחלת הקראה אחרת עוצרת את הנוכחית.
- שנו את הקול, המודל, המצב או הפורמט השמורים ב־קול לבקשות הבאות.
ההשמעה משתמשת בהיטל הטקסט של CodeNomad, לא בהקראת צילום מסך: בתים בינאריים/של תמונות וקבלות הרשאה אינם תוכן להקראה. היא אינה מריצה קלט או משנה את מודל OpenCode שנבחר. תמיכת השמע בדפדפן ותשובות הספק עדיין עשויות למנוע השמעה גם אם אפשר לבחור פורמט.
לדיבור שיחה אוטומטי, השתמשו ב־הפעל מצב שיחה בתפריט פעולות נוספות של שדה הקלט; הוא חל על אותה לשונית פרויקט ואינו נשמר לאחר טעינה מחדש. כל עוד הוא פעיל, CodeNomad מבקש מהסוכן, עם כל קלט שאתם שולחים, לפתוח את תשובתו בסיכום קצר בבלוק spoken מגודר. רק הבלוק שהושלם מוקרא, בסשן הראשי הפעיל; זו אינה הקראה אוטומטית של כל תשובה או תת־סוכן. כבה מצב שיחה עוצר את התור שלו ומפסיק לבקש את הסיכום. תחילת קלט מיקרופון עוצרת גם דיבור שיחה פעיל. המתג מופיע עם קלט קולי, או כל עוד מצב שיחה כבר מופעל, ונדרש TTS תקין להפעלתו.
זרימת נתונים ופרטיות
שמע המיקרופון עובר מהלקוח לשרת הקצה של CodeNomad, ומשם לנקודת הקצה STT המוגדרת. טקסט שנבחר להפקת דיבור עובר דרך אותו שרת קצה לנקודת הקצה TTS המוגדרת; השמע המוחזר מושמע בלקוח. מפתחות API נשארים בצד השרת ואינם מוחזרים כערכים שמורים לטופס ההגדרות.
השתמשו בנקודת קצה שאתם נותנים בה אמון עם החומר המוכתב או המוקרא. אין זו הבטחה לתמלול לא מקוון, ופרטי התחברות של OpenCode אינם מאשרים שימוש בקול אוטומטית. עצרו הקלטה/השמעה בסיום; שינוי מפתח או נקודת קצה משפיע על בקשות עתידיות, לא על נתונים שכבר נשלחו לספק. ראו אבטחה לפני חשיפת שרת למשתמשים אחרים.