kitten-command-palette(1) kitty kitten-command-palette(1)

kitten-command-palette - مرور و اجرای میان‌برهای صفحه‌کلید و کنش‌ها

پالت دستورات (command palette) به شما امکان می‌دهد تمام میان‌برهای صفحه‌کلید و کنش‌ها را در kitty از طریق یک لایهٔ رویی (overlay) قابل جستجو مرور، جستجو و اجرا کنید. برای باز کردن آن کلیدهای ctrl+shift+f3 <#shortcut-kitty.Command-palette> را فشار دهید (پیش‌فرض: Ctrl+Shift+F3).

پالت دستورات که نتایج جستجو برای win close را نمایش می‌دهد. (تصاویر پشتیبانی نمی‌شوند)

تمام کنش‌های نگاشت‌شده (آن‌هایی که میان‌بر صفحه‌کلید دارند) و کنش‌های نگاشت‌نشده (کنش‌های موجود ولی بدون کلید اختصاص‌یافته) بر اساس دسته‌بندی فهرست شده‌اند. نگاشت‌های ماوس در بخشی جداگانه نمایش داده می‌شوند. برای جستجو کافی است تایپ کنید، یک نتیجه را انتخاب کرده و برای اجرای آن Enter را فشار دهید.

هم‌زمان با تایپ در نوار جستجو، پالت نتایج را به‌صورت هم‌زمان فیلتر می‌کند. تطبیق نسبت به بزرگی و کوچکی حروف حساس نیست (case-insensitive) و به‌طور هم‌زمان روی سه ستون کار می‌کند: key (میان‌بر صفحه‌کلید)، نام action (کنش)، و category (دسته‌بندی). نویسه‌های منطبق برجسته می‌شوند تا بتوانید دقیقاً محل تطابق هر عبارت را مشاهده کنید.

چندین کلمه
عبارت‌های خود را با فاصله از هم جدا کنید. تایپ کردن scroll page به‌دنبال مواردی می‌گردد که شامل scroll و page در هر کجای ستون‌های key، action یا category باشند. مواردی که با تعداد بیشتری از عبارت‌های شما مطابقت داشته باشند، رتبهٔ بالاتری نسبت به موارد با تطابق کمتر کسب می‌کنند.
نحوهٔ تطبیق کلمات جداگانه
هر کلمه در پرس‌وجوی شما با تک‌تک کلمات موجود در سه ستون مقایسه می‌شود. بهترین تطابق برنده شده و امتیاز مورد را برای آن عبارت تعیین می‌کند:
  • کلمهٔ دقیق (Exact word) — کلمهٔ پرس‌وجو دقیقاً با کلمهٔ ستون برابر است (بالاترین امتیاز).
  • پیشوند (Prefix) — کلمهٔ ستون با کلمهٔ پرس‌وجو آغاز می‌شود؛ برای مثال scr با scroll مطابقت دارد.
  • تحمل غلط املایی (Typo tolerance) — برای کلمات چهار نویسه‌ای یا طولانی‌تر، یک غلط املایی (یک نویسه درج، حذف یا جایگزین شده) همچنان تطابق ایجاد می‌کند و دو غلط املایی تطابقی با امتیاز پایین‌تر می‌دهد.

یک مورد تا زمانی که دست‌کم یک کلمه از پرس‌وجو با چیزی مطابقت داشته باشد در نتایج ظاهر می‌شود. مواردی که کلمات بیشتری از پرس‌وجو با آن‌ها تطابق دارند، بالاتر از مواردی قرار می‌گیرند که تطابق کمتری دارند.

نام‌های مرکب
جداکننده‌هایی مانند _، +، / و - در داخل یک کلمهٔ پرس‌وجو دست‌نخورده باقی می‌مانند، بنابراین می‌توانید نام‌های مرکب کنش‌ها را به‌عنوان یک واحد جستجو کنید. تایپ mouse_selection ابتدا تلاش می‌کند آن زیررشتهٔ دقیق را در هر ستون پیدا کند. اگر این کار ناموفق باشد، توکن را به بخش‌های آن (mouse و selection) تقسیم کرده و هر بخش را به‌صورت جداگانه با کلمات ستون مطابقت می‌دهد.
رتبه‌بندی
هنگامی که چندین مورد با یک پرس‌وجو مطابقت دارند، بر اساس موارد زیر مرتب می‌شوند:
1.
تعداد کلمات پرس‌وجو که تطابق داشته‌اند (بیشتر، بهتر است).
2.
امتیاز در ستون action (تطابق‌های کنش بالاتر از تطابق‌های key یا category قرار می‌گیرند).
3.
امتیاز در ستون key.
4.
امتیاز در ستون category.
5.
کوتاه‌تر بودن نام کنش به‌عنوان امتیاز شکنندهٔ تساوی (نتایج خاص‌تر در ابتدا).

کلیدهای زیر هنگام باز بودن پالت دستورات در دسترس هستند:

کلید کنش
هر متنی فیلتر کردن نتایج با تایپ پرس‌وجوی جستجو
Enter اجرای کنش انتخاب‌شده
Escape پاک کردن پرس‌وجوی جستجو، یا بستن پالت در صورتی که پرس‌وجو از قبل خالی باشد
Up / Ctrl+K / Ctrl+P حرکت دادن انتخاب به بالا
Down / Ctrl+J / Ctrl+N حرکت دادن انتخاب به پایین
Page Up حرکت دادن انتخاب به اندازهٔ یک صفحه به بالا
Page Down حرکت دادن انتخاب به اندازهٔ یک صفحه به پایین
Home پرش به نخستین نتیجه
End پرش به آخرین نتیجه
Backspace حذف آخرین نویسه از پرس‌وجو
F12 تغییر وضعیت نمایش کنش‌های نگاشت‌نشده
کلیک ماوس انتخاب و اجرای کنش کلیک‌شده

به‌طور پیش‌فرض، پالت هر دو نوع کنش‌های نگاشت‌شده (آن‌هایی که به میان‌بر متصل شده‌اند) و نگاشت‌نشده (آن‌هایی که هیچ میان‌بری به آن‌ها اختصاص داده نشده است) را نشان می‌دهد. کنش‌های نگاشت‌نشده با برچسب (unmapped) در ستون key ظاهر می‌شوند. کلید F12 را فشار دهید تا وضعیت نمایش آن‌ها تغییر کند. این ترجیح در نشست‌های بعدی به یاد سپرده می‌شود.

کنش‌های نگاشت‌نشده برای کشف قابلیت‌هایی که ممکن است میان‌بری برای آن‌ها پیکربندی نکرده باشید مفید هستند. می‌توانید آن‌ها را مستقیماً از پالت اجرا کنید، یا نام کنش را یادداشت کرده و یک نگاشت در kitty.conf اضافه کنید.

اگر در پیکربندی خود حالت‌های سفارشی صفحه‌کلید <#modal-mappings> را تعریف کرده باشید، کلیدهای آن‌ها زیر سربرگ‌های مجزای هر حالت در پالت نمایش داده می‌شوند. نگاشت‌های push_keyboard_mode با حالت مقصدی که فعال می‌کنند گروه‌بندی می‌شوند، که مشاهدهٔ نحوهٔ ورود به هر حالت را در کنار میان‌برهای آن آسان می‌سازد.

نگاشت پیش‌فرض برای باز کردن پالت دستورات برابر است با:

map kitty_mod+f3 command_palette

می‌توانید مانند هر نگاشت دیگری، این مورد را نیز در kitty.conf تغییر دهید؛ برای نمونه:

map ctrl+p command_palette

Kovid Goyal

2026, Kovid Goyal

July 30, 2026 0.48.2