سير عمل تطوير Pi

يلخص هذا الدليل سير عمل معقول للعمل على تكامل pi في Mayros.

فحص الأنواع و Linting

  • فحص الأنواع والبناء: pnpm build
  • Lint: pnpm lint
  • فحص التنسيق: pnpm format
  • بوابة كاملة قبل الدفع: pnpm lint && pnpm build && pnpm test

تشغيل اختبارات Pi

استخدم النص البرمجي المخصص لمجموعة اختبار تكامل pi:

bash
scripts/pi/run-tests.sh

لتضمين الاختبار المباشر الذي يمارس سلوك الموفر الحقيقي:

bash
scripts/pi/run-tests.sh --live

يقوم النص البرمجي بتشغيل جميع اختبارات الوحدة المتعلقة بـ pi عبر هذه globs:

  • src/agents/pi-*.test.ts
  • src/agents/pi-embedded-*.test.ts
  • src/agents/pi-tools*.test.ts
  • src/agents/pi-settings.test.ts
  • src/agents/pi-tool-definition-adapter.test.ts
  • src/agents/pi-extensions/*.test.ts

الاختبار اليدوي

التدفق الموصى به:

  • قم بتشغيل البوابة في وضع التطوير:
    • pnpm gateway:dev
  • قم بتشغيل الوكيل مباشرة:
    • pnpm mayros agent --message "Hello" --thinking low
  • استخدم TUI لتصحيح الأخطاء التفاعلي:
    • pnpm tui

لسلوك استدعاء الأداة، اطلب إجراء read أو exec حتى تتمكن من رؤية بث الأداة ومعالجة الحمولة.

إعادة تعيين نظيفة

تعيش الحالة تحت دليل حالة Mayros. الافتراضي هو ~/.mayros. إذا تم تعيين MAYROS_STATE_DIR، استخدم هذا الدليل بدلاً من ذلك.

لإعادة تعيين كل شيء:

  • mayros.json للتكوين
  • credentials/ لملفات تعريف المصادقة والرموز
  • agents/<agentId>/sessions/ لسجل جلسة الوكيل
  • agents/<agentId>/sessions.json لفهرس الجلسة
  • sessions/ إذا كانت المسارات القديمة موجودة
  • workspace/ إذا كنت تريد مساحة عمل فارغة

إذا كنت تريد فقط إعادة تعيين الجلسات، احذف agents/<agentId>/sessions/ و agents/<agentId>/sessions.json لهذا الوكيل. احتفظ بـ credentials/ إذا كنت لا تريد إعادة المصادقة.

المراجع