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


פתיחת הלוח
לוחצים ⌥⇧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' }) |
| APIs | handlers כמו 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.enabled | true או false | true |
טוב לדעת
- בסביבת עבודה עם כמה תיקיות, התאום מכסה את התיקייה הראשונה.
- מפת הפרויקט שהסוכן קורא בתחילת משימה היא סקירה נפרדת ומקוצרת.
- בקרוב: לשאול את התאום שאלות במילים פשוטות, לתת אותו לסוכן כהקשר, ושכבות נוספות (state stores, טבלאות מסד נתונים, בעלים, כיסוי).