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

התאום הדיגיטלי של הפרויקט

מודל חי של הפרויקט שנבנה מהקוד: החבילות, הקומפוננטות, הנתיבים, ה-APIs, הבדיקות והייבואים שמחברים ביניהם. הלוח Project Twin מציג את המפה ועונה על השאלה מה נוגע בקובץ הזה? עבור הקובץ הפתוח, והתאום מתעדכן בכל שמירה.

Silver התאום הדיגיטלי של הפרויקט כלול ב-Silver,‏ Gold ו-Platinum. בתוכנית אחרת הלוח נשאר, מציין איזו תוכנית כוללת אותו, ושום דבר לא נבנה.

הלוח Project Twin ליד src/cartStore.ts: ספירה לפי שכבות, ואז What touches this file? עם 3 קבצים שמייבאים אותו, הבדיקות שמגיעות אליו, POST /orders ו-/checkout מעליו, ו-money.ts שהוא מייבאהלוח Project Twin ליד src/cartStore.ts: ספירה לפי שכבות, ואז What touches this file? עם 3 קבצים שמייבאים אותו, הבדיקות שמגיעות אליו, POST /orders ו-/checkout מעליו, ו-money.ts שהוא מייבא
הלוח Project Twin ליד src/cartStore.ts: ספירה לפי שכבות, ואז What touches this file? עם 3 קבצים שמייבאים אותו, הבדיקות שמגיעות אליו, POST /orders ו-/checkout מעליו, ו-money.ts שהוא מייבא

פתיחת הלוח

לוחצים ⌥⇧T (Alt+Shift+T) או בוחרים Project Twin: Show Project Twin ב-Find Action. הלוח נפתח משמאל. בפעם הראשונה Ingot סורק את הפרויקט ובונה את התאום; בפרויקט גדול זה לוקח כמה שניות.

מה יש בתאום

שכבהמה נספר
חבילותתיקיות עם package.json משלהן (אחת בפרויקט של חבילה אחת, כל חבילה במונוריפו)
קומפוננטותקומפוננטות מיוצאות בקבצי .jsx ו-.tsx (שמות ב-PascalCase), וקבצי .vue ו-.svelte
נתיביםנתיבים לפי מערכת הקבצים (pages/cart.tsx,‏ app/orders/[id]/page.tsx,‏ routes/…) וטבלאות נתיבים (<Route path="/checkout">,‏ { path: '/cart' })
APIshandlers כמו router.post('/orders') או app.get('/users/:id'), מחלקות @Controller עם @Get / @Post,‏ pages/api/… ו-app/api/…/route.ts
בדיקות*.test.*,‏ *.spec.*, קבצים ב-tests/,‏ __tests__/ ו-e2e/,‏ test_*.py
מודוליםכל קובץ קוד אחר

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

לוחצים על שכבה כדי לראות את הקבצים שלה, המיובאים ביותר קודם; לוחצים על קובץ כדי לפתוח אותו.

מה נוגע בקובץ הזה?

החלק העליון של הלוח עוקב אחרי הקובץ בעורך הנוכחי:

קבוצהקבצים
Imported byקבצים שמייבאים אותו ישירות; הכותרת אומרת כמה
Tests that reach itבדיקות שמייבאות אותו, או מייבאות קובץ שמייבא אותו
Routes and APIs above itנתיבים ו-APIs שמגיעים אליו דרך ייבואים (עד ארבעה צעדים)
It importsקבצי הפרויקט שהוא מייבא

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

תמיד מעודכן

  • התאום נשמר ב-.ingot/twin/twin.json בפרויקט. לתיקייה שלו יש .gitignore משלה, כך שהוא אף פעם לא נכנס לקומיט: הוא נבנה מחדש מהקוד.
  • כל קובץ ששומרים, מוסיפים או מוחקים מעדכן רק את הקובץ הזה בתאום, תוך רגע.
  • כשפותחים את הפרויקט שוב, רק קבצים שהשתנו בינתיים נקראים מחדש.
  • Project Twin: Rebuild Project Twin (או ↻ בלוח) בונה אותו מחדש מאפס.

כיבוי

התאום פעיל כברירת מחדל. מכבים אותו ב-Settings › Features › Project Digital Twin; הלוח נסגר והתאום מפסיק להתעדכן.

הגדרהערכיםברירת מחדל
ingot.twin.enabledtrue או falsetrue

טוב לדעת

  • בסביבת עבודה עם כמה תיקיות, התאום מכסה את התיקייה הראשונה.
  • מפת הפרויקט שהסוכן קורא בתחילת משימה היא סקירה נפרדת ומקוצרת.
  • בקרוב: לשאול את התאום שאלות במילים פשוטות, לתת אותו לסוכן כהקשר, ושכבות נוספות (state stores, טבלאות מסד נתונים, בעלים, כיסוי).