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.
22 KiB
משימות
משימות מצמידות תוכנית פרויקט מתמשכת לשיחות מקוריות של OpenCode. המתאם מתכנן ומאציל; עץ המטלות מתעד תלויות ותוצאות. תוכנית שמורה, קלט שהתקבל להרצה והרצה שנצפתה הן עובדות שונות.
יצירה ואז הפעלה מפורשת
- פתחו משימות בלוח הימני ובחרו יצירת משימה.
- מלאו מה המשימה צריכה לעשות? ובדקו כותרת, הממולאת מראש מהמשפט הראשון (עד 60 תווים).
- תחת מתי, בחרו פעם אחת או כל יום בשעה. לעבודה יומית, אמתו את אזור הזמן המוצג; שינוי מאפשר אזור IANA.
- הרחיבו אפשרויות עבור מדריך, הערות, סוכנים ומודלים, שיחות משימות, תקצירים שמורים ושיחות במעקב לפי בחירה. עם השוואת שני מודלים, הבוררים מודל A ו־מודל B מופיעים בטופס הראשי.
- בחרו יצירה. בחרו את הרשומה החדשה, ואז השתמשו בפעולת ▶ הנפרדת שלה כשתהיו מוכנים: הפעלת משימה לעבודה חד־פעמית, או הפעלת לוח הזמנים {id} ללוח זמנים יומי.
יצירה לעולם אינה מתחילה עבודה. משימה חד־פעמית מוכנה; לוח זמנים יומי מושהה. לא יצירה ולא שמירת תקציר מפעילות שעון עצר. היצירה תחומה לפרויקט/ל־Location שנבחרו ומקפיאה את הפרופילים המבוקשים ואת מדיניות סשני המטלות. האימות מופיע לצד השדה המושפע; סירוב שאומר שלא נשלח דבר משאיר את הטיוטה זמינה לתיקון. המתאם של משימה חד־פעמית יכול גם להכין עבורכם משימה נפרדת, כגון משימת המשך: היא מופיעה ברשימה כ־מוכנה וכמו כל משימה, מתחילה רק מפעולת ▶ שלה.
מדריכי עבודה
| מדריך עבודה | העבודה המיועדת |
|---|---|
| משימה גמישה | המתאם בוחר תוכנית מודעת־תלויות למטרה. |
| ניפוי תקלות | אבחון, מימוש, סקירת תקנים/מפרט נפרדת ואימות חדש; פתרון ממשיך את שיחת המממש. |
| חקירה | ממפה אי־ודאויות ופועלת דרך החלטות תחומות עם שאלות לאדם. |
| אספקת מוצר | מתאמת תפקידי ניתוח מוצר, ארכיטקטורה, מימוש ואיכות. |
| השוואת שני מודלים | מריצה את אותה מטלה עם תיאורים זהים על מודל A ועל מודל B, ואז שופט עיוור נותן ציון לשניהם תחת תוויות ניטרליות ומוסר פסק דין: מודל A מנצח, מודל B מנצח, שקולים או ללא מסקנה. |
ב־השוואת שני מודלים, שני המודלים נדרשים וחייבים להיות שונים; רמת חשיבה שונה בלבד אינה מודל שונה. אלא אם תבחרו שופט, הוא משתמש במודל של המתאם; הטופס מזהיר כשהוא זהה ל־A או ל־B, דבר שעלול להטות את ההשוואה. הסקירה מציגה את פסק הדין, את שמות שני המודלים ואת הציונים לפי קריטריון.
המדריך מנחה תיאום; הוא אינו עוקף אישורים מקוריים או מבטיח הצלחה. ענו לשאלות ההחלטה של חקירה דרך אזור הבקשות של CodeNomad כדי שתירשם תשובת ממשק מפורשת, במקום לבקש מסוכן להתחזות לאישור.
מעקב אחר העץ וקריאת תוצאות
- בחרו את כותרת המשימה. החץ המוביל משאיר את רשימתה פתוחה; שדה הכותרת פותח בורר זמני.
- בחרו סיכום (עין) לסקירה המרכזית, או בחרו צומת מטלה לתוצאה, לתיאור ולראיות המדויקים שלו.
- עקבו אחר קישורי תלויות ו־דוחות; השתמשו ב־פתיחת השיחה למתאם כשנחוץ לכם התמליל שלו.
- תחת נדרשת תגובתך, בחרו מענה לפתיחת שיחת הגורם המבקש ואזור הבקשות.
| מחוון | מה הוא מוכיח |
|---|---|
| הוקצתה | קלט התקבל להרצה; צריכת המודל/עבודה/השלמה אינן מוכחות. |
| פעילה | נצפתה פעילות מקורית. |
| ממתינה | התלויות המוצהרות עדיין לא התקיימו. |
| חסומה | דווח מכשול, לא בהכרח שאלה עבורכם. |
| ממתינה לתשובתך | טופס/שאלה מקוריים פתוחים או הרשאה דורשים תשובה; הם מופיעים תחת נדרשת תגובתך. |
| הושלמה | נרשמה תוצאת מטלה; בדקו את ראיותיה וכל עבודה מקורית שנותרה. |
| נכשלה / הוסרה | המטלה נכשלה, או שהמתאם החליף אותה או נטש אותה. |
הגרף כולל עבודה שהושלמה והוצאה מהתוכנית. הוצאת מטלה מהתוכנית אינה עוצרת כשלעצמה את שיחתה. במשימה חד־פעמית, המתאם יכול לעצור בנפרד את השיחות של מטלה שהוסרה ושהוא הפעיל כתת־סוכן מקורי, בלי לגעת במטלות אחרות. בתהליך הוא מצב מחזור החיים של המשימה, לא הוכחה שהמתאם שלה פועל כרגע. טקסט מלא שייך לקורא המרכזי, לא לרשימת המטלות בלוח; פרטים טכניים מכווץ מזהים ומידע הרצה מבוקש.
עדכוני מצב ובקשות עדכון
המתאם מונחה לפרסם עדכון מצב לפרויקט אחרי התוכנית הראשונית, אחרי השלמת מטלות, כשהוא ממתין לאדם ולפני הדוח הסופי. זו הערכה כתובה, לא מונה פעילות חי או אות חיים תקופתי מובטח. הודעה מציינת כשהמפה השתנתה מאז העדכון.
השתמשו ב־בקשת עדכון מתחת לסרגל הכלים להערכה חדשה מהמתאם, ואז קראו סיכום. עדכון התבקש… אומר שהבקשה ממתינה, לא שנענתה. השליחה לא אושרה אינו מתיר שליחה אוטומטית מחדש: פתחו את שיחת המתאם לפני הגשת בקשה חדשה ונפרדת. זהו קלט מקורי רגיל, לא ארגז חול לקריאה בלבד; המתאם שומר את הרשאותיו הרגילות.
פרופילים, האצלה ועומק
- השתמשו בגלגל השיניים של משימות או ב־הגדרות → משימות לעריכת ברירות מחדל למשימות חדשות.
- תחת החלה על, בחרו כל המשימות או מדריך אחד, ואז הגדירו את שיחות משימות, ותחת סוכנים ומודלים שורה אחת לכל תפקיד (המתאם, ואז תפקידי המדריך). כל בחירה נשמרת מיד; אין כפתור שמירה.
- בהיקף של מדריך, השורות מציגות את הערכים הגלובליים המסומנים גלובלי. שינוי שדה מתאים אישית את אותו תפקיד החל מהם; סמל השחזור שלו חוזר להשתמש בערכים הגלובליים. איפוס (לאחר אישור) מנקה רק את הסוכנים והמודלים של ההיקף המוצג.
- ביצירה, השתמשו ב־אפשרויות → סוכנים ומודלים לפרופילים מבוקשים מסוימים; שימוש בברירות המחדל השמורות משחזר את השמורים.
- למגבלות רקורסיה מקורית, ערכו את עומק הקינון של תתי־סשנים → עומק שנקבע לפרויקט. לחיצה על Enter או יציאה מהשדה שומרות ערך תקין ששונה; ירושה שומרת מיד; Escape משליך ערך שלא נשמר.
| הגדרה | היקף והשפעה |
|---|---|
| ברירות מחדל למשימות חדשות | ברירות מחדל לכל התצורה למשימות חדשות בלבד; חריג מדריך גובר על ברירת המחדל הכללית. |
| סוכן / מודל / חשיבה | בחירות מתאם/תפקיד מבוקשות המתועדות ביצירה; גורם עסוק אינו מוחלף בשקט כדי להתאים לעבודה מאוחרת יותר. הרצות יומיות משתמשות שוב בפרופילים המבוקשים הקפואים שלהן. |
| תת־סוכנים מקוריים | סשני מטלות משתמשים בסוכני subagent/all מקוריים תחת המתאם. |
| סשנים עצמאיים | סשני מטלות מוצהרים משתמשים בסוכני primary/all ובשיחות עצמאיות; הדבר אינו משבית עוזרים מקוריים פנימיים. |
| עומק הקינון של תתי־סשנים | תצורת פרויקט ל־כל שיחות OpenCode שם, לא רק למשימות. ריק יורש. שמירה אינה טוענת מחדש את OpenCode או משנה שיחות פועלות. |
ברירת מחדל מקורית ו־גלובלי שונות: הראשונה מבקשת את ברירות המחדל של OpenCode עצמו, השנייה יורשת את הבחירה הגלובלית; בחירת ברירות מחדל מקוריות בהיקף של מדריך נשארת חריג מפורש. זמינות הקטלוג נבדקת; פרופיל מבוקש אינו הוכחה לפרופיל ששיחה משתמשת בו כרגע. אישורים מקוריים והעומק המוגדר עדיין שולטים בקריאות לעוזרים פנימיים בשני מצבי המטלות.
בחירה שנדחתה או שלא אושרה לעולם אינה נשלחת שוב: הערכים השמורים מוצגים שוב, ו־טעינה מחדש מופיעה רק כשאי אפשר לקרוא אותם. אם שינוי עומק אינו מאושר, הערך שלכם נשמר; השתמשו ב־רענון עומק הפרויקט לפני שינוי נוסף. אל תפרשו עומק OpenCode האפקטיבי אינו ידוע כאפס או כמושבת.
שימוש חוזר בתקציר שמור
- ביצירה, הרחיבו אפשרויות → להתחיל מתקציר ובחרו את התקציר השמור.
- בדקו את המטרה, ההערות, המדריך, הפרופילים וההאצלה שהועתקו לפני יצירה.
- השתמשו ב־שמירה כתקציר למתן שם לטיוטה לשימוש חוזר. משימה חד־פעמית שנבחרה, לרבות משימה שהסתיימה, מציעה גם שמירה כתקציר.
תקצירים שומרים הוראות ובחירות מבוקשות, לא תוכניות מטלות, תוצאות, שיחות, שעוני לוח זמנים או סמכות הרצה. טעינת תקציר ממלאת טיוטת יצירה רגילה; היא אינה מתחילה או מתזמנת דבר. הסרת תקציר משאירה משימות/שיחות קיימות. הגדרות → משימות → תיאורים שמורים מנהל את הספרייה; אם הספרייה הופכת לבלתי קריאה, איפוס הספרייה השמורה (לאחר אישור) מסיר תקצירים שמורים, לא הרצות. ללוחות הזמנים עצמם אין פעולת שמירה כתקציר.
שעה יומית, השלמת פערים ושיחות במעקב
לוחות זמנים יומיים משתמשים באזור הזמן IANA ובשעה האזרחית השמורים, לא במרווח חולף של 24 שעות. השעות מוצגות באזור של לוח הזמנים, עם תווית כשהוא שונה מזה של הצופה. כל הרצה מקבלת מתאם ומפת משימה מבודדת משלה; לוח הזמנים הנבחר מציג את עץ המטלות הנוכחי והיסטוריית תאריכים/תוצאות. בחרו הרצה קודמת לקריאתה במרכז. ההיסטוריה מוגבלת ל־30 תוצאות.
| מצב | התנהגות התזמון |
|---|---|
| מספר ימים שמועדם חל הוחמצו | מריץ רק את היום האחרון שמועדו חל ומאוחר מסמן היום שהושלם, לא צבר לכל יום שהוחמץ. |
| פער במעבר לשעון קיץ | מתקדם לדקה התקינה הראשונה שאחריו; פער בסוף היום מתקדם מעבר לגבול היום. |
| שעה שחוזרת בשעון | משתמש בהופעה הראשונה; אינו יוצר הרצה יומית שנייה. |
| יום אזרחי שדולג בשלמותו | אין הרצה לאותו יום. |
| השעון זז לאחור | אינו הופך יום שכבר עובד ליום שהגיע מועדו שוב. |
| הרצה קיימת עדיין ממתינה | אינו חופף אותה עם הרצה יומית חדשה. |
גם זמן היצירה מגביל עבודה יומית זכאית; הפעלת לוח זמנים חדש אינה היתר לעבד תאריכים מלפני שהיה קיים. הרצה עכשיו מתחיל הרצה ידנית נפרדת כשמוצע; אינו מחליף את השעון היומי או עוקף הרצה ממתינה. השעה הבאה המוצגת היא תחזית, לא הבטחה להרצה בשעה מדויקת.
שיחות במעקב (לא חובה) מוסיף הקשר מוגבל משיחות שנבחרו. רק הרצה שהושלמה מקדמת את סמני ההודעות שעובדו שלהן; הרצה שנכשלה/נקטעה אינה צורכת בשקט את ההקשר הזה. אם ההוראות וההקשר יחד חורגים מהקיבולת, קצרו הוראות או הסירו שיחות במעקב במקום להניח שנקראת היסטוריה ללא גבול.
משך חיים והפעלות שירות מחדש
| רכיב | משמעות סגירתו |
|---|---|
| לשונית פרויקט CodeNomad | סוגרת את הפרויקט ב־CodeNomad; סשנים מקוריים ממשיכים ב־OpenCode. פתחו את הפרויקט מחדש כדי למצוא אותם שוב. |
| חלון שלם, יציאה מהיישום או טעינה מחדש של תהליך התצוגה | משמרים את חיבורי הפרויקטים לשחזור; אינם עוצרים עבודה מקורית או את שירות OpenCode. |
| שרת הקצה של CodeNomad | אינו עוצר את OpenCode. תיאום חד־פעמי של CodeNomad תלוי בנוכחות שרת הקצה; אל תניחו ששיגור/בקרה חדשים למשימה חד־פעמית נשארים זמינים כשהוא סגור. |
| לוח זמנים יומי פועל | השעון והרצת המחזור שלו פועלים בתוסף/בשירות OpenCode, לרבות כשהממשק ושרת הקצה של CodeNomad סגורים. מארח ההרצה ושירות OpenCode חייבים להמשיך לפעול. |
| הפעלה מחדש של שירות OpenCode | מאבדת עבודות תזמון מקומיות לתהליך. לוח זמנים שאמור לפעול הופך ל־נקטע עד המשך מפורש; פתיחת CodeNomad מחדש אינה מפעילה אותו מחדש. |
לאחר הפעלה מחדש, בדקו את ההרצה הממתינה ובחרו המשך כשתהיו מוכנים. המשך מיישב את ההרצה הקיימת בלי לשלוח את קלט המתאם שלה פעמיים; הוא אינו מבטיח המשך של תור מקורי שנקטע. תור שנחתך בהפעלה מחדש יכול להסתיים ללא דוח, עם הופסקה בגלל הפעלה מחדש. אל תשתמשו בהפעלה מחדש כדרך לנסות שוב השפעות צד של כלים.
משימות פועלות עם יישומי שולחן העבודה ועם שרת CodeNomad עצמאי. כשהלוח מציג בקרת המשימה אינה זמינה, ההודעה שלו מציינת את הסיבה:
| סיבה | מה לעשות |
|---|---|
| סביבת העבודה של OpenCode אינה מוכנה | חברו מחדש את הפרויקט, ואז רעננו. |
| OpenCode לא טען את תוסף המשימות | רעננו בעוד רגע; אם המצב נמשך, השתמשו ב־טעינה מחדש של תצורת OpenCode ב־הגדרות → OpenCode. |
| OpenCode לא הצליח לטעון את תוסף המשימות | קראו את השגיאה שלו ברשימת התוספים, ואז רעננו לאחר שתוקנה. |
| שרת CodeNomad לא הצליח לפתוח את חיבור המשימות המקומי שלו (127.0.0.1) | בדקו את יומן השרת; טעינה מחדש של OpenCode לא תעזור. |
השהיה, עצירה ותוצאות לא ודאיות
- בחרו את הרשומה ובדקו את מצבה הנוכחי ואת השיחה לפני פעולה.
- השתמשו בסמל ההשהיה לעצירה שניתן לחדש, או בסמל העצירה ובאישור לעצירה סופית. עצות הריחוף החד־פעמיות הן השהיית משימה ו־עצירת משימה לצמיתות; עצות לוחות זמנים מציינות את לוח הזמנים.
- אם התוצאה אינה מאושרת, השתמשו ב־בדיקת מצב / בדיקת מצב הבקרה לקריאת התוצאה הקיימת. אל תוציאו פעולה חלופית כדי לעקוף אי־ודאות.
- לפעולות חד־פעמיות, רענון ושליחה מחדש של הפעולה שלא אושרה בכותרת בודק תחילה מצב ושולח מחדש רק את אותה פעולה מדויקת שעדיין אינה מאושרת, בעקבות לחיצה מפורשת שלכם.
השהיה חד־פעמית קוטעת את המשפחה המקורית של המשימה ומשהה תיאום; עצירה מבטלת גם קלטים/מסירות בתור של המשפחה והיא סופית. אלו פעולות מוגבלות: ייתכן שחלק מתתי-הסוכנים עדיין פועלים. אומר שהעצירה אינה שלמה. בדקו את התוצאה שנשמרה והשתמשו בניסיון החוזר המפורש שלה במקום להניח שכל השפעות המעטפת/הכלים בוטלו. חידוש מודיע למתאם על צאצאים שנקטעו; עליו להחליט כיצד להמשיך את העבודה.
השהיה/עצירה יומיות מבטלות תזמון ומבקשות קטיעה של גורמי שורש רשומים, לרבות המתאם והמומחים העצמאיים, אך אינן מוכיחות שאותן שיחות או צאצאיהן נעצרו. בדקו את המשפחות המקוריות. עצירה היא סופית: לוח זמנים שנעצר אינו יכול לפעול, להתחדש או לרוץ עכשיו. בדיקת ההרצה מיישב הרצה ממתינה בלי לשלוח אותה שוב. כשלי בדיקה מתוזמנת זמניים מציגים את הכשל האחרון שלהם ומנסים שוב אוטומטית; אובדן תשובה לבקרת משתמש אינו גורם לשליחה אוטומטית מחדש של הבקרה.
למתאם חד־פעמי הנמצא בסרק ללא הדוח שלו, פעולת ▶ הראשית יכולה לאמת ולהתאושש; למטלות יש התאוששות ממוקדת לדוח חסר כשזכאיות. ההתאוששות בודקת תחילה פעילות מקורית, צאצאים והמתנות; פעילות לא ידועה מסרבת לקבלה להרצה. היא אינה שולחת מחדש הקצאות או מחליפה את התוכנית. פתחו שיחות כדי לפתור שאלות, אישורים, מעטפות או עבודת רקע שנותרו.
אם יצירה אינה מאושרת, החלון שומר את הבקשה שנשלחה ומשבית יצירה נוספת לאותו פרויקט; מחיקת worktree עשויה להישאר מעוכבת. רענון רק קורא מצב. סגירת העורך ופתיחתו מחדש אינן מתקנות זאת. לפני טעינת החלון מחדש, בדקו את רשימת המשימות: טעינה מחדש מנקה את הנעילה המקומית, לא הוכחה שהיצירה נכשלה. אל תיצרו בעיוורון כפילות לאחר טעינה מחדש או הפעלה מחדש.
עריכה, מחיקה וניקוי שיחות
השתמשו ב־עריכת המשימה שנבחרה במשימה חד־פעמית הניתנת לעריכה; בהתנגשות, סגרו/פתחו מחדש את העורך לטעינת המהדורה הנוכחית במקום לדרוס אותה. לוחות זמנים יומיים אינם מציעים פקדי עריכה/מחיקה.
- למשימה חד־פעמית שכבר אינה נחוצה, בחרו מחיקת המשימה שנבחרה… ובדקו את האישור.
- אפשר לסמן למחוק גם שיחות מומחים שנוצרו עבור משימה זו לפני האישור.
- בדקו ניקוי שיחות למספרים שהוסרו/נשמרו/ממתינים. נסו שוב רק את הניקוי הרשום שנותר, אם מוצע.
מחיקת משימה אינה זהה לעצירתה; השתמשו בעצירה ובדקו עבודה שנותרה תחילה. מתאמים ושיחות בשימוש חוזר נשמרים. גם מומחים משותפים, מועברים, בעלי ילדים או שלא ניתן לאמת בעלות עליהם עשויים להישמר. ניקוי חלקי אינו מוחזר לאחור ואינו מושלם בשקט ברקע. היסטוריית ניקוי שהושלם נשארת זמינה בקורא הסקירה.
ראו אישורים, שיחות ו־הגדרת OpenCode לעבודה מקורית ולפקדי שירות.