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

מציג ההבדלים ומיזוג חכם

מציג ההבדלים של Ingot מחיל או מבטל כל שינוי עם חצים בשוליים, מקבל או דוחה קובץ שלם וממזג קונפליקטים בתצוגה תלת-כיוונית.

לכל פעולה יש קיצור מקלדת. פותחים את המציג בלחיצה כפולה על קובץ ב-Local Changes (⌘K, Ctrl+K), בחלון ה-commit או בבלוק Agent review שמתחת להרצה של הסוכן בצ'אט. הכותרת סופרת Change 1 of 3, והקבצים ששונו מופיעים בצד.

מציג ההבדלים זה לצד זה: חצי >> בשוליים השמאליים וחצי << בשוליים הימניים לכל שינוי, עם Reject all ו-Accept all בכותרתמציג ההבדלים זה לצד זה: חצי >> בשוליים השמאליים וחצי << בשוליים הימניים לכל שינוי, עם Reject all ו-Accept all בכותרת
מציג ההבדלים זה לצד זה: חצי >> בשוליים השמאליים וחצי << בשוליים הימניים לכל שינוי, עם Reject all ו-Accept all בכותרת

להחיל או לבטל כל שינוי

לכל שינוי יש שני חצים בשוליים, כמו במציג ההבדלים של IDE שולחני:

חץאיפהמה הוא עושה
»בשוליים השמאלייםRevert this change: הטקסט הקודם חוזר לקובץ שלכם, והקובץ נשמר. ביטול עובד כרגיל (⌘Z, Ctrl+Z).
«בשוליים הימנייםApply this change: השינוי נשאר. הוא יוצא מהרשימה ונשאר מוחל גם כשפותחים את המציג שוב.

במצב Unified שני החצים נמצאים באותם שוליים. המונה מתעדכן תוך כדי, וכשלא נשאר כלום הוא מציג No changes.

בעריכות של הרצת סוכן בצ'אט, « גם מקבל את העריכה של הסוכן בשורות האלה, ו-» מחזיר אותן למצב שלפני ההרצה.

לקבל הכול או לדחות הכול

Accept all משאיר את כל השינויים בקובץ, ו-Reject all מבטל את כולם. שניהם בכותרת ופועלים על הקובץ שמוצג; בחרו קובץ אחר בצד כדי להמשיך.

לערוך את צד הקובץ

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

מיזוג חכם לקבצים עם קונפליקט

קובץ עם קונפליקט מיזוג (אחרי git merge,‏ git rebase או git cherry-pick) מוצג עם סמל מיזוג ברשימה ונפתח בתצוגה התלת-כיוונית. Smart merge רץ מעצמו כשהקובץ נפתח: כל שינוי שרק צד אחד עשה, או ששני הצדדים עשו באותה צורה, נכנס לתוצאה. מה שנשאר הם הקונפליקטים האמיתיים, שבהם שני הצדדים שינו את אותן שורות בצורה שונה. הם מודגשים, והכותרת מציגה 1 conflict · 2 auto-merged.

התצוגה התלת-כיוונית: שלכם משמאל, התוצאה באמצע עם הקונפליקט מודגש, שלהם מימין, ו-1 conflict · 2 auto-merged בכותרתהתצוגה התלת-כיוונית: שלכם משמאל, התוצאה באמצע עם הקונפליקט מודגש, שלהם מימין, ו-1 conflict · 2 auto-merged בכותרת
התצוגה התלת-כיוונית: שלכם משמאל, התוצאה באמצע עם הקונפליקט מודגש, שלהם מימין, ו-1 conflict · 2 auto-merged בכותרת

עריכות באותה שורה

Smart merge מסתכל גם בתוך שורה ששני הצדדים ערכו. הוא מפרק את השורה לטוקנים (שמות, מספרים, מחרוזות, סימני פיסוק ורווחים) וממזג אותם: אם שיניתם את השם total ל-count והם שינו את add(a, b) ל-add(a, c), התוצאה היא count = add(a, c). אותו דבר עובד לשני ארגומנטים שונים, או כשצד אחד מוסיף תחילית והשני סיומת. שינוי ששני הצדדים עשו באותה צורה נלקח פעם אחת. כשבקטע נוספה או נמחקה שורה, השורות מותאמות קודם, וכל שורה שנערכה ממוזגת בנפרד.

השורות האלה מסומנות auto-resolved same-line בתוצאה, עם שרביט בשוליים, והכותרת סופרת אותן: 1 conflict · 2 auto-merged (1 same-line). העבירו את העכבר מעל התגית או השורה כדי לראות למה היא מוזגה. »,‏ « ו-× עדיין לוקחים צד או את הבסיס, ו-Smart merge מחזיר את השורה הממוזגת.

זה נשאר קונפליקט כששני הצדדים שינו את אותו טוקן בצורה שונה (למשל MODE = "safe" ו-MODE = "slow"), או כששניהם הוסיפו טקסט שונה באותו מקום.

התצוגה התלת-כיוונית עם count = add(a, c) בתוצאה מסומן auto-resolved same-line, שורת MODE עדיין בקונפליקט, ו-1 conflict · 2 auto-merged (1 same-line) בכותרתהתצוגה התלת-כיוונית עם count = add(a, c) בתוצאה מסומן auto-resolved same-line, שורת MODE עדיין בקונפליקט, ו-1 conflict · 2 auto-merged (1 same-line) בכותרת
התצוגה התלת-כיוונית עם count = add(a, c) בתוצאה מסומן auto-resolved same-line, שורת MODE עדיין בקונפליקט, ו-1 conflict · 2 auto-merged (1 same-line) בכותרת

התצוגה התלת-כיוונית

שלוש החלוניות נגללות יחד:

חלוניתמה היא מציגה
שמאלשלכם: הענף שלכם (למשל main (yours, read-only))
אמצעResult: מה שייכתב. אפשר להקליד בה.
ימיןשלהם: ה-commit שממוזג פנימה (MERGE_HEAD, או REBASE_HEAD בזמן rebase)
פעולהמה היא עושה
» משמאלמכניס את השינוי שלכם לתוצאה. בקונפליקט אפשר לקחת את שני הצדדים: התוצאה מקבלת קודם את שלכם ואחר כך את שלהם.
« מימיןמכניס את השינוי שלהם לתוצאה.
×מתעלם מהשינוי: התוצאה שומרת שם את טקסט הבסיס.
Smart mergeמחיל שוב את כל השינויים בלי קונפליקט.
Resetחוזר לטקסט הבסיס.
Accept left / Accept rightלוקח צד שלם.
Applyכותב את התוצאה, מוסיף אותה ל-stage ומסמן את הקובץ כפתור. הכפתור מושבת עד שכל קונפליקט נפתר או שמתעלמים ממנו.

כשכל הקונפליקטים נפתרו, הכותרת מציגה All conflicts resolved. אחרי Apply הקובץ הוא שוב שינוי רגיל ומוצג בתצוגה הדו-כיוונית.

קיצורי מקלדת

כל קיצור עובד כשהמציג פתוח ומופיע בתיאור הקופץ של החץ או הכפתור שלו. כל הפעולות נמצאות גם ב-Find Action‏ (⌘⇧A, Ctrl+Shift+A) תחת Diff Viewer.

פעולהmacOSWindows ו-Linux
השינוי הבאF7F7
השינוי הקודם⇧F7Shift+F7
החלת שינוי («, או לקחת את שלהם בתלת-כיווני)⌘⌥⇧←Ctrl+Alt+Shift+←
ביטול שינוי (», או לקחת את שלכם בתלת-כיווני)⌘⌥⇧→Ctrl+Alt+Shift+→
לקבל הכול (Smart merge בתלת-כיווני)⌘⇧EnterCtrl+Shift+Enter
לדחות הכול (Reset בתלת-כיווני)⌘⇧⌫Ctrl+Shift+Backspace
התעלמות משינוי (תלת-כיווני)⌘⌥⇧⌫Ctrl+Alt+Shift+Backspace
סגירהEscEsc
התיאור הקופץ של חץ >>:‏ Revert this change, עם הקיצור שלוהתיאור הקופץ של חץ >>:‏ Revert this change, עם הקיצור שלו
התיאור הקופץ של חץ >>:‏ Revert this change, עם הקיצור שלו

הגדרות

פתחו את Settings › Tools › Agent review before commit, או הגדירו את המפתח בהגדרות המשתמש או ב-.ingot/settings.json של הפרויקט:

הגדרהברירת מחדלמה היא עושה
ingot.diffViewer.autoMergetrueמיזוג חכם של קבצים עם קונפליקט כשהם נפתחים בתצוגה התלת-כיוונית. כבו אותה כדי להתחיל מטקסט הבסיס.

מהטרמינל

ה-CLI של ingot מריץ את אותו מיזוג חכם על שלושה קבצים, בסקריפטים או כ-merge driver של git:

npx @ingotide/cli merge yours.ts base.ts theirs.ts                   # מדפיסה את התוצאה; יוצאת עם 1 כל עוד נשארו קונפליקטים
npx @ingotide/cli merge yours.ts base.ts theirs.ts --output yours.ts # כותבת אותה במקום
npx @ingotide/cli merge yours.ts base.ts theirs.ts --conflicts theirs --json
git config merge.ingot.driver "ingot merge %A %O %B --output %A"

קונפליקטים נשארים עם סימוני diff3 ‏(<<<<<<<,‏ |||||||,‏ =======,‏ >>>>>>>) אלא אם --conflicts yours,‏ theirs או both לוקח צד. עריכות באותה שורה ממוזגות כמו במציג ונספרות כ-sameLine ב---json;‏ --line-only מכבה את זה ומתייחס לכל שורה ששני הצדדים ערכו כקונפליקט, כמו git. כל האפשרויות מופיעות במדריך ה-CLI.