کانال CLI
رابط خط فرمان کانال پیشفرض در Triggerfish است. همیشه در دسترس است، نیازی به راهاندازی خارجی ندارد و روش اصلی تعامل با عامل در طول توسعه و استفاده محلی است.
طبقهبندی
کانال CLI بهصورت پیشفرض طبقهبندی INTERNAL دارد. کاربر ترمینال همیشه بهعنوان مالک برخورد میشود — هیچ جریان جفتسازی یا احراز هویتی وجود ندارد زیرا شما فرآیند را مستقیماً روی ماشین خود اجرا میکنید.
چرا INTERNAL؟ CLI یک رابط مستقیم و محلی است. فقط کسی با دسترسی به ترمینال شما میتواند از آن استفاده کند. این INTERNAL را به پیشفرض مناسب تبدیل میکند — عامل شما میتواند دادههای سطح داخلی را آزادانه در این زمینه به اشتراک بگذارد. :::
ویژگیها
ورودی ترمینال خام
CLI از حالت ترمینال خام با تجزیه کامل توالی فرار ANSI استفاده میکند. این تجربه ویرایش غنی مستقیماً در ترمینال شما ارائه میدهد:
- ویرایش خط — پیمایش با کلیدهای جهتی، Home/End، حذف کلمات با Ctrl+W
- تاریخچه ورودی — بالا/پایین برای مرور ورودیهای قبلی
- پیشنهادات — تکمیل Tab برای دستورات رایج
- ورودی چندخطی — ورود promptهای بلندتر بهصورت طبیعی
نمایش فشرده ابزار
وقتی عامل ابزارها را فراخوانی میکند، CLI بهصورت پیشفرض خلاصه یکخطی فشرده نمایش میدهد:
tool_name arg resultبا Ctrl+O بین خروجی فشرده و گسترده ابزار جابهجا شوید.
توقف عملیات در حال اجرا
ESC را بزنید تا عملیات فعلی متوقف شود. این یک سیگنال لغو از طریق هماهنگساز به ارائهدهنده LLM میفرستد و تولید را فوراً متوقف میکند. نیازی به انتظار برای پایان پاسخ بلند نیست.
نمایش Taint
میتوانید با فعالسازی showTaint در پیکربندی کانال CLI، سطح Taint نشست فعلی را در خروجی نمایش دهید. این سطح طبقهبندی را به هر پاسخ اضافه میکند:
[CONFIDENTIAL] اینها اعداد پایپلاین سهماهه چهارم شما هستند...نوار پیشرفت طول زمینه
CLI یک نوار استفاده از پنجره زمینه را بهصورت بلادرنگ در خط جداکننده پایین ترمینال نمایش میدهد:
[████████████░░░░░░░░] 62% ctx MCP 3/3- نوار با مصرف توکنهای زمینه پر میشود
- نشانگر آبی در آستانه ۷۰٪ ظاهر میشود (جایی که فشردهسازی خودکار فعال میشود)
- نوار هنگام نزدیک شدن به محدودیت قرمز میشود
- پس از فشردهسازی (
/compactیا خودکار)، نوار بازنشانی میشود
وضعیت سرور MCP
جداکننده همچنین وضعیت اتصال سرور MCP را نشان میدهد:
| نمایش | معنا |
|---|---|
MCP 3/3 (سبز) | تمام سرورهای پیکربندیشده متصل |
MCP 2/3 (زرد) | برخی سرورها هنوز در حال اتصال یا ناموفق |
MCP 0/3 (قرمز) | هیچ سروری متصل نیست |
سرورهای MCP بهصورت تنبل در پسزمینه پس از راهاندازی متصل میشوند. وضعیت با آنلاین شدن سرورها بهصورت بلادرنگ بهروز میشود.
تاریخچه ورودی
تاریخچه ورودی شما بین نشستها در مسیر زیر ذخیره میشود:
~/.triggerfish/data/input_history.jsonتاریخچه در هنگام راهاندازی بارگذاری و پس از هر ورودی ذخیره میشود. با حذف فایل میتوانید آن را پاک کنید.
ورودی غیر TTY / لولهشده
وقتی stdin یک TTY نیست (مثلاً هنگام لولهکشی ورودی از فرآیند دیگر)، CLI بهصورت خودکار به حالت بافر خطی بازمیگردد. در این حالت:
- ویژگیهای ترمینال خام (کلیدهای جهتی، پیمایش تاریخچه) غیرفعال هستند
- ورودی خط به خط از stdin خوانده میشود
- خروجی بدون قالببندی ANSI به stdout نوشته میشود
این امکان اسکریپتنویسی تعاملات با عامل را فراهم میکند:
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 | نمایش سطح Taint نشست در خروجی |
بدون نیاز به راهاندازی کانال CLI بدون هیچ تنظیمی کار میکند. نیازی به پیکربندی هیچ چیزی برای شروع استفاده از Triggerfish از ترمینال ندارید. :::
میانبرهای کیبورد
| میانبر | عملکرد |
|---|---|
| Enter | ارسال پیام |
| بالا / پایین | پیمایش تاریخچه ورودی |
| Ctrl+V | چسباندن تصویر از کلیپبورد (ارسال بهعنوان محتوای چندرسانهای) |
| Ctrl+O | جابهجایی نمایش فشرده/گسترده ابزار |
| ESC | توقف عملیات فعلی |
| Ctrl+C | خروج از CLI |
| Ctrl+W | حذف کلمه قبلی |
| Home / End | پرش به ابتدا/انتهای خط |