تثبيت وتشغيل وبناء نسخة DeepSeek Harness المكتبية على Linux

نبذة على المشروع

DeepSeek Harness Linux هو fork موجّه لـ Linux من DeepSeek Harness الرسمي، والهدف ديالو هو توفير نسخة مكتبية لمستخدمي Linux يمكن تحميلها وتثبيتها وتحديثها مباشرة. كيحتافظ بقدرات agent وskill والاتصال بالإنترنت والواجهة الأمامية ونظام الإضافات وبروتوكول التواصل ديال النسخة الأصلية، وكيزيد غير الدعم المرتبط بالتغليف والاختبار والتوزيع على Linux.

ملاحظة: هاد المشروع ماشي إصدار رسمي ديال DeepSeek، وما بدّلش نواة agent. النسخة الأصلية ما زالت فمرحلة developer preview، وبالتالي ممكن تكون تحديثات متكررة أو تغييرات كتسبب عدم التوافق.

المشروع كيدعم x64 وarm64. الأول مناسب للحواسيب الشائعة بمعالجات AMD وIntel، والثاني مناسب لـ Raspberry Pi 5 وخوادم ARM، وكذلك Linux اللي خدام على أجهزة Apple Silicon.

المزايا الرئيسية

• ثلاثة صيغ للتوزيع: AppImage و.deb و.tar.gz.
• دعم جوج معماريات: بناء نسخ x64 وarm64 بجوج.
• تحديث تلقائي لـ AppImage: خدام عبر electron-updater وقناة التحديث nightly-linux.yml.
• CI أصلي: كيستعمل ubuntu-24.04 وubuntu-24.04-arm runner كل واحد لبناء المعمارية المناسبة.
• متابعة النسخة الأصلية: نواة agent والقدرات المكتبية الرئيسية كيبقاو متزامنين مع المشروع الرسمي.
• ترخيص MIT: الكود الأصلي وطبقة التغليف الجديدة ديال Linux موزعين بموجب ترخيص MIT.

اختيار حزمة التثبيت المناسبة

AppImage: الاختيار المفضل لمعظم المستخدمين

AppImage هو برنامج فملف واحد، ما كيحتاجش لتثبيت تقليدي، وكيدعم قناة التحديث التلقائي اللي كيوفرها المشروع. مناسب للي باغي يجرب بسرعة أو يتفادى تغيير حالة مدير حزم النظام.

DEB: مناسب لـ Debian وUbuntu

ملف .deb يمكن تثبيتو بأدوات إدارة الحزم ديال أنظمة Debian، ومن بعد يمكن تشغيلو من قائمة التطبيقات أو من الطرفية. مناسب للي باغي يدمج التطبيق مع بيئة سطح المكتب ديال النظام.

tar.gz: تشغيل محمول

من بعد فك ضغط .tar.gz يمكن تشغيلو مباشرة بلا تثبيت. مناسب للمجلدات المحمولة وبيئات الاختبار أو الحالات اللي ما يمكنش فيها تثبيت حزم النظام.

التأكد من المعمارية قبل التثبيت

شوف أولا معمارية النظام الحالية من الطرفية:

uname -m

• إلى خرجات x86_64، حمّل النسخة اللي فيها linux-x64 فاسم الملف.
• إلى خرجات aarch64 أو arm64، حمّل النسخة اللي فيها linux-arm64 فاسم الملف.

يمكن تحميل حزم التثبيت من صفحة Releases ديال المشروع. حمّل البناءات المجتمعية غير من Release ديال هاد المستودع.

الطريقة الأولى: تشغيل AppImage

AppImage هي طريقة التثبيت الموصى بها فـ README. كتحتاج FUSE 2، لذلك خاص تثبّت runtime المناسب للتوزيعة ديالك أولا.

مستخدمو Debian أو Ubuntu ينفذو:

sudo apt install libfuse2

مستخدمو Fedora أو الأنظمة اللي مبنية على RHEL ينفذو:

sudo dnf install fuse2

من بعد تحميل AppImage المطابقة للمعمارية، عطِ الملف صلاحية التنفيذ. المثال التالي خاص بملف x64:

chmod +x deepseek-harness-*-linux-x64.AppImage
./deepseek-harness-*-linux-x64.AppImage

مستخدمو arm64 خاصهم يبدلو linux-x64 فالأوامر بـ linux-arm64، أو يستعملو اسم الملف اللي تحمّل فعلا.

الطريقة الثانية: تثبيت حزمة DEB

فـ Debian وUbuntu والتوزيعات المشتقة منهم، تقدر تستعمل dpkg لتثبيت الحزمة المحمّلة:

sudo dpkg -i deepseek-harness-*-linux-x64.deb

من بعد التثبيت، تقدر تشغل البرنامج من قائمة تطبيقات سطح المكتب أو من الطرفية:

deepseek-harness

فأنظمة arm64، خاص تثبّت حزمة DEB اللي فيها linux-arm64 فاسم الملف.

الطريقة الثالثة: تشغيل الحزمة المحمولة

إلى ما بغيتيش تثبّت حزمة فالنظام، فك ضغط .tar.gz وشغّل مدخل التشغيل الموجود فالمجلد مباشرة:

tar -xzf deepseek-harness-*-linux-x64.tar.gz
cd deepseek-harness-*-linux-x64
./deepseek-harness

مستخدمو arm64 خاصهم حتى هما يختارو ويفكو ضغط الملف ديال المعمارية المناسبة.

الاستعمال الأساسي

من بعد تشغيل البرنامج، تقدر تستعمل قدرات سطح المكتب الموروثة من النسخة الأصلية، بما فيها agent وskill والاتصال بالإنترنت والواجهة المكتبية. هاد fork ديال Linux ما بدّلش نواة agent ولا نظام الإضافات ولا بروتوكول التواصل، لذلك السلوك المرتبط بها غادي يتبع تنفيذ DeepSeek Harness الرسمي.

إلى كنت كتستعمل AppImage، تقدر تحتافظ بالملف الواحد المحمّل وتشغلو مرة أخرى مباشرة؛ وإلى ثبّتِ حزمة DEB، تقدر تشغلها بالأمر deepseek-harness أو من قائمة التطبيقات؛ أما النسخة المحمولة فخاص تشغيل ./deepseek-harness من مجلد فك الضغط.

التشغيل عبر سطح مكتب بعيد أو بلا شاشة

البرنامج تطبيق مكتبي. ملي كتستعملو مع VNC فوق خادم بعيد، خاص تتأكد أن DISPLAY مضبوط مزيان. مثلا، فبيئة xfce4 وTigerVNC، ممكن يكون رقم العرض هو :1:

export DISPLAY=:1
./deepseek-harness

إلى كانت بيئة العرض متاحة، البرنامج المكتبي غادي يفتح تلقائيا. رقم العرض الفعلي خاصو يتحدد حسب إعداد VNC أو الجلسة الرسومية الحالية.

البناء من الكود المصدري

تحضير المتطلبات

البناء من الكود المصدري كيحتاج Node.js 24 أو إصدار أحدث، وpnpm، وكذلك libfuse2 فآلة البناء. كيتستعمل libfuse2 لتجميع AppImage.

استنساخ المشروع وتثبيت الاعتماديات

git clone https://github.com/Zhou-Yujing114514/deepseek-harness-linux.git
cd deepseek-harness-linux
pnpm install

تحضير ملف بيئة Linux

نسخ الملف النموذجي اللي كيوفره المشروع، وعمر إعدادات الإصدار حسب الحاجة:

cp apps/desktop/.env.linux.example apps/desktop/.env.linux

بناء المعمارية المطلوبة

بناء حزم x64:

pnpm --dir apps/desktop run package:linux:x64

بناء حزم arm64:

pnpm --dir apps/desktop run package:linux:arm64

كل معمارية غادي تنتج الصيغ الثلاث: AppImage وDEB وtar.gz. حتى workflow ديال المشروع Desktop (Linux) كيقدر يبني عند الطلب فوق runner أصلي، ويمكن تحميل النتائج من GitHub Actions Artifacts أو من Release كيتنشأ تلقائيا.

التحديث التلقائي والتحقق الأمني

AppImage كتستعمل قناة تحديث AppImage عبر electron-updater، ووصف التحديث هو nightly-linux.yml، والنقل كيدوز عبر HTTPS.

مهم: البناء الحالي ديال Linux ما فيهش توقيع للكود. التحديث التلقائي كيعتمد غير على النقل عبر HTTPS والتحقق من بيانات feed، وما فيهش التحقق من توقيع الكود، لذلك ما مناسبش للاستعمال المباشر فحالات الثقة العالية.

من بعد التحميل أو التحديث، خاص تقارن SHA256 ديال الملف مع checksum الموجود فصفحة Release. تقدر تحسب البصمة بالأمر التالي:

sha256sum deepseek-harness-*-linux-x64.AppImage

تأكد أن النتيجة مطابقة تماما للقيمة المنشورة فـ Release. حتى ملفات DEB وtar.gz وarm64 تقدر تتحقق منها بالطريقة نفسها.

القيود المعروفة

1. البناء بلا توقيع: ملفات Linux الثنائية ما فيهاش توقيع للكود ولا توثيق رسمي على مستوى النظام.
2. تحويل وثائق Office غير متاح حاليا: تحويل DOCX وXLSX وPPTX إلى PDF كيحتاج bindings أصلية لـ Linux ديال LibreOffice Kit، والنسخة الحالية ما كتوزعهاش مع حزمة التثبيت.
3. النسخة الأصلية ما زالت فمرحلة المعاينة: المشروع الرسمي فمرحلة developer preview، وممكن توقع تغييرات متكررة أو كتسبب عدم التوافق.
4. ما كايناش نسخة فمتجر التطبيقات: المشروع ما كيدوزش من مسار النشر ديال متاجر التطبيقات.

قيد تحويل Office ما كيأثرش على القدرات المكتبية الأخرى المذكورة بوضوح فـ README، بما فيها agent وskill والاتصال بالإنترنت والواجهة الأمامية.

نصائح متقدمة

• طابق المعمارية أولا: ما تحمّلش حزمة arm64 فـ x64، والعكس صحيح.
• اختار AppImage إلا كنت محتاج للتحديث: README ديال DEB وtar.gz ما كيصرحش باستعمال قناة تحديث AppImage.
• حافظ على التحقق: سواء فالتحميل الأول أو التحديث، خاصك تقارن SHA256 مع القيمة الموجودة فـ Release.
• تابع تغييرات النسخة الأصلية: هاد fork غادي يبقى كيدير rebase على commits ديال النسخة الأصلية، لذلك شوف ملاحظات Release قبل الترقية.
• استافد من CI الأصلي كمطور: إلى كنت محتاج تختبر المعماريتين بجوج، استعمل workflow الموجود فالمشروع Desktop (Linux)، وما تفترضش أن نتيجة البناء المتقاطع مساوية للبناء الأصلي.

قبل التشغيل، خاصك حتى تقرا SAFETY.md ديال المشروع الأصلي. المشروع الرسمي موجود فـ deepseek-ai/deepseek-harness.

الخلاصة

DeepSeek Harness Linux كيزيد للنسخة المكتبية الرسمية إمكانية التوزيع على Linux بمعماريتي x64 وarm64. المستخدم العادي يقدر يختار AppImage اللي كتدعم التحديث التلقائي، ومستخدمو Debian أو Ubuntu يقدرو يثبّتو DEB، أما اللي محتاج تشغيل محمول فيقدر يختار tar.gz. وبما أن البناء الحالي ما زال بلا توقيع، خاص التحقق من SHA256 عند التحميل والتحديث والنشر، والانتباه لتغييرات التوافق خلال مرحلة developer preview.