סוגי תוספים
החנות של Ingot מקבלת חמישה סוגי תוספים. לכל ingot.json יש type אחד, שקובע את הקטגוריה בחנות ואיזו רשומה ב-contributes היא חובה; חבילה יכולה להוסיף מעליו חוקים, Habits, פקודות ושרתי MCP.
type | קטגוריה בחנות | חובה ב-contributes | רץ ב- |
|---|---|---|---|
theme | ערכות צבעים | themes | Ingot |
rules | חבילות חוקים | rules | Ingot |
habits | חבילות Habits | habits | Ingot |
mcp | שרתי MCP | mcpServers | Ingot |
rex-template | תבניות Rex | rexTemplates | Zaprex |
צרו כל אחד מהם עם 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 של הפריימוורק. כל שדה מוסבר במניפסט.