الانتقال إلى المحتوى الرئيسي
أي coding agent يكتب كود Lousho بشكل أفضل عندما يقرأ التوثيق الحالي بدلًا من التخمين من بيانات التدريب. الـ SDK ينشر توثيقه في ملفين machine-readable، وهذا الموقع يقدّم كل صفحة بصيغة Markdown.

التوثيق كملفات

الملفان مولّدان من نفس توثيق هذا الموقع، والـ CI الخاص بالـ SDK يتحقق منهما. ملف llms.txt الموجود في node_modules يطابق النسخة المثبتة عندك؛ أما llms-full.txt في المستودع فيتبع فرع main في الـ SDK، وقد يكون أحدث من الإصدار الذي ثبّتّه. أخبر الـ coding agent بمكانهما، مثلًا في AGENTS.md أو CLAUDE.md في مشروعك:

التوثيق من هذا الموقع

في أعلى كل صفحة هنا زر Copy page، ينسخ الصفحة بصيغة Markdown لتلصقها في محادثة. ومن القائمة نفسها يمكنك فتح الصفحة في ChatGPT أو Claude.

دع الـ coding agent يتحقق من عمله

جزءان في الـ SDK يسهّلان التحقق من عمل الـ agent بدون مفتاح API:
  • Testing: mockModel يحدد ردود الـ model مسبقًا، فيقدر الاختبار يتحقق من الـ tool calls ومن النص النهائي ويشتغل offline في CI.
  • Evals: defineEval() يتحقق من مسار التنفيذ (أي tools، بأي ترتيب، وبأي معاملات)، وlousho eval يُخرج النتيجة بصيغة JUnit.
الأمر npx lousho doctor يفحص نسخة Node والـ peer dependencies ومفاتيح API، ويطبع طريقة إصلاح أي نقص. وهو أول أمر مفيد يشغّله الـ coding agent في checkout جديد.

الـ agent الذي تبنيه بـ Lousho كـ coding agent

الاتجاه المعاكس مغطّى أيضًا. الـ agent الذي تبنيه بالـ SDK يستطيع هو نفسه العمل على الكود:
  • Build a coding agent: شرح خطوة بخطوة لـ coding agent يعمل في الطرفية، مع tools للملفات والـ shell، وapprovals وأسئلة متابعة.
  • Registry kits: lousho add coding-kit (أو coding-pi، نفس الـ harness على الـ Pi provider مع Pi coding sub-agent) يثبّت coding agent ببنية production — checkpoints وقواعد صلاحيات وloop guard وسقف تكلفة — كمجلد واحد.
  • Pi coding sub-agents: piAgent() يفوّض مهام implementation محددة النطاق لـ Pi coding agent. له قواعد صلاحيات خاصة به، ويوقّف الـ approval ويستأنفه بشكل durable.
  • Workspace tools: tools لنظام الملفات والـ shell محصورة في مجلد جذر، والـ shell يتطلب approval.
  • Editors (ACP): lousho acp ./my-agent يقدّم الـ agent لـ Zed وباقي محررات Agent Client Protocol.
  • Project instructions: projectInstructions يلحق ملف AGENTS.md الموجود في مستودعك بتعليمات الـ agent.