מפת הפרויקט
בתחילת כל משימה Ingot נותן לסוכן סקירה קצרה ומדורגת של הפרויקט הפתוח, כדי שימצא מהר יותר את הקבצים הנכונים ויקרא פחות. זה עובד בכל מבנה: חבילה אחת, monorepo, אפליקציית מובייל בלי תיקיית src, או כמה פרויקטים זה לצד זה.
Project map (ranked overview of the open project; read files with ingot/read_file before changing them):
Project: acme (1,284 files; TypeScript 902, Swift 41, Kotlin 38)
Frameworks: Turborepo, Next.js, React, React Native, Expo
Packages: apps/web/ (Next.js, React), apps/mobile/ (React, React Native, Expo), packages/ui/ "@acme/ui" (React)
Entry points: apps/mobile/index.js, packages/ui/source/index.ts, apps/web/app/page.tsx
Commands: dev: `pnpm run dev`; test: `pnpm run test`
Key files (most imported first):
- packages/ui/source/index.ts ← 14 file(s): Button, Card, Sheet
מה יש בה
- חבילות: כל תיקייה עם manifest (
package.json,pyproject.toml,go.mod,Cargo.toml,pubspec.yaml, Gradle, Podfile, .csproj), עם ה-frameworks שלה. דוגמאות ו-fixtures של בדיקות לא נכללות. - נקודות כניסה:
main, module, binו-react-nativeמכלpackage.json(נתיב מקומפל כמוdist/index.jsמוצג כקובץ המקור שלו, איפה שהוא נמצא), וקבצים בשםindex, main, app, serverאוcliליד manifest או תיקייה אחת מתחתיו, לא משנה איך התיקייה נקראת. - פקודות: הסקריפטים של השורש עם מנהל החבילות שלכם; פרויקט בלי manifest בשורש מקבל את הפקודות של החבילה הראשית שלו, שרצות בתיקייה שלה.
- קבצים מרכזיים: מדורגים לפי כמה קבצים מייבאים אותם. ה-imports נעקבים דרך נתיבים יחסיים, שמות חבילות ב-workspace (
@acme/ui), כינוייpathsשל tsconfig (@/components) ומודולי Python תחת כל תיקייה.
שימוש
הריצו Ingot: Show Project Map כדי לפתוח את המפה שהסוכן מקבל. היא נבנית מחדש כמה שניות אחרי שקבצים משתנים.
| הגדרה | ברירת מחדל | השפעה |
|---|---|---|
ingot.agent.repoMap.enabled | true | לתת לסוכן את המפה |
ingot.agent.repoMap.tokenBudget | 2000 | מקסימום טוקנים שהמפה תופסת (קודם פחות קבצים מרכזיים, אחר כך רק שמות) |
המפה הולכת לפי אותם קובצי התעלמות כמו החיפוש בקוד.