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
עדכונים
בחירת ערוץ העדכונים
- פתחו הגדרות → מידע → עדכונים.
- הגדירו ערוץ עדכונים ל־גרסאות יציבות או ל־גרסאות תצוגה מקדימה ויציבות.
- רעננו/בדקו עדכונים ועיינו בגרסה המוצעת לפני אישור התקנה.
הערוץ נשמר בתצורת שרת CodeNomad ומשנה רק אילו גרסאות מוצעות. הוא אינו משנה פרופילי נתונים לשולחן העבודה, טיוטות, חלונות, סשנים של OpenCode או תצורת שירות. ללא בחירה מפורשת, בניות המסומנות כתצוגה מקדימה משתמשות בתצוגות מקדימות כברירת מחדל, ובניות אחרות ביציבות.
הערוץ היציב בוחר את הגרסה הסופית האחרונה. תצוגה מקדימה עוקבת אחר סדר הפרסום כי בניות פיתוח עשויות לשתף מספר גרסת בסיס; אל תשוו רק מספרי גרסאות. גרסת תצוגה מקדימה מוצעת רק לאחר שכל הבניות שלה פורסמו. חבילות תצוגה מקדימה מיועדות למי שמוכנים לבדוק התנהגות קדם־הפצה; עיינו בהערות הגרסה והגנו על טיוטות חשובות לפני הפעלה מחדש.
עדכון התקנת שולחן עבודה
- השתמשו ב־עזרה → חיפוש עדכונים…, בהתראת העדכון או בכפתור שב־הגדרות → מידע → עדכונים.
- ב־Electron, עברו לדף הגרסה והשיגו את הארכיון/החבילה למארח/לפלטפורמה שבהם אתם משתמשים.
- בהתקנות Tauri מקומיות מתאימות, בדקו את ההצעה המקורית ובחרו במפורש התקנה והפעלה מחדש.
- שמרו עבודה חשובה בכל חלון לפני התקנה/הפעלה מחדש, ואז אמתו את מידע לאחר ההפעלה.
| התקנת Tauri | זכאות להתקנה בתוך היישום |
|---|---|
| התקנת NSIS ב־Windows x64 | נתמכת עם מפתח העדכון המוטמע ומטען גרסה חתום. |
| יישום macOS x64 / arm64 | נתמך עם מפתח העדכון המוטמע ומטען .app.tar.gz חתום. |
| AppImage ב־Linux x64 | דורש סמן חבילת AppImage ונתיב APPIMAGE לא ריק, וכן תמיכה בעדכונים חתומים. APPRUN לבדו אינו מספיק. |
| Debian/RPM, קובץ הרצה נפרד של Windows, בנייה לא חתומה/ללא מפתח | פותח את דף הגרסה במקום להתקין בתוך היישום. |
בחלונות היישום של Tauri ובחלונות העדפות המקוריים, מקטע העדכונים מציג התקן עדכון כאשר מוצעת גרסה. הוא בודק את הערוץ שנבחר ומציע התקנה והפעלה מחדש כאשר עדכון בתוך היישום זמין; אחרת הוא פותח את דף הגרסה המוצג במקטע. חלונות Electron, דפדפן וחלונות מרוחקים מציגים במקום זאת את הקישור הורד עדכון, ללא בדיקה של מנגנון העדכון המקורי.
תפריט עזרה → חיפוש עדכונים… של Tauri מפעיל את תהליך העדכון בחלון היישום שבמוקד. מתוך העדפות או חלון מרוחק, הוא מביא לחזית את חלון היישום שבו נעשה שימוש לאחרונה כדי לבצע את הבדיקה; הוא אינו מתקין דרך החלון המרוחק. אם אין חלון יישום שיכול לקבל את הפעולה, לרבות כאשר החלון שאליו היא מכוונת מציג מסך טעינה, התחברות או צימוד, התפריט פותח במקום זאת את דף הגרסה.
Tauri מתקין רק גרסאות עם מניפסט עדכון שפורסם עבור הערוץ/היעד שנבחרו. אם גרסה שהוכרזה עדיין אינה ניתנת להתקנה, ההתראה פותחת במקום זאת את דף הגרסה. נדרש אימות חתימה מקורי לפני התקנה. חתימות עדכון נפרדות מהבטחות אישור נוטריוני/חתימת קוד של מערכת ההפעלה.
ההתקנה שומרת את מצב כל חלונות היישום ועוצרת את שרת הקצה שבבעלות CodeNomad לפני החלפת/הפעלת היישום מחדש. דמון OpenCode שבבעלות נפרדת אינו חלק מהכיבוי. סגירת CodeNomad עדיין מסירה תכונות התלויות בשרת הקצה עד חזרתו; אל תסיקו רציפות שירותי ממשק מסשן OpenCode שממשיך לפעול.
אם בדיקה עסוקה, המתינו לפעולה בחלון האחר. בכשל הורדה, אימות או כיבוי, קראו את השגיאה ובצעו בדיקה חדשה; התראה ישנה אינה היתר להתקין מחדש בתים מיושנים. התקנה שנכשלה יכולה לשחזר את שרת הקצה ולטעון מחדש חלונות, ואינה חוזרת אוטומטית על ההתקנה. אם התקנה מקורית אינה זמינה, השתמשו בדף הגרסה לחבילה המתאימה; ראו התקנה.
עדכון שרת עצמאי
- זהו כיצד הפעלתם את CodeNomad ושמרו עבודה התלויה בשרת הקצה הזה.
- עצרו את תהליך שרת CodeNomad באמצעות בקרת התהליך/השירות הרגילה שלו.
- עדכנו את אותה התקנת חבילה, ואז הפעילו מחדש עם התצורה והדגלים הרצויים.
| שיטת הפעלה/התקנה | פקודת עדכון |
|---|---|
| הפעלת npm יציבה חד־פעמית | npx @neuralnomads/codenomad@latest עם הדגלים הרגילים שלכם |
| התקנה יציבה גלובלית | npm install -g @neuralnomads/codenomad@latest |
| התקנה יציבה מקומית | npm install @neuralnomads/codenomad@latest בתיקיית החבילה |
| הפעלת תצוגה מקדימה חד־פעמית | npx @neuralnomads/codenomad-dev@latest עם הדגלים הרגילים שלכם |
| התקנת תצוגה מקדימה גלובלית/מקומית | התקינו @neuralnomads/codenomad-dev@latest באותה צורת npm גלובלית/מקומית |
תהליך שכבר פועל אינו מקבל קוד חדש רק מפני ש־npm התקין אותו. שמרו במכוון על אותו נתיב תצורה; בחירת ערוץ בהגדרות אינה מחליפה את חבילת npm או מחליפה אוטומטית שמות חבילות יציבות/תצוגה מקדימה. שמרו את דגלי האימות/TLS בהפעלה מחדש; ראו שרת.
הפרדת תחזוקת OpenCode
עדכון CodeNomad אינו עדכון OpenCode CLI שנבחר. עדכון ה־CLI אינו הפעלה מחדש של הדמון המשותף הפועל. טעינת תצורה מקורית מחדש היא פעולה מפורשת נוספת עם השפעות משלה על Locations טעונים ובקשות.
משאבי Node/npm לשולחן העבודה נשלחים עם היישום; גרסת יישום מספקת את עדכוניהם. הדבר אינו מחליף את Node/npm במערכת, את סביבת הריצה הפנימית של Electron, את ה־webview של הפלטפורמה או את שירות OpenCode המנוהל בנפרד.
השתמשו ב־הגדרות → OpenCode לבחירת סביבת ריצה, התקנה/עדכון ופקדי שירות מפורשים. בדקו הגדרת OpenCode לפני הפעלה מחדש או טעינה מחדש, במיוחד כשחלונות/משתמשים אחרים או משימות חולקים את הדמון. לעולם אל תחזרו על קלט או על פעולת שינוי לא ודאיים רק מפני שעדכון/חיבור מחדש הסתיים.