دليل المبتدئين ديال Lancer: بنّي مساحة عمل مكتبية موازية للذكاء الاصطناعي وقابلة للتتبّع

شنو هو Lancer

Lancer هو مساحة عمل مكتبية للذكاء الاصطناعي مبنية على pi-gui وpi. كيجمع المحادثات، والفروع المتوازية، ومراحل التنفيذ، والملفات المسلّمة فواجهة وحدة، وكيعاونك تتبّع المهمة كاملة من الإنشاء والتقسيم حتى التسليم.

مهم: Lancer مازال دابا فمرحلة Alpha، وmacOS Apple Silicon هي المنصة الرئيسية للاختبار. Linux وWindows عندهم إعدادات البناء، ولكن هاد الشي ما كيعنيش أن جميع القدرات الأصلية تجرّبات كاملة. الأرشيف المضغوط ديال المصدر ماشي تطبيق مكتبي جاهز للتشغيل بالنقر المزدوج.

الوظائف الأساسية

المحادثات والمهام المعيارية

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

الفروع المتوازية وتجميع النتائج

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

رسم أحداث المهام GitTree

GitTree اللي فالجهة اليمنى من الواجهة يقدر يبيّن فآن واحد عدة خطوط ديال المحادثات، والفروع، وعمليات الدمج، وعقد التسليم، ويقدر حتى يركّز على المحادثة الحالية. خاص الانتباه أن GitTree كيمثّل رسم أحداث المهام، والعقد ديالو ماشي كاملين كيمثلو commits حقيقية فـ Git.

التغذية الراجعة على التنفيذ وتأثيرات الضوء

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

الموديلات والحسابات والتحكم فـ Doubao

Lancer كيتاصل عبر pi بحسابات الاشتراك، ومفاتيح API، والنقاط النهائية المخصصة، وكيُسيّر بشكل منفصل العلامات ديال الموديلات والبوابات. فـ macOS، يقدر حتى يربط جلسة مفتوحة من تطبيق Doubao باش يستقبل الردود والفيديو. التحكم فـ Doubao كيحتاج صلاحيات ميزات المساعدة فالجهاز، وتحديثات واجهة تطبيق Doubao المكتبي تقدر تأثر على التوافق.

سير عمل تحليل الفيديو

سير عمل الفيديو يقدر يحمّل أو يستقبل الفيديو، ويستخرج الإطارات الرئيسية، ويولّد تحليلا وملفات تسليم فيها الأدلة. ولكن الاستنساخ التلقائي حاليا ما كيضمنش تطابقا 1:1 مع القالب. التحكم فـ Doubao، وتحليل الموديل، والرسوم المتحركة بالكود، والمونتاج النهائي مراحل مختلفة، وخص التحقق من كل مرحلة بوحدها.

التحضيرات قبل التثبيت

قبل ما تبدا، تأكد أن بيئة التطوير كتستوفي المتطلبات التالية:

• Node.js >=22.19.0 و <26، وكيُنصح باستعمال Node.js 24.
• pnpm 10.34.9.
• Git.
• macOS كيحتاج Xcode Command Line Tools.
• Linux كيحتاج Python 3، وmake، ومترجم C++، وبيئة سطح مكتب رسومية، ومكتبات التشغيل النظامية اللازمة لـ Electron.
• الاعتماديات الأصلية ديال Windows تقدر تحتاج Python وVisual Studio Build Tools فيه عبء عمل C++، ولكن النسخة الحالية مازال ما تجرّباتش فيها سلوكيات Windows الأصلية بشكل كامل.

إلى كان macOS ناقصو أدوات سطر الأوامر، تقدر تشغّل:

xcode-select --install

فـ Debian أو Ubuntu تقدر تثبّت اعتماديات البناء ديال Linux:

sudo apt-get install build-essential python3

التثبيت والتشغيل من المصدر

فكّ ضغط المصدر أو دير clone فمجلد جديد، دخل لجذر المستودع، ومن بعد نفّذ الأوامر التالية بالترتيب:

npx --yes pnpm@10.34.9 run doctor
npx --yes pnpm@10.34.9 install --frozen-lockfile
npx --yes pnpm@10.34.9 dev

هاد الأوامر كتستعمل pnpm 10.34.9 بشكل ثابت، وما كايناش حاجة لتشغيل corepack enable ولا لتثبيت pnpm عالميا. إلا كان نفس الإصدار مثبت فالنظام، تقدر تبدّل السابقة ديال الأوامر مباشرة بـ pnpm.

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

npx --yes pnpm@10.34.9 run setup:electron
npx --yes pnpm@10.34.9 dev

ما تحاولش تصلّح مشكل تثبيت Electron بالسماح العشوائي لجميع سكريبتات الاعتماديات أو بإغلاقها كاملة؛ فالأول راجع سجل التثبيت وأخطاء الشبكة.

إكمال الإعداد الأول

1. شغّل Lancer ودخل للإعدادات.
2. ربط حساب موديل مدعوم، أو مزوّد، أو نقطة نهائية مخصصة. المصدر ما فيهش بيانات الاعتماد الشخصية.
3. زيد مساحة عمل أو اختار وحدة موجودة.
4. أنشئ محادثة عادية، أو حسب الحاجة أنشئ محادثة وحدة فيها مراحل، وموديل، ومهارة، وهدف، ومتطلبات التسليم.
5. من بعد تشغيل المهمة، راقب فـ GitTree خط المحادثة، والفروع المشتقة، وعقد التجميع والتسليم.

تقدر تحدد لغة الواجهة عبر متغير البيئة:

LANCER_LOCALE=zh-CN npx --yes pnpm@10.34.9 dev

بالنسبة للواجهة بالإنجليزية، بدّل القيمة إلى en.

تحميل إعدادات البيئة الاختيارية

الإعدادات الاختيارية مسجلة فـ .env.example داخل المستودع، ولكن سكريبت تشغيل سطح المكتب ما كيقرّاش هاد الملف تلقائيا. فـ macOS أو Linux، تقدر تنسخ القالب وتحملو فالطرفية الحالية:

cp .env.example .env.local
set -a
. ./.env.local
set +a
npx --yes pnpm@10.34.9 dev

مستخدمو PowerShell يقدرو يحددو متغيرات البيئة وحدة بوحدة، مثلا:

$env:LANCER_LOCALE = "en"

خاص ربط حسابات الموديلات الحقيقية من إعدادات التطبيق. ما ترفعش مفاتيح API، أو ملفات المصادقة، أو النقاط النهائية الخاصة، أو المحادثات الحقيقية، أو تسجيلات الجلسات للمستودع العمومي.

إعداد أدوات الفيديو

إلى كنت غادي تستعمل غير واجهة المحادثة، ما كتحتاجش أدوات الوسائط. أما إلا بغيتي تشغّل عمليات تحميل الفيديو، واستخراج الإطارات الرئيسية، وتحليل الوسائط، فخاصك FFmpeg وFFprobe وyt-dlp قابلين للتنفيذ.

pnpm run doctor --media

إلى ما كانتش هاد الأدوات فـ PATH، تقدر تحدد المسارات المطلقة ديالها عبر متغيرات البيئة FFMPEG وFFPROBE وYT_DLP، أو تهيّأ المسارات فـ video-learn-tools.json داخل مجلد بيانات المستخدم.

أمر التشخيص كينفّذ فعليا أوامر إظهار الإصدار ديال كل أداة، وبالتالي ما كيكتاشفش غير الملفات الناقصة، بل حتى التثبيتات المعطوبة اللي فيها “الملف التنفيذي موجود ولكن المكتبة الديناميكية ناقصة”. قبل التحقق الكامل، تقدر تدير فحص يدوي:

ffmpeg -version
ffprobe -version

فحوصات التشغيل والبناء والاختبارات

ملي كتوجد باش ترفع تعديلات أو تقيّم حالة المصدر، تقدر تشغّل الفحوصات التالية:

pnpm check
pnpm build
pnpm audit:dependencies
pnpm verify:install-copy
pnpm verify:release-config
pnpm --filter @lancer/desktop run test:e2e:core

أثناء التطوير، تقدر حتى تتحقق من إعادة تحميل سطح المكتب:

pnpm --filter @lancer/desktop run test:dev:reload

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

إعادة استعمال Lancer Light UI بشكل مستقل

إلى كنت محتاج غير تأثيرات الضوء اللي كتربط الموديل أو الفقاعات بشجرة العمل، تقدر تصدّر Lancer Light UI. ما كيحتاجش Electron ولا CLI ولا خدمة موديل، وكيقدّم أمثلة على الخط الواحد، والتفرع والدمج، والتوازي بين عدة محادثات.

pnpm export:light-ui /absolute/new/lancer-light-ui
cd /absolute/new/lancer-light-ui
npm install && npm run dev

خاص مسار التصدير يتبدّل للمسار المطلق فالجهاز المستهدف. لمزيد من التوضيحات، شوف README ديال Light UI فالمستودع.

بناء التطبيق المحلي على macOS

حزمة المصدر ما فيهاش .app جاهز للنقر المزدوج، كما أن تنزيل التطبيق المستقل مازال ما تنشرش. من بعد تثبيت الاعتماديات، تقدر تشغّل سكريبت البناء المحلي:

bash scripts/build-mac-lancer.sh --skip-install --dir

حزمة التثبيت المحلية كتحتاج من قبل شهادة توقيع دائمة. السكريبت ما كينشئش الشهادة تلقائيا، وما كيبدلهاش لتوقيع مؤقت، وما كينفذش التوثيق. نتيجة البناء كتتحفظ فمجلد مستقل من نوع apps/desktop/release-local-*/.

من بعد التحقق من التطبيق المرشح، تقدر تزيد --install باش تثبتو فـ /Applications:

bash scripts/build-mac-lancer.sh --skip-install --dir --install

المثبّت كيتطلب أن التطبيق القديم يسد بشكل عادي، وكيعاين التوقيع وكيحتافظ بالنسخة القديمة القابلة للاسترجاع، وما كيمسحش بيانات الجلسات. التوزيع العمومي مازال كيحتاج Developer ID، والتوثيق، والتحقق على جهاز نقي؛ والتوقيع المحلي ما يمكنش يتعتبر مصادقة مكتملة للنشر العمومي.

الاستعمال المتقدم ونصائح الأمان

فهم مكان بيانات التشغيل

بيانات الجلسات والحسابات كتستعمل ~/.pi/agent ديال pi. فـ macOS، حالة واجهة Lancer كاينة فـ ~/Library/Application Support/Lancer. نسخ المصدر لمجلد آخر ما كيعزلش بيانات التشغيل هادي؛ إلا بغيتي اختبارا يدويا معزولا بشكل كامل، استعمل مستخدم نظام تشغيل مستقل.

تصميم الفروع للمهام المعقدة

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

التحقق من مراحل الفيديو بشكل منفصل

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

تصدير حزمة مصدر مرشحة قابلة للمراجعة

ملي كتوجد لإصدار المصدر، تقدر تصدّر مجلدا مرشحا جديدا ولائحة SHA-256:

pnpm export:source /absolute/path/to/new/lancer-source

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

الأسئلة الشائعة

• Corepack عطى خطأ فالصلاحيات: استعمل الأمر ذي الإصدار الثابت npx --yes pnpm@10.34.9، وما كايناش حاجة تبدّل shim العالمي.
• Electron ما تثبتش بشكل صحيح: راجع الشبكة وأخطاء التثبيت، ومن بعد شغّل run setup:electron.
• Linux كيقول إن make أو المترجم ناقص: ثبّت أولا Python 3 وmake وأدوات بناء C++، ومن بعد عاود تثبيت الاعتماديات.
• فحص أدوات الفيديو فشل: نفّذ pnpm doctor --media، وتأكد أن الملفات التنفيذية والمكتبات الديناميكية ديالها كاملين خدامين.
• الموديل ما خدامش: ربط من الإعدادات حسابا أو مزوّدا مدعوما؛ المصدر ما فيهش معلومات المصادقة الشخصية.

الخلاصة

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