ערוץ CLI
ממשק שורת הפקודה הוא ערוץ ברירת המחדל ב-Triggerfish. הוא תמיד זמין, אינו דורש הגדרה חיצונית, והוא הדרך העיקרית שבה אתם מתקשרים עם הסוכן במהלך פיתוח ושימוש מקומי.
סיווג
ערוץ ה-CLI מוגדר כברירת מחדל לסיווג INTERNAL. משתמש הטרמינל תמיד מטופל כבעלים -- אין זרימת צימוד או אימות כי אתם מריצים את התהליך ישירות על המחשב שלכם.
מדוע INTERNAL? ה-CLI הוא ממשק ישיר ומקומי. רק מי שיש לו גישה
לטרמינל שלכם יכול להשתמש בו. זה הופך את INTERNAL לברירת מחדל המתאימה -- הסוכן יכול לשתף נתונים פנימיים בחופשיות בהקשר זה. :::
תכונות
קלט טרמינל גולמי
ה-CLI משתמש במצב טרמינל גולמי עם ניתוח מלא של רצפי ANSI escape. זה נותן לכם חוויית עריכה עשירה ישירות בטרמינל:
- עריכת שורה -- ניווט עם מקשי חצים, Home/End, מחיקת מילים עם Ctrl+W
- היסטוריית קלט -- לחצו Up/Down לסיבוב בין קלטים קודמים
- הצעות -- השלמת Tab לפקודות נפוצות
- קלט רב-שורתי -- הזינו פרומפטים ארוכים יותר באופן טבעי
תצוגת כלים קומפקטית
כאשר הסוכן קורא לכלים, ה-CLI מציג סיכום חד-שורתי קומפקטי כברירת מחדל:
tool_name arg resultהחליפו בין תצוגת כלים קומפקטית ומורחבת עם Ctrl+O.
הפסקת פעולות רצות
לחצו ESC להפסקת הפעולה הנוכחית. זה שולח אות ביטול דרך ה-orchestrator לספק ה-LLM, ועוצר את הייצור מיד. אין צורך לחכות לתגובה ארוכה שתסתיים.
תצוגת זיהום
ניתן להציג אופציונלית את רמת זיהום הסשן הנוכחית בפלט על ידי הפעלת showTaint בתצורת ערוץ ה-CLI. זה מוסיף את רמת הסיווג לפני כל תגובה:
[CONFIDENTIAL] הנה מספרי צינור ה-Q4 שלך...סרגל התקדמות אורך הקשר
ה-CLI מציג סרגל שימוש בחלון הקשר בזמן אמת בשורת ההפרדה בתחתית הטרמינל:
[████████████░░░░░░░░] 62% ctx MCP 3/3- הסרגל מתמלא ככל שטוקני הקשר נצרכים
- סמן כחול מופיע בסף 70% (שבו דחיסה אוטומטית מופעלת)
- הסרגל הופך לאדום כשמתקרבים למגבלה
- לאחר דחיסה (
/compactאו אוטומטית), הסרגל מתאפס
סטטוס שרתי MCP
שורת ההפרדה מציגה גם את סטטוס חיבור שרתי MCP:
| תצוגה | משמעות |
|---|---|
MCP 3/3 (ירוק) | כל השרתים המוגדרים מחוברים |
MCP 2/3 (צהוב) | חלק מהשרתים עדיין מתחברים או נכשלו |
MCP 0/3 (אדום) | אין שרתים מחוברים |
שרתי MCP מתחברים באופן עצל ברקע לאחר האתחול. הסטטוס מתעדכן בזמן אמת ככל שהשרתים עולים לאוויר.
היסטוריית קלט
היסטוריית הקלט שלכם נשמרת בין סשנים ב:
~/.triggerfish/data/input_history.jsonההיסטוריה נטענת באתחול ונשמרת לאחר כל קלט. ניתן לנקות אותה על ידי מחיקת הקובץ.
קלט Non-TTY / מועבר בצינור
כאשר stdin אינו TTY (למשל, כאשר מעבירים קלט בצינור מתהליך אחר), ה-CLI עובר אוטומטית למצב מאגר שורות. במצב זה:
- תכונות טרמינל גולמי (מקשי חצים, ניווט היסטוריה) מושבתות
- קלט נקרא שורה אחר שורה מ-stdin
- פלט נכתב ל-stdout ללא עיצוב ANSI
זה מאפשר לכם לתסרט אינטראקציות עם הסוכן:
bash
echo "What is the weather today?" | triggerfish runתצורה
ערוץ ה-CLI דורש תצורה מינימלית. הוא נוצר אוטומטית כאשר מריצים triggerfish run או משתמשים ב-REPL האינטראקטיבי.
yaml
channels:
cli:
interactive: true
showTaint: false| אפשרות | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
interactive | boolean | true | הפעלת מצב REPL אינטראקטיבי |
showTaint | boolean | false | הצגת רמת זיהום סשן בפלט |
ללא הגדרה נדרשת ערוץ ה-CLI עובד מיד. אין צורך להגדיר דבר
כדי להתחיל להשתמש ב-Triggerfish מהטרמינל. :::
קיצורי מקלדת
| קיצור | פעולה |
|---|---|
| Enter | שליחת הודעה |
| Up / Down | ניווט בהיסטוריית קלט |
| Ctrl+V | הדבקת תמונה מלוח (נשלחת כתוכן רב-מודלי) |
| Ctrl+O | החלפת תצוגת כלים קומפקטית/מורחבת |
| ESC | הפסקת פעולה נוכחית |
| Ctrl+C | יציאה מה-CLI |
| Ctrl+W | מחיקת מילה קודמת |
| Home / End | קפיצה לתחילת/סוף שורה |
