AnswersPublished15 sources
Як встановити проєкт на Windows 10: покрокова інструкція через WSL2
Проєкт не можна повноцінно встановити лише засобами Windows PowerShell або CMD: він залежить від Bash, GNU timeout і Unix механізму блокувань файлів. Рекомендований варіант для Windows 10 — Ubuntu у WSL2; команда wsl install працює на Windows 10 версії 2004 і новіших збірках 19041 або вище.
ОпублікувавЗображення створено за допомогою GPT Image 2
Research answer
Key takeaways
- Проєкт не можна повноцінно встановити лише засобами Windows PowerShell або CMD: він залежить від Bash, GNU timeout і Unix механізму блокувань файлів.
- Рекомендований варіант для Windows 10 — Ubuntu у WSL2; команда wsl install працює на Windows 10 версії 2004 і новіших збірках 19041 або вище.
- Перед розгортанням потрібно перевірити сценарії встановлення й результати попереднього тесту, а також з’ясувати, де саме працює ваша IDE.
![[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
Для цього проєкту WSL2 з Ubuntu — практичніший варіант, ніж спроба встановити його безпосередньо у Windows. Причина не лише в тому, що потрібен Bash: скрипти також використовують Unix-модуль fcntl, якого немає у Windows-версії Python. 7
Наведені нижче кроки — рекомендація на основі вимог проєкту та документації Microsoft. Їх не перевіряли на реальному комп’ютері з Windows 10, і жодних команд встановлення чи змін у проєкті тут не виконували.
Чому потрібен WSL2
У README.md серед залежностей зазначено Bash, Git, GNU timeout, Python 3.10 або новішої версії та PyYAML. Крім того, модуль розгортання імпортує fcntl — Unix-інтерфейс для роботи з файловими дескрипторами й блокуваннями. 7 Тому встановлення Git Bash і Windows-версії Python саме по собі не розв’язує проблему сумісності.
Також автоматичне виявлення режимів орієнтується на Linux-структуру каталогів (deployment_targets.py, рядок 11). Отже, розмістити файли в WSL — ще не означає, що їх автоматично підхопить Windows-версія IDE.
1. Встановіть WSL і Ubuntu
Однокомандний спосіб інсталяції WSL доступний для Windows 10 версії 2004 і новіших — збірка 19041 або вище. Для старіших версій Windows можуть знадобитися ручні кроки. 12
10
15
Запустіть PowerShell від імені адміністратора та введіть: 12
wsl --install -d Ubuntu
Дотримуйтесь підказок і перезавантажте комп’ютер, якщо система попросить. Під час першого запуску Ubuntu створіть ім’я користувача та пароль Linux. 3
Перевірте, чи працює дистрибутив у WSL2: 12
wsl --list --verbose
Якщо навпроти Ubuntu в колонці VERSION стоїть 1, перейдіть на WSL2: 12
wsl --set-version Ubuntu 2
2. Підготуйте Ubuntu та завантажте репозиторій
Наступні команди виконуйте в терміналі Ubuntu, а не в PowerShell. Спершу пройдіть запит автентифікації адміністратора, а потім встановіть залежності. Якщо команда завершиться помилкою, зупиніться й з’ясуйте причину, перш ніж продовжувати.
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, рядок 33).
3. Запустіть попередню перевірку
У кореневій папці репозиторію виконайте спочатку попередню перевірку, а потім пробний запуск. Параметри --preflight і --dry-run підтримує bs.sh (рядок 343):
timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null
Переходьте до розгортання лише тоді, коли перевірка завершилася успішно, ви впевнені, що вибрано правильне середовище, і погоджуєтеся змінити глобальні налаштування поточного користувача Linux. Команда встановлення й перевірки статусу (README.md, рядок 39):
timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null
Якщо сценарій повідомляє про конфлікт файлів, пошкоджену конфігурацію чи незавершену транзакцію, спершу розберіться з проблемою. Не видаляйте записи стану й не перезаписуйте файли силоміць (README.md, рядок 85).
4. Переконайтеся, що IDE бачить саме це середовище
Якщо ви працюєте у VS Code, встановіть програму та розширення WSL у Windows, а потім відкрийте робочу папку Ubuntu через WSL. Такий спосіб розробки рекомендує Microsoft. 9
Водночас важливо з’ясувати, де саме запускається Roo та якому середовищу належать його налаштування режимів: середовище розширень може відрізнятися. У документації проєкту окремо зазначено, що роботу потрібно перевіряти під час фактичного запуску (README.md, рядок 94).
Якщо Antigravity, Gemini чи Roo працюють як звичайні Windows-програми, не вважайте розгортання у WSL автоматичною інсталяцією для них. Поточне автоматичне виявлення не охоплює шляхи конфігурації Windows (deployment_targets.py, рядок 11).
Висновок: якщо ви можете користуватися WSL2, спробуйте встановлення через Ubuntu за цією інструкцією. Якщо ж проєкт має працювати повністю у Windows без Linux-середовища, наразі немає підстав рекомендувати готову команду інсталяції: спочатку знадобиться адаптація роботи з блокуваннями файлів, правами доступу, синхронізацією каталогів і шляхами конфігурації Windows. Успішне копіювання файлів ще не підтверджує, що IDE завантажила їх і пройшла перевірку дозволів (README.md, рядок 29).
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: покрокова інструкція через WSL2"?
Проєкт не можна повноцінно встановити лише засобами Windows PowerShell або CMD: він залежить від Bash, GNU timeout і Unix механізму блокувань файлів.
What are the key points to validate first?
Проєкт не можна повноцінно встановити лише засобами Windows PowerShell або CMD: він залежить від Bash, GNU timeout і Unix механізму блокувань файлів. Рекомендований варіант для Windows 10 — Ubuntu у WSL2; команда wsl install працює на Windows 10 версії 2004 і новіших збірках 19041 або вище.
What should I do next in practice?
Перед розгортанням потрібно перевірити сценарії встановлення й результати попереднього тесту, а також з’ясувати, де саме працює ваша IDE.
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 ...