AnswersPublished15 sources
כך מתקינים את הפרויקט ב-Windows 10 — עם הסתייגות חשובה
הפרויקט דורש Bash, Git, כלי timeout של GNU, Python 3.10 ומעלה ו PyYAML, ומסתמך גם על רכיב נעילת קבצים שזמין ב Unix. ב Windows 10 אפשר לנסות להתקין דרך WSL2 ו Ubuntu, ואז להריץ בדיקות מקדימות לפני פריסה.
פורסם על ידיהתמונות נוצרו באמצעות GPT Image 2
Research answer
Key takeaways
- הפרויקט דורש Bash, Git, כלי timeout של GNU, Python 3.10 ומעלה ו PyYAML, ומסתמך גם על רכיב נעילת קבצים שזמין ב Unix.
- ב Windows 10 אפשר לנסות להתקין דרך WSL2 ו Ubuntu, ואז להריץ בדיקות מקדימות לפני פריסה.
- אם כלי הפיתוח פועל ב Windows עצמו, פריסה ב WSL לא מבטיחה שהוא יטען את ההגדרות או המצבים של הפרויקט.
![[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)
AI Prompt
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
השורה התחתונה
לפי מבנה הפרויקט, התקנה ישירה דרך PowerShell או CMD אינה מסלול מומלץ. בין התלויות שלו נמצאים Bash, Git, כלי timeout של GNU, Python 3.10 ומעלה ו-PyYAML, וקוד הפריסה משתמש במודול fcntl של Python — ממשק לשגרות Unix שאינו זמין ב-Windows.7 לכן, אם אפשר להשתמש ב-WSL, המסלול הסביר הוא Ubuntu בתוך WSL2.
חשוב לסייג: ההוראות כאן מבוססות על בדיקת קוד הפרויקט והמקורות, ולא על התקנה שנבדקה בפועל במחשב Windows 10.
1. התקנת WSL ו-Ubuntu
ב-Windows 10 בגרסה 2004 ומעלה (Build 19041 ומעלה), אפשר לפתוח PowerShell כמנהל ולהריץ:12
wsl --install -d Ubuntu
הפקודה הפשוטה להתקנת WSL זמינה גם ב-Windows 10 בגרסה 2004 ומעלה; בגרסאות ישנות יותר ייתכן שיהיה צורך בהתקנה ידנית.15
10 לאחר ההתקנה, פתחו את Ubuntu ופעלו לפי ההנחיות ליצירת שם משתמש וסיסמה ל-Linux.
3
בדקו ש-Ubuntu פועלת בגרסה 2 של WSL:12
wsl --list --verbose
אם בעמודת VERSION מופיע 1, אפשר לבקש המרה ל-WSL2:12
wsl --set-version Ubuntu 2
2. התקנת התלויות ושכפול המאגר
את הפקודות הבאות מריצים בתוך מסוף Ubuntu, לא ב-PowerShell. תחילה ודאו שאפשר לבצע פעולות מנהל באמצעות sudo, ואז התקינו את התלויות:[^project-deps]
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
שכפלו את המאגר לספרייה שתבחרו. כתובת המאגר מופיעה בסקריפט 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 של הפרויקט ממליץ לבדוק את הסקריפטים לפני שמריצים אותם; אל תעבירו סקריפט מרוחק ישירות לצינור הרצה.
3. בדיקה לפני פריסה
מתוך תיקיית המאגר, הריצו תחילה בדיקות מקדימות ומצב הדמיה, שאמורים לבדוק את התהליך בלי לבצע פריסה בפועל. שני הדגלים נתמכים על ידי bs.sh:
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
רק אם הבדיקות מסתיימות בהצלחה, היעד נכון ואתם מסכימים לכתוב הגדרות גלובליות עבור משתמש ה-Linux הנוכחי, המשיכו לפריסה ולבדיקת המצב:
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
אם מתקבלת אזהרה על קבצים קיימים שמתנגשים, הגדרות פגומות או פעולה קודמת שלא הושלמה, עצרו וטפלו בבעיה לפני שממשיכים. אל תמחקו רשומות מצב ואל תעקפו את הבדיקות.
4. האם כלי הפיתוח יזהה את ההתקנה?
לא בהכרח. מנגנון איתור המצבים בפרויקט מכוון לפריסות במבנה אחסון של Linux (deployment_targets.py). לכן, העתקת קבצים לתוך WSL אינה מוכיחה שכלי פיתוח שמותקן ורץ ב-Windows עצמו יטען אותם.
למשתמשי VS Code, Microsoft מתעדת סביבת עבודה שבה VS Code מותקן ב-Windows ומתחבר ל-Ubuntu באמצעות WSL וההרחבה המתאימה.9 גם במקרה כזה צריך לבדוק באיזה מארח רצה ההרחבה של Roo, והאם הגדרות המצב שייכות לאותו מארח. אם משתמשים ב-Antigravity, Gemini או Roo שפועלים ישירות ב-Windows, אין להניח שההתקנה ב-WSL התקינה אותם גם בסביבת Windows.
בשורה התחתונה: WSL2 עם Ubuntu הוא מסלול אפשרי להפעלת תהליך הפריסה, אך לא תחליף להתאמה מלאה ל-Windows. אם חייבים לעבוד ב-Windows מקורי בלבד, צריך להתאים את הקוד ואת נתיבי ההגדרות למערכת הזו. הצלחת העתקת הקבצים, כשלעצמה, אינה אישור לכך שכלי הפיתוח טען אותם או שההרשאות נבדקו.
[^project-deps]: דרישות התלויות מצוינות ב-README.md של הפרויקט.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "כך מתקינים את הפרויקט ב-Windows 10 — עם הסתייגות חשובה"?
הפרויקט דורש Bash, Git, כלי timeout של GNU, Python 3.10 ומעלה ו PyYAML, ומסתמך גם על רכיב נעילת קבצים שזמין ב Unix.
What are the key points to validate first?
הפרויקט דורש Bash, Git, כלי timeout של GNU, Python 3.10 ומעלה ו PyYAML, ומסתמך גם על רכיב נעילת קבצים שזמין ב Unix. ב Windows 10 אפשר לנסות להתקין דרך WSL2 ו Ubuntu, ואז להריץ בדיקות מקדימות לפני פריסה.
What should I do next in practice?
אם כלי הפיתוח פועל ב Windows עצמו, פריסה ב WSL לא מבטיחה שהוא יטען את ההגדרות או המצבים של הפרויקט.
Sources
docs.python.orgfcntl — The fcntl and ioctl system calls — Python 3.14.8 documentation
learn.microsoft.comInstall WSL
devblogs.microsoft.comdevblogs.microsoft.com · commandline · install-wslInstall WSL with a single command now available in Windows 10 ...