التوثيق

البداية من هنا#

التثبيت بواسطة وكيل#

هذه الصفحة موجهة إلى وكيل برمجة بالذكاء الاصطناعي (Claude Code، أو أي وكيل يستطيع استخدام الطرفية) طُلب منه تثبيت aipager لصاحبه وإعداده. المطلوب اتباعها خطوة بخطوة. كل أمر هنا يعمل دون أي سؤال ولا يحتاج أبدًا إلى طرفية تفاعلية.

المرجع#

البنية#

‏aipager برنامج asyncio يعمل في الخلفية في عملية واحدة. يربط بين ثلاثة عوالم: دردشتك في Telegram، وعمليات Claude Code التي تعمل تحت dtach، ونظام الهوكات في Claude Code. كل شيء يمر عبر حلقة أحداث واحدة (event loop): لا مجموعات خيوط عاملة، ولا قواعد بيانات، ولا طوابير بين العمليات.

أحداث الهوك#

يشغّل Claude Code أوامر الهوك في لحظات ثابتة من المهمة: إرسال رسالة، وأداة على وشك العمل، وأداة انتهت، وانتهاء المهمة، وهكذا. يربط aipager هوكًا بكل واحدة من هذه اللحظات ويحوّلها إلى نشاط في Telegram: بطاقة العمل، وطلبات الإذن، والإجابات، والإشعارات، وسجل التدقيق.

أوامر البوت وواجهته#

كيف يُدار aipager من Telegram. أربع قنوات للإدخال: أوامر الشرطة المائلة، وأزرار لوحة المفاتيح، ولوحة Mini App، والرسائل الحرة (نص، ملفات، رسائل صوتية).

وضع الفريق والمجموعات#

افتراضيًا، aipager بوت خاص: أنت والبوت في دردشة خاصة واحدة، ولا أحد غيركما. وضع الفريق يفتحه لأشخاص آخرين: مجموعة Telegram يدير فيها عدة مطوّرين الجلسات، أو دردشات خاصة لأشخاص آخرين مع البوت، أو كليهما. لكل دردشة أعضاؤها، ولكل عضو دور يحدد ما يحق له فيها: إرسال الرسائل، أو الرد على أسئلة Claude وطلبات الإذن، أو إدارة الجلسات، أو المشاهدة فقط.

التشغيل والصيانة#

نموذج الأمان#

يشغّل aipager برنامج Claude Code نيابة عنك ويُدار من Telegram. ومن هنا سؤالان:

حل المشكلات#

الأعطال الشائعة وإصلاحاتها. عند الشك، يكفي تشغيل:

تقارير المشكلات#

عندما يصادف aipager خللًا، يمكنك إرسال تقرير مشكلة إلى مطوّر aipager بضغطة واحدة. يظهر لك التقرير كاملًا قبل إرسال أي شيء، ولا يغادر شيء كمبيوترك قبل موافقتك، ولا يحتوي التقرير أبدًا على دردشاتك أو رسائلك أو الأسماء أو المسارات أو التوكنات. يُبنى فقط من قائمة ثابتة من الحقول: الإصدارات، والأعداد، والتواريخ، وإجابات نعم/لا، واختيارات من قوائم ثابتة، ومواضع في شيفرة aipager نفسه، وأسماء أخطائه التي تبدأ بـ ap1-‎، ومعها ملاحظة قصيرة فقط إذا كتبتها.