ОтветыОпубликовано15 источники
Как запустить установку проекта на Windows 10 через WSL2
Для работы проекта нужны Bash, Git, GNU timeout, Python 3.10+ и PyYAML; в коде также используется Unix модуль блокировок, несовместимый с нативным Python для Windows. Рекомендуемый вариант для Windows 10 — установить Ubuntu через WSL2, затем выполнить предварительную проверку и пробный запуск.
ОпубликовалИзображения созданы с помощью GPT Image 2
Ответ на исследование
Ключевые выводы
- Для работы проекта нужны Bash, Git, GNU timeout, Python 3.10+ и PyYAML; в коде также используется Unix модуль блокировок, несовместимый с нативным Python для Windows.
- Рекомендуемый вариант для Windows 10 — установить Ubuntu через WSL2, затем выполнить предварительную проверку и пробный запуск.
- Установка файлов внутри WSL не означает, что расширение или IDE, работающие в Windows, автоматически обнаружат их.
- Руководство основано на просмотре исходников: установка на реальном компьютере с Windows 10 не проводилась.
![[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
Установить этот проект напрямую из PowerShell или CMD не получится без доработок: его скрипты рассчитаны на Linux-инструменты и системные интерфейсы. Для Windows 10 практичный вариант — запустить Ubuntu в WSL2, подсистеме Windows для Linux. Важно: это не установка проекта в нативную среду Windows, а запуск в отдельной Linux-среде.
Инструкция ниже основана на просмотре исходников и документации. Она не проверялась на реальном компьютере с Windows 10; установка и изменение проекта здесь не выполнялись.
Почему нужен WSL2
В README проекта среди требований указаны Bash, Git, GNU timeout, Python 3.10+ и PyYAML (README.md). Кроме того, скрипт развертывания импортирует модуль fcntl, предназначенный для Unix-систем; в стандартной библиотеке Python он недоступен в Windows (asset_safety.py, 7).
Автоматический поиск режимов также ориентирован на структуру каталогов Linux (deployment_targets.py). Поэтому успешное копирование файлов внутри WSL ещё не гарантирует, что их найдёт IDE, запущенная непосредственно в Windows.
1. Установите WSL и Ubuntu
Для приведённой ниже команды требуется Windows 10 версии 2004 или новее (сборка 19041 и выше). На более старых версиях может понадобиться ручная установка WSL (12,
10).
Откройте PowerShell от имени администратора и выполните команду (12):
wsl --install -d Ubuntu
Следуйте подсказкам и перезагрузите компьютер, если система попросит. При первом запуске Ubuntu создайте имя пользователя и пароль Linux (3).
Проверьте, что дистрибутив работает в WSL2:
wsl --list --verbose
Если напротив Ubuntu указана версия 1, переключите её на WSL2:
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:
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. Проверьте, где работает IDE
- Для VS Code можно установить приложение в Windows, добавить расширение WSL и открыть рабочую папку Ubuntu. Microsoft рекомендует такой способ разработки с WSL (
9).
- Уточните, в каком окружении запускается Roo и к этому ли окружению относится установленная конфигурация. Документация проекта отдельно требует проверить работу режимов в самой IDE (
README.md). - Если Antigravity, Gemini или Roo запущены как приложения Windows, установку внутри WSL нельзя считать успешной установкой для Windows. Автоматический поиск проекта, согласно исходникам, не охватывает пути конфигурации Windows (
deployment_targets.py).
Итог: если вы готовы работать в Linux-среде внутри Windows, попробуйте маршрут через WSL2 и Ubuntu. Если проект должен работать исключительно в нативной Windows-среде, готовой инструкции для этого пока нет: потребуется адаптировать блокировки файлов, права доступа, синхронизацию каталогов и пути конфигурации Windows. Даже успешное копирование файлов ещё не подтверждает, что IDE загрузила режимы и прошла проверку прав доступа (README.md).
Studio Global AI
Продолжайте свое исследование
На этой странице есть ответ, подтвержденный источником, который вы можете продолжить внутри Studio Global.
Люди также спрашивают
Каков краткий ответ на вопрос «Как запустить установку проекта на Windows 10 через WSL2»?
Для работы проекта нужны Bash, Git, GNU timeout, Python 3.10+ и PyYAML; в коде также используется Unix модуль блокировок, несовместимый с нативным Python для Windows.
Какие ключевые моменты необходимо проверить в первую очередь?
Для работы проекта нужны Bash, Git, GNU timeout, Python 3.10+ и PyYAML; в коде также используется Unix модуль блокировок, несовместимый с нативным Python для Windows. Рекомендуемый вариант для Windows 10 — установить Ubuntu через WSL2, затем выполнить предварительную проверку и пробный запуск.
Что мне делать дальше на практике?
Установка файлов внутри WSL не означает, что расширение или IDE, работающие в Windows, автоматически обнаружат их.
Источники
docs.python.orgfcntl — The fcntl and ioctl system calls — Python 3.14.8 documentation
developer.microsoft.comWindows Subsystem for Linux | Microsoft Developer