البرمجة بالذكاء الاصطناعي مع Pi: دليل البدء بإصدار 1.0

كيف يتيح لك Pi تخصيص البرمجة بالذكاء الاصطناعي حول نموذجك؟

Pi هو طبقة تشغيل خفيفة للوكيل، أي البرنامج الذي يصل النموذج بملفاتك وأوامرك. تخيّله كمنضدة عمل: النموذج الذي تختاره يقرّر ما ينبغي فعله، وPi يضع الأدوات اللازمة بين يديه.

تغطّي الأدوات الأربع المدمجة والمفعّلة افتراضياً دورة العمل الأساسية:

يطلب النموذج استخدام أداة، وينفّذ Pi الطلب، ثم يعيد النتيجة إلى المحادثة. ويمكن أن تتكرّر هذه الدورة حتى تنتهي المهمة. هذه هي الأدوات الأربع المفعّلة افتراضياً، وليست قائمة شاملة بكل الأدوات المدمجة المتاحة في 1.0. مرجع أدوات Pi، دورة عمل الوكيل.

إذا كنت تستخدم Claude Code أو Codex بالفعل، فقيّم Pi بناءً على سير العمل الذي تريد التحكم فيه. أوصي بتجربته عندما يكون لديك تخصيص محدّد في ذهنك، مثل أمر لمراجعة المستودع أو مهارة قابلة لإعادة الاستخدام في ترحيل الشيفرة. وللاطلاع على خيارات أوسع، راجع وكلاء البرمجة المستقلين عن مزوّد النموذج.

ما الذي تغيّر في واجهة الطرفية والأدوات مع Pi 1.0؟

يجعل الإصدار 1.0.0 وضع ملء الشاشة هو الافتراضي، ويحسّن codemode وتسجيل الدخول. واجهة TUI هي الواجهة التي تُعرض داخل الطرفية؛ وهذه أبرز التغييرات التي تهمّك أثناء الإعداد:

يربط MCP الوكيل بأدوات خارجية. أما OAuth فهو مسار تسجيل دخول يمنح الوصول من دون تسليم كلمة مرورك للأداة. ويتيح codemode للنموذج تركيب استدعاءات الأدوات في JavaScript وإعادة نتائج مختارة إلى المحادثة. ينطبق تقليل توكنات التعليمات على هذا الوضع تحديداً؛ ولا يعني وعداً بخفض فاتورة كل مهمة بنسبة 40%. ملاحظات إصدار Pi 1.0.0، مرجع codemode.

يضيف الإصدار نفسه توليد الصور من سكربتات codemode، وRadius ضمن /login، والخيار quietStartup: "header". يمكنك تأجيل هذه الميزات إلى ما بعد مهمة البرمجة الأولى. ملاحظات الإصدار.

إعداد Pi وإنجاز أول مهمة ضمن 28 دقيقة

ابدأ بمستودع تعرفه، وأمر اختبارات يعمل، ووصول إلى نموذج مدعوم. التوقيت أدناه ميزانية مقترحة للوقت؛ فمدة التنزيل وتسجيل الدخول والاختبارات تعتمد على بيئتك. اختر مهمة صغيرة بما يكفي لمراجعتها قبل نهاية الجلسة.

من الدقيقة 0 إلى 5: التثبيت وفتح المشروع

يتطلّب مسار التثبيت عبر npm في المشروع Node.js 22.19 أو أحدث. يثبّت الأمر التالي Pi على الإصدار 1.0.0، حتى تطابق خطواتك الإصدار الذي يتناوله هذا الدليل:

node --version
npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.0.0
pi --version
cd /path/to/project
pi --tui-mode regular

استبدل /path/to/project بمجلد عملك. ينبغي أن يعرض pi --version القيمة 1.0.0. أما تشغيل pi وحده فيستخدم وضع ملء الشاشة الافتراضي الجديد. والبديل الرسمي على macOS/Linux هو curl -fsSL https://pi.dev/install.sh | sh، الذي يثبّت الإصدار الحالي. توثيق تثبيت المشروع، دليل البدء السريع.

من الدقيقة 5 إلى 10: ربط حسابك الحالي

شغّل /login داخل Pi، واختر المزوّد، ثم أكمل طريقة المصادقة المعروضة. بعد ذلك شغّل /model واختر نموذجاً متاحاً. المزوّد هو مسار حصولك على الوصول؛ والنموذج هو النظام الذي يولّد الردود.

يسرد توثيق المصادقة لدى Pi مساري اشتراك Anthropic وSign in with ChatGPT لدى OpenAI. وتصف OpenAI استخدام الخطة بأنه تفويض للطلبات المؤهلة، يخضع لأهلية الحساب. أما اختيار مفتاح API فيضع الاستخدام على مسار فوترة منفصل. مزوّدو OAuth في Pi، توثيق تسجيل الدخول لدى OpenAI.

يعرض موقع Pi دعم Anthropic وOpenAI وGoogle وOpenRouter وOllama وغيرها. لكن دعم المزوّد لا يعني ظهور كل نموذج في كل حساب. إذا غاب نموذج، فتحقّق من المصادقة أولاً؛ إذ يعرض /model النماذج التي تتوفر لها بيانات اعتماد صالحة للاستخدام. اضغط Ctrl+S في قائمة الاختيار لحفظ نموذجك الافتراضي. توثيق اختيار النموذج.

لإعداد Ollama، اتّبع مثال نقطة النهاية المتوافقة في توثيق المشروع داخل ~/.pi/agent/models.json: يستخدم المثال http://localhost:11434/v1، ونوع API بقيمة openai-completions، ومفتاحاً صورياً هو ollama، ومعرّف نموذج يقدّمه تثبيت Ollama لديك. يؤدي فتح /model إلى إعادة تحميل هذا الملف. هذا هو المسار المحلي إذا أردت تجربة Pi من دون حساب نموذج مدفوع.

من الدقيقة 10 إلى 13: تزويد Pi بتعليمات المستودع

أضف ملف AGENTS.md مختصراً إلى جذر المستودع، أو وسّع الملف الذي تستخدمه بالفعل. يكتشف Pi التعليمات في ~/.pi/agent/ والمجلدات الأعلى والمجلد الحالي. شغّل /reload إذا عدّلتها أثناء الجلسة. توثيق الإعدادات.

اكتب تعليمات تصف مستودعك الفعلي. مثلاً:

Use the existing test runner and neighboring test conventions.
Keep this task within the function and tests I name.
Do not add dependencies or change the public API.
Run the focused tests and report the exact command and result.
Leave commits and publishing to me.

أضف أمر الاختبارات المحدّدة الفعلي إن كنت تعرفه. يوجّه AGENTS.md النموذج، لكنه لا يفرض حدوداً للصلاحيات.

من الدقيقة 13 إلى 23: تنفيذ تغيير مفيد واحد

اختر دالة مساعدة موجودة يكون سلوكها مع المدخلات الفارغة محدّداً، لكنه يفتقر إلى اختبار يمنع تراجعه لاحقاً. أرفق الدالة واختباراً مجاوراً باستخدام @، أداة اختيار الملفات في Pi، ثم أعطه المهمة التالية:

يحمي اختبار منع التراجع سلوكاً متوقعاً من التعطّل في تغييرات لاحقة. وتنتج هذه المهمة فروقاً واضحة في الملفات من دون مطالبة Pi بإعادة تصميم التطبيق. يوثّق دليل البدء السريع اختيار الملفات عبر @ ومراجعة الملفات المعدّلة بعد انتهاء المهمة. توثيق المهمة الأولى.

من الدقيقة 23 إلى 28: مراجعة النتائج والأدلة

اقرأ الاختبار المعدّل وافحص git diff، الذي يعرض تغييرات الملفات. تأكّد من أن عبارة التحقّق تختبر السلوك المتوقع، ثم شغّل أمر الاختبارات المحدّدة بنفسك. نجاح الاختبارات يدعم التغيير؛ ويبقى عليك تقييم فائدة عبارة التحقّق ومدى التزام التغيير بالنطاق المطلوب.

معيار اكتمال التجربة الأولى بسيط: نجح الاتصال بالمزوّد المختار، ونفّذ Pi التغيير المقصود، وأصبحت قادراً على شرح الفروق في الملفات. اترك التخصيص للجلسة التالية.

Pi مجاني؛ استخدام النموذج هو ما يحدّد الفاتورة

لا يضيف ترخيص MIT الخاص بـPi أي رسوم برمجية لكل مستخدم. الوصول عبر الاشتراك يستهلك ما توفّره الخطة، بينما يولّد مفتاح API فاتورة استخدام لدى المزوّد. أما النموذج المحلي فينقل التكلفة إلى العتاد والتشغيل لديك.

في مثال حسابي لاستخدام API، تسعّر OpenAI الاستخدام القياسي لـGPT-6.1 Sol مع السياق القصير عند $2 لكل مليون توكن إدخال و**$10 لكل مليون توكن إخراج**. التوكنات هي وحدات المحتوى التي تُعدّ لأغراض الفوترة. أسعار OpenAI الرسمية.

لنفترض أن مهمة صغيرة تجمع الاستخدام التالي عبر طلباتها:

هذا مثال حسابي توضيحي، وليس قياساً لاستخدام مهمة فعلية. يفترض معالجة قياسية، وألا يتجاوز كل طلب 272,000 توكن إدخال، ومن دون عمليات كتابة في الذاكرة المؤقتة أو أدوات تُفرض عليها رسوم منفصلة. وتختلف الأسعار للمدخلات المخزّنة مؤقتاً، والكتابة في الذاكرة المؤقتة، والطلبات الأطول، ومستويات المعالجة الأخرى. مئة مهمة بالنمط نفسه تماماً ستكلّف $30 من الرسوم الأساسية للنموذج. تفاصيل أسعار GPT-6.1 Sol.

السؤال عند تحديد الميزانية هو ما إذا كان التخصيص الذي تريده يستحق صيانته. يزيل Pi رسوم ترخيص طبقة تشغيل الوكيل؛ لكنه لا يلغي تكلفة النموذج، أو المراجعة البشرية، أو الوقت الهندسي اللازم لدعم سير عملك.

وسّع سير العمل بأبسط آلية تؤدي الغرض

استخدم التعليمات لقواعد العمل، والمهارات للإجراءات المتكررة، والإضافات للسلوك القابل للتنفيذ.

يبدأ ملف SKILL.md الخاص بالمهارة باسم ووصف. استدعِ مهارة بعينها باستخدام /skill:name عندما تريد تحميلها صراحةً. تعمل الإضافات داخل عملية Pi نفسها، لذا راجع شيفرتها قبل تحميلها. المهارات، الإضافات.

يثبّت pi install ./local-package حزمة أعددتها محلياً. ولحزمة منشورة، استخدم pi install npm:@scope/package@version مع اسمها وإصدارها الفعليين. أضف --local لتسجيل تعريف الحزمة على مستوى المشروع في .pi/settings.json. شغّل /reload بعد تعديل الموارد أثناء جلسة نشطة. توثيق الحزم.

لخدمة MCP خارجية، اضبط خادمها واستخدم /mcp login <server> عندما تتطلّب OAuth. اجعل ذلك إضافة لاحقة، بعد أن يعمل الإعداد الأساسي. توثيق MCP.

ست مهام مفيدة مرتّبة بحسب العائد العملي

أفضل بداية هي عمل يتكرّر في مستودع تفهمه. هذه مسارات عمل مقترحة، ويتوقف عائدها على قاعدة الشيفرة ومدى التزامك بالمراجعة.

1. إضافة اختبارات تمنع عودة خلل أُبلغ عنه. يمكن لمؤسس يتولى صيانة تطبيق ويب باشتراك أن يرفق خطوات إعادة إنتاج الخلل، وشيفرة التنفيذ، والاختبارات، ثم يطلب من Pi اختباراً يفشل وإصلاحاً محدود النطاق، ويعيد تشغيل الفحوص ذات الصلة. القيمة هنا هي تحويل الخلل الذي رُصد إلى اختبار دائم.
2. مراجعة تغيير قبل فتح طلب سحب. يمكن لمطوّر تزويد Pi بالفروق المحلية في الملفات ومهارة لمراجعة المستودع، وطلب العيوب المحتملة مع إشارات إلى الملفات وشرح لكل منها. اكتشاف مشكلة محدّدة قبل المراجعة قد يقلّل جولة من النقاش والتعديلات.
3. ترحيل جزء محدّد من التطبيق. يمكن للقائم على الصيانة صياغة إجراء الترحيل في مهارة، وتطبيقه على وحدة واحدة، وتشغيل فحوصها. يأتي التوفير المحتمل من إعادة استخدام الإجراء عبر وحدات متشابهة، مع مراجعة كل مجموعة تغييرات.
4. فهم مستودع غير مألوف. يمكن لمهندس جديد أن يطلب من Pi تتبّع طلب واحد من نقطة الدخول حتى التخزين، ثم حفظ ملاحظات تتضمن إشارات إلى الملفات وأوامر الفحص ذات الصلة. قد تقلّل هذه الملاحظات تكرار أسئلة الإعداد.
5. كتابة سكربت صيانة صغير. يمكن لمسؤول تشغيل يتولى بيانات الاختبار القديمة أن يطلب من Pi إعداد سكربت، وتجربته على عينات من المدخلات، وتوثيق استخدامه. وقد يغني السكربت، بعد مراجعته، عن تعديلات يدوية متكررة.
6. بناء سير عمل داخلي للمطوّرين. يمكن لقائد تقني جمع أمر مخصّص ومهارات في حزمة، أو دمج Pi عبر وضع الطباعة للأوامر المنفردة، أو RPC للتحكم في عملية منفصلة، أو مكتبة SDK لتضمين الجلسات داخل تطبيق. العائد هو تكييف الوكيل مع مهمة متكررة؛ ويتولى القائد مسؤولية الدمج والدعم. واجهات الدمج.

أوضح فرصة لبناء منتج: مراجع مخصّص للمستودع

حزمة مراجعة قبل الدمج هي أوضح فرصة، لأن المهمة تتكرّر والمشتري يعرف مسبقاً تكلفة تأخّر المراجعات. قد يدفع فريق هندسي صغير مقابل حزمة تُصان باستمرار، وتفحص قواعده الخاصة، وتقدّم أدلة للمراجعين.

أظهر فحص الطلب 1,300 عملية بحث شهرية تقديرية على Google في الولايات المتحدة عن «ai code review». وتوفّر CodeRabbit Essentials مرجعاً سعرياً عند $24 لكل مطوّر شهرياً مع الفوترة السنوية، أو $30 مع الفوترة الشهرية. تشير هذه المعطيات إلى اهتمام بالمهمة وإلى فئة منتجات مدفوعة قائمة؛ لكنها لا تثبت وجود طلب على حزمة Pi. مصدر حجم البحث: نظرة عامة على الكلمات المفتاحية من DataForSEO، جرى التحقّق منها في 3 أكتوبر 2026. أسعار CodeRabbit.

قد تضم أصغر نسخة قابلة للبيع مهارة مراجعة، وأمراً يجمع الفروق المحلية في الملفات، وفحوصاً خاصة بالمستودع، وتقريراً يشير إلى الملفات. ابدأ بالتسليم المحلي. التحدّي هو التميّز: يسهل نسخ تعليمات عامة، بينما تحتاج حزمة Pi إلى صيانة وضوابط وصول ودعم خاص بها. اجعل ما تبيعه هو جودة فحوص المستودع واستمرار صيانتها.

الفرصة الثانية هي حزمة إعداد أولي للفريق. يمكن لقائد هندسي شراء خدمات الإعداد والصيانة لتوحيد إعدادات المزوّد، وAGENTS.md، والمهارات المشتركة، ومجموعة صغيرة من الإضافات المعتمدة. أظهر فحص الطلب 1,600 عملية بحث شهرية تقديرية في الولايات المتحدة عن «open source ai coding assistant»، وفق قياس DataForSEO في التاريخ نفسه. يمكن أن تكون النسخة الأولى حزمة واحدة مع إجراء لتهيئة العمل على مستودعات فريق واحد. لكن الاهتمام في البحث لا يثبت الاستعداد للدفع مقابل التثبيت؛ وينبغي أن تأتي القيمة المستمرة من صيانة سير عمل الفريق.

متى لا يكون Pi خياراً مناسباً؟

اختر أداة مُدارة إذا كان فريقك يتوقع بوابات الموافقة على الصلاحيات، والعزل، ومسارات العمل الموحّدة ضمن منتج مدعوم. تستخدم أدوات Pi صلاحيات العملية التي تشغّله. وتتحكم الثقة في المشروع في موارد المشروع التي تُحمّل، لكنها لا تعزل استدعاءات الأدوات. وجود مجلد عمل لا يمنع الأوامر من الوصول إلى مسارات أخرى متاحة للعملية. نموذج الأمان في Pi.

يمكن للإضافات توفير خطوات تأكيد أو حماية للمسارات، ويمكن لحاوية أن توفّر عزلاً على مستوى نظام التشغيل. لكن هذه الخيارات تضع أعمال التنفيذ والصيانة على عاتق فريقك. كذلك لا يغيّر عزل JavaScript في codemode صلاحيات الأدوات التي يستدعيها. قدرات الإضافات، codemode.

لا يضم Pi أيضاً وكلاء فرعيين مدمجين أو وضع تخطيط ضمن نواته. في تقديري، هذا تنازل مناسب لمطوّر يريد قاعدة صغيرة يشكّلها حسب حاجته، وغير مناسب لفريق يريد أن يتولى طرف آخر هذه القرارات. خيارات تصميم المشروع.

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