סוגי תוספים

החנות של Ingot מקבלת חמישה סוגי תוספים. לכל ingot.json יש type אחד, שקובע את הקטגוריה בחנות ואיזו רשומה ב-contributes היא חובה; חבילה יכולה להוסיף מעליו חוקים, Habits, פקודות ושרתי MCP.

typeקטגוריה בחנותחובה ב-contributesרץ ב-
themeערכות צבעיםthemesIngot
rulesחבילות חוקיםrulesIngot
habitsחבילות HabitshabitsIngot
mcpשרתי MCPmcpServersIngot
rex-templateתבניות RexrexTemplatesZaprex

צרו כל אחד מהם עם ingot init <folder> --type <type>, ואז עקבו אחרי מדריך היוצרים.

ערכת צבעים

ערכת צבעים בפורמט ה-JSON הסטנדרטי של ערכות צבעים, עם colors (ממשק) ו/או tokenColors (תחביר). Ingot מציג אותה תחת Settings › Appearance › Theme.

"contributes": {
  "themes": [{ "id": "acme-dark", "label": "Acme Dark", "uiTheme": "dark", "path": "themes/acme-dark.json" }]
}
  • uiTheme הוא dark או light; Ingot משתמש בו לכל מה שערכת הצבעים לא צובעת.
  • חבילה אחת יכולה להכיל גרסה כהה וגרסה בהירה: הוסיפו שתי רשומות.
  • בדיקה: ingot try <project>, ואז בחרו את ערכת הצבעים ב-Settings.

חבילת חוקים

קבצי Markdown (.md) או .mdc לתיקייה .ingot/rules/ של הפרויקט. הסוכן קורא אותם בכל בקשה שמתאימה להם (ראו חוקים).

---
description: React conventions
globs: "**/*.{ts,tsx}"
alwaysApply: false
---

- Prefer named exports over default exports.
- Co-locate a test with every component.

הוסיפו קבצים עם ingot add rule <name>. שמרו כל חוק קצר וקונקרטי: הסוכן מציית ל-"Use zod for request validation" טוב יותר מאשר ל-"Validate input properly".

חבילת Habits

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

{
  "id": "no-console-log",
  "title": "Rejected edits that add console.log calls",
  "match": "console\\.log\\(",
  "rule": "- Don't add console.log calls. Use the project's logger instead.",
  "threshold": 3
}
שדההערות
idמילים באותיות קטנות מחוברות ב--
titleמה הדפוס תופס, עד 120 תווים
matchביטוי רגולרי של JavaScript, שנבדק מול השורות שנדחו
ruleנוסח החוק ש-Habits מציע (עד 2,000 תווים)
thresholdאופציונלי: אחרי כמה דחיות Habits מציע את החוק, 1 עד 20

הוסיפו דפוס עם ingot add habit <id> --match "<regex>" --rule "<text>". החנות דוחה דפוס שה-match שלו אינו ביטוי רגולרי תקין.

שרת MCP

שרת MCP נותן לסוכן כלים חדשים. חבילה מגדירה שרת אחד או יותר תחת mcpServers; Ingot כותב אותם ל-.ingot/mcp.json (ראו שרתי MCP).

שרת מקומי שנמצא בחבילה:

"files": ["server"],
"contributes": {
  "mcpServers": {
    "word-tools": { "command": "node", "args": ["${extensionDir}/server/index.mjs"] }
  }
}

שרת מ-npm שצריך מפתח API:

"mcpServers": {
  "acme": { "command": "npx", "args": ["-y", "@acme/mcp-server"], "env": { "ACME_API_KEY": "Your Acme API key (Settings › API)" } }
}

שרת מרוחק: { "url": "https://mcp.acme.dev/sse" }.

  • ${extensionDir} מוחלף בתיקייה שבה התוסף מותקן.
  • env מפרט שמות של משתנים עם תיאור של מה להזין, לעולם לא את הערך. הערכים נשארים ריקים כשהשרת מותקן, והמשתמש ממלא אותם (ingot try מדפיס אילו מהם להגדיר). לעולם אל תשימו מפתח אמיתי בחבילה.
  • קוד שהשרת צריך חייב להופיע ב-files (נארזים רק קבצים שיש אליהם הפניה ורשומות files).
  • השלד מ-ingot init --type mcp הוא שרת stdio בלי תלויות עם כלי אחד; הריצו node server/index.mjs כדי לנסות אותו.

תבנית Rex

עבודה ש-Rex, הסוכן בענן של Zaprex, מריץ בשבילכם בסביבה מבודדת: קובץ Markdown עם frontmatter אופציונלי (title, ו-schedule כביטוי cron) וההוראות בגוף הקובץ.

---
title: Nightly test fix
schedule: "0 3 * * 1-5"
---

Run the test suite. If a test fails, fix the cause with the smallest change and open a pull request.

תבניות Rex מופיעות בחלק של Zaprex בחנות. כדי להריץ אותן צריך תוכנית Zaprex עם Rex (מחירים).

שילוב

כל סוג יכול לכלול גם:

  • rules: קבצי חוקים נוספים
  • habits: דפוסי Habits נוספים
  • commands: פקודות סלאש, פרומפטים ב-Markdown שהופכים ל-/<name> בצ'אט של הסוכן
  • mcpServers: שרתים שהתוסף צריך

לדוגמה, חבילת rules לפריימוורק יכולה להוסיף פקודה /migrate ואת שרת ה-MCP של הפריימוורק. כל שדה מוסבר במניפסט.