الإجاباتمنشور15 المصادر
كيف تثبّت المشروع على Windows 10 باستخدام WSL2؟
لا يوصي المشروع بالتثبيت مباشرة من PowerShell أو موجه الأوامر؛ مسار WSL2 مع Ubuntu هو الأنسب للتجربة. يعتمد المشروع على Bash وGit وGNU timeout وPython 3.10+ وPyYAML، ويستخدم قفل ملفات خاصًا بـUnix لا يتوفر في Windows الأصلي.[7] نجاح توزيع الملفات داخل WSL لا يعني أن أدوات التطوير أو الإضافات العاملة على Windows ستتع...
نشر بواسطةتم إنشاء الصور باستخدام GPT Image 2
إجابة البحث
الوجبات السريعة الرئيسية
- لا يوصي المشروع بالتثبيت مباشرة من PowerShell أو موجه الأوامر؛ مسار WSL2 مع Ubuntu هو الأنسب للتجربة.
- يعتمد المشروع على Bash وGit وGNU timeout وPython 3.10+ وPyYAML، ويستخدم قفل ملفات خاصًا بـUnix لا يتوفر في Windows الأصلي.[7]
- نجاح توزيع الملفات داخل WSL لا يعني أن أدوات التطوير أو الإضافات العاملة على Windows ستتعرف عليها تلقائيًا.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the](https://d15bya8fi85z1v.cloudfront.net/chat/IbEfUgNRVbQuBwZI6xLn8uUpdIy1/images/70A21BC5961258BE376D/8C9CEB076789B956243D.png)
موجّه الذكاء الاصطناعي
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"当前项目不能直接用 Windows 原生 PowerShell/CMD 完成安装；Win10 上建议采用 WSL2 + Ubuntu 路线。以下是基于已读取源码的安装建议，未在 Win10 实机验证，也未执行安装或修改项目。\n\n 兼容性结论\n\n 安装依赖 Bash、Git、GNU timeout、Pyth. Topic tags: general web, workflow, code, python, api. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts wit
إذا كنت تريد تثبيت هذا المشروع على Windows 10، فالنقطة الأهم هي أن تشغيل أوامر التثبيت في PowerShell وحده لا يكفي. يعتمد المشروع على أدوات وميزات من بيئة Linux، ولذلك فإن المسار المقترح هو استخدام WSL2 مع Ubuntu.
لماذا WSL2؟
تتضمن متطلبات المشروع Bash وGit وأداة GNU timeout وPython 3.10 أو أحدث وPyYAML، وفقًا لـREADME.md. كما يستورد أحد مكوّنات النشر وحدة fcntl الخاصة بقفل الملفات، وهي متاحة لأنظمة Unix وليست جزءًا من Python على Windows.7 كذلك، يتوقع اكتشاف الأنماط تلقائيًا بنية تخزين خاصة بـLinux، بحسب
deployment_targets.py.
لهذا، فإن تثبيت Git Bash وPython لنظام Windows لا يعوّض وحده بيئة Linux المطلوبة. وحتى عند استخدام WSL، لا يعني نقل الملفات إلى بيئته أن البرنامج أو الإضافة المثبّتة على Windows ستكتشفها تلقائيًا.
1. تثبيت WSL وUbuntu
تعمل طريقة التثبيت المختصرة أدناه على Windows 10 بالإصدار 2004 (البنية 19041) أو أحدث؛ أما الإصدارات الأقدم فقد تتطلب خطوات تثبيت يدوية.15
10
12
افتح PowerShell بصلاحيات المسؤول وشغّل:12
wsl --install -d Ubuntu
أكمل إعادة التشغيل إذا طُلبت منك، ثم افتح Ubuntu وأنشئ اسم مستخدم وكلمة مرور لنظام Linux.3
تحقق من إصدار WSL المستخدم:12
wsl --list --verbose
إذا ظهر الرقم 1 في عمود VERSION بجانب Ubuntu، فحوّل التوزيعة إلى WSL2:12
wsl --set-version Ubuntu 2
2. تثبيت متطلبات المشروع واستنساخ المستودع
نفّذ الأوامر التالية داخل طرفية Ubuntu، لا في PowerShell. اطلب صلاحية sudo أولًا، ثم ثبّت الأدوات التي يذكرها المشروع. إذا فشل أي أمر، توقّف قبل متابعة التثبيت.
sudo -v
timeout 600s sudo -n apt-get update < /dev/null &&
timeout 600s sudo -n env DEBIAN_FRONTEND=noninteractive apt-get install -y git coreutils python3 python3-yaml < /dev/null
انتقل إلى مجلد Linux الذي اخترته لاستضافة المشروع، ثم استنسخ المستودع. عنوانه وارد في install.sh:
timeout 30s env GIT_TERMINAL_PROMPT=0 git -c core.autocrlf=false -c core.hooksPath=/dev/null clone --no-recurse-submodules --branch main https://github.com/zhaosan2023/dotfiles-bmad-solo.git dotfiles-bmad-solo < /dev/null
بعد نجاح الاستنساخ، ادخل إلى مجلد المشروع:
cd dotfiles-bmad-solo
راجع نسختي install.sh وbs.sh اللتين نُزّلتا قبل تشغيل أي منهما. لا تمرّر نصًا برمجيًا بعيدًا مباشرة إلى الصدفة؛ ويوصي المشروع بمراجعة النسخة الموثوقة قبل التثبيت أيضًا، وفقًا لـREADME.md.
3. افحص قبل إجراء أي تغييرات
من جذر المستودع، شغّل الفحص المسبق والتشغيل التجريبي. يدعم bs.sh الخيارين المذكورين، وفقًا لـbs.sh:
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
لا تتابع إلا إذا نجح الفحص، وتأكدت من أن الوجهة صحيحة، ووافقت على أن يكتب التثبيت في الإعدادات العامة لمستخدم Linux الحالي. عندها شغّل النشر وتحقق من الحالة، كما يوضح README.md:
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
إذا أبلغت الأداة عن تعارض في الملفات أو إعدادات تالفة أو عملية غير مكتملة، عالج المشكلة أولًا. لا تحذف سجلات الحالة ولا تتجاوز التعارض بالقوة؛ راجع README.md.
4. انتبه إلى مكان تشغيل أداة التطوير
- مع VS Code، يمكنك تثبيت البرنامج وإضافة WSL على Windows، ثم فتح مساحة العمل المتصلة بـUbuntu. توصي Microsoft بهذا الأسلوب لتطوير البرامج عبر WSL.
9
- تحقّق من مضيف الإضافة الذي يعمل فيه Roo، ومن أن إعدادات الأنماط موجودة في البيئة التي تستخدمها. ويشير المشروع إلى ضرورة التحقق من عمل الأداة فعليًا بعد التثبيت، وفقًا لـ
README.md. - إذا كنت تستخدم Antigravity أو Gemini أو Roo كتطبيق Windows أصلي، فلا تعتبر نشر الملفات داخل WSL تثبيتًا ناجحًا على Windows. فالاكتشاف التلقائي الحالي لا يغطي مسارات الإعدادات الأصلية في Windows، بحسب
deployment_targets.py.
الخلاصة: إذا كان استخدام WSL2 مناسبًا لك، فاتبع الخطوات السابقة باعتبارها مسارًا للتثبيت والتجربة داخل Ubuntu. أما إذا كان المطلوب تشغيل المشروع بالكامل في بيئة Windows الأصلية، فلا يوفّر الكود الحالي أمر تثبيت مكتملًا يمكن التوصية به دون تعديلات تشمل أقفال الملفات والصلاحيات ومزامنة المجلدات ومسارات إعدادات Windows. وحتى مع نجاح نقل الملفات، يبقى التحقق من تحميلها وعملها داخل أداة التطوير خطوة مستقلة، وفقًا لـREADME.md.
Studio Global AI
مواصلة البحث الخاص بك
تتضمن هذه الصفحة إجابة مدعومة بالمصدر يمكنك المتابعة داخل Studio Global.
يسأل الناس أيضا
ما هي الإجابة المختصرة على "كيف تثبّت المشروع على Windows 10 باستخدام WSL2؟"؟
لا يوصي المشروع بالتثبيت مباشرة من PowerShell أو موجه الأوامر؛ مسار WSL2 مع Ubuntu هو الأنسب للتجربة.
ما هي النقاط الأساسية التي يجب التحقق منها أولاً؟
لا يوصي المشروع بالتثبيت مباشرة من PowerShell أو موجه الأوامر؛ مسار WSL2 مع Ubuntu هو الأنسب للتجربة. يعتمد المشروع على Bash وGit وGNU timeout وPython 3.10+ وPyYAML، ويستخدم قفل ملفات خاصًا بـUnix لا يتوفر في Windows الأصلي.[7]
ماذا يجب أن أفعل بعد ذلك في الممارسة العملية؟
نجاح توزيع الملفات داخل WSL لا يعني أن أدوات التطوير أو الإضافات العاملة على Windows ستتعرف عليها تلقائيًا.
المصادر
docs.python.orgfcntl — The fcntl and ioctl system calls — Python 3.14.8 documentation
devblogs.microsoft.comdevblogs.microsoft.com · commandline · install-wslInstall WSL with a single command now available in Windows 10 ...