כלים

QuietContext

משאיר פלט פקודות רועש מחוץ להקשר של הסוכן, עם פקודות qc ושבעה כלי MCP לחיפוש ולניווט במאגר.

הגדרה בעזרת סוכןלפרויקט

איזו בעיה הכלי פותר

יומן בדיקות ארוך או קריאה חוזרת של קבצים דוחקים הוראות שימושיות מתוך שיחת הסוכן. QuietContext שומר חומר גלם גדול מחוץ לשיחה ומחזיר תוצאות קצרות או הפניות שאפשר לחפש שוב. שורשי פרויקט נפרדים משתמשים במאגרי חיפוש נפרדים.

דרכים להשתמש בכלי

  • לקרוא כשל בדיקה בלי להציף את השיחה

    מריצים את פקודת הבדיקות האמיתית של הפרויקט דרך qc run. קוד היציאה המקורי נשמר, הפלט הארוך מתקצר וטקסט שהושמט ניתן לאחזור מהתיעוד שנשמר או באמצעות חיפוש.

  • למצוא סמל לפני קריאת קבצים שלמים

    משתמשים ב-qc repo map להתמצאות ואז ב-qc repo symbol MyType או ב-qc repo references MyType. מחליפים את MyType בשם מתוך הפרויקט כדי למצוא קודם את הקוד הרלוונטי.

  • להשתמש במסמך שוב בלי להדביק אותו מחדש

    מאנדקסים README או תיקיית תיעוד קטנה פעם אחת ומחפשים מונח מסוים מההגדרות. שומרים על אותה זהות פרויקט כדי ששאילתות מאוחרות יגיעו לאותו מאגר.

לפני שמתחילים

  • Node.js מגרסה 22.5 ו-npm; הארכיון המקומי המתועד תומך ב-Linux x64 וב-Windows x64.
  • ארכיון הגרסה וקובץ SHA256SUMS שפורסם לצדו. שכפול Git רגיל אינו כולל את קובץ ההפעלה המקומי של qc.
  • לקוח שתומך ב-MCP נדרש רק לשילוב עם סוכן; אפשר להשתמש ב-qc המקומי גם בנפרד.

התקנה והגדרה

  1. להוריד ולאמת את גרסת המועמדת

    מורידים מעמוד הגרסה המקושר ב-README את quietcontext-1.1.0-rc.3.tgz ואת SHA256SUMS לאותה תיקייה. ב-Linux מריצים את הבדיקה שלהלן; ב-Windows משווים את Get-FileHash לערך שפורסם.

    sha256sum -c SHA256SUMS

  2. להתקין את הארכיון המאומת

    מריצים מתיקיית ההורדה. כך מתקינים את כלי שורת הפקודה הארוז, ולא את חבילת context-mode מהפרויקט המקורי. בודקים קודם את מגבלות הגרסה והפלטפורמה.

    npm install -g ./quietcontext-1.1.0-rc.3.tgz
qc --version
qc status

  3. לחבר את הסוכן לפי הצורך

    בחיבור MCP מסוג stdio מגדירים ללקוח להפעיל quietcontext ולא qc. משתמשים בנתיב מלא אם הלקוח לא מוצא אותו. שומרים את השרתים הקיימים ובודקים ששבעת הכלים מופיעים בשיחה חדשה.

    [mcp_servers.quietcontext]
command = "quietcontext"

שימוש בפרויקט

  1. לסקור מאגר

    מריצים משורש הפרויקט. המפה היא סקירה כללית; ממשיכים בשאילתת סמל או הפניות כשצריך מיקום מדויק.

    qc repo map
qc run -- git status --short

  2. לאנדקס מסמך שאינו רגיש

    מתחילים ב-README של הפרויקט. תווית המקור עוזרת למצוא אותו שוב; בוחרים קובץ שמותר לעבד.

    qc index README.md --source project-readme

  3. לחפש ביטוי שידוע שקיים

    מחליפים את installation במילה מתוך ה-README. היעדר תוצאות הוא תוצאת חיפוש תקינה. משתמשים באותה תיקיית פרויקט או בנתיב --project מפורש באינדוקס ובחיפוש.

    qc search installation --source project-readme --full

איך יודעים שזה עובד

qc status מציג את גרסאות החבילה, המנוע והפרוטוקול; מפת המאגר מחזירה סקירה מוגבלת, וחיפוש ביטוי שאונדקס מחזיר את הטקסט שלו. הבדיקות האלה לבדן אינן מוכיחות שהשרת או הלקוח מחוברים.

לבקש מהסוכן להגדיר את הכלי

מעתיקים את הבקשה לסוכן תכנות שיש לו גישה לסביבה שלך. הבקשה מורה לו לבדוק את ההוראות העדכניות ולאמת את ההגדרה לפני שהוא מסיים.

אפשר גם לבחור את הטקסט ולהעתיק אותו ישירות.

מה כדאי לדעת מראש

החבילה המתועדת היא גרסת מועמדת לשחרור, ברישיון Elastic License 2.0 ולא MIT. הפקודות פועלות בהרשאות המשתמש המקומי; קיצור פלט אינו בידוד אבטחתי ואינו מבטיח חיסכון בטוקנים.

README העדכני של הפרויקט

סוכניםכלי פיתוח