Pi Agent: Keybindings & Theme Customization
آخر تحديث: 2026-08-31
--- title: "اختصارات لوحة المفاتيح وتخصيص السمة" description: "خصّص اختصارات لوحة المفاتيح وسمات واجهة Pi Agent لبناء بيئة تطوير الوكيل المثالية." order: 9 lang: ar
الأدوات تبدو صحيحة عندما تناسب يديك. الاختصارات والسمات هي "معايرة محطة العمل".
1. اختصارات لوحة المفاتيح
(1) الاختصارات الافتراضية
| الاختصار | الوظيفة |
|---|---|
| Ctrl+C | مقاطعة العملية الحالية / الخروج |
| Ctrl+D | الخروج من الوضع التفاعلي |
| Enter | إرسال الرسالة |
| Ctrl+L | مسح الشاشة |
| Tab | إكمال تلقائي (أوامر/أسماء ملفات) |
| Up/Down | تصفح سجل الرسائل |
| Ctrl+R | إعادة توليد آخر استجابة |
| Ctrl+E | تعديل آخر رسالة |
| Ctrl+K | حذف حتى نهاية السطر |
(2) اختصارات مخصصة
التكوين في ~/.pi-agent/keybindings.yaml:
YAML
keybindings:
submit: "enter"
new_line: "ctrl+enter"
clear_screen: "ctrl+l"
retry: "ctrl+r"
edit_last: "ctrl+e"
save_session: "ctrl+s"
load_session: "ctrl+o"
toggle_tools: "ctrl+t"
switch_model: "ctrl+m"
history_up: "up"
history_down: "down"
(3) تسجيل الاختصارات في الكود
PYTHON
from pi_agent import Agent
agent = Agent(name="custom")
@agent.keybind("ctrl+shift+r")
def retry_with_reasoner():
agent.switch_model("deepseek-reasoner")
agent.retry()
@agent.keybind("ctrl+shift+s")
def save_and_summarize():
agent.session.save("auto_save.json")
print("Session saved")
2. تخصيص السمة
(1) السمات المدمجة
BASH
pi-agent config set theme dark
pi-agent config set theme light
pi-agent config set theme monokai
pi-agent config set theme solarized
pi-agent config set theme nord
(2) التبديل في الوضع التفاعلي
TEXT
📖 للعرض فقط
you> /theme dark
Theme switched to dark
(3) سمة مخصصة
أنشئ ~/.pi-agent/themes/my_theme.yaml:
YAML
name: my_theme
background: "#1e1e2e"
foreground: "#cdd6f4"
accent: "#89b4fa"
error: "#f38ba8"
warning: "#fab387"
success: "#a6e3a1"
user_input: "#89dceb"
agent_output: "#cdd6f4"
tool_call: "#f9e2af"
code_block:
background: "#313244"
foreground: "#cdd6f4"
keyword: "#cba6f7"
string: "#a6e3a1"
comment: "#6c7086"
function: "#89b4fa"
التطبيق:
BASH
pi-agent config set theme my_theme
3. تخصيص صيغة الإخراج
(1) تمييز الكود
YAML
display:
code_highlight: true
code_theme: "monokai"
line_numbers: true
wrap_lines: false
(2) عرض Markdown
YAML
display:
markdown_render: true
table_render: true
link_clickable: true
(3) عرض استدعاء الأدوات
YAML
display:
show_tool_calls: true
tool_call_format: "compact" # compact | detailed | minimal
show_thinking: false
4. الخط والتخطيط
YAML
display:
font_family: "JetBrains Mono"
font_size: 14
line_height: 1.5
show_header: true
show_token_count: true
show_timestamp: false
compact_mode: false
max_width: 120
❓ أسئلة شائعة
س تعارض الاختصارات؟
ج اختصارات Pi Agent لها أولوية أقل من اختصارات الطرفية. في حال التعارض، عدّل تكوين اختصارات Pi Agent.
س السمة لا تُطبّق؟
ج تأكد أن اسم ملف السمة يتطابق مع التكوين. السمات المخصصة يجب أن تكون في
~/.pi-agent/themes/.س مشاكل عرض الرموز التعبيرية في الطرفية؟
ج تأكد أن طرفيتك تدعم Unicode. Windows Terminal وiTerm2 وAlacritty تدعمها جميعاً. cmd.exe القديم قد لا يدعمها.
📖 ملخص
- الاختصارات الافتراضية تغطي العمليات الشائعة؛ قابلة للتخصيص في keybindings.yaml
- 5 سمات مدمجة؛ أنظمة ألوان مخصصة بالكامل مدعومة
- صيغة الإخراج قابلة للتكوين: تمييز الكود، عرض Markdown، عرض استدعاء الأدوات
- خيارات الخط والتخطيط تحسّن تجربة القراءة
📝 تمارين
- أساسي (الصعوبة: ⭐): بدّل بين 3 سمات مدمجة، اختر المفضلة لديك.
- متوسط (الصعوبة: ⭐⭐): أنشئ سمة مخصصة بنظام ألوانك المفضل.
- متقدم (الصعوبة: ⭐⭐⭐): سجّل اختصارات للتبديل بنقرة واحدة بين سمتي "وضع البرمجة" و"وضع القراءة".