الانتقال إلى المحتوى الرئيسي

​
بوت Telegram الشخصي

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

​
الإعداد

افتح Telegram وأرسل رسالة إلى @BotFather:
/newbot
اتبع التعليمات لتسمية البوت. سيمنحك BotFather رمزًا (token) مثل:
7123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
انسخ هذا الرمز.
حافظ على سرية رمز البوت. أي شخص يملك الرمز يمكنه استقبال الرسائل المرسلة إلى البوت. في حال تسرّبه، قم بإلغائه عبر BotFather بأمر /revoke ثم أعد التهيئة في وولف فيش.

​
الأوامر

يتعرّف البوت على أوامر الشرطة المائلة التالية:
الأمرالإجراء
/stopإلغاء المهمة الجارية حاليًا
/newبدء محادثة جديدة
/resumeمتابعة المحادثة السابقة
/deleteحذف المحادثة الحالية
/currentعرض المحادثة النشطة
/statusتقرير النظام (النموذج، استخدام الذاكرة، وقت التشغيل)
/localالتبديل إلى النموذج المحلي (Ollama)
/cloudالتبديل إلى النموذج السحابي (Claude/OpenAI)

​
آلية الموافقة

عندما تُصنّف الـ amygdala استدعاء أداة على أنه قد يكون خطيرًا، يرسل وولف فيش لوحة أزرار مضمّنة في Telegram: 
Wolffish wants to execute:
  shell_exec: rm -rf ./build/

[Approve] [Deny]
اضغط Approve للمتابعة أو Deny للإلغاء. يتوقف الدور حتى تستجيب — لا مهلة زمنية، ولا موافقة تلقائية.
تتضمن طلبات الموافقة اسم الأداة الكامل ومعاملاتها حتى تتمكن من اتخاذ قرار مستنير. الأوامر الخطرة (حذف الملفات، طلبات الشبكة، تعديلات النظام) تتطلب دائمًا موافقة.

​
إدارة المحادثات

كل محادثة في Telegram ترتبط بمحادثة في وولف فيش. الربط يعمل كالتالي:
  • المحادثة الخاصة مع البوت = سلسلة محادثة واحدة
  • استخدم /new لبدء محادثة جديدة (المحادثة السابقة محفوظة في الذاكرة)
  • استخدم /resume للعودة إلى آخر محادثة نشطة
  • استخدم /delete لحذف المحادثة الحالية من السجل
المحادثات مشتركة بين القنوات. محادثة بدأت في Telegram تظهر في قائمة محادثات واجهة Electron، والعكس صحيح.

​
معالجة الملفات

يمكن للبوت استقبال ومعالجة:
  • الصور — لقطات شاشة، صور، مخططات (تُعالج عبر قدرات الرؤية)
  • المستندات — ملفات بي دي اف، ملفات نصية، ملفات برمجية (يُستخرج المحتوى ويُمرّر للذكاء)
  • الرسائل الصوتية — تُحوّل لنص عبر تقنية تحويل الكلام إلى نص وتُعالج كمدخل نصي
أرسل ملفًا مع أو بدون تعليق. إذا أرفقت تعليقًا، يصبح رسالة المستخدم مع الملف كسياق. إذا لم يكن هناك تعليق، يستنتج وولف فيش القصد من محتوى الملف.

​
تنسيق الردود

ينسّق وولف فيش الردود باستخدام مجموعة HTML الفرعية في Telegram: 
<b>bold</b>
<i>italic</i>
<code>inline code</code>
<pre>code block</pre>
<a href="url">link text</a>
تُقسّم الردود الطويلة عند حدود منطقية (فواصل الفقرات، عناصر القوائم) للبقاء ضمن حدود طول الرسائل في Telegram. تُحافظ كتل الشفرة البرمجية على سلامتها قدر الإمكان.

​
نتائج المهام المفصّلة

افتراضيًا يستقبل Telegram تغذية نظيفة — ردود الوكيل، وأي ملفات يُنتجها، والأخطاء. أما خطوات الأدوات التفصيلية فتبقى في واجهة سطح المكتب حتى لا تمتلئ محادثتك بالخطوات الداخلية. بدّل ذلك من الإعدادات → القنوات → Telegram → نتائج المهام المفصّلة:
  • إيقاف (الافتراضي) — رسائل الوكيل والنتائج الحاملة للملفات والأخطاء فقط.
  • تشغيل — يُعاد بثّ كل استدعاء أداة وكل نتيجة وكل نشاط إلى المحادثة لحظة حدوثه.
لا يغيّر الوضع المفصّل سوى ما يُرسَل إلى Telegram. أما الدور كاملًا — كل استدعاء أداة ونتيجته — فيُحفظ في السجل والذاكرة بغضّ النظر عن الإعداد.

​
التفاصيل التقنية

قناة Telegram مبنية على مكتبة Grammy — إطار عمل حديث مكتوب بـ TypeScript لبناء بوتات Telegram. تتولى Grammy:
  • الاستطلاع المطوّل لتحديثات الرسائل
  • إدارة لوحات الأزرار المضمّنة للموافقات
  • رفع وتنزيل الملفات
  • تنسيق الرسائل وتقسيمها
  • استرداد الأخطاء وإعادة الاتصال

​
فلتر البيانات الحساسة

يتضمن وولف فيش فلتراً اختيارياً يتجاهل الرسائل التي تحتوي على بيانات اعتماد قبل وصولها للوكيل. هو معطّل افتراضياً — مناقشة الأسرار جزء مشروع من كثير من سير العمل (إعداد التكاملات، تصحيح المصادقة، تدوير المفاتيح). لتفعيله: الإعدادات → وولف فيش → حجب البيانات الحساسة في الرسائل عند التفعيل، أي رسالة واردة تطابق نمط بيانات اعتماد تُتجاهل فوراً بالكامل. لا يُعالج الدور، ولا يُحفظ شيء، ويتلقى المستخدم إشعاراً قصيراً. ينطبق هذا بالتساوي على سطح المكتب وTelegram وWhatsApp. الأنماط المكتشفة: كلمات المرور (password:، my password is...)، مفاتيح API (api_key:، secret_key:)، رموز الوصول (access_token:، bearer_token:)، المفاتيح الخاصة SSH/RSA/PGP (-----BEGIN PRIVATE KEY-----)، عبارات المفاتيح الخاصة (private_key:، ssh_key:).
عندما يكون الفلتر معطّلاً (الافتراضي)، تُعالج الرسائل بشكل طبيعي بغض النظر عن محتواها. إذا كنت تعمل مع بيانات الاعتماد بشكل متكرر، فهذا سلوك متوقع — خزّن الأسرار في الإعدادات → المتغيرات بدلاً من لصقها في المحادثة.