שיחות

CodeNomad מציג סשנים מקוריים של OpenCode כשיחות, עם היררכיה לעבודה מואצלת ופקדים נפרדים למה שתשלחו בהמשך.

הודעות מציגות Markdown, קוד, הבדלים ותמונות נתמכות מתוצאות כלים. העתקת טקסט, חיפוש בהיסטוריה המלאה ודיבור משתמשים בהיטלי טקסט, לא בבתי תמונה מוטמעים. תוכן ההודעות משנה נראות בלי למחוק חלקים שמורים; היסטוריה מבחין בין פקדי תצוגה לניקוי.

כותרות החשיבה והכלים מציגות כמה זמן נמשך כל שלב, בספירה חיה בזמן שהוא רץ; משכים של פחות משנייה אינם מוצגים. כאשר טוקנים מוצג ב־תוכן ההודעות (התבנית הכול מציגה אותו), כל הודעת סוכן מסתיימת בשורת טוקנים ועלות אחת אחרי הטקסט הסופי שלה. שורה זו מסכמת את ההודעה ואת ההודעות המכילות את הכלים והחשיבה שהפעולה הסר כלים וחשיבה מהתשובה הזו שלה מכסה, בתוך התמליל הטעון; הרחיבו אותה לספירות החשיבה והמטמון. לשלבים שרק הריצו כלים אין שורה משלהם.

איתור שיחות וניווט ביניהן

1. בחרו שורה תחת סשנים, או השתמשו ב־סשן חדש להתחלת שיחת הורה.
2. הרחיבו את החץ של הורה כדי לראות את תת־הסשנים שלו. חץ מכווץ מציג את המצב הדחוף ביותר של צאצאיו: זקוקים לקלט, עובדים, או סיימו לאחרונה (במנוחה); תיאור הכלי שלו סופר אותם.
3. השתמשו ב־חפש סשנים…, ב־סשנים ראשיים / תת־סשנים, במסנן worktree ובמיון פעילות, שם או Worktree לצמצום הרשימה.
4. השתמשו ב־אחורה וב־קדימה בסרגל הצד כדי לחזור לשיחות שהצגתם.

עיון רגיל הוא היררכי; תוצאות חיפוש/סינון הן רשומות שטוחות עם הזהות וה־worktree של כל שיחה. תת־סשן שמתחיל לעבוד נחשף אוטומטית רק תחת משפחת השיחה הפעילה. כיווץ הענף מבטל את החשיפה האוטומטית עבור הצאצאים שפועלים באותו רגע.

אחורה/קדימה הם היסטוריית ביקורים לכל לשונית פרויקט ולכל חלון, לא סדר הרשימה. היא נשמרת בזיכרון, מדלגת על שיחות לא זמינות/שנמחקו ואינה משוחזרת לאחר הפעלה מחדש. בחירת שיחה חדשה לאחר חזרה אחורה מחליפה את המסלול קדימה. סשן קודם / סשן הבא בלוח הפקודות עוברים במקום זאת במחזור ברשימה הגלויה.

בחירת סוכן, מודל וחשיבה

1. השתמשו בבוררי הסוכן והמודל בשורה התחתונה של שדה הקלט לפני שליחה.
2. אם המודל חושף וריאנטים, בחרו את מאמץ ה־חשיבה שלו; ברירת מחדל משאיר את ברירת המחדל המקורית בשימוש.
3. שלחו את הקלט הבא ובדקו את מטא־נתוני הסוכן/המודל של התשובה בעת אבחון תוצאה.

שיחה חדשה מתחילה עם הסוכן ש־OpenCode קובע כברירת המחדל שלה, שתוסף יכול להגדיר, אלא אם תבחרו אחר. תיאורי הכלים של הבוררים מציגים את הקיצורים שלהם.

אלו בחירות הרצה לשליחות עתידיות, לא עריכות לתשובות קודמות. קריאת קטע ישן בציר הזמן אינה מחליפה את הבחירות הנוכחיות בשדה הקלט במטא־נתונים היסטוריים. נראות מודלים, מועדפים וחיבורי ספקים מנוהלים ב־ספקים.

טיוטות וקבצים מצורפים

1. כתבו בשיחה שנבחרה. מעבר בין שיחות שומר את הטיוטה שלה במקום לשלוח אותה.
2. לקבצים ממכשיר זה, בחרו צירוף קובץ… בתפריט פעולות נוספות של שדה הקלט, או גררו או הדביקו אותם; לחלופין הקלידו @ לבחירת קובצי פרויקט, סוכנים או מיומנויות.
3. בדקו את תגי הצירוף והסירו כל דבר שאינו מיועד לשליחה הבאה.

קובצי מכשיר חייבים להיות קריאים ולעמוד בתקציב הצירוף: לכל היותר 5 MiB לקובץ, 10 קבצים ו־20 MiB בסך הכול. קובץ שנדחה אינו מצורף; בדקו את ההודעה במקום להניח שכל הבחירה הצליחה.

בחירת מיומנות מסירה את האסימון @query ומוסיפה תג. שליחה מנקה את הבחירה בשדה הקלט, לא את ההוראות שכבר נשמרו ב־OpenCode עם ההודעה שנשלחה. הודעות היסטוריות שומרות תוויות מיומנויות. הסרת מיומנות בעת עריכת קלט בתור משאירה אותה מוסרת מהשליחה המחליפה.

בשולחן העבודה, שליחה מעבירה את מיקוד המקלדת לשיחה, כך שהחצים, מקשי הדפדוף ו־Space גוללים אותה; הקלדת תו מחזירה לשדה הקלט עם אותו תו. נקה את טקסט הפרומפט ב־פעולות נוספות (ברירת מחדל Ctrl/Cmd+K) מנקה את הטיוטה בשדה הקלט.

טיוטות הן מצב עבודה בצד הלקוח, לא הודעות מקוריות משותפות. שחזור בהפעלה יכול לשמר מצב נתמך של שדה הקלט, אך אל תתייחסו לטיוטה או לצירוף שלא נשלחו כאל גיבוי ואל תניחו שהם מופיעים במכשיר אחר. שמרו טקסט חשוב לפני ניקוי נתוני הפעלה או סגירת לקוח שמדיניות השחזור שלו מושבתת; ראו שולחן עבודה.

פקודות ומצב מעטפת

1. הקלידו /, בחרו פקודה מותאמת שהתגלתה וספקו את הארגומנטים שלה.
2. לפקודת מעטפת ישירה, הקלידו ! בתחילת שדה קלט ריק כדי להיכנס ל־מצב מעטפת.
3. שלחו את הפקודה. ליציאה ממצב מעטפת בלי להריץ, השתמשו ב־Escape, או ב־Backspace בשדה ריק.

רק שמות מוכרים של פקודות לוכסן עוברים בנתיב הפקודה המותאמת; /text לא מוכר הוא קלט רגיל. פקודות מותאמות משתמשות בהגדרתן המקורית. קבצים/תמונות מצורפים אינם נשלחים בנתיב פקודה זה ונשארים זמינים לקלט מאוחר יותר; טקסט שהודבק ומשמש בארגומנטים נפתר לתוך הארגומנטים.

מצב מעטפת מריץ בקשת מעטפת מקורית של הסשן, לא בקשה מהמודל להציע פקודה. הוא יכול לשנות קבצים ולהפעיל תהליכים במארח ההרצה. הגדרות סביבת הפרופיל חלות לפני הקלט, הפקודה המותאמת או בקשת המעטפת הבאים; הן אינן מפעילות שירות קיים מחדש. ראו שילובים ו־הגדרת OpenCode.

הכוונה, תור ועריכת הודעות המשך

1. ב־הגדרות → כללי, הפעילו את הכנסת הנחיות שנשלחו לתור כדי להכניס לתור הודעות המשך שנשלחות בזמן שהסשן עסוק; השאירו אותו כבוי (ברירת המחדל) כדי לכוון את המשימה הרצה.
2. כשהסשן עסוק, שלחו הודעת המשך בהתנהגות זו. להתנהגות האחרת, בחרו הוסף הודעה לתור או הזרק עכשיו בתפריט פעולות נוספות של שדה הקלט, או השתמשו בקיצור השליחה החלופית (ברירת מחדל Alt+Enter ב־Windows וב־Linux, Cmd+Shift+Return ב־macOS; ראו קיצורים).
3. בתור הקלטים, השתמשו ב־הזרק עכשיו, ב־העבר לתור, ב־ערוך הנחיה בתור או ב־הסר הנחיה מהתור כל עוד הרשומה ממתינה.

במנוחה, שליחה רגילה משתמשת בנתיב המיידי הרגיל ללא תלות במתג זה, והחלופה ב־פעולות נוספות אינה זמינה. עריכה מחזירה קלט ממתין ואת צירופיו הניתנים להסרה לשדה הקלט; בטל עריכה יוצא מזרימת העריכה. קלט שכבר נצרך ב־OpenCode אינו עוד רשומה ממתינה הניתנת לעריכה. הסרת רשומה אינה מבטלת עבודה שכבר בוצעה.

אם עדכון תור נכשל, בדקו את התור החי לפני ניסיון חוזר. קבלה להרצה אינה הוכחה שהמודל צרך הודעת המשך, וחיבור מחדש אינו היתר לשלוח אותה שוב.

שאלת צד באמצעות /btw

1. שלחו /btw your question בשיחה קיימת, או /btw לפתיחת חלון שאלת הצד.
2. קראו את התשובה, השתמשו ב־העתק תשובה, או בחרו בטל שאלה כשהיא ממתינה.
3. סגרו את החלון בסיום.

זו בקשת מודל נפרדת אחת המשתמשת בהקשר הסשן. היא אינה מריצה לולאת כלים, מבצעת פעולות או מוסיפה את השאלה/התשובה לשיחה. קבצים/תמונות מצורפים נשארים בשדה הקלט; טקסט שהודבק ומשמש בשאלה נכלל כטקסט. זו אינה שיחה מתמשכת חדשה או דרך חלופית לשגר עבודה.

סגירה מבטלת את בקשת הצד הממתינה בלי לקטוע את הסשן הראשי. עזיבת השיחה הפעילה מנקה את החלון הארעי הזה; העתיקו תחילה כל מה שנחוץ לכם. תשובות ריקות/שגיאות מופיעות כאן במקום להפוך להודעות בתמליל.

פיצול, ביטול והתאוששות מהרצה שנכשלה

1. בהודעה, בחרו פצל אחרי הודעה זו ליצירת שיחה אחרי אותה נקודה בלי להחליף את המקור.
2. לביטול, בדקו בזהירות בטל שינויים עד כאן (מוחק הודעות). הלוח מציע בטל הודעה אחרונה ו־ביצוע מחדש של ההודעה האחרונה לביטול המדורג.
3. אם ההרצה נכשלת, בדקו שגיאת סשן, את שגיאת התשובה וכל פרטי השליחה נכשלה לפני שליחה נוספת.

פיצול מעתיק את הקשר השיחה עד הנקודה שנבחרה; הוא אינו יוצר worktree של Git או מבודד קבצים. החזרה לאחור אינה ניווט בלבד. בדקו השפעות על קבצים ואת גבול הביטול לפני המשך; השתמשו בפיצול כשאתם רוצים דיון חלופי בלי לכתוב מחדש את המסלול המקורי.

סטטוס מנסה שוב עם ספירה לאחור פירושו ש־OpenCode מנסה מחדש בעצמו לאחר שגיאת ספק; המתינו לו או עצרו את הסשן במקום לשלוח שוב. שליחה שנכשלה משחזרת את הטיוטה והצירופים שנוסו אם הדבר לא ידרוס הקלדה חדשה יותר. הרצה שנכשלה אולי כבר הפעילה כלים: בדקו קבצים, בקשות ממתינות ופעילות מקורית לפני ניסיון חוזר. טען הודעות מחדש או טען מחדש סשן קוראים מצב; אף אחת אינה הוראה לחזור על שינוי. עצור סשן קוטע הרצה, לא מבטל שינויי קבצים או שירותים חיצוניים.