ملاحظة الكاتب: أعددت هذا المقال بالاستناد إلى وثائق Alma الرسمية ولقطات شاشة من الاستخدام الفعلي. لا يقتصر Alma على كونه واجهة للواجهة الطرفية مخصصة للمبرمجين؛ بل يهدف إلى وضع وكلاء الذكاء الاصطناعي على أجهزة الجميع: نافذة واحدة تجمع كل النماذج، وتتذكر تفضيلاتك، وتستخدم الكمبيوتر نيابةً عنك، وتحوّل Claude Code وCodex في herdr إلى نوافذ دردشة. من تجربتي، يتصرف بقدر ملحوظ من المبادرة، حتى إن النموذج نفسه قد يبدو أكثر ذكاءً بكثير عند استخدامه معه.
الخلاصة أولًا: Alma تطبيق لوكلاء الذكاء الاصطناعي يعطي الأولوية للتشغيل المحلي، وهو أيضًا عميل بواجهة رسومية لـ herdr. يصفه الموقع الرسمي بأنه وسيلة «لوضع قدرات الوكلاء في متناول الجميع»: فهو يجمع النماذج والذاكرة والمهارات والإضافات والقنوات والتحكم بالكمبيوتر في تطبيق واحد. أما أكثر ميزاته فائدة للمطورين فهي نقل وكلاء البرمجة المتعددين من الواجهة الطرفية إلى نوافذ دردشة تسهل قراءتها والرد فيها.
إذا كنت تشغّل من 2 إلى 4 وكلاء في الوقت نفسه يوميًا، وتجد صعوبة في معرفة من ينتظر إذنًا ومن انتهى من عمله، أو تتوقف مهامك بسبب انتظار الموافقة عندما تبتعد عن الكمبيوتر، فهذه المجموعة تستحق التجربة. لكنها ليست مناسبة لمن يشغّل وكيلًا واحدًا فقط ولا يحتاج إلى التحكم بالكمبيوتر أو استخدام التطبيق على الهاتف؛ كما أن إصدار iPhone لا يزال متاحًا للتجربة العامة عبر TestFlight. تستند المعلومات في هذا المقال أساسًا إلى وثائق Alma وherdr الرسمية، مع عدة لقطات شاشة من الاستخدام الفعلي وتعليق من أحد مستخدمي X، وسنشير إلى مصدر كل منها في موضعه.
الشكل 1: رسم يوضح استخدام Alma على الكمبيوتر وiPhone معًا، مستند إلى القسم الأول من الموقع الرسمي، وليس لقطة شاشة رسمية.
عدة وكلاء AI في الطرفية: الفوضى ليست بسبب النماذج
تخيل أن لديك ثلاث نوافذ طرفية مفتوحة: يعمل Claude Code على إعادة هيكلة الشفرة، ويضيف Codex اختبارات، بينما يبحث Codex آخر عن خطأ. النماذج كلها تعمل بصورة طبيعية، لكن ما يستهلك وقتك هو التنقل بين النوافذ ومراجعة سجل الطرفية السابق (scrollback) لمعرفة أي جلسة تنتظر تأكيد الصلاحيات. وكلما زاد عدد الوكلاء، ارتفعت كلفة متابعة حالتهم.
وتصبح المشكلة أوضح عندما تبتعد عن الكمبيوتر. فقد لا ينقص الوكيل سوى موافقة واحدة على أمر، لكنه يظل منتظرًا نصف ساعة، بينما لا تستطيع متابعة تقدمه من هاتفك. لذلك، لا تكمن العقبة أمام العمل مع عدة وكلاء غالبًا في قدرات النماذج، بل في وضوح الحالة وسهولة الرد.
يقارن الجدول التالي بين طريقتين للعمل، ويعرض العمود الأيمن وصف الوظائف الرسمي عند استخدام Alma مع herdr:
| المهمة اليومية | الطرفية فقط | Alma + herdr |
|---|---|---|
| معرفة من ينتظرك | التنقل بين النوافذ واحدة تلو الأخرى | يجمع الشريط الجانبي الوكلاء حسب الحالة، ويعرض المنتظرين أولًا |
| متابعة خطوات التنفيذ | مراجعة سجل الطرفية السابق | طي الخطوات وتنسيق الشفرة، مع إمكانية فتح الوكلاء الفرعيين كلٍّ على حدة |
| الرد على الوكيل | العودة إلى النافذة المناسبة والكتابة | الرد عبر حقل الإدخال أو الأزرار، مع إمكانية وضع الرسالة التالية في قائمة الانتظار |
| الموافقة بعد الابتعاد عن الكمبيوتر | العودة إلى الكمبيوتر لمعالجة الطلب | تلقي إشعار على الهاتف والرد بضغطة زر أو بكتابة رسالة |
| عرض المخرجات الخام | مرئية دائمًا | إمكانية العودة إلى الطرفية الفعلية في أي وقت |
تجدر الإشارة إلى أن الشريط الجانبي وعلامات التبويب في herdr تعرض أيضًا حالة الوكلاء. بمعنى أنك تحصل على جزء من فائدة «معرفة من يحتاج إليك» بتثبيت herdr وحده. أما ما تضيفه Alma فهو عرض المحادثات بطريقة أسهل للقراءة، والرد بالأزرار، واستخدام الهاتف، وربط النماذج.
استخدم Alma لتحسين تجربة العرض والرد، واترك تشغيل الوكلاء لـ herdr
لفهم هذه التركيبة، يكفي التمييز بين ثلاث طبقات. ينظّم herdr الوكلاء ويشغّلهم، أما herdr-core فهو خدمة صغيرة تعمل على الجهاز المحلي وتستضيف الوكلاء فعليًا. ويتصل Alma بهذه الخدمة ليحوّل كل pane (لوحة، أي منطقة الطرفية التي يعمل فيها الوكيل) إلى واجهة محادثة. ولا يشغّل Alma هؤلاء الوكلاء بنفسه.
ينتج عن هذا التقسيم أمران. أولًا، لا تحتاج إلى تغيير طريقة عملك: شغّل الوكلاء في herdr كالمعتاد، وسيعثر Alma على الخدمة المحلية تلقائيًا. ثانيًا، عند الخروج من تطبيق Alma أو herdr، يواصل الوكلاء العمل داخل herdr-core. لكن إذا أُعيد تشغيل الجهاز أو توقّف herdr-core، فستتوقف البرامج أيضًا. وستُستعاد اللوحات بجلسات shell في الدليل نفسه، لكن herdr لن يعيد تشغيل الوكلاء أو يستأنف العمل الجاري.
الشكل 2: مخطط توضيحي لتوزيع الأدوار بين herdr وAlma، وليس مخططًا رسميًا للبنية.
من المهم أيضًا التمييز بين مساري النماذج. تستخدم نافذة المحادثة في Alma النموذج الذي أعددته في Providers، بينما يواصل Claude Code وCodex داخل herdr استخدام إعدادات تسجيل الدخول والتهيئة الخاصة بهما. وعند ربط APIYI لاحقًا، سيقتصر التأثير على جانب Alma.
Alma أكثر من لوحة للوكلاء: 5 ميزات تستحق التفعيل أولًا
يعرّف الموقع الرسمي Alma بأنه تطبيق لوكلاء الذكاء الاصطناعي يعطي الأولوية للعمل المحلي والذاكرة، وكونه عميلًا لـ herdr ليس سوى أحد أدواره. وعند فتح صفحة الإعدادات، يكشف العمود الأيسر عن تنوع ميزاته.
الشكل 4: الشريط الجانبي للميزات في صفحة إعدادات Alma، في لقطة طويلة جُمعت في عمودين. يضم الشريط Providers وChannels وComputer Use وRemote Access.
جميع النماذج في نافذة واحدة
تضم قائمة Providers إعدادات مسبقة لـ OpenAI وAnthropic وGoogle Gemini وxAI Grok وDeepSeek وMoonshot وZ.AI وKimi وAiHubMix وOpenCode Go وغيرها، كما يمكن إضافة أي خدمة متوافقة مع OpenAI. يُحفظ مفتاح API على الجهاز، ويمكنك تبديل النموذج في أي وقت داخل المحادثة نفسها.
الشكل 5: مقدمو الخدمات المُعدّون مسبقًا في قائمة Providers، ومن بينهم xAI Grok وKimi وZ.AI.
الذاكرة وسجل النشاط: قد يتذكر ما فعلته اليوم قبلك
تحفظ ميزة Memory المعلومات المهمة على هيئة متجهات دلالية، ويمكنك عرضها وتعديلها وحذفها. أما Activity Recorder فيلتقط لقطات للشاشة دوريًا على الجهاز، ويستخدم التعرّف الضوئي على الحروف (OCR) لتحليل المشاريع التي تعمل عليها، مع إبقاء السجل على جهازك فقط. تفاجأ أحد مستخدمي X عندما أخبره Alma من تلقاء نفسه: «لقد دمجت طلبات MR على GitLab ونشرت إصدارًا بعد الظهر»، فنشر منشورًا أشار فيه إلى @yetone. هذه الصياغة القريبة من كلام البشر جاءت لأن Alma رجع فعلًا إلى مفكرته الصغيرة، بدلًا من مجرد ترديد السجل.
الشكل 6: نشر مستخدم X @rubickeho تجربته بعدما أخبره Alma بما فعله بعد الظهر. الرد الظاهر في لقطة الشاشة أنشأه Alma.
هذه تجربة مستخدم واحد، وليست وعدًا رسميًا بميزة محددة؛ يُرجى الرجوع إلى الشرح داخل البرنامج لمعرفة نطاق عمل Activity Recorder.
دعه يتحكم في جهاز Mac نيابةً عنك
تستطيع ميزة Computer Use التحكم في تطبيقات Mac الأصلية في الخلفية، دون سحب التركيز من النافذة الحالية. وتتطلب برنامجًا مساعدًا موقّعًا، وأذونات تسهيلات الاستخدام وتسجيل الشاشة. يُنصح أولًا بتفعيل الموافقة الصارمة لكل تطبيق، والسماح بالتطبيقات المطلوبة فقط. ويظل سجل الإجراءات على جهازك المحلي.
الشكل 7: أذونات Computer Use، والموافقة لكل تطبيق، وخيار المراقبة بوضع صورة داخل صورة.
الاتصال عبر WeChat وFeishu وTelegram
تضم Channels ست قنوات: Telegram وDiscord وFeishu وLark وWeChat وEmail. بمجرد إعداد بوت Telegram، يمكنك متابعة المحادثة من هاتفك دون البقاء أمام الكمبيوتر.
الشكل 8: القنوات الست في Channels، مع إمكانية إعداد بوت على Telegram.
وهناك مجموعة أخرى من المكونات التي يمكنك إضافتها تدريجيًا
تشمل هذه المكونات Image Generation لتوليد الصور، وToken Savings لتوفير الرموز، وPrompts للموجهات، وSkills، وMCP Servers، وPlugins، وHooks، وSpeech وText-to-Speech، وPeople، وWeb Search، وChrome Relay، وRemote Access (Beta). لا تحتاج إلى تفعيلها جميعًا دفعة واحدة؛ فعّل ما تحتاج إليه فقط.
ثبّت Alma وherdr في 5 خطوات، وحوّل الطرفية إلى نافذة محادثة
قبل البدء، تحقّق من دعم المنصات. يجمع الجدول التالي المعلومات الرسمية لـ Alma وherdr، مع نقطتين تستحقان اهتمامًا خاصًا:
| المنصة | Alma | herdr | ملاحظات |
|---|---|---|---|
| macOS | ملف .dmg لأجهزة Apple Silicon وIntel؛ تشترط الوثائق macOS 26 أو أحدث وذاكرة 4GB على الأقل، وتوصي بـ 8GB | يذكر الموقع الرسمي Apple silicon | على مستخدمي Intel Mac التأكد أولًا من إمكانية تشغيل herdr، لأن قائمة الأنظمة في الموقع الرسمي لا تذكر Intel |
| Windows | ملف .exe لمعمارية x64، ويدعم Windows 10/11 | x86_64 | تتوفر حزم تثبيت لكليهما |
| Linux | تسرد صفحة التنزيل ملفات AppImage و.deb و.rpm لمعمارية x64 | x86_64 وarm64 | تشير الوثائق إلى أن الدعم «قادم قريبًا»، وهو ما يتعارض مع صفحة التنزيل |
| iPhone | إصدار تجريبي عام عبر TestFlight، يتطلب الاقتران بجهاز كمبيوتر | لا يعمل على الهاتف | ليس إصدارًا رسميًا على App Store |
| Android | تتوفر حزمة APK تجريبية | لا يعمل على الهاتف | لم تحدد الوثائق الرسمية التي استند إليها هذا المقال نطاق الوظائف |
الخطوة 1: تثبيت herdr وتشغيل agent
- أين تنقر: على Mac، نزّل ملف .dmg من
herdr.devواسحبه إلى Applications. ويمكن لمستخدمي macOS وLinux أيضًا تنفيذ أمر تثبيت herdr في الطرفية:curl -fsSL https://releases.herdr.dev/app/install.sh | sh. أما على Windows، فنفّذ الأمرpowershell -c "irm https://releases.herdr.dev/app/install.ps1 | iex"في PowerShell. - ما الذي ستراه: بعد فتح Herdr، انقر على
+في شريط علامات التبويب لتشغيل Claude Code أو Codex أو غيرهما من البرامج. ووفقًا للتعليمات الرسمية، يُضبط herdr-core أثناء التثبيت إذا لم يكن موجودًا. - ماذا تفعل إذا لم تنجح الخطوة: تأكد أولًا من أن agent يعمل في طرفية عادية، ثم عُد إلى Herdr وشغّله من هناك. لا يتولى herdr حل مشكلات تسجيل الدخول إلى agent نيابةً عنك.
معيار التحقق: وجود agent واحد على الأقل قيد التشغيل في نافذة Herdr. يُنصح بتركه قيد التشغيل لاختبار الاتصال في الخطوة التالية.
الخطوة 2: تثبيت عميل Alma وفتحه
- أين تنقر: نزّل حزمة التثبيت المناسبة لنظامك من
alma.now. على macOS، اسحب Alma إلى Applications، وعلى Windows شغّل ملف .exe. أما على Linux، فيجب أولًا منح ملف AppImage صلاحية التنفيذ باستخدامchmod +x، وتثبيت ملف .deb باستخدامapt install، أو ملف .rpm باستخدامdnfأوzypper. - ما الذي ستراه: تفتح نافذة Alma الرئيسية بصورة طبيعية. قد يظهر تحذير أمني عند فتحه لأول مرة على macOS؛ انقر حينها بزر الفأرة الأيمن على Alma، أو انقر عليه مع الضغط على Control، ثم اختر Open.
- ماذا تفعل إذا لم تنجح الخطوة: إذا ظهرت رسالة «Alma is damaged and can’t be opened» على macOS، فنفّذ
xattr -cr /Applications/Alma.appفي الطرفية لإزالة السمات الموسّعة للتطبيق. وإذا تعطل التطبيق فور تشغيله، تقترح الوثائق الرسمية حذف~/Library/Application Support/almaثم إعادة التثبيت، لكن ذلك سيؤدي إلى إعادة تعيين بيانات Alma المحلية، لذا فكّر جيدًا قبل المتابعة.
الخطوة 3: التبديل إلى الشريط الجانبي Agent في Alma
- أين تنقر: استخدم زر التبديل أعلى Alma لتحويل الشريط الجانبي إلى Agent. اختصار Mac هو
⌘⇧A. - ما ستراه: يظهر في الشريط الجانبي الـ agent الذي شغّلته في الخطوة 1. انقر على إحدى اللوحات (pane)، فتظهر المحادثة في المنطقة الرئيسية بدلًا من شاشة الطرفية.
- ماذا لو لم تنجح الخطوة: وفقًا للوثائق، لا تحتاج هنا إلى إعداد socket (منفذ اتصال العمليات المحلية) يدويًا. إذا ظهرت رسالة تفيد بأن «herdr لا يعمل»، فارجع إلى Herdr وتأكد من تشغيل الخدمة، ثم راجع جدول الأخطاء أدناه.
معيار التحقق: يظهر الـ agent في الشريط الجانبي، وتظهر المحادثة عند النقر على اللوحة. أرسل رسالة من مربع الإدخال؛ من المفترض أن تصل إلى اللوحة المقابلة، كما لو أنك كتبتها فيها مباشرةً.
الخطوة 4: إقران iPhone باستخدام TestFlight
- أين تنقر: ثبّت TestFlight من App Store أولًا، ثم افتح دعوة الاختبار العام لـ Alma على iPhone وثبّت التطبيق. بعد ذلك، ارجع إلى الكمبيوتر وافتح Alma، ثم انتقل إلى الإعدادات › الوصول عن بُعد (Remote Access في الواجهة الإنجليزية)، وأظهر رمز الإقران وامسحه باستخدام iPhone.
- ما ستراه: تظهر على الهاتف قائمة الـ agents وسجلات المحادثات نفسها الموجودة على الكمبيوتر. وفقًا للشرح الرسمي، يتم الاتصال مباشرةً عند استخدام شبكة Wi-Fi نفسها، أو عبر وسيط Alma بنقل مشفّر من طرف إلى طرف.
- ماذا لو لم تنجح الخطوة: تأكد أولًا من أن Alma مفتوح على الكمبيوتر وأن رمز الإقران لا يزال ظاهرًا على الشاشة، ثم أعد مسحه. إذا أردت استخدام الشاشة عن بُعد، فعليك أيضًا منح Alma إذني تسجيل الشاشة وإمكانية الوصول على Mac. هذه الميزة مدعومة على Mac فقط.
معيار التحقق: تظهر القائمة نفسها على الهاتف، ويمكنك فتح محادثة أحد الـ agents.
الخطوة 5: ربط نماذج Alma بـ APIYI
هذه الخطوة اختيارية، وتؤثر فقط في نافذة الدردشة الخاصة بـ Alma والنماذج التي يستخدمها في الخلفية. APIYI، على apiyi.com، منصة لتجميع النماذج متوافقة مع OpenAI. يمكنك استخدام مفتاح واحد لاستدعاء نماذج مثل Claude وGPT وGemini وDeepSeek، ويحصل المستخدمون الجدد على رصيد مجاني للاختبار.
الخطوات التالية مستندة إلى وثائق Alma Custom Provider ووثائق APIYI؛ ويمكن رؤية النتيجة بعد الربط في الشكل 9.
- أنشئ مفتاح API في لوحة تحكم APIYI.
- افتح إعدادات Alma باستخدام (
Cmd+,أوCtrl+,)، وانتقل إلى Providers، ثم اضغط على Add Provider واختر Custom كنوع للمزود. - املأ الحقول وفق الجدول أدناه، ثم اضغط على Save.
- في إعدادات Provider، اضغط على Add Model وأدخل معرّف النموذج الدقيق يدويًا.
- اضغط على Test للتأكد من أن Alma يستطيع إكمال طلب بسيط.
- انتقل إلى الإعدادات → General → Tool Model، واختر نموذجًا سريعًا ومنخفض التكلفة، ثم اضغط على Test.
| عنصر الإعداد | القيمة | التوضيح |
|---|---|---|
| Provider type | Custom | يستخدمه Alma للاتصال بواجهة متوافقة مع OpenAI |
| Name | APIYI | اسم للعرض فقط، ويمكن تخصيصه |
| Base URL | https://api.apiyi.com/v1 |
عنوان نقطة نهاية API؛ يجب أن يتضمن البروتوكول وألا ينتهي بشرطة مائلة |
| API Key | أنشئه على https://api.apiyi.com/token |
لا ترفعه إلى مستودع الشفرة ولا تشاركه في لقطات الشاشة |
| معرّف نموذج الدردشة | claude-sonnet-5-5، gpt-6-luna |
أضفه يدويًا عبر Add Model |
| Tool Model | gemini-3.8-flash أو deepseek-v4.1-flash |
يتولى عمليات الخلفية مثل اختيار الأدوات وإدارة الذاكرة وتوليد العناوين |
| تضمين الذاكرة (اختياري) | text-embedding-3-small |
يُستخدم لتخزين الذاكرة في صورة متجهات دلالية |
الشكل 3: رسم توضيحي لخطوات إعداد Alma Custom Provider باستخدام واجهة APIYI على apiyi.com مثالًا، وليس لقطة شاشة فعلية للبرنامج.
معايير التحقق: ينجح اختبار Provider، ويظهر النموذج الذي أضفته في قائمة اختيار النماذج، وتتلقى ردًا في نافذة الدردشة العادية في Alma. إذا فشل الاختبار، فتحقق أولًا من نهاية Base URL، ومعرّف النموذج، ومفتاح API. وتوصي الوثائق الرسمية بعدم استخدام نموذج استدلال أو نموذج لغة كبير بطيء ومكلف بوصفه Tool Model.
الشكل 9: بعد ربط APIYI، تظهر العبارة deepseek-flash · APIYI في قائمة اختيار النماذج بالصفحة الرئيسية لـ Alma.
نصيحة للإعداد: ابدأ بإضافة نموذج دردشة واحد وTool Model واحد فقط، ثم أضف المزيد تدريجيًا بعد نجاح الاختبار. راجع قائمة النماذج في المنصة لمعرفة الطرازات والأسعار: docs.apiyi.com/models.
أربعة استخدامات يومية لـ Alma: من معرفة من ينتظر ردك إلى إدارة عدة أجهزة
معرفة من ينتظر ردك من الشريط الجانبي في Alma
عند فتح Alma كل يوم، ألقِ نظرة على الشريط الجانبي أولًا بدلًا من تفقد كل طرفية على حدة. إليك معنى الحالات الثلاث والإجراء المقترح لكل منها:
| حالة الشريط الجانبي | المعنى الرسمي | الإجراء المقترح |
|---|---|---|
| يحتاج إلى إدخال | طرح الوكيل سؤالًا وينتظر الرد | تعامل معه أولًا، وأكّد الصلاحيات أو أجب عن السؤال |
| قيد العمل | ينفّذ الوكيل جولة من العمليات | لا حاجة إلى مقاطعته؛ يمكنك إنجاز مهام أخرى |
| مكتمل | أنهى الوكيل عمله، وتُميَّز الجولات غير المقروءة | راجع النتيجة ثم قرر الخطوة التالية |
يرسل Alma إشعارًا على سطح المكتب عندما يحتاج الوكيل إليك أو ينهي مهمة. وإذا كنت لا تريد تلقي إشعارات من مساحة عمل أو علامة تبويب معينة، فيمكنك كتمها من القائمة. من المناسب تنظيم مساحات العمل (Workspace) حسب مستودعات الشفرة، وعلامات التبويب حسب المهام، وهي أيضًا طريقة التنظيم المقترحة على الموقع الرسمي لـ herdr.
متابعة الوكلاء الفرعيين والتغييرات في محادثات Alma
يقرأ Alma سجلات جلسات Claude Code وCodex وpi مباشرةً، ويعرض استدعاءات الأدوات والوكلاء الفرعيين والتغييرات على الملفات بالترتيب. وعندما تحتاج إلى الرد، يمكنك الاختيار من بين عدة خيارات، أو الموافقة على أمر، أو وضع الرسالة التالية في قائمة الانتظار، أو إرسال ملفات وصور. يصل ما ترسله إلى الجزء المقابل (pane)، لذا تأكد من تحديد الوكيل الصحيح قبل الرد.
العودة إلى الطرفية الفعلية في herdr في أي وقت
عرض المحادثة مناسب للقراءة السريعة، لكن الانتقال إلى عرض الشاشة أكثر مباشرةً عندما تريد مراجعة المخرجات كاملةً أو التعامل مع برامج تفاعلية. تلتف الأسطر في طرفية الهاتف بحسب عرض الشاشة، وتتوفر مفاتيح esc و^C والأسهم. تظهر البرامج الأخرى التي تعمل في herdr أيضًا كطرفيات مباشرة، لكنها لا توفر سجلات محادثة كاملة مثل Claude Code وCodex وpi.
إدارة الوكلاء على عدة أجهزة باستخدام Alma
يمكن لنسخة واحدة من Alma التحكم في الوكلاء على عدة أجهزة. افتح أولًا الإعدادات › الوصول عن بُعد على الجهاز الآخر وانسخ رابط الاقتران، ثم عد إلى Alma على جهازك الحالي والصقه في «إضافة جهاز…». يستخدم Alma الشبكة المحلية عندما يكون الاتصال المباشر ممكنًا، وإلا يتصل عبر خدمة الترحيل من Alma المشفّرة من طرف إلى طرف. ويمكن أيضًا إقران iPhone بعدة أجهزة Mac والتبديل بينها بضغطة واحدة.
استكشاف الأخطاء الشائعة في Alma وherdr وحلها
ابدأ بتحديد موضع المشكلة. فقد تبدو رسائل مثل «herdr لا يعمل» ومشكلات الجلسة والإصدار القديم جميعها كأنها مشكلة اتصال، لكن طريقة التعامل مع كل منها تختلف:
| العَرَض | السبب المحتمل | طريقة المعالجة |
|---|---|---|
| تظهر رسالة تفيد بأن «herdr لا يعمل» | لم يُشغّل herdr على الجهاز المستهدف | شغّل herdr على ذلك الجهاز، ثم انقر على إعادة الاتصال |
| يعمل herdr، لكن Alma لا يزال غير قادر على الاتصال | تُستخدم جلسة مسماة أو socket مخصص، وقيمة HERDR_SESSION أو HERDR_SOCKET_PATH غير صحيحة |
اضبط القيمة الصحيحة في صدفة تسجيل الدخول، ثم انقر على إعادة الاتصال |
| تظهر رسالة تطلب «تحديث Alma على ذلك الجهاز» | إصدار Alma على الجهاز الآخر أقدم من الإصدار على الجهاز الحالي | حدّث Alma على الجهاز المذكور في الرسالة |
| لا يظهر الوكيل في قائمة الوكلاء | إصدار الوكيل لا يُبلّغ عن حالته، أو أنه يعمل داخل tmux، أو شُغّل بواسطة Herdr TUI | حدّث الوكيل، وتجنب تشغيله داخل tmux، وتحقق من برنامج herdr الذي شُغّل فيه |
| يعرض مزود الخدمة خطأ Authentication Failed أو Model Not Found | صيغة المفتاح غير صحيحة، أو معرّف النموذج غير دقيق | انسخ المفتاح مجددًا، وتحقق من معرّف النموذج في قائمة النماذج |
من السهل تشخيص مشكلات مثل HERDR_SESSION على نحو خاطئ. فعند فتح Alma من شريط التطبيقات أو قائمة ابدأ، يقرأ أيضًا متغيرات البيئة في صدفة تسجيل الدخول. لكن المتغيرات التي تضبطها مؤقتًا في الطرفية الحالية قد لا تكون متاحة لتلك الصدفة. يوجد socket الجلسة الافتراضية في <config>/herdr/herdr.sock، بينما يوجد socket الجلسة المسماة في <config>/herdr/sessions/<名称>/herdr.sock。
هناك أيضًا ثلاث نقاط يسهل الوقوع فيها:
- تطبيق Herdr وواجهة Herdr TUI لا يشتركان في الوكلاء: واجهة TUI برنامج منفصل له خدمة مستقلة، لذا لن يظهر الوكيل الذي تشغّله في أحدهما داخل الآخر.
- تعتمد الحالة على بروتوكول OSC 7501: وهو بروتوكول مفتوح يستخدمه الوكيل لإبلاغ herdr بحالته. تظل البرامج التي لا تدعمه قادرة على العمل، لكن حالتها لن تظهر.
- إغلاق علامة التبويب ينهي الوكيل: يبقى سجل الجلسة محفوظًا على الجهاز، لكن العملية تكون قد انتهت. إذا أردت استمرار تشغيل الوكيل، فلا تغلق علامة التبويب ظنًا أن ذلك يخفي النافذة فحسب.
تتوالى تحديثات Alma بوتيرة سريعة، لذا إذا واجهت مشكلة مع وكيل معين، فحدّثه أولًا قبل بدء التشخيص. على سبيل المثال، أصلح الإصدار v0.4.428 مشكلة عدم عثور محادثة اللوحة على سلسلة المحادثة عندما يستخدم Codex خدمة app-server daemon مشتركة، كما أصلح ظهور تنبيه إعادة الاتصال لفترة وجيزة عند فتح قفل iOS أو تبديل الشبكة.
الأسئلة الشائعة FAQ
س1: ما العلاقة بين Alma وherdr؟
يتولى herdr تشغيل الوكلاء وتنظيمهم، بينما تعمل Alma كواجهة رسومية له. تتصل Alma بخدمة herdr على جهازك، وتعرض لوحات pane في واجهة تتيح لك قراءة محتواها والرد عليه. وهي أيضًا تطبيق AI لسطح المكتب يدعم نماذج متعددة والذاكرة وSkills وMCP.
س2: هل Alma وherdr مجانيان؟
لكل منهما شروطه. يوضح موقع herdr أن التطبيق وherdr-core وHerdr TUI مجانية ومفتوحة المصدر بترخيص Apache 2.0. أما موقع Alma فيعرض زر تنزيل مكتوبًا عليه Free download، لكنه لا يضم صفحة للأسعار، ولم يوضح رسميًا ما إذا كان الاستخدام سيظل مجانيًا بلا قيود على المدى الطويل. وتطبيق Alma نفسه ليس مفتوح المصدر.
س3: هل يتوقف Claude Code وCodex عند إغلاق Alma؟
عند إغلاق نافذة Alma أو تطبيق herdr، تواصل الوكلاء العمل داخل herdr-core. ولا تتوقف إلا عند إعادة تشغيل الجهاز أو توقف herdr-core. بعد الاستعادة، تحتوي لوحة pane على جلسة shell في الدليل نفسه فقط، وعليك إعادة تشغيل العمل الذي كان جاريًا.
س4: بعد ربط APIYI، هل يستخدم Claude Code وCodex الواجهة نفسها؟
لا. يخدم مزود الخدمة الذي تضبطه عبر APIYI على apiyi.com نافذة الدردشة في Alma وميزات مثل Tool Model فقط. أما Claude Code وCodex داخل herdr فيواصلان استخدام إعدادات تسجيل الدخول والتهيئة الخاصة بكل منهما. ولا تتناول هذه المقالة استبدال الاشتراكات أو تجاوز تسجيل الدخول.
س5: هل يمكن استخدام وكلاء آخرين غير Claude Code وCodex وpi؟
تظهر جميع البرامج التي يمكن تشغيلها في herdr داخل طرفية مباشرة، لكن Claude Code وCodex وpi وحدها تعرض سجل المحادثة الكامل. ويعتمد ظهور حالات مثل «قيد العمل» و«مكتمل» أيضًا على دعم البرنامج لـ OSC 7501.
س6: كيف أختار Tool Model في Alma؟
اختر أولًا نموذجًا صغيرًا سريع الاستجابة ومنخفض التكلفة، وتجنب نماذج الاستدلال. يمكنك التحقق من توفر `gemini-3.8-flash` أو `deepseek-v4.1-flash` حاليًا في قائمة النماذج على APIYI في apiyi.com، ثم إضافة النموذج في Alma والضغط على Test.
أبرز النقاط حول Alma وherdr
- توزيع واضح للأدوار: يشغّل herdr الوكيل، بينما تتولى Alma عرض المحتوى والردود.
- الحالة أولًا: يجمع الشريط الجانبي المهام حسب حالتها: تحتاج إلى إدخال، أو قيد التنفيذ، أو مكتملة.
- اتصال بسيط: لا تحتاج عادةً إلى إعداد socket؛ وإذا تعذر الاتصال، فتحقق من herdr أولًا.
- تجربة عامة على الهاتف: يمكن تثبيت التطبيق على iPhone عبر TestFlight وإقرانه بالكمبيوتر.
- حدود التشغيل: لا يتوقف العمل عند إغلاق النافذة، لكنه لا يُستأنف بعد إعادة التشغيل أو توقف herdr-core.
- إعدادات نموذج مستقلة: ربط APIYI يؤثر في Alma فقط، ولا يغيّر إعدادات الوكيل نفسه.
- وظائف واسعة: تتوفر Providers وMemory وComputer Use وChannels كلها في تطبيق واحد.
الخلاصة ونصائح للبدء
أستخدم Alma منذ فترة طويلة. ظهر التطبيق قبل انتشار OpenClaw، وطوّره المطور المستقل yetone، وقد أصبح اليوم سهل الاستخدام وعمليًا للغاية. عندما أستخدم DeepSeek V4.1 Flash فيه، أشعر كأنني أستخدم Opus 5.5. تمنح بيئة Alma النموذج قدرًا كبيرًا من المبادرة ولمسة إنسانية واضحة، سواء في إنجاز المهام بفضل مبادرته، أو في الكتابة التي تكاد تخلو من الطابع الآلي. كما أن ميزة Computer Use تبدو لي أفضل من Codex: سريعة وسلسة للغاية!
أما ربط النماذج، فيمكن تأجيل إعداده حتى يستقر سير عمل الوكيل. أنشئ مفتاحًا عبر APIYI على apiyi.com، ثم ابدأ باختبار نموذج محادثة واحد ونموذج أدوات واحد، واضبط الإعدادات لاحقًا حسب استخدامك الفعلي. يمكنك أيضًا ربطهما بصريًا عبر Magpie بسهولة؛ ستجد شرحًا في قسم القراءة الإضافية.
📚 المراجع
- موقع Alma الرسمي: ميزات المنتج وروابط التنزيل والأسئلة الشائعة الرسمية
- الرابط:
alma.now -
ملاحظة: للتحقق من المنصات المدعومة ومعلومات الاختبار العام على iPhone
-
وثائق عميل Alma herdr الرسومي: طرق الاتصال وحالة الشريط الجانبي والأسئلة الشائعة
- الرابط:
alma.now/docs/zh/features/herdr -
ملاحظة: لاستكشاف مشكلات socket والجلسات وإشعارات الإصدار وإصلاحها
-
وثائق Alma Custom Providers: إعداد واجهات متوافقة مع OpenAI
- الرابط:
alma.now/docs/providers/custom -
ملاحظة: لإعداد Base URL وKey ومعرّف النموذج
-
موقع herdr الرسمي: معلومات عن herdr-core وOSC 7501 والأنظمة المدعومة
- الرابط:
herdr.dev -
ملاحظة: لفهم طريقة عمل الوكيل والاطلاع على الأسئلة الشائعة حول Herdr
-
سجل إصدارات Alma: سجلات نشر حزم التثبيت
- الرابط:
github.com/yetone/alma-releases -
ملاحظة: للتحقق من تاريخ إصدار v0.4.428 والإصلاحات التي يتضمنها
-
قائمة نماذج APIYI: النماذج المتاحة ومعلومات الأسعار
- الرابط:
docs.apiyi.com/models - ملاحظة: راجع القائمة قبل إعداد معرّف النموذج
الكاتب: الفريق التقني في APIYI
التواصل التقني: يسعدنا تواصلكم معنا عبر الصفحة الرئيسية لموقع APIYI، ويمكنكم زيارة مركز التوثيق على docs.apiyi.com للاطلاع على المزيد من الموارد
