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 القديم قد لا يدعمها.

📖 ملخص


📝 تمارين

  1. أساسي (الصعوبة: ⭐): بدّل بين 3 سمات مدمجة، اختر المفضلة لديك.
  2. متوسط (الصعوبة: ⭐⭐): أنشئ سمة مخصصة بنظام ألوانك المفضل.
  3. متقدم (الصعوبة: ⭐⭐⭐): سجّل اختصارات للتبديل بنقرة واحدة بين سمتي "وضع البرمجة" و"وضع القراءة".
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%