כללי החנות

הכללים שכל תוסף מהקהילה בחנות של Ingot עומד בהם: דפים כנים, חבילות בטוחות, שמות ברורים וגרסאות שאפשר לסמוך עליהן. החנות בודקת אוטומטית את מה שהיא יכולה; השאר תלוי בכם, ודפים שמפרים את הכללים מוסרים.

כנות לגבי מה שהתוסף עושה

  • תארו מה התוסף עושה היום. בלי תוכניות עתידיות ובלי "בקרוב".
  • בלי מספרים מומצאים. מניפסטים לא יכולים לכלול מוני הורדות, התקנות, דירוגים, ביקורות או כוכבים, והחנות אף פעם לא מציגה אותם.
  • תיאור של שורה אחת (200 תווים), ואת הפרטים שימו ב-README.md, שמוצג בדף בחנות.
  • הסבירו איך משתמשים בו. כתבו מה לעשות אחרי ההתקנה: איזו ערכת צבעים לבחור, איזו פקודה להריץ, אילו כלים השרת מוסיף.

שמות ומיתוג

  • בחרו name ו-displayName שמתארים את התוסף. אל תשתמשו בשמות של מוצרים אחרים כך שייראה שהם יצרו אותו ("Official GitHub Theme").
  • אל תשתמשו במיתוג או בלוגואים של Ingot או Zaprex, ולא במילים "רשמי" או "מאומת". מזהי מפרסם שנראים רשמיים שמורים.
  • אל תעלו לוגואים של אחרים. החנות מציגה אריח צבעוני עם 1 עד 3 תווים (icon ב-ingot.json).
  • דפים מהקהילה מציגים תג קהילה. רק Ingot ו-Zaprex הם מפרסמים מאומתים.

בטיחות

  • בלי סודות בחבילות. לעולם אל תכללו מפתחות API, טוקנים או סיסמאות. בשרתי MCP, תארו כל משתנה ב-env ותנו למשתמשים למלא את הערכים שלהם.
  • בלי התנהגות נסתרת. שרת MCP או פקודה חייבים לעשות את מה שה-README שלהם אומר. בלי מעקב, בלי שליחת קוד או נתונים לאן שהמשתמש לא ביקש, בלי כרייה ובלי קוד מוסווה.
  • קבעו את מה שאתם מריצים. שרתי MCP שמופעלים עם npx צריכים לציין חבילה מדויקת (ועדיף גם גרסה), לא כתובת URL ולא סקריפט שמועבר ל-shell.
  • שאלו לפני שהורסים משהו. פקודות ותבניות Rex לא מוחקות קבצים, לא עושות force-push ולא נוגעות במערכות ייצור בלי שהמשתמש ביקש.
  • חוקים הם הוראות, לא התקפות. חוקים ותבניות לא מנסים לגרום לסוכן להתעלם מהמשתמש, להסתיר שינויים או להוציא נתונים.

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

רישוי

  • הגדירו ב-license מזהה SPDX וכללו קובץ LICENSE (ingot init כותב רישיון MIT).
  • פרסמו רק מה שיש לכם זכות לפרסם. ערכות צבעים שהועברו מעורכים אחרים חייבות לשמור על הרישיון והקרדיט המקוריים.

גרסאות

  • השתמשו בניהול גרסאות סמנטי: patch לתיקונים, minor לתוספות, major לשינויים ששוברים הגדרות קיימות.
  • כל העלאה צריכה גרסה חדשה וגבוהה יותר. מספרי גרסה לא חוזרים לשימוש, גם אחרי הסרה.
  • עדכנו את CHANGELOG.md; ingot version מוסיף את הכותרת בשבילכם.
  • הסירו גרסה שבורה ופרסמו תיקון, במקום להשאיר אותה בחנות.

הסרות ודיווחים

כדי לדווח על תוסף שמפר את הכללים (או את הזכויות שלכם), השתמשו בדיווח על התוסף בדף שלו בחנות, או פנו לתמיכה עם מזהה התוסף (publisher.name). Ingot רשאית להסיר תוסף, לבטל את הטוקנים של המפרסם שלו או לסגור חשבון מפרסם שמפר את הכללים או את מדיניות השימוש המקובל.

לפני שמפרסמים

  • ingot validate עובר
  • בדקתם עם ingot try בפרויקט אמיתי
  • ה-README מסביר מה התוסף עושה ואיך משתמשים בו
  • אין סודות, מפתחות או מידע אישי באף קובץ
  • license, LICENSE ו-CHANGELOG.md מוגדרים
  • הגרסה חדשה ועומדת ב-semver