Linux پر DeepSeek Harness ڈیسک ٹاپ ورژن کی تنصیب، اجرا اور تعمیر

پروجیکٹ کا تعارف

DeepSeek Harness Linux، سرکاری DeepSeek Harness کا ڈاؤن اسٹریم fork ہے، جس کا مقصد Linux صارفین کو براہِ راست ڈاؤن لوڈ، انسٹال اور اپ ڈیٹ کیا جا سکنے والا ڈیسک ٹاپ ورژن فراہم کرنا ہے۔ یہ upstream ڈیسک ٹاپ کی agent، skill، نیٹ ورک رسائی، فرنٹ اینڈ، پلگ اِن نظام اور مواصلاتی پروٹوکول کی صلاحیتیں برقرار رکھتا ہے، جبکہ صرف Linux پیکیجنگ، ٹیسٹنگ اور تقسیم کی معاونت شامل کرتا ہے۔

نوٹ: یہ پروجیکٹ DeepSeek کا سرکاری ڈسٹری بیوشن ورژن نہیں ہے اور اس نے agent kernel میں کوئی تبدیلی نہیں کی۔ upstream ابھی developer preview مرحلے میں ہے، اس لیے بار بار اپ ڈیٹس یا غیر ہم آہنگ تبدیلیاں آ سکتی ہیں۔

پروجیکٹ x64 اور arm64 دونوں کو سپورٹ کرتا ہے۔ پہلا عام AMD اور Intel کمپیوٹرز کے لیے، جبکہ دوسرا Raspberry Pi 5، ARM سرورز اور Apple Silicon ڈیوائسز پر چلنے والے Linux کے لیے موزوں ہے۔

اہم خصوصیات

• تین ڈسٹری بیوشن فارمیٹس: AppImage، .deb اور .tar.gz فراہم کیے جاتے ہیں۔
• دو معماریوں کی معاونت: x64 اور arm64 ورژن بیک وقت بنائے جاتے ہیں۔
• AppImage خودکار اپ ڈیٹ: electron-updater اور nightly-linux.yml اپ ڈیٹ چینل کے ذریعے کام کرتا ہے۔
• مقامی CI: متعلقہ معماری کے لیے بالترتیب ubuntu-24.04 اور ubuntu-24.04-arm runner استعمال کیے جاتے ہیں۔
• upstream کے ساتھ ہم آہنگی: agent kernel اور اہم ڈیسک ٹاپ صلاحیتیں سرکاری پروجیکٹ کے ساتھ ہم آہنگ رکھی جاتی ہیں۔
• MIT لائسنس: upstream کوڈ اور نئی Linux پیکیجنگ پرت MIT لائسنس کے تحت تقسیم کیے جاتے ہیں۔

مناسب انسٹالیشن پیکیج کا انتخاب

AppImage: زیادہ تر صارفین کے لیے پہلا انتخاب

AppImage ایک واحد فائل پروگرام ہے، جسے روایتی تنصیب کی ضرورت نہیں ہوتی اور یہ پروجیکٹ کے فراہم کردہ خودکار اپ ڈیٹ چینل کو سپورٹ کرتا ہے۔ یہ ان صارفین کے لیے موزوں ہے جو تیزی سے آزمانا چاہتے ہیں یا سسٹم کے پیکیج مینیجر کی حالت میں تبدیلی سے بچنا چاہتے ہیں۔

DEB: Debian اور Ubuntu کے لیے موزوں

.deb فائل Debian سسٹم کے پیکیج مینجمنٹ ٹول سے انسٹال کی جا سکتی ہے اور اسے ایپلیکیشن مینو یا ٹرمینل سے شروع کیا جا سکتا ہے۔ یہ ان صارفین کے لیے موزوں ہے جو ایپلیکیشن کو سسٹم کے ڈیسک ٹاپ ماحول میں شامل کرنا چاہتے ہیں۔

tar.gz: قابلِ نقل اجرا

.tar.gz فائل کو extract کرنے کے بعد بغیر تنصیب کے چلایا جا سکتا ہے۔ یہ پورٹیبل ڈائریکٹری، ٹیسٹنگ ماحول یا ایسے حالات کے لیے موزوں ہے جہاں سسٹم سافٹ ویئر پیکیج انسٹال نہیں کیا جا سکتا۔

تنصیب سے پہلے معماری کی تصدیق

پہلے ٹرمینل میں موجودہ سسٹم کی معماری دیکھیں:

uname -m

• اگر نتیجہ x86_64 ہو تو ایسے ورژن کو ڈاؤن لوڈ کریں جس کے فائل نام میں linux-x64 شامل ہو۔
• اگر نتیجہ aarch64 یا arm64 ہو تو ایسے ورژن کو ڈاؤن لوڈ کریں جس کے فائل نام میں linux-arm64 شامل ہو۔

انسٹالیشن پیکیجز پروجیکٹ کے Releases صفحے سے حاصل کیے جا سکتے ہیں۔ کمیونٹی builds صرف اسی repository کے 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 فائل کو extract کر کے ڈائریکٹری میں موجود startup entry براہِ راست چلائیں:

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

arm64 صارفین کو بھی متعلقہ معماری کی فائل منتخب کر کے extract کرنا ہوگا۔

بنیادی استعمال

پروگرام شروع ہونے کے بعد upstream سے حاصل شدہ ڈیسک ٹاپ صلاحیتیں، بشمول agent، skill، نیٹ ورک فنکشنز اور ڈیسک ٹاپ فرنٹ اینڈ، استعمال کی جا سکتی ہیں۔ اس Linux fork نے agent kernel، پلگ اِن نظام یا مواصلاتی پروٹوکول میں تبدیلی نہیں کی، اس لیے متعلقہ رویہ سرکاری DeepSeek Harness کی implementation کے مطابق رہے گا۔

AppImage استعمال کرنے کی صورت میں ڈاؤن لوڈ کی گئی واحد فائل محفوظ رکھ کر اسے دوبارہ براہِ راست چلایا جا سکتا ہے؛ DEB پیکیج انسٹال ہونے کی صورت میں deepseek-harness کمانڈ یا ایپلیکیشن مینو سے شروع کیا جا سکتا ہے؛ پورٹیبل ورژن کے لیے extract کی گئی ڈائریکٹری سے ./deepseek-harness چلائیں۔

ریموٹ ڈیسک ٹاپ یا بغیر ڈسپلے والے ماحول میں اجرا

یہ ایک ڈیسک ٹاپ ایپلیکیشن ہے۔ VNC کے ساتھ ریموٹ سرور استعمال کرتے وقت یقینی بنائیں کہ DISPLAY درست طور پر سیٹ ہے۔ مثال کے طور پر xfce4 اور TigerVNC ماحول میں ڈسپلے نمبر :1 ہو سکتا ہے:

export DISPLAY=:1
./deepseek-harness

ڈسپلے ماحول دستیاب ہونے پر ڈیسک ٹاپ پروگرام خود شروع ہو جائے گا۔ اصل ڈسپلے نمبر موجودہ VNC یا گرافیکل سیشن کی configuration کے مطابق ہونا چاہیے۔

سورس سے تعمیر

انحصارات کی تیاری

سورس سے تعمیر کے لیے Node.js 24 یا اس سے جدید ورژن، pnpm اور build host پر libfuse2 درکار ہیں۔ libfuse2 AppImage assemble کرنے کے لیے استعمال ہوتا ہے۔

کلون کریں اور انحصارات انسٹال کریں

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

Linux ماحول کی فائل تیار کریں

پروجیکٹ کی فراہم کردہ مثال والی فائل copy کریں اور release settings ضرورت کے مطابق پُر کریں:

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 تینوں فارمیٹس تیار ہوں گے۔ پروجیکٹ کا Desktop (Linux) workflow بھی native runner پر ضرورت کے مطابق build کرتا ہے، اور artifacts GitHub Actions Artifacts یا خودکار طور پر بنائے گئے Release سے حاصل کیے جا سکتے ہیں۔

خودکار اپ ڈیٹ اور سیکیورٹی تصدیق

AppImage، electron-updater کے ذریعے AppImage update channel استعمال کرتا ہے، update descriptor nightly-linux.yml ہے اور منتقلی HTTPS کے ذریعے ہوتی ہے۔

اہم: موجودہ Linux build code-signed نہیں ہے۔ خودکار اپ ڈیٹ صرف HTTPS منتقلی اور feed metadata کی تصدیق پر منحصر ہے، اس میں code-signature verification شامل نہیں؛ اس لیے یہ اعلیٰ اعتماد والے ماحول میں براہِ راست استعمال کے لیے موزوں نہیں ہے۔

ڈاؤن لوڈ یا اپ ڈیٹ کے بعد فائل کے SHA256 کو Release صفحے پر فراہم کردہ checksum سے ملائیں۔ خلاصہ calculate کرنے کے لیے یہ کمانڈ استعمال کی جا سکتی ہے:

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

یقینی بنائیں کہ نتیجہ Release میں شائع کردہ قدر سے مکمل طور پر یکساں ہو۔ DEB، tar.gz اور arm64 فائلوں کی بھی اسی طریقے سے تصدیق کی جا سکتی ہے۔

معلوم حدود

1. Build unsigned ہے: Linux binary files پر code signature یا system-level notarization موجود نہیں۔
2. Office دستاویز کی تبدیلی فی الحال دستیاب نہیں: DOCX، XLSX اور PPTX کو PDF میں تبدیل کرنا LibreOffice Kit کی native Linux bindings پر منحصر ہے، جو موجودہ ورژن کے انسٹالیشن پیکیج کے ساتھ تقسیم نہیں کی جاتیں۔
3. upstream ابھی preview مرحلے میں ہے: سرکاری پروجیکٹ developer preview میں ہے، اس لیے بار بار یا غیر ہم آہنگ تبدیلیاں ہو سکتی ہیں۔
4. ایپ اسٹور ورژن نہیں: پروجیکٹ ایپ اسٹور کے publishing process سے نہیں گزرتا۔

Office conversion کی یہ حد README میں واضح کردہ دیگر ڈیسک ٹاپ صلاحیتوں، بشمول agent، skill، نیٹ ورک فنکشنز اور فرنٹ اینڈ، کو متاثر نہیں کرتی۔

اعلیٰ سطحی تجاویز

• معماری کو ترجیحاً ملائیں: x64 سسٹم پر arm64 پیکیج یا اس کے برعکس ڈاؤن لوڈ نہ کریں۔
• اپ ڈیٹ کی صلاحیت درکار ہو تو AppImage منتخب کریں: DEB اور tar.gz کے README میں AppImage update channel کے استعمال کا اعلان نہیں کیا گیا۔
• تصدیقی عمل برقرار رکھیں: پہلی بار ڈاؤن لوڈ اور اپ ڈیٹ، دونوں صورتوں میں Release کے SHA256 کی جانچ کریں۔
• upstream تبدیلیوں پر نظر رکھیں: یہ fork مسلسل upstream commits کو rebase کرتا ہے، اس لیے اپ گریڈ سے پہلے Release notes دیکھیں۔
• ڈیولپر native CI استعمال کریں: دونوں معماریوں کی بیک وقت توثیق درکار ہو تو موجودہ Desktop (Linux) workflow استعمال کریں، بجائے اس مفروضے کے کہ cross-build کا نتیجہ native build کے برابر ہوگا۔

چلانے سے پہلے upstream کی SAFETY.md بھی پڑھیں۔ سرکاری upstream پروجیکٹ deepseek-ai/deepseek-harness پر موجود ہے۔

خلاصہ

DeepSeek Harness Linux سرکاری ڈیسک ٹاپ ورژن کے لیے x64 اور arm64 Linux تقسیم کی صلاحیت فراہم کرتا ہے۔ عام صارفین خودکار اپ ڈیٹ کی معاونت رکھنے والے AppImage کو ترجیح دے سکتے ہیں، جبکہ Debian یا Ubuntu صارفین DEB انسٹال کر سکتے ہیں اور پورٹیبل اجرا کے لیے tar.gz منتخب کیا جا سکتا ہے۔ موجودہ build کے unsigned ہونے کی وجہ سے ڈاؤن لوڈ، اپ ڈیٹ اور deployment کے دوران SHA256 ضرور چیک کریں اور developer preview مرحلے میں compatibility کی تبدیلیوں پر نظر رکھیں۔